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

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. Az Azure Analytics naplózási beállításainak csoportosítása .
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. Az Azure Analytics-metrikák beállításainak csoportosítása, amely az API-k szerint csoportosított kérésstatisztikák összegzését adja 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. Az Azure Analytics HourMetrics beállításainak csoportosítása, amely az API-k szerint csoportosított kérelemstatisztikák összegzését adja 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. Az Azure Analytics MinuteMetrics beállításait csoportosítja , amelyek a blobok minden percére vonatkozóan kérésstatisztikát biztosítanak. 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; 1a 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. Az összes CORS-szabály csoportosítása. 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. Csoportosítja a helyreállítható törlés beállításait. 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 ; 1a 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ásra irányuló 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 megfelelő válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, é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 az nem jelenik meg a válaszban.

Választörzs

Nincsenek.

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

Microsoft Entra ID

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 azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure-beli felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatásra irányuló 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: Blobokhoz való hozzáférés 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 Set Blob Service Properties műveletet, valamint a legkevésbé emelt szintű beépített Azure RBAC-szerepkört, 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ével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

Közös hozzáférésű jogosultságkódok (SAS)

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. Az SAS-sel 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 Set Blob Service Properties művelet támogatja a fiók SAS használatával történő engedélyezést.

Ha a tárfiók megosztott kulcshoz való hozzáférése nem engedélyezett, a fiók SAS-jogkivonata nem lesz engedélyezve a Blob Storage felé irányuló kérés esetén. 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 védelme a tárfiók kulcsával történik. 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ó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 kell megadni:

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)

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

Megosztott kulcs

A művelet támogatja a Set Blob Service Propertiesmegosztott kulcs engedélyezését. A fiókkulcsokkal való engedélyezés a legtöbb esetben nem ajánlott, mivel kevésbé biztonságos. A Microsoft azt javasolja, hogy lehetőség szerint tiltsa le a megosztott kulcs engedélyezését a tárfiókhoz. További információ: Engedélyezés megakadályozása megosztott kulccsal.

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 összes CORS-szabálybeállításának maximális mérete – az XML-címkék kivételével – nem haladhatja meg a 2 KiB-t.

• 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ál fejlécek, ahol a pontos fejlécnév szerepel, 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érelemhez nem kötelező. Ha a kérés törzsében a Cors elem megadása nélkül hívSet Blob Service Properties, a meglévő CORS-szabályok megmaradnak.

A CORS letiltásához egy üres CORS-szabálybeállítással (azaz</Cors>) és belső CORS-szabályok nélkül hívja Set Blob Service Properties meg a hívást. 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. Ha valamelyik elem hiányzik, a kérés 400-ás (Bad Request) hibakóddal meghiúsul.

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 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 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áról a Azure Blob Storage Díjszabás című témakörben talál további információt.

Mintakérés és válasz

A következő minta URI 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és a következő fejlécekkel lesz elküldve:

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és a következő XML-törzstel lesz elküldve:

<?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ó