- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- GetPolicyOptions
- Pruébalo
Permite obtener la política de control de acceso de un recurso. Se muestra un error si el recurso no existe. Se muestra una política vacía si el recurso existe, pero no tiene una política establecida. El llamador debe tener el permiso de IAM de Google correcto en el recurso.
Solicitud HTTP
POST https://identitytoolkit.googleapis.com/admin/v2/{resource=projects/*/tenants/*}:getIamPolicy
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
resource |
OBLIGATORIO. El recurso para el cual se solicita la política. Consulta Nombres de recursos para conocer el valor adecuado para este campo. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"options": {
object ( |
Campos | |
---|---|
options |
OPCIONAL: Un objeto |
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Policy
.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/identitytoolkit
https://www.googleapis.com/auth/firebase
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta Authentication Overview.
GetPolicyOptions
Encapsula la configuración proporcionada a tenants.getIamPolicy.
Representación JSON |
---|
{ "requestedPolicyVersion": integer } |
Campos | |
---|---|
requestedPolicyVersion |
Opcional. La versión máxima de la política que se usará para dar formato a la política. Los valores válidos son 0, 1 y 3. Se rechazarán las solicitudes que especifiquen un valor no válido. Las solicitudes de políticas con vinculaciones de roles condicionales deben especificar la versión 3. Las políticas sin vinculaciones de roles condicionales pueden especificar cualquier valor válido o dejar el campo sin configurar. La política en la respuesta puede usar la versión de la política que especificaste o una versión anterior. Por ejemplo, si especificas la versión 3, pero la política no tiene vinculaciones de roles condicionales, la respuesta usa la versión 1. Para saber qué recursos admiten condiciones en sus políticas de IAM, consulta la documentación de IAM. |