Method: projects.locations.collections.engines.assistants.agents.getIamPolicy

Obtiene la política de control de acceso para un recurso de agente. Se muestra un error NOT_FOUND si el recurso no existe. Se devuelve una política vacía si el recurso existe, pero no tiene establecida una política.

Solicitud HTTP

GET https://discoveryengine.googleapis.com/v1alpha/{resource=projects/*/locations/*/collections/*/engines/*/assistants/*/agents/*}:getIamPolicy

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
resource

string

OBLIGATORIO. El recurso para el cual se solicita la política. Consulta Nombres de recursos para conocer el valor adecuado para este campo.

Parámetros de consulta

Parámetros
options

object (GetPolicyOptions)

OPCIONAL. Un objeto GetPolicyOptions para especificar opciones en agents.getIamPolicy.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

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/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

Para obtener más información, consulta Authentication Overview.

GetPolicyOptions

Encapsula la configuración proporcionada a agents.getIamPolicy.

Representación JSON
{
  "requestedPolicyVersion": integer
}
Campos
requestedPolicyVersion

integer

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 rol 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.