Method: projects.tenants.getIamPolicy

Busca a política de controle de acesso de um recurso. Um erro será retornado se o recurso não existir. Uma política vazia será retornada se o recurso existir, mas não tiver uma política definida. O autor da chamada precisa ter a permissão correta do Google IAM no recurso.

Solicitação HTTP

POST https://identitytoolkit.googleapis.com/admin/v2/{resource=projects/*/tenants/*}: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 para saber o valor apropriado para esse campo.

Corpo da solicitação

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

Representação JSON 
{
  "options": {
    object (GetPolicyOptions)
  }
}
Campos
options

object (GetPolicyOptions)

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

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 um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

GetPolicyOptions

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

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

integer

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

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 de papel condicional precisam especificar a versão 3. As políticas sem vinculações de papéis condicionais 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 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.