REST API ile Azure Depolama hesabı oluşturma

Makale
07/11/2023

Bu örnek, Azure REST API'sini kullanarak yeni bir Azure Depolama Hesabı oluşturmayı gösterir.

Eksiksiz başvuru belgeleri ve ek örnekler Depolama Kaynak Sağlayıcısı REST API Başvurusu'nda bulunabilir.

İsteği oluşturma

Yeni bir Azure Depolama hesabı oluşturmak için aşağıdaki HTTP PUT isteğini kullanın.

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

İstek üst bilgileri

Aşağıdaki üstbilgiler gereklidir:

İstek üst bilgisi	Açıklama
Content-Type:	Gereklidir. `application/json` olarak ayarlayın.
Yetkilendirme:	Gereklidir. Geçerli `Bearer` bir erişim belirteci olarak ayarlayın.

URI parametreleri

Ad	Açıklama
subscriptionId	Azure aboneliğini tanımlayan abonelik kimliği. Birden çok aboneliğiniz varsa bkz. Birden çok abonelikle çalışma.
resourceGroupName	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden, CLI'dan veya portaldan alabilirsiniz.
accountName	Depolama hesabının adı. Adlandırma hesaplarının en iyi yöntemlerinin izlenmesi önerilir.
api-sürümü	İstek için kullanılacak API sürümü. Bu belge, yukarıdaki URL'de yer alan api sürümünü `2018-02-01`kapsar.

İstek gövdesi

Aşağıdaki tabloda, istek gövdesi için gerekli JSON özellikleri açıklanmaktadır. Depolama hesabını daha fazla özelleştirmek için isteğe bağlı parametreleri kullanın.

Ad	Tür	Description
location	string	Kaynak konumu. Liste Konumları işlemini kullanarak geçerli konum listesini alın.
Tür	Tip	Oluşturulacak depolama hesabı türünü belirtir. Genel amaçlı `StorageV2` seçim önerilir ve bu örnekte kullanılır.
Sku	Sku	Depolama hesabının yedeklilik stratejisi ve şifreleme gibi özelliklerini tanımlar. Bu örnekte Coğrafi Olarak Yedekli depolama kullanılmaktadır.

Örnek istek gövdesi

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

Yanıtı işleme

Yeni hesap oluşturmak için yapılan başarılı istekler, boş yanıt gövdesine sahip bir 202 durum kodu döndürür. Depolama hesabı zaman uyumsuz olarak oluşturulur. Hesap zaten varsa veya sağlanıyorsa, istek yanıtının yanıt gövdesinde mevcut depolama hesabının yapılandırmasıyla birlikte 200 dönüş kodu vardır.

Hata kodları da dahil olmak üzere yanıt kodlarının tam listesi Hata kodu başvuru belgelerinde bulunabilir.

Örnek 200 yanıt kodu

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

Aracılığıyla paylaş