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à.
CreateFramework
Crea un framework con uno o più controlli. Un framework è una raccolta di controlli che è possibile utilizzare per valutare le procedure di backup. Utilizzando controlli personalizzabili predefiniti per definire le policy, è possibile valutare se le procedure di backup sono conformi alle policy e quali risorse non sono ancora conformi.
Sintassi della richiesta
POST /audit/frameworks 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",
"FrameworkName": "string",
"FrameworkTags": {
"string" : "string"
},
"IdempotencyToken": "string"
}URIParametri di richiesta
La richiesta non utilizza alcun URI parametro.
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: sì
- FrameworkDescription
-
Una descrizione facoltativa del framework, con 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
- FrameworkName
-
Il nome univoco del framework. Il nome deve essere compreso tra 1 e 256 caratteri, deve iniziare con una lettera ed essere 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]*Campo obbligatorio: sì
- FrameworkTags
-
I tag da assegnare al framework.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
- IdempotencyToken
-
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a
CreateFrameworkInput. 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
{
"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.
- 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 del framework. Il nome deve essere compreso tra 1 e 256 caratteri, deve iniziare con una lettera ed essere 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
- 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
- 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:
