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