共用方式為


BlobContainersOperations 類別

警告

請勿直接具現化此類別。

您應該改為透過 存取下列作業

StorageManagementClient's

<xref:blob_containers> 屬性。

繼承
builtins.object
BlobContainersOperations

建構函式

BlobContainersOperations(*args, **kwargs)

方法

begin_object_level_worm

這項作業會將 Blob 容器從容器層級 WORM 移轉至已啟用物件層級的不變性容器。 必要條件需要處於鎖定或解除鎖定狀態的容器層級不變性原則,必須啟用帳戶層級版本控制,而且容器上不應該有合法保留。

clear_legal_hold

清除合法保存標籤。 清除相同或不存在的標記會導致等冪運算。 ClearLegalHold 只會清除要求中指定的標記。

create

依照要求本文所述,在指定的帳號下建立新的容器。 容器資源包含該容器的中繼資料和屬性。 不包含容器中的 Blob 清單。

create_or_update_immutability_policy

建立或更新解除鎖定的不變性原則。 如果為此作業指定但不需要,則會接受 If-Match 中的 ETag。

delete

刪除其帳戶下的指定容器。

delete_immutability_policy

中止解除鎖定的不變性原則。 刪除的回應將 immutabilityPeriodSinceCreationInDays 設定為 0。 此作業需要 If-Match 中的 ETag。 不允許刪除鎖定的不變性原則,唯一的方法就是刪除原則鎖定容器內所有過期的 Blob 之後刪除容器。

extend_immutability_policy

擴充鎖定 immutabilityPolicy 的 immutabilityPeriodSinceCreationInDays。 鎖定原則上允許的唯一動作就是此動作。 此作業需要 If-Match 中的 ETag。

get

取得指定容器的屬性。

get_immutability_policy

取得現有的不變性原則,以及回應標頭和本文中的對應 ETag。

lease

租用容器作業會建立和管理容器上的鎖定以進行刪除作業。 鎖定持續時間的範圍是 15 到 60 秒,也可以設為無限。

list

列出所有容器,且不支援前置詞,例如資料平面。 此外,目前 SRP 不會傳回接續權杖。

lock_immutability_policy

將 ImmutabilityPolicy 設定為 [鎖定] 狀態。 鎖定原則上允許的唯一動作是 ExtendImmutabilityPolicy 動作。 此作業需要 If-Match 中的 ETag。

set_legal_hold

設定法務保存標記。 設定相同的標記會導致等冪運算。 SetLegalHold 遵循附加模式,而且不會清除要求中未指定的現有標記。

update

更新要求本文中指定的容器屬性。 要求中未提及的屬性將會保持不變。 如果指定的容器不存在,更新就會失敗。

begin_object_level_worm

這項作業會將 Blob 容器從容器層級 WORM 移轉至已啟用物件層級的不變性容器。 必要條件需要處於鎖定或解除鎖定狀態的容器層級不變性原則,必須啟用帳戶層級版本控制,而且容器上不應該有合法保留。

begin_object_level_worm(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) -> LROPoller[None]

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

cls
callable

將傳遞直接回應的自訂類型或函式

continuation_token
str

從已儲存狀態重新開機輪詢器的接續權杖。

polling
boolPollingMethod

根據預設,您的輪詢方法會是 ARMPolling。 針對此作業傳入 False,以不輪詢,或傳入您自己的初始化輪詢物件,以取得個人輪詢策略。

polling_interval
int

如果沒有 Retry-After 標頭,則為 LRO 作業的兩個輪詢之間的預設等候時間。

傳回

LROPoller 的實例,會傳回 None 或 cls (回應的結果)

傳回類型

例外狀況

清除合法保存標籤。 清除相同或不存在的標記會導致等冪運算。 ClearLegalHold 只會清除要求中指定的標記。

clear_legal_hold(resource_group_name: str, account_name: str, container_name: str, legal_hold: _models.LegalHold, *, content_type: str = 'application/json', **kwargs: Any) -> _models.LegalHold

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

legal_hold
LegalHoldIO
必要

將會從 Blob 容器清除的 LegalHold 屬性。 這是 LegalHold 類型或 IO 類型。 必要。

content_type
str

Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

LegalHold 或 cls (回應的結果)

傳回類型

例外狀況

create

依照要求本文所述,在指定的帳號下建立新的容器。 容器資源包含該容器的中繼資料和屬性。 不包含容器中的 Blob 清單。

create(resource_group_name: str, account_name: str, container_name: str, blob_container: _models.BlobContainer, *, content_type: str = 'application/json', **kwargs: Any) -> _models.BlobContainer

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

blob_container
BlobContainerIO
必要

要建立之 Blob 容器的屬性。 這是 BlobContainer 類型或 IO 類型。 必要。

content_type
str

Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

BlobContainer 或 cls 的結果 (回應)

傳回類型

例外狀況

create_or_update_immutability_policy

建立或更新解除鎖定的不變性原則。 如果為此作業指定但不需要,則會接受 If-Match 中的 ETag。

create_or_update_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str | None = None, parameters: _models.ImmutabilityPolicy | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> _models.ImmutabilityPolicy

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

if_match
str
必要

要更新的實體狀態 (ETag) 版本的不變性原則。 只有在不變性原則已經存在時,才能使用 「*」 的值來套用作業。 如果省略,一律會套用此作業。 預設值為 [無]。

parameters
ImmutabilityPolicyIO
必要

將建立或更新至 Blob 容器的 ImmutabilityPolicy 屬性。 這是 ImmutabilityPolicy 類型或 IO 類型。 預設值為 [無]。

immutability_policy_name
str

指定儲存體帳戶內的 Blob 容器 immutabilityPolicy 名稱。 ImmutabilityPolicy 名稱必須是 'default'。 預設值為 「default」。 請注意,覆寫此預設值可能會導致不支援的行為。

content_type
str

Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

immutabilityPolicy 或 cls 的結果 (回應)

傳回類型

例外狀況

delete

刪除其帳戶下的指定容器。

delete(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) -> None

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

無或 cls (回應的結果)

傳回類型

例外狀況

delete_immutability_policy

中止解除鎖定的不變性原則。 刪除的回應將 immutabilityPeriodSinceCreationInDays 設定為 0。 此作業需要 If-Match 中的 ETag。 不允許刪除鎖定的不變性原則,唯一的方法就是刪除原則鎖定容器內所有過期的 Blob 之後刪除容器。

delete_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, **kwargs: Any) -> ImmutabilityPolicy

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

if_match
str
必要

要更新的實體狀態 (ETag) 版本的不變性原則。 只有在不變性原則已經存在時,才能使用 「*」 的值來套用作業。 如果省略,一律會套用此作業。 必要。

immutability_policy_name
str

指定儲存體帳戶內的 Blob 容器 immutabilityPolicy 名稱。 ImmutabilityPolicy 名稱必須是 'default'。 預設值為 「default」。 請注意,覆寫此預設值可能會導致不支援的行為。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

immutabilityPolicy 或 cls 的結果 (回應)

傳回類型

例外狀況

extend_immutability_policy

擴充鎖定 immutabilityPolicy 的 immutabilityPeriodSinceCreationInDays。 鎖定原則上允許的唯一動作就是此動作。 此作業需要 If-Match 中的 ETag。

extend_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, parameters: _models.ImmutabilityPolicy | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> _models.ImmutabilityPolicy

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

if_match
str
必要

要更新的實體狀態 (ETag) 版本的不變性原則。 只有在不變性原則已經存在時,才能使用 「*」 的值來套用作業。 如果省略,一律會套用此作業。 必要。

parameters
ImmutabilityPolicyIO
必要

將會針對 Blob 容器擴充的 ImmutabilityPolicy 屬性。 這是 ImmutabilityPolicy 類型或 IO 類型。 預設值為 [無]。

content_type
str

Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

immutabilityPolicy 或 cls 的結果 (回應)

傳回類型

例外狀況

get

取得指定容器的屬性。

get(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) -> BlobContainer

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

BlobContainer 或 cls 的結果 (回應)

傳回類型

例外狀況

get_immutability_policy

取得現有的不變性原則,以及回應標頭和本文中的對應 ETag。

get_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str | None = None, **kwargs: Any) -> ImmutabilityPolicy

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

if_match
str
必要

要更新的實體狀態 (ETag) 版本的不變性原則。 只有在不變性原則已經存在時,才能使用 「*」 的值來套用作業。 如果省略,一律會套用此作業。 預設值為 [無]。

