REST Resource: roleAssignments

المورد: RoleAssignment

تحدّد هذه السمة مهمة دور.

تمثيل JSON 
{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string,
  "expirationDetails": {
    object (ExpirationDetails)
  }
}
الحقول
roleAssignmentId

string (int64 format)

معرّف roleAssignment هذا.
roleId

string (int64 format)

معرّف الدور الذي تمّ تعيينه.
kind

string

نوع مورد واجهة برمجة التطبيقات يكون هذا الخيار admin#directory#roleAssignment دائمًا.
etag

string

تمثّل هذه السمة علامة ETag الخاصة بالمرجع.
assignedTo

string

المعرّف الفريد للكيان الذي تمّ إسناد هذا الدور إليه، سواء كان userId لمستخدم أو groupId لمجموعة أو uniqueId لحساب خدمة كما هو محدّد في إدارة الهوية وإمكانية الوصول (IAM)
assigneeType

enum (AssigneeType)

النتائج فقط. نوع المستخدم المُسنَد إليه (USER أو GROUP)
scopeType

string

النطاق الذي يتم فيه تعيين هذا الدور

القيم المقبولة هي:

  • CUSTOMER
  • ORG_UNIT
orgUnitId

string

إذا كان الدور محصورًا بوحدة تنظيمية، يحتوي هذا الحقل على رقم تعريف الوحدة التنظيمية التي يقتصر عليها ممارسة هذا الدور.
condition

string

اختياريّ. الشرط المرتبط بإسناد الدور هذا.

ملاحظة: تتوفّر هذه الميزة لعملاء Enterprise Standard وEnterprise Plus وGoogle Workspace for Education Plus والنسخة المدفوعة من Cloud Identity.

لن يتم تطبيق RoleAssignment مع ضبط الحقل condition إلا عندما يستوفي المرجع الذي يتم الوصول إليه الشرط. إذا كان condition فارغًا، يتم تطبيق الدور (roleId) على الجهة الفاعلة (assignedTo) في النطاق (scopeType) بدون شروط.

تتوفّر حاليًا الشروط التالية:

  • لجعل RoleAssignment ينطبق فقط على مجموعات الأمان: api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

  • لجعل RoleAssignment غير منطبق على مجموعات الأمان: !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.security']) && resource.type == 'cloudidentity.googleapis.com/Group'

في الوقت الحالي، يجب أن تكون سلاسل الشروط مطابقة تمامًا، ولا تعمل إلا مع أدوار المشرف السابقة التحديد التالية:

  • محرّر "مجموعات Google"
  • قارئ "مجموعات Google"

يتّبع الشرط بنية شرط Cloud IAM.

  • لجعل RoleAssignment غير منطبق على المجموعات المقفلة: !api.getAttribute('cloudidentity.googleapis.com/groups.labels', []).hasAny(['groups.locked']) && resource.type == 'cloudidentity.googleapis.com/Group'

يمكن أيضًا استخدام هذا الشرط مع شرط متعلّق بالأمان.
expirationDetails

object (ExpirationDetails)

اختياريّ. تفاصيل بشأن انتهاء صلاحية تعيين هذا الدور.

AssigneeType

تمثّل هذه السمة نوع الهوية التي تمّ تعيين دور لها.

عمليات التعداد
USER مستخدم فردي ضمن النطاق
GROUP مجموعة ضمن النطاق

ExpirationDetails

تفاصيل بشأن انتهاء صلاحية تعيين هذا الدور. تُستخدَم لإبطال إذن الوصول تلقائيًا عند بلوغ الحدّ الزمني.

تمثيل JSON 
{

  "expireTime": string
}
الحقول

حقل الربط expiration

يمكن أن يكون التعليق expiration إحدى القيم التالية فقط:
expireTime

string (Timestamp format)

الطابع الزمني المحدّد الذي تنتهي فيه صلاحية تعيين الدور

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

الطُرق

delete

 تحذف هذه الطريقة عملية إسناد دور.

get

 تعرض هذه الطريقة معلومات عن إذن الوصول إلى دور.

insert

 تنشئ هذه الطريقة عملية ربط دور.

list

 يستردّ هذا الإجراء قائمة مقسّمة إلى صفحات بجميع عمليات roleAssignments.