/transfer-certificate/{certificateId}

The AWS IoT Wireless multi-region endpoint

https://api.iotwireless.{region}.amazonaws.com

PATCH

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.

Request

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠480InvalidRequestException

🟠481ResourceNotFoundException

🟠482CertificateStateException

🟠483TransferConflictException

🟠484ThrottlingException

🟠485UnauthorizedException

🟠486ServiceUnavailableException

🟠487InternalFailureException

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "transferredCertificateArn": "string"
}

Modified at 2022-09-10 23:12:18

/authorizer/{authorizerName}/test

/untag