az storage-actions task

預覽
參考

注意

此參考是 Azure CLI 的記憶體動作擴充功能的一部分（2.57.0 版或更高版本）。擴充功能會在您第一次執行 az storage-actions 工作 命令時自動安裝。深入了解擴充功能。

命令群組 'az storage-actions' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

管理儲存體 Task。

命令

名稱	Description	類型	狀態
az storage-actions task create	使用指定的參數建立新的記憶體工作資源。如果已建立記憶體工作，且後續的建立要求會以不同的屬性發出，則會更新記憶體工作屬性。如果已建立記憶體工作，且後續的建立要求會以完全相同的屬性集發出，要求將會成功。	副檔名	預覽
az storage-actions task delete	刪除記憶體工作資源。	副檔名	預覽
az storage-actions task list	列出訂用帳戶下可用的所有記憶體工作。	副檔名	預覽
az storage-actions task list-assignment	列出指定資源群組下所有可用的記憶體工作分派。	副檔名	預覽
az storage-actions task list-report	列出每個指派的記憶體工作執行報告摘要。	副檔名	預覽
az storage-actions task preview-action	針對輸入物件元資料屬性執行輸入條件，並在回應中指定相符的物件。	副檔名	預覽
az storage-actions task show	取得記憶體工作屬性。	副檔名	預覽
az storage-actions task update	使用指定的參數更新記憶體工作資源。如果已建立記憶體工作，且後續的更新要求會以不同的屬性發出，則會更新記憶體工作屬性。如果已建立記憶體工作，且後續的更新要求會以完全相同的屬性集發出，要求將會成功。	副檔名	預覽
az storage-actions task wait	將 CLI 置於等候狀態，直到符合條件為止。	副檔名	預覽

az storage-actions task create

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

使用指定的參數建立新的記憶體工作資源。如果已建立記憶體工作，且後續的建立要求會以不同的屬性發出，則會更新記憶體工作屬性。如果已建立記憶體工作，且後續的建立要求會以完全相同的屬性集發出，要求將會成功。

az storage-actions task create --action
                               --description
                               --enabled {0, 1, f, false, n, no, t, true, y, yes}
                               --identity
                               --name
                               --resource-group
                               [--location]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--tags]

範例

storage-actions 工作建立

az storage-actions task create -g rgteststorageactions -n testtask1 --identity "{type:SystemAssigned}" --tags "{key1:value1}" --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]',operations:[{name:'SetBlobTier',parameters:{tier:'Hot'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'DeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description StorageTask1 --enabled true

必要參數

--action

執行的記憶體工作動作支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--description

描述記憶體工作用途的文字。

--enabled

儲存體當設定為 true 且設定為 false 時停用工作。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--identity

資源的受控服務識別。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--location -l

未指定資源所在的地理位置，將會使用資源群組的位置。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--tags

資源標籤。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task delete

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

刪除記憶體工作資源。

az storage-actions task delete [--ids]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--resource-group]
                               [--subscription]
                               [--yes]

範例

storage-actions 工作刪除

az storage-actions task delete -g rgteststorageactions -n testtask1

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。您應該提供 --ids 或其他「資源識別碼」引數。

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task list

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

列出訂用帳戶下可用的所有記憶體工作。

az storage-actions task list [--max-items]
                             [--next-token]
                             [--resource-group]

範例

storage-actions 工作清單

az storage-actions task list -g rgteststorageactions

選擇性參數

--max-items

命令輸出中要傳回的項目總數。如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。若要繼續分頁，請在後續命令的自變數中 --next-token 提供令牌值。

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task list-assignment

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

列出指定資源群組下所有可用的記憶體工作分派。

az storage-actions task list-assignment --name
                                        --resource-group
                                        [--max-items]
                                        [--maxpagesize]
                                        [--next-token]

範例

storage-actions 工作清單工作分派

az storage-actions task list-assignment -g rgteststorageactions -n testtask1

必要參數

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--max-items

--maxpagesize

選擇性，指定要包含在清單回應中的記憶體工作分派標識子數目上限。

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task list-report

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

列出每個指派的記憶體工作執行報告摘要。

az storage-actions task list-report --name
                                    --resource-group
                                    [--filter]
                                    [--max-items]
                                    [--maxpagesize]
                                    [--next-token]

範例

storage-actions 工作 list-report

az storage-actions task list-report -g rgteststorageactions -n testtask1

