Creación del almacén de Azure Recovery Services mediante API REST para Azure Backup
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
Para más información sobre las API REST de Azure, consulte los siguientes documentos:
- API REST del proveedor de Azure Recovery Services
- Get started with Azure REST API (Introducción a la API REST de Azure)