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

Článek
12/15/2024

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.

Prosba

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

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

Metoda	Identifikátor URI požadavku	Verze 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

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

Parametr	Popis
`restype`	Požadovaný. Hodnota parametru `restype` musí být `account`.
`comp`	Požadovaný. Hodnota parametru `comp` musí být `properties`.

Hlavičky požadavku

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

Hlavička požadavku	Popis
`Authorization`	Požadovaný. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
`Date or x-ms-date`	Požadovaný. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu 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`	Volitelný. Poskytuje hodnotu vygenerovanou klientem, neprůshlenou hodnotou s limitem 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 naleznete v tématu Stav a kódy chyb.

Hlavičky odpovědi

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

Hlavička odpovědi	Popis
`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 služby Azure Blob Storage, která se používá k provedení požadavku.
`Date`	Hodnota data a času UTC, která označuje čas, kdy služba odeslala odpověď.
`Content-Length`	Určuje délku textu požadavku. Pro tuto operaci bude délka obsahu vždy nula.
`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`, `BlobStorage`a `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ězce `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ě hlavičky `x-ms-client-request-id`, pokud se nachází v požadavku a hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud v požadavku není hlavička `x-ms-client-request-id`, nebude tato hlavička v odpovědi k dispozici.
`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

Oprávnění

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

Důležitý

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID poskytuje vynikající zabezpečení a snadné použití v porovnání s autorizací sdíleného klíče.

Azure Storage podporuje použití Microsoft Entra ID k autorizaci požadavků na data objektů blob. S ID Microsoft Entra můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objekt zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Instanční objekt zabezpečení je ověřený pomocí ID Microsoft Entra pro vrácení tokenu OAuth 2.0. Token se pak dá použít k autorizaci požadavku ve službě Blob Service.

Další informace o autorizaci pomocí ID Microsoft Entra najdete v tématu Autorizace přístupu k objektům blob pomocíMicrosoft Entra ID .

Dovolení

Níže je uvedena akce RBAC potřebná pro uživatele, skupinu, spravovanou identitu nebo instanční objekt Microsoftu pro volání operace Get Account Information:

akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Tato akce RBAC je součástí role Vlastník nebo můžete tuto akci přiřadit vlastní roli.

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Sdílený přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. Pomocí 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á klient přístup, jaká oprávnění k těmto prostředkům má a jak dlouho je SAS platný.

Operace Get Account Information podporuje autorizaci pomocí sdíleného přístupového podpisu účtu.

SAS účtu

Sdílený přístupový podpis úč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 SAS 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.

Poznámky

Cesta URL požadavku nemá vliv na informace, které tato operace poskytuje. Jejím účelem je umožnit požadavku správně autorizovat token SAS, který určuje povolený prostředek.

Zadaný prostředek nemusí existovat, aby byla tato operace ú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 název neexistující objektu blob.

Fakturování

Žádosti o ceny můžou pocházet z klientů, kteří používají rozhraní API služby Blob Storage, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny služby Azure Storage. Tyto žádosti nabíhají poplatky za transakci. Typ transakce ovlivňuje způsob účtování účtu. Například transakce čtení nabíhají do jiné fakturační kategorie než transakce zápisu. Následující tabulka uvádí kategorii fakturace pro požadavky Get Account Information na základě 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 verze 2	Jiné operace
Získání informací o účtu	Standard pro obecné účely verze 1	Operace čtení

Další informace o cenách pro zadanou fakturační kategorii najdete v tématu ceny služby Azure Blob Storage.

Sdílet prostřednictvím