

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

# CreateAccountSubscription
<a name="API_CreateAccountSubscription"></a>

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

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

この操作を使用する前に、既存ののに接続できることを確かめてください。AWS アカウント。アカウントをお持ちでない場合は、AWS アカウント「」を参照してください。[サインアップ:AWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)の*アマゾン QuickSight ユーザーガイド*。Amazonにサインアップする人 QuickSight 正しいものが必要ですAWS Identity and Access Management(IAM) 権限。詳細については、次を参照してください。[Amazon の IAM ポリシーの例 QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)の*アマゾン QuickSight ユーザーガイド*。

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

既存の IAM ロールを渡して他にアクセスすることはできませんAWSこの API オペレーションを使用するサービス。既存の IAM ロールを Amazon に渡すには QuickSight「」を参照してください。[IAM ロールを Amazon に渡す QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)の*アマゾン QuickSight ユーザーガイド*。

Amazonから新しいアカウントにデフォルトのリソースアクセスを設定することはできません QuickSightAPI。代わりに、Amazonからのデフォルトのリソースアクセスを追加します QuickSight console. デフォルトのリソースアクセス設定については、AWSサービス、「」を参照してください[のデフォルトのリソースアクセスの設定AWSサービス](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)の*アマゾン QuickSightユーザーガイド*。

## リクエストの構文
<a name="API_CreateAccountSubscription_RequestSyntax"></a>

```
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 リクエストパラメータ
<a name="API_CreateAccountSubscription_RequestParameters"></a>

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

 ** [AwsAccountId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AwsAccountId"></a>
-AWS アカウントAmazon を作成するために使用しているアカウントの ID QuickSight アカウント.  
長さの制約: 固定長は 12 です。  
パターン: `^[0-9]{12}$`   
必須: はい

## リクエストボディ
<a name="API_CreateAccountSubscription_RequestBody"></a>

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

 ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AccountName"></a>
Amazon の名前 QuickSight アカウント. この名前はすべての中で一意ですAWSと表示され、ユーザーがサインインした場合にのみ表示されます。「」は変更できません`AccountName`アマゾンの後の価値 QuickSight アカウントが作成されます。  
Type: 文字列  
必須: はい

 ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthenticationMethod"></a>
Amazon を認証するために使用するメソッド QuickSight アカウント. 現在、このパラメータの有効な値は、`IAM_AND_QUICKSIGHT`,`IAM_ONLY`, および`ACTIVE_DIRECTORY`。  
選択内容`ACTIVE_DIRECTORY`、提供する`ActiveDirectoryName`と`AdminGroup`は Active Directory に関連付けられています。  
Type: 文字列  
有効な値: ` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY`   
必須: はい

 ** [Edition](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Edition"></a>
Amazonのエディション QuickSight あなたのアカウントに持たせたいこと。現在、選択内容`ENTERPRISE`または`ENTERPRISE_AND_Q`。  
選択内容`ENTERPRISE_AND_Q`「」を参照してください。  
+  `FirstName` 
+  `LastName` 
+  `EmailAddress` 
+  `ContactNumber` 
Type: 文字列  
有効な値: ` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q`   
必須: はい

 ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-NotificationEmail"></a>
Amazonが欲しいEメールアドレス QuickSight お使いのAmazonに関する通知を送信する QuickSight アカウントまたは Amazon QuickSight サブスクリプション。  
Type: 文字列  
必須: はい

 ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ActiveDirectoryName"></a>
アクティブディレクトリの名前。このフィールドは、`ACTIVE_DIRECTORY`新しいAmazonの選択された認証方法です QuickSight アカウント.  
Type: 文字列  
必須: いいえ

 ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AdminGroup"></a>
Active Directory に関連付けられている管理者グループ。このフィールドは、`ACTIVE_DIRECTORY`新しいAmazonの選択された認証方法です QuickSight アカウント. AmazonでのActive Directorの使用方法については、 QuickSight「」を参照してください。[Amazon でActive Directory を使用する QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)アマゾンで QuickSightユーザーガイド。  
Type: 文字列の配列  
必須: いいえ

 ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-AuthorGroup"></a>
Active Directory に関連付けられている作成者グループ。AmazonでのActive Directorの使用方法については、 QuickSight「」を参照してください。[Amazon でActive Directory を使用する QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)アマゾンで QuickSightユーザーガイド。  
Type: 文字列の配列  
必須: いいえ

 ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ContactNumber"></a>
Amazonの作成者の名、10桁の電話番号 QuickSight future 通信に使用するアカウント。このフィールドは、`ENTERPPRISE_AND_Q`新しいAmazonの選択されたエディションですか QuickSight アカウント.  
Type: 文字列  
必須: いいえ

 ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-DirectoryId"></a>
お使いのAmazonに関連付けられている Active Directory の ID QuickSight アカウント.  
Type: 文字列  
必須: いいえ

 ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-EmailAddress"></a>
Amazonの作者のEメールアドレス QuickSight future 通信に使用するアカウント。このフィールドは、`ENTERPPRISE_AND_Q`新しいAmazonの選択されたエディションですか QuickSight アカウント.  
Type: 文字列  
必須: いいえ

 ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-FirstName"></a>
Amazonの作者の名 QuickSight future 通信に使用するアカウント。このフィールドは、`ENTERPPRISE_AND_Q`新しいAmazonの選択されたエディションですか QuickSight アカウント.  
Type: 文字列  
必須: いいえ

 ** [LastName](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-LastName"></a>
Amazon の作者の姓。 QuickSight future 通信に使用するアカウント。このフィールドは、`ENTERPPRISE_AND_Q`新しいAmazonの選択されたエディションですか QuickSight アカウント.  
Type: 文字列  
必須: いいえ

 ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-ReaderGroup"></a>
Active Directory に関連付けられたリーダーグループ。AmazonでのActive Directorの使用方法については、 QuickSight「」を参照してください。[Amazon でActive Directory を使用する QuickSight Enterprise Edition](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)の*アマゾン QuickSightユーザーガイド*。  
Type: 文字列の配列  
必須: いいえ

 ** [Realm](#API_CreateAccountSubscription_RequestSyntax) **   <a name="QS-CreateAccountSubscription-request-Realm"></a>
Amazonに関連付けられているActive Directoryのレルム QuickSight アカウント. このフィールドは、`ACTIVE_DIRECTORY`新しいAmazonの選択された認証方法です QuickSight アカウント.  
Type: 文字列  
必須: いいえ

## レスポンスの構文
<a name="API_CreateAccountSubscription_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "RequestId": "string",
   "SignupResponse": { 
      "accountName": "string",
      "directoryType": "string",
      "IAMUser": boolean,
      "userLoginName": "string"
   }
}
```

## レスポンス要素
<a name="API_CreateAccountSubscription_ResponseElements"></a>

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

 ** [Status](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-Status"></a>
リクエストの HTTP ステータス。

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

 ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-RequestId"></a>
-AWSこの処理のリクエスト ID です。  
Type: 文字列

 ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) **   <a name="QS-CreateAccountSubscription-response-SignupResponse"></a>
ある`SignupResponse`新しく作成された Amazon に関する情報を返すオブジェクト QuickSight アカウント.  
型: [SignupResponse](API_SignupResponse.md) オブジェクト

## エラー
<a name="API_CreateAccountSubscription_Errors"></a>

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

 ** 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

## 以下の資料も参照してください。
<a name="API_CreateAccountSubscription_SeeAlso"></a>

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS向け SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAccountSubscription) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAccountSubscription) 