Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # UpdateUser Aktualisiert ein QuickSight Nutzer. ## Anforderungssyntax ``` 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 } ``` ## URI-Anfrageparameter Die Anforderung verwendet die folgenden URI-Parameter. ** [AwsAccountId](#API_UpdateUser_RequestSyntax) ** Die ID derAWSKonto, in dem sich der Benutzer befindet. Derzeit verwenden Sie die ID für dieAWS-Konto, das Ihr QuickSight Konto. Einschränkungen der Länge: Feste Länge von 12. Pattern: `^[0-9]{12}$` Erforderlich: Ja ** [Namespace](#API_UpdateUser_RequestSyntax) ** Der Namespace Derzeit sollten Sie dies setzen`default`. Einschränkungen der Länge: Höchstlänge = 64 Zeichen. Pattern: `^[a-zA-Z0-9._-]*$` Erforderlich: Ja ** [UserName](#API_UpdateUser_RequestSyntax) ** Der QuickSight -Benutzername, den Sie aktualisieren möchten. Einschränkungen der Länge: Mindestlänge 1. Pattern: `[\u0020-\u00FF]+` Erforderlich: Ja ## Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [Email](#API_UpdateUser_RequestSyntax) ** Die E-Mail-Adresse des Benutzers, den Sie aktualisieren möchten. Type: String Erforderlich: Ja ** [Role](#API_UpdateUser_RequestSyntax) ** Der QuickSight Rolle des Benutzers. Bei der Rolle kann es sich um einen der folgenden Standardsicherheitskohorten handeln: + `READER`: Ein Benutzer mit schreibgeschütztem Zugriff auf Dashboards. + `AUTHOR`: Ein Benutzer, der Datenquellen, Datasets, Analysen und Dashboards erstellen kann. + `ADMIN`: Ein Benutzer, der Autor ist und auch Amazon verwalten kann QuickSight-Einstellungen. Der Name des QuickSight ist für den Benutzer unsichtbar, mit Ausnahme der Konsolenbildschirme, die sich mit Berechtigungen befassen. Type: String Zulässige Werte:` ADMIN | AUTHOR | READER | RESTRICTED_AUTHOR | RESTRICTED_READER` Erforderlich: Ja ** [CustomFederationProviderUrl](#API_UpdateUser_RequestSyntax) ** Die URL des benutzerdefinierten OpenID Connect (OIDC) -Anbieters, der die Identität bereitstellt, damit ein Benutzer eine Verbindung zu Amazon herstellen kann QuickSight mit einemAWS Identity and Access Management(IAM) -Rolle. Dieser Parameter sollte nur verwendet werden, wenn`ExternalLoginFederationProviderType`-Parameter ist auf gesetzt`CUSTOM_OIDC`. Type: String Erforderlich: Nein ** [CustomPermissionsName](#API_UpdateUser_RequestSyntax) ** (Nur Enterprise Edition) Der Name des benutzerdefinierten Berechtigungsprofils, das Sie diesem Benutzer zuweisen möchten. Mit benutzerdefinierten Berechtigungen können Sie den Zugriff eines Benutzers steuern, indem Sie den Zugriff auf die folgenden Vorgänge einschränken: + Datenquellen erstellen und aktualisieren + Datensätze erstellen und aktualisieren + E-Mail-Berichte erstellen und aktualisieren + E-Mail-Berichte abonnieren Ein Satz benutzerdefinierter Berechtigungen umfasst eine beliebige Kombination dieser Einschränkungen. Derzeit müssen Sie die Profilnamen für benutzerdefinierte Berechtigungssätze mithilfe von Amazon erstellen QuickSightconsole. Dann verwenden Sie das`RegisterUser`API-Vorgang zum Zuweisen des benannten Berechtigungssatzes zu einem Amazon QuickSight Nutzer. Amazon QuickSight benutzerdefinierte Berechtigungen werden über IAM-Richtlinien angewendet. Daher überschreiben sie die normalerweise durch die Zuweisung von Amazon gewährten Berechtigungen. QuickSight Benutzer einer der Standardsicherheitskohorten in Amazon QuickSight (Administrator, Autor, Leser). Diese Funktion steht nur Amazon zur Verfügung QuickSight Abonnements der Enterprise-Edition. Type: String Einschränkungen der Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen. Pattern: `^[a-zA-Z0-9+=,.@_-]+$` Erforderlich: Nein ** [ExternalLoginFederationProviderType](#API_UpdateUser_RequestSyntax) ** Der Typ des unterstützten externen Anmeldeanbieters, der die Identität bereitstellt, damit ein Benutzer eine Verbindung zu Amazon herstellen kann QuickSight mit einemAWS Identity and Access Management(IAM) -Rolle. Beim Typ des externen Anmeldeanbieters kann es sich um einen der folgenden Werte handeln. + `COGNITO`: Amazon Cognito. Die Anbieter-URL lautet cognito-identity.amazonaws.com. Bei der Auswahl des`COGNITO`Anbietertyp, verwenden Sie nicht den“CustomFederationProviderUrl„Parameter, der nur benötigt wird, wenn der externe Anbieter benutzerdefiniert ist. + `CUSTOM_OIDC`: Benutzerdefinierter OpenID Connect-Anbieter (OIDC) -Anbieter. Bei der Auswahl`CUSTOM_OIDC`tippe, benutze das`CustomFederationProviderUrl`-Parameter, um die benutzerdefinierte OIDC-Anbieter-URL bereitzustellen. + `NONE`: Dadurch werden alle zuvor gespeicherten externen Anmeldeinformationen für einen Benutzer gelöscht. Verwenden der` [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html) `API-Operation zur Überprüfung der externen Anmeldeinformationen. Type: String Erforderlich: Nein ** [ExternalLoginId](#API_UpdateUser_RequestSyntax) ** Die Identity-ID für einen Benutzer im externen Anmeldeanbieter. Type: String Erforderlich: Nein ** [UnapplyCustomPermissions](#API_UpdateUser_RequestSyntax) ** Ein Flag, mit dem Sie angeben, dass Sie diesem Benutzer alle benutzerdefinierten Berechtigungen entfernen möchten. Durch die Verwendung dieses Parameters wird der Benutzer auf den Status zurückgesetzt, in dem er sich vor der Anwendung eines benutzerdefinierten Berechtigungsprofils befand. Dieser Parameter ist standardmäßig NULL und akzeptiert keinen anderen Wert. Type: Boolesch Erforderlich: Nein ## Antwortsyntax ``` 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" } } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück. ** [Status](#API_UpdateUser_ResponseSyntax) ** Der HTTP-Status der Anforderung. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [RequestId](#API_UpdateUser_ResponseSyntax) ** DieAWS-ID für diese Operation. Type: String ** [User](#API_UpdateUser_ResponseSyntax) ** Der QuickSight Nutzer. Typ: [User](API_User.md) Objekt ## Fehler Hinweise zu den Fehlern, die bei allen Aktionen auftreten, finden Sie unter[Häufige Fehler](CommonErrors.md). ** AccessDeniedException ** Sie haben keinen Zugriff auf diesen Artikel. Die bereitgestellten Anmeldeinformationen konnten nicht überprüft werden. Sie sind möglicherweise nicht berechtigt, die Anforderung auszuführen. Stellen Sie sicher, dass Ihr Konto für die Nutzung von Amazon autorisiert ist QuickSight -Dienst, dass Ihre Richtlinien die korrekten Berechtigungen besitzen und dass Sie die richtigen Zugriffsschlüssel verwenden. HTTP Status Code: 401 ** InternalFailureException ** Es ist ein interner Fehler aufgetreten. HTTP Status Code: 500 ** InvalidParameterValueException ** Ein oder mehrere Parameter haben einen Wert, der nicht gültig ist. HTTP Status Code: 400 ** PreconditionNotMetException ** Mindestens eine Vorbedingung ist nicht erfüllt. HTTP Status Code: 400 ** ResourceNotFoundException ** Mindestens eine Ressource kann nicht gefunden werden. HTTP Status Code: 404 ** ResourceUnavailableException ** Die Ressource ist derzeit nicht verfügbar. HTTP Status Code: 503 ** ThrottlingException ** Der Zugriff wird gedrosselt HTTP Status Code: 429 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: + [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/UpdateUser) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/UpdateUser) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/UpdateUser) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/UpdateUser) + [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/UpdateUser) + [AWSSDK-Statusfür JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/UpdateUser) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/UpdateUser) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/UpdateUser) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/UpdateUser)