Nastavení vlastností služby Blob Service

  • Článek

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. Skupiny 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ší. Skupiny nastavení metrik Azure Analytics, které poskytuje 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. Skupiny nastavení Azure Analytics HourMetrics, které poskytuje souhrn statistik žádostí seskupených podle rozhraní API v hodinové agregaci objektů blob.
MinuteMetrics Volitelné pro verzi 2013-08-15 a novější; se nevztahuje na starší verze. Skupiny nastavení Azure Analytics MinuteMetrics, která poskytují statistiky žádostí o 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é jenom v případě, že jsou povolené metriky. Platí jenom pro konfiguraci metrik. Určuje, jestli mají metriky generovat souhrnné statistiky pro volané operace rozhraní API.
RetentionPolicy/Enabled Povinná hodnota. Určuje, jestli je pro službu úložiště povolená zásada uchovávání informací.
RetentionPolicy/Days Vyžaduje se 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í pro účet úložiště. Výchozí hodnotou je false..
Výchozí verze služby Nepovinný parametr. Pokud chcete nastavit DefaultServiceVersion, zavolejte Set Blob Service Properties ho pomocí verze 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. Mezi možné hodnoty patří verze 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ší. Skupiny 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 službu Blob Storage. Do požadavku 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 službu Blob Storage zakáže.
AllowedOrigins Vyžaduje se, pokud existuje element CorsRule . Seznam počátečních domén oddělených čárkami, které jsou povoleny prostřednictvím CORS, nebo *, pokud chcete povolit všechny domény. 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 domén původu. Každý povolený původ může mít maximálně 256 znaků.
ExposedHeaders Vyžaduje se, pokud existuje 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ě hlavičky s předponou. Každé záhlaví může mít maximálně 256 znaků.
MaxAgeInSeconds Vyžaduje se, pokud existuje element CorsRule . Počet sekund, po který má klient nebo prohlížeč ukládat předběžnou odpověď do mezipaměti.
Povolené hlavičky Vyžaduje se, pokud existuje element CorsRule . Čárkami oddělený seznam hlaviček, které mohou být součástí požadavku mezi zdroji. Omezeno na 64 definovaných hlaviček a 2 hlavičky 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 provedeny původem. Pro Azure Storage jsou povolené metody DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS a PUT.
OdstranitRetentionPolicy Nepovinný parametr. Pokud chcete nastavit DeleteRetentionPolicy, zavolejte Set Blob Service Properties metodu s použitím verze 2017-07-29 nebo novější. Skupiny nastavení obnovitelného odstranění. Platí jenom pro Blob Storage.
DeleteRetentionPolicy/Enabled Povinná hodnota. Určuje, jestli se odstraněný objekt blob nebo snímek zachovají nebo okamžitě odeberou operací odstranění.
DeleteRetentionPolicy/Days Požadováno 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 je Set Blob Service Properties pomocí verze 2018-03-28 a novější. Platí jenom pro Blob Storage.
StaticWebsite/Enabled Povinná hodnota. Určuje, jestli je pro zadaný účet povolená podpora statického webu.
StaticWebsite/IndexDocument Nepovinný parametr. Webová stránka, kterou Azure Storage používá pro požadavky do kořenového adresáře webu nebo jakékoli podsložky (například index.html). V hodnotě se rozlišují malá a velká písmena.
StaticWebsite/DefaultIndexDocumentPath Nepovinný parametr. Absolutní cesta k webové stránce, kterou Azure Storage obsluhuje pro požadavky, které neodpovídají existujícímu souboru. Obsah stránky se vrátí pomocí HTTP 200 OK příkazu (například index.html). Prvek se vzájemně vylučuje s elementem StaticWebsite/IndexDocument. V hodnotě se rozlišují malá a velká písmena.
StaticWebsite/ErrorDocument404Path Nepovinný parametr. Absolutní cesta k webové stránce, kterou Azure Storage obsluhuje pro požadavky, které neodpovídají existujícímu souboru. Obsah stránky se vrátí pomocí HTTP 404 Not Found příkazu (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í malá a velká 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.

Důležité

Microsoft doporučuje používat Microsoft Entra ID se spravovanými identitami k autorizaci požadavků do služby Azure Storage. Microsoft Entra ID ve srovnání s autorizací sdíleného klíče poskytuje vynikající zabezpečení a snadné použití.

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, spravované identity nebo instančního objektu Set Blob Service Properties a nejméně privilegované integrované role Azure RBAC, která zahrnuje tuto akci:

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.

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 CORS HTTP