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.
UpdateRecoveryPointLifecycle
Définit le cycle de vie de transition d'un point de récupération.
Le cycle de vie définit le moment où une ressource protégée est transférée vers le stockage à froid et sa date d'expiration. AWS Backup effectue la transition et fait expirer les sauvegardes automatiquement en fonction du cycle de vie que vous définissez.
Les sauvegardes transférées vers un stockage à froid doivent être stockées dans le stockage à froid pendant au moins 90 jours. Par conséquent, le paramètre « rétention » doit être supérieur de 90 jours au paramètre « nombre de jours avant transfert vers stockage à froid ». Le paramètre « transition to cold after days (nombre de jours avant transfert vers stockage à froid) » ne peut pas être modifié après le transfert d'une sauvegarde vers un stockage à froid.
Les types de ressources pouvant être transférés vers le stockage à froid sont répertoriés dans la section « Cycle de vie vers le stockage à froid » du tableau Disponibilité des fonctionnalités par ressource. AWS Backup ignore cette expression pour les autres types de ressources.
Cette opération ne prend pas en charge les sauvegardes continues.
Syntaxe de la demande
POST /backup-vaults/backupVaultName
/recovery-points/recoveryPointArn
HTTP/1.1
Content-type: application/json
{
"Lifecycle": {
"DeleteAfterDays": number
,
"MoveToColdStorageAfterDays": number
,
"OptInToArchiveForSupportedResources": boolean
}
}
Paramètres de demande URI
La demande utilise les paramètres URI suivants.
- backupVaultName
-
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région AWS dans laquelle ils sont créés. Ces noms sont composés de lettres minuscules, des chiffres et de traits d'union.
Modèle :
^[a-zA-Z0-9\-\_]{2,50}$
Obligatoire : oui
- recoveryPointArn
-
Un Amazon Resource Name (ARN) qui identifie de façon unique un point de récupération ; par exemple,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
.Obligatoire : oui
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- Lifecycle
-
Le cycle de vie définit le moment où une ressource protégée est transférée vers le stockage à froid et sa date d'expiration. AWS Backup effectue la transition et fait expirer les sauvegardes automatiquement en fonction du cycle de vie que vous définissez.
Les sauvegardes transférées vers un stockage à froid doivent être stockées dans le stockage à froid pendant au moins 90 jours. Par conséquent, le paramètre « rétention » doit être supérieur de 90 jours au paramètre « nombre de jours avant transfert vers stockage à froid ». Le paramètre « transition to cold after days (nombre de jours avant transfert vers stockage à froid) » ne peut pas être modifié après le transfert d'une sauvegarde vers un stockage à froid.
Type : objet Lifecycle
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"CalculatedLifecycle": {
"DeleteAt": number,
"MoveToColdStorageAt": number
},
"Lifecycle": {
"DeleteAfterDays": number,
"MoveToColdStorageAfterDays": number,
"OptInToArchiveForSupportedResources": boolean
},
"RecoveryPointArn": "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 au format JSON par le service.
- BackupVaultArn
-
Un ARN qui identifie de façon unique un coffre-fort de sauvegarde ; par exemple,
arn:aws:backup:us-east-1:123456789012:vault:aBackupVault
.Type : chaîne
- CalculatedLifecycle
-
Un objet
CalculatedLifecycle
contenant des horodatagesDeleteAt
etMoveToColdStorageAt
.Type : objet CalculatedLifecycle
- Lifecycle
-
Le cycle de vie définit le moment où une ressource protégée est transférée vers le stockage à froid et sa date d'expiration. AWS Backup effectue la transition et fait expirer les sauvegardes automatiquement en fonction du cycle de vie que vous définissez.
Les sauvegardes transférées vers un stockage à froid doivent être stockées dans le stockage à froid pendant au moins 90 jours. Par conséquent, le paramètre « rétention » doit être supérieur de 90 jours au paramètre « nombre de jours avant transfert vers stockage à froid ». Le paramètre « transition to cold after days (nombre de jours avant transfert vers stockage à froid) » ne peut pas être modifié après le transfert d'une sauvegarde vers un stockage à froid.
Les types de ressources pouvant être transférés vers le stockage à froid sont répertoriés dans la section « Cycle de vie vers le stockage à froid » du tableau Disponibilité des fonctionnalités par ressource. AWS Backup ignore cette expression pour les autres types de ressources.
Type : objet Lifecycle
- RecoveryPointArn
-
Un Amazon Resource Name (ARN) qui identifie de façon unique un point de récupération ; par exemple,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45
.Type : chaîne
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
Code d’état HTTP : 400
- InvalidRequestException
-
Indique une erreur dans la saisie de la demande. Par exemple, un paramètre n'est pas du bon type.
Code d’état HTTP : 400
- MissingParameterValueException
-
Indique qu'un paramètre obligatoire est manquant.
Code d’état HTTP : 400
- ResourceNotFoundException
-
Aucune ressource requise pour l'action n'existe.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
Code d’état HTTP : 500
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :