Nastavení vlastností služby Blob Service

Článek
02/07/2024

Operace Set Blob Service Properties nastaví vlastnosti koncového bodu služby Blob Storage účtu úložiště, včetně vlastností pro Analýza úložiště, pravidel sdílení prostředků mezi zdroji (CORS) a nastavení obnovitelného odstranění.

Pomocí této operace můžete také nastavit výchozí verzi žádosti pro všechny příchozí požadavky do služby Blob Storage, které nemají zadanou verzi.

Další informace o pravidlech CORS najdete v tématu Podpora CORS pro služby Azure Storage.

Žádost

Žádost Set Blob Service Properties může být zadána následujícím způsobem. Doporučujeme použít https. Nahraďte název účtu názvem vašeho účtu úložiště:

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PUT	`https://account-name.blob.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Poznámka

Identifikátor URI musí vždy obsahovat znak lomítka (/), aby se název hostitele oddělil od části cesty a dotazu identifikátoru URI. V této operaci je část cesty identifikátoru URI prázdná.

Parametry identifikátoru URI

Parametr identifikátoru URI	Description
`restype=service&comp=properties`	Povinná hodnota. K nastavení vlastností služby úložiště se vyžaduje kombinace obou řetězců dotazu.
`timeout`	Nepovinný parametr. Parametr `timeout` je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Blob Storage.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje schéma autorizace, název účtu úložiště a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date` nebo `x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`x-ms-version`	Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Blob Storage.

Text požadavku

Pro verzi 2012-02-12 a starší je formát textu požadavku následující:

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

Pro verzi 2013-08-15 a novější je formát textu požadavku následující:

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

Pro verzi 2017-07-29 a novější je formát textu požadavku následující:

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

Pro verzi 2018-03-28 a novější je formát textu požadavku následující:

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

Pro verzi 2019-12-12 a novější je formát textu požadavku následující:

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

Od verze 2013-08-15 můžete volat Set Blob Service Properties s jedním nebo více kořenovými prvky zadanými v textu požadavku. Mezi kořenové prvky patří:

Protokolování
HourMetrics
MinuteMetrics
Cors
DefaultServiceVersion
DeleteRetentionPolicy: Verze 2017-07-29 a novější
StaticWebová lokalita: Verze 2018-03-28 a novější

Už není nutné zadávat každý kořenový prvek v požadavku. Pokud vynecháte kořenový prvek, stávající nastavení služby pro tuto funkci se zachovají. Pokud však zadáte kořenový prvek, musíte zadat každý podřízený prvek pro tento prvek.

Následující tabulka popisuje prvky textu požadavku:

Název elementu	Popis
Protokolování	Volitelné od verze 2013-08-15. Požadováno pro starší verze. Seskupí nastavení protokolování Azure Analytics.
Metriky	Vyžaduje se pro verzi 2012-02-12 a starší. Neplatí pro verzi 2013-08-15 a novější. Seskupí nastavení metrik Azure Analytics, která poskytují souhrn statistik žádostí seskupených podle rozhraní API v hodinové agregaci objektů blob.
HourMetrics	Volitelné pro verzi 2013-08-15 a novější; se nevztahuje na starší verze. Seskupí nastavení Azure Analytics HourMetrics , která poskytují souhrn statistik žádostí seskupených podle rozhraní API v hodinových agregacích pro objekty blob.
MinuteMetrics	Volitelné pro verzi 2013-08-15 a novější; se nevztahuje na starší verze. Seskupí nastavení Azure Analytics MinuteMetrics , která poskytují statistiky žádostí pro každou minutu pro objekty blob. Pro verze starší než 2013-08-15 není MinuteMetrics součástí textu odpovědi.
Verze	Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Verze Analýza úložiště, která se má nakonfigurovat.
Odstranit	Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Platí jenom pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny žádosti o odstranění.
Read	Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Platí jenom pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny žádosti o čtení.
Write	Vyžaduje se, pokud jsou zadána nastavení Protokolování, Metriky, HourMetrics nebo MinuteMetrics. Platí jenom pro konfiguraci protokolování. Určuje, jestli se mají protokolovat všechny žádosti o zápis.
Povoleno	Povinná hodnota. Určuje, jestli jsou metriky povolené pro službu Blob Storage. Pokud je povolená geograficky redundantní replikace s přístupem pro čtení, shromažďují se primární i sekundární metriky. Pokud není povolená geograficky redundantní replikace s přístupem pro čtení, shromažďují se jenom primární metriky.
IncludeAPIs	Povinné pouze v případě, že jsou povolené metriky. Platí jenom pro konfiguraci metrik. Určuje, jestli by metriky měly generovat souhrnné statistiky pro operace volaných rozhraní API.
Zásady uchovávání informací / Povoleno	Povinná hodnota. Určuje, jestli je pro službu úložiště povolená zásada uchovávání informací.
Zásady uchovávání informací/dny	Povinné pouze v případě, že jsou povolené zásady uchovávání informací. Určuje počet dnů, po který se mají metriky nebo data protokolování uchovávat. Všechna data, která jsou starší než tato hodnota, se odstraní. Minimální hodnota, kterou můžete zadat, je `1`; největší hodnota je `365` (jeden rok).
RetentionPolicy/AllowPermanentDelete	Volitelné, verze 2020-02-10 a novější. Umožňuje povolit trvalé odstranění účtu úložiště. Výchozí hodnotou je `false.`.
DefaultServiceVersion	Nepovinný parametr. Pokud chcete nastavit DefaultServiceVersion, zavolejte `Set Blob Service Properties` ve verzi 2011-08-18 a novější. DefaultServiceVersion označuje výchozí verzi, která se má použít pro požadavky na službu Blob Storage, pokud není zadaná verze příchozího požadavku. Možné hodnoty zahrnují verzi 2008-10-27 a novější. Další informace o příslušných verzích najdete v tématu Správa verzí pro služby Azure Storage. Platí jenom pro Blob Storage.
Cors	Nepovinný parametr. Element Cors je podporovaný pro verzi 2013-08-15 a novější. Seskupí všechna pravidla CORS. Vynecháním této skupiny prvků nedojde k přepsání existujících nastavení CORS.
CorsRule	Nepovinný parametr. Určuje pravidlo CORS pro Blob Storage. Do žádosti můžete zahrnout až pět prvků CorsRule . Pokud v textu požadavku nejsou zahrnuté žádné prvky CorsRule , odstraní se všechna pravidla CORS a cors se pro Blob Storage zakáže.
AllowedOrigins	Vyžaduje se, pokud je k dispozici element CorsRule . Seznam domén původu oddělených čárkami, které jsou povoleny prostřednictvím CORS, nebo "*" pro povolení všech domén. Původní doména může také v subdoméně obsahovat zástupný znak, který umožňuje žádosti prostřednictvím CORS pro všechny subdomény domény. Omezeno na 64 původních domén. Každý povolený původ může mít až 256 znaků.
Exponované hlavičky	Vyžaduje se, pokud je k dispozici element CorsRule . Seznam hlaviček odpovědí oddělených čárkami, které se mají zpřístupnit klientům CORS. Omezeno na 64 definovaných hlaviček a dvě předpony. Každé záhlaví může mít maximálně 256 znaků.
MaxAgeInSeconds	Vyžaduje se, pokud je k dispozici element CorsRule . Počet sekund, po který by měl klient nebo prohlížeč uložit předběžnou odpověď do mezipaměti.
AllowedHeaders	Vyžaduje se, pokud existuje element CorsRule . Seznam záhlaví oddělených čárkami, který může být součástí požadavku mezi zdroji. Omezeno na 64 definovaných hlaviček a 2 záhlaví s předponou. Každé záhlaví může mít maximálně 256 znaků.
AllowedMethods	Vyžaduje se, pokud existuje element CorsRule . Seznam metod HTTP oddělených čárkami, které mohou být spouštěné zdrojem. Pro Azure Storage jsou povolené metody DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS a PUT.
DeleteRetentionPolicy	Nepovinný parametr. Pokud chcete nastavit DeleteRetentionPolicy, zavolejte `Set Blob Service Properties` ve verzi 2017-07-29 a novější. Seskupí nastavení obnovitelného odstranění. Platí jenom pro Blob Storage.
DeleteRetentionPolicy/Enabled	Povinná hodnota. Označuje, jestli se odstraněný objekt blob nebo snímek zachovají nebo okamžitě odeberou operací odstranění.
DeleteRetentionPolicy/Days	Povinné pouze v případě, že hodnota DeleteRetentionPolicy/Enabled má hodnotu true. Určuje počet dnů, po které se odstraněný objekt blob uchovává. Všechna data, která jsou starší než tato hodnota, se trvale odstraní. Minimální hodnota, kterou můžete zadat, je `1`; největší hodnota je `365`.
Statickýweb	Nepovinný parametr. Pokud chcete nastavit vlastnosti StaticWebsite , zavolejte `Set Blob Service Properties` ve verzi 2018-03-28 a novější. Platí jenom pro Blob Storage.
StaticWebová lokalita / Povoleno	Povinná hodnota. Určuje, jestli je pro zadaný účet povolená podpora statických webů.
StaticWebsite/IndexDocument	Nepovinný parametr. Webová stránka, kterou Azure Storage slouží pro požadavky na kořen webu nebo libovolnou podsložku (například `index.html`). V hodnotě se rozlišují velká a malá písmena.
StaticWebsite/DefaultIndexDocumentPath	Nepovinný parametr. Absolutní cesta k webové stránce, kterou Azure Storage slouží pro požadavky, které neodpovídají existujícímu souboru. Obsah stránky se vrátí pomocí `HTTP 200 OK` (například `index.html`). Prvek se vzájemně vylučuje s `StaticWebsite/IndexDocument`. V hodnotě se rozlišují velká a malá písmena.
StaticWebsite/ErrorDocument404Path	Nepovinný parametr. Absolutní cesta k webové stránce, kterou Azure Storage slouží pro požadavky, které neodpovídají existujícímu souboru. Obsah stránky se vrátí pomocí `HTTP 404 Not Found` (například `error/404.html`). Na každém statickém webu je podporována pouze jedna vlastní stránka 404. V hodnotě se rozlišují velká a malá písmena.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 202 (přijato).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
`x-ms-request-id`	Jedinečně identifikuje požadavek provedený vůči službě.
`x-ms-version`	Určuje verzi operace použité pro odpověď. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-client-request-id`	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička `x-ms-client-request-id` v požadavku není, nebude v odpovědi.

Text odpovědi

Žádné

Autorizace

Při volání jakékoli operace přístupu k datům ve službě Azure Storage se vyžaduje autorizace. Operaci můžete autorizovat, Set Blob Service Properties jak je popsáno níže.

Azure Storage podporuje autorizaci požadavků na data objektů blob pomocí Microsoft Entra ID. S Microsoft Entra ID můžete pomocí řízení přístupu na základě role v Azure (Azure RBAC) udělit oprávnění k objektu zabezpečení. Objektem zabezpečení může být uživatel, skupina, instanční objekt aplikace nebo spravovaná identita Azure. Objekt zabezpečení je ověřen Microsoft Entra ID, aby vrátil token OAuth 2.0. Token se pak dá použít k autorizaci požadavku na službu Blob Service.

Další informace o autorizaci pomocí Microsoft Entra ID najdete v tématu Autorizace přístupu k objektům blob pomocí Microsoft Entra ID.

Oprávnění

Níže jsou uvedené akce RBAC potřebné k volání operace Microsoft Entra uživatele, skupiny nebo instančního Set Blob Service Properties objektu a předdefinované role Azure RBAC s nejnižšími oprávněními, která zahrnuje tuto akci:

Akce Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/write
Nejméně privilegovaná předdefinovaná role:Přispěvatel účtu úložiště

