Blob Containers - Extend Immutability Policy

Služba:

Storage Resource Provider

Verze rozhraní API:

2025-08-01

Prodlouží dobu neměnnostiObdobíOd VytvořeníVe dnech uzamčené zásady neměnnosti. Jedinou povolenou akcí u uzamčené zásady bude tato akce. Pro tuto operaci je vyžadována značka ETag v 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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Název účtu úložiště v zadané skupině prostředků. Názvy účtů úložiště musí mít délku 3 až 24 znaků a musí obsahovat jenom číslice a malá písmena.
containerName	path	True	string minLength: 3 maxLength: 63	Název kontejneru objektů blob v rámci zadaného účtu úložiště. Názvy kontejnerů objektů blob musí mít délku 3 až 63 znaků a musí používat pouze číslice, malá písmena a pomlčky (-). Každému znaku pomlčky (-) musí bezprostředně předcházet a za ním musí následovat písmeno nebo číslo.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
If-Match	True	string	Verze entity state (ETag) zásady neměnnosti, která se má aktualizovat, musí být vrácena na server pro všechny operace aktualizace. Hodnota ETag musí obsahovat úvodní a koncové dvojité uvozovky vrácené službou.

Text požadavku

Name	Typ	Description
properties.allowProtectedAppendWrites	boolean	Tuto vlastnost lze změnit pouze pro odemknuté zásady uchovávání informací na základě času. Pokud je tato možnost povolená, dají se nové bloky zapsat do doplňovacího objektu blob při zachování neměnnosti a dodržování předpisů. Je možné přidat pouze nové bloky a všechny existující bloky nelze upravit ani odstranit. Tuto vlastnost nelze změnit pomocí rozhraní API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Tuto vlastnost lze změnit pouze pro odemknuté zásady uchovávání informací na základě času. Pokud je tato možnost povolená, dají se nové bloky zapsat do objektů blob připojení i Bock při zachování neměnnosti ochrany a dodržování předpisů. Je možné přidat pouze nové bloky a všechny existující bloky nelze upravit ani odstranit. Tuto vlastnost nelze změnit pomocí rozhraní API ExtendImmutabilityPolicy. Vlastnosti allowProtectedAppendWrites a allowProtectedAppendWritesAll se vzájemně vylučují.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Doba neměnnosti objektů blob v kontejneru od vytvoření zásady ve dnech.

Odpovědi

Name	Typ	Description
200 OK	ImmutabilityPolicy	Operace Azure byla úspěšně dokončena. Hlavičky ETag: string
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

ExtendImmutabilityPolicy

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
ErrorResponse	Odpověď na chybu od poskytovatele prostředků úložiště
ErrorResponseBody	Kontrakt textu odpovědi na chybu
ImmutabilityPolicy	Vlastnost ImmutabilityPolicy kontejneru objektů blob, včetně ID, názvu prostředku, typu prostředku, značky Etag.
ImmutabilityPolicyState	Stav ImmutabilityPolicy kontejneru objektů blob, mezi možné hodnoty patří: Uzamčeno a Odemčeno.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Odpověď na chybu od poskytovatele prostředků úložiště

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

ErrorResponseBody

Objekt

Kontrakt textu odpovědi na chybu

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	string	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

ImmutabilityPolicy

Objekt

Vlastnost ImmutabilityPolicy kontejneru objektů blob, včetně ID, názvu prostředku, typu prostředku, značky Etag.

Name	Typ	Description
etag	string	Značky Etag prostředku
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties.allowProtectedAppendWrites	boolean	Tuto vlastnost lze změnit pouze pro odemknuté zásady uchovávání informací na základě času. Pokud je tato možnost povolená, dají se nové bloky zapsat do doplňovacího objektu blob při zachování neměnnosti a dodržování předpisů. Je možné přidat pouze nové bloky a všechny existující bloky nelze upravit ani odstranit. Tuto vlastnost nelze změnit pomocí rozhraní API ExtendImmutabilityPolicy.
properties.allowProtectedAppendWritesAll	boolean	Tuto vlastnost lze změnit pouze pro odemknuté zásady uchovávání informací na základě času. Pokud je tato možnost povolená, dají se nové bloky zapsat do objektů blob připojení i Bock při zachování neměnnosti ochrany a dodržování předpisů. Je možné přidat pouze nové bloky a všechny existující bloky nelze upravit ani odstranit. Tuto vlastnost nelze změnit pomocí rozhraní API ExtendImmutabilityPolicy. Vlastnosti allowProtectedAppendWrites a allowProtectedAppendWritesAll se vzájemně vylučují.
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	Doba neměnnosti objektů blob v kontejneru od vytvoření zásady ve dnech.
properties.state	ImmutabilityPolicyState	Stav ImmutabilityPolicy kontejneru objektů blob, mezi možné hodnoty patří: Uzamčeno a Odemčeno.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ImmutabilityPolicyState

Výčet

Stav ImmutabilityPolicy kontejneru objektů blob, mezi možné hodnoty patří: Uzamčeno a Odemčeno.

Hodnota	Description
Locked
Unlocked

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.