Creación de una cuenta de Azure Storage con la API REST

En este ejemplo se muestra cómo crear una nueva cuenta de Azure Storage mediante la API REST de Azure.

La documentación de referencia completa y los ejemplos adicionales están disponibles en la referencia de la API rest del proveedor de recursos de almacenamiento.

Compilar la solicitud

Use la siguiente solicitud HTTP PUT para crear una nueva cuenta de Azure Storage.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01

Encabezados de solicitud

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.

Parámetros del identificador URI

Nombre	Descripción
subscriptionId	El id. de suscripción que identifica una suscripción de Azure. Si tiene varias suscripciones, consulte Trabajo con varias suscripciones.
resourceGroupName	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API de Azure Resource Manager, la CLI o en Azure Portal.
accountName	El nombre de la cuenta de almacenamiento. Se recomienda seguir los procedimientos recomendados para asignar nombres a las cuentas .
api-version	La versión de API que se usará para la solicitud. En este documento se describe la versión 2018-02-01 de la API que se incluye en la dirección URL anterior.

Cuerpo de la solicitud

En la tabla siguiente se describen las propiedades JSON necesarias para el cuerpo de la solicitud. Use parámetros opcionales para personalizar aún más la cuenta de almacenamiento.

Nombre	Tipo	Descripción
ubicación	string	Ubicación del recurso Obtenga una lista actualizada de ubicaciones mediante la operación Enumerar ubicaciones operación.
kind	Variante	Especifica el tipo de cuenta de almacenamiento que se va a crear. La opción de uso StorageV2 general se recomienda y se usa en este ejemplo.
sku	Sku	Define las funcionalidades de la cuenta de almacenamiento, como la estrategia de redundancia y el cifrado. En este ejemplo se usa el almacenamiento con redundancia geográfica.

Cuerpo de solicitud de ejemplo

{
  "sku": {
    "name": "Standard_GRS"
  },
  "kind": "StorageV2",
  "location": "eastus2",
}

Control de la respuesta

Las solicitudes correctas para crear una cuenta devuelven un código de estado 202 con un cuerpo de respuesta vacío. La cuenta de almacenamiento se crea de forma asincrónica. Si la cuenta ya existe o se está aprovisionando, la respuesta de solicitud tiene un código de devolución 200 con la configuración de la cuenta de almacenamiento existente en el cuerpo de la respuesta.

Hay disponible una lista completa de códigos de respuesta, incluidos los códigos de error, en la documentación de referencia del código de error.

Ejemplo de código de respuesta 200

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/res9101/providers/Microsoft.Storage/storageAccounts/{accountName}",
  "kind": "Storage",
  "location": "eastus2",
  "name": "{accountName}",
  "properties": {
    "creationTime": "2017-05-24T13:25:33.4863236Z",
    "primaryEndpoints": {
      "blob": "https://{accountName}.blob.core.windows.net/",
      "file": "https://{accountName}.file.core.windows.net/",
      "queue": "https://{accountName}.queue.core.windows.net/",
      "table": "https://{accountName}.table.core.windows.net/"
    },
    "primaryLocation": "eastus2",
    "provisioningState": "Succeeded",
    "secondaryLocation": "centralus",
    "statusOfPrimary": "available",
    "statusOfSecondary": "available",
    "supportsHttpsTrafficOnly": false
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  },
  "type": "Microsoft.Storage/storageAccounts"
}