AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

TransferCertificate

将指定证书传输到指定 AWS 账户。

在接收方确认之前,您可以取消传输。

系统不向传输目标的账户发送任何通知,而是由调用方通知传输目标。

所传输的证书不能处于 ACTIVE 状态。您可以使用 UpdateCertificate API 来停用它。

该证书不能附加有任何策略。您可以使用 DetachPrincipalPolicy API 来分离它们。

请求语法:

PATCH /transfer-certificate/certificateId?targetAwsAccount=targetAwsAccount Content-type: application/json { "transferMessage": "string" }

URI 请求参数:

名称

类型

请求?

描述

certificateId

CertificateId

证书的 ID。(证书 ARN 的最后一部分包含证书 ID。)

targetAwsAccount

AwsAccountId

AWS 账户。

请求正文参数:

名称

类型

请求?

描述

transferMessage

Message

传输消息。

响应语法:

Content-type: application/json { "transferredCertificateArn": "string" }

响应正文参数:

名称

类型

请求?

描述

transferredCertificateArn

CertificateArn

证书的 ARN。

错误:

InvalidRequestException

请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。

HTTP 响应代码:400

ResourceNotFoundException

指定的资源不存在。

HTTP 响应代码:404

CertificateStateException

不允许执行该证书操作。

HTTP 响应代码:406

TransferConflictException

由于仍附加有授权策略,您无法传输证书。

HTTP 响应代码:409

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

CLI

摘要:

aws iot transfer-certificate \ --certificate-id <value> \ --target-aws-account <value> \ [--transfer-message <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "certificateId": "string", "targetAwsAccount": "string", "transferMessage": "string" }

cli-input-json 字段:

名称

类型

描述

certificateId

字符串

最大长度:64,最小长度:64

模式:(0x)?[a-fA-F0-9]+

证书的 ID。(证书 ARN 的最后一部分包含证书 ID。)

targetAwsAccount

字符串

模式:[0-9]{12}

AWS 账户。

transferMessage

字符串

最大长度:128

传输消息。

输出:

{ "transferredCertificateArn": "string" }

cli 输出字段:

名称

类型

描述

transferredCertificateArn

字符串

证书的 ARN。

本页内容: