Perissions

Метод: TunedModels.permissions.create

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

Конечная точка

опубликуйте https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Параметры пути

parent string

Необходимый. Родительский ресурс Permission . Форматы: tunedModels/{tunedModel} corpora/{corpus} Он принимает форму tunedModels/{tunedmodel} .

Тело запроса

Тело запроса содержит экземпляр Permission .

Пример запроса

Питон

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

group_permission = model_info.permissions.create(
    role="READER",
    # Use "user" for an individual email address.
    grantee_type="group",
    email_address="genai-samples-test-group@googlegroups.com",
)

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр Permission .

Метод: TunedModels.permissions.get

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

Конечная точка

получите https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Параметры пути

string name

Необходимый. Имя ресурса разрешения.

Форматы: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Он принимает форму tunedModels/{tunedmodel}/permissions/{permission} .

Тело запроса

Тело запроса должно быть пустым.

Пример запроса

Питон

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

public = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)
print(public)
name = public.name
print(name)  # tunedModels/{tunedModel}/permissions/{permission}

from_name = genai.types.Permissions.get(name)
print(from_name)

Тело ответа

В случае успеха тело ответа содержит экземпляр Permission .

Метод: TunedModels.permissions.list

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

Конечная точка

получите https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Параметры пути

parent string

Необходимый. Родительский ресурс разрешений. Форматы: tunedModels/{tunedModel} corpora/{corpus} Он принимает форму tunedModels/{tunedmodel} .

Параметры запроса

pageSize integer

Необязательный. Максимальное количество возвращаемых Permission (на страницу). Служба может возвращать меньше разрешений.

Если не указано, будет возвращено не более 10 разрешений. Этот метод возвращает не более 1000 разрешений на страницу, даже если вы передаете больший размер страницы.

string pageToken

Необязательный. Токен страницы, полученный в результате предыдущего вызова permissions.list .

Предоставьте pageToken , возвращенный одним запросом, в качестве аргумента для следующего запроса для получения следующей страницы.

При разбиении на страницы все остальные параметры, предоставленные в permissions.list должны соответствовать вызову, который предоставил токен страницы.

Тело запроса

Тело запроса должно быть пустым.

Пример запроса

Питон

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

for p in model_info.permissions.list():
    print(p)

Тело ответа

В случае успеха тело ответа содержит экземпляр ListPermissionsResponse .

Метод: TunedModels.permissions.patch

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

Конечная точка

патч https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}
PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

Параметры пути

string permission.name

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

Параметры запроса

строка updateMask string ( FieldMask format)

Необходимый. Список полей для обновления. Принимаются: - роль (поле Permission.role )

Это разделенный запятыми список полных имен полей. Пример: "user.displayName,photo" .

Тело запроса

Тело запроса содержит экземпляр Permission .

Пример запроса

Питон

        model_info = genai.get_model("tunedModels/my-increment-model")

        # ...

        test_group = model_info.permissions.create(
            role="writer",
            grantee_type="group",
            email_address="genai-samples-test-group@googlegroups.com",
        )

        test_group.update({"role": "READER"})

    def test_tuned_models_permission_delete(self):
        model_info = genai.get_model("tunedModels/my-increment-model")
        # ...

        public_permission = model_info.permissions.create(
            role="READER",
            grantee_type="EVERYONE",
        )

        public_permission.delete()


if __name__ == "__main__":
    absltest.main()

Тело ответа

В случае успеха тело ответа содержит экземпляр Permission .

Метод: TunedModels.permissions.delete

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

Конечная точка

удалить https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Параметры пути

string name

Необходимый. Имя ресурса разрешения. Форматы: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Он принимает форму tunedModels/{tunedmodel}/permissions/{permission} .

Тело запроса

Тело запроса должно быть пустым.

Пример запроса

Питон

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

public_permission.delete()

Тело ответа

В случае успеха тело ответа пустое.

Метод: TunedModels.transferOwnership

Передаёт право собственности на настроенную модель. Это единственный способ сменить владельца тюнингованной модели. Нынешний владелец будет понижен до уровня писателя.

Конечная точка

опубликуйте https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

Параметры пути

string name

Необходимый. Имя ресурса настроенной модели для передачи права собственности.

Формат: tunedModels/my-model-id Он принимает форму tunedModels/{tunedmodel} .

Тело запроса

Тело запроса содержит данные следующей структуры:

Поля
string emailAddress

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

Тело ответа

В случае успеха тело ответа пустое.

Ресурс REST: TunedModels.permissions

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

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

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

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

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

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

перечисление granteeType enum ( GranteeType )

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

string emailAddress

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

перечисление role enum ( Role )

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

ListPermissionsResponse

Ответ от ListPermissions , содержащий список разрешений с разбивкой на страницы.

JSON-представление
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}
Поля
объект permissions[] object ( Permission )

Возвращены разрешения.

следующая string nextPageToken

Токен, который можно отправить как pageToken для получения следующей страницы.

Если это поле опущено, страниц больше нет.