UpdateFramework - AWS Backup

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à.

UpdateFramework

Aggiorna il framework specificato.

Sintassi della richiesta

PUT /audit/frameworks/frameworkName HTTP/1.1 Content-type: application/json { "FrameworkControls": [ { "ControlInputParameters": [ { "ParameterName": "string", "ParameterValue": "string" } ], "ControlName": "string", "ControlScope": { "ComplianceResourceIds": [ "string" ], "ComplianceResourceTypes": [ "string" ], "Tags": { "string" : "string" } } } ], "FrameworkDescription": "string", "IdempotencyToken": "string" }

URIParametri della richiesta

La richiesta utilizza i seguenti URI parametri.

frameworkName

Il nome univoco di un framework. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (_).

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z][_a-zA-Z0-9]*

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

FrameworkControls

I controlli che compongono il framework. Ogni controllo nell'elenco dispone di nome, parametri di input e ambito.

Tipo: matrice di oggetti FrameworkControl

Campo obbligatorio: no

FrameworkDescription

Descrizione facoltativa del framework, per un massimo di 1.024 caratteri.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.

Modello: .*\S.*

Campo obbligatorio: no

IdempotencyToken

Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a UpdateFrameworkInput. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.

Tipo: string

Campo obbligatorio: no

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "FrameworkArn": "string", "FrameworkName": "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.

CreationTime

La data e l'ora di creazione di un framework, nella rappresentazione ISO 8601. Il valore di CreationTime è preciso al millisecondo. Ad esempio, 2020-07-10T 15:00:00.000-08:00 rappresenta il 10 luglio 2020 alle 15:00 con 8 ore di ritardo. UTC

Tipo: Timestamp

FrameworkArn

Un Amazon Resource Name (ARN) che identifica in modo univoco una risorsa. Il formato di ARN dipende dal tipo di risorsa.

Tipo: stringa

FrameworkName

Il nome univoco di un framework. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (_).

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z][_a-zA-Z0-9]*

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AlreadyExistsException

La risorsa richiesta esiste già.

HTTPCodice di stato: 400

ConflictException

AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.

HTTPCodice di stato: 400

InvalidParameterValueException

Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.

HTTPCodice di stato: 400

LimitExceededException

È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.

HTTPCodice di stato: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

HTTPCodice di stato: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

HTTPCodice di stato: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

HTTPCodice di stato: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: