Partager via

Créer un coffre de sauvegarde Azure à l’aide d’une API REST

Cet article explique comment créer un coffre de sauvegarde à l’aide de l’API REST. Vous pouvez également créer un coffre de sauvegarde à l’aide du portail Azure.

La nouvelle plateforme de protection des données de Sauvegarde Azure offre des fonctionnalités étendues pour la sauvegarde et la restauration de charges de travail plus récentes telles que les blobs dans des comptes de stockage, le disque managé et la plateforme PaaS du serveur PostgreSQL. Elle vise à réduire la surcharge de gestion tout en facilitant l’organisation des sauvegardes. Un « coffre de sauvegarde » est la pierre angulaire de la plateforme de protection des données, et diffère du coffre Recovery Services.

Les étapes de création d’un coffre de Sauvegarde Azure à l’aide d’une API REST sont décrites dans la documentation de l’API REST créer un coffre. Utilisons ce document comme référence pour créer un coffre appelé testBkpVault dans West US et sous le groupe de ressources TestBkpVaultRG.

Pour créer ou mettre à jour un coffre de sauvegarde Azure, utilisez l’opération PUT suivante.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01

Créer une demande

Pour créer la demande PUT, vous devez impérativement utiliser le paramètre {subscription-id}. Si vous avez plusieurs abonnements, consultez Utilisation de plusieurs abonnements. Vous devez définir les paramètres {resourceGroupName} et {vaultName} pour vos ressources, ainsi que le paramètre api-version. Cet article utilise api-version=2021-01-01.

Les en-têtes suivants sont requis :

En-tête de requête Descriptif
Content-Type : Obligatoire. Défini sur application/json.
Authorization : Obligatoire. Défini sur un jeton d’accèsBearer valide.

Pour plus d’informations sur la création de la demande, consultez Components of a REST API request/response (Composants d’une demande/réponse de l’API REST).

Créer le corps de la demande

Les définitions courantes suivantes permettent de générer un corps de demande :

Nom Obligatoire Type Descriptif
eTag Chaîne eTag facultatif
location vrai Chaîne Emplacement de la ressource
Propriétés vrai BackupVault Propriétés du coffre
Identité DPPIdentityDetails Identifie l’identificateur système unique de chaque ressource Azure.
tags Objet Balises de ressource

Notez que le nom de l’espace de stockage et le nom du groupe de ressources sont fournis dans l’URI PUT. Le corps de la requête définit l’emplacement.

Exemple de corps de demande

Le corps de l’exemple suivant est utilisé pour créer un coffre dans la région « USA Ouest ». Spécifiez l’emplacement.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Si vous souhaitez créer un coffre de sauvegarde et générer une identité attribuée par le système, le corps de demande suivant doit être spécifié.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "systemAssigned"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Réponses

La création d’un coffre de sauvegarde est une opération asynchrone. ce qui signifie qu’elle crée une autre opération qui doit faire l’objet d’un suivi distinct. Il existe deux réponses de réussite pour l’opération de création ou de mise à jour d’un coffre de sauvegarde :

Nom Type Descriptif
200 OK BackupVaultResource Ok
201 Créé BackupVaultResource Date de création
Autres codes d’état CloudError

Pour plus d’informations sur les réponses des API REST, consultez Process the response message (Traiter le message de réponse).

Exemple de réponse

Une réponse 201 Créé condensée à partir de l’exemple de corps de demande précédent affiche un ID assigné et l’état provisioningStateSucceeded :

{
    "eTag": null,
    "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
    "identity": {
      "principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "SystemAssigned"
    },
    "location": "westUS",
    "name": "testBkpVault",
    "properties": {
      "provisioningState": "Succeeded",
      "storageSettings": [
        {
          "datastoreType": "VaultStore",
          "type": "GeoRedundant"
        }
      ]
    },
    "resourceGroup": "TestBkpVaultRG",
    "systemData": null,
    "tags": {},
    "type": "Microsoft.DataProtection/backupVaults"
  }

Étapes suivantes

Créez une stratégie de sauvegarde pour sauvegarder les blobs dans ce coffre.

Pour plus d’informations sur l’envoi de travaux à l’aide des API REST Azure, consultez les documents suivants :

  • Last updated on