Blob Containers - Extend Immutability Policy

Usługa:

Storage Resource Provider

Wersja interfejsu API:

2025-08-01

Rozszerza wartość immutabilityPeriodSinceCreationInDays zablokowanej zasady niezmienności. Jedyną akcją dozwoloną dla zablokowanych zasad będzie ta akcja. Element ETag w If-Match jest wymagany dla tej operacji.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nazwa konta magazynu w określonej grupie zasobów. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać wyłącznie cyfry oraz małe litery.
containerName	path	True	string minLength: 3 maxLength: 63	Nazwa kontenera obiektów blob w ramach określonego konta magazynu. Nazwy kontenerów obiektów blob muszą mieć długość od 3 do 63 znaków i używać tylko cyfr, małych liter i kreski (-). Każdy znak kreski (-) musi być bezpośrednio poprzedzony literą lub cyfrą i po niej następuje.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match	True	string	Wersja stanu jednostki (ETag) zasady niezmienności do zaktualizowania musi zostać zwrócona do serwera dla wszystkich operacji aktualizacji. Wartość ETag musi zawierać początkowe i końcowe podwójne cudzysłowy zwrócone przez usługę.

Treść żądania

Nazwa	Typ	Opis
properties.allowProtectedAppendWrites	boolean	Tę właściwość można zmienić tylko dla odblokowanych zasad przechowywania na podstawie czasu. Po włączeniu nowych bloków można zapisywać w uzupełnialnych obiektach blob przy zachowaniu niezmienności i zgodności. Można dodawać tylko nowe bloki i nie można modyfikować ani usuwać żadnych istniejących bloków. Tej właściwości nie można zmienić za pomocą interfejsu API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Tę właściwość można zmienić tylko dla odblokowanych zasad przechowywania na podstawie czasu. Po włączeniu nowych bloków można zapisywać zarówno w obiektach blob dołączania, jak i obiektów blob Bock przy zachowaniu niezmienności i zgodności. Można dodawać tylko nowe bloki i nie można modyfikować ani usuwać żadnych istniejących bloków. Tej właściwości nie można zmienić za pomocą interfejsu API ExtendImmutabilityPolicy. Właściwości "allowProtectedAppendWrites" i "allowProtectedAppendWritesAll" wzajemnie się wykluczają.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Okres niezmienności obiektów blob w kontenerze od momentu utworzenia zasad w dniach.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ImmutabilityPolicy	Operacja Azure zakończyła się pomyślnie. Nagłówki ETag: string
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ExtendImmutabilityPolicy

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorResponse	Odpowiedź dostawcy zasobów magazynu na błąd.
ErrorResponseBody	Kontrakt treści odpowiedzi na błąd.
ImmutabilityPolicy	Właściwość ImmutabilityPolicy kontenera obiektów blob, w tym Identyfikator, nazwa zasobu, typ zasobu, Etag.
ImmutabilityPolicyState	Stan ImmutabilityPolicy kontenera obiektów blob, możliwe wartości to: Zablokowane i Odblokowane.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Odpowiedź dostawcy zasobów magazynu na błąd.

Nazwa	Typ	Opis
error	ErrorResponseBody	Azure Storage Resource Provider Error response body.

ErrorResponseBody

Objekt

Kontrakt treści odpowiedzi na błąd.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

ImmutabilityPolicy

Objekt

Właściwość ImmutabilityPolicy kontenera obiektów blob, w tym Identyfikator, nazwa zasobu, typ zasobu, Etag.

Nazwa	Typ	Opis
etag	string	Zasób Etag.
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties.allowProtectedAppendWrites	boolean	Tę właściwość można zmienić tylko dla odblokowanych zasad przechowywania na podstawie czasu. Po włączeniu nowych bloków można zapisywać w uzupełnialnych obiektach blob przy zachowaniu niezmienności i zgodności. Można dodawać tylko nowe bloki i nie można modyfikować ani usuwać żadnych istniejących bloków. Tej właściwości nie można zmienić za pomocą interfejsu API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Tę właściwość można zmienić tylko dla odblokowanych zasad przechowywania na podstawie czasu. Po włączeniu nowych bloków można zapisywać zarówno w obiektach blob dołączania, jak i obiektów blob Bock przy zachowaniu niezmienności i zgodności. Można dodawać tylko nowe bloki i nie można modyfikować ani usuwać żadnych istniejących bloków. Tej właściwości nie można zmienić za pomocą interfejsu API ExtendImmutabilityPolicy. Właściwości "allowProtectedAppendWrites" i "allowProtectedAppendWritesAll" wzajemnie się wykluczają.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Okres niezmienności obiektów blob w kontenerze od momentu utworzenia zasad w dniach.
properties.state	ImmutabilityPolicyState	Stan ImmutabilityPolicy kontenera obiektów blob, możliwe wartości to: Zablokowane i Odblokowane.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Wyliczenie

Stan ImmutabilityPolicy kontenera obiektów blob, możliwe wartości to: Zablokowane i Odblokowane.

Wartość	Opis
Locked
Unlocked

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.