Method: projects.locations.investigations.getIamPolicy

Obtém a política de controlo de acesso para um recurso. Devolve uma política vazia se o recurso existir e não tiver uma política definida.

Pedido HTTP

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

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

Parâmetros de caminho

Parâmetros
resource

string

Obrigatório: o recurso para o qual a política está a ser pedida. Consulte os nomes dos recursos para ver o valor adequado para este campo.

Parâmetros de consulta

Parâmetros
options

object (GetPolicyOptions)

OPCIONAL: um objeto GetPolicyOptions para especificar opções para investigations.getIamPolicy.

Corpo do pedido

O corpo do pedido tem de estar vazio.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de Policy.

Âmbitos de autorização

Requer o seguinte âmbito do OAuth:

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

Para mais informações, consulte o Authentication Overview.

Autorizações de IAM

Requer a seguinte autorização de IAM no recurso resource:

  • geminicloudassist.investigations.getIamPolicy

Para mais informações, consulte a documentação do IAM.

GetPolicyOptions

Encapsula as definições fornecidas a investigations.getIamPolicy.

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

integer

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

Os valores válidos são 0, 1 e 3. Os pedidos que especifiquem um valor inválido são rejeitados.

Os pedidos de políticas com quaisquer associações de funções condicionais têm de especificar a versão 3. As políticas sem associações de funções condicionais podem especificar qualquer valor válido ou deixar o campo não definido.

A política na resposta pode usar a versão da política que especificou ou pode usar uma versão da política inferior. Por exemplo, se especificar a versão 3, mas a política não tiver associações de funções condicionais, a resposta usa a versão 1.

Para saber que recursos suportam condições nas respetivas políticas de IAM, consulte a documentação da IAM.