翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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。いずれかのアクションがDeny、Denyアクションが優先され、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、提供するActiveDirectoryNameとAdminGroupは 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 を使用する方法の詳細については、以下を参照してください。