Method: projects.locations.instances.backup

Instance de sauvegarde. Si c'est la première fois qu'une sauvegarde est créée, une collection de sauvegardes sera créée au niveau du backend, et cette sauvegarde appartiendra à cette collection. La collection et la sauvegarde auront un nom de ressource. La sauvegarde sera exécutée pour chaque partition. Une réplique (primaire si non HA) sera sélectionnée 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 la période d'aperçu, si la version logicielle interne de l'instance est trop ancienne, une mise à jour critique sera effectuée avant la sauvegarde proprement dite. 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 pas de mise à jour critique. Après la prévisualisation, aucune mise à jour critique ne sera nécessaire pour la sauvegarde.

Requête HTTP


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

Les URL utilisent 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. Valeur TTL avant expiration 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 de 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 aucune valeur n'est spécifiée, la valeur par défaut ([AAAAMMJJHHMMSS]_[UID de l'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.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Autorisations IAM

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

  • memorystore.instances.backup

Pour en savoir plus, consultez la documentation IAM.