Fiókadatok lekérése

Cikk
12/14/2024

A Get Account Information művelet a megadott fiók termékváltozatának nevét és fióktípusát adja vissza. A szolgáltatás 2018.03.28-i és újabb verzióiban érhető el.

Kérés

A Get Account Information kérést közös kulcs vagy közös hozzáférésű jogosultságkód (SAS) engedélyezésével engedélyezett érvényes kéréssel hozhatja létre.

Ha restypeaccount és comppropertiesértéket ad hozzá, a kérés a Get Account Information műveletet fogja használni. Az alábbi táblázat példákat mutat be:

Módszer	URI kérése	HTTP-verzió
`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-paraméterek

A kérelem URI-ján a következő további paramétereket adhatja meg:

Paraméter	Leírás
`restype`	Szükséges. A `restype` paraméterértéknek `account`kell lennie.
`comp`	Szükséges. A `comp` paraméterértéknek `properties`kell lennie.

Kérelemfejlécek

Az alábbi táblázat a szükséges és választható kérelemfejléceket ismerteti:

Kérelem fejléce	Leírás
`Authorization`	Szükséges. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-.
`Date or x-ms-date`	Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-.
`x-ms-version`	Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. Ehhez a művelethez a verziónak a 2018-03-28-es vagy újabb verziónak kell lennie. További információ: Az Azure Storage-szolgáltatások verziószámozása.
`x-ms-client-request-id`	Szabadon választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel.

Kérelem törzse

Egyik sem.

Válasz

A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.

Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.

Válaszfejlécek

A művelet válasza a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Leírás
`x-ms-request-id`	Egyedileg azonosítja a végrehajtott kérést. Ezzel elháríthatja a kérést. További információ: API-műveletek hibaelhárítása.
`x-ms-version`	2009-09-19-es és újabb verzió. A kérés végrehajtásához használt Azure Blob Storage-verziót jelzi.
`Date`	UTC dátum/idő érték, amely azt az időpontot jelzi, amikor a szolgáltatás elküldte a választ.
`Content-Length`	A kérelem törzsének hosszát adja meg. Ebben a műveletben a tartalom hossza mindig nulla lesz.
`x-ms-sku-name`	Azonosítja a megadott fiók termékváltozatának nevét.
`x-ms-account-kind`	A megadott fiók fióktípusú azonosítja. A lehetséges értékek a következők: `Storage`, `BlobStorage`és `StorageV2`. A fejléc különbséget tesz az Általános célú v1 (GPv1) és az Általános célú v2 (GPv2) tárfiókok között a GPv2-fiókokhoz tartozó részszűrési `V2` használatával.
`x-ms-client-request-id`	A kérések és a megfelelő válaszok hibaelhárítására használható. Ennek az élőfejnek az értéke megegyezik a `x-ms-client-request-id` fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karakter. Ha a `x-ms-client-request-id` fejléc nem szerepel a kérelemben, akkor ez a fejléc nem jelenik meg a válaszban.
`x-ms-is-hns-enabled`	2019-07-07-es és újabb verzió. Azt jelzi, hogy a fiók rendelkezik-e engedélyezve hierarchikus névtérrel.

Válasz törzse

Egyik sem.

Mintaválasz

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

Felhatalmazás

Az Azure Storage-beli adathozzáférési műveletek meghívásához engedélyezésre van szükség. Az alábbi módon engedélyezheti a Get Account Information műveletet.

Fontos

A Microsoft azt javasolja, hogy felügyelt identitásokkal használja a Microsoft Entra ID-t az Azure Storage-kérelmek engedélyezéséhez. A Microsoft Entra ID kiváló biztonságot és egyszerű használatot biztosít a megosztott kulcsok engedélyezéséhez képest.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID-val azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A biztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A biztonsági tagot a Microsoft Entra ID hitelesíti egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatással kapcsolatos kérések engedélyezésére használható.

A Microsoft Entra ID használatával történő engedélyezésről további információt A blobok hozzáférésének engedélyezése a Microsoft Entra-azonosítóvalcímű témakörben talál.

Engedélyek

Az alábbiakban a Microsoft Entra-felhasználó, csoport, felügyelt identitás vagy szolgáltatásnév meghívásához szükséges RBAC-műveletet találja a Get Account Information művelet meghívásához:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Ez az RBAC-művelet szerepel a Tulajdonos szerepkörben, vagy hozzárendelheti ezt a műveletet egy egyéni szerepkörhöz.

A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshezcímű témakörben talál.

A közös hozzáférésű jogosultságkód (SAS) biztonságos delegált hozzáférést biztosít a tárfiók erőforrásaihoz. Sas használatával részletesen szabályozhatja, hogy az ügyfél hogyan férhet hozzá az adatokhoz. Megadhatja, hogy az ügyfél milyen erőforráshoz férhet hozzá, milyen engedélyekkel rendelkezik ezekhez az erőforrásokhoz, és mennyi ideig érvényes az SAS.

A Get Account Information művelet támogatja a fiók SAS használatával történő engedélyezést.

Fiók SAS-fiókja

A fiók SAS-jének biztonságát a tárfiókkulcs biztosítja. A fiók sasa egy vagy több tárolási szolgáltatásban delegálja az erőforrásokhoz való hozzáférést. A szolgáltatáson vagy a felhasználói delegálási SAS-en keresztül elérhető összes művelet egy fiók SAS-ével is elérhető.

További információ a fiók SAS-járól: Fiók SAS-létrehozása.

Megjegyzések

A kérés URL-elérési útja nem befolyásolja a művelet által megadott információkat. Célja, hogy lehetővé tegye a kérelem megfelelő engedélyezését egy SAS-jogkivonattal, amely megadja az engedélyezett erőforrást.

A művelet sikeres végrehajtásához a megadott erőforrásnak nem kell léteznie. A nem létező blobokkal és érvényes engedélyekkel létrehozott SAS-jogkivonatok például a megfelelő fióknevet, a megfelelő tárolónevet és a nem létező blob nevét tartalmazó URL-elérési úttal sikeresek lesznek.

Számlázás

A díjszabási kérések olyan ügyfelektől származhatnak, amelyek Blob Storage API-kat használnak közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa hatással van a fiók díjának módjára. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján Get Account Information kérelmek számlázási kategóriáját mutatja be:

Művelet	Tárfiók típusa	Számlázási kategória
Fiókadatok lekérése	Prémium szintű blokkblob Standard általános célú v2	Egyéb műveletek
Fiókadatok lekérése	Standard általános célú v1	Olvasási műveletek

A megadott számlázási kategória díjszabásáról az Azure Blob Storage díjszabási című témakörben olvashat.

Megosztás a következőn keresztül: