Creación del almacén de Azure Recovery Services mediante API REST para Azure Backup

  • Artículo

En este artículo se describe cómo crear un almacén de Azure Recovery Services mediante API REST. Para crear el almacén mediante Azure Portal, consulte este artículo.

Un almacén de Recovery Services es una entidad de almacenamiento de Azure que aloja datos. Normalmente, los datos son copias de datos o información de configuración de máquinas virtuales (VM), cargas de trabajo, servidores o estaciones de trabajo. Puede usar almacenes de Recovery Services para almacenar datos de copia de seguridad de varios servicios de Azure como máquinas virtuales de IaaS (Linux o Windows) y SQL Server en máquinas virtuales de Azure. Los almacenes de Recovery Services son compatibles con System Center DPM, Windows Server, Azure Backup Server y muchos más. Los almacenes de Recovery Services facilitan la tarea de organizar los datos de copia de seguridad, al mismo tiempo que reduce al mínimo su sobrecarga administrativa.

Antes de comenzar

La creación de un almacén de Azure Recovery Services mediante una API REST se describen en el artículo sobre creación de almacenes de API REST. Vamos a usar este artículo como referencia para crear un almacén denominado testVault en West US.

Para crear o actualizar un almacén de Azure Recovery Services, use la siguiente operación PUT:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01

Creación de una solicitud

Para crear la solicitud PUT, se necesita el parámetro {subscription-id}. Si tiene varias suscripciones, consulte Trabajo con varias suscripciones. Definirá los elementos {resourceGroupName} y {vaultName} para sus recursos, junto con el parámetro api-version. En este artículo se usa api-version=2016-06-01.

Los siguientes encabezados son obligatorios:

Encabezado de solicitud Descripción
Content-Type: Necesario. Establézcalo en application/json.
Authorization: Necesario. Establézcalo en un token de accesoBearer válido.

Para más información sobre cómo crear la solicitud, consulte Componentes de una solicitud/respuesta de la API REST.

Creación del cuerpo de la solicitud

Para crear el cuerpo de la solicitud, se usan las siguientes definiciones comunes:

Nombre Obligatorio Type Descripción
eTag String eTag opcional
ubicación true String Ubicación de los recursos
properties VaultProperties Propiedades del almacén
sku Sku Identifica el identificador único de sistema de cada recurso de Azure.
etiquetas Object Etiquetas del recurso

Tenga en cuenta que el nombre del almacén y el nombre del grupo de recursos se proporcionan en el URI de PUT. El cuerpo de solicitud define la ubicación.

Cuerpo de solicitud de ejemplo

El cuerpo de ejemplo siguiente se usa para crear un almacén en West US. Especifique la ubicación. La SKU siempre es Standard.

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

Respuestas

Hay dos respuestas correctas a la operación para crear o actualizar un almacén de Recovery Services:

Nombre Escribir Descripción
200 OK Almacén Aceptar
201 Creado Almacén Creado

Para más información sobre las respuestas de API REST, consulte Process the response message (Procesamiento del mensaje de respuesta).

Respuesta de ejemplo

Una respuesta de tipo 201 Creado condensada del cuerpo de solicitud de ejemplo anterior muestra que se ha asignado un identificador y que el estado de provisioningState es correcto:

{
  "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"
  }
}

Pasos siguientes

Creación de una directiva de copia de seguridad para la copia de seguridad de una máquina virtual de Azure en este almacén.

Para más información sobre las API REST de Azure, consulte los siguientes documentos: