GetAlternateContact - Amazon 账户管理
请求语法URI 请求参数请求体响应语法响应元素错误示例另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

GetAlternateContact

检索附加到 Amazon Web Services 账户 的指定备用联系人。

关于如何使用备用联系人操作的完整详细信息，请参阅访问或更新备用联系人。

注意

在更新由 Amazon Organizations 管理的 Amazon Web Services 账户 的备用联系人信息之前，必须先启用 Amazon 账户管理和组织之间的集成。有关更多信息，请参阅对 Amazon 账户管理启用可信的访问权限。

请求语法

POST /getAlternateContact HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AlternateContactType": "string"
}

URI 请求参数

该请求不使用任何 URI 参数。

请求体

请求接受采用 JSON 格式的以下数据。

AccountId

指定要通过此操作访问或修改的 Amazon 账户的 12 位账户 ID 号。

如果未指定此参数，则默认为调用此操作使用的身份的 Amazon 账户。

要使用此参数，调用方必须具有组织管理账户或委托管理员账户中的身份，并且指定的账户 ID 必须是同一组织中的成员账户。组织必须启用所有功能，且组织必须为账户管理服务启用可信访问权限，可选择分配委托管理员账户。

注意

管理账户无法自行指定其 AccountId；它必须在不包括 AccountId 参数的情况下，在独立上下文中调用此操作。

要对不是组织成员的账户调用此操作，不要指定此参数，请以属于要检索或修改其联系人的账户的身份调用此操作。

类型：字符串

模式：^\d{12}$

必需：否

AlternateContactType

指定要检索的备用联系人。

类型：字符串

有效值：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

包含指定备用联系人详细信息的结构。

类型：AlternateContact 对象

错误

有关所有操作的常见错误的信息，请参阅常见错误。

AccessDeniedException

操作失败，调用身份没有所需的最低权限。

HTTP 状态代码：403

InternalServerException

操作失败，Amazon 内部存在错误。请稍后重新尝试操作。

HTTP 状态代码：500

ResourceNotFoundException

操作失败，找不到指定的资源。

HTTP 状态代码：404

TooManyRequestsException

操作失败，调用频率过高且超过了节流限制。

HTTP 状态代码：429

ValidationException

操作失败，其中一个输入参数无效。

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"
    }   
}

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：