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

Recupera il criterio 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 alcuna norma, viene restituita una norma 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 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 ulteriori informazioni, consulta Authentication Overview.

GetPolicyOptions

Contiene le impostazioni fornite a agents.getIamPolicy.

Rappresentazione JSON
{
  "requestedPolicyVersion": integer
}
Campi
requestedPolicyVersion

integer

Facoltativo. La versione massima delle norme che verrà utilizzata per formattarle.

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

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

Il criterio nella risposta potrebbe utilizzare la versione del criterio che hai specificato oppure una versione precedente. Ad esempio, se specifichi la versione 3, ma la norma 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 IAM.