翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # RegisterUser Amazon を作成します QuickSight ユーザー (ID)AWS Identity and Access Management(IAM) リクエストで指定された ID またはロール。 ## リクエストの構文 ``` 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" } ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [AwsAccountId](#API_RegisterUser_RequestSyntax) ** の IDAWSユーザーが所属するアカウント。現在、この ID はAWSお使いのアカウントがAmazonを含むアカウント QuickSight アカウント. 長さの制約: 固定長は 12 です。 パターン: `^[0-9]{12}$` 必須 はい ** [Namespace](#API_RegisterUser_RequestSyntax) ** 名前空間。現在、これを設定する必要があります。`default`。 長さの制約: 最大長は 64 文字です。 パターン: `^[a-zA-Z0-9._-]*$` 必須 はい ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [Email](#API_RegisterUser_RequestSyntax) ** 登録したいユーザーの E メールアドレス。 Type: 文字列 必須 はい ** [IdentityType](#API_RegisterUser_RequestSyntax) ** アマゾン QuickSight は、ユーザの ID を管理するいくつかの方法をサポートしています。このパラメーターは 2 つの値を受け入れます。 + `IAM`: ID が既存の IAM ユーザーまたはロールにマッピングされるユーザー。 + `QUICKSIGHT`: ID が Amazon によって内部的に所有および管理されているユーザー QuickSight。 Type: 文字列 有効な値: ` IAM | QUICKSIGHT` 必須 はい ** [UserRole](#API_RegisterUser_RequestSyntax) ** ザ・アマゾン QuickSight ユーザーのロール ユーザーロールは、次のいずれかになります。 + `READER`: ダッシュボードへの読み取り専用アクセス権を持つユーザー + `AUTHOR`: データソース、およびダッシュボードを作成できます。 + `ADMIN`: 著者であり、Amazonも管理できるユーザー QuickSight[] 設定。 + `RESTRICTED_READER`: このロールは現在使用できません。 + `RESTRICTED_AUTHOR`: このロールは現在使用できません。 Type: 文字列 有効な値: ` ADMIN | AUTHOR | READER | RESTRICTED_AUTHOR | RESTRICTED_READER` 必須 はい ** [CustomFederationProviderUrl](#API_RegisterUser_RequestSyntax) ** ユーザーが Amazon にフェデレートできるようにするための ID を提供するカスタム OpenID Connect (OIDC) プロバイダーの URL QuickSight 関連付けAWS Identity and Access Management(IAM) ロール このパラメータを使用する必要があるのは、次の場合のみです。`ExternalLoginFederationProviderType`パラメータの設定`CUSTOM_OIDC`。 Type: 文字列 必須 いいえ ** [CustomPermissionsName](#API_RegisterUser_RequestSyntax) ** (Enterprise エディションのみ) このユーザーに割り当てるカスタム権限プロファイルの名前。カスタマイズされた権限を使用すると、次の操作でアクセスを制限することにより、ユーザーのアクセスを制御できます。 + データソースの作成と更新 + データセットの作成と更新 + メールレポートの作成と更新 + E メールレポートのサブスクライブ 既存のユーザーにカスタム権限を追加するには、を使用します。` [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html) `代わりに。 一連のカスタム権限には、これらの制限の任意の組み合わせが含まれます。現在、Amazon を使用してカスタム権限セットのプロファイル名を作成する必要があります QuickSightconsole. 次に、必須`RegisterUser`名前付きアクセス権限のセットを Amazon に割り当てる API オペレーション QuickSight ユーザー。 アマゾン QuickSight カスタム許可は IAM ポリシーによって適用されます。したがって、通常は Amazon を割り当てることによって付与されるアクセス許可よりも優先されます。 QuickSight Amazonのデフォルトのセキュリティコホートの1つにユーザーを参加させる QuickSight (管理者、著者、読者)。 この機能は Amazon でのみ使用できます QuickSight Enterprise Edition サブスクライブ Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 64 文字です。 パターン: `^[a-zA-Z0-9+=,.@_-]+$` 必須 いいえ ** [ExternalLoginFederationProviderType](#API_RegisterUser_RequestSyntax) ** ユーザーを Amazon にフェデレートさせるための ID を提供する、サポートされている外部ログインプロバイダーのタイプ QuickSight 関連付けAWS Identity and Access Management(IAM) ロール サポートされている外部ログインプロバイダーのタイプは、次のいずれかになります。 + `COGNITO`Amazon Cognito 須 プロバイダー URL は cognito-identity.amazonaws.com です。を選択するとき`COGNITO`プロバイダタイプ、」CustomFederationProviderUrl「パラメータ。外部プロバイダがカスタムの場合にのみ必要です。 + `CUSTOM_OIDC`OpenID 必須 選ぶとき`CUSTOM_OIDC`と入力し、`CustomFederationProviderUrl`パラメータを使用して、カスタムの OIDC プロバイダー URL を指定します。 Type: 文字列 必須 いいえ ** [ExternalLoginId](#API_RegisterUser_RequestSyntax) ** 外部ログインプロバイダーのユーザーのアイデンティティ ID。 Type: 文字列 必須 いいえ ** [IamArn](#API_RegisterUser_RequestSyntax) ** Amazon に登録している IAM ユーザーまたはロールの ARN QuickSight。 Type: 文字列 必須 いいえ ** [SessionName](#API_RegisterUser_RequestSyntax) ** このパラメータを使用する必要があるのは、引き受けた IAM ロールを使用する場合のみです。IAM ユーザーや Amazon を登録する場合など、他のシナリオではセッション名を指定する必要はありません。 QuickSight ユーザー。各ユーザーが異なるセッション名を使用した場合、同じ IAM ロールを使用して複数のユーザーを登録できます。IAM ロールを引き受ける詳細については、「」を参照してください。[https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html](https://docs.aws.amazon.com/cli/latest/reference/sts/assume-role.html)の* AWS CLIリファレンス* Type: 文字列 長さの制約: 最小長は 2 です｡ 最大長は 64 文字です。 パターン: `[\w+=.@-]*` 必須 いいえ ** [UserName](#API_RegisterUser_RequestSyntax) ** ザ・アマゾン QuickSight 登録しているユーザーに対して作成するユーザー名。 Type: 文字列 長さの制約: 最小長は 1 です｡ パターン: `[\u0020-\u00FF]+` 必須 いいえ ## レスポンスの構文 ``` 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" } ``` ## レスポンス要素 アクションが成功すると、以下の HTTP レスポンスが返されます。 ** [Status](#API_RegisterUser_ResponseSyntax) ** リクエストの HTTP ステータス。 サービスから以下のデータが JSON 形式で返されます。 ** [RequestId](#API_RegisterUser_ResponseSyntax) ** -AWSこのオペレーションのリクエストID Type: 文字列 ** [User](#API_RegisterUser_ResponseSyntax) ** ユーザーのユーザー名。 型: [User](API_User.md) オブジェクト ** [UserInvitationUrl](#API_RegisterUser_ResponseSyntax) ** ユーザーが登録を完了し、パスワードを入力するためにアクセスする URL。これは、ID タイプが`QUICKSIGHT`。 Type: 文字列 ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアイテムにはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。あなたのアカウントがAmazonの使用を許可されていることを確認してください QuickSight サービスの利用を許可したり、ポリシーに正しいアクセス許可があること、正しいアクセスキーを使っていることを確認してください。 ステータスステータスステータスステータスステータスステータスステータス 401 ** InternalFailureException ** 内部エラーが発生しました。 ステータスステータスステータスステータスステータスステータスステータス 500 ** InvalidParameterValueException ** 1 つ以上のパラメータに無効な値があります。 ステータスステータスステータスステータスステータスステータスステータス 400 ** LimitExceededException ** 制限を超過しています。 ステータスステータスステータスステータスステータスステータスステータス 409 ** PreconditionNotMetException ** 1 つ以上の前提条件が満たされていません。​ ステータスステータスステータスステータスステータスステータスステータス 400 ** ResourceExistsException ** 指定されたリソースは既に存在します。 ステータスステータスステータスステータスステータスステータスステータス 409 ** ResourceNotFoundException ** 1 つ以上のリソースが見つかりません。 ステータスステータスステータスステータスステータスステータスステータス 404 ** ResourceUnavailableException ** このリソースは現在使用できません。 ステータスステータスステータスステータスステータスステータスステータス 503 ** ThrottlingException ** アクセスが調整済みです。 ステータスステータスステータスステータスステータスステータスステータス 429 ## 以下の資料も参照してください。 言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/RegisterUser) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/RegisterUser) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/RegisterUser) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/RegisterUser) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/RegisterUser) + [AWS向け SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/RegisterUser) + [AWS SDK for 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)