REST Resource: corpora.permissions

Ресурс: Разрешение

Ресурс разрешения предоставляет пользователю, группе или остальному миру доступ к ресурсу API PaLM (например, настроенной модели, корпусу).

Роль — это набор разрешенных операций, который позволяет пользователям выполнять определенные действия с ресурсами PaLM API. Чтобы сделать их доступными для пользователей, групп или учетных записей служб, вы назначаете роли. Назначая роль, вы предоставляете разрешения, которые содержит эта роль.

Есть три концентрические роли. Каждая роль представляет собой расширенный набор разрешенных операций предыдущей роли:

  • читатель может использовать ресурс (например, настроенную модель, корпус) для вывода
  • писатель имеет права читателя и, кроме того, может редактировать и делиться
  • владелец имеет права записи и, кроме того, может удалять
JSON-представление
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
Поля
name

string

Только вывод. Идентификатор. Имя разрешения. Уникальное имя будет сгенерировано при создании. Примеры: TunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Только вывод.

granteeType

enum ( GranteeType )

Необязательный. Неизменный. Тип грантополучателя.

emailAddress

string

Необязательный. Неизменный. Адрес электронной почты пользователя группы, к которому относится это разрешение. Поле не задается, если типом получателя разрешения является ВСЕ.

role

enum ( Role )

Необходимый. Роль, предоставленная этим разрешением.

Тип получателя гранта

Определяет типы получателя этого разрешения.

Перечисления
GRANTEE_TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
USER Представляет пользователя. Если этот параметр установлен, вы должны предоставить пользователю адрес электронной почты.
GROUP Представляет группу. Если этот параметр установлен, вы должны указать адрес электронной почты для группы.
EVERYONE Представляет доступ для всех. Никакой дополнительной информации не требуется.

Роль

Определяет роль, предоставляемую этим разрешением.

Перечисления
ROLE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
OWNER Владелец может использовать, обновлять, делиться и удалять ресурс.
WRITER Writer может использовать, обновлять и делиться ресурсом.
READER Читатель может воспользоваться ресурсом.

Методы

create

 Создайте разрешение для определенного ресурса.

delete

 Удаляет разрешение.

get

 Получает информацию о конкретном Разрешении.

list

 Перечисляет разрешения для конкретного ресурса.

patch

 Обновляет разрешение.