Nastavení vlastností služby Blob Service

Článek
05/15/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. 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:

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

Sdílet prostřednictvím