/transfer-certificate/{certificateId}

Transfers the specified certificate to the specified Amazon Web Services account.

Requires permission to access the TransferCertificate action.

You can cancel the transfer until it is acknowledged by the recipient.

No notification is sent to the transfer destination's account. It is up to the caller to notify the transfer target.

The certificate being transferred must not be in the ACTIVE state. You can use the UpdateCertificate action to deactivate it.

The certificate must not have any policies attached to it. You can use the DetachPolicy action to detach them.

curl --location -g --request PATCH 'https://api.iotwireless.{region}.amazonaws.com/transfer-certificate/?targetAwsAccount=' \ --header 'Content-Type: application/json' \ --data-raw '{ "transferMessage": "string" }'

Request

Path Params

certificateId

string

required

The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)

Query Params

targetAwsAccount

string

required

The Amazon Web Services account.

Body Params application/json

transferMessage

string

optional

The transfer message.

<= 128 characters

Examples

Responses

🟢200Success

application/json

Body

The output from the TransferCertificate operation.

transferredCertificateArn

string

optional

The ARN of the certificate.

🟠480InvalidRequestException

🟠481ResourceNotFoundException

🟠482CertificateStateException

🟠483TransferConflictException

🟠484ThrottlingException

🟠485UnauthorizedException

🟠486ServiceUnavailableException

🟠487InternalFailureException