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

Recupera la policy di controllo dell'accesso per una risorsa agente. Se la risorsa non esiste, viene restituito un errore NOT_FOUND. Se la risorsa esiste ma non è stata impostata una policy, viene restituita una policy vuota.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
resource

string

OBBLIGATORIO: la risorsa per cui viene richiesta la policy. Per conoscere il valore appropriato per questo campo, consulta Nomi delle risorse.

Parametri di query

Parametri
options

object (GetPolicyOptions)

FACOLTATIVO: un oggetto GetPolicyOptions per specificare le opzioni di agents.getIamPolicy.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Policy.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa resource:

  • discoveryengine.agents.getIamPolicy

Per saperne di più, consulta la documentazione di IAM.

GetPolicyOptions

Contiene le impostazioni fornite a agents.getIamPolicy.

Rappresentazione JSON 
{
  "requestedPolicyVersion": integer
}
Campi
requestedPolicyVersion

integer

Facoltativo. La versione massima della policy che verrà utilizzata per formattarla.

I valori validi sono 0, 1 e 3. Le richieste che specificano un valore non valido verranno rifiutate.

Le richieste di policy con associazioni di ruoli condizionali devono specificare la versione 3. Le policy senza associazioni di ruoli condizionali possono specificare qualsiasi valore valido o lasciare il campo non impostato.

Il criterio nella risposta potrebbe utilizzare la versione del criterio specificata oppure una versione precedente. Ad esempio, se specifichi la versione 3, ma il criterio non ha associazioni di ruoli condizionali, la risposta utilizza la versione 1.

Per scoprire quali risorse supportano le condizioni nelle relative policy IAM, consulta la documentazione di IAM.