Blobszolgáltatás tulajdonságainak beállítása

Cikk
05/15/2024

A Set Blob Service Properties művelet beállítja a tárfiók Blob Storage-végpontjának tulajdonságait, beleértve a Storage Analytics tulajdonságait, a forrásközi erőforrás-megosztási (CORS) szabályokat és a helyreállítható törlési beállításokat.

Ezzel a művelettel beállíthatja az összes bejövő kérés alapértelmezett kérési verzióját olyan Blob Storage-ra, amely nem rendelkezik megadott verzióval.

További információ a CORS-szabályokról: CORS-támogatás az Azure Storage-szolgáltatásokhoz.

Kérés

A Set Blob Service Properties kérés a következőképpen adható meg. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a fióknevet a tárfiók nevére:

Metódus	Kérés URI-ja	HTTP-verzió
PUT	`https://account-name.blob.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Megjegyzés

Az URI-nak mindig tartalmaznia kell egy perjel karaktert (/), amely elválasztja a gazdagépnevet az URI elérési útjától és lekérdezési részeitő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 tárolási szolgáltatás tulajdonságainak beállításához mindkét lekérdezési sztring kombinációjára szükség van.
`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

A 2012-02-12-es és korábbi verziók esetében a kérelemtörzs 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>  
    <!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

A 2013-08-15-ös és újabb verziók esetében a kérelemtörzs 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>  
    <!-- The DefaultServiceVersion element can only be set for Blob Storage, and the request must be made using version 2011-08-18 and later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>

A 2017-07-29-es és újabb verziók esetében a kérelem 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 és újabb verziók esetében a kérelemtörzs 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 és újabb verziók esetében a kérelemtörzs 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 2013-08-15-ös verziótól a Set Blob Service Properties kérés törzsében megadott egy vagy több gyökérelemet használhat. A gyökérelemek a következők:

Logging
HourMetrics
MinuteMetrics
Cors
DefaultServiceVersion
DeleteRetentionPolicy: 2017-07-29-es és újabb verzió
StaticWebsite: 2018-03-28-es és újabb verzió

A kérés minden gyökérelemét már nem kell megadni. Ha kihagy egy gyökérelemet, a szolgáltatás meglévő beállításai megmaradnak az adott funkcióhoz. Ha azonban megad egy gyökérelemet, meg kell adnia az elem minden gyermekelemét.

A következő táblázat a kérelem törzsének elemeit ismerteti:

