Hesap Bilgilerini Al

Makale
02/07/2024

İşlem, Get Account Information 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 isteği oluşturabilirsiniz Get Account Information .

değerini ve değerini account eklersenizrestype, istek işlemi kullanırGet Account Information.propertiescomp 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`	Gereklidir. `restype` Parametre değeri olmalıdır`account`.
`comp`	Gereklidir. `comp` Parametre değeri olmalıdır`properties`.

İ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`	Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
`Date or x-ms-date`	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini 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`	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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

Yok.

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.

Durum kodu

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

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 bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Description
`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şlemleriyle ilgili sorunları 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ünü tanımlar. Olası değerler , `BlobStorage`ve `StorageV2`değerleridir`Storage`. Üst bilgi, GPv2 hesapları için alt dizeyi kullanarak Genel Amaçlı v1 (GPv1) ile Genel Amaçlı v2 (GPv2) depolama hesaplarını ayırt eder`V2`.
`x-ms-client-request-id`	İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer en fazla 1.024 görünür ASCII karakteriyse üst bilginin değerine `x-ms-client-request-id` eşittir. İstekte `x-ms-client-request-id` üst bilgi yoksa, yanıtta bu üst bilgi 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

Yok.

Ö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

Yetkilendirme

Azure Depolama'da herhangi bir veri erişimi işlemi çağrılırken yetkilendirme gereklidir. İşlemi aşağıda açıklandığı gibi yetki Get Account Information verebilirsiniz.

Bu işlem, Azure Active Directory/MSI'den erişim belirteci veya kullanıcı temsilcisi SAS'sı aracılığıyla OAuth tabanlı yetkilendirmeyi desteklemez.

Paylaşılan erişim imzaları (SAS)
Paylaşılan anahtar

Paylaşılan erişim imzası (SAS), depolama hesabındaki kaynaklara güvenli temsilci erişimi sağlar. SAS ile istemcinin verilere nasıl erişebileceği üzerinde ayrıntılı denetime sahipsiniz. İstemcinin hangi kaynağa erişebileceğini, bu kaynaklara hangi izinlere sahip olduğunu ve SAS'nin ne kadar süre geçerli olduğunu belirtebilirsiniz.

İşlem, Get Account Information hesap SAS'sini veya en az bir kullanılabilir izne sahip bir hizmet SAS'sini kullanarak yetkilendirmeyi destekler.

Hesap SAS'i

Bir hesap SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hesap SAS ise bir veya daha fazla depolama hizmetindeki kaynaklara erişim atar. Bir hizmet veya kullanıcı temsilcisi SAS aracılığıyla kullanılabilen tüm işlemler, hesap SAS'sı aracılığıyla da kullanılabilir.

Hesap SAS'i hakkında daha fazla bilgi edinmek için bkz. Hesap SAS'ı oluşturma.

Hizmet SAS'i

Hizmet SAS'sinin güvenliği depolama hesabı anahtarıyla sağlanır. Hizmet SAS'ı blob depolama gibi tek bir Azure Depolama hizmetindeki bir kaynağa erişim yetkisi verir.

Depolama hesabı için Paylaşılan Anahtar erişimine izin verilmediğinde, Blob Depolama isteğinde hizmet SAS belirtecine izin verilmez. Daha fazla bilgi edinmek için bkz. Paylaşılan Anahtara izin vermemeyenin SAS belirteçlerini nasıl etkilediğini anlama.

Hizmet SAS'i hakkında daha fazla bilgi edinmek için bkz. Hizmet SAS'ı oluşturma.

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 bir SAS belirteci, doğru hesap adını, doğru kapsayıcı adını ve var olmayan blob'un adını içeren bir URL yolu ile başarılı olur.

Faturalama

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 nasıl ücretlendirildiğinden etkilenir. Ö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 istekler için Get Account Information 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. fiyatlandırma Azure Blob Depolama.