PutAlternateContact
AWS アカウント に添付された指定された代替連絡先を修正します。
代替連絡先オペレーションの使用方法については、「AWS アカウント の代替連絡先を更新する」を参照してください。
注記
AWS Organizations によって管理されている AWS アカウント の代替連絡先情報を更新する前に、まず AWS アカウント管理と組織の間の統合を有効にする必要があります。詳細については、「AWS アカウント管理用の信頼されたアクセスの有効化」を参照してください。
リクエストの構文
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
-
この操作でアクセスまたは変更する AWS アカウントの 12 桁のアカウント ID 番号を指定します。
このパラメータを指定しない場合、操作を呼び出したアイデンティティの AWS アカウントがデフォルトになります。
このパラメータを使用するには、呼び出し元が組織の管理アカウントまたは委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織はすべての機能を有効化して、アカウント管理サービス用の有効な信頼されたアクセスを持つ必要があり、オプションとして委任管理者アカウントが割り当てられます。
注記
管理アカウントは独自の
AccountIdアカウントを指定できません; これは、AccountIdパラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。
タイプ: 文字列
パターン:
\d{12}必須: いいえ
- AlternateContactType
-
作成または更新する代替連絡先を指定します。
型: 文字列
有効な値:
BILLING | OPERATIONS | SECURITY必須: はい
- EmailAddress
-
代替連絡先の電子メールアドレスを指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 254 です。
パターン:
[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*必須: はい
- Name
-
代替連絡先の名前を指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長 64
必須: はい
- PhoneNumber
-
代替連絡先の電話番号を指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 25 です。
パターン:
[\s0-9()+-]+必須: はい
- Title
-
代替連絡先のタイトルを指定します。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 50 です。
必須: はい
レスポンスの構文
HTTP/1.1 200
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- 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 SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。