Задание свойств службы BLOB-объектов

Статья
03/16/2023

Операция Set Blob Service Properties задает свойства конечной точки хранилища BLOB-объектов учетной записи хранения, включая свойства для Аналитика Службы хранилища, правил общего доступа к ресурсам независимо от источника (CORS) и параметров обратимого удаления.

Вы также можете использовать эту операцию, чтобы задать версию запроса по умолчанию для всех входящих запросов к хранилищу BLOB-объектов без указанной версии.

Дополнительные сведения о правилах CORS см. в статье Поддержка CORS для служб хранилища Azure.

Запрос

Запрос Set Blob Service Properties можно указать следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS. Замените account-name именем своей учетной записи хранения:

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
PUT	`https://account-name.blob.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Примечание

Универсальный код ресурса (URI) всегда должен содержать символ косой черты (/), чтобы отделить имя узла от частей пути и запроса URI. В этой операции часть пути URI пуста.

Параметры универсального кода ресурса (URI)

Параметр URI	Описание
`restype=service&comp=properties`	Обязательный. Сочетание обеих строк запроса обязательно для задания свойств службы хранилища.
`timeout`	Необязательный элемент. Параметр `timeout` указывается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания для операций с хранилищем BLOB-объектов.

Заголовки запросов

Обязательные и необязательные заголовки запросов описаны в следующей таблице:

Заголовок запроса	Описание
`Authorization`	Обязательный. Указывает схему авторизации, имя учетной записи хранения и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`Date` или `x-ms-date`	Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
`x-ms-version`	Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
`x-ms-client-request-id`	Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure.

Текст запроса

Текст запроса для версии 2012-02-12 и более ранних имеет следующий формат:

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

Текст запроса для версии 2013-08-15 и более поздних имеет следующий формат:

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

Для версии 2017-07-29 и более поздних формат текста запроса выглядит следующим образом:

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

Для версии 2018-03-28 и более поздних формат текста запроса выглядит следующим образом:

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

Для версии 2019-12-12 и более поздних формат текста запроса выглядит следующим образом:

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

Начиная с версии 2013-08-15, можно вызывать Set Blob Service Properties с одним или несколькими корневыми элементами, указанными в тексте запроса. Корневые элементы включают:

Logging
HourMetrics
MinuteMetrics
Cors
DefaultServiceVersion
DeleteRetentionPolicy: версия 29.07.2017 и более поздние версии.
StaticWebsite: версия 28.03.2018 и более поздние версии

Больше не нужно указывать каждый корневой элемент в запросе. Если корневой элемент не указан, то сохраняются существующие параметры службы для этой функции. Однако при указании корневого элемента необходимо указать каждый дочерний элемент для этого элемента.

В следующей таблице описываются элементы текста запроса.

Имя элемента	Описание
Logging	Необязательный с версии 2013-08-15. В предыдущих версиях обязателен. Группирует параметры аналитики Azure Logging.
Метрики	В версии 2012-02-12 и более ранних обязателен. Неприменимо для версии 2013-08-15 и более поздних версий. Группирует параметры метрик Azure Analytics, которые предоставляют сводку статистики запросов, сгруппированных по API, в почасовых статистических выражениях для больших двоичных объектов.
HourMetrics	Необязательно для версии 2013-08-15 и более поздних версий; неприменимо для более ранних версий. Группирует параметры Azure Analytics HourMetrics , которые предоставляют сводку статистики запросов, сгруппированных по API, в почасовых статистических выражениях для больших двоичных объектов.
MinuteMetrics	Необязательно для версии 2013-08-15 и более поздних версий; неприменимо для более ранних версий. Группирует параметры Azure Analytics MinuteMetrics , которые предоставляют статистику запросов за каждую минуту для BLOB-объектов. Для версий, предшествующих 2013-08-15, MinuteMetrics не включается в текст ответа.
Версия	Требуется, если указаны параметры Ведение журнала, Метрики, HourMetrics или MinuteMetrics . Настраиваемая версия аналитики хранилища.
Удалить	Требуется, если указаны параметры Ведение журнала, Метрики, HourMetrics или MinuteMetrics . Применяется только к настройке ведения журнала. Указывает, следует ли вносить в журнал все запросы удаления.
Чтение	Требуется, если указаны параметры Ведение журнала, Метрики, HourMetrics или MinuteMetrics . Применяется только к настройке ведения журнала. Указывает, следует ли вносить в журнал все запросы чтения.
запись	Требуется, если указаны параметры Ведение журнала, Метрики, HourMetrics или MinuteMetrics . Применяется только к настройке ведения журнала. Указывает, следует ли вносить в журнал все запросы записи.
Enabled	Обязательный. Указывает, включены ли метрики для хранилища BLOB-объектов. Если географически избыточная репликация с доступом для чтения включена, то будет вестись сбор как первичных, так и вторичных показателей. Если геоизбыточная репликация с доступом на чтение не включена, собираются только основные метрики.
IncludeAPIs	Обязателен, только если показатели включены. Применяется только к настройкам метрики. Указывает, должна ли метрика создавать сводную статистику для вызываемых операций API.
RetentionPolicy/Enabled	Обязательный. Указывает, включена ли политика сохранения для службы хранилища.
RetentionPolicy/Days	Обязательно, если политика сохранения включена. Указывает число дней, в течение которых данные метрики или журнала должны сохраняться. Удаляются все данные, которые старше этого значения. Минимальное значение - `1`; наибольшее значение - `365` (один год).
RetentionPolicy/AllowPermanentDelete	Необязательно, версия 2020-02-10 и более поздние. Позволяет включить окончательное удаление в учетной записи хранения. Значение по умолчанию — `false.`
DefaultServiceVersion	Необязательный элемент. Чтобы задать DefaultServiceVersion, вызовите `Set Blob Service Properties` с помощью версии 2011-08-18 и более поздних. DefaultServiceVersion указывает версию по умолчанию, используемую для запросов к Хранилищу BLOB-объектов, если версия входящего запроса не указана. Возможные значения: версия 2008-10-27 и более поздние. Дополнительные сведения о применимых версиях см. в статье Управление версиями для служб хранилища Azure. Применяется только к хранилищу BLOB-объектов.
Cors	Необязательный элемент. Элемент Cors поддерживается для версии 2013-08-15 и более поздних версий. Группирует все правила CORS. Пропуск этой группы элементов не приводит к перезаписи существующих параметров CORS.
элемент	Необязательный элемент. Задает правило CORS для хранилища BLOB-объектов. В запрос можно включить до пяти элементов CorsRule . Если в текст запроса не включены элементы CorsRule , все правила CORS удаляются, а cors отключен для хранилища BLOB-объектов.
AllowedOrigins	Требуется при наличии элемента CorsRule . Разделенный запятыми список доменов источника, которые разрешены через CORS или "*", чтобы разрешить все домены. Домен источника также может содержать подстановочный знак в поддомене, чтобы разрешить запросы через CORS для всех поддоменов домена. Ограничен 64 доменами источников. Каждый разрешенный источник может содержать до 256 символов.
ExposedHeaders	Требуется при наличии элемента CorsRule . Список заголовков ответов с разделителями-запятыми для предоставления клиентам CORS. Ограничен 64 определенными заголовками и 2 заголовками с префиксами. Каждый заголовок может содержать до 256 символов.
MaxAgeInSeconds	Требуется при наличии элемента CorsRule . Число секунд, в течение которых клиент или браузер должен кэшировать предполетный ответ.
AllowedHeaders	Требуется, если элемент CorsRule существует. Список допустимых заголовков с разделителями-запятыми, которые должны быть частью запроса общего доступа. Ограничен 64 определенными заголовками и 2 заголовками с префиксами. Каждый заголовок может содержать до 256 символов.
AllowedMethods	Требуется, если элемент CorsRule существует. Список методов HTTP с разделителями-запятыми, которые разрешено выполнять источником. Для службы хранилища Azure разрешенные методы: DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS и PUT.
DeleteRetentionPolicy	Необязательный элемент. Чтобы задать параметр DeleteRetentionPolicy, вызовите `Set Blob Service Properties` с помощью версии 2017-07-29 и более поздних. Группирует параметры обратимого удаления. Применяется только к хранилищу BLOB-объектов.
DeleteRetentionPolicy/Enabled	Обязательный. Указывает, сохраняется ли удаленный большой двоичный объект или snapshot в результате операции удаления.
DeleteRetentionPolicy/Days	Требуется, только если параметр DeleteRetentionPolicy/Enabled имеет значение true. Указывает количество дней хранения удаленного BLOB-объекта. Все данные, которые старше этого значения, удаляются без возможности восстановления. Минимальное значение, которое можно указать, — ; `1`наибольшее значение — `365`.
StaticWebsite	Необязательный элемент. Чтобы задать свойства StaticWebsite , вызовите `Set Blob Service Properties` с помощью версии 2018-03-28 и более поздних. Применяется только к хранилищу BLOB-объектов.
StaticWebsite/Enabled	Обязательный. Указывает, включена ли поддержка статического веб-сайта для указанной учетной записи.
StaticWebsite/IndexDocument	Необязательный элемент. Веб-страница, которую служба хранилища Azure обслуживает для запросов к корню веб-сайта или любой вложенной папке (например, `index.html`). Для этого значения учитывается регистр.
StaticWebsite/DefaultIndexDocumentPath	Необязательный элемент. Абсолютный путь к веб-странице, которую служба хранилища Azure обслуживает для запросов, которые не соответствуют существующему файлу. Содержимое страницы возвращается с `HTTP 200 OK` помощью (например, `index.html`). Элемент является взаимоисключающим с `StaticWebsite/IndexDocument`. Для этого значения учитывается регистр.
StaticWebsite/ErrorDocument404Path	Необязательный элемент. Абсолютный путь к веб-странице, которую служба хранилища Azure обслуживает для запросов, которые не соответствуют существующему файлу. Содержимое страницы возвращается с `HTTP 404 Not Found` помощью (например, `error/404.html`). На каждом статическом веб-сайте поддерживается только одна пользовательская страница 404. Для этого значения учитывается регистр.

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 202 (принято).

Заголовки ответов

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Заголовок ответа	Описание
`x-ms-request-id`	Уникально идентифицирует запрос к службе.
`x-ms-version`	Задает версию операции, используемой для ответа. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
`x-ms-client-request-id`	Может использоваться для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка `x-ms-client-request-id` , если он присутствует в запросе и содержит не более 1024 видимых символов ASCII. Если заголовок `x-ms-client-request-id` отсутствует в запросе, он не будет присутствовать в ответе.

Текст ответа

Нет.

Авторизация

Авторизация требуется при вызове любой операции доступа к данным в службе хранилища Azure. Вы можете авторизовать операцию, Set Blob Service Properties как описано ниже.

Служба хранилища Azure поддерживает использование Microsoft Entra ID для авторизации запросов к данным BLOB-объектов. С помощью Microsoft Entra ID можно использовать управление доступом на основе ролей Azure (Azure RBAC) для предоставления разрешений субъекту безопасности. Субъектом безопасности может быть пользователь, группа, субъект-служба приложения или управляемое удостоверение Azure. Субъект безопасности проходит проверку подлинности Microsoft Entra ID для возврата маркера OAuth 2.0. Затем маркер можно использовать для авторизации запроса к службе BLOB-объектов.

Дополнительные сведения об авторизации с помощью Microsoft Entra ID см. в статье Авторизация доступа к BLOB-объектам с помощью Microsoft Entra ID.

Разрешения

Ниже перечислены действия RBAC, необходимые Microsoft Entra пользователю, группе или субъекту-службе для вызова Set Blob Service Properties операции, а также встроенная роль Azure RBAC с минимальными привилегиями, которая включает это действие:

Действие Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/write
Встроенная роль с минимальными привилегиями:Участник учетной записи хранения

Дополнительные сведения о назначении ролей с помощью Azure RBAC см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Подписанный URL-адрес (SAS) обеспечивает безопасный делегированный доступ к ресурсам в учетной записи хранения. С помощью SAS вы можете детально контролировать доступ клиента к данным. Вы можете указать, к какому ресурсу может обращаться клиент, какие у него есть разрешения для этих ресурсов и как долго будет действителен SAS.

Операция Set Blob Service Properties поддерживает авторизацию с помощью SAS учетной записи.

Если доступ к общему ключу запрещен для учетной записи хранения, маркер SAS учетной записи не будет разрешен при запросе к хранилищу BLOB-объектов. Дополнительные сведения см. в статье Сведения о том, как запрет общего ключа влияет на маркеры SAS.

SAS для учетной записи

SAS для учетной записи защищен с помощью ключа учетной записи хранения. SAS учетной записи делегирует доступ к ресурсам в одной или нескольких службах хранилища. Все операции, доступные через SAS для службы или делегирования пользователей, также доступны через SAS для учетной записи.

В следующей таблице указаны подписанный тип ресурса и подписанные разрешения, которые необходимо указать при делегировании доступа:

Операция	Подписанная служба	Подписанный тип ресурса	Подписанное разрешение
Задание свойств службы BLOB-объектов	Большой двоичный объект (b)	Служба (ы)	Запись (w)

Дополнительные сведения о SAS учетной записи см. в статье Создание SAS учетной записи.

Операция Set Blob Service Properties поддерживает авторизацию с общим ключом. Авторизация с помощью ключей учетной записи не рекомендуется в большинстве сценариев, так как она менее безопасна. Корпорация Майкрософт рекомендует запретить авторизацию с общим ключом для учетной записи хранения, когда это возможно. Дополнительные сведения см. в статье Предотвращение авторизации с помощью общего ключа.

Можно сохранить не более 5 правил.
Максимальный размер всех параметров правил CORS в запросе, за исключением XML-тегов, не должен превышать 2 КиБ.
Длина разрешенного заголовка, представленного заголовка или разрешенного исходного домена не должна превышать 256 знаков.
Разрешенные и представленные заголовки могут быть следующими:
- Литеральные заголовки с точным именем заголовка, например x-ms-meta-processed. В запросе может быть указано до 64 литеральных заголовков.
- Заголовки с префиксом, где указан префикс заголовка, например x-ms-meta-data*. Указание префикса таким образом разрешает или предоставляет любой заголовок, начинающийся с указанного префикса. В запросе можно задать не более 2 заголовков с префиксами.
Методы (или HTTP-команды), указанные в элементе AllowedMethods , должны соответствовать методам, поддерживаемым API службы хранилища Azure. Поддерживаемые методы: DELETE, GET, HEAD, MERGE, PATCH, POST, OPTIONS и PUT.

Указание правил CORS в запросе не обязательно. При вызове Set Blob Service Properties без указания элемента Cors в тексте запроса будут поддерживаться все существующие правила CORS.

Чтобы отключить CORS, вызовите Set Blob Service Properties с пустым параметром правил CORS (т. е</Cors>. без внутренних правил CORS). Этот вызов удаляет все существующие правила и отключает CORS для хранилища BLOB-объектов.

Все элементы правила CORS являются обязательными, если указан элемент CorsRule . Если отсутствует какой-либо элемент, запрос завершается ошибкой с кодом 400 (Bad Request).

Начиная с версии 2013-08-15 элементы параметров XML являются необязательными, поэтому вы можете обновить определенный элемент, отправив XML-код, содержащий только обновленный элемент. Другие параметры не затрагиваются.

Подробные сведения о правилах CORS и логике оценки см. в статье Поддержка CORS для служб хранилища Azure.

Выставление счетов

Запросы на ценообразование могут поступать от клиентов, использующих API хранилища BLOB-объектов, напрямую через REST API хранилища BLOB-объектов или из клиентской библиотеки службы хранилища Azure. Эти запросы начисляют плату за транзакцию. Тип транзакции влияет на способ оплаты учетной записи. Например, транзакции чтения начисляются к категории выставления счетов, отличной от категории операций записи. В следующей таблице показана категория выставления счетов для Set Blob Service Properties запросов на основе типа учетной записи хранения.

Операция	Тип учетной записи хранения	Категория выставления счетов
Задание свойств службы BLOB-объектов	Блочный BLOB-объект (ценовая категории "Премиум") Общего назначения версии 2 (цен. категория "Стандартный")	Другие операции
Задание свойств службы BLOB-объектов	Стандартная общего назначения версии 1	Операции записи

Дополнительные сведения о ценах на указанную категорию выставления счетов см. в разделе Цены на Хранилище BLOB-объектов Azure.

Пример запроса и ответа

В следующем примере URI выполняется запрос на изменение свойств хранилища BLOB-объектов для вымышленной учетной записи хранения с именем myaccount:

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

Запрос отправляется со следующими заголовками:

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

Запрос отправляется со следующим текстом 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>

После отправки запроса возвращается следующий ответ:

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

См. также раздел

Аналитика службы хранилища
Поддержка CORS для служб хранилища Azure
Спецификация CORS HTTP