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

Имя В Обязательно Тип Описание
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя регистронезависимо.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

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

Имя Тип Описание
properties.automaticSnapshotPolicyEnabled

boolean

Не рекомендуется использовать свойство isVersioningEnabled.

properties.changeFeed

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Свойства службы BLOB-объектов для обратимого удаления контейнера.

properties.cors

CorsRules

Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов.

properties.defaultServiceVersion

string

DefaultServiceVersion указывает версию по умолчанию, используемую для запросов к службе BLOB-объектов, если версия входящего запроса не указана. Возможные значения включают версию 2008-10-27 и все более последние версии.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

Свойства службы BLOB-объектов для обратимого удаления BLOB-объектов.

properties.isVersioningEnabled

boolean

Управление версиями включено, если задано значение true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

Свойство службы BLOB-объектов для настройки политики отслеживания на основе времени последнего доступа.

properties.restorePolicy

RestorePolicyProperties

Свойства службы BLOB-объектов для политики восстановления BLOB-объектов.

properties.staticWebsite

StaticWebsite

Статические свойства сайта для хранения blob.

Ответы

Имя Тип Описание
200 OK

BlobServiceProperties

Операция обновления ресурса 'BlobServiceProperties' была успешна

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

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"
  }
}

Определения

Имя Описание
AllowedMethods
BlobServiceProperties

Свойства службы BLOB-объектов учетной записи хранения.

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

CorsRule

Задает правило CORS для службы BLOB-объектов.

CorsRules

Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.

createdByType

Тип удостоверения, создавшего ресурс.

DeleteRetentionPolicy

Свойства службы для обратимого удаления.

ErrorResponse

Ответ на ошибку от поставщика ресурсов хранилища.

ErrorResponseBody

Контракт текста ответа на ошибку.

LastAccessTimeTrackingPolicy

Свойства службы BLOB-объектов для политики отслеживания на основе времени последнего доступа.

Name

Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения

RestorePolicyProperties

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

Sku

Номер SKU учетной записи хранения.

SkuName

Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.

SkuTier

Уровень SKU. Это основано на имени SKU.

StaticWebsite

Статические свойства сайта для хранения blob.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

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

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Свойства службы BLOB-объектов для обратимого удаления контейнера.

properties.cors

CorsRules

Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов.

properties.defaultServiceVersion

string

DefaultServiceVersion указывает версию по умолчанию, используемую для запросов к службе BLOB-объектов, если версия входящего запроса не указана. Возможные значения включают версию 2008-10-27 и все более последние версии.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

Свойства службы BLOB-объектов для обратимого удаления BLOB-объектов.

properties.isVersioningEnabled

boolean

Управление версиями включено, если задано значение true.

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

Свойство службы BLOB-объектов для настройки политики отслеживания на основе времени последнего доступа.

properties.restorePolicy

RestorePolicyProperties

Свойства службы BLOB-объектов для политики восстановления BLOB-объектов.

properties.staticWebsite

StaticWebsite

Статические свойства сайта для хранения blob.

sku

Sku

Имя и уровень артикула.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

type

string

Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения»

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

Имя Тип Описание
enabled

boolean

Указывает, включена ли ведение журнала событий канала изменений для службы BLOB-объектов.

retentionInDays

integer (int32)

minimum: 1
maximum: 146000

Указывает длительность хранения changeFeed в днях. Минимальное значение равно 1 день и максимальное значение — 146000 дней (400 лет). Значение NULL означает бесконечное хранение канала изменений.

CorsRule

Задает правило CORS для службы BLOB-объектов.

Имя Тип Описание
allowedHeaders

string[]

Требуется, если элемент CorsRule присутствует. Список заголовков, которым разрешено быть частью запроса между источниками.

allowedMethods

AllowedMethods[]

Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.

allowedOrigins

string[]

Требуется, если элемент CorsRule присутствует. Список доменов происхождения, которые будут разрешены через CORS или *, чтобы разрешить все домены

exposedHeaders

string[]

Требуется, если элемент CorsRule присутствует. Список заголовков ответов для предоставления клиентам CORS.

maxAgeInSeconds

integer (int32)

Требуется, если элемент CorsRule присутствует. Количество секунд, в течение которых клиент или браузер должен кэшировать предварительный ответ.

CorsRules

Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.

Имя Тип Описание
corsRules

CorsRule[]

Список правил CORS. В запрос можно включить до пяти элементов CorsRule.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

DeleteRetentionPolicy

Свойства службы для обратимого удаления.

Имя Тип Описание
allowPermanentDelete

boolean

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

days

integer (int32)

minimum: 1
maximum: 365

Указывает количество дней хранения удаленного элемента. Минимальное указанное значение может иметь значение 1, а максимальное значение — 365.

enabled

boolean

Указывает, включена ли функция DeleteRetentionPolicy.

ErrorResponse

Ответ на ошибку от поставщика ресурсов хранилища.

Имя Тип Описание
error

ErrorResponseBody

Azure Storage Resource Provider error response body.

ErrorResponseBody

Контракт текста ответа на ошибку.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.

message

string

Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.

LastAccessTimeTrackingPolicy

Свойства службы BLOB-объектов для политики отслеживания на основе времени последнего доступа.

Имя Тип Описание
blobType

string[]

Массив предопределенных поддерживаемых типов BLOB-объектов. Только blockBlob является поддерживаемым значением. Это поле в настоящее время доступно только для чтения

enable

boolean

Если задано значение true для отслеживания на основе времени последнего доступа, включена функция отслеживания.

name

Name

Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения

trackingGranularityInDays

integer (int32)

Поле указывает детализацию отслеживания объектов BLOB-объектов в днях, как правило, частоту отслеживания объекта БОЛЬШОго двоичного объекта. Это поле в настоящее время считывается только со значением 1

Name

Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения

Значение Описание
AccessTimeTracking

RestorePolicyProperties

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

Имя Тип Описание
days

integer (int32)

minimum: 1
maximum: 365

как долго этот большой двоичный объект можно восстановить. Оно должно быть больше нуля и меньше, чем DeleteRetentionPolicy.days.

enabled

boolean

Восстановление BLOB-объектов включено, если задано значение true.

lastEnabledTime

string (date-time)

Устарело в пользу свойства minRestoreTime.

minRestoreTime

string (date-time)

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

Sku

Номер SKU учетной записи хранения.

Имя Тип Описание
name

SkuName

Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.

tier

SkuTier

Уровень 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

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.