immutability_policy_name
str

指定儲存體帳戶內的 Blob 容器 immutabilityPolicy 名稱。 ImmutabilityPolicy 名稱必須是 'default'。 預設值為 「default」。 請注意,覆寫此預設值可能會導致不支援的行為。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

immutabilityPolicy 或 cls 的結果 (回應)

傳回類型

例外狀況

lease

租用容器作業會建立和管理容器上的鎖定以進行刪除作業。 鎖定持續時間的範圍是 15 到 60 秒,也可以設為無限。

lease(resource_group_name: str, account_name: str, container_name: str, parameters: _models.LeaseContainerRequest | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> _models.LeaseContainerResponse

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定之儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱的長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

parameters
LeaseContainerRequestIO
必要

租用容器要求本文。 這是 LeaseContainerRequest 類型或 IO 類型。 預設值為 [無]。

content_type
str

本文參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

LeaseContainerResponse 或 cls (回應的結果)

傳回類型

例外狀況

list

列出所有容器,且不支援前置詞,例如資料平面。 此外,目前 SRP 不會傳回接續權杖。

list(resource_group_name: str, account_name: str, maxpagesize: str | None = None, filter: str | None = None, include: str | ListContainersInclude | None = None, **kwargs: Any) -> Iterable[ListContainerItem]

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

maxpagesize
str
必要

選擇性。 指定可以包含在清單中的最大容器數目。 預設值為 [無]。

filter
str
必要

選擇性。 指定時,只會列出以篩選開頭的容器名稱。 預設值為 [無]。

include
strListContainersInclude
必要

選擇性,用來包含虛刪除 Blob 容器的屬性。 「deleted」 預設值為 None。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

像是 ListContainerItem 實例或 cls (回應結果的反覆運算器)

傳回類型

例外狀況

lock_immutability_policy

將 ImmutabilityPolicy 設定為 [鎖定] 狀態。 鎖定原則上允許的唯一動作是 ExtendImmutabilityPolicy 動作。 此作業需要 If-Match 中的 ETag。

lock_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, **kwargs: Any) -> ImmutabilityPolicy

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定之儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱的長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

if_match
str
必要

要更新之不變性原則的實體狀態 (ETag) 版本。 只有在不變性原則已經存在時,才能使用 「*」 的值來套用作業。 如果省略,一律會套用此作業。 必要。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

immutabilityPolicy 或 cls 的結果 (回應)

傳回類型

例外狀況

設定法務保存標記。 設定相同的標記會導致等冪運算。 SetLegalHold 遵循附加模式,而且不會清除要求中未指定的現有標記。

set_legal_hold(resource_group_name: str, account_name: str, container_name: str, legal_hold: _models.LegalHold, *, content_type: str = 'application/json', **kwargs: Any) -> _models.LegalHold

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定之儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱的長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

legal_hold
LegalHoldIO
必要

將設定為 Blob 容器的 LegalHold 屬性。 這是 LegalHold 類型或 IO 類型。 必要。

content_type
str

本文參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

LegalHold 或 cls 的結果 (回應)

傳回類型

例外狀況

update

更新要求本文中指定的容器屬性。 要求中未提及的屬性將會保持不變。 如果指定的容器不存在,更新就會失敗。

update(resource_group_name: str, account_name: str, container_name: str, blob_container: _models.BlobContainer, *, content_type: str = 'application/json', **kwargs: Any) -> _models.BlobContainer

參數

resource_group_name
str
必要

使用者訂用帳戶內的資源組名。 名稱不區分大小寫。 必要。

account_name
str
必要

指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 必要。

container_name
str
必要

指定之儲存體帳戶內的 Blob 容器名稱。 Blob 容器名稱的長度必須介於 3 到 63 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

blob_container
BlobContainerIO
必要

要更新 Blob 容器的屬性。 這是 BlobContainer 類型或 IO 類型。 必要。

content_type
str

本文參數內容類型。 已知值為:'application/json'。 預設值為 [無]。

cls
callable

將傳遞直接回應的自訂類型或函式

傳回

BlobContainer 或 cls 的結果 (回應)

傳回類型

例外狀況

屬性

models

models = <module 'azure.mgmt.storage.v2022_09_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\storage\\v2022_09_01\\models\\__init__.py'>