Permissions

Método: TuneModels.permissions.create

Criar uma permissão para um recurso específico.

Endpoint

postar https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Parâmetros de caminho

parent string

Obrigatório. O recurso pai da Permission. Formatos: tunedModels/{tunedModel} corpora/{corpus} Ele assume o formato tunedModels/{tunedmodel}.

Corpo da solicitação

O corpo da solicitação contém uma instância de Permission.

Campos
granteeType enum (GranteeType)

Opcional. Imutável. O tipo de beneficiário.

emailAddress string

Opcional. Imutável. O endereço de e-mail do usuário do grupo a que esta permissão se refere. O campo não é definido quando o tipo de beneficiário da permissão é TODOS.

role enum (Role)

Obrigatório. O papel concedido pela permissão.

Exemplo de solicitação

Python

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",
)

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Permission.

Método: tuningModels.permissions.get

Recebe informações sobre uma permissão específica.

Endpoint

recebe https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Parâmetros de caminho

name string

Obrigatório. O nome do recurso da permissão.

Formatos: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Ele assume o formato tunedModels/{tunedmodel}/permissions/{permission}.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Exemplo de solicitação

Python

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)

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Permission.

Método: tuningModels.permissions.list

Lista as permissões para o recurso específico.

Endpoint

recebe https://generativelanguage.googleapis.com/v1beta/{parent=tunedModels/*}/permissions

Parâmetros de caminho

parent string

Obrigatório. O recurso pai das permissões. Formatos: tunedModels/{tunedModel} corpora/{corpus} Ele assume o formato tunedModels/{tunedmodel}.

Parâmetros de consulta

pageSize integer

Opcional. O número máximo de Permissions a serem retornados (por página). O serviço pode retornar menos permissões.

Se não for especificado, serão retornadas no máximo 10 permissões. Esse método retorna no máximo 1.000 permissões por página, mesmo que você transmita um pageSize maior.

pageToken string

Opcional. Um token de página recebido de uma chamada permissions.list anterior.

Forneça o pageToken retornado por uma solicitação como um argumento para a próxima solicitação a fim de recuperar a próxima página.

Ao paginar, todos os outros parâmetros fornecidos para permissions.list precisam corresponder à chamada que forneceu o token da página.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Exemplo de solicitação

Python

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

# ...

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

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de ListPermissionsResponse.

Método: AdjustModels.permissions.patch

Atualiza a permissão.

Endpoint

patch https://generativelanguage.googleapis.com/v1beta/{permission.name=tunedModels/*/permissions/*}

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

Parâmetros de caminho

permission.name string

Apenas saída. Identificador. O nome da permissão. Um nome exclusivo será gerado na criação. Exemplos: tuningModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} somente saída. Ele tem o formato tunedModels/{tunedmodel}/permissions/{permission}.

Parâmetros de consulta

updateMask string (FieldMask format)

Obrigatório. Lista de campos a serem atualizados. Aceitas: - função (Permission.role campo)

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da solicitação

O corpo da solicitação contém uma instância de Permission.

Campos
role enum (Role)

Obrigatório. O papel concedido pela permissão.

Exemplo de solicitação

Python

        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()

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Permission.

Método: tuningModels.permissions.delete

Exclui a permissão.

Endpoint

excluir https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*/permissions/*}

Parâmetros de caminho

name string

Obrigatório. O nome do recurso da permissão. Formatos: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} Ele assume o formato tunedModels/{tunedmodel}/permissions/{permission}.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Exemplo de solicitação

Python

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

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

public_permission.delete()

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Método: TuneModels.transferOwnership

Transfere a propriedade do modelo ajustado. Essa é a única maneira de alterar a propriedade do modelo ajustado. O proprietário atual será rebaixado para a função de escritor.

Endpoint

postar https://generativelanguage.googleapis.com/v1beta/{name=tunedModels/*}:transferOwnership

Parâmetros de caminho

name string

Obrigatório. O nome do recurso do modelo ajustado para transferir a propriedade.

Formato: tunedModels/my-model-id. Ele assume o formato tunedModels/{tunedmodel}.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Campos
emailAddress string

Obrigatório. O endereço de e-mail do usuário para quem o modelo ajustado está sendo transferido.

Corpo da resposta

Se a solicitação for concluída, o corpo da resposta estará vazio.

Recurso REST: tuningModels.permissions

Recurso: permissão

O recurso de permissão concede ao usuário, grupo ou o resto do mundo acesso ao recurso da API PaLM (por exemplo, um modelo ajustado, corpus).

Um papel é uma coleção de operações permitidas que permitem que os usuários executem ações específicas nos recursos da API PaLM. Você atribui papéis para disponibilizá-los a usuários, grupos ou contas de serviço. Ao atribuir um papel, você concede as permissões contidas nele.

Há três papéis concêntricos. Cada papel é um superconjunto das operações permitidas dos papéis anteriores:

  • o leitor pode usar o recurso (por exemplo, modelo ajustado, corpus) para inferência
  • O escritor tem permissões de leitor e também pode editar e compartilhar
  • proprietário tem permissões de escritor e também pode excluir
Campos
name string

Apenas saída. Identificador. O nome da permissão. Um nome exclusivo será gerado na criação. Exemplos: tuningModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} somente saída.

granteeType enum (GranteeType)

Opcional. Imutável. O tipo de beneficiário.

emailAddress string

Opcional. Imutável. O endereço de e-mail do usuário do grupo a que esta permissão se refere. O campo não é definido quando o tipo de beneficiário da permissão é TODOS.

role enum (Role)

Obrigatório. O papel concedido pela permissão.

Representação JSON
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

ListPermissionsResponse

Resposta de ListPermissions contendo uma lista paginada de permissões.

Campos
permissions[] object (Permission)

Permissões retornadas.

nextPageToken string

Um token, que pode ser enviado como pageToken para recuperar a próxima página.

Se esse campo for omitido, não haverá mais páginas.

Representação JSON
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}