CreateAccountSubscription - Amazon QuickSight

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateAccountSubscription

Amazon を作成します。 QuickSight アカウント、または Amazon に登録している QuickSight Q:

-AWS リージョンのアカウントは、AWS CLIまたは SDK。この操作は、米国東部 (オハイオ) リージョン、南米 (サンパウロ) リージョン、またはアジアパシフィック (シンガポール) リージョンではサポートされていません。

この操作を使用する前に、既存ののに接続できることを確かめてください。AWS アカウント。アカウントをお持ちでない場合は、AWS アカウント「」を参照してください。サインアップ:AWSアマゾン QuickSight ユーザーガイド。Amazonにサインアップする人 QuickSight 正しいものが必要ですAWS Identity and Access Management(IAM) 権限。詳細については、次を参照してください。Amazon の IAM ポリシーの例 QuickSightアマゾン QuickSight ユーザーガイド

IAM ポリシーにSubscribeそしてCreateAccountSubscriptionactions、両方のアクションがAllow。いずれかのアクションがDenyDenyアクションが優先され、API コールが失敗します。

既存の IAM ロールを渡して他にアクセスすることはできませんAWSこの API オペレーションを使用するサービス。既存の IAM ロールを Amazon に渡すには QuickSight「」を参照してください。IAM ロールを Amazon に渡す QuickSightアマゾン QuickSight ユーザーガイド

Amazonから新しいアカウントにデフォルトのリソースアクセスを設定することはできません QuickSightAPI。代わりに、Amazonからのデフォルトのリソースアクセスを追加します QuickSight console. デフォルトのリソースアクセス設定については、AWSサービス、「」を参照してくださいのデフォルトのリソースアクセスの設定AWSサービスアマゾン QuickSightユーザーガイド

リクエストの構文

POST /account/AwsAccountId HTTP/1.1 Content-type: application/json { "AccountName": "string", "ActiveDirectoryName": "string", "AdminGroup": [ "string" ], "AuthenticationMethod": "string", "AuthorGroup": [ "string" ], "ContactNumber": "string", "DirectoryId": "string", "Edition": "string", "EmailAddress": "string", "FirstName": "string", "LastName": "string", "NotificationEmail": "string", "ReaderGroup": [ "string" ], "Realm": "string" }

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

AwsAccountId

-AWS アカウントAmazon を作成するために使用しているアカウントの ID QuickSight アカウント.

長さの制約: 固定長は 12 です。

パターン: ^[0-9]{12}$

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

AccountName

Amazon の名前 QuickSight アカウント. この名前はすべての中で一意ですAWSと表示され、ユーザーがサインインした場合にのみ表示されます。「」は変更できませんAccountNameアマゾンの後の価値 QuickSight アカウントが作成されます。

Type: 文字列

必須: はい

AuthenticationMethod

Amazon を認証するために使用するメソッド QuickSight アカウント. 現在、このパラメータの有効な値は、IAM_AND_QUICKSIGHT,IAM_ONLY, およびACTIVE_DIRECTORY

選択内容ACTIVE_DIRECTORY、提供するActiveDirectoryNameAdminGroupは Active Directory に関連付けられています。

Type: 文字列

有効な値: IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY

必須: はい

Edition

Amazonのエディション QuickSight あなたのアカウントに持たせたいこと。現在、選択内容ENTERPRISEまたはENTERPRISE_AND_Q

選択内容ENTERPRISE_AND_Q「」を参照してください。

  • FirstName

  • LastName

  • EmailAddress

  • ContactNumber

Type: 文字列

有効な値: STANDARD | ENTERPRISE | ENTERPRISE_AND_Q

必須: はい

NotificationEmail

Amazonが欲しいEメールアドレス QuickSight お使いのAmazonに関する通知を送信する QuickSight アカウントまたは Amazon QuickSight サブスクリプション。

Type: 文字列

必須: はい

ActiveDirectoryName

アクティブディレクトリの名前。このフィールドは、ACTIVE_DIRECTORY新しいAmazonの選択された認証方法です QuickSight アカウント.

Type: 文字列

必須: いいえ

AdminGroup

