Aracılığıyla paylaş

Hesap Bilgilerini Al

  • Makale

Get Account Information işlemi, belirtilen hesap için SKU adını ve hesap türünü döndürür. Hizmetin 2018-03-28 ve sonraki sürümlerinde kullanılabilir.

İstek

Paylaşılan anahtar veya paylaşılan erişim imzası (SAS) yetkilendirmesi aracılığıyla yetkilendirilmiş geçerli bir istek kullanarak Get Account Information isteği oluşturabilirsiniz.

account restype ve propertiescomp değeri eklerseniz, istek Get Account Information işlemini kullanır. Aşağıdaki tabloda örnekler gösterilmektedir:

Yöntem İstek URI'si HTTP sürümü
GET/HEAD https://myaccount.blob.core.windows.net/?restype=account&comp=properties HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

Parametre Açıklama
restype Gerekli. restype parametre değeri accountolmalıdır.
comp Gerekli. comp parametre değeri propertiesolmalıdır.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır:

İstek üst bilgisi Açıklama
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
Date or x-ms-date Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Bu işlem için sürüm 2018-03-28 veya üzeri olmalıdır. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-client-request-id Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz.

İstek gövdesi

Hiç kimse.

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 200 durum kodunu döndürür (Tamam).

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgilerHTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Açıklama
x-ms-request-id Yapılan isteği benzersiz olarak tanımlar. İsteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlem sorunlarını giderme.
x-ms-version Sürüm 2009-09-19 ve üzeri. İsteği yürütmek için kullanılan Azure Blob Depolama sürümünü gösterir.
Date Hizmetin yanıtı gönderdiği saati gösteren UTC tarih/saat değeri.
Content-Length İstek gövdesinin uzunluğunu belirtir. Bu işlem için içerik uzunluğu her zaman sıfır olacaktır.
x-ms-sku-name Belirtilen hesabın SKU adını tanımlar.
x-ms-account-kind Belirtilen hesabın hesap türü tanımlar. Olası değerler Storage, BlobStorageve StorageV2'dır. Üst bilgi, GPv2 hesapları için alt dize V2 kullanarak Genel Amaçlı v1 (GPv1) ile Genel Amaçlı v2 (GPv2) depolama hesaplarını birbirinden ayırır.
x-ms-client-request-id İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte varsa ve değer en fazla 1.024 görünür ASCII karakteriyse, x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa, bu üst bilgi yanıtta mevcut olmaz.
x-ms-is-hns-enabled Sürüm 2019-07-07 ve üzeri. Hesapta hiyerarşik ad alanının etkinleştirilip etkinleştirilmediğini gösterir.

Yanıt gövdesi

Hiç kimse.

Örnek yanıt

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2

İzin

Azure Depolama'da herhangi bir veri erişim işlemi çağrılırken yetkilendirme gereklidir. aşağıda açıklandığı gibi Get Account Information işlemini yetkileyebilirsiniz.

Önemli

Microsoft, Azure Depolama'ya yönelik istekleri yetkilendirmek için Yönetilen kimliklerle Microsoft Entra Id kullanılmasını önerir. Microsoft Entra ID, Paylaşılan Anahtar yetkilendirmesine kıyasla üstün güvenlik ve kullanım kolaylığı sağlar.

Azure Depolama, blob verilerine yönelik istekleri yetkilendirmek için Microsoft Entra Id kullanılmasını destekler. Microsoft Entra Id ile azure rol tabanlı erişim denetimini (Azure RBAC) kullanarak bir güvenlik sorumlusuna izin vekleyebilirsiniz. Güvenlik sorumlusu bir kullanıcı, grup, uygulama hizmet sorumlusu veya Azure yönetilen kimliği olabilir. OAuth 2.0 belirtecini döndürmek için güvenlik sorumlusunun kimliği Microsoft Entra Id tarafından doğrulanır. Daha sonra belirteç, Blob hizmetine karşı bir isteği yetkilendirmek için kullanılabilir.

Microsoft Entra Id kullanarak yetkilendirme hakkında daha fazla bilgi edinmek için bkz.Microsoft Entra Id kullanarak bloblara erişimi yetkilendirme .

İzinler

Aşağıda bir Microsoft Entra kullanıcısı, grubu, yönetilen kimliği veya hizmet sorumlusunun Get Account Information işlemini çağırması için gereken RBAC eylemi verilmiştir:

  • Azure RBAC eylemini : Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Bu RBAC eylemi Sahip rolüne dahil edilir veya bu eylemi özel bir role atayabilirsiniz.

Azure RBAC kullanarak rol atama hakkında daha fazla bilgi edinmek için bkz. Blob verilerine erişim için Azure rolü atama.

Açıklamalar

İsteğin URL yolu, bu işlemin verdiği bilgileri etkilemez. Amacı, isteğin izin verilen kaynağı belirten bir SAS belirteci ile doğru şekilde yetkilendirmesine izin vermektir.

Bu işlemin başarılı olması için belirtilen kaynağın mevcut olması gerekmez. Örneğin, var olmayan bir blob ve geçerli izinlerle oluşturulan sas belirteci doğru hesap adını, doğru kapsayıcı adını ve var olmayan blob adını içeren bir URL yolu ile başarılı olur.

Fatura

Fiyatlandırma istekleri, Blob Depolama API'lerini kullanan istemcilerden, doğrudan Blob Depolama REST API'si aracılığıyla veya bir Azure Depolama istemci kitaplığından kaynaklanabilir. Bu istekler işlem başına ücret tahakkuk eder. İşlem türü, hesabın ücretlendirilma şeklini etkiler. Örneğin, okuma işlemleri yazma işlemlerinden farklı bir faturalama kategorisine tahakkuk eder. Aşağıdaki tabloda, depolama hesabı türüne göre Get Account Information istekleri için faturalama kategorisi gösterilmektedir:

İşlem Depolama hesabı türü Faturalama kategorisi
Hesap Bilgilerini Al Premium blok blobu
Standart genel amaçlı v2		 Diğer işlemler
Hesap Bilgilerini Al Standart genel amaçlı v1 Okuma işlemleri

Belirtilen faturalama kategorisinin fiyatlandırması hakkında bilgi edinmek için bkz. azure blob depolama fiyatlandırması.