Získání informací o účtu

  • Článek

Operace Get Account Information vrátí název skladové položky a druh účtu pro zadaný účet. Je k dispozici ve verzi 2018-03-28 a novějších verzích služby.

Žádost

Požadavek můžete vytvořit Get Account Information pomocí platného požadavku, který je autorizovaný prostřednictvím autorizace sdíleného klíče nebo sdíleného přístupového podpisu (SAS).

Pokud přidáte restype hodnotu account a comp hodnotu properties, požadavek použije Get Account Information operaci . Následující tabulka uvádí příklady:

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
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

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametry:

Parametr Popis
restype Povinná hodnota. Hodnota restype parametru musí být account.
comp Povinná hodnota. Hodnota comp parametru musí být properties.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků:

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date or x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Pro tuto operaci musí být verze 2018-03-28 nebo novější. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
x-ms-request-id Jednoznačně identifikuje požadavek, který byl proveden. Můžete ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Verze 2009-09-19 a novější. Označuje verzi Azure Blob Storage, která se používá ke spuštění požadavku.
Date Hodnota data a času UTC, která určuje čas, kdy služba odeslala odpověď.
Content-Length Určuje délku textu požadavku. U této operace bude délka obsahu vždy nulová.
x-ms-sku-name Určuje název skladové položky zadaného účtu.
x-ms-account-kind Identifikuje druh účtu zadaného účtu. Možné hodnoty jsou Storage, BlobStoragea StorageV2. Hlavička rozlišuje účty úložiště Pro obecné účely v1 (GPv1) a účty úložiště Pro obecné účely v2 (GPv2) pomocí podřetězení V2 pro účty GPv2.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud se nachází v požadavku a hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, nebude tato hlavička v odpovědi.
x-ms-is-hns-enabled Verze 2019-07-07 a novější. Označuje, jestli má účet povolený hierarchický obor názvů.

Text odpovědi

Žádné

Ukázková odpověď

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

Autorizace

Autorizace se vyžaduje při volání jakékoli operace přístupu k datům ve službě Azure Storage. Operaci můžete autorizovat Get Account Information , jak je popsáno níže.

Tato operace nepodporuje autorizaci na základě OAuth prostřednictvím přístupového tokenu z Azure Active Directory/MSI nebo SAS delegování uživatele.

Sdílený přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. V případě sdíleného přístupového podpisu máte podrobnou kontrolu nad tím, jak může klient přistupovat k datům. Můžete určit, k jakému prostředku může klient přistupovat, jaká oprávnění k těmto prostředkům má a jak dlouho je sas platný.

Operace Get Account Information podporuje autorizaci pomocí SAS účtu nebo SAS služby s alespoň jedním dostupným oprávněním.

Sas účtu

SAS účtu je zabezpečené pomocí klíče účtu úložiště. SAS účtu deleguje přístup k prostředkům v jedné nebo více službách úložiště. Všechny operace dostupné prostřednictvím sdíleného přístupového podpisu pro delegování služby nebo uživatele jsou dostupné také prostřednictvím sdíleného přístupového podpisu účtu.

Další informace o SAS účtu najdete v tématu Vytvoření SAS účtu.

Sas služby

Sdílený přístupový podpis služby je zabezpečený pomocí klíče účtu úložiště. SAS služby deleguje přístup k prostředku v jedné službě Azure Storage, jako je úložiště objektů blob.

Pokud je pro účet úložiště zakázaný přístup ke sdílenému klíči, token SAS služby nebude v požadavku na Službu Blob Storage povolený. Další informace najdete v tématu Vysvětlení, jak zakázání sdíleného klíče ovlivňuje tokeny SAS.

Další informace o SAS služby najdete v tématu Vytvoření SAS služby.

Poznámky

Cesta URL požadavku nemá vliv na informace, které tato operace poskytuje. Jeho účelem je umožnit žádosti správnou autorizaci pomocí tokenu SAS, který určuje povolený prostředek.

Zadaný prostředek nemusí existovat, aby tato operace byla úspěšná. Například token SAS vygenerovaný s neexistující objekt blob a platnými oprávněními bude úspěšný s cestou URL, která obsahuje správný název účtu, správný název kontejneru a neexistující název objektu blob.

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro Get Account Information žádosti založené na typu účtu úložiště:

Operace Typ účtu úložiště Kategorie fakturace
Získání informací o účtu Objekt blob bloku úrovně Premium
Standard pro obecné účely v2		 Další operace
Získání informací o účtu Standard pro obecné účely v1 Operace čtení

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.