Další informace o přiřazování rolí pomocí Azure RBAC najdete v tématu Přiřazení role Azure pro přístup k datům objektů blob.

Sdílený přístupový podpis (SAS) poskytuje zabezpečený delegovaný přístup k prostředkům v účtu úložiště. V případě SAS máte podrobnou kontrolu nad tím, jak může klient přistupovat k datům. Můžete určit, k jakému prostředku může klient přistupovat, jaká oprávnění k těmto prostředkům má a jak dlouho je sas platný.

Operace Set Blob Service Properties podporuje autorizaci pomocí SAS účtu.

Pokud je přístup ke sdílenému klíči pro účet úložiště zakázaný, token SAS účtu nebude na žádost do služby Blob Storage povolený. Další informace najdete v tématu Vysvětlení, jak zakázání sdíleného klíče ovlivňuje tokeny SAS.

Sas účtu

SAS účtu je zabezpečené pomocí klíče účtu úložiště. SAS účtu deleguje přístup k prostředkům v jedné nebo více službách úložiště. Všechny operace dostupné prostřednictvím sas pro službu nebo delegování uživatele jsou dostupné také prostřednictvím SAS účtu.

Následující tabulka uvádí typ podepsaného prostředku a podepsaná oprávnění, která se mají zadat při delegování přístupu:

