翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # アクション 以下のアクションがサポートされています: + [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md) + [DeleteAlternateContact](API_DeleteAlternateContact.md) + [DisableRegion](API_DisableRegion.md) + [EnableRegion](API_EnableRegion.md) + [GetAccountInformation](API_GetAccountInformation.md) + [GetAlternateContact](API_GetAlternateContact.md) + [GetContactInformation](API_GetContactInformation.md) + [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md) + [GetPrimaryEmail](API_GetPrimaryEmail.md) + [GetRegionOptStatus](API_GetRegionOptStatus.md) + [ListRegions](API_ListRegions.md) + [PutAccountName](API_PutAccountName.md) + [PutAlternateContact](API_PutAlternateContact.md) + [PutContactInformation](API_PutContactInformation.md) + [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) # AcceptPrimaryEmailUpdate 指定されたアカウントの主要な E メールアドレス (ルートユーザーの E メールアドレスとも呼ばれる) を更新するために、[StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) から発信されたリクエストを受け入れます。 ## リクエストの構文 ``` POST /acceptPrimaryEmailUpdate HTTP/1.1 Content-type: application/json { "AccountId": "string", "Otp": "string", "PrimaryEmail": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 このオペレーションは、メンバーアカウントに対して、組織の管理アカウントまたは委任管理者アカウントからのみ呼び出すことができます。 管理アカウントは、自身の `AccountId` を指定することはできません。 タイプ: 文字列 Pattern: `\d{12}` 必須: はい ** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** `StartPrimaryEmailUpdate` API コールで指定された `PrimaryEmail` に送信される OTP コード。 タイプ: 文字列 Pattern: `[a-zA-Z0-9]{6}` 必須: はい ** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) ** 指定されたアカウントで使用する新しい主要 E メールアドレス。これは、`StartPrimaryEmailUpdate` API コールからの `PrimaryEmail` と一致する必要があります。 タイプ: 文字列 長さの制限: 最小長は 5。最大長 64 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "Status": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) ** 受け入れられた主要 E メール更新リクエストのステータスを取得します。 型: 文字列 有効な値：`PENDING | ACCEPTED` ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** ConflictException ** リソースの現在のステータスが競合しているため、リクエストを処理できませんでした。例えば、現在無効化中 (DISABLING ステータス) のリージョンを有効化しようとした場合や、アカウントのルートユーザーの E メールを、既に使用している E メールアドレスに変更しようとした場合にこれが発生します。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 409 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate) # DeleteAlternateContact 指定された代替連絡先を から削除します AWS アカウント。 代替連絡先オペレーションの使用方法については、「[AWS アカウントの代替連絡先を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)」を参照してください。 **注記** AWS アカウント が管理する の代替連絡先情報を更新する前に AWS Organizations、まず AWS アカウント管理と Organizations の統合を有効にする必要があります。詳細については、「[AWS アカウント管理用の信頼されたアクセスの有効化](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)」を参照してください。 ## リクエストの構文 ``` POST /deleteAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_DeleteAlternateContact_RequestSyntax) ** このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。 このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。 このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。 組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) ** 削除する代替連絡先を指定します。 型: 文字列 有効な値：`BILLING | OPERATIONS | SECURITY` 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 例 ### 例 1 次の例では、操作の呼び出しに使用される認証情報を持つアカウントのセキュリティ代替連絡先を削除します。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AccountName":"MyAccount" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 例 2 次の例では、組織内の指定されたメンバーアカウントの請求代行連絡先を削除します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AccountId":"123456789012", "AlternateContactType":"BILLING" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact) # DisableRegion アカウントの特定のリージョンを無効化 (オプトアウト) します。 **注記** リージョンを無効化すると、そのリージョンに存在するリソースへのすべての IAM アクセスが削除されます。 ## リクエストの構文 ``` POST /disableRegion HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_DisableRegion_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。 組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [RegionName](#API_DisableRegion_RequestSyntax) ** 特定のリージョン名のリージョンコードを指定します (例: `af-south-1`)。リージョンを無効にすると、 AWS は、リージョン内の IAM リソースを破棄するなど、アカウント内のそのリージョンを非アクティブ化するアクションを実行します。ほとんどのアカウントでは、このプロセスに数分かかりますが、数時間かかることがあります。無効化プロセスが完全に完了するまで、そのリージョンを有効化することはできません。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** ConflictException ** リソースの現在のステータスが競合しているため、リクエストを処理できませんでした。例えば、現在無効化中 (DISABLING ステータス) のリージョンを有効化しようとした場合や、アカウントのルートユーザーの E メールを、既に使用している E メールアドレスに変更しようとした場合にこれが発生します。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 409 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DisableRegion) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion) # EnableRegion アカウントに対して特定のリージョンを有効化 (オプトイン) します。 ## リクエストの構文 ``` POST /enableRegion HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_EnableRegion_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。 組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [RegionName](#API_EnableRegion_RequestSyntax) ** 特定のリージョン名のリージョンコードを指定します (例: `af-south-1`)。リージョンを有効にすると、そのリージョンへの IAM リソースの配信など、 AWS がそのリージョンでアカウントを準備するためのアクションを実行します。このプロセスは、ほとんどのアカウントでは数分で完了しますが、数時間かかることもあります。このプロセスが完了するまでそのリージョンを使用することはできません。さらに、有効化プロセスが完全に完了するまで、そのリージョンを無効化することはできません。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** ConflictException ** リソースの現在のステータスが競合しているため、リクエストを処理できませんでした。例えば、現在無効化中 (DISABLING ステータス) のリージョンを有効化しようとした場合や、アカウントのルートユーザーの E メールを、既に使用している E メールアドレスに変更しようとした場合にこれが発生します。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 409 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/EnableRegion) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion) # GetAccountInformation アカウント名、アカウント ID、アカウント作成日時など、指定されたアカウントに関する情報を取得します。この API を使用するには、IAM ユーザーまたはロールに `account:GetAccountInformation` IAM アクセス許可が必要です。 ## リクエストの構文 ``` POST /getAccountInformation HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_GetAccountInformation_RequestSyntax) ** このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。 このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。 このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。 組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "AccountCreatedDate": "string", "AccountId": "string", "AccountName": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) ** アカウントが作成された日時。 タイプ: タイムスタンプ ** [AccountId](#API_GetAccountInformation_ResponseSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 このオペレーションは、メンバーアカウントに対して、組織の管理アカウントまたは委任管理者アカウントからのみ呼び出すことができます。 管理アカウントは、自身の `AccountId` を指定することはできません。 タイプ: 文字列 パターン: `\d{12}` ** [AccountName](#API_GetAccountInformation_ResponseSyntax) ** アカウントの名前。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 パターン: `[ -;=?-~]+` ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 例 ### 例 1 次の例では、オペレーションの呼び出しに使用される認証情報を持つアカウントのアカウント情報を取得します。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAccountInformation {} ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AccountId": "123456789012", "AccountName": "MyAccount", "AccountCreatedDate": "2020-11-30T17:44:37Z" } ``` ### 例 2 次の例では、組織内の指定されたメンバーアカウントのアカウント情報を取得します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAccountInformation { "AccountId": "123456789012" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AccountId": "123456789012", "AccountName": "MyMemberAccount", "AccountCreatedDate": "2020-11-30T17:44:37Z" } ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation) # GetAlternateContact にアタッチされた指定された代替連絡先を取得します AWS アカウント。 代替連絡先オペレーションの使用方法については、「[AWS アカウントの代替連絡先を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)」を参照してください。 **注記** AWS アカウント が管理する の代替連絡先情報を更新する前に AWS Organizations、まず AWS アカウント管理と Organizations の統合を有効にする必要があります。詳細については、「[AWS アカウント管理用の信頼されたアクセスの有効化](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)」を参照してください。 ## リクエストの構文 ``` POST /getAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_GetAlternateContact_RequestSyntax) ** このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。 このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。 このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。 組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) ** 取得する代替連絡先を指定します。 型: 文字列 有効な値：`BILLING | OPERATIONS | SECURITY` 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "AlternateContact": { "AlternateContactType": "string", "EmailAddress": "string", "Name": "string", "PhoneNumber": "string", "Title": "string" } } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) ** 指定された代替連絡先の詳細を含む構造体。 型: [AlternateContact](API_AlternateContact.md) オブジェクト ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 例 ### 例 1 次の例では、操作の呼び出しに使用される認証情報を持つアカウントのセキュリティ代替連絡先を取得します。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAlternateContact { "AlternateContactType":"SECURITY" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AlternateContact":{ "Name":"Anika", "Title":"COO", "EmailAddress":"anika@example.com", "PhoneNumber":"206-555-0198", "AlternateContactType":"Security" } } ``` ### 例 2 次の例では、組織内の指定されたメンバーアカウントの操作に関する代替連絡先を取得します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetAlternateContact { "AccountId":"123456789012", "AlternateContactType":"Operations" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json { "AlternateContact":{ "Name":"Anika", "Title":"COO", "EmailAddress":"anika@example.com", "PhoneNumber":"206-555-0198", "AlternateContactType":"Operations" } } ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact) # GetContactInformation AWS アカウントの主要連絡先情報を取得します。 主要連絡先オペレーションの使用方法については、「[AWS アカウントの主要連絡先情報を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)」を参照してください。 ## リクエストの構文 ``` POST /getContactInformation HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_GetContactInformation_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。 組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "ContactInformation": { "AddressLine1": "string", "AddressLine2": "string", "AddressLine3": "string", "City": "string", "CompanyName": "string", "CountryCode": "string", "DistrictOrCounty": "string", "FullName": "string", "PhoneNumber": "string", "PostalCode": "string", "StateOrRegion": "string", "WebsiteUrl": "string" } } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [ContactInformation](#API_GetContactInformation_ResponseSyntax) ** AWS アカウントに関連付けられた主要連絡先情報の詳細が含まれます。 型: [ContactInformation](API_ContactInformation.md) オブジェクト ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetContactInformation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation) # GetGovCloudAccountInformation GovCloud アカウント ID と状態など、指定された標準アカウント (存在する場合) にリンクされた GovCloud アカウントに関する情報を取得します。この API を使用するには、IAM ユーザーまたはロールに `account:GetGovCloudAccountInformation` IAM アクセス許可が必要です。 ## リクエストの構文 ``` POST /getGovCloudAccountInformation HTTP/1.1 Content-type: application/json { "StandardAccountId": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) ** このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。 このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。 このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。 組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "AccountState": "string", "GovCloudAccountId": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) ** リンクされた GovCloud アカウントのアカウント状態。 型: 文字列 有効な値：`PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) ** リンクされた GovCloud アカウントの 12 桁のアカウント ID 番号。 タイプ: 文字列 パターン: `\d{12}` ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** ResourceUnavailableException ** 現在利用できないリソースが指定されているため、オペレーションは失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 424 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 例 ### 例 1 次の の例では、 オペレーションの呼び出しに認証情報が使用されるアカウントのリンクされた GovCloud アカウント情報を取得します。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation {} ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json { "GovCloudAccountId": "123456789012", "AccountState": "ACTIVE" } ``` ### 例 2 次の の例では、組織内の指定されたメンバーアカウントのリンクされた GovCloud アカウント情報を取得します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation { "StandardAccountId": "111111111111" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json { "GovCloudAccountId": "123456789012", "AccountState": "ACTIVE" } ``` ### 例 3 次の例では、GovCloud アカウントにリンクされていない標準アカウントのリンクされた GovCloud アカウント情報を取得しようとします。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation { "StandardAccountId": "222222222222" } ``` #### レスポンス例 ``` HTTP/1.1 404 Content-Type: application/json { "message":"GovCloud Account ID not found for Standard Account - 222222222222." } ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation) # GetPrimaryEmail 指定されたアカウントの主要 E メールアドレスを取得します。 ## リクエストの構文 ``` POST /getPrimaryEmail HTTP/1.1 Content-type: application/json { "AccountId": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_GetPrimaryEmail_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 このオペレーションは、メンバーアカウントに対して、組織の管理アカウントまたは委任管理者アカウントからのみ呼び出すことができます。 管理アカウントは、自身の `AccountId` を指定することはできません。 タイプ: 文字列 Pattern: `\d{12}` 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "PrimaryEmail": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) ** 指定されたアカウントに関連付けられている主要 E メールアドレスを取得します。 タイプ: 文字列 長さの制限: 最小長は 5。最大長 64 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail) # GetRegionOptStatus 特定のリージョンのオプトインステータスを取得します。 ## リクエストの構文 ``` POST /getRegionOptStatus HTTP/1.1 Content-type: application/json { "AccountId": "string", "RegionName": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_GetRegionOptStatus_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。 組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [RegionName](#API_GetRegionOptStatus_RequestSyntax) ** 特定のリージョン名のリージョンコードを指定します (例: `af-south-1`)。この関数は、このパラメータに渡されたリージョンのステータスを返します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "RegionName": "string", "RegionOptStatus": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) ** 渡されたリージョンコード。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 ** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) ** リージョンが取り得るステータスの 1 つ (有効、有効化中、無効、無効化中、デフォルトで有効)。 型: 文字列 有効な値：`ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus) # ListRegions 特定のアカウントのすべてのリージョンと、それぞれのオプトインステータスをリストします。オプションで、このリストを `region-opt-status-contains` パラメータでフィルタリングできます。 ## リクエストの構文 ``` POST /listRegions HTTP/1.1 Content-type: application/json { "AccountId": "string", "MaxResults": number, "NextToken": "string", "RegionOptStatusContains": [ "string" ] } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_ListRegions_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。 組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [MaxResults](#API_ListRegions_RequestSyntax) ** コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で `NextToken` が提供されます。ページ分割を再開するには、後続コマンドの `starting-token` 引数で `NextToken` 値を指定します。 AWS CLI の外部で`NextToken`レスポンス要素を直接使用しないでください。使用例については、* AWS 「 コマンドラインインターフェイスユーザーガイド*」の[「ページ分割](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)」を参照してください。 タイプ: 整数 有効範囲: 最小値 は 1 です。最大値は 50 です。 必須: いいえ ** [NextToken](#API_ListRegions_RequestSyntax) ** ページ分割の開始場所を指定するために使用されるトークン。これは、以前に切り捨てられた応答からの `NextToken` です。使用例については、* AWS 「 コマンドラインインターフェイスユーザーガイド*」の[「ページ分割](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)」を参照してください。 タイプ: 文字列 長さの制約: 最小長は 0 です。最大長 1,000 必須: いいえ ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) ** 特定のアカウントのリージョンのリストをフィルタリングするために使用するリージョンステータス (有効化中、有効、無効化中、無効、デフォルトで有効) のリスト。例えば、値 ENABLING を渡すと、リージョンステータスが ENABLING であるリージョンのリストのみが返されます。 型: 文字列の配列 有効な値: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` 必須：いいえ ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Regions": [ { "RegionName": "string", "RegionOptStatus": "string" } ] } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [NextToken](#API_ListRegions_ResponseSyntax) ** 返されるデータがさらにある場合、これが設定されます。`list-regions` の `next-token` リクエストパラメータに渡す必要があります。 タイプ: 文字列 ** [Regions](#API_ListRegions_ResponseSyntax) ** これは、特定のアカウントのリージョンのリストです。あるいは、フィルタリングされたパラメータが使用された場合は、`filter` パラメータで設定されたフィルタ条件に一致するリージョンのリストです。 型: [Region](API_Region.md) オブジェクトの配列 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions) # PutAccountName 指定されたアカウントのアカウント名を更新します。この API を使用するには、IAM プリンシパルに `account:PutAccountName` IAM アクセス許可が必要です。 ## リクエストの構文 ``` POST /putAccountName HTTP/1.1 Content-type: application/json { "AccountId": "string", "AccountName": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_PutAccountName_RequestSyntax) ** このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。 このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。 このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。 組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [AccountName](#API_PutAccountName_RequestSyntax) ** アカウントの名前。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 パターン: `[ -;=?-~]+` 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 例 ### 例 1 次の例では、オペレーションの呼び出しに使用される認証情報を持つアカウント名を更新します。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAccountName { "AccountName":"MyAccount" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 例 2 次の例では、組織内の指定されたメンバーアカウントのアカウント名を更新します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAccountName { "AccountId": "123456789012", "AccountName": "MyMemberAccount" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName) # PutAlternateContact にアタッチされている指定された代替連絡先を変更します AWS アカウント。 代替連絡先オペレーションの使用方法については、「[AWS アカウントの代替連絡先を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html)」を参照してください。 **注記** AWS アカウント が管理する の代替連絡先情報を更新する前に AWS Organizations、まず AWS アカウント管理と Organizations の統合を有効にする必要があります。詳細については、「[AWS アカウント管理用の信頼されたアクセスの有効化](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html)」を参照してください。 ## リクエストの構文 ``` POST /putAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string", "EmailAddress": "string", "Name": "string", "PhoneNumber": "string", "Title": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_PutAlternateContact_RequestSyntax) ** このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。 このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。 このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。 組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) ** 作成または更新する代替連絡先を指定します。 型: 文字列 有効な値：`BILLING | OPERATIONS | SECURITY` 必須: はい ** [EmailAddress](#API_PutAlternateContact_RequestSyntax) ** 代替連絡先の電子メールアドレスを指定します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 254 です。 パターン: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*` 必須: はい ** [Name](#API_PutAlternateContact_RequestSyntax) ** 代替連絡先の名前を指定します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長 64 必須: はい ** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) ** 代替連絡先の電話番号を指定します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 25 です。 パターン: `[\s0-9()+-]+` 必須: はい ** [Title](#API_PutAlternateContact_RequestSyntax) ** 代替連絡先のタイトルを指定します。 タイプ: 文字列 長さの制約: 最小長は 1 です。最大長は 50 です。 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 例 ### 例 1 次の例では、操作の呼び出しに使用される認証情報を持つアカウントの請求代行連絡先を設定します。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAlternateContact { "AlternateContactType": "Billing", "Name": "Carlos Salazar", "Title": "CFO", "EmailAddress": "carlos@example.com", "PhoneNumber": "206-555-0199" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ### 例 2 次の例では、組織内の指定されたメンバーアカウントの請求代行連絡先を設定または上書きします。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。 #### リクエスト例 ``` POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.PutAlternateContact { "AccountId": "123456789012", "AlternateContactType": "Billing", "Name": "Carlos Salazar", "Title": "CFO", "EmailAddress": "carlos@example.com", "PhoneNumber": "206-555-0199" } ``` #### レスポンス例 ``` HTTP/1.1 200 OK Content-Type: application/json ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact) # PutContactInformation AWS アカウントの主要連絡先情報を更新します。 主要連絡先オペレーションの使用方法については、「[AWS アカウントの主要連絡先情報を更新する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)」を参照してください。 ## リクエストの構文 ``` POST /putContactInformation HTTP/1.1 Content-type: application/json { "AccountId": "string", "ContactInformation": { "AddressLine1": "string", "AddressLine2": "string", "AddressLine3": "string", "City": "string", "CompanyName": "string", "CountryCode": "string", "DistrictOrCounty": "string", "FullName": "string", "PhoneNumber": "string", "PostalCode": "string", "StateOrRegion": "string", "WebsiteUrl": "string" } } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_PutContactInformation_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを指定しない場合、デフォルトで、オペレーションの呼び出しに使用された ID の Amazon Web Services アカウントになります。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 管理アカウントは、自身の `AccountId` を指定することはできません。`AccountId` パラメータを含めずに、スタンドアロンコンテキストでオペレーションを呼び出す必要があります。 組織のメンバーではないアカウントに対してこのオペレーションを呼び出す場合は、このパラメータを指定しないでください。代わりに、連絡先を取得または変更するアカウントに属する ID を使用してオペレーションを呼び出します。 タイプ: 文字列 パターン: `\d{12}` 必須: いいえ ** [ContactInformation](#API_PutContactInformation_RequestSyntax) ** AWS アカウントに関連付けられた主要連絡先情報の詳細が含まれます。 型: [ContactInformation](API_ContactInformation.md) オブジェクト 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 ``` ## レスポンス要素 アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutContactInformation) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation) # StartPrimaryEmailUpdate 指定されたアカウントの主要 E メールアドレスを更新するプロセスを開始します。 ## リクエストの構文 ``` POST /startPrimaryEmailUpdate HTTP/1.1 Content-type: application/json { "AccountId": "string", "PrimaryEmail": "string" } ``` ## URI リクエストパラメータ リクエストでは URI パラメータを使用しません。 ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) ** このオペレーションでアクセスまたは変更 AWS アカウント する の 12 桁のアカウント ID 番号を指定します。このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウントの ID である必要があります。指定されたアカウント ID は、同じ組織のメンバーアカウントである必要があります。組織は[すべての機能を有効にして](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。 このオペレーションは、メンバーアカウントに対して、組織の管理アカウントまたは委任管理者アカウントからのみ呼び出すことができます。 管理アカウントは、自身の `AccountId` を指定することはできません。 タイプ: 文字列 Pattern: `\d{12}` 必須: はい ** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) ** 指定されたアカウントで使用する新しい主要 E メールアドレス (ルートユーザーの E メールアドレスとも呼ばれる)。 タイプ: 文字列 長さの制限: 最小長は 5。最大長 64 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "Status": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) ** 主要 E メールの更新リクエストのステータス。 型: 文字列 有効な値：`PENDING | ACCEPTED` ## エラー すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** 呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 403 ** ConflictException ** リソースの現在のステータスが競合しているため、リクエストを処理できませんでした。例えば、現在無効化中 (DISABLING ステータス) のリージョンを有効化しようとした場合や、アカウントのルートユーザーの E メールを、既に使用している E メールアドレスに変更しようとした場合にこれが発生します。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 409 ** InternalServerException ** 内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 500 ** ResourceNotFoundException ** 見つからないリソースが指定されているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 404 ** TooManyRequestsException ** 操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。 ** errorType ** API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。 HTTP ステータスコード: 429 ** ValidationException ** 入力パラメータのいずれかが無効であるため、操作が失敗しました。 ** fieldList ** 無効なエントリが検出されたフィールド。 ** message ** リクエストのどの部分が無効だったかを知らせるメッセージ。 ** reason ** 検証が失敗した理由。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate)