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

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

GetAlternateContact

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

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

注意

在更新由Amazon Organizations管理的的的备用联系人信息之前Amazon Web Services 账户，必须先启用Amazon账户管理与Organizations 之间的集成。有关更多信息，请参阅为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 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：