Získání informací o účtu
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.
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.