Compartir a través de

Creación de un almacén de Azure Backup mediante la API REST

La nueva plataforma de protección de datos de Azure Backup ofrece capacidades mejoradas para copias de seguridad y restauración para cargas de trabajo más recientes, como blobs en cuentas de almacenamiento, disco administrado y plataforma PaaS del servidor PostgreSQL. Su objetivo es minimizar la sobrecarga de administración a la vez que facilita la organización de las copias de seguridad. Un "almacén de Backup" es la piedra angular de la plataforma de protección de datos y es algo diferente del almacén de "Recovery Services".

Los pasos para crear un almacén de Azure Backup mediante una API REST se describen en la documentación sobre creación de almacenes de API REST. Vamos a usar este documento como referencia para crear un almacén de prueba llamado "testBkpVault" en "Oeste de EE. UU." y en el grupo de recursos "TestBkpVaultRG".

Para crear o actualizar un almacén de Azure Backup, use la siguiente operación PUT.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-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=2021-01-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 acceso Bearer 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 true BackupVault Propiedades del almacén
Identidad DPPIdentityDetails 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 "Oeste de EE. UU.". Especifique la ubicación.

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

Si desea crear un almacén de Backup y generar también una identidad asignada por el sistema, se debe dar el siguiente cuerpo de la solicitud.

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

Respuestas

La creación de un almacén de Backup es una operación asincrónica. Significa que esta operación crea otra que tiene que ser seguida por separado. Hay dos respuestas correctas a la operación para crear o actualizar un almacén de Backup:

Nombre Escribir Descripción
200 OK BackupVaultResource Aceptar
201 Creado BackupVaultResource Creado
Otros códigos de estado CloudError

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 201 Created (creado) condensada del cuerpo de solicitud de ejemplo anterior muestra que se ha asignado un identificador y que provisioningState es Succeeded (con éxito):

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

Pasos siguientes

Creación de una directiva de copia de seguridad para la copia de seguridad de blobs en este almacén.

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