Método: projects.locations.instances.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://memcache.googleapis.com/v1beta2/{resource=projects/*/locations/*/instances/*}: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 a documentação da operação para ver o valor apropriado para este campo.

Parâmetros de consulta

Parâmetros
options

object (GetPolicyOptions)

OPCIONAL: um objeto GetPolicyOptions para especificar opções para instances.getIamPolicy. Esse campo é usado apenas pelo Cloud IAM.

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 do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

GetPolicyOptions

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

Representação JSON

{
  "requestedPolicyVersion": integer
}
Campos
requestedPolicyVersion

integer

Opcional. A versão do formato da política a ser retornada.

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

As solicitações de políticas com qualquer vinculação condicional precisam especificar a versão 3. Políticas sem vinculações condicionais podem especificar qualquer valor válido ou deixar o campo não definido.