REST Resource: enterprises.enrollmentTokens

المورد: RegistryToken

رمز مميَّز للتسجيل

تمثيل JSON
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
الحقول
name

string

اسم الرمز المميّز للتسجيل الذي أنشأه الخادم أثناء الإنشاء بالتنسيق enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.

value

string

تشير هذه القيمة إلى قيمة الرمز المميّز التي تم تمريرها إلى الجهاز والتي تمكّن الجهاز من التسجيل. هذا حقل للقراءة فقط أنشأه الخادم.

duration

string (Duration format)

المدة الزمنية التي يكون فيها الرمز المميّز للتسجيل صالحًا، وتتراوح من دقيقة واحدة إلى Durations.MAX_VALUE، وحوالي 10,000 سنة. إذا لم يتم تحديد المدة، تكون المدة التلقائية ساعة واحدة. يُرجى العِلم أنّه إذا تسببت المدة المطلوبة في تجاوز expirationTimestamp الناتجة Timestamps.MAX_VALUE، سيتم فرض expirationTimestamp على Timestamps.MAX_VALUE.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

expirationTimestamp

string (Timestamp format)

وقت انتهاء صلاحية الرمز المميّز هذا حقل للقراءة فقط أنشأه الخادم.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

policyName

string

تمثّل هذه السمة اسم السياسة التي تم تطبيقها في البداية على الجهاز المسجَّل بالتنسيق enterprises/{enterpriseId}/policies/{policyId}. وفي حال عدم تحديد هذه السمة، سيتم تطبيق سمة policyName لمستخدم الجهاز. إذا لم يتم تحديد السمة userName أيضًا، يتم تطبيق السمة enterprises/{enterpriseId}/policies/default تلقائيًا. عند تعديل هذا الحقل، يمكنك تحديد policyId فقط طالما أنّ السمة policyId لا تحتوي على أي شرطات مائلة. وسيتم استنتاج بقية اسم السياسة.

additionalData

string

بيانات اختيارية عشوائية مرتبطة بالرمز المميّز للتسجيل وقد يحتوي هذا مثلاً على رقم تعريف الوحدة التنظيمية التي يتم تخصيص الجهاز لها بعد التسجيل. بعد تسجيل الجهاز باستخدام الرمز المميّز، سيتم عرض هذه البيانات في الحقل enrollmentTokenData ضمن المورد Device. يجب أن تكون البيانات 1024 حرفًا أو أقل؛ وإلا لن ينجح طلب الإنشاء.

qrCode

string

سلسلة JSON يمكن استخدام تمثيل UTF-8 فيها لإنشاء رمز استجابة سريعة لتسجيل جهاز باستخدام هذا الرمز المميّز للتسجيل. لتسجيل جهاز باستخدام NFC، يجب أن يشتمل سجلّ NFC على تمثيل java.util.Properties متسلسل للسمات في ملف JSON.

oneTimeOnly

boolean

تحدّد هذه السمة ما إذا كان الرمز المميّز للتسجيل مخصّصًا للاستخدام لمرة واحدة فقط. وفي حال ضبط العلامة على "صحيح"، يمكن لجهاز واحد فقط استخدامها للتسجيل.

user
(deprecated)

object (User)

تم إيقاف هذا الحقل وتجاهل القيمة.

allowPersonalUsage

enum (AllowPersonalUsage)

تتحكّم هذه السياسة في ما إذا كان مسموحًا بالاستخدام الشخصي على جهاز مُدار باستخدام هذا الرمز المميّز للتسجيل.

بالنسبة إلى الأجهزة المملوكة للشركة:

  • يسمح تفعيل الاستخدام الشخصي للمستخدم بإعداد ملف شخصي للعمل على الجهاز.
  • يتطلب إيقاف الاستخدام الشخصي أن يدير المستخدم الجهاز كجهاز مُدار بالكامل.

بالنسبة إلى الأجهزة المملوكة شخصيًا:

  • يسمح تفعيل الاستخدام الشخصي للمستخدم بإعداد ملف شخصي للعمل على الجهاز.
  • سيؤدي إيقاف الاستخدام الشخصي إلى منع الجهاز من توفير المتطلبات اللازمة. لا يمكن إيقاف الاستخدام الشخصي على جهاز شخصي.

الطُرق

create

تنشئ رمزًا مميّزًا للتسجيل لمؤسسة معيّنة.

delete

يتم حذف الرمز المميّز للتسجيل.

get

للحصول على رمز مميَّز نشط وغير منتهي الصلاحية للتسجيل.

list

تعرض رموز التسجيل المميَّزة النشطة وغير المنتهية الصلاحية لمؤسسة معيَّنة.