Elem neve	Leírás
Logging	A 2013-08-15-ös verziótól nem kötelező. A korábbi verziókhoz szükséges. Csoportok az Azure Analytics naplózási beállításait.
Metrikák	A 2012-02-12-es és korábbi verzióhoz szükséges. Nem alkalmazható a 2013-08-15-ös és újabb verziókra. Csoportok az Azure Analytics-metrikák beállításait, amelyek az API-k szerint csoportosított kérésstatisztikák összegzését adják meg a blobok óránkénti összesítésében.
HourMetrics	Nem kötelező a 2013-08-15-ös és újabb verziókhoz; nem alkalmazható a korábbi verziókra. Csoportok az Azure Analytics HourMetrics beállításait, amelyek az API-k szerint csoportosított kérésstatisztikák összegzését adják meg a blobok óránkénti összesítésében.
MinuteMetrics	Nem kötelező a 2013-08-15-ös és újabb verziókhoz; nem alkalmazható a korábbi verziókra. Csoportok az Azure Analytics MinuteMetrics beállításait, amelyek a blobok percenkénti statisztikáit adják meg. A 2013-08-15-nél korábbi verziók esetében a MinuteMetrics nem szerepel a válasz törzsében.
Verzió	A Naplózás, a Metrikák, a HourMetrics vagy a MinuteMetrics beállítás megadása kötelező. A konfigurálni kívánt Storage Analytics verziója.
Törlés	A Naplózás, a Metrikák, a HourMetrics vagy a MinuteMetrics beállítás megadása kötelező. Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy az összes törlési kérést naplózni kell-e.
Olvasás	A Naplózás, a Metrikák, a HourMetrics vagy a MinuteMetrics beállítás megadása kötelező. Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy minden olvasási kérést naplózni kell-e.
Írás	A Naplózás, a Metrikák, a HourMetrics vagy a MinuteMetrics beállítás megadása kötelező. Csak a naplózási konfigurációra vonatkozik. Azt jelzi, hogy minden írási kérést naplózni kell-e.
Engedélyezve	Kötelező. 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 akkor szükséges, ha a metrikák engedélyezve vannak. Csak a metrikakonfigurációra vonatkozik. Azt jelzi, hogy a metrikák létrehoznak-e összefoglaló statisztikákat az úgynevezett API-műveletekhez.
RetentionPolicy/Enabled	Kötelező. Azt jelzi, hogy engedélyezve van-e egy adatmegőrzési szabályzat a tárolási szolgáltatáshoz.
RetentionPolicy/Days	Csak akkor szükséges, ha egy adatmegőrzési szabályzat engedélyezve van. Azt jelzi, hogy hány napig kell megőrizni a metrikákat vagy a naplózási adatokat. Az ennél az értéknél régebbi adatok törlődnek. A megadható minimális érték; `1`a legnagyobb érték `365` (egy év).
RetentionPolicy/AllowPermanentDelete	Nem kötelező, 2020-02-10-es vagy újabb verzió. Lehetővé teszi a tárfiók végleges törlésének engedélyezését. Az alapértelmezett érték `false.`
DefaultServiceVersion	Választható. A DefaultServiceVersion beállításához hívja `Set Blob Service Properties` meg a 2011-08-18-es és újabb verziót. A DefaultServiceVersion azt az alapértelmezett verziót jelzi, amelyet a Blob Storage felé irányuló kérelmekhez kell használni, ha nincs megadva egy bejövő kérés verziója. A lehetséges értékek közé tartozik a 2008-10-27-es és újabb verzió. A vonatkozó verziókkal kapcsolatos további információkért lásd : Az Azure Storage-szolgáltatások verziószámozása. Csak a Blob Storage-ra vonatkozik.
Cors	Választható. A Cors elem a 2013-08-15-ös és újabb verziókban támogatott. Csoportok az összes CORS-szabályt. Ha kihagyja ezt az elemcsoportot, az nem írja felül a meglévő CORS-beállításokat.
CorsRule	Választható. Cors-szabályt ad meg a Blob Storage-hoz. A kérelemben legfeljebb öt CorsRule-elem szerepelhet. Ha a kérés törzsében nem szerepelnek CorsRule-elemek , az összes CORS-szabály törlődik, és a CORS le van tiltva a Blob Storage esetében.
AllowedOrigins	Kötelező, ha a CorsRule elem jelen van. A CORS-on keresztül engedélyezett forrástartományok vesszővel tagolt listája, vagy "*" az összes tartomány engedélyezéséhez. A forrástartomány helyettesítő karaktert is tartalmazhat az altartományban, amely lehetővé teszi a CORS-on keresztüli kéréseket a tartomány összes altartományára vonatkozóan. Legfeljebb 64 forrástartomány lehet. Minden engedélyezett forrás legfeljebb 256 karakterből állhat.
ExposedHeaders	Kötelező, ha a CorsRule elem jelen van. A CORS-ügyfelek számára közzéteendő válaszfejlécek vesszővel tagolt listája. Legfeljebb 64 definiált fejléc és két előtagú fejléc lehet. Minden fejléc legfeljebb 256 karakter hosszúságú lehet.
MaxAgeInSeconds	Kötelező, ha a CorsRule elem jelen van. Azon másodpercek száma, ahányszor az ügyfélnek/böngészőnek gyorsítótáraznia kell az elővizsgálati választ.
AllowedHeaders	Kötelező, ha a CorsRule elem létezik. Azoknak a fejléceknek a vesszővel tagolt listája, amelyek a forrásközi kérelem részét képezhetik. Legfeljebb 64 definiált fejléc és 2 előtagú fejléc lehet. Minden fejléc legfeljebb 256 karakter hosszúságú lehet.
AllowedMethods	Kötelező, ha a CorsRule elem létezik. A forrás által végrehajtható HTTP-metódusok vesszővel tagolt listája. Az Azure Storage esetében az engedélyezett módszerek a KÖVETKEZŐK: DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS és PUT.
DeleteRetentionPolicy	Választható. A DeleteRetentionPolicy beállításához hívja `Set Blob Service Properties` meg a 2017-07-29-es és újabb verziót. Csoportok helyreállítható törlési beállításokat. Csak a Blob Storage-ra vonatkozik.
DeleteRetentionPolicy/Enabled	Kötelező. Azt jelzi, hogy a törölt blobot vagy pillanatképet egy törlési művelet megőrzi vagy azonnal eltávolítja.
DeleteRetentionPolicy/Days	Csak akkor szükséges, ha a DeleteRetentionPolicy/Enabled értéke igaz. A törölt blobok megőrzésének napjainak számát jelzi. Az ennél az értéknél régebbi adatok véglegesen törlődnek. A megadható minimális érték ; `1`a legnagyobb érték a `365`.
StaticWebsite	Választható. A StaticWebsite tulajdonságainak beállításához hívja `Set Blob Service Properties` meg a 2018-03-28-es vagy újabb verziót. Csak a Blob Storage-ra vonatkozik.
StaticWebsite/Enabled	Kötelező. Azt jelzi, hogy a statikus webhely támogatása engedélyezve van-e a megadott fiókhoz.
StaticWebsite/IndexDocument	Választható. Az a weblap, amelyet az Azure Storage a webhely gyökerének vagy bármely almappájának (például `index.html`) kéréseihez szolgál ki. Az érték megkülönbözteti a kis- és nagybetűk értékét.
StaticWebsite/DefaultIndexDocumentPath	Választható. 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 a következővel `HTTP 200 OK` adja vissza a lap 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	Választható. 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 a következővel `HTTP 404 Not Found` adja vissza a lap tartalmát (például `error/404.html`: ). Minden statikus webhelyen csak egyetlen egyéni 404-oldal támogatott. Az érték megkülönbözteti a kis- és nagybetűk értékét.

