DeleteAlternateContact - AWS 帳戶管理

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DeleteAlternateContact

從刪除指定的替代連絡人 AWS 帳戶。

如需如何使用替代連絡人作業的完整詳細資訊,請參閱存取或更新替代連絡人

注意

您必須先啟用「 AWS 帳戶管理」與「Organ AWS 帳戶 izations」之間的整合 AWS Organizations,才能更新由管理的替代聯絡人資訊。如需詳細資訊,請參閱啟用 AWS 帳戶管理的受信任存取權

請求語法

POST /deleteAlternateContact HTTP/1.1 Content-type: application/json { "AccountId": "string", "AlternateContactType": "string" }

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

請求接受採用 JSON 格式的下列資料。

AccountId

指定您要透過此作業存取或修改的 AWS 帳戶的 12 位數帳號 ID 號碼。

如果您未指定此參數,它會預設為用來呼叫作業之識別的 AWS 帳戶。

若要使用此參數,來電者必須是組織管理帳戶中的身分識別或委派的系統管理員帳戶,而且指定的帳戶 ID 必須是相同組織中的成員帳戶。組織必須啟用所有功能,且組織必須啟用帳戶管理服務的受信任存取權,並選擇性地指派委派管理員帳戶。

注意

管理帳戶無法指定自己的帳戶AccountId;它必須在獨立內容中呼叫作業,方法是不包含AccountId參數。

若要在非組織成員的帳戶上呼叫此作業,請勿指定此參數,並使用屬於您要擷取或修改其連絡人之帳戶的識別碼呼叫作業。

類型:String

模式:^\d{12}$

必要:否

AlternateContactType

指定要刪除的替代連絡人。

類型:字串

有效值:BILLING | OPERATIONS | SECURITY

必要:是

回應語法

HTTP/1.1 200

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

AccessDeniedException

作業失敗,因為呼叫識別沒有必要的最低權限。

HTTP 狀態碼:403

InternalServerException

作業失敗,因為內部的錯誤 AWS。請稍後再試一次。

HTTP 狀態碼:500

ResourceNotFoundException

作業失敗,因為它指定了找不到的資源。

HTTP 狀態碼:404

TooManyRequestsException

作業失敗,因為呼叫頻率太頻繁且超過節流限制。

HTTP 狀態碼:429

ValidationException

作業失敗,因為其中一個輸入參數無效。

HTTP 狀態碼:400

範例

範例 1

下列範例會刪除其認證用於呼叫作業之帳戶的安全性替代連絡人。

請求範例

POST / HTTP/1.1 X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact { "AlternateContactType": "SECURITY" }

回應範例

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 SDK 中使用此 API 的詳細資訊,請參閱下列內容: