本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateAccountSubscription 建立 Amazon QuickSight 帳戶，或訂閱亞馬遜 QuickSight Q。所以此AWS 區域對於該帳戶是從中配置的內容衍生出來的AWS CLI或開發套件。美國東部 (俄亥俄) 區域、南美洲 (聖保羅) 區域或亞太區域 (新加坡) 區域不支援此作業。在使用此操作之前，請確保您可以連接到現有AWS 帳戶。如果您沒有AWS 帳戶，請參閱[註冊AWS](https://docs.aws.amazon.com/quicksight/latest/user/setting-up-aws-sign-up.html)中的*亞馬遜 QuickSight 使用者指南*。註冊亞馬遜的人 QuickSight 需要有正確的AWS Identity and Access Management(IAM) 許可權。如需詳細資訊，請參閱「」[Amazon 政策範例 QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)中的*亞馬遜 QuickSight 使用者指南*。如果您的 IAM 政策同時包含`Subscribe`和`CreateAccountSubscription`動作，請確定兩個動作都設定為`Allow`。如果其中一個動作設定為`Deny`，該`Deny`動作盛行，您的 API 呼叫失敗。您無法傳遞現有的 IAM 角色來存取其他角色AWS使用此 API 操作的服務。將您現有的 IAM 角色傳遞給亞馬遜 QuickSight，請參閱[將 IAM 角色傳遞給亞馬遜 QuickSight](https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html#security-create-iam-role)中的*亞馬遜 QuickSight 使用者指南*。您無法從亞馬遜對新帳戶設置默認資源訪問 QuickSightAPI。相反，從亞馬遜添加默認資源訪問 QuickSight console (英文) 如需將預設資源存取權設定為的相關資訊AWS服務，請參閱[將預設資源存取權限設定為AWS服務](https://docs.aws.amazon.com/quicksight/latest/user/scoping-policies-defaults.html)中的*亞馬遜 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](#API_CreateAccountSubscription_RequestSyntax) ** 所以此AWS 帳戶您用來建立 Amazon Amazon 的帳戶 ID QuickSight 帳戶。長度限制：長度固定為 12。模式：`^[0-9]{12}$` 必要：是 ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AccountName](#API_CreateAccountSubscription_RequestSyntax) ** Amazon 的名稱 QuickSight 帳戶。這個名稱在所有人中都是唯一的AWS，只有在使用者登入時才會顯示。您無法變更`AccountName`亞馬遜後的價值 QuickSight 已建立帳戶。類型：字串必要：是 ** [AuthenticationMethod](#API_CreateAccountSubscription_RequestSyntax) ** 您想要用來身份驗證您的亞馬遜方法 QuickSight 帳戶。目前，此參數的有效值為`IAM_AND_QUICKSIGHT`、`IAM_ONLY`，以及`ACTIVE_DIRECTORY`。如果選擇`ACTIVE_DIRECTORY`，提供一個`ActiveDirectoryName`和一個`AdminGroup`與您的 Active Directory 相關聯。類型：字串有效值：` IAM_AND_QUICKSIGHT | IAM_ONLY | ACTIVE_DIRECTORY` 必要：是 ** [Edition](#API_CreateAccountSubscription_RequestSyntax) ** 亞馬遜版 QuickSight 您希望您的帳戶擁有。目前，您可以選擇`ENTERPRISE`或者`ENTERPRISE_AND_Q`。如果選擇`ENTERPRISE_AND_Q`，下列是必要參數： + `FirstName` + `LastName` + `EmailAddress` + `ContactNumber` 類型：字串有效值：` STANDARD | ENTERPRISE | ENTERPRISE_AND_Q` 必要：是 ** [NotificationEmail](#API_CreateAccountSubscription_RequestSyntax) ** 您希望亞馬遜的電子郵件地址 QuickSight 傳送通知給您的 Amazon 相關資訊 QuickSight 帳戶或亞馬遜 QuickSight 訂閱。類型：字串必要：是 ** [ActiveDirectoryName](#API_CreateAccountSubscription_RequestSyntax) ** 您的 Active Directory 的名稱。如果您有，即需要此欄位`ACTIVE_DIRECTORY`是新亞馬遜選定的身份驗證方法 QuickSight 帳戶。類型：字串必要：否 ** [AdminGroup](#API_CreateAccountSubscription_RequestSyntax) ** 與您 Active Directory 相關聯的管理員群組。如果您有，即需要此欄位`ACTIVE_DIRECTORY`是新亞馬遜選定的身份驗證方法 QuickSight 帳戶。有關在亞馬遜使用 Active Directory 的詳細資訊 QuickSight，請參閱[Amazon 使用 Active Directory QuickSight 企業版本](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)在 Amazon QuickSight使用者指南。類型：字串陣列必要：否 ** [AuthorGroup](#API_CreateAccountSubscription_RequestSyntax) ** 與您 Active Directory 相關聯的作者群組。有關在亞馬遜使用 Active Directory 的詳細資訊 QuickSight，請參閱[Amazon 使用 Active Directory QuickSight 企業版本](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)在 Amazon QuickSight使用者指南。類型：字串陣列必要：否 ** [ContactNumber](#API_CreateAccountSubscription_RequestSyntax) ** 亞馬遜作者的 10 位數電話號碼 QuickSight 用於 future 通信的帳戶。如果您有，即需要此欄位`ENTERPPRISE_AND_Q`是新亞馬遜的精選版本 QuickSight 帳戶。類型：字串必要：否 ** [DirectoryId](#API_CreateAccountSubscription_RequestSyntax) ** 與您的 Amazon 相關聯的 Active Directory Directory ID QuickSight 帳戶。類型：字串必要：否 ** [EmailAddress](#API_CreateAccountSubscription_RequestSyntax) ** 亞馬遜作者的電子郵件地址 QuickSight 用於 future 通信的帳戶。如果您有，即需要此欄位`ENTERPPRISE_AND_Q`是新亞馬遜的精選版本 QuickSight 帳戶。類型：字串必要：否 ** [FirstName](#API_CreateAccountSubscription_RequestSyntax) ** 亞馬遜作者的名字 QuickSight 用於 future 通信的帳戶。如果您有，即需要此欄位`ENTERPPRISE_AND_Q`是新亞馬遜的精選版本 QuickSight 帳戶。類型：字串必要：否 ** [LastName](#API_CreateAccountSubscription_RequestSyntax) ** 亞馬遜作者的姓氏 QuickSight 用於 future 通信的帳戶。如果您有，即需要此欄位`ENTERPPRISE_AND_Q`是新亞馬遜的精選版本 QuickSight 帳戶。類型：字串必要：否 ** [ReaderGroup](#API_CreateAccountSubscription_RequestSyntax) ** 與您的「作用中導覽」相關聯的讀取器群組。有關在亞馬遜使用 Active Directory 的詳細資訊 QuickSight，請參閱[Amazon 使用 Active Directory QuickSight 企業版本](https://docs.aws.amazon.com/quicksight/latest/user/aws-directory-service.html)中的*亞馬遜 QuickSight使用者指南*。類型：字串陣列必要：否 ** [Realm](#API_CreateAccountSubscription_RequestSyntax) ** 與您的亞馬遜相關聯的活動目錄的領域 QuickSight 帳戶。如果您有，即需要此欄位`ACTIVE_DIRECTORY`是新亞馬遜選定的身份驗證方法 QuickSight 帳戶。類型：字串必要：否 ## 回應語法 ``` HTTP/1.1 Status Content-type: application/json { "RequestId": "string", "SignupResponse": { "accountName": "string", "directoryType": "string", "IAMUser": boolean, "userLoginName": "string" } } ``` ## 回應元素如果動作成功，則服務傳回下列 HTTP 回應。 ** [Status](#API_CreateAccountSubscription_ResponseSyntax) ** 請求的 HTTP 狀態。服務會傳回下列 JSON 格式的資料。 ** [RequestId](#API_CreateAccountSubscription_ResponseSyntax) ** 所以此AWS此操作的請求 ID。類型：字串 ** [SignupResponse](#API_CreateAccountSubscription_ResponseSyntax) ** 一個`SignupResponse`返回有關新創建的亞馬遜信息的對象 QuickSight 帳戶。類型：[SignupResponse](API_SignupResponse.md) 物件 ## 錯誤如需所有動作常見的錯誤相關資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無法存取此項目。提供的登入資料無法驗證。您可能無法取得授權以執行請求。確保您的帳戶已獲授權使用亞馬遜 QuickSight 服務，您的政策有正確許可，以及您使用正確的存取金鑰。 HTTP 狀態碼：HTTP 狀態碼：401 ** ConflictException ** 更新或刪除資源可能會導致不一致的狀態。 HTTP 狀態碼：HTTP 狀態碼：409 ** InternalFailureException ** 發生內部故障。 HTTP 狀態碼：HTTP 狀態碼：500 ** InvalidParameterValueException ** 一或多個參數的值無效。 HTTP 狀態碼：HTTP 狀態碼：400 ** PreconditionNotMetException ** 未滿足一個或多個先決條件。 HTTP 狀態碼：HTTP 狀態碼：400 ** ResourceExistsException ** 指定的資源已存在。 HTTP 狀態碼：HTTP 狀態碼：409 ** ResourceNotFoundException ** 無法找到一個或多個資源。 HTTP 狀態碼：HTTP 狀態碼：404 ** ResourceUnavailableException ** 此資源目前無法使用。 HTTP 狀態碼：HTTP 狀態碼：503 ** ThrottlingException ** 存取已調節。 HTTP 狀態碼：HTTP 狀態碼：429 ## 另請參閱如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS 命令列界面](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/CreateAccountSubscription) + [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/CreateAccountSubscription) + [適用於 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/CreateAccountSubscription) + [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/CreateAccountSubscription) + [適用於 Java 的 AWS 開發套件第 2 版](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) + [適用於 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/CreateAccountSubscription) + [適用於 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/CreateAccountSubscription) + [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/CreateAccountSubscription)