Share via

az containerapp job

  • 參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理容器應用程式作業的命令。

命令

名稱 Description 類型 狀態
az containerapp job create

建立容器應用程式作業。

 核心 GA
az containerapp job create (containerapp 擴充功能)

建立容器應用程式作業。

 副檔名 GA
az containerapp job delete

刪除容器應用程式作業。

 核心 GA
az containerapp job delete (containerapp 擴充功能)

刪除容器應用程式作業。

 副檔名 GA
az containerapp job execution

用來檢視容器應用程式作業執行的命令。

 核心 GA
az containerapp job execution list

取得容器應用程式作業的所有執行清單。

 核心 GA
az containerapp job execution show

取得容器應用程式作業的執行。

 核心 GA
az containerapp job identity

管理容器應用程式作業受控識別的命令。

 核心 GA
az containerapp job identity assign

將受控識別指派給容器應用程式作業。

 核心 GA
az containerapp job identity remove

從容器應用程式作業中移除受控識別。

 核心 GA
az containerapp job identity show

顯示容器應用程式作業的受控識別。

 核心 GA
az containerapp job list

依訂用帳戶或資源群組列出容器應用程式作業。

 核心 GA
az containerapp job list (containerapp 擴充功能)

依訂用帳戶或資源群組列出容器應用程式作業。

 副檔名 GA
az containerapp job secret

管理秘密的命令。

 核心 GA
az containerapp job secret list

列出容器應用程式作業的秘密。

 核心 GA
az containerapp job secret remove

從容器應用程式作業移除秘密。

 核心 GA
az containerapp job secret set

建立/更新秘密。

 核心 GA
az containerapp job secret show

顯示秘密的詳細數據。

 核心 GA
az containerapp job show

顯示容器應用程式作業的詳細數據。

 核心 GA
az containerapp job show (containerapp 擴充功能)

顯示容器應用程式作業的詳細數據。

 副檔名 GA
az containerapp job start

啟動容器應用程式作業執行。

 核心 GA
az containerapp job stop

停止容器應用程式作業執行。

 核心 GA
az containerapp job update

更新容器應用程式作業。

 核心 GA

az containerapp job create

編輯

建立容器應用程式作業。

az containerapp job create --name
                           --resource-group
                           [--args]
                           [--command]
                           [--container-name]
                           [--cpu]
                           [--cron-expression]
                           [--env-vars]
                           [--environment]
                           [--image]
                           [--max-executions]
                           [--memory]
                           [--mi-system-assigned]
                           [--mi-user-assigned]
                           [--min-executions]
                           [--no-wait]
                           [--parallelism]
                           [--polling-interval]
                           [--rcc]
                           [--registry-identity]
                           [--registry-password]
                           [--registry-server]
                           [--registry-username]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--scale-rule-auth]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--secrets]
                           [--tags]
                           [--trigger-type]
                           [--workload-profile-name]
                           [--yaml]

範例

使用 [觸發程序類型] 做為 [手動] 建立容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --trigger-type Manual \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image imageName \
    --workload-profile-name my-wlp

建立具有觸發程式類型為排程的容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --trigger-type Schedule \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --cron-expression "*/1 * * * *" \
    --image imageName

使用觸發程式類型做為事件建立容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --trigger-type Event \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --polling-interval 30 \
    --min-executions 0 \
    --max-executions 1 \
    --scale-rule-name queueJob \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength": "5" "queueName": "foo" \
    --scale-rule-auth "connection=my-connection-string-secret-name" \
    --image imageName

必要參數

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

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

選擇性參數

--args

容器啟動命令自變數的清單。 以空格分隔的值，例如 “-c” “mycommand”。 空字串可清除現有的值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值，例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU，從0.25 - 2.0，例如0.5。

--cron-expression

Cron 運算式。 僅支援觸發程式類型 「排程」。

--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref：' 作為參考秘密的前置詞值。

--environment

容器應用程式環境的名稱或資源識別碼。

--image

容器映射，例如 publisher/image-name：tag。

--max-executions

每個輪詢間隔要執行的作業執行數目上限。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾，例如 1.0Gi。

--mi-system-assigned

布爾值，指出是否指派系統指派的身分識別。

預設值: False
--mi-user-assigned

要指派的空間分隔使用者身分識別。

--min-executions

每個輪詢間隔執行的作業執行數目下限。

--no-wait

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

預設值: False
--parallelism

每個執行所要執行的複本數目上限。

--polling-interval

以秒為單位檢查每個事件來源的間隔。 預設值為 30s。

--rcc --replica-completion-count

需要成功完成才能成功執行的複本數目。

--registry-identity

使用登錄伺服器進行驗證的受控識別，而不是使用者名稱/密碼。 分別針對使用者定義和系統定義的身分識別使用資源標識碼或「系統」。 登錄必須是 ACR。 可能的話，系統會自動為身分識別建立「acrpull」角色 assignemnt。

--registry-password

登入容器登錄的密碼。 如果儲存為秘密，值必須以 'secretref：' 開頭，後面接著秘密名稱。

--registry-server

容器登錄伺服器主機名，例如 myregistry.azurecr.io。

--registry-username

要登入容器登錄的用戶名稱。

--replica-retry-limit

複本失敗之前重試次數上限。

--replica-timeout

復本可以執行的秒數上限。

--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。

--secrets -s

容器應用程式的秘密清單。 以 『key=value』 格式分隔的空間值。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--trigger-type

觸發程式類型。 排程 |事件 |手動。

--workload-profile-name -w

工作負載配置檔的易記名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例，請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全域參數
--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 containerapp job create (containerapp 擴充功能)

建立容器應用程式作業。

az containerapp job create --name
                           --resource-group
                           [--args]
                           [--command]
                           [--container-name]
                           [--cpu]
                           [--cron-expression]
                           [--env-vars]
                           [--environment]
                           [--environment-type {connected, managed}]
                           [--image]
                           [--max-executions]
                           [--memory]
                           [--mi-system-assigned]
                           [--mi-user-assigned]
                           [--min-executions]
                           [--no-wait]
                           [--parallelism]
                           [--polling-interval]
                           [--rcc]
                           [--registry-identity]
                           [--registry-password]
                           [--registry-server]
                           [--registry-username]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--scale-rule-auth]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--secrets]
                           [--tags]
                           [--trigger-type]
                           [--workload-profile-name]
                           [--yaml]

範例

使用 [觸發程序類型] 做為 [手動] 建立容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappEnv
    --trigger-type Manual \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image imageName \
    --workload-profile-name my-wlp

建立具有觸發程式類型為排程的容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappEnv
    --trigger-type Schedule \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --cron-expression "*/1 * * * *" \
    --image imageName

使用觸發程式類型做為事件建立容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappEnv
    --trigger-type Event \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --polling-interval 30 \
    --min-executions 0 \
    --max-executions 1 \
    --scale-rule-name queueJob \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength": "5" "queueName": "foo" \
    --scale-rule-auth "connection=my-connection-string-secret-name" \
    --image imageName

建立裝載於 連線 環境的容器應用程式作業。

az containerapp job create -n MyContainerappsjob -g MyResourceGroup \
    --environment MyContainerappConnectedEnv
    --environment-type connected
    --trigger-type Manual \
    --replica-timeout 5 \
    --replica-retry-limit 2 \
    --replica-completion-count 1 \
    --parallelism 1 \
    --image imageName \
    --workload-profile-name my-wlp

必要參數

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

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

選擇性參數

--args

容器啟動命令自變數的清單。 以空格分隔的值，例如 “-c” “mycommand”。 空字串可清除現有的值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值，例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU，從0.25 - 2.0，例如0.5。

--cron-expression

Cron 運算式。 僅支援觸發程式類型 「排程」。

--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref：' 作為參考秘密的前置詞值。

--environment

容器應用程式環境的名稱或資源識別碼。

--environment-type
預覽

環境類型。

接受的值: connected, managed
預設值: managed
--image

容器映射，例如 publisher/image-name：tag。

--max-executions

為觸發程式建立的作業執行數目上限。

預設值: 100
--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾，例如 1.0Gi。

--mi-system-assigned

布爾值，指出是否指派系統指派的身分識別。

預設值: False
--mi-user-assigned

