Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
UpdateCertificate
Aggiorna le date attive e inattive di un certificato.
Sintassi della richiesta
{
"ActiveDate": number
,
"CertificateId": "string
",
"Description": "string
",
"InactiveDate": number
}
Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati nel JSON formato.
- ActiveDate
-
Una data opzionale che specifica quando il certificato diventa attivo.
Tipo: Timestamp
Campo obbligatorio: no
- CertificateId
-
L'identificatore dell'oggetto certificato che stai aggiornando.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 22.
Modello:
cert-([0-9a-f]{17})
Campo obbligatorio: sì
- Description
-
Una breve descrizione per aiutare a identificare il certificato.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 200.
Modello:
[\p{Graph}]+
Campo obbligatorio: no
- InactiveDate
-
Una data opzionale che specifica quando il certificato cessa di essere attivo.
Tipo: Timestamp
Campo obbligatorio: no
Sintassi della risposta
{
"CertificateId": "string"
}
Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- CertificateId
-
Restituisce l'identificatore dell'oggetto certificato che si sta aggiornando.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa pari a 22.
Modello:
cert-([0-9a-f]{17})
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalServiceError
-
Questa eccezione viene generata quando si verifica un errore nel servizio. AWS Transfer Family
HTTPCodice di stato: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
HTTPCodice di stato: 500
- ThrottlingException
-
La richiesta è stata negata a causa del throttling della richiesta.
HTTPCodice di stato: 400
Esempi
Esempio
L'esempio seguente aggiorna la data attiva di un certificato, impostando la data attiva al 16 gennaio 2022 alle 16:12:07 UTC -5 ore.
Richiesta di esempio
aws transfer update-certificate --certificate-id c-abcdefg123456hijk --active-date 2022-01-16T16:12:07-05:00
Esempio
Di seguito è riportato un esempio di risposta per questa API chiamata.
Risposta di esempio
"CertificateId": "c-abcdefg123456hijk"
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API opzione in una delle lingue specifiche AWS SDKs, consulta quanto segue: