Method: projects.locations.investigations.getIamPolicy

Busca a política de controle de acesso de um recurso. Retorna uma política vazia se o recurso estiver presente e não tiver um conjunto de políticas.

Solicitação HTTP

GET https://geminicloudassist.googleapis.com/v1alpha/{resource=projects/*/locations/*/investigations/*}:getIamPolicy

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
resource

string

OBRIGATÓRIO: o recurso para o qual a política está sendo solicitada. Consulte Nomes de recursos (link em inglês) se quiser saber o valor correto para esse campo.

Parâmetros de consulta

Parâmetros
options

object (GetPolicyOptions)

OPCIONAL: um objeto GetPolicyOptions se você quiser especificar opções para investigations.getIamPolicy.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso resource:

  • geminicloudassist.investigations.getIamPolicy

Para mais detalhes, consulte a documentação do IAM.

GetPolicyOptions

Encapsula as configurações fornecidas para investigations.getIamPolicy.

Representação JSON
{
  "requestedPolicyVersion": integer
}
Campos
requestedPolicyVersion

integer

Opcional. A versão máxima que será usada para formatar a política.

Os valores válidos são: 0, 1 e 3. Solicitações que especificam um valor inválido serão rejeitadas.

As solicitações de políticas com qualquer vinculação de papel condicional devem especificar a versão 3. As políticas sem vinculações desse tipo podem especificar qualquer valor válido ou deixar o campo sem definição.

A política na resposta pode usar a versão da política especificada ou uma versão anterior. Por exemplo, se você especificar a versão 3, mas a política não tiver vinculações de papéis condicionais, a resposta vai usar a versão 1.

Para saber quais recursos são compatíveis com as condições nas políticas do IAM, consulte a documentação do IAM.