要指派的空間分隔使用者身分識別。

--min-executions

為觸發程式建立的作業執行數目下限。 預設：0。

預設值: 0
--no-wait

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

預設值: False
--parallelism

每個執行所要執行的複本數目上限。

預設值: 1
--polling-interval

以秒為單位檢查每個事件來源的間隔。

預設值: 30
--rcc --replica-completion-count

需要成功完成才能成功執行的複本數目。

預設值: 1
--registry-identity

使用登錄伺服器進行驗證的受控識別，而不是使用者名稱/密碼。 分別針對使用者定義和系統定義的身分識別使用資源標識碼或「系統」。 登錄必須是 ACR。 可能的話，系統會自動為身分識別建立「acrpull」角色 assignemnt。

--registry-password

登入容器登錄的密碼。 如果儲存為秘密，值必須以 'secretref：' 開頭，後面接著秘密名稱。

--registry-server

容器登錄伺服器主機名，例如 myregistry.azurecr.io。

--registry-username

要登入容器登錄的用戶名稱。

--replica-retry-limit

複本失敗之前重試次數上限。 預設：0。

預設值: 0
--replica-timeout

復本可以執行的秒數上限。

預設值: 1800
--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。

--secrets -s

容器應用程式的秘密清單。 以 『key=value』 格式分隔的空間值。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--trigger-type

觸發程式類型。 排程 |事件 |手動。

--workload-profile-name -w

工作負載配置檔的易記名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例，請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全域參數
--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 containerapp job delete

編輯

刪除容器應用程式作業。

az containerapp job delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--yes]

範例

刪除作業。

az containerapp job delete -n my-containerapp-job -g MyResourceGroup

選擇性參數

--ids

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

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

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

預設值: False
--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 containerapp job delete (containerapp 擴充功能)

刪除容器應用程式作業。

az containerapp job delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--yes]

範例

刪除作業。

az containerapp job delete -n my-containerapp-job -g MyResourceGroup

選擇性參數

--ids

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

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

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

預設值: False
--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 containerapp job list

編輯

依訂用帳戶或資源群組列出容器應用程式作業。

az containerapp job list [--resource-group]

範例

列出目前訂用帳戶中的作業。

az containerapp job list

依資源群組列出環境。

az containerapp job list -g MyResourceGroup

選擇性參數

--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 containerapp job list (containerapp 擴充功能)

依訂用帳戶或資源群組列出容器應用程式作業。

az containerapp job list [--resource-group]

範例

列出目前訂用帳戶中的作業。

az containerapp job list

依資源群組列出環境。

az containerapp job list -g MyResourceGroup

選擇性參數

--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 containerapp job show

編輯

顯示容器應用程式作業的詳細數據。

az containerapp job show [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

範例

顯示作業的詳細數據。

az containerapp job show -n my-containerapp-job -g MyResourceGroup

選擇性參數

--ids

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

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--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 containerapp job show (containerapp 擴充功能)

顯示容器應用程式作業的詳細數據。

az containerapp job show [--ids]
                         [--name]
                         [--resource-group]
                         [--subscription]

範例

顯示作業的詳細數據。

az containerapp job show -n my-containerapp-job -g MyResourceGroup

選擇性參數

--ids

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

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--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 containerapp job start

編輯

啟動容器應用程式作業執行。

az containerapp job start [--args]
                          [--command]
                          [--container-name]
                          [--cpu]
                          [--env-vars]
                          [--ids]
                          [--image]
                          [--memory]
                          [--name]
                          [--no-wait]
                          [--registry-identity]
                          [--resource-group]
                          [--subscription]
                          [--yaml]

範例

啟動作業執行。

az containerapp job start -n my-containerapp-job -g MyResourceGroup

使用不同的映像和組態啟動作業。

az containerapp job start -n my-containerapp-job -g MyResourceGroup --image MyImageName --cpu 0.5 --memory 1.0Gi

選擇性參數

--args

容器啟動命令自變數的清單。 以空格分隔的值，例如 “-c” “mycommand”。 空字串可清除現有的值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值，例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU，從0.25 - 2.0，例如0.5。

--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref：' 作為參考秘密的前置詞值。

--ids

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

--image

容器映射，例如 publisher/image-name：tag。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾，例如 1.0Gi。

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

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

預設值: False
--registry-identity

使用登錄伺服器進行驗證的受控識別，而不是使用者名稱/密碼。 分別針對使用者定義和系統定義的身分識別使用資源標識碼或「系統」。 登錄必須是 ACR。 可能的話，系統會自動為身分識別建立「acrpull」角色 assignemnt。

--resource-group -g

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

--subscription

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

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例，請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全域參數
--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 containerapp job stop

編輯

停止容器應用程式作業執行。

az containerapp job stop [--execution-name-list]
                         [--ids]
                         [--job-execution-name]
                         [--name]
                         [--no-wait]
                         [--resource-group]
                         [--subscription]

範例

停止作業執行。

az containerapp job stop -n my-containerapp-job -g MyResourceGroup

停止提供特定作業執行名稱的作業執行。

az containerapp job stop -n my-containerapp-job -g MyResourceGroup --job-execution-name MyContainerAppJob-66v9xh0

停止多個作業執行，並提供執行名稱的清單。

az containerapp job stop -n my-containerapp-job -g MyResourceGroup --execution-name-list MyContainerAppJob-66v9xh0,MyContainerAppJob-66v9xh1

選擇性參數

--execution-name-list

作業執行名稱的逗號分隔清單。

--ids

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

--job-execution-name

需要停止的特定作業執行名稱。

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

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

預設值: False
--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 containerapp job update

編輯

更新容器應用程式作業。

az containerapp job update [--args]
                           [--command]
                           [--container-name]
                           [--cpu]
                           [--cron-expression]
                           [--ids]
                           [--image]
                           [--max-executions]
                           [--memory]
                           [--min-executions]
                           [--name]
                           [--no-wait]
                           [--parallelism]
                           [--polling-interval]
                           [--rcc]
                           [--remove-all-env-vars]
                           [--remove-env-vars]
                           [--replace-env-vars]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--resource-group]
                           [--scale-rule-auth]
                           [--scale-rule-metadata]
                           [--scale-rule-name]
                           [--scale-rule-type]
                           [--set-env-vars]
                           [--subscription]
                           [--tags]
                           [--workload-profile-name]
                           [--yaml]

範例

更新作業的複本逾時。

az containerapp job update -n my-containerapp-job -g MyResourceGroup \
    --replica-timeout 10

選擇性參數

--args

容器啟動命令自變數的清單。 以空格分隔的值，例如 “-c” “mycommand”。 空字串可清除現有的值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值，例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU，從0.25 - 2.0，例如0.5。

--cron-expression

Cron 運算式。 僅支援觸發程式類型 「排程」。

--ids

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

--image

容器映射，例如 publisher/image-name：tag。

--max-executions

每個輪詢間隔要執行的作業執行數目上限。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾，例如 1.0Gi。

--min-executions

每個輪詢間隔執行的作業執行數目下限。

--name -n

Container Apps 作業的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

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

預設值: False
--parallelism

每個執行所要執行的複本數目上限。

--polling-interval

以秒為單位檢查每個事件來源的間隔。 預設值為 30s。

--rcc --replica-completion-count

需要成功完成才能成功執行的複本數目。

--remove-all-env-vars

從 container 移除所有環境變數。。

預設值: False
--remove-env-vars

從容器中移除環境變數。 以空格分隔的環境變數名稱。

--replace-env-vars

取代容器中的環境變數。 拿掉其他現有的環境變數。 以 『key=value』 格式分隔的空間值。 如果儲存為秘密，值必須以 'secretref：' 開頭，後面接著秘密名稱。

--replica-retry-limit

複本失敗之前重試次數上限。

--replica-timeout

復本可以執行的秒數上限。

--resource-group -g

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

--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。

--set-env-vars

在容器中新增或更新環境變數。 不會修改現有的環境變數。 以 『key=value』 格式分隔的空間值。 如果儲存為秘密，值必須以 'secretref：' 開頭，後面接著秘密名稱。

--subscription

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

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--workload-profile-name -w

工作負載配置檔的易記名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例，請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples。

全域參數
--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 來取得完整偵錯記錄。