AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginTransferCertificate and EndTransferCertificate.

Namespace: Amazon.IoT
Assembly: AWSSDK.IoT.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<TransferCertificateResponse> TransferCertificateAsync(
         TransferCertificateRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.IoT.Model.TransferCertificateRequest

Container for the necessary parameters to execute the TransferCertificate service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the TransferCertificate service method, as returned by IoT.

Exceptions

ExceptionCondition
CertificateStateException The certificate operation is not allowed.
InternalFailureException An unexpected error has occurred.
InvalidRequestException The request is not valid.
ResourceNotFoundException The specified resource does not exist.
ServiceUnavailableException The service is temporarily unavailable.
ThrottlingException The rate exceeds the limit.
TransferConflictException You can't transfer the certificate because authorization policies are still attached.
UnauthorizedException You are not authorized to perform this operation.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also