az containerapp job

Note

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

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

命令

名稱	Description	類型	狀態
az containerapp job create	建立容器應用程式作業。	Core	GA
az containerapp job create (containerapp 擴充功能)	建立容器應用程式作業。	Extension	GA
az containerapp job delete	刪除容器應用程式作業。	Core	GA
az containerapp job delete (containerapp 擴充功能)	刪除容器應用程式作業。	Extension	GA
az containerapp job execution	用來檢視容器應用程式作業執行的命令。	Core	GA
az containerapp job execution list	取得容器應用程式作業的所有執行清單。	Core	GA
az containerapp job execution show	取得容器應用程式作業的執行。	Core	GA
az containerapp job identity	管理容器應用程式作業受控識別的命令。	Core	GA
az containerapp job identity assign	將受控識別指派給容器應用程式作業。	Core	GA
az containerapp job identity remove	從容器應用程式作業中移除受控識別。	Core	GA
az containerapp job identity show	顯示容器應用程式作業的受控識別。	Core	GA
az containerapp job list	依訂用帳戶或資源群組列出容器應用程式作業。	Core	GA
az containerapp job list (containerapp 擴充功能)	依訂用帳戶或資源群組列出容器應用程式作業。	Extension	GA
az containerapp job logs	顯示容器應用程式作業記錄。	Extension	Preview
az containerapp job logs show	實時顯示過去的記錄和/或列印記錄（使用 --follow 參數）。 請注意，記錄只會取自一個執行、複本和容器。	Extension	Preview
az containerapp job registry	用來管理容器應用程式作業之容器登錄資訊的命令。	核心和擴充功能	Preview
az containerapp job registry list	列出容器應用程式作業中設定的容器登錄。	Core	Preview
az containerapp job registry remove	拿掉容器應用程式作業中的容器登錄詳細數據。	Core	Preview
az containerapp job registry set	在容器應用程式作業中新增或更新容器登錄的詳細數據。	Core	Preview
az containerapp job registry set (containerapp 擴充功能)	在容器應用程式作業中新增或更新容器登錄的詳細數據。	Extension	Preview
az containerapp job registry show	從容器應用程式作業顯示容器登錄的詳細數據。	Core	Preview
az containerapp job replica	管理容器應用程式複本。	Extension	Preview
az containerapp job replica list	列出容器應用程式作業執行的複本。	Extension	Preview
az containerapp job secret	管理秘密的命令。	Core	GA
az containerapp job secret list	列出容器應用程式作業的秘密。	Core	GA
az containerapp job secret remove	從容器應用程式作業移除秘密。	Core	GA
az containerapp job secret set	建立/更新秘密。	Core	GA
az containerapp job secret show	顯示秘密的詳細數據。	Core	GA
az containerapp job show	顯示容器應用程式作業的詳細數據。	Core	GA
az containerapp job show (containerapp 擴充功能)	顯示容器應用程式作業的詳細數據。	Extension	GA
az containerapp job start	啟動容器應用程式作業執行。	Core	GA
az containerapp job stop	停止容器應用程式作業執行。	Core	GA
az containerapp job update	更新容器應用程式作業。	Core	GA
az containerapp job update (containerapp 擴充功能)	更新容器應用程式作業。	Extension	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 --replica-completion-count]
                           [--registry-identity]
                           [--registry-password]
                           [--registry-server]
                           [--registry-username]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--scale-rule-auth --sra]
                           [--scale-rule-metadata --srm]
                           [--scale-rule-name --srn]
                           [--scale-rule-type --srt]
                           [--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 queue \
    --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”。 空字串可清除現有的值。

屬性	值
參數群組:	Container Arguments

--command

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

屬性	值
參數群組:	Container Arguments

--container-name

容器的名稱。

屬性	值
參數群組:	Container Arguments

--cpu

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

屬性	值
參數群組:	Container Arguments

--cron-expression

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

--env-vars

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

屬性	值
參數群組:	Container Arguments

--environment

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

--image

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

--max-executions

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

屬性	值
參數群組:	Scale Arguments

--memory

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

屬性	值
參數群組:	Container Arguments

--mi-system-assigned

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

屬性	值
預設值:	False

--mi-user-assigned

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

--min-executions

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

屬性	值
參數群組:	Scale Arguments

--no-wait

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

屬性	值
預設值:	False

--parallelism

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

--polling-interval

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

屬性	值
參數群組:	Scale Arguments

--rcc --replica-completion-count

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

--registry-identity

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

屬性	值
參數群組:	Configuration Arguments

--registry-password

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

屬性	值
參數群組:	Configuration Arguments

--registry-server

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

屬性	值
參數群組:	Configuration Arguments

--registry-username

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

屬性	值
參數群組:	Configuration Arguments

--replica-retry-limit

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

--replica-timeout

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

--scale-rule-auth --sra

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-metadata --srm

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-name --srn

調整規則的名稱。

屬性	值
參數群組:	Scale Arguments

--scale-rule-type --srt

縮放規則的類型。

屬性	值
參數群組:	Scale Arguments

--secrets -s

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

屬性	值
參數群組:	Configuration Arguments

--tags

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

--trigger-type

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

--workload-profile-name -w

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

--yaml

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 --replica-completion-count]
                           [--registry-identity]
                           [--registry-password]
                           [--registry-server]
                           [--registry-username]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--scale-rule-auth --sra]
                           [--scale-rule-identity --sri]
                           [--scale-rule-metadata --srm]
                           [--scale-rule-name --srn]
                           [--scale-rule-type --srt]
                           [--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 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 azure-queue \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength=5" "queueName=foo" \
    --scale-rule-identity myUserIdentityResourceId \
    --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”。 空字串可清除現有的值。

屬性	值
參數群組:	Container Arguments

--command

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

屬性	值
參數群組:	Container Arguments

--container-name

容器的名稱。

屬性	值
參數群組:	Container Arguments

--cpu

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

屬性	值
參數群組:	Container Arguments

--cron-expression

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

--env-vars

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

屬性	值
參數群組:	Container Arguments

--environment

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

--environment-type

預覽

環境類型。

屬性	值
預設值:	managed
接受的值:	connected, managed

--image

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

--max-executions

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

屬性	值
參數群組:	Scale Arguments
預設值:	100

--memory

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

屬性	值
參數群組:	Container Arguments

--mi-system-assigned

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

屬性	值
預設值:	False

--mi-user-assigned

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

--min-executions

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

屬性	值
參數群組:	Scale Arguments
預設值:	0

--no-wait

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

屬性	值
預設值:	False

--parallelism

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

屬性	值
預設值:	1

--polling-interval

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

屬性	值
參數群組:	Scale Arguments
預設值:	30

--rcc --replica-completion-count

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

屬性	值
預設值:	1

--registry-identity

要向 Azure Container Registry 進行驗證的受控識別（而不是使用者名稱/密碼）。 針對系統定義的身分識別使用 『system』、針對環境層級系統定義的身分識別使用 'system-environment' 或使用者定義環境/containerappjob 層級身分識別的資源標識符。 在部署之前，受控識別應該已在 ACR 上指派 acrpull 許可權（使用 'az role assignment create --role acrpull ...'）。

屬性	值
參數群組:	Configuration Arguments

--registry-password

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

屬性	值
參數群組:	Configuration Arguments

--registry-server

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

屬性	值
參數群組:	Configuration Arguments

--registry-username

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

屬性	值
參數群組:	Configuration Arguments

--replica-retry-limit

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

屬性	值
預設值:	0

--replica-timeout

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

屬性	值
預設值:	1800

--scale-rule-auth --sra

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-identity --sri

預覽

使用 Azure Scaler 資源進行驗證的受控識別資源識別碼（記憶體帳戶/eventhub 或其他），或使用系統指派的身分識別。

屬性	值
參數群組:	Scale Arguments

--scale-rule-metadata --srm

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-name --srn

調整規則的名稱。

屬性	值
參數群組:	Scale Arguments

--scale-rule-type --srt

縮放規則的類型。

屬性	值
參數群組:	Scale Arguments

--secrets -s

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

屬性	值
參數群組:	Configuration Arguments

--tags

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

--trigger-type

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

--workload-profile-name -w

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

--yaml

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 或其他「資源識別碼」自變數。

屬性	值
參數群組:	Resource Id Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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”。 空字串可清除現有的值。

屬性	值
參數群組:	Container Arguments

--command

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

屬性	值
參數群組:	Container Arguments

--container-name

容器的名稱。

屬性	值
參數群組:	Container Arguments

--cpu

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

屬性	值
參數群組:	Container Arguments

--env-vars

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

屬性	值
參數群組:	Container Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--image

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

--memory

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

屬性	值
參數群組:	Container Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--registry-identity

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

屬性	值
參數群組:	Configuration Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--yaml

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az containerapp job stop

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

az containerapp job stop [--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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--job-execution-name

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

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

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 --replica-completion-count]
                           [--remove-all-env-vars]
                           [--remove-env-vars]
                           [--replace-env-vars]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--resource-group]
                           [--scale-rule-auth --sra]
                           [--scale-rule-metadata --srm]
                           [--scale-rule-name --srn]
                           [--scale-rule-type --srt]
                           [--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”。 空字串可清除現有的值。

屬性	值
參數群組:	Container Arguments

--command

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

屬性	值
參數群組:	Container Arguments

--container-name

容器的名稱。

屬性	值
參數群組:	Container Arguments

--cpu

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

屬性	值
參數群組:	Container Arguments

--cron-expression

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--image

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

--max-executions

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

屬性	值
參數群組:	Scale Arguments

--memory

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

屬性	值
參數群組:	Container Arguments

--min-executions

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

屬性	值
參數群組:	Scale Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--parallelism

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

--polling-interval

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

屬性	值
參數群組:	Scale Arguments

--rcc --replica-completion-count

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

--remove-all-env-vars

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

屬性	值
參數群組:	Environment variables Arguments
預設值:	False

--remove-env-vars

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

屬性	值
參數群組:	Environment variables Arguments

--replace-env-vars

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

屬性	值
參數群組:	Environment variables Arguments

--replica-retry-limit

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

--replica-timeout

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

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--scale-rule-auth --sra

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-metadata --srm

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-name --srn

調整規則的名稱。

屬性	值
參數群組:	Scale Arguments

--scale-rule-type --srt

縮放規則的類型。

屬性	值
參數群組:	Scale Arguments

--set-env-vars

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

屬性	值
參數群組:	Environment variables Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

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

--workload-profile-name -w

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

--yaml

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az containerapp job update (containerapp 擴充功能)

更新容器應用程式作業。

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 --replica-completion-count]
                           [--remove-all-env-vars]
                           [--remove-env-vars]
                           [--replace-env-vars]
                           [--replica-retry-limit]
                           [--replica-timeout]
                           [--resource-group]
                           [--scale-rule-auth --sra]
                           [--scale-rule-identity --sri]
                           [--scale-rule-metadata --srm]
                           [--scale-rule-name --srn]
                           [--scale-rule-type --srt]
                           [--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”。 空字串可清除現有的值。

屬性	值
參數群組:	Container Arguments

--command

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

屬性	值
參數群組:	Container Arguments

--container-name

容器的名稱。

屬性	值
參數群組:	Container Arguments

--cpu

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

屬性	值
參數群組:	Container Arguments

--cron-expression

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--image

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

--max-executions

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

屬性	值
參數群組:	Scale Arguments

--memory

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

屬性	值
參數群組:	Container Arguments

--min-executions

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

屬性	值
參數群組:	Scale Arguments

--name -n

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

屬性	值
預設值:	False

--parallelism

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

--polling-interval

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

屬性	值
參數群組:	Scale Arguments

--rcc --replica-completion-count

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

--remove-all-env-vars

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

屬性	值
參數群組:	Environment variables Arguments
預設值:	False

--remove-env-vars

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

屬性	值
參數群組:	Environment variables Arguments

--replace-env-vars

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

屬性	值
參數群組:	Environment variables Arguments

--replica-retry-limit

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

--replica-timeout

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

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--scale-rule-auth --sra

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-identity --sri

預覽

使用 Azure Scaler 資源進行驗證的受控識別資源識別碼（記憶體帳戶/eventhub 或其他），或使用系統指派的身分識別。

屬性	值
參數群組:	Scale Arguments

--scale-rule-metadata --srm

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

屬性	值
參數群組:	Scale Arguments

--scale-rule-name --srn

調整規則的名稱。

屬性	值
參數群組:	Scale Arguments

--scale-rule-type --srt

縮放規則的類型。

屬性	值
參數群組:	Scale Arguments

--set-env-vars

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

屬性	值
參數群組:	Environment variables Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

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

--workload-profile-name -w

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

--yaml

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False