Criar uma conta de Armazenamento do Azure com a API REST

Artigo
07/11/2023

Este exemplo mostra como criar uma nova Conta de Armazenamento do Azure com a API REST do Azure.

A documentação de referência completa e os exemplos adicionais estão disponíveis na Referência da API REST do Fornecedor de Recursos de Armazenamento.

Criar o pedido

Utilize o seguinte pedido HTTP PUT para criar uma nova conta de Armazenamento do Azure.

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

Cabeçalhos do pedido

Os seguintes cabeçalhos são obrigatórios:

Cabeçalho do pedido	Descrição
Content-Type:	Necessário. Definido como `application/json`.
Authorization:	Necessário. Defina como um token de acesso válido`Bearer`.

Parâmetros URI

Nome	Descrição
subscriptionId	O ID da subscrição que identifica uma subscrição do Azure. Se tiver várias subscrições, consulte Trabalhar com várias subscrições.
resourceGroupName	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API Resource Manager do Azure, da CLI ou do portal.
accountName	O nome da conta de armazenamento. Recomenda-se que siga as melhores práticas das contas de nomenclatura.
api-version	A versão da API a utilizar para o pedido. Este documento abrange a versão `2018-02-01`da api , incluída no URL acima.

Corpo do pedido

A tabela abaixo descreve as propriedades JSON necessárias para o corpo do pedido. Utilize parâmetros opcionais para personalizar ainda mais a conta de armazenamento.

Nome	Tipo	Description
localização	cadeia (de carateres)	Localização do recurso. Obtenha uma lista atual de localizações com a operação Localizações da Lista .
tipo	Tipo	Especifica o tipo de conta de armazenamento a criar. A escolha para fins `StorageV2` gerais é recomendada e utilizada neste exemplo.
sku	SKU	Define as capacidades da conta de Armazenamento, como a estratégia de redundância e a encriptação. Este exemplo utiliza armazenamento Georredundante.

Corpo do pedido de exemplo

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

Processar a resposta

Os pedidos com êxito para criar uma nova conta devolvem um código de estado 202 com um corpo de resposta vazio. A conta de armazenamento é criada de forma assíncrona. Se a conta já existir ou estiver a ser aprovisionada, a resposta do pedido tem um código de devolução 200 com a configuração da conta de armazenamento existente no corpo da resposta.

Está disponível uma lista completa de códigos de resposta, incluindo códigos de erro, na documentação de referência do Código de erro.

Código de resposta de exemplo 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"
}

Partilhar via