Blob Containers - Extend Immutability Policy

Служба:: Storage Resource Provider

Версия API:: 2025-08-01

Расширяет immutabilityPeriodSinceCreationInDays заблокированной immutabilityPolicy. Единственное действие, разрешенное для заблокированной политики, будет этим действием. ETag в If-Match требуется для этой операции.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default/containers/{containerName}/immutabilityPolicies/default/extend?api-version=2025-08-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы.
containerName	path	True	string minLength: 3 maxLength: 63	Имя контейнера BLOB-объектов в указанной учетной записи хранения. Имена контейнеров BLOB-объектов должны содержать от 3 до 63 символов и содержать только цифры, строчные буквы и тире (-). Каждому символу тире (-) должна предшествовать буква или цифра, а за ним должна стоять буква или цифра.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Обязательно	Тип	Описание
If-Match	True	string	Версия состояния сущности (ETag) политики неизменяемости для обновления должна быть возвращена на сервер для всех операций обновления. Значение ETag должно включать начальные и конечные двойные кавычки, возвращаемые сервисом.

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

Имя	Тип	Описание
properties.allowProtectedAppendWrites	boolean	Это свойство можно изменить только для разблокированных политик хранения на основе времени. При включении новые блоки можно записать в добавочный большой двоичный объект при сохранении неизменяемости защиты и соответствия требованиям. Можно добавить только новые блоки, и любые существующие блоки нельзя изменить или удалить. Это свойство нельзя изменить с помощью API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Это свойство можно изменить только для разблокированных политик хранения на основе времени. При включении новые блоки можно записать в "Добавление и Bock Blobs" при сохранении неизменяемости защиты и соответствия требованиям. Можно добавить только новые блоки, и любые существующие блоки нельзя изменить или удалить. Это свойство нельзя изменить с помощью API ExtendImmutabilityPolicy. Свойства allowProtectedAppendWrites и AllowProtectedAppendWritesAll являются взаимоисключающими.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Период неизменяемости больших двоичных объектов в контейнере с момента создания политики в днях.

Ответы

Имя	Тип	Описание
200 OK	ImmutabilityPolicy	Операция Azure успешно завершена. Заголовки ETag: string
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

ImmutabilityPolicy

Операция Azure успешно завершена.

Заголовки

ETag: string

Other Status Codes

ErrorResponse

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

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

ExtendImmutabilityPolicy

Образец запроса

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res6238/providers/Microsoft.Storage/storageAccounts/sto232/blobServices/default/containers/container5023/immutabilityPolicies/default/extend?api-version=2025-08-01


{
  "properties": {
    "immutabilityPeriodSinceCreationInDays": 100
  }
}

Пример ответа

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

{
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices/containers/immutabilityPolicies",
  "etag": "\"8d57a8b2ff50332\"",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res6238/providers/Microsoft.Storage/storageAccounts/sto232/blobServices/default/containers/container5023/immutabilityPolicies/default",
  "properties": {
    "immutabilityPeriodSinceCreationInDays": 100,
    "state": "Locked"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
ErrorResponse	Ответ на ошибку от поставщика ресурсов хранилища.
ErrorResponseBody	Контракт текста ответа на ошибку.
ImmutabilityPolicy	Свойство ImmutabilityPolicy контейнера BLOB-объектов, включая идентификатор, имя ресурса, тип ресурса, Etag.
ImmutabilityPolicyState	Состояние ImmutabilityPolicy контейнера BLOB-объектов, возможные значения: Заблокировано и Разблокировано.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

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

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

ErrorResponse

Объект

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

Имя	Тип	Описание
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Объект

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

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.

ImmutabilityPolicy

Объект

Свойство ImmutabilityPolicy контейнера BLOB-объектов, включая идентификатор, имя ресурса, тип ресурса, Etag.

Имя	Тип	Описание
etag	string	Etag ресурса.
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties.allowProtectedAppendWrites	boolean	Это свойство можно изменить только для разблокированных политик хранения на основе времени. При включении новые блоки можно записать в добавочный большой двоичный объект при сохранении неизменяемости защиты и соответствия требованиям. Можно добавить только новые блоки, и любые существующие блоки нельзя изменить или удалить. Это свойство нельзя изменить с помощью API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Это свойство можно изменить только для разблокированных политик хранения на основе времени. При включении новые блоки можно записать в "Добавление и Bock Blobs" при сохранении неизменяемости защиты и соответствия требованиям. Можно добавить только новые блоки, и любые существующие блоки нельзя изменить или удалить. Это свойство нельзя изменить с помощью API ExtendImmutabilityPolicy. Свойства allowProtectedAppendWrites и AllowProtectedAppendWritesAll являются взаимоисключающими.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Период неизменяемости больших двоичных объектов в контейнере с момента создания политики в днях.
properties.state	ImmutabilityPolicyState	Состояние ImmutabilityPolicy контейнера BLOB-объектов, возможные значения: Заблокировано и Разблокировано.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Перечисление

Состояние ImmutabilityPolicy контейнера BLOB-объектов, возможные значения: Заблокировано и Разблокировано.

Значение	Описание
Locked
Unlocked

systemData

Объект

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

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Blob Containers - Extend Immutability Policy

Параметры URI

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

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

Ответы

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

azure_auth

Области

Примеры

ExtendImmutabilityPolicy

Образец запроса

Пример ответа

Определения

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData