Ustawianie właściwości usługi BLOB Service

Set Blob Service PropertiesOperacja ustawia właściwości dla punktu końcowego BLOB Service konta magazynu, w tym właściwości analityka magazynu, reguły CORS (współużytkowanie zasobów między źródłami) i ustawienia usuwania nietrwałego.

Można również użyć tej operacji, aby ustawić domyślną wersję żądania dla wszystkich żądań przychodzących do Blob service, dla których nie określono wersji.

Więcej informacji na temat reguł CORS można znaleźć w temacie Obsługa mechanizmu CORS dla usług magazynu .

Żądanie

Set Blob Service PropertiesŻądanie może być określone w następujący sposób. Zalecany jest protokół HTTPS. Zamień <account-name> na nazwę konta magazynu:

Metoda Identyfikator URI żądania Wersja protokołu HTTP
PUT https://<account-name>.blob.core.windows.net/?restype=service&comp=properties PROTOKÓŁ HTTP/1.1

Należy pamiętać, że identyfikator URI musi zawsze zawierać ukośnik (/), aby oddzielić nazwę hosta od części ścieżki i zapytania w identyfikatorze URI. W przypadku tej operacji część ścieżki identyfikatora URI jest pusta.

Parametry identyfikatora URI

Parametr URI Opis
restype=service&comp=properties Wymagane. W celu ustawienia właściwości usługi magazynu wymagane jest połączenie obu ciągów zapytań.
timeout Opcjonalny. timeoutParametr jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi BLOB Service.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania Opis
Authorization Wymagane. Określa schemat autoryzacji, nazwę konta magazynu i podpis. Aby uzyskać więcej informacji, zobacz Autoryzuj żądania do usługi Azure Storage.
Date lub x-ms-date Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzuj żądania do usługi Azure Storage.
x-ms-version Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji, która ma być używana dla tego żądania. Aby uzyskać więcej informacji, zobacz przechowywanie wersji usług Azure Storage.
x-ms-client-request-id Opcjonalny. Zapewnia wygenerowaną przez klienta wartość nieprzezroczystą z 1 KiB limit znaków, który jest rejestrowany w dziennikach analizy po włączeniu rejestrowania analizy magazynu. Używanie tego nagłówka jest wysoce zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz Informacje o rejestrowaniu analityka magazynu i rejestrowaniu na platformie Azure: używanie dzienników do śledzenia żądań magazynu.

Treść żądania

W przypadku wersji 2012-02-12 i wcześniejszej format treści żądania jest następujący:

<?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 the Blob service and the request must be made using version 2011-08-18 or later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>  

W przypadku wersji 2013-08-15 i nowszych format treści żądania jest następujący:

<?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 the Blob service and the request must be made using version 2011-08-18 or later -->  
    <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion>  
</StorageServiceProperties>  

W przypadku wersji 2017-07-29 i nowszych format treści żądania jest następujący:

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

W przypadku wersji 2018-03-28 lub nowszej format treści żądania jest następujący:

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

W przypadku wersji 2019-12-12 lub nowszej format treści żądania jest następujący:

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

Począwszy od wersji 2013-08-15, można wywołać Set Blob Service Properties z co najmniej jednym elementem głównym określonym w treści żądania. Elementy główne obejmują:

  • Rejestrowanie

  • HourMetrics

  • MinuteMetrics

  • Specyfikacji

  • DefaultServiceVersion

  • DeleteRetentionPolicy — wersja 2017-07-29 lub nowsza.

  • StaticWebsite — w wersji 2018-03-28 lub nowszej.

Nie trzeba już określać każdego elementu głównego w żądaniu. W przypadku pominięcia elementu głównego istniejące ustawienia usługi dla tej funkcji są zachowywane. Jednakże w przypadku określenia danego elementu głównego należy określić każdy element podrzędny dla tego elementu.

W poniższej tabeli opisano elementy treści żądania:

Nazwa elementu Opis
Rejestrowanie Opcjonalne począwszy od wersji 2013-08-15. Wymagane dla wcześniejszych wersji. Grupuje ustawienia rejestrowania usługi Azure Analytics.
Metryki Wymagane dla wersji 2012-02-12 i wcześniejszych. Nie dotyczy wersji 2013-08-15 lub nowszej. Grupuje ustawienia metryk usługi Azure Analytics. Ustawienia metryk zawierają podsumowanie statystyk żądań pogrupowanych według interfejsów API w postaci wartościowo zagregowanych obiektów BLOB.
HourMetrics Opcjonalne dla wersji 2013-08-15 lub nowszej; nie dotyczy wcześniejszych wersji. Grupuje ustawienia usługi Azure Analytics HourMetrics . Ustawienia HourMetrics zawierają podsumowanie statystyk żądań pogrupowanych według interfejsu API w co godzinę agregacji dla obiektów BLOB.
MinuteMetrics Opcjonalne dla wersji 2013-08-15 lub nowszej; nie dotyczy wcześniejszych wersji. Grupuje ustawienia usługi Azure Analytics MinuteMetrics . Ustawienia MinuteMetrics zapewniają dane statystyczne żądania dla każdej minuty dla obiektów BLOB. W przypadku wersji wcześniejszej niż 2013-08-15 MinuteMetrics nie jest uwzględniony w treści odpowiedzi.
Wersja Wymagane, jeśli określono ustawienia rejestrowania, metryk, HourMetrics lub MinuteMetrics . Wersja analityka magazynu do skonfigurowania.
Usuwanie Wymagane, jeśli określono ustawienia rejestrowania, metryk, HourMetrics lub MinuteMetrics . Dotyczy tylko konfiguracji rejestrowania. Wskazuje, czy wszystkie żądania usunięcia powinny być rejestrowane.
Odczyt Wymagane, jeśli określono ustawienia rejestrowania, metryk, HourMetrics lub MinuteMetrics . Dotyczy tylko konfiguracji rejestrowania. Wskazuje, czy wszystkie żądania odczytu powinny być rejestrowane.
Prawem Wymagane, jeśli określono ustawienia rejestrowania, metryk, HourMetrics lub MinuteMetrics . Dotyczy tylko konfiguracji rejestrowania. Wskazuje, czy wszystkie żądania zapisu powinny być rejestrowane.
Włączono Wymagane. Wskazuje, czy metryki są włączone dla Blob service.

Jeśli replikacja geograficznie nadmiarowa do odczytu jest włączona, zbierane są zarówno metryki podstawowe, jak i pomocnicze. Jeśli replikacja geograficznie nadmiarowa do odczytu nie jest włączona, zbierane są tylko podstawowe metryki.
IncludeAPIs Wymagane tylko wtedy, gdy są włączone metryki. Dotyczy tylko konfiguracji metryk. Wskazuje, czy metryki powinny generować statystyki podsumowujące dla wywołanych operacji interfejsu API.
RetentionPolicy/włączony Wymagane. Wskazuje, czy zasady przechowywania są włączone dla usługi magazynu.
RetentionPolicy/dni Wymagane tylko w przypadku włączenia zasad przechowywania. Wskazuje liczbę dni zachowywania metryk lub danych rejestrowania. Wszystkie dane starsze niż ta wartość zostaną usunięte. Minimalna wartość, którą można określić, to 1 365 (jeden rok).
RetentionPolicy/AllowPermanentDelete Opcjonalne, wersja 2020-02-10 i nowsze. Umożliwia trwałe usuwanie konta magazynu. Wartość domyślna to false.
DefaultServiceVersion Opcjonalny. Aby ustawić DefaultServiceVersion, należy wywołać Set Blob Service Properties przy użyciu wersji 2011-08-18 lub nowszej. DefaultServiceVersion wskazuje domyślną wersję do użycia dla żądań wysyłanych do BLOB Service, jeśli nie określono wersji żądania przychodzącego. Możliwe wartości to wersja 2008-10-27 i wszystkie nowsze wersje. Aby uzyskać więcej informacji na temat odpowiednich wersji, zobacz przechowywanie wersji usług Azure Storage.

Dotyczy tylko Blob service.
Specyfikacji Opcjonalny. Element CORS jest obsługiwany w wersji 2013-08-15 lub nowszej. Grupuje wszystkie reguły CORS.

Pominięcie tej grupy elementów nie spowoduje zastąpienia istniejących ustawień specyfikacji CORS.
CorsRule Opcjonalny. Określa regułę CORS dla Blob service. W żądaniu możesz uwzględnić maksymalnie pięć elementów CorsRule . Jeśli treść żądania nie zawiera żadnych elementów CorsRule , zostaną usunięte wszystkie reguły CORS, a mechanizm CORS zostanie wyłączony dla BLOB Service.
AllowedOrigins Wymagane, jeśli element CorsRule jest obecny. Rozdzielana przecinkami lista domen pochodzenia, które będą dozwolone za pośrednictwem mechanizmu CORS, lub "*", aby zezwolić na wszystkie domeny. Ograniczone do domen pochodzenia 64. Każdy dozwolony punkt początkowy może mieć do 256 znaków.
ExposedHeaders Wymagane, jeśli element CorsRule jest obecny. Rozdzielana przecinkami lista nagłówków odpowiedzi do udostępnienia klientom CORS. Ograniczone do 64 zdefiniowanych nagłówków i dwóch nagłówków z prefiksem. Każdy nagłówek może składać się z maksymalnie 256 znaków.
Atrybut maxageinseconds Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, przez jaką klient/przeglądarka powinna buforować odpowiedź na czas wstępny.
AllowedHeaders Wymagane, jeśli istnieje element CorsRule . Rozdzielana przecinkami lista nagłówków, które mogą być częścią żądania między źródłami. Ograniczone do 64 zdefiniowanych nagłówków i 2 nagłówki z prefiksami. Każdy nagłówek może składać się z maksymalnie 256 znaków.
Atrybut AllowedMethods Wymagane, jeśli istnieje element CorsRule . Rozdzielana przecinkami lista metod HTTP, które mogą być wykonywane przez źródło. W przypadku usługi Azure Storage dozwolone metody to DELETE, GET, głowy, MERGE, PATCH, POST, OPTIONS i PUT.
DeleteRetentionPolicy Opcjonalny. Aby ustawić DeleteRetentionPolicy, należy wywołać Set Blob Service Properties przy użyciu wersji 2017-07-29 lub nowszej. Grupuje ustawienia usuwania nietrwałego. Dotyczy tylko Blob service.
DeleteRetentionPolicy/włączony Wymagane. Wskazuje, czy usunięty obiekt BLOB lub migawka jest zachowywana, czy natychmiast usuwana przez operację usuwania.
DeleteRetentionPolicy/dni Wymagane tylko wtedy, gdy DeleteRetentionPolicy/Enabled ma wartość true. Wskazuje liczbę dni zachowywania usuniętego obiektu BLOB. Wszystkie dane starsze niż ta wartość zostaną trwale usunięte. Minimalna wartość, którą można określić, to 1 ; największa wartość to 365 .
StaticWebsite Opcjonalny. Aby ustawić właściwości StaticWebsite , należy wywołać Set Blob Service Properties przy użyciu wersji 2018-03-28 lub nowszej. Dotyczy tylko Blob service.
StaticWebsite/włączony Wymagane. Wskazuje, czy dla danego konta jest włączona obsługa statycznej witryny internetowej.
StaticWebsite/IndexDocument Opcjonalny. Strona sieci Web, w której usługa Azure Storage obsługuje żądania kierowane do katalogu głównego witryny internetowej lub dowolnego podfolderu. Na przykład index.html. W tej wartości jest rozróżniana wielkość liter.
StaticWebsite/DefaultIndexDocumentPath Opcjonalny. Ścieżka bezwzględna do strony sieci Web, która jest obsługiwana przez usługę Azure Storage dla żądań, które nie odpowiadają istniejącemu plikowi. Zawartość strony zostanie zwrócona z HTTP 200 OK . Na przykład index.html. Element wzajemnie się wykluczają StaticWebsite/IndexDocument . W tej wartości jest rozróżniana wielkość liter.
StaticWebsite/ErrorDocument404Path Opcjonalny. Ścieżka bezwzględna do strony sieci Web, która jest obsługiwana przez usługę Azure Storage dla żądań, które nie odpowiadają istniejącemu plikowi. Zawartość strony zostanie zwrócona z HTTP 404 Not Found . Na przykład error/404.html. Każda statyczna witryna sieci Web obsługuje tylko jedną niestandardową stronę 404. W tej wartości jest rozróżniana wielkość liter.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Operacja powiodła się zwraca kod stanu 202 (zaakceptowany).