Operace	Podepsaná služba	Typ podepsaného prostředku	Podepsané oprávnění
Nastavení vlastností služby Blob Service	Objekt blob (b)	Služby	Zápis (w)

Další informace o SAS účtu najdete v tématu Vytvoření SAS účtu.

Poznámky

Na pravidla CORS ve službě Azure Storage se vztahují následující omezení:

Je možné uložit maximálně pět pravidel.
Maximální velikost všech nastavení pravidel CORS v požadavku s výjimkou značek XML by neměla překročit 2 KiB.
Délka povolené hlavičky, zveřejněné hlavičky nebo povoleného původu by neměla překročit 256 znaků.
Povolené a vystavené hlavičky můžou být:
- Záhlaví literálů, kde je zadaný přesný název hlavičky, například x-ms-meta-processed. V požadavku může být zadáno maximálně 64 záhlaví literálů.
- Hlavičky s předponou, kde je k dispozici předpona záhlaví, například x-ms-meta-data*. Zadáním předpony tímto způsobem povolíte nebo zpřístupníte jakoukoli hlavičku, která začíná určenou předponou. V požadavku mohou být zadány maximálně dvě hlavičky s předponou.
Metody (nebo příkazy HTTP), které jsou zadané v prvku AllowedMethods , musí odpovídat metodám podporovaným rozhraními API služby Azure Storage. Podporované metody jsou DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS a PUT.

Zadání pravidel CORS v požadavku je volitelné. Pokud zavoláte Set Blob Service Properties bez zadání elementu Cors v textu požadavku, budou zachována všechna existující pravidla CORS.

Pokud chcete CORS zakázat, zavolejte Set Blob Service Properties s prázdným nastavením pravidel CORS (to znamená)</Cors> a bez vnitřních pravidel CORS. Toto volání odstraní všechna existující pravidla a zakáže CORS pro Blob Storage.

Všechny prvky pravidla CORS jsou vyžadovány, pokud je zadán element CorsRule . Pokud některý prvek chybí, požadavek selže s kódem chyby 400 (Bad Request).

Od verze 2013-08-15 jsou elementy nastavení XML volitelné, takže můžete aktualizovat konkrétní prvek odesláním XML, který obsahuje pouze aktualizovaný element. Na ostatní nastavení to nemá vliv.

Podrobné informace o pravidlech CORS a logice vyhodnocení najdete v tématu Podpora CORS pro služby Azure Storage.

Fakturace

Žádosti o ceny můžou pocházet od klientů, kteří používají rozhraní BLOB Storage API, a to buď přímo prostřednictvím rozhraní REST API služby Blob Storage, nebo z klientské knihovny Služby Azure Storage. Tyto požadavky načítají poplatky za transakci. Typ transakce ovlivňuje způsob účtování poplatku za účet. Například transakce čtení se načítají do jiné kategorie fakturace než transakce zápisu. Následující tabulka ukazuje kategorii fakturace pro Set Blob Service Properties žádosti založené na typu účtu úložiště:

Operace	Typ účtu úložiště	Kategorie fakturace
Nastavení vlastností služby Blob Service	Objekt blob bloku úrovně Premium Standard pro obecné účely v2	Další operace
Nastavení vlastností služby Blob Service	Standard pro obecné účely v1	Operace zápisu

Informace o cenách pro zadanou kategorii fakturace najdete v tématu Azure Blob Storage Ceny.

Ukázkový požadavek a odpověď

Následující ukázkový identifikátor URI vytvoří požadavek na změnu vlastností služby Blob Storage pro fiktivní účet úložiště s názvem myaccount:

PUT https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

Požadavek se odešle s následujícími hlavičkami:

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

Požadavek se odešle s následujícím textem XML:

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

Po odeslání požadavku se vrátí následující odpověď:

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

Viz také

Storage Analytics
Podpora CORS pro služby Azure Storage
Specifikace PROTOKOLU HTTP CORS