IoT / Client / update_certificate
update_certificate#
- IoT.Client.update_certificate(**kwargs)#
Updates the status of the specified certificate. This operation is idempotent.
Requires permission to access the UpdateCertificate action.
Certificates must be in the ACTIVE state to authenticate devices that use a certificate to connect to IoT.
Within a few minutes of updating a certificate from the ACTIVE state to any other state, IoT disconnects all devices that used that certificate to connect. Devices cannot use a certificate that is not in the ACTIVE state to reconnect.
See also: AWS API Documentation
Request Syntax
response = client.update_certificate( certificateId='string', newStatus='ACTIVE'|'INACTIVE'|'REVOKED'|'PENDING_TRANSFER'|'REGISTER_INACTIVE'|'PENDING_ACTIVATION' )
- Parameters:
certificateId (string) –
[REQUIRED]
The ID of the certificate. (The last part of the certificate ARN contains the certificate ID.)
newStatus (string) –
[REQUIRED]
The new status.
Note: Setting the status to PENDING_TRANSFER or PENDING_ACTIVATION will result in an exception being thrown. PENDING_TRANSFER and PENDING_ACTIVATION are statuses used internally by IoT. They are not intended for developer use.
Note: The status value REGISTER_INACTIVE is deprecated and should not be used.
- Returns:
None
Exceptions
IoT.Client.exceptions.ResourceNotFoundException
IoT.Client.exceptions.CertificateStateException
IoT.Client.exceptions.InvalidRequestException
IoT.Client.exceptions.ThrottlingException
IoT.Client.exceptions.UnauthorizedException
IoT.Client.exceptions.ServiceUnavailableException
IoT.Client.exceptions.InternalFailureException