UpdateDataSetPermissions - Amazon QuickSight

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateDataSetPermissions

Aggiorna le autorizzazioni su un set di dati.

La risorsa delle autorizzazioni èarn:aws:quicksight:region:aws-account-id:dataset/data-set-id.

Sintassi della richiesta

POST /accounts/AwsAccountId/data-sets/DataSetId/permissions HTTP/1.1 Content-type: application/json { "GrantPermissions": [ { "Actions": [ "string" ], "Principal": "string" } ], "RevokePermissions": [ { "Actions": [ "string" ], "Principal": "string" } ] }

Parametri della richiesta URI:

La richiesta utilizza i seguenti parametri URI.

AwsAccountId

ID dell'account AWS.

Vincoli di lunghezza: Lunghezza fissa di 12.

Modello: ^[0-9]{12}$

Campo obbligatorio: Sì

DataSetId

L'ID del set di dati di cui si desiderano aggiornare le autorizzazioni. Questo ID è univoco perRegione AWSper ogni)AWSconto.

Campo obbligatorio: Sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

GrantPermissions

Le autorizzazioni della risorsa che intendi concedere al set di dati.

Type: Matrice diResourcePermissionoggetti

Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 64 elementi.

Campo obbligatorio: No

RevokePermissions

Le autorizzazioni delle risorse che desideri revocare dal set di dati.

Type: Matrice diResourcePermissionoggetti

Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 64 elementi.

Campo obbligatorio: No

Sintassi della risposta

HTTP/1.1 Status Content-type: application/json { "DataSetArn": "string", "DataSetId": "string", "RequestId": "string" }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP.

Status

Lo stato HTTP della richiesta.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

DataSetArn

L'Amazon Resource Name (ARN) del set di dati.

Type: Stringa

DataSetId

L'ID del set di dati di cui si desiderano aggiornare le autorizzazioni. Questo ID è univoco perRegione AWSper ogni)AWSconto.

Type: Stringa

RequestId

LaAWSID della richiesta per questa operazione.

Type: Stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccessDeniedException

Non hai l'accesso. Le credenziali fornite non possono essere convalidate. È possibile che non sei autorizzato a effettuare la richiesta. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight che le policy abbiano le autorizzazioni corrette e che siano utilizzate le chiavi di accesso corrette.

Codice di stato HTTP: 401

ConflictException

L'aggiornamento o l'eliminazione di una risorsa può causare uno stato incoerente.

Codice di stato HTTP: 409

InternalFailureException

Si è verificato un errore interno.

Codice di stato HTTP: 500

InvalidParameterValueException

Uno o più parametri hanno un valore non valido.

Codice di stato HTTP: 400

ResourceNotFoundException

Uno o più risorse non sono state trovate.

Codice di stato HTTP: 404

ThrottlingException

L'accesso è limitato.

Codice di stato HTTP: 429

Esempi

Esempio

Questo esempio illustra un utilizzo di UpdateDataSetPermissions.

Richiesta di esempio

POST /accounts/{AwsAccountId}/data-sets/{DataSetId}/permissions HTTP/1.1 Content-type: application/json

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: