Blob Containers - Extend Immutability Policy

Tjänst:: Storage Resource Provider

API-version:: 2025-08-01

Utökar immutabilityPeriodSinceCreationInDays för en låst immutabilityPolicy. Den enda åtgärd som tillåts i en låst princip är den här åtgärden. ETag i If-Match krävs för den här åtgärden.

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

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Namnet på lagringskontot i den angivna resursgruppen. Lagringskontonamn måste vara mellan 3 och 24 tecken långa och endast använda siffror och gemener.
containerName	path	True	string minLength: 3 maxLength: 63	Namnet på blobcontainern i det angivna lagringskontot. Blobcontainernamn måste vara mellan 3 och 63 tecken långa och får endast innehålla siffror, gemener och bindestreck (-). Varje bindestreck (-) måste omedelbart föregås och följas av en bokstav eller siffra.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
If-Match	True	string	ETag-versionen (Entity State) av omutbarhetsprincipen som ska uppdateras måste returneras till servern för alla uppdateringsåtgärder. ETag-värdet måste innehålla de inledande och avslutande dubbla citattecknen som returneras av tjänsten.

Begärandetext

Name	Typ	Description
properties.allowProtectedAppendWrites	boolean	Den här egenskapen kan bara ändras för olåst tidsbaserade kvarhållningsprinciper. När de är aktiverade kan nya block skrivas till en tilläggsblob samtidigt som oföränderlighetsskydd och efterlevnad upprätthålls. Det går bara att lägga till nya block och befintliga block kan inte ändras eller tas bort. Det går inte att ändra den här egenskapen med ExtendImmutabilityPolicy API.
properties.allowProtectedAppendWritesAll	boolean	Den här egenskapen kan bara ändras för olåst tidsbaserade kvarhållningsprinciper. När de är aktiverade kan nya block skrivas till både Tilläggs- och Bock-blobbar samtidigt som oföränderlighetsskydd och efterlevnad upprätthålls. Det går bara att lägga till nya block och befintliga block kan inte ändras eller tas bort. Det går inte att ändra den här egenskapen med ExtendImmutabilityPolicy API. Egenskaperna "allowProtectedAppendWrites" och "allowProtectedAppendWritesAll" är ömsesidigt uteslutande.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Oföränderlighetsperioden för blobarna i containern sedan principen skapades i dagar.

Svar

Name	Typ	Description
200 OK	ImmutabilityPolicy	Azure-operationen slutfördes framgångsrikt. Sidhuvuden ETag: string
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

ImmutabilityPolicy

Azure-operationen slutfördes framgångsrikt.

Sidhuvuden

ETag: string

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ExtendImmutabilityPolicy

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
ErrorResponse	Ett felsvar från lagringsresursprovidern.
ErrorResponseBody	Brödtextkontrakt för felsvar.
ImmutabilityPolicy	Egenskapen ImmutabilityPolicy för en blobcontainer, inklusive ID, resursnamn, resurstyp, Etag.
ImmutabilityPolicyState	ImmutabilityPolicy-tillståndet för en blobcontainer, möjliga värden är: Låst och Olåst.
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Ett felsvar från lagringsresursprovidern.

Name	Typ	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Objekt

Brödtextkontrakt för felsvar.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
message	string	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.

ImmutabilityPolicy

Objekt

Egenskapen ImmutabilityPolicy för en blobcontainer, inklusive ID, resursnamn, resurstyp, Etag.

Name	Typ	Description
etag	string	Resurs-Etag.
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Namnet på resursen
properties.allowProtectedAppendWrites	boolean	Den här egenskapen kan bara ändras för olåst tidsbaserade kvarhållningsprinciper. När de är aktiverade kan nya block skrivas till en tilläggsblob samtidigt som oföränderlighetsskydd och efterlevnad upprätthålls. Det går bara att lägga till nya block och befintliga block kan inte ändras eller tas bort. Det går inte att ändra den här egenskapen med ExtendImmutabilityPolicy API.
properties.allowProtectedAppendWritesAll	boolean	Den här egenskapen kan bara ändras för olåst tidsbaserade kvarhållningsprinciper. När de är aktiverade kan nya block skrivas till både Tilläggs- och Bock-blobbar samtidigt som oföränderlighetsskydd och efterlevnad upprätthålls. Det går bara att lägga till nya block och befintliga block kan inte ändras eller tas bort. Det går inte att ändra den här egenskapen med ExtendImmutabilityPolicy API. Egenskaperna "allowProtectedAppendWrites" och "allowProtectedAppendWritesAll" är ömsesidigt uteslutande.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Oföränderlighetsperioden för blobarna i containern sedan principen skapades i dagar.
properties.state	ImmutabilityPolicyState	ImmutabilityPolicy-tillståndet för en blobcontainer, möjliga värden är: Låst och Olåst.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

Uppräkning

ImmutabilityPolicy-tillståndet för en blobcontainer, möjliga värden är: Låst och Olåst.

Värde	Description
Locked
Unlocked

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för senaste ändring av resurs (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Blob Containers - Extend Immutability Policy

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

ExtendImmutabilityPolicy

Exempelbegäran

Exempelsvar

Definitioner

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData