Permite mostrar los permisos que tiene un emisor para un recurso específico. Si el recurso no existe, se mostrará un conjunto vacío de permisos y no un error NOT_FOUND.
Nota: Esta operación se diseñó a fin de usarse en la creación de IU adaptadas a los permisos y en herramientas de líneas de comandos, y no para la comprobación de la autorización. La operación puede provocar un “fail open” sin mostrar advertencias.
Solicitud HTTP
POST https://runtimeconfig.googleapis.com/v1beta1/{resource=projects/*/configs/*}:testIamPermissions
OBLIGATORIO. El recurso para el que se solicitan los detalles de la política. Consulta la documentación de operación a fin de 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
{"permissions": [string]}
Campos
permissions[]
string
Corresponde al conjunto de permisos que se debe comprobar para el resource. No se permiten los permisos con comodines (p. ej., “*” o “storage.*”). Para obtener más información, consulta la Descripción general de IAM.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de TestIamPermissionsResponse.
Alcances de autorización
Se necesita uno de los siguientes alcances de OAuth:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-03-04 (UTC)"],[[["This endpoint retrieves permissions for a specified resource, returning an empty set if the resource doesn't exist rather than an error."],["The HTTP request uses a POST method with a URL that follows gRPC Transcoding syntax and requires a 'resource' path parameter."],["The request body, in JSON format, includes an array of 'permissions' to check, excluding any with wildcards, and requires the resource in question."],["Successful responses contain a TestIamPermissionsResponse instance, and the operation is intended for UI/tool development, not for direct authorization."],["The process requires one of two Oauth scopes: either `https://www.googleapis.com/auth/cloud-platform` or `https://www.googleapis.com/auth/cloudruntimeconfig`."]]],[]]
