REST Resource: corpora.permissions

المرجع: الإذن

يمنح مورد الأذونات المستخدم أو المجموعة أو بقية بُلدان العالم الإذن بالوصول إلى مورد PaLM API (على سبيل المثال، نموذج تم ضبطه أو مجموعة بيانات).

الدور هو مجموعة من العمليات المسموح بها التي تسمح للمستخدمين بتنفيذ إجراءات محدّدة على موارد PaLM API. ولإتاحتها للمستخدمين أو المجموعات أو حسابات الخدمة، يمكنك تعيين الأدوار. وعند إسناد دور، فإنك تمنح الأذونات التي يتضمّنها هذا الدور.

هناك ثلاثة أدوار متحدة المركز. يمثّل كل دور مجموعة فرعية من العمليات المسموح بها للدور السابق:

  • يمكن للقارئ استخدام المورد (مثلاً نموذج مضبوط أو مجموعة) للاستنتاج
  • فإن الكاتب لديه أذونات القارئ ويمكنه أيضًا تعديل ومشاركة
  • مالك لديه أذونات كاتب ويمكنه أيضًا حذف
تمثيل JSON 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
الحقول
name

string

النتائج فقط. المعرّف. اسم الإذن سيتم إنشاء اسم فريد عند الإنشاء. أمثلة: المخرجات المحدّدة/{tunedModel}/permissions/{permission} Corpora/{corpus}/permissions/{permission} فقط.
granteeType

enum (GranteeType)

اختياري. غير قابل للتغيير. نوع المستفيد من المنحة.
emailAddress

string

اختياري. غير قابل للتغيير. عنوان البريد الإلكتروني لمستخدم المجموعة الذي يشير إليه هذا الإذن. لم يتم ضبط الحقل عندما يكون نوع المستفيد من الإذن هو "الكل".
role

enum (Role)

مطلوبة. الدور الذي تم منحه لهذا الإذن.

GranteeType

تحدّد هذه السمة أنواع الأشخاص الذين حصلوا على هذا الإذن.

عمليات التعداد
GRANTEE_TYPE_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدَمة.
USER يمثل مستخدمًا. عند ضبط السياسة، يجب تقديم عنوان البريد الإلكتروني للمستخدم.
GROUP يمثل مجموعة. وعند ضبطها، عليك تقديم عنوان البريد الإلكتروني للمجموعة.
EVERYONE يمثل إمكانية الوصول إلى الجميع. ما مِن معلومات إضافية مطلوبة.

Role

يحدد الدور الذي تم منحه لهذا الإذن.

عمليات التعداد
ROLE_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدَمة.
OWNER يمكن للمالك استخدام المورد وتعديله ومشاركته وحذفه.
WRITER يمكن للكاتب استخدام المورد وتحديثه ومشاركته.
READER يمكن للقارئ استخدام المورد.

الطُرق

create

 إنشاء إذن لمورد محدَّد.

delete

 يؤدي هذا الإجراء إلى حذف الإذن.

get

 الحصول على معلومات حول إذن معيّن

list

 يسرد الأذونات للمورّد المحدَّد.

patch

 لتعديل الإذن