Blob Containers - Extend Immutability Policy

サービス:: Storage Resource Provider

API バージョン:: 2025-08-01

ロックされた immutabilityPolicy の immutabilityPeriodSinceCreationInDays を拡張します。ロックされたポリシーで許可されるアクションは、このアクションのみです。この操作には、If-Match の ETag が必要です。

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)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求ヘッダー

名前	必須	型	説明
If-Match	True	string	更新する不変性ポリシーのエンティティ状態 (ETag) バージョンは、すべての更新操作でサーバーに返す必要があります。 ETag 値には、サービスによって返される先頭と末尾の二重引用符を含める必要があります。

要求本文

名前	型	説明
properties.allowProtectedAppendWrites	boolean	このプロパティは、ロック解除された時間ベースのアイテム保持ポリシーに対してのみ変更できます。有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを追加 BLOB に書き込むことができます。新しいブロックのみを追加でき、既存のブロックは変更または削除できません。 ExtendImmutabilityPolicy API では、このプロパティを変更できません。
properties.allowProtectedAppendWritesAll	boolean	このプロパティは、ロック解除された時間ベースのアイテム保持ポリシーに対してのみ変更できます。有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを 'Append BLOB と Bock BLOB' の両方に書き込むことができます。新しいブロックのみを追加でき、既存のブロックは変更または削除できません。 ExtendImmutabilityPolicy API では、このプロパティを変更できません。 'allowProtectedAppendWrites' プロパティと 'allowProtectedAppendWritesAll' プロパティは相互に排他的です。
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	ポリシーの作成以降のコンテナー内の BLOB の不変期間 (日数)。

応答

名前	型	説明
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 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 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	リソースを作成した ID の種類。
ErrorResponse	ストレージリソースプロバイダーからのエラー応答。
ErrorResponseBody	エラー応答本文コントラクト。
ImmutabilityPolicy	ID、リソース名、リソースの種類、Etag など、BLOB コンテナーの ImmutabilityPolicy プロパティ。
ImmutabilityPolicyState	BLOB コンテナーの ImmutabilityPolicy 状態で、可能な値は Locked と Unlocked です。
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorResponse

Object

ストレージリソースプロバイダーからのエラー応答。

名前	型	説明
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

エラー応答本文コントラクト。

名前	型	説明
code	string	エラーの識別子。コードは不変であり、プログラムで使用することを目的としています。
message	string	ユーザーインターフェイスでの表示に適したエラーを説明するメッセージ。

ImmutabilityPolicy

Object

ID、リソース名、リソースの種類、Etag など、BLOB コンテナーの ImmutabilityPolicy プロパティ。

名前	型	説明
etag	string	リソース Etag。
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.allowProtectedAppendWrites	boolean	このプロパティは、ロック解除された時間ベースのアイテム保持ポリシーに対してのみ変更できます。有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを追加 BLOB に書き込むことができます。新しいブロックのみを追加でき、既存のブロックは変更または削除できません。 ExtendImmutabilityPolicy API では、このプロパティを変更できません。
properties.allowProtectedAppendWritesAll	boolean	このプロパティは、ロック解除された時間ベースのアイテム保持ポリシーに対してのみ変更できます。有効にすると、不変性の保護とコンプライアンスを維持しながら、新しいブロックを 'Append BLOB と Bock BLOB' の両方に書き込むことができます。新しいブロックのみを追加でき、既存のブロックは変更または削除できません。 ExtendImmutabilityPolicy API では、このプロパティを変更できません。 'allowProtectedAppendWrites' プロパティと 'allowProtectedAppendWritesAll' プロパティは相互に排他的です。
properties.immutabilityPeriodSinceCreationInDays	integer (int32)	ポリシーの作成以降のコンテナー内の BLOB の不変期間 (日数)。
properties.state	ImmutabilityPolicyState	BLOB コンテナーの ImmutabilityPolicy 状態で、可能な値は Locked と Unlocked です。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

ImmutabilityPolicyState

列挙

BLOB コンテナーの ImmutabilityPolicy 状態で、可能な値は Locked と Unlocked です。

値	説明
Locked
Unlocked

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Blob Containers - Extend Immutability Policy

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

azure_auth

スコープ

例

ExtendImmutabilityPolicy

要求のサンプル

応答のサンプル

定義

createdByType

ErrorResponse

ErrorResponseBody

ImmutabilityPolicy

ImmutabilityPolicyState

systemData