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