Nagłówki odpowiedzi

Odpowiedź dla tej operacji obejmuje następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi Opis
x-ms-request-id Wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi.
x-ms-version Określa wersję operacji używanej w odpowiedzi. Aby uzyskać więcej informacji, zobacz przechowywanie wersji usług Azure Storage.
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadających im odpowiedzi. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli jest obecna w żądaniu, a wartość to co najwyżej 1024 widocznych znaków ASCII. Jeśli x-ms-client-request-id nagłówek nie występuje w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

Brak.

Authorization

Tylko właściciel konta może wywoływać tę operację.

Uwagi

Poniższe ograniczenia i ograniczenia dotyczą reguł CORS w usłudze Azure Storage:

  • Można przechowywać maksymalnie pięć reguł.

  • Maksymalny rozmiar wszystkich ustawień reguł CORS w żądaniu, z wyłączeniem tagów XML, nie powinien przekraczać 2 KiB.

  • Długość dozwolonego nagłówka, uwidocznionego nagłówka lub dozwolonego źródła nie powinna przekraczać 256 znaków.

  • Dozwolone nagłówki i uwidocznione nagłówki mogą być następujące:

    • Nagłówki literałów, w których podano dokładną nazwę nagłówka, taką jak x-MS-meta-przetworzony. W żądaniu można określić maksymalnie 64 nagłówków literałów.

    • Wstępnie ustalone nagłówki, w których podano prefiks nagłówka, taki jak *x-MS-meta-data * _. Określenie prefiksu w ten sposób umożliwia lub uwidacznia każdy nagłówek zaczynający się od danego prefiksu. W żądaniu można określić maksymalnie dwa nagłówki z prefiksami.

  • Metody (lub czasowniki HTTP) określone w elemencie _ atrybut AllowedMethods* muszą być zgodne z metodami obsługiwanymi przez interfejsy API usługi Azure Storage. Obsługiwane metody to DELETE, GET, głowy, MERGE, PATCH, POST, OPTIONS i PUT.

Określanie reguł CORS w żądaniu jest opcjonalne. W przypadku wywołania Set Blob Service Properties bez określenia elementu CORS w treści żądania są zachowywane wszystkie istniejące reguły CORS.

Aby wyłączyć mechanizm CORS, należy wywołać Set Blob Service Properties puste Ustawienia reguł CORS (tj. </Cors> ) i bez wewnętrznych reguł CORS. To wywołanie usuwa wszystkie istniejące reguły, uniemożliwiając wyłączenie mechanizmu CORS dla Blob service.

W przypadku określenia elementu CorsRule są wymagane wszystkie elementy reguł CORS. Żądanie zakończy się niepowodzeniem z kodem błędu 400 ( Bad Request ), jeśli brakuje żadnego elementu.

Począwszy od wersji 2013-08-15, elementy ustawień XML będą opcjonalne, w związku z czym Aktualizacja określonego elementu może zostać wykonana przez wysłanie pliku XML, który zawiera tylko zaktualizowany element, a inne ustawienia nie zostaną naruszone.

Aby uzyskać szczegółowe informacje na temat reguł CORS i logiki oceny, zobacz Obsługa mechanizmu CORS dla usług magazynu.

Przykładowe żądanie i odpowiedź

Następujący przykładowy identyfikator URI wykonuje żądanie zmiany właściwości Blob service fikcyjnego konta magazynu o nazwie Moje konto:

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

Żądanie jest wysyłane z następującymi nagłówkami:

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  

Żądanie jest wysyłane z następującą treścią 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 wysłaniu żądania zostanie zwrócona następująca odpowiedź:

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
  

Zobacz też

Ulepszone nagłówki HTTP na potrzeby wznawiania przy pobieraniu i zmiana w warunkach If-Match
analityka magazynu
Obsługa mechanizmu CORS dla usług magazynu
Specyfikacja protokołu HTTP CORS