Erstellen eines Azure Storage-Kontos mit der REST-API

Artikel
08/05/2023

In diesem Beispiel wird gezeigt, wie Sie mithilfe der Azure-REST-API ein neues Azure Storage-Konto erstellen.

Eine vollständige Referenzdokumentation und zusätzliche Beispiele finden Sie in der Rest-API-Referenz des Speicherressourcenanbieters.

Erstellen der Anforderung

Verwenden Sie die folgende HTTP PUT-Anforderung, um ein neues Azure Storage-Konto zu erstellen.

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

Anforderungsheader

Die folgenden Header sind erforderlich:

Anforderungsheader	BESCHREIBUNG
Content-Type:	Erforderlich. Legen Sie diese Option auf `application/json` fest.
Authorization:	Erforderlich. Legen Sie diese Option auf ein gültiges `Bearer`Zugriffstoken fest.

URI-Parameter

Name	BESCHREIBUNG
subscriptionId	Abonnement-ID für ein Azure-Abonnement. Wenn Sie über mehrere Abonnements verfügen, lesen Sie Verwenden mehrerer Abonnements:
resourceGroupName	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure Resource Manager-API, Befehlszeilenschnittstelle oder das Portal abgerufen werden.
.	Der Name des Speicherkontos. Die bewährten Methoden zum Benennen von Konten werden empfohlen.
api-version	API-Version, die für die Anforderung verwendet werden soll. In diesem Dokument wird API-Version `2018-02-01` behandelt, die in der obigen URL enthalten ist.

Anforderungstext

In der folgenden Tabelle werden die erforderlichen JSON-Eigenschaften für den Anforderungstext beschrieben. Verwenden Sie optionale Parameter , um das Speicherkonto weiter anzupassen.

Name	type	BESCHREIBUNG
location	Zeichenfolge	Ressourcenspeicherort Rufen Sie mit dem Vorgang List Locations eine aktuelle Liste der Standorte auf.
kind	Kind	Gibt an, welcher Speicherkontotyp erstellt werden soll. Die allgemeine `StorageV2` Wahl wird empfohlen und in diesem Beispiel verwendet.
sku	sku	Definiert die Funktionen des Speicherkontos, z. B. Redundanzstrategie und Verschlüsselung. In diesem Beispiel wird georedundanter Speicher verwendet.

Beispiel für Anforderungstext

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

Verarbeiten der Antwort

Erfolgreiche Anforderungen zum Erstellen eines neuen Kontos geben einen Code vom Typ 202 status mit einem leeren Antworttext zurück. Das Speicherkonto wird asynchron erstellt. Wenn das Konto bereits vorhanden ist oder bereitgestellt wird, weist die Anforderungsantwort den Rückgabecode 200 mit der Konfiguration des vorhandenen Speicherkontos im Antworttext auf.

Eine vollständige Liste der Antwortcodes, einschließlich Fehlercodes, finden Sie in der Referenzdokumentation zu Fehlercode.

Beispiel:200-Antwortcode

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

Freigeben über