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.
UpdateFramework
Met à jour le framework spécifié.
Syntaxe de la requête
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
"
}
URIParamètres de demande
La demande utilise les URI paramètres suivants.
- frameworkName
-
Le nom unique d'un cadre. Ce nom contient entre 1 et 256 caractères, commence par une lettre et est composé de lettres (a à z, A à Z), de chiffres (0 à 9) et de traits de soulignement (_).
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle :
[a-zA-Z][_a-zA-Z0-9]*
Obligatoire : oui
Corps de la demande
La demande accepte les données suivantes au JSON format suivant.
- FrameworkControls
-
Les contrôles qui constituent le cadre. Chaque contrôle de la liste possède un nom, des paramètres d'entrée et une portée.
Type : tableau d’objets FrameworkControl
Obligatoire : non
- FrameworkDescription
-
Une description facultative du cadre avec 1 024 caractères au maximum.
Type : String
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 1024.
Modèle :
.*\S.*
Obligatoire : non
- IdempotencyToken
-
Chaîne choisie par le client que vous pouvez utiliser pour faire la distinction entre des appels par ailleurs identiques à
UpdateFrameworkInput
. Toute nouvelle tentative d'une demande réussie avec le même jeton d'idempotence entraîne un message de réussite sans qu'aucune action ne soit entreprise.Type : chaîne
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"FrameworkArn": "string",
"FrameworkName": "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.
- CreationTime
-
Date et heure de création d'un framework, en représentation ISO 8601. La valeur de
CreationTime
est précise en millisecondes. Par exemple, 2020-07-10T 15:00:00.000-08:00 représente le 10 juillet 2020 à 15 h 00 avec 8 heures de retard. UTCType : Timestamp
- FrameworkArn
-
Nom de ressource Amazon (ARN) qui identifie une ressource de manière unique. Le format du ARN dépend du type de ressource.
Type : String
- FrameworkName
-
Le nom unique d'un cadre. Ce nom contient entre 1 et 256 caractères, commence par une lettre et est composé de lettres (a à z, A à Z), de chiffres (0 à 9) et de traits de soulignement (_).
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle :
[a-zA-Z][_a-zA-Z0-9]*
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- AlreadyExistsException
-
La ressource demandée existe déjà.
HTTPCode de statut : 400
- ConflictException
-
AWS Backup ne peut pas exécuter l'action que vous avez demandée tant qu'il n'a pas terminé d'exécuter une action précédente. Réessayez ultérieurement.
HTTPCode de statut : 400
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
HTTPCode de statut : 400
- LimitExceededException
-
Une limite de la demande a été dépassée ; par exemple, le nombre maximum d'éléments autorisés dans une demande.
HTTPCode de statut : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
HTTPCode de statut : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
HTTPCode de statut : 500
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :