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