Fiókadatok lekérése
A Get Account Information
művelet visszaadja a megadott fiók termékváltozatának nevét és fióktípusát. A szolgáltatás 2018.03.28-i és újabb verzióiban érhető el.
Kérés
A kérést Get Account Information
létrehozhatja egy olyan érvényes kéréssel, amely megosztott kulcson vagy közös hozzáférésű jogosultságkódon (SAS) keresztül van engedélyezve.
Ha a restype
értékét és comp
értékét account
properties
adja 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:
Metódus | Kérés URI-ja | 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 |
Kötelező. A restype paraméter értékének a következőnek kell lennie account : . |
comp |
Kötelező. A comp paraméter értékének a következőnek kell lennie properties : . |
Kérésfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Kötelező. 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-ba. |
Date or x-ms-date |
Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használandó művelet verzióját adja meg. Ehhez a művelethez a verziónak 2018-03-28-nak vagy újabbnak kell lennie. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
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. |
A kérés törzse
Nincsenek.
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A sikeres művelet a 200 -os állapotkódot adja vissza (OK).
Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz 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 | Description |
---|---|
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést. Segítségével 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ójá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. Ehhez a művelethez a tartalom hossza mindig nulla lesz. |
x-ms-sku-name |
A megadott fiók termékváltozatának nevét azonosítja. |
x-ms-account-kind |
A megadott fiók fióktípusát azonosítja. A lehetséges értékek a következők: Storage , BlobStorage és StorageV2 . A fejléc különbséget tesz általános célú v1 (GPv1) és általános célú v2 (GPv2) tárfiókok között a GPv2-fiókok részkarakterláncának 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ó. A fejléc é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-karakterből áll. Ha a x-ms-client-request-id fejléc nincs jelen a kérelemben, ez a fejléc nem lesz jelen a válaszban. |
x-ms-is-hns-enabled |
2019-07-07-es és újabb verzió. Azt jelzi, hogy a fiókban engedélyezve van-e a hierarchikus névtér. |
Választörzs
Nincsenek.
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
Engedélyezés
Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezés szükséges. A műveletet az Get Account Information
alábbiak szerint engedélyezheti.
Ez a művelet nem támogatja az OAuth-alapú hitelesítést az Azure Active Directory/MSI hozzáférési jogkivonatán vagy a felhasználódelegálási SAS-en keresztül.
Megjegyzések
A kérelem URL-címe nem befolyásolja a művelet által megadott információkat. Célja, hogy lehetővé tegye a kérés megfelelő engedélyezését egy SAS-jogkivonattal, amely megadja az engedélyezett erőforrást.
A művelet sikerességéhez 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 sikeresek lesznek a megfelelő fióknevet, a megfelelő tárolónevet és a nem létező blob nevét tartalmazó URL-cím elérési útjával.
Számlázás
A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. 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 a kérelmek számlázási kategóriáját Get Account Information
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ával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.