UpdateCertificate - AWS Transfer Family

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

UpdateCertificate

Met à jour les dates d'activité et d'inactivité d'un certificat.

Syntaxe de la requête

{ "ActiveDate": number, "CertificateId": "string", "Description": "string", "InactiveDate": number }

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

La demande accepte le JSON format des données suivantes.

ActiveDate

Une date facultative qui indique à quel moment le certificat devient actif.

Type : Timestamp

Obligatoire : non

CertificateId

Identifiant de l'objet de certificat que vous mettez à jour.

Type : String

Contraintes de longueur : longueur fixe de 22.

Modèle : cert-([0-9a-f]{17})

Obligatoire : oui

Description

Brève description pour aider à identifier le certificat.

Type : String

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.

Modèle : [\p{Graph}]+

Obligatoire : non

InactiveDate

Une date facultative qui indique à quel moment le certificat devient inactif.

Type : Timestamp

Obligatoire : non

Syntaxe de la réponse

{ "CertificateId": "string" }

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées sous JSON forme formatée par le service.

CertificateId

Renvoie l'identifiant de l'objet de certificat que vous mettez à jour.

Type : String

Contraintes de longueur : longueur fixe de 22.

Modèle : cert-([0-9a-f]{17})

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

InternalServiceError

Cette exception est levée lorsqu'une erreur se produit dans le AWS Transfer Family service.

HTTPCode de statut : 500

InvalidRequestException

Cette exception est levée lorsque le client soumet une demande mal formée.

HTTPCode de statut : 400

ResourceNotFoundException

Cette exception est levée lorsqu'aucune ressource n'est trouvée par le service AWS Transfer Family.

HTTPCode de statut : 400

ServiceUnavailableException

La demande a échoué car le service AWS Transfer Family n'est pas disponible.

HTTPCode de statut : 500

ThrottlingException

La demande a été refusée suite à une limitation des demandes.

HTTPCode de statut : 400

Exemples

Exemple

L'exemple suivant met à jour la date d'activité d'un certificat, en la fixant au 16 janvier 2022 à 16:12:07 UTC -5 heures.

Exemple de demande

aws transfer update-certificate --certificate-id c-abcdefg123456hijk --active-date 2022-01-16T16:12:07-05:00

Exemple

Voici un exemple de réponse à cet API appel.

Exemple de réponse

"CertificateId": "c-abcdefg123456hijk"

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :