共用方式為


StorageAccountsOperations 類別

警告

請勿直接具現化此類別。

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

StorageManagementClient's

<xref:storage_accounts> 屬性。

繼承
builtins.object
StorageAccountsOperations

建構函式

StorageAccountsOperations(*args, **kwargs)

方法

begin_abort_hierarchical_namespace_migration

中止儲存體帳戶的即時移轉,以啟用 Hns。

begin_create

以非同步方式建立具有指定參數的新儲存體帳戶。 如果帳戶已建立,且後續的建立要求會以不同的屬性發出,則會更新帳戶屬性。 如果帳戶已建立,且後續的建立或更新要求會發出完全相同的屬性集,要求將會成功。

begin_failover

當主要端點因任何原因而無法使用時,可以觸發儲存體帳戶的容錯移轉要求。 容錯移轉會從儲存體帳戶的主要叢集發生到 RA-GRS 帳戶的次要叢集。 次要叢集會在容錯移轉之後變成主要叢集,而且帳戶會轉換成 LRS。 在計劃性容錯移轉的情況下,主要和次要叢集會在容錯移轉後交換,而且帳戶仍會異地複寫。 容錯移轉應該會在可用性問題發生時繼續使用,因為只有在主要和次要端點可用時,才能使用計劃性容錯移轉。 計劃性容錯移轉的主要使用案例是災害復原測試演練。 將 FailoverType 參數設定為 'Planned',以叫用這種類型的容錯移轉。 在這裡深入瞭解容錯移轉選項- https://learn.microsoft.com/en-us/azure/storage/common/storage-disaster-recovery-guidance

begin_hierarchical_namespace_migration

即時移轉儲存體帳戶以啟用 Hns。

begin_restore_blob_ranges

在指定的 Blob 範圍中還原 Blob。

check_name_availability

檢查儲存體帳戶名稱是否有效,且尚未使用中。

delete

刪除 Microsoft Azure 中的儲存體帳戶。

get_properties

傳回指定儲存體帳戶的屬性,包括但不限於名稱、SKU 名稱、位置和帳戶狀態。 ListKeys 作業應該用來擷取儲存體金鑰。

list

列出訂用帳戶下可用的所有儲存體帳戶。 請注意,不會傳回儲存體金鑰;請使用 ListKeys 作業來進行此作業。

list_account_sas

列出儲存體帳戶的 SAS 認證。

list_by_resource_group

列出指定資源群組下可用的所有儲存體帳戶。 請注意,不會傳回儲存體金鑰;請使用 ListKeys 作業來進行此作業。

list_keys

如果已啟用指定儲存體帳戶的 active directory) ,則會列出存取金鑰或 Kerberos 金鑰 (。

list_service_sas

列出特定資源的服務 SAS 認證。

regenerate_key

針對指定的儲存體帳戶重新產生其中一個存取金鑰或 Kerberos 金鑰。

revoke_user_delegation_keys

撤銷使用者委派金鑰。

update

更新作業可用來更新儲存體帳戶的 SKU、加密、存取層或標記。 它也可以用來將帳戶對應至自訂網域。 每個儲存體帳戶只支援一個自訂網域;不支援取代/變更自訂網域。 若要取代舊的自訂定義域,必須先清除/取消註冊舊的值,才能設定新的值。 支援更新多個屬性。 此呼叫不會變更帳戶的儲存體金鑰。 如果您想要變更儲存體帳戶金鑰,請使用重新產生金鑰作業。 建立之後,無法變更儲存體帳戶的位置和名稱。

begin_abort_hierarchical_namespace_migration

中止儲存體帳戶的即時移轉,以啟用 Hns。

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

參數

resource_group_name
str
必要

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

account_name
str
必要

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

cls
callable

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

continuation_token
str

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

polling
boolPollingMethod

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

polling_interval
int

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

傳回

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

傳回類型

例外狀況

begin_create

以非同步方式建立具有指定參數的新儲存體帳戶。 如果帳戶已建立,且後續的建立要求會以不同的屬性發出,則會更新帳戶屬性。 如果帳戶已建立,且後續的建立或更新要求會發出完全相同的屬性集,要求將會成功。

begin_create(resource_group_name: str, account_name: str, parameters: _models.StorageAccountCreateParameters, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.StorageAccount]

參數

resource_group_name
str
必要

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

account_name
str
必要

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

parameters
StorageAccountCreateParametersIO
必要

要提供給所建立帳戶的參數。 這是 StorageAccountCreateParameters 類型或 IO 類型。 必要。

content_type
str

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

cls
callable

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

continuation_token
str

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

polling
boolPollingMethod

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

polling_interval
int

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

傳回

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

傳回類型

例外狀況

begin_failover

當主要端點因任何原因而無法使用時,可以觸發儲存體帳戶的容錯移轉要求。 容錯移轉會從儲存體帳戶的主要叢集發生到 RA-GRS 帳戶的次要叢集。 次要叢集會在容錯移轉之後變成主要叢集,而且帳戶會轉換成 LRS。 在計劃性容錯移轉的情況下,主要和次要叢集會在容錯移轉後交換,而且帳戶仍會異地複寫。 容錯移轉應該會在可用性問題發生時繼續使用,因為只有在主要和次要端點可用時,才能使用計劃性容錯移轉。 計劃性容錯移轉的主要使用案例是災害復原測試演練。 將 FailoverType 參數設定為 'Planned',以叫用這種類型的容錯移轉。 在這裡深入瞭解容錯移轉選項- https://learn.microsoft.com/en-us/azure/storage/common/storage-disaster-recovery-guidance

begin_failover(resource_group_name: str, account_name: str, failover_type: Literal['Planned'] = 'Planned', **kwargs: Any) -> LROPoller[None]

參數

resource_group_name
str
必要

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

account_name
str
必要

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

failover_type
str
必要

參數會設定為 'Planned',以指出是否要求計劃性容錯移轉。 已知值為 「已規劃」和「無」。 預設值為 「Planned」。

cls
callable

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

continuation_token
str

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

polling
boolPollingMethod

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

polling_interval
int

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

傳回

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

傳回類型

例外狀況

begin_hierarchical_namespace_migration

即時移轉儲存體帳戶以啟用 Hns。

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

參數

resource_group_name
str
必要

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

account_name
str
必要

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

request_type
str
必要

必要。 階層命名空間移轉類型可以是階層命名空間驗證要求 'HnsOnValidationRequest' 或凍結要求 'HnsOnHydrationRequest'。 驗證要求會驗證移轉,而凍結要求則會移轉帳戶。 必要。

cls
callable

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

continuation_token
str

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

polling
boolPollingMethod

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

polling_interval
int

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

傳回

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

傳回類型

例外狀況

begin_restore_blob_ranges

在指定的 Blob 範圍中還原 Blob。

begin_restore_blob_ranges(resource_group_name: str, account_name: str, parameters: _models.BlobRestoreParameters, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.BlobRestoreStatus]

參數

resource_group_name
str
必要

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

account_name
str
必要

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

parameters
BlobRestoreParametersIO
必要

要提供還原 Blob 範圍的參數。 這是 BlobRestoreParameters 類型或 IO 類型。 必要。

content_type
str

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

cls
callable

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

continuation_token
str

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

polling
boolPollingMethod

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

polling_interval
int

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

傳回

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

傳回類型

例外狀況

check_name_availability

檢查儲存體帳戶名稱是否有效,且尚未使用中。

check_name_availability(account_name: _models.StorageAccountCheckNameAvailabilityParameters, *, content_type: str = 'application/json', **kwargs: Any) -> _models.CheckNameAvailabilityResult

參數

account_name
StorageAccountCheckNameAvailabilityParametersIO
必要

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

content_type
str

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

cls
callable

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

傳回

CheckNameAvailabilityResult 或 cls (回應的結果)

傳回類型

例外狀況

delete

刪除 Microsoft Azure 中的儲存體帳戶。

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

參數

resource_group_name
str
必要

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

account_name
str
必要

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

cls
callable

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

傳回

無或 cls (回應的結果)

傳回類型

例外狀況

get_properties

傳回指定儲存體帳戶的屬性,包括但不限於名稱、SKU 名稱、位置和帳戶狀態。 ListKeys 作業應該用來擷取儲存體金鑰。

get_properties(resource_group_name: str, account_name: str, expand: str | StorageAccountExpand | None = None, **kwargs: Any) -> StorageAccount

參數

resource_group_name
str
必要

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

account_name
str
必要

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

expand
strStorageAccountExpand
必要

可用來展開帳戶屬性內的屬性。 根據預設,擷取屬性時不會包含資料。 目前我們只支援 geoReplicationStats 和 blobRestoreStatus。 已知值為:「geoReplicationStats」 和 「blobRestoreStatus」。 預設值為 [無]。

cls
callable

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

傳回

StorageAccount 或 cls 的結果 (回應)

傳回類型

例外狀況

list

列出訂用帳戶下可用的所有儲存體帳戶。 請注意,不會傳回儲存體金鑰;請使用 ListKeys 作業來進行此作業。

list(**kwargs: Any) -> Iterable[StorageAccount]

參數

cls
callable

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

傳回

StorageAccount 實例或 cls (回應結果之類的反覆運算器)

傳回類型

例外狀況

list_account_sas

列出儲存體帳戶的 SAS 認證。

list_account_sas(resource_group_name: str, account_name: str, parameters: _models.AccountSasParameters, *, content_type: str = 'application/json', **kwargs: Any) -> _models.ListAccountSasResponse

參數

resource_group_name
str
必要

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

account_name
str
必要

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

parameters
AccountSasParametersIO
必要

要提供以列出儲存體帳戶 SAS 認證的參數。 這是 AccountSasParameters 類型或 IO 類型。 必要。

content_type
str

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

cls
callable

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

傳回

ListAccountSasResponse 或 cls (回應的結果)

傳回類型

例外狀況

list_by_resource_group

列出指定資源群組下可用的所有儲存體帳戶。 請注意,不會傳回儲存體金鑰;請使用 ListKeys 作業來進行此作業。

list_by_resource_group(resource_group_name: str, **kwargs: Any) -> Iterable[StorageAccount]

參數

resource_group_name
str
必要

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

cls
callable

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

傳回

StorageAccount 實例或 cls (回應結果之類的反覆運算器)

傳回類型

例外狀況

list_keys

如果已啟用指定儲存體帳戶的 active directory) ,則會列出存取金鑰或 Kerberos 金鑰 (。

list_keys(resource_group_name: str, account_name: str, expand: Literal['kerb'] = 'kerb', **kwargs: Any) -> StorageAccountListKeysResult

參數

resource_group_name
str
必要

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

account_name
str
必要

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

expand
str
必要

指定要列出的索引鍵類型。 可能的值為 kerb。 已知值為 「kerb」 和 None。 預設值為 「kerb」。

cls
callable

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

傳回

StorageAccountListKeysResult 或 cls (回應的結果)

傳回類型

例外狀況

list_service_sas

列出特定資源的服務 SAS 認證。

list_service_sas(resource_group_name: str, account_name: str, parameters: _models.ServiceSasParameters, *, content_type: str = 'application/json', **kwargs: Any) -> _models.ListServiceSasResponse

參數

resource_group_name
str
必要

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

account_name
str
必要

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

parameters
ServiceSasParametersIO
必要

要提供以列出服務 SAS 認證的參數。 這是 ServiceSasParameters 類型或 IO 類型。 必要。

content_type
str

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

cls
callable

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

傳回

ListServiceSasResponse 或 cls (回應的結果)

傳回類型

例外狀況

regenerate_key

針對指定的儲存體帳戶重新產生其中一個存取金鑰或 Kerberos 金鑰。

regenerate_key(resource_group_name: str, account_name: str, regenerate_key: _models.StorageAccountRegenerateKeyParameters, *, content_type: str = 'application/json', **kwargs: Any) -> _models.StorageAccountListKeysResult

參數

resource_group_name
str
必要

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

account_name
str
必要

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

regenerate_key
StorageAccountRegenerateKeyParametersIO
必要

指定應該重新產生的金鑰名稱 – key1、key2、kerb1、kerb2。 這是 StorageAccountRegenerateKeyParameters 類型或 IO 類型。 必要。

content_type
str

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

cls
callable

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

傳回

StorageAccountListKeysResult 或 cls (回應的結果)

傳回類型

例外狀況

revoke_user_delegation_keys

撤銷使用者委派金鑰。

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

參數

resource_group_name
str
必要

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

account_name
str
必要

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

cls
callable

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

傳回

無或 cls (回應的結果)

傳回類型

例外狀況

update

更新作業可用來更新儲存體帳戶的 SKU、加密、存取層或標記。 它也可以用來將帳戶對應至自訂網域。 每個儲存體帳戶只支援一個自訂網域;不支援取代/變更自訂網域。 若要取代舊的自訂定義域,必須先清除/取消註冊舊的值,才能設定新的值。 支援更新多個屬性。 此呼叫不會變更帳戶的儲存體金鑰。 如果您想要變更儲存體帳戶金鑰,請使用重新產生金鑰作業。 建立之後,無法變更儲存體帳戶的位置和名稱。

update(resource_group_name: str, account_name: str, parameters: _models.StorageAccountUpdateParameters, *, content_type: str = 'application/json', **kwargs: Any) -> _models.StorageAccount

參數

resource_group_name
str
必要

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

account_name
str
必要

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

parameters
StorageAccountUpdateParametersIO
必要

要為更新帳戶提供的參數。 這是 StorageAccountUpdateParameters 類型或 IO 類型。 必要。

content_type
str

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

cls
callable

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

傳回

StorageAccount 或 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'>