Créer un coffre Azure Recovery Services à l'aide de l'API REST pour Sauvegarde Microsoft Azure

Article
04/10/2024

Cet article explique comment créer un coffre Azure Recovery Services à l’aide de l’API REST. Pour créer le coffre-fort à l'aide du Portail Microsoft Azure, consultez cet article.

Un coffre Recovery Services est une entité de stockage dans Azure qui héberge des données. Les données sont généralement des copies de données ou des informations de configuration pour des machines virtuelles, des charges de travail, des serveurs ou des stations de travail. Vous pouvez utiliser des coffres Recovery Services afin de stocker des données de sauvegarde pour divers services Azure tels que des machines virtuelles IaaS (Windows ou Linux) et SQL Server dans des machines virtuelles. Les coffres Recovery Services prennent en charge System Center DPM, Windows Server, le serveur de sauvegarde Azure et bien plus. Les coffres Recovery Services facilitent l’organisation de vos données de sauvegarde, tout en réduisant le temps de gestion.

Avant de commencer

La création d’un coffre-fort Azure Recovery Services à l’aide de l’API REST est décrite dans l’article Créer un coffre-fort REST API. Utilisons cet article comme référence pour créer un coffre-fort nommé testVault dans West US.

Pour créer ou mettre à jour un coffre Azure Recovery Services, utilisez l’opération PUT suivante :

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-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=2016-06-01.

Les en-têtes suivants sont requis :

En-tête de requête	Description
Content-Type :	Obligatoire. Défini sur `application/json`.
Authorization :	Obligatoire. Défini sur un jeton d’accès `Bearer` 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	Requise	Type	Description
eTag		String	eTag facultatif
location	true	String	Emplacement de la ressource
properties		VaultProperties	Propriétés du coffre
sku		Sku	Identifie l’identificateur système unique de chaque ressource Azure.
tags		Object	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

L'exemple de corps suivant est utilisé pour créer un coffre-fort dans West US. Spécifiez l’emplacement. Le SKU est toujours Standard.

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "location": "West US"
}

Réponses

Il existe deux réponses de réussite pour l’opération de création ou de mise à jour d’un coffre Recovery Services :

Nom	Type	Description
200 OK	Coffre	OK
201 Créé	Coffre	Date de création

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 condensée 201 Created de l'exemple de corps de requête précédent montre qu'un ID a été attribué et que provisioningState est Succeeded :

{
  "location": "westus",
  "name": "testVault",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/testVault",
  "type": "Microsoft.RecoveryServices/vaults",
  "sku": {
    "name": "Standard"
  }
}

Étapes suivantes

Créez une stratégie de sauvegarde pour sauvegarder une machine virtuelle Azure dans ce coffre.

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

Partager via