必要參數

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--filter

選擇性。指定時，它可以用來使用報告屬性進行查詢。

--max-items

--maxpagesize

選擇性，指定要包含在清單回應中的記憶體工作分派標識子數目上限。

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task preview-action

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

針對輸入物件元資料屬性執行輸入條件，並在回應中指定相符的物件。

az storage-actions task preview-action --action
                                       --blobs
                                       --container
                                       [--ids]
                                       [--location]
                                       [--subscription]

範例

storage-actions 工作 preview-action

az storage-actions task preview-action -l eastus2euap --action "{if:{condition:'[[equals(AccessTier,'/Cool'/)]]'},else-block-exists:True}" --blobs "[{name:'folder2/file1.txt',properties:[{key:'Creation-Time',value:'Wed, 06 Jun 2023 05:23:29 GMT'},{key:'Last-Modified',value:'Wed, 06 Jun 2023 05:23:29 GMT'},{key:'Etag',value:'0x6FB67175454D36D'}],metadata:[{key:'mKey2',value:'mValue2'}],tags:[{key:'tKey2',value:'tValue2'}]}]" --container "{name:'firstContainer',metadata:[{key:'mContainerKey1',value:'mContainerValue1'}]}"

必要參數

--action

要測試符合所提供條件的預覽動作容器屬性。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--blobs

要測試符合所提供條件的預覽動作容器屬性。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--container

要測試符合所提供條件的預覽動作容器屬性。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

選擇性參數

--ids

--location -l

位置。來自的值： az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task show

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

取得記憶體工作屬性。

az storage-actions task show [--ids]
                             [--name]
                             [--resource-group]
                             [--subscription]

範例

storage-actions 工作顯示

az storage-actions task show -g rgteststorageactions -n testtask1

選擇性參數

--ids

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task update

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

使用指定的參數更新記憶體工作資源。如果已建立記憶體工作，且後續的更新要求會以不同的屬性發出，則會更新記憶體工作屬性。如果已建立記憶體工作，且後續的更新要求會以完全相同的屬性集發出，要求將會成功。

az storage-actions task update [--action]
                               [--add]
                               [--description]
                               [--enabled {0, 1, f, false, n, no, t, true, y, yes}]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--identity]
                               [--ids]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--remove]
                               [--resource-group]
                               [--set]
                               [--subscription]
                               [--tags]

範例

storage-actions 工作更新

az storage-actions task update -g rgteststorageactions -n testtask1 --identity "{type:SystemAssigned}" --tags "{key2:value2}" --action "{if:{condition:'[[equals(BlobType,'/BlockBlob'/)]]',operations:[{name:'SetBlobTags',parameters:{Archive-Status:'Archived'},onSuccess:'continue',onFailure:'break'}]},else:{operations:[{name:'UndeleteBlob',onSuccess:'continue',onFailure:'break'}]}}" --description StorageTask1Update --enabled true

選擇性參數

--action

執行的記憶體工作動作支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value、string 或 JSON 字串>。

--description

描述記憶體工作用途的文字。

--enabled

儲存體當設定為 true 且設為 false 時停用工作。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--identity

資源的受控服務識別。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--ids

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--remove

從清單中移除屬性或專案。範例：--remove property.list OR --remove 屬性ToRemove。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。範例：--set property1.property2=。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--tags

資源標籤。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az storage-actions task wait

預覽

命令群組 'az storage-actions task' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

將 CLI 置於等候狀態，直到符合條件為止。

az storage-actions task wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--ids]
                             [--interval]
                             [--name]
                             [--resource-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--ids

--interval

輪詢間隔以秒為單位。

預設值: 30

--name --storage-task-name -n

指定資源群組內的記憶體工作名稱。儲存體任務名稱長度必須介於 3 到 18 個字元之間，且只使用數位和小寫字母。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az storage-actions task

命令

az storage-actions task create

範例

必要參數

選擇性參數

az storage-actions task delete

範例

選擇性參數

az storage-actions task list

範例

選擇性參數

az storage-actions task list-assignment

範例

必要參數

選擇性參數

az storage-actions task list-report

範例

必要參數

選擇性參數

az storage-actions task preview-action

範例

必要參數

選擇性參數

az storage-actions task show

範例

選擇性參數

az storage-actions task update

範例

選擇性參數

az storage-actions task wait

選擇性參數

其他資源