Blobszolgáltatás tulajdonságainak lekérése
A Get Blob Service Properties
művelet lekéri egy Azure Blob Storage-fiók tulajdonságait, beleértve a Storage Analytics és a forrásközi erőforrás-megosztási (CORS) szabályok tulajdonságait is.
A CORS-szabályokkal és a kiértékelési logikával kapcsolatos részletes információkért lásd: CORS-támogatás az Azure Storage-szolgáltatásokhoz.
Kérés
A kérést a Get Blob Service Properties
következőképpen adhatja meg. Javasoljuk, hogy HTTPS-t használjon. Cserélje le <account-name>
a elemet a tárfiók nevére:
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
GET | https://<account-name>.blob.core.windows.net/?restype=service&comp=properties |
HTTP/1.1 |
Megjegyzés
Az URI-nak mindig tartalmaznia kell egy perjelet (/), amely elválasztja a gazdagép nevét az elérési úttól és a lekérdezési részektől. Ebben a műveletben az URI elérési útja üres.
URI-paraméterek
URI-paraméter | Description |
---|---|
restype=service&comp=properties |
Kötelező. A Blob Storage tulajdonságainak lekéréséhez mindkét lekérdezési sztring kombinációja szükséges. |
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Kötelező. Megadja az engedélyezési sémát, a tárfiók nevét és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba. |
Date vagy 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érések engedélyezése az Azure Storage-ba. |
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. 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 kib-os (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. További információ: Monitorozási Azure Blob Storage. |
A kérés törzse
Nincsenek.
Reagálás
A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.
Állapotkód
A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.
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 szolgáltatással szemben benyújtott kérést. |
x-ms-version |
A művelet válaszhoz használt verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
A kérések és a kapcsolódó 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-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem szerepel a válaszban. |
Választörzs
A 2012-02-12-es és korábbi verziók esetében a válasz törzsének formátuma a következő:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<Metrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Metrics>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>
A 2013-08-15-ös verziótól a válasz törzsének formátuma a következő:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
<AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
</StorageServiceProperties>
A 2017-07-29-es verziótól a válasz törzsének formátuma a következő:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
<AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
</StorageServiceProperties>
A 2018-03-28-as verziótól a válasz törzsének formátuma a következő:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
<AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true|false</Enabled>
<IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
<ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
A 2019-12-12-es verziótól a válasz törzsének formátuma a következő:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>version-number</Version>
<Delete>true|false</Delete>
<Read>true|false</Read>
<Write>true|false</Write>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>version-number</Version>
<Enabled>true|false</Enabled>
<IncludeAPIs>true|false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
<AllowedMethods>comma-separated-list-of-HTTP-verbs</AllowedMethods>
<MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
<ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>
<AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true|false</Enabled>
<Days>number-of-days</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true|false</Enabled>
<IndexDocument>default-name-of-index-page-under-each-directory</IndexDocument>
<DefaultIndexDocumentPath>absolute-path-of-the-default-index-page</DefaultIndexDocumentPath>
<ErrorDocument404Path>absolute-path-of-the-custom-404-page</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
A választörzs elemeit a következő táblázat ismerteti:
Elem neve | Leírás |
---|---|
Logging | Az Azure Analytics naplózási beállításainak csoportosítása . |
Metrikák | Az Azure Analytics-metrikák beállításainak csoportosítása . A Metrikák beállításai a kérelmek statisztikáinak összegzését adják meg, API szerint csoportosítva, a blobok óránkénti összesítésében. |
HourMetrics | Az Azure Analytics HourMetrics beállításainak csoportosítása . A HourMetrics beállításai a kérelmek statisztikáinak összegzését adják meg API-k szerint csoportosítva a blobok óránkénti összesítésében. |
MinuteMetrics | Az Azure Analytics MinuteMetrics beállításainak csoportosítása . A MinuteMetrics beállításai a blobok percenkénti kérésstatisztikáit adják meg. |
Verzió | A jelenleg használatban lévő Storage Analytics verziója. |
Törlés | Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy a rendszer naplózza-e a törlési kérelmeket. |
Olvasás | Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy az olvasási kérelmek naplózása folyamatban van-e. |
Írás | Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy az írási kérelmek naplózása folyamatban van-e. |
Engedélyezve | Azt jelzi, hogy engedélyezve vannak-e a metrikák a Blob Storage-hoz. Ha az olvasási hozzáférés georedundáns replikációja engedélyezve van, az elsődleges és a másodlagos metrikákat is összegyűjti a rendszer. Ha az olvasási hozzáférés georedundáns replikációja nincs engedélyezve, csak az elsődleges metrikák lesznek összegyűjtve. |
IncludeAPI-k | Csak a metrikák konfigurálására vonatkozik. Azt jelzi, hogy a metrikák létrehoznak-e összefoglaló statisztikákat az úgynevezett API-műveletekhez. |
RetentionPolicy/Enabled | Azt jelzi, hogy engedélyezve van-e adatmegőrzési szabályzat az Azure Storage-hoz. |
RetentionPolicy/Days | Azt jelzi, hogy hány napig őrzi meg a metrikákat vagy a naplózási adatokat. Az ennél az értéknél régebbi adatok törlődnek. |
DefaultServiceVersion | Azt az alapértelmezett verziót jelöli, amelyet a Blob Storage-nak küldött kérésekhez használni kell, ha egy bejövő kérelem verziója nincs megadva. Az értékek közé tartozik a 2008-10-27-es és újabb verzió. Az alkalmazható verziókkal kapcsolatos további információkért lásd: Az Azure Storage-szolgáltatások verziószámozása. |
Cors | Az összes CORS-szabály csoportosítása. |
CorsRule | CORS-szabály beállításainak csoportosítása. |
Engedélyezettorigins | A CORS-on keresztül engedélyezett forrástartományok vesszővel tagolt listája vagy "*", ha minden tartomány engedélyezve van. |
ExposedHeaders | A CORS-ügyfelek számára közzéteendő válaszfejlécek vesszővel tagolt listája. |
MaxAgeInSeconds | Azon másodpercek száma, amikor az ügyfélnek/böngészőnek gyorsítótáraznia kell az elővizsgálati választ. |
AllowedHeaders | Olyan fejlécek vesszővel tagolt listája, amelyek részt vehetnek a forrásközi kérésben. |
Engedélyezettmethodok | A forrás által végrehajtható HTTP-metódusok vesszővel tagolt listája. Az Azure Storage esetében a megengedett módszerek a DELETE, a GET, a HEAD, a MERGE, a POST, a OPTIONS és a PUT. |
DeleteRetentionPolicy | Az Azure Delete beállításainak csoportosítása. Csak a Blob Storage-ra vonatkozik. |
Engedélyezve | Azt jelzi, hogy a törölt blob vagy pillanatkép megmarad-e, vagy a törlési művelet azonnal eltávolítja őket. |
Nap | Azt jelzi, hogy hány napig kell megőrizni a törölt blobot. Az ennél az értéknél régebbi adatok véglegesen törlődnek. |
StaticWebsite | A statikuswebhely beállításainak csoportosítása . Csak a Blob Storage-ra vonatkozik. |
StaticWebsite/Enabled | Azt jelzi, hogy engedélyezve van-e a statikuswebhely-támogatás a megadott fiókhoz. |
StaticWebsite/IndexDocument | Az Azure Storage által a webhely gyökeréhez vagy bármely almappához (például index.html ) érkező kérésekhez használt weblap. Az érték megkülönbözteti a kis- és nagybetűk értékét. |
StaticWebsite/DefaultIndexDocumentPath | Az Azure Storage által a meglévő fájlnak nem megfelelő kérésekhez használt weblap abszolút elérési útja. A rendszer visszaadja a lap HTTP 200 OK tartalmát (például index.html ). Az elem kölcsönösen kizárja a következővel: StaticWebsite/IndexDocument . Az érték megkülönbözteti a kis- és nagybetűk értékét. |
StaticWebsite/ErrorDocument404Path | Az Azure Storage által a meglévő fájlnak nem megfelelő kérésekhez használt weblap abszolút elérési útja. A rendszer visszaadja a lap HTTP 404 Not Found tartalmát (például error/404.html ). Az érték megkülönbözteti a kis- és nagybetűk értékét. |
Engedélyezés
Az Azure Storage-ban bármilyen adathozzáférési művelet meghívásához engedélyezésre van szükség. A műveletet az Get Blob Service Properties
alábbiak szerint engedélyezheti.
Az Azure Storage támogatja az Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsá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 szembeni kérések engedélyezésére használható.
További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobok hozzáférésének engedélyezése Microsoft Entra ID használatával.
Engedélyek
Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívja a Get Blob Service Properties
műveletet, valamint a legkevésbé kiemelt beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:
- Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/read
- Legkevésbé kiemelt beépített szerepkör:Tárfiók közreműködője
A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt az Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshez című témakörben talál.
Megjegyzések
Nincsenek. A művelet költségre gyakorolt hatásáról további információt a számlázási információkban talál.
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 Blob Service Properties
mutatja be:
Művelet | Tárfiók típusa | Számlázási kategória |
---|---|---|
Blobszolgáltatás tulajdonságainak lekérése | Prémium szintű blokkblob Standard általános célú v2 |
Egyéb műveletek |
Blobszolgáltatás tulajdonságainak 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.
Mintakérés és válasz
Az alábbi URI-minta kérést küld egy myaccount nevű fiktív tárfiók Blob Storage-tulajdonságainak lekérésére:
GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties&timeout=30 HTTP/1.1
A kérést a rendszer a következő fejlécekkel küldi el:
x-ms-version: 2018-03-28
x-ms-date: Tue, 12 Sep 2018 23:38:36 GMT
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.blob.core.windows.net
A kérés elküldése után a rendszer a következő választ adja vissza:
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2018-03-28
Date: Tue, 12 Sep 2018 23:38:35 GMT
A válasz a következő XML-törzset tartalmazza:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
<Logging>
<Version>1.0</Version>
<Delete>true</Delete>
<Read>false</Read>
<Write>true</Write>
<RetentionPolicy>
<Enabled>true</Enabled>
<Days>7</Days>
</RetentionPolicy>
</Logging>
<HourMetrics>
<Version>1.0</Version>
<Enabled>true</Enabled>
<IncludeAPIs>false</IncludeAPIs>
<RetentionPolicy>
<Enabled>true</Enabled>
<Days>7</Days>
</RetentionPolicy>
</HourMetrics>
<MinuteMetrics>
<Version>1.0</Version>
<Enabled>true</Enabled>
<IncludeAPIs>true</IncludeAPIs>
<RetentionPolicy>
<Enabled>true</Enabled>
<Days>7</Days>
</RetentionPolicy>
</MinuteMetrics>
<Cors>
<CorsRule>
<AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>
<AllowedMethods>GET,PUT</AllowedMethods>
<MaxAgeInSeconds>500</MaxAgeInSeconds>
<ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>
<AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>
</CorsRule>
</Cors>
<DefaultServiceVersion>2017-07-29</DefaultServiceVersion>
<DeleteRetentionPolicy>
<Enabled>true</Enabled>
<Days>5</Days>
</DeleteRetentionPolicy>
<StaticWebsite>
<Enabled>true</Enabled>
<IndexDocument>index.html</IndexDocument>
<ErrorDocument404Path>error/404.html</ErrorDocument404Path>
</StaticWebsite>
</StorageServiceProperties>
Lásd még
Storage Analytics
CORS-támogatás az Azure Storage-szolgáltatásokhoz
CORS HTTP-specifikáció