Reagálás

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

Állapotkód

A sikeres művelet a 202-s állapotkódot adja vissza (elfogadva).

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 küldött kérést.
`x-ms-version`	A válaszhoz használt 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`	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, az nem jelenik meg a válaszban.

Választörzs

Nincsenek.

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 Set Blob Service Properties alábbiak szerint engedélyezheti.

Fontos

A Microsoft azt javasolja, hogy Microsoft Entra ID felügyelt identitásokkal engedélyezze az Azure Storage-ra irányuló kéréseket. Microsoft Entra ID a megosztott kulcs engedélyezéséhez képest kiváló biztonságot és könnyű használatot biztosít.

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 felsoroljuk azt az RBAC-műveletet, amely a művelet meghívásához Set Blob Service Properties szükséges Microsoft Entra felhasználóhoz, csoporthoz, felügyelt identitáshoz vagy szolgáltatásnévhez, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkörhöz, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet:Microsoft.Storage/storageAccounts/blobServices/write
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.

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 esetén részletes vezérléssel rendelkezik arról, 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 hogy az SAS mennyi ideig érvényes.

A Set Blob Service Properties művelet támogatja az engedélyezést egy fiók SAS-jének használatával.

Ha a tárfiókhoz nincs engedélyezve a megosztott kulcshoz való hozzáférés, a Blob Storage-ra irányuló kérések esetén a fiók SAS-jogkivonata nem lesz engedélyezve. További információ: A megosztott kulcs letiltása hogyan befolyásolja az SAS-jogkivonatokat.

Fiók SAS-fiókja

A fiók SAS-jének biztonságát a tárfiókkulcs biztosítja. A fiókalapú SAS egy vagy több tárolószolgáltatás erőforrásaihoz nyújt 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 fiók SAS-en keresztül is elérhető.

Az alábbi táblázat az aláírt erőforrástípust és az aláírt engedélyeket jelzi, amelyet a hozzáférés delegálásakor meg kell adni:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Blobszolgáltatás tulajdonságainak beállítása	Blob (b)	Szolgáltatás (ok)	Írás (w)

A fiók SAS-járól további információt a fiók SAS-Létrehozás című témakörben talál.

Megjegyzések

Az alábbi korlátozások és korlátozások vonatkoznak az Azure Storage CORS-szabályaira:

Legfeljebb öt szabály tárolható.
A kérelem cors-szabálybeállításainak maximális mérete – az XML-címkék kivételével – nem haladhatja meg a 2 kib-ot.
Az engedélyezett fejléc, a közzétett fejléc vagy az engedélyezett forrás hossza nem haladhatja meg a 256 karaktert.
Az engedélyezett fejlécek és a közzétett fejlécek a következők lehetnek:
- Literális fejlécek, ahol meg van adva a fejléc pontos neve, például x-ms-meta-processed. A kérelemben legfeljebb 64 literális fejléc adható meg.
- Előtaggal rendelkező fejlécek, ahol meg van adva a fejléc előtagja, például x-ms-meta-data*. Az előtag ilyen módon történő megadása lehetővé teszi vagy elérhetővé teszi a megadott előtaggal kezdődő fejléceket. A kérelemben legfeljebb két előtagú fejléc adható meg.
Az AllowedMethods elemben megadott metódusoknak (vagy HTTP-parancsoknak) meg kell felelniük az Azure Storage API-k által támogatott metódusoknak. A támogatott módszerek a KÖVETKEZŐK: DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS és PUT.

A CORS-szabályok megadása a kérelemben nem kötelező. Ha a kéréstörzs Cors elemének megadása nélkül hívSet Blob Service Properties, a meglévő CORS-szabályok megmaradnak.

A CORS letiltásához hívjon Set Blob Service Properties üres CORS-szabályokkal (azaz</Cors>) és belső CORS-szabályok nélkül. Ez a hívás törli a meglévő szabályokat, és letiltja a CORS-t a Blob Storage-hoz.

Minden CORS-szabályelemre szükség van, ha a CorsRule elem meg van adva. A kérés 400-os hibakóddal (Bad Request) meghiúsul, ha valamelyik elem hiányzik.

A 2013-08-15-ös verziótól az XML-beállítások elemei nem kötelezőek, így egy adott elemet frissíthet egy olyan XML elküldésével, amely csak a frissített elemet tartalmazza. A többi beállításra nincs hatással.

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.

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 Set Blob Service Properties mutatja be:

Művelet	Tárfiók típusa	Számlázási kategória
Blobszolgáltatás tulajdonságainak beállítása	Prémium szintű blokkblob Standard általános célú v2	Egyéb műveletek
Blobszolgáltatás tulajdonságainak beállítása	Standard általános célú v1	Írá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 a myaccount nevű fiktív tárfiók Blob Storage-tulajdonságainak módosítására:

PUT https://myaccount.blob.core.windows.net/?restype=service&comp=properties 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:35 GMT 
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.blob.core.windows.net

A kérést a rendszer a következő XML-törzstel küldi el:

<?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>
    <DeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>5</Days>
    </DeleteRetentionPolicy>  
    <StaticWebsite>  
        <Enabled>true</Enabled>  
        <IndexDocument>index.html</IndexDocument>  
        <ErrorDocument404Path>error/404.html</ErrorDocument404Path>  
    </StaticWebsite>  
    <DefaultServiceVersion>2018-03-28</DefaultServiceVersion>  
</StorageServiceProperties>

A kérés elküldése után a rendszer a következő választ adja vissza:

HTTP/1.1 202 Accepted
Transfer-Encoding: chunked
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

Lásd még

Storage Analytics
CORS-támogatás az Azure Storage-szolgáltatásokhoz
CORS HTTP-specifikáció

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