Active Directory に関連付けられている管理者グループ。このフィールドは、ACTIVE_DIRECTORY新しいAmazonの選択された認証方法です QuickSight アカウント. AmazonでのActive Directorの使用方法については、 QuickSight「」を参照してください。Amazon でActive Directory を使用する QuickSight Enterprise Editionアマゾンで QuickSightユーザーガイド。

Type: 文字列の配列

必須: いいえ

AuthorGroup

Active Directory に関連付けられている作成者グループ。AmazonでのActive Directorの使用方法については、 QuickSight「」を参照してください。Amazon でActive Directory を使用する QuickSight Enterprise Editionアマゾンで QuickSightユーザーガイド。

Type: 文字列の配列

必須: いいえ

ContactNumber

Amazonの作成者の名、10桁の電話番号 QuickSight future 通信に使用するアカウント。このフィールドは、ENTERPPRISE_AND_Q新しいAmazonの選択されたエディションですか QuickSight アカウント.

Type: 文字列

必須: いいえ

DirectoryId

お使いのAmazonに関連付けられている Active Directory の ID QuickSight アカウント.

Type: 文字列

必須: いいえ

EmailAddress

Amazonの作者のEメールアドレス QuickSight future 通信に使用するアカウント。このフィールドは、ENTERPPRISE_AND_Q新しいAmazonの選択されたエディションですか QuickSight アカウント.

Type: 文字列

必須: いいえ

FirstName

Amazonの作者の名 QuickSight future 通信に使用するアカウント。このフィールドは、ENTERPPRISE_AND_Q新しいAmazonの選択されたエディションですか QuickSight アカウント.

Type: 文字列

必須: いいえ

LastName

Amazon の作者の姓。 QuickSight future 通信に使用するアカウント。このフィールドは、ENTERPPRISE_AND_Q新しいAmazonの選択されたエディションですか QuickSight アカウント.

Type: 文字列

必須: いいえ

ReaderGroup

Active Directory に関連付けられたリーダーグループ。AmazonでのActive Directorの使用方法については、 QuickSight「」を参照してください。Amazon でActive Directory を使用する QuickSight Enterprise Editionアマゾン QuickSightユーザーガイド

Type: 文字列の配列

必須: いいえ

Realm

Amazonに関連付けられているActive Directoryのレルム QuickSight アカウント. このフィールドは、ACTIVE_DIRECTORY新しいAmazonの選択された認証方法です QuickSight アカウント.

Type: 文字列

必須: いいえ

レスポンスの構文

HTTP/1.1 Status Content-type: application/json { "RequestId": "string", "SignupResponse": { "accountName": "string", "directoryType": "string", "IAMUser": boolean, "userLoginName": "string" } }

レスポンス要素

アクションが成功すると、以下の HTTP レスポンスが返されます。

Status

リクエストの HTTP ステータス。

サービスから以下のデータが JSON 形式で返されます。

RequestId

-AWSこの処理のリクエスト ID です。

Type: 文字列

SignupResponse

あるSignupResponse新しく作成された Amazon に関する情報を返すオブジェクト QuickSight アカウント.

型: SignupResponse オブジェクト

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AccessDeniedException

このアイテムにはアクセスできません。提供された認証情報を検証できませんでした。リクエストを実行する権限がない可能性があります。アカウントがAmazonの使用を許可されていることを確認してください QuickSight サービスの利用を許可されているアクセスキーを使っていること。

HTTP コード: 401

ConflictException

リソースを更新または削除すると、一貫性のない状態が発生する可能性があります。

HTTP コード: 409

InternalFailureException

内部エラーが発生しました。

HTTP コード: 500

InvalidParameterValueException

1 つ以上のパラメータに無効な値があります。

HTTP コード: 400

PreconditionNotMetException

1 つ以上の前提条件が満たされていません。​

HTTP コード: 400

ResourceExistsException

指定されたリソースは既に存在します。

HTTP コード: 409

ResourceNotFoundException

1 つ以上のリソースが見つかりません。

HTTP コード: 404

ResourceUnavailableException

このリソースは現在使用できません。

HTTP コード: 503

ThrottlingException

アクセスが調整済みです。

HTTP コード: 429

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。