UpdateUser - Amazon QuickSight
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

UpdateUser

Aggiorna un Amazon QuickSight utente.

Sintassi della richiesta

PUT /accounts/AwsAccountId/namespaces/Namespace/users/UserName HTTP/1.1
Content-type: application/json

{
   "CustomFederationProviderUrl": "string",
   "CustomPermissionsName": "string",
   "Email": "string",
   "ExternalLoginFederationProviderType": "string",
   "ExternalLoginId": "string",
   "Role": "string",
   "UnapplyCustomPermissions": boolean
}

Parametri della richiesta URI:

La richiesta utilizza i seguenti parametri URI.

AwsAccountId

L'IDAWSaccount in cui si trova l'utente. Attualmente, si utilizza l'ID perAWSaccount che contiene il tuo Amazon QuickSight conto.

Vincoli di lunghezza: Lunghezza fissa di 12.

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

obbligatorio Sì

Namespace

Lo spazio dei nomi. Attualmente, è necessario impostare questo sudefault.

Vincoli di lunghezza: La lunghezza massima è 64 caratteri.

Modello: ^[a-zA-Z0-9._-]*$

obbligatorio Sì

UserName

L'Amazon QuickSight nome utente che si desidera aggiornare.

Vincoli di lunghezza: Lunghezza minima pari a 1.

Modello: [\u0020-\u00FF]+

obbligatorio Sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

Email

L'indirizzo e-mail dell'utente che si desidera aggiornare.

Type: Stringa

obbligatorio Sì

Role

L'Amazon QuickSight ruolo dell'utente. Il ruolo può essere una delle seguenti seguenti coorti di sicurezza predefinite:

  • READER: campo campo campo campo campo campo campo campo campo obblig

  • AUTHOR: campo campo campo campo campo campo campo campo campo campo obblig: campo campo campo campo campo campo campo campo campo campo campo campo campo campo campo obblig

  • ADMIN: un utente che è un autore, che può anche gestire Amazon QuickSightImpostazioni .

Il nome dell'Amazon QuickSight il ruolo è invisibile all'utente ad eccezione delle schermate della console che trattano le autorizzazioni.

Type: Stringa

Valori validi: ADMIN | AUTHOR | READER | RESTRICTED_AUTHOR | RESTRICTED_READER

obbligatorio Sì

CustomFederationProviderUrl

L'URL del provider OpenID Connect (OIDC) personalizzato che fornisce l'identità per consentire a un utente di federarsi in Amazon QuickSight with an associated AWS Identity and Access Management(IAM) Questo parametro deve essere utilizzato solo quandoExternalLoginFederationProviderTypeIl parametro è impostato suCUSTOM_OIDC.

Type: Stringa

obbligatorio No

CustomPermissionsName

(Solo edizione Enterprise) Il nome del profilo di autorizzazioni personalizzato che si desidera assegnare a questo utente. Le autorizzazioni personalizzate consentono di controllare l'accesso di un utente limitando l'accesso alle seguenti operazioni:

  • Creare e aggiornare le origini dati

  • Creare e aggiornare set di dati

  • Creazione e aggiorna report e-mail

  • Scrivere ai report via e-mail

Un set di autorizzazioni personalizzate include qualsiasi combinazione di queste restrizioni. Al momento, devi creare i nomi dei profili per i set di autorizzazioni personalizzati utilizzando Amazon QuickSightConsole. Quindi,RegisterUserOperazione API per assegnare il set di autorizzazioni denominato a un Amazon QuickSight utente.

Amazon QuickSight Le autorizzazioni personalizzate vengono applicate mediante le policy IAM. Pertanto, sostituiscono le autorizzazioni generalmente concesse assegnando Amazon QuickSight utenti di una delle coorti di sicurezza predefinite in Amazon QuickSight (amministratore, autore, lettore).

Questa caratteristica è disponibile solo per Amazon QuickSight Sottoscrivere alla Enterprise Edition.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: ^[a-zA-Z0-9+=,.@_-]+$

obbligatorio No

ExternalLoginFederationProviderType

Il tipo di provider di accesso esterno supportato che fornisce l'identità per consentire a un utente di federarsi in Amazon QuickSight with an associated AWS Identity and Access Management(IAM) Il tipo di provider di accesso esterno supportato può essere uno dei seguenti.

  • COGNITO: campo Amazon Cognito campo L'URL del provider è cognito-identity.amazonaws.com. Quando si sceglie ilCOGNITOtipo di provider, non utilizzare»CustomFederationProviderUrl«parametro che è necessario solo quando il provider esterno è personalizzato.

  • CUSTOM_OIDC: campo OpenID Connect campo campo campo campo campo obblig Quando si sceglieCUSTOM_OIDCdigitare, utilizzare ilCustomFederationProviderUrlparametro per fornire l'URL del provider OIDC.

  • NONE: cancella tutte le informazioni di accesso esterne salvate in precedenza per un utente. Utilizzo dell' DescribeUser Operazione API per verificare le informazioni di accesso esterne.

Type: Stringa

obbligatorio No

ExternalLoginId

L'ID di identità di un utente nel provider di accesso esterno.

Type: Stringa

obbligatorio No

UnapplyCustomPermissions

Un flag utilizzato per indicare che si desidera rimuovere tutte le autorizzazioni personalizzate da questo utente. L'utilizzo di questo parametro reimposta l'utente allo stato in cui si trovava prima dell'applicazione di un profilo di autorizzazioni personalizzato. Il valore predefinito di questo parametro è NULL e non accetta nessun altro valore.

Type: Boolean

obbligatorio No

Sintassi della risposta

HTTP/1.1 Status
Content-type: application/json

{
   "RequestId": "string",
   "User": { 
      "Active": boolean,
      "Arn": "string",
      "CustomPermissionsName": "string",
      "Email": "string",
      "ExternalLoginFederationProviderType": "string",
      "ExternalLoginFederationProviderUrl": "string",
      "ExternalLoginId": "string",
      "IdentityType": "string",
      "PrincipalId": "string",
      "Role": "string",
      "UserName": "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.

RequestId

LaAWSL'ID di richiesta per questa operazione.

Type: Stringa

User

L'Amazon QuickSight utente.

Tipo: User oggetto

Errori

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

AccessDeniedException

Non hai l'accesso a questo articolo. Le credenziali fornite non possono essere convalidate. È bbligatorio. Assicurati che il tuo account sia autorizzato a utilizzare Amazon QuickSight che le policy abbiano le autorizzazioni corrette e che le chiavi di accesso corrette e che le chiavi di accesso corrette.

Codice di stato di stato di stato 401

InternalFailureException

Si è verificato un errore interno.

Codice di stato di stato di stato 500

InvalidParameterValueException

Uno o più parametri hanno un valore non valido.

Codice di stato di stato di stato 400

PreconditionNotMetException

Una o più precondizioni non sono soddisfatte.

Codice di stato di stato di stato 400

ResourceNotFoundException

Uno o più risorse non sono state trovate.

Codice di stato di stato di stato 404

ResourceUnavailableException

Questa risorsa al momento non è disponibile.

Codice di stato di stato di stato 503

ThrottlingException

L'accesso è limitato.

Codice di stato di stato di stato 429

Vedi anche

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