Blob Services - Set Service Properties
Устанавливает свойства сервиса Blob аккаунта хранения, включая свойства для Storage Analytics и правил CORS (Cross-Origin Resource Sharing).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2026-04-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя регистронезависимо. |
|
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID). |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| properties.automaticSnapshotPolicyEnabled |
boolean |
Не рекомендуется использовать свойство isVersioningEnabled. |
| properties.changeFeed |
Свойства службы BLOB-объектов для событий канала изменений. |
|
| properties.containerDeleteRetentionPolicy |
Свойства службы BLOB-объектов для обратимого удаления контейнера. |
|
| properties.cors |
Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion указывает версию по умолчанию, используемую для запросов к службе BLOB-объектов, если версия входящего запроса не указана. Возможные значения включают версию 2008-10-27 и все более последние версии. |
| properties.deleteRetentionPolicy |
Свойства службы BLOB-объектов для обратимого удаления BLOB-объектов. |
|
| properties.isVersioningEnabled |
boolean |
Управление версиями включено, если задано значение true. |
| properties.lastAccessTimeTrackingPolicy |
Свойство службы BLOB-объектов для настройки политики отслеживания на основе времени последнего доступа. |
|
| properties.restorePolicy |
Свойства службы BLOB-объектов для политики восстановления BLOB-объектов. |
|
| properties.staticWebsite |
Статические свойства сайта для хранения blob. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Операция обновления ресурса 'BlobServiceProperties' была успешна |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
|
Blob |
|
Blob |
|
Put |
BlobServicesPutAllowPermanentDelete
Образец запроса
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2026-04-01
{
"properties": {
"deleteRetentionPolicy": {
"allowPermanentDelete": true,
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
Пример ответа
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"deleteRetentionPolicy": {
"allowPermanentDelete": true,
"days": 300,
"enabled": true
},
"isVersioningEnabled": true
}
}
BlobServicesPutLastAccessTimeBasedTracking
Образец запроса
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2026-04-01
{
"properties": {
"lastAccessTimeTrackingPolicy": {
"name": "AccessTimeTracking",
"blobType": [
"blockBlob"
],
"enable": true,
"trackingGranularityInDays": 1
}
}
}
Пример ответа
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"lastAccessTimeTrackingPolicy": {
"name": "AccessTimeTracking",
"blobType": [
"blockBlob"
],
"enable": true,
"trackingGranularityInDays": 1
}
}
}
PutBlobServices
Образец запроса
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2026-04-01
{
"properties": {
"changeFeed": {
"enabled": true,
"retentionInDays": 7
},
"cors": {
"corsRules": [
{
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"exposedHeaders": [
"x-ms-meta-*"
],
"maxAgeInSeconds": 100
},
{
"allowedHeaders": [
"*"
],
"allowedMethods": [
"GET"
],
"allowedOrigins": [
"*"
],
"exposedHeaders": [
"*"
],
"maxAgeInSeconds": 2
},
{
"allowedHeaders": [
"x-ms-meta-12345675754564*"
],
"allowedMethods": [
"GET",
"PUT"
],
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"maxAgeInSeconds": 2000
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"days": 300,
"enabled": true
},
"isVersioningEnabled": true,
"staticWebsite": {
"enabled": true,
"indexDocument": "home.html",
"errorDocument404Path": "site/errors/not-found.html"
}
}
}
Пример ответа
{
"name": "default",
"type": "Microsoft.Storage/storageAccounts/blobServices",
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
"properties": {
"changeFeed": {
"enabled": true,
"retentionInDays": 7
},
"cors": {
"corsRules": [
{
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"exposedHeaders": [
"x-ms-meta-*"
],
"maxAgeInSeconds": 100
},
{
"allowedHeaders": [
"*"
],
"allowedMethods": [
"GET"
],
"allowedOrigins": [
"*"
],
"exposedHeaders": [
"*"
],
"maxAgeInSeconds": 2
},
{
"allowedHeaders": [
"x-ms-meta-12345675754564*"
],
"allowedMethods": [
"GET",
"PUT"
],
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x -ms-meta-target*"
],
"maxAgeInSeconds": 2000
}
]
},
"defaultServiceVersion": "2017-07-29",
"deleteRetentionPolicy": {
"days": 300,
"enabled": true
},
"isVersioningEnabled": true,
"staticWebsite": {
"enabled": true,
"indexDocument": "home.html",
"errorDocument404Path": "site/errors/not-found.html"
}
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
Определения
| Имя | Описание |
|---|---|
|
Allowed |
|
|
Blob |
Свойства службы BLOB-объектов учетной записи хранения. |
|
Change |
Свойства службы BLOB-объектов для событий канала изменений. |
|
Cors |
Задает правило CORS для службы BLOB-объектов. |
|
Cors |
Задает правила CORS. В запрос можно включить до пяти элементов CorsRule. |
|
created |
Тип удостоверения, создавшего ресурс. |
|
Delete |
Свойства службы для обратимого удаления. |
|
Error |
Ответ на ошибку от поставщика ресурсов хранилища. |
|
Error |
Контракт текста ответа на ошибку. |
|
Last |
Свойства службы BLOB-объектов для политики отслеживания на основе времени последнего доступа. |
| Name |
Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения |
|
Restore |
Свойства службы BLOB-объектов для политики восстановления BLOB-объектов |
| Sku |
Номер SKU учетной записи хранения. |
|
Sku |
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType. |
|
Sku |
Уровень SKU. Это основано на имени SKU. |
|
Static |
Статические свойства сайта для хранения blob. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
AllowedMethods
| Значение | Описание |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
BlobServiceProperties
Свойства службы BLOB-объектов учетной записи хранения.
| Имя | Тип | Описание |
|---|---|---|
| id |
string (arm-id) |
Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Имя ресурса |
| properties.automaticSnapshotPolicyEnabled |
boolean |
Не рекомендуется использовать свойство isVersioningEnabled. |
| properties.changeFeed |
Свойства службы BLOB-объектов для событий канала изменений. |
|
| properties.containerDeleteRetentionPolicy |
Свойства службы BLOB-объектов для обратимого удаления контейнера. |
|
| properties.cors |
Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion указывает версию по умолчанию, используемую для запросов к службе BLOB-объектов, если версия входящего запроса не указана. Возможные значения включают версию 2008-10-27 и все более последние версии. |
| properties.deleteRetentionPolicy |
Свойства службы BLOB-объектов для обратимого удаления BLOB-объектов. |
|
| properties.isVersioningEnabled |
boolean |
Управление версиями включено, если задано значение true. |
| properties.lastAccessTimeTrackingPolicy |
Свойство службы BLOB-объектов для настройки политики отслеживания на основе времени последнего доступа. |
|
| properties.restorePolicy |
Свойства службы BLOB-объектов для политики восстановления BLOB-объектов. |
|
| properties.staticWebsite |
Статические свойства сайта для хранения blob. |
|
| sku |
Имя и уровень артикула. |
|
| systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
| type |
string |
Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения» |
ChangeFeed
Свойства службы BLOB-объектов для событий канала изменений.
| Имя | Тип | Описание |
|---|---|---|
| enabled |
boolean |
Указывает, включена ли ведение журнала событий канала изменений для службы BLOB-объектов. |
| retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Указывает длительность хранения changeFeed в днях. Минимальное значение равно 1 день и максимальное значение — 146000 дней (400 лет). Значение NULL означает бесконечное хранение канала изменений. |
CorsRule
Задает правило CORS для службы BLOB-объектов.
| Имя | Тип | Описание |
|---|---|---|
| allowedHeaders |
string[] |
Требуется, если элемент CorsRule присутствует. Список заголовков, которым разрешено быть частью запроса между источниками. |
| allowedMethods |
Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником. |
|
| allowedOrigins |
string[] |
Требуется, если элемент CorsRule присутствует. Список доменов происхождения, которые будут разрешены через CORS или *, чтобы разрешить все домены |
| exposedHeaders |
string[] |
Требуется, если элемент CorsRule присутствует. Список заголовков ответов для предоставления клиентам CORS. |
| maxAgeInSeconds |
integer (int32) |
Требуется, если элемент CorsRule присутствует. Количество секунд, в течение которых клиент или браузер должен кэшировать предварительный ответ. |
CorsRules
Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.
| Имя | Тип | Описание |
|---|---|---|
| corsRules |
Cors |
Список правил CORS. В запрос можно включить до пяти элементов CorsRule. |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DeleteRetentionPolicy
Свойства службы для обратимого удаления.
| Имя | Тип | Описание |
|---|---|---|
| allowPermanentDelete |
boolean |
Это свойство, если задано значение true, разрешает удаление обратимо удаленных версий и моментальных снимков больших двоичных объектов. Это свойство нельзя использовать политику восстановления BLOB-объектов. Это свойство применяется только к службе BLOB-объектов и не применяется к контейнерам или общей папке. |
| days |
integer (int32) minimum: 1maximum: 365 |
Указывает количество дней хранения удаленного элемента. Минимальное указанное значение может иметь значение 1, а максимальное значение — 365. |
| enabled |
boolean |
Указывает, включена ли функция DeleteRetentionPolicy. |
ErrorResponse
Ответ на ошибку от поставщика ресурсов хранилища.
| Имя | Тип | Описание |
|---|---|---|
| error |
Azure Storage Resource Provider error response body. |
ErrorResponseBody
Контракт текста ответа на ошибку.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования. |
| message |
string |
Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе. |
LastAccessTimeTrackingPolicy
Свойства службы BLOB-объектов для политики отслеживания на основе времени последнего доступа.
| Имя | Тип | Описание |
|---|---|---|
| blobType |
string[] |
Массив предопределенных поддерживаемых типов BLOB-объектов. Только blockBlob является поддерживаемым значением. Это поле в настоящее время доступно только для чтения |
| enable |
boolean |
Если задано значение true для отслеживания на основе времени последнего доступа, включена функция отслеживания. |
| name |
Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения |
|
| trackingGranularityInDays |
integer (int32) |
Поле указывает детализацию отслеживания объектов BLOB-объектов в днях, как правило, частоту отслеживания объекта БОЛЬШОго двоичного объекта. Это поле в настоящее время считывается только со значением 1 |
Name
Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения
| Значение | Описание |
|---|---|
| AccessTimeTracking |
RestorePolicyProperties
Свойства службы BLOB-объектов для политики восстановления BLOB-объектов
| Имя | Тип | Описание |
|---|---|---|
| days |
integer (int32) minimum: 1maximum: 365 |
как долго этот большой двоичный объект можно восстановить. Оно должно быть больше нуля и меньше, чем DeleteRetentionPolicy.days. |
| enabled |
boolean |
Восстановление BLOB-объектов включено, если задано значение true. |
| lastEnabledTime |
string (date-time) |
Устарело в пользу свойства minRestoreTime. |
| minRestoreTime |
string (date-time) |
Возвращает минимальную дату и время, когда может быть начато восстановление. |
Sku
Номер SKU учетной записи хранения.
| Имя | Тип | Описание |
|---|---|---|
| name |
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType. |
|
| tier |
Уровень SKU. Это основано на имени SKU. |
SkuName
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.
| Значение | Описание |
|---|---|
| Standard_LRS | |
| Standard_GRS | |
| Standard_RAGRS | |
| Standard_ZRS | |
| Premium_LRS | |
| Premium_ZRS | |
| Standard_GZRS | |
| Standard_RAGZRS | |
| StandardV2_LRS | |
| StandardV2_GRS | |
| StandardV2_ZRS | |
| StandardV2_GZRS | |
| PremiumV2_LRS | |
| PremiumV2_ZRS |
SkuTier
Уровень SKU. Это основано на имени SKU.
| Значение | Описание |
|---|---|
| Standard | |
| Premium |
StaticWebsite
Статические свойства сайта для хранения blob.
| Имя | Тип | Описание |
|---|---|---|
| defaultIndexDocumentPath |
string |
Абсолютный путь, где находится стандартный индексный файл. Этот абсолютный путь взаимоисключает «indexDocument» и зависит от регистра. |
| enabled |
boolean |
Указывает, включена ли поддержка статического сайта для указанной учётной записи. |
| errorDocument404Path |
string |
Абсолютный путь к веб-странице, который Azure Storage обслуживает для запросов, не соответствующих существующему файлу. Содержимое страницы возвращается с HTTP 404 Not Found. В каждом статическом сайте поддерживается только одна пользовательская страница 404. |
| indexDocument |
string |
Веб-страница, которая Azure Storage служит запросами к корню сайта или любой подпапке (например, index.html). Значение чувствительно к регистру. |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |