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à. # RegisterUser Crea un Amazon QuickSight utente, la cui identità è associata alAWS Identity and Access Management(IAM) identità o ruolo specificato nella richiesta. ## Sintassi della richiesta ``` POST /accounts/AwsAccountId/namespaces/Namespace/users HTTP/1.1 Content-type: application/json { "CustomFederationProviderUrl": "string", "CustomPermissionsName": "string", "Email": "string", "ExternalLoginFederationProviderType": "string", "ExternalLoginId": "string", "IamArn": "string", "IdentityType": "string", "SessionName": "string", "UserName": "string", "UserRole": "string" } ``` ## Parametri della richiesta URI: La richiesta utilizza i seguenti parametri URI. ** [AwsAccountId](#API_RegisterUser_RequestSyntax) ** L'ID delAWSaccount in cui si trova l'utente. Attualmente, si utilizza l'ID per ilAWSaccount che contiene Amazon contiene il tuo Amazon QuickSight conto. Limitazioni di lunghezza: Lunghezza fissa di 12. Modello: `^[0-9]{12}$` Campo: Sì ** [Namespace](#API_RegisterUser_RequestSyntax) ** Lo spazio dei nomi. Attualmente, è necessario impostare questo su`default`. Limitazioni di lunghezza: La lunghezza massima è 64 caratteri. Modello: `^[a-zA-Z0-9._-]*$` Campo: Sì ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [Email](#API_RegisterUser_RequestSyntax) ** L'indirizzo e-mail dell'utente che si desidera registrare. Type: Stringa Campo: Sì ** [IdentityType](#API_RegisterUser_RequestSyntax) ** Amazon QuickSight supporta diversi modi di gestire l'identità degli utenti. Questo parametro accetta due valori: + `IAM`: un utente la cui identità è mappata a un utente o ruolo IAM esistente. + `QUICKSIGHT`: un utente la cui identità è posseduta e gestita internamente da Amazon QuickSight. Type: Stringa Valori validi: ` IAM | QUICKSIGHT` Campo: Sì ** [UserRole](#API_RegisterUser_RequestSyntax) ** L'Amazon QuickSight ruolo per l'utente. Il ruolo utente può essere uno dei seguenti: + `READER`: campo obbligatorio. il campo di controllo. + `AUTHOR`: Un utente che può creare origini dati, set di dati, analisi e pannelli di controllo + `ADMIN`: un utente che è un autore, che può anche gestire Amazon QuickSightImpostazioni . + `RESTRICTED_READER`: questo ruolo non è attualmente disponibile per l'uso. + `RESTRICTED_AUTHOR`: questo ruolo non è attualmente disponibile per l'uso. Type: Stringa Valori validi: ` ADMIN | AUTHOR | READER | RESTRICTED_AUTHOR | RESTRICTED_READER` Campo: Sì ** [CustomFederationProviderUrl](#API_RegisterUser_RequestSyntax) ** L'URL del provider OpenID Connect (OIDC) personalizzato che fornisce l'identità per consentire a un utente di federarsi in Amazon QuickSight con un associata aAWS Identity and Access Management(IAM). Questo parametro deve essere utilizzato solo quando`ExternalLoginFederationProviderType`Il parametro è impostato su`CUSTOM_OIDC`. Type: Stringa Campo: No ** [CustomPermissionsName](#API_RegisterUser_RequestSyntax) ** (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 aggiornamento dei report via e-mail + Sottoscrivere a Per aggiungere autorizzazioni personalizzate a un utente esistente, utilizzare` [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html) `invece. 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, utilizzi il plugin`RegisterUser`Operazione API per assegnare il set di autorizzazioni denominato a un Amazon QuickSight utente. Amazon QuickSight Le autorizzazioni personalizzate vengono applicate tramite 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 Limitazioni di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `^[a-zA-Z0-9+=,.@_-]+$` Campo: No ** [ExternalLoginFederationProviderType](#API_RegisterUser_RequestSyntax) ** Il tipo di provider di accesso esterno supportato che fornisce l'identità per consentire a un utente di federarsi in Amazon QuickSight con un associata aAWS Identity and Access Management(IAM). Il tipo di provider di accesso esterno supportato può assumere uno dei seguenti valori. + `COGNITO`: Amazon Cognito. L'URL del provider è cognito-identity.amazonaws.com. Quando si sceglie il`COGNITO`tipo di provider, non utilizzare»CustomFederationProviderUrl«parametro che è necessario solo quando il provider esterno è personalizzato. + `CUSTOM_OIDC`: OpenID obbligatorio (OIDC). Quando si sceglie`CUSTOM_OIDC`digitare, utilizzare il`CustomFederationProviderUrl`per fornire l'URL del provider OIDC personalizzato. Type: Stringa Campo: No ** [ExternalLoginId](#API_RegisterUser_RequestSyntax) ** L'ID di identità di un utente nel provider di accesso esterno. Type: Stringa Campo: No ** [IamArn](#API_RegisterUser_RequestSyntax) ** L'ARN dell'utente o del ruolo IAM che si sta registrando con Amazon QuickSight. Type: Stringa Campo: No ** [SessionName](#API_RegisterUser_RequestSyntax) ** È necessario utilizzare questo parametro solo quando si registrano uno o più utenti utilizzando un ruolo IAM presunto. Non è necessario fornire il nome della sessione per altri scenari, ad esempio quando si registra un utente IAM o un Amazon QuickSight utente. È possibile registrare più utenti utilizzando lo stesso ruolo IAM se ogni utente ha un nome di sessione diverso. Per ulteriori informazioni sull'assunzione dei ruoli IAM, consulta l'[https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html](https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html)nella* AWS CLIInformazioni di riferimento.* Type: Stringa Limitazioni di lunghezza: Lunghezza minima pari a 2. La lunghezza massima è 64 caratteri. Modello: `[\w+=.@-]*` Campo: No ** [UserName](#API_RegisterUser_RequestSyntax) ** L'Amazon QuickSight nome utente che si desidera creare per l'utente che si sta registrando. Type: Stringa Limitazioni di lunghezza: Lunghezza minima pari a 1. Modello: `[\u0020-\u00FF]+` Campo: 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" }, "UserInvitationUrl": "string" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce la seguente risposta HTTP. ** [Status](#API_RegisterUser_ResponseSyntax) ** Lo stato HTTP della richiesta. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [RequestId](#API_RegisterUser_ResponseSyntax) ** LaAWSCampo obbligatorio per questa operazione. Type: Stringa ** [User](#API_RegisterUser_ResponseSyntax) ** Il nome utente dell'utente. Tipo: [User](API_User.md) oggetto ** [UserInvitationUrl](#API_RegisterUser_ResponseSyntax) ** L'URL visitato dall'utente per completare la registrazione e fornire una password. Viene restituito solo per gli utenti con un tipo di identità di`QUICKSIGHT`. Type: Stringa ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md). ** AccessDeniedException ** Non hai accesso a questo articolo. 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 ** 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 ** LimitExceededException ** È stato superato un limite. Codice di stato HTTP: 409 ** PreconditionNotMetException ** Una o più precondizioni non sono soddisfatte. Codice di stato HTTP: 400 ** ResourceExistsException ** La risorsa specificata esiste già. Codice di stato HTTP: 409 ** ResourceNotFoundException ** Uno o più risorse non sono state trovate. Codice di stato HTTP: 404 ** ResourceUnavailableException ** Questa risorsa al momento non è disponibile. Codice di stato HTTP: 503 ** ThrottlingException ** L'accesso è limitato. Codice di stato HTTP: 429 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: + [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/RegisterUser) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/RegisterUser) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/RegisterUser) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/RegisterUser) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/RegisterUser) + [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/RegisterUser) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/RegisterUser) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/RegisterUser) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/RegisterUser)