REST Resource: roleAssignments

المورد: RoleAssignment

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

تمثيل JSON 
{
  "roleAssignmentId": string,
  "roleId": string,
  "kind": string,
  "etag": string,
  "assignedTo": string,
  "assigneeType": enum (AssigneeType),
  "scopeType": string,
  "orgUnitId": string,
  "condition": string
}
الحقول
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 Premium.

لن يتم تطبيق 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'

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

AssigneeType

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

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

الطُرق

delete

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

get

 يستردّ عملية إسناد دور.

insert

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

list

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