StorageAccountsOperations 類別
- 繼承
-
builtins.objectStorageAccountsOperations
建構函式
StorageAccountsOperations(*args, **kwargs)
方法
begin_abort_hierarchical_namespace_migration |
中止儲存體帳戶的即時移轉,以啟用 Hns。 |
begin_create |
以非同步方式建立具有指定參數的新儲存體帳戶。 如果帳戶已建立,且後續的建立要求會以不同的屬性發出,則會更新帳戶屬性。 如果帳戶已建立,且後續的建立或更新要求會發出完全相同的屬性集,要求將會成功。 |
begin_customer_initiated_migration |
您可以觸發帳戶移轉要求,讓儲存體帳戶變更其備援層級。 移轉會將非區域備援儲存體帳戶更新為區域性備援帳戶,反之亦然,以取得更好的可靠性和可用性。 區域備援儲存體 (ZRS) 會在主要區域中將儲存體帳戶同步複寫至三個 Azure 可用區域。 |
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_customer_initiated_migration |
取得指定儲存體帳戶進行中移轉的狀態。 |
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]
參數
- cls
- callable
將傳遞直接回應的自訂類型或函式
- continuation_token
- str
從已儲存狀態重新開機輪詢器的接續權杖。
- polling
- bool 或 PollingMethod
根據預設,您的輪詢方法會是 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]
參數
- parameters
- StorageAccountCreateParameters 或 IO
要提供給所建立帳戶的參數。 這是 StorageAccountCreateParameters 類型或 IO 類型。 必要。
- content_type
- str
Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。
- cls
- callable
將傳遞直接回應的自訂類型或函式
- continuation_token
- str
從已儲存狀態重新開機輪詢器的接續權杖。
- polling
- bool 或 PollingMethod
根據預設,您的輪詢方法會是 ARMPolling。 針對此作業傳入 False,以不輪詢,或傳入您自己的初始化輪詢物件,以取得個人輪詢策略。
- polling_interval
- int
如果沒有 Retry-After 標頭,則為 LRO 作業的兩個輪詢之間的預設等候時間。
傳回
LROPoller 的實例,會傳回 StorageAccount 或 cls (回應的結果)
傳回類型
例外狀況
begin_customer_initiated_migration
您可以觸發帳戶移轉要求,讓儲存體帳戶變更其備援層級。 移轉會將非區域備援儲存體帳戶更新為區域性備援帳戶,反之亦然,以取得更好的可靠性和可用性。 區域備援儲存體 (ZRS) 會在主要區域中將儲存體帳戶同步複寫至三個 Azure 可用區域。
begin_customer_initiated_migration(resource_group_name: str, account_name: str, parameters: _models.StorageAccountMigration, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[None]
參數
- parameters
- StorageAccountMigration 或 IO
執行儲存體帳戶移轉所需的要求參數。 這是 StorageAccountMigration 類型或 IO 類型。 必要。
- content_type
- str
Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。
- cls
- callable
將傳遞直接回應的自訂類型或函式
- continuation_token
- str
從已儲存狀態重新開機輪詢器的接續權杖。
- polling
- bool 或 PollingMethod
根據預設,您的輪詢方法會是 ARMPolling。 針對此作業傳入 False,以不輪詢,或傳入您自己的初始化輪詢物件,以取得個人輪詢策略。
- polling_interval
- int
如果沒有 Retry-After 標頭,則為 LRO 作業的兩個輪詢之間的預設等候時間。
傳回
LROPoller 的實例,會傳回 None 或 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]
參數
- cls
- callable
將傳遞直接回應的自訂類型或函式
- continuation_token
- str
從已儲存狀態重新開機輪詢器的接續權杖。
- polling
- bool 或 PollingMethod
根據預設,您的輪詢方法會是 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]
參數
- request_type
- str
必要。 階層命名空間移轉類型可以是階層命名空間驗證要求 'HnsOnValidationRequest' 或凍結要求 'HnsOnHydrationRequest'。 驗證要求會驗證移轉,而凍結要求則會移轉帳戶。 必要。
- cls
- callable
將傳遞直接回應的自訂類型或函式
- continuation_token
- str
從已儲存狀態重新開機輪詢器的接續權杖。
- polling
- bool 或 PollingMethod
根據預設,您的輪詢方法會是 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]
參數
- content_type
- str
Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。
- cls
- callable
將傳遞直接回應的自訂類型或函式
- continuation_token
- str
從已儲存狀態重新開機輪詢器的接續權杖。
- polling
- bool 或 PollingMethod
根據預設,您的輪詢方法會是 ARMPolling。 針對此作業傳入 False,以不輪詢,或傳入您自己的初始化輪詢物件,以取得個人輪詢策略。
- polling_interval
- int
如果沒有 Retry-After 標頭,則為 LRO 作業的兩個輪詢之間的預設等候時間。
傳回
LROPoller 的實例,會傳回 BlobRestoreStatus 或 cls (回應的結果)
傳回類型
例外狀況
check_name_availability
檢查儲存體帳戶名稱是否有效,且尚未使用中。
check_name_availability(account_name: _models.StorageAccountCheckNameAvailabilityParameters, *, content_type: str = 'application/json', **kwargs: Any) -> _models.CheckNameAvailabilityResult
參數
- account_name
- StorageAccountCheckNameAvailabilityParameters 或 IO
指定資源群組內的儲存體帳戶名稱。 儲存體帳戶名稱必須介於 3 到 24 個字元的長度,而且只能使用數字和小寫字母。 這是 StorageAccountCheckNameAvailabilityParameters 類型或 IO 類型。 必要。
- content_type
- str
Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。
- cls
- callable
將傳遞直接回應的自訂類型或函式
傳回
CheckNameAvailabilityResult 或 cls 的結果 (回應)
傳回類型
例外狀況
delete
刪除 Microsoft Azure 中的儲存體帳戶。
delete(resource_group_name: str, account_name: str, **kwargs: Any) -> None
參數
- cls
- callable
將傳遞直接回應的自訂類型或函式
傳回
無或 cls (回應的結果)
傳回類型
例外狀況
get_customer_initiated_migration
取得指定儲存體帳戶進行中移轉的狀態。
get_customer_initiated_migration(resource_group_name: str, account_name: str, migration_name: str | MigrationName, **kwargs: Any) -> StorageAccountMigration
參數
- cls
- callable
將傳遞直接回應的自訂類型或函式
傳回
StorageAccountMigration 或 cls 的結果 (回應)
傳回類型
例外狀況
get_properties
傳回指定儲存體帳戶的屬性,包括但不限於名稱、SKU 名稱、位置和帳戶狀態。 ListKeys 作業應該用來擷取儲存體金鑰。
get_properties(resource_group_name: str, account_name: str, expand: str | StorageAccountExpand | None = None, **kwargs: Any) -> StorageAccount
參數
- expand
- str 或 StorageAccountExpand
可用來展開帳戶屬性內的屬性。 根據預設,擷取屬性時不會包含資料。 目前我們只支援 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
參數
- parameters
- AccountSasParameters 或 IO
要提供以列出儲存體帳戶 SAS 認證的參數。 這是 AccountSasParameters 類型或 IO 類型。 必要。
- content_type
- str
Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。
- cls
- callable
將傳遞直接回應的自訂類型或函式
傳回
ListAccountSasResponse 或 cls (回應的結果)
傳回類型
例外狀況
list_by_resource_group
列出指定資源群組下可用的所有儲存體帳戶。 請注意,不會傳回儲存體金鑰;請使用 ListKeys 作業來進行此作業。
list_by_resource_group(resource_group_name: str, **kwargs: Any) -> Iterable[StorageAccount]
參數
- 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
參數
- 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
參數
- content_type
- str
Body 參數內容類型。 已知值為:'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
參數
- regenerate_key
- StorageAccountRegenerateKeyParameters 或 IO
指定應該重新產生之金鑰的名稱 – 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
參數
- 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
參數
- parameters
- StorageAccountUpdateParameters 或 IO
要為更新帳戶提供的參數。 這是 StorageAccountUpdateParameters 類型或 IO 類型。 必要。
- content_type
- str
Body 參數內容類型。 已知值為:'application/json'。 預設值為 [無]。
- cls
- callable
將傳遞直接回應的自訂類型或函式
傳回
StorageAccount 或 cls 的結果 (回應)
傳回類型
例外狀況
屬性
models
models = <module 'azure.mgmt.storage.v2023_01_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\storage\\v2023_01_01\\models\\__init__.py'>
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應