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

Операция 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 в почасовых статистических выражениях для BLOB-объектов.
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 операцию, как описано ниже.

Важно!

Корпорация Майкрософт рекомендует использовать Microsoft Entra ID с управляемыми удостоверениями для авторизации запросов к службе хранилища Azure. Microsoft Entra ID обеспечивает более высокий уровень безопасности и простоту использования по сравнению с авторизацией с общим ключом.

Microsoft Entra ID (рекомендуется)

Служба хранилища 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)

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

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

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

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

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

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

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

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

Общий ключ

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

Комментарии

К правилам CORS в хранилище Azure применяются следующие ограничения.

• Можно сохранить не более 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