Blob Containers - Extend Immutability Policy

Dienst:: Storage Resource Provider

API-Version:: 2025-08-01

Erweitert die immutabilityPeriodSinceCreationInDays einer gesperrten ImmutabilityPolicy. Die einzige Aktion, die für eine gesperrte Richtlinie zulässig ist, ist diese Aktion. ETag in If-Match ist für diesen Vorgang erforderlich.

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

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Die Namen von Speicherkonten müssen zwischen 3 und 24 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden.
containerName	path	True	string minLength: 3 maxLength: 63	Der Name des Blobcontainers innerhalb des angegebenen Speicherkontos. Die Namen von Blobcontainern müssen zwischen 3 und 63 Zeichen lang sein und dürfen nur Zahlen, Kleinbuchstaben und Bindestriche (-) enthalten. Jedem Bindestrich (-) muss unmittelbar ein Buchstabe oder eine Zahl vorangestellt und gefolgt werden.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-Match	True	string	Die ETag-Version (Entity State) der zu aktualisierenden Unveränderlichkeitsrichtlinie muss für alle Aktualisierungsvorgänge an den Server zurückgegeben werden. Der ETag-Wert muss die führenden und nachfolgenden doppelten Anführungszeichen enthalten, wie sie vom Dienst zurückgegeben werden.

Anforderungstext

Name	Typ	Beschreibung
properties.allowProtectedAppendWrites	boolean	Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn diese Option aktiviert ist, können neue Blöcke in ein Anfüge-Blob geschrieben werden und gleichzeitig unveränderlichen Schutz und Compliance beibehalten. Es können nur neue Blöcke hinzugefügt werden, und vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden.
properties.allowProtectedAppendWritesAll	boolean	Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn diese Option aktiviert ist, können neue Blöcke sowohl in "Append" als auch in "Bock Blobs" geschrieben werden und gleichzeitig unveränderlichen Schutz und Compliance beibehalten werden. Es können nur neue Blöcke hinzugefügt werden, und vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden. Die Eigenschaften "allowProtectedAppendWrites" und "allowProtectedAppendWritesAll" schließen sich gegenseitig aus.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Der Unveränderlichkeitszeitraum für die Blobs im Container seit der Richtlinienerstellung in Tagen.

Antworten

Name	Typ	Beschreibung
200 OK	ImmutabilityPolicy	Azure-Operation erfolgreich abgeschlossen. Header ETag: string
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

ImmutabilityPolicy

Azure-Operation erfolgreich abgeschlossen.

Header

ETag: string

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

ExtendImmutabilityPolicy

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorResponse	Eine Fehlerantwort des Speicherressourcenanbieters.
ErrorResponseBody	Fehlerantworttext-Vertrag.
ImmutabilityPolicy	Die ImmutabilityPolicy-Eigenschaft eines BLOB-Containers, einschließlich ID, Ressourcenname, Ressourcentyp, Etag.
ImmutabilityPolicyState	Zu den möglichen Werten für den ImmutabilityPolicy-Zustand eines Blobcontainers gehören: Locked und Unlocked.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Eine Fehlerantwort des Speicherressourcenanbieters.

Name	Typ	Beschreibung
error	ErrorResponseBody	Azure Storage Resource Provider Error Response Body.

ErrorResponseBody

Objekt

Fehlerantworttext-Vertrag.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

ImmutabilityPolicy

Objekt

Die ImmutabilityPolicy-Eigenschaft eines BLOB-Containers, einschließlich ID, Ressourcenname, Ressourcentyp, Etag.

Name	Typ	Beschreibung
etag	string	Ressourcen-Etag.
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.allowProtectedAppendWrites	boolean	Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn diese Option aktiviert ist, können neue Blöcke in ein Anfüge-Blob geschrieben werden und gleichzeitig unveränderlichen Schutz und Compliance beibehalten. Es können nur neue Blöcke hinzugefügt werden, und vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden.
properties.allowProtectedAppendWritesAll	boolean	Diese Eigenschaft kann nur für entsperrte zeitbasierte Aufbewahrungsrichtlinien geändert werden. Wenn diese Option aktiviert ist, können neue Blöcke sowohl in "Append" als auch in "Bock Blobs" geschrieben werden und gleichzeitig unveränderlichen Schutz und Compliance beibehalten werden. Es können nur neue Blöcke hinzugefügt werden, und vorhandene Blöcke können nicht geändert oder gelöscht werden. Diese Eigenschaft kann nicht mit der ExtendImmutabilityPolicy-API geändert werden. Die Eigenschaften "allowProtectedAppendWrites" und "allowProtectedAppendWritesAll" schließen sich gegenseitig aus.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Der Unveränderlichkeitszeitraum für die Blobs im Container seit der Richtlinienerstellung in Tagen.
properties.state	ImmutabilityPolicyState	Zu den möglichen Werten für den ImmutabilityPolicy-Zustand eines Blobcontainers gehören: Locked und Unlocked.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Enumeration

Zu den möglichen Werten für den ImmutabilityPolicy-Zustand eines Blobcontainers gehören: Locked und Unlocked.

Wert	Beschreibung
Locked
Unlocked

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Blob Containers - Extend Immutability Policy

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

ExtendImmutabilityPolicy

Beispielanforderung

Beispiel für eine Antwort

Definitionen

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData