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:

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ó