Method: projects.locations.instances.backup

Instance de sauvegarde. S'il s'agit de la première sauvegarde, une collection de sauvegardes est créée au niveau du backend, et cette sauvegarde lui appartient. La collection et la sauvegarde auront un nom de ressource. Une sauvegarde sera effectuée pour chaque fragment. Un réplica (principal si nonHA) sera sélectionné pour effectuer l'exécution. L'appel de sauvegarde sera refusé si une opération de sauvegarde ou de mise à jour est en cours. Notez que pendant l'aperçu, si la version logicielle interne de l'instance est trop ancienne, une mise à jour critique sera effectuée avant la sauvegarde réelle. Une fois la version logicielle interne mise à jour vers la version minimale requise par la fonctionnalité de sauvegarde, les sauvegardes ultérieures ne nécessiteront plus de mise à jour critique. Après la phase de preview, aucune mise à jour critique ne sera nécessaire pour la sauvegarde.

Requête HTTP

POST https://memorystore.googleapis.com/v1/{name=projects/*/locations/*/instances/*}:backup

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de l'instance au format projects/{projectId}/locations/{locationId}/instances/{instanceId}, où locationId fait référence à une région Google Cloud.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "ttl": string,
  "backupId": string
}
Champs
ttl

string (Duration format)

Facultatif. Durée de vie (TTL) de la sauvegarde. La plage de valeurs est comprise entre 1 jour et 100 ans. Si aucune valeur n'est spécifiée, la valeur par défaut est 100 ans.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
backupId

string

Facultatif. ID de la sauvegarde à créer. Si cette option n'est pas spécifiée, la valeur par défaut ([YYYYMMDDHHMMSS]_[UID d'instance abrégé] est utilisée.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • memorystore.instances.backup

Pour en savoir plus, consultez la documentation IAM.