共用方式為


BlobContainersOperations 類別

警告

請勿直接具現化此類別。

相反地,您應該透過 存取下列作業

StorageManagementClient's

<xref:blob_containers> 屬性。

繼承
builtins.object
BlobContainersOperations

建構函式

BlobContainersOperations(*args, **kwargs)

方法

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

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

清除合法保留標記。 清除相同或不存在的標記會導致等冪運算。 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

本文參數內容類型。 已知值為:'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

本文參數內容類型。 已知值為:'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, immutability_policy_name: str | _models.Enum10, 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 個字元之間,且只能使用數位、小寫字母和虛線 ( ) 。 每個虛線 (-) 字元的前後都必須是字母或數字。 必要。

immutability_policy_name
strEnum10
必要

指定儲存體帳戶內的 Blob 容器不變性Policy 名稱。 ImmutabilityPolicy 名稱必須是 'default'。 「default」 必要。

if_match
str
必要

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

parameters
ImmutabilityPolicyIO
必要

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

content_type
str

本文參數內容類型。 已知值為:'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, immutability_policy_name: str | Enum10, if_match: str, **kwargs: Any) -> ImmutabilityPolicy

參數

resource_group_name
str
必要

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

account_name
str
必要

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

container_name
str
必要

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

immutability_policy_name
strEnum10
必要

指定儲存體帳戶內的 Blob 容器不變性Policy 名稱。 ImmutabilityPolicy 名稱必須是 'default'。 「default」 必要。

if_match
str
必要

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

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

本文參數內容類型。 已知值為:'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, immutability_policy_name: str | Enum10, if_match: str | None = None, **kwargs: Any) -> ImmutabilityPolicy

參數

resource_group_name
str
必要

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

account_name
str
必要

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

container_name
str
必要

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

immutability_policy_name
strEnum10
必要

指定儲存體帳戶內的 Blob 容器不變性Policy 名稱。 ImmutabilityPolicy 名稱必須是 'default'。 「default」 必要。

if_match
str
必要

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

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, **kwargs: Any) -> ListContainerItems

參數

resource_group_name
str
必要

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

account_name
str
必要

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

cls
callable

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

傳回

ListContainerItems 或 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

Body 參數內容類型。 已知值為:'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

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

cls
callable

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

傳回

BlobContainer 或 cls 的結果 (回應)

傳回類型

例外狀況

屬性

models

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