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

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

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
resource

string

OBLIGATORIO: Recurso para el que se solicita la política. Consulta Nombres de recursos para ver el valor adecuado de este campo.

Los parámetros de consulta

Parámetros
options

object (GetPolicyOptions)

OPCIONAL: un objeto GetPolicyOptions para especificar opciones de agents.getIamPolicy.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de Policy.

Permisos de autorización

Debes disponer de 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 el Authentication Overview.

GetPolicyOptions

Encapsula los ajustes proporcionados 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 darle formato.

Los valores válidos son 0, 1 y 3. Las solicitudes que especifiquen un valor no válido se rechazarán.

Las solicitudes de políticas con vinculaciones de roles condicionales deben especificar la versión 3. Las políticas sin enlaces de roles condicionales pueden especificar cualquier valor válido o dejar el campo sin definir.

La política de la respuesta puede usar la versión de la política que hayas especificado o una versión inferior. Por ejemplo, si especificas la versión 3, pero la política no tiene enlaces de roles condicionales, la respuesta usa la versión 1.

Para saber qué recursos admiten condiciones en sus políticas de gestión de identidades y accesos, consulta la documentación de IAM.