az nginx deployment

參考

注意

此參考是 Azure CLI nginx 延伸模組的一部分（2.68.0 版或更高版本）。擴充功能會在您第一次執行 az nginx deployment 命令時自動安裝。深入瞭解擴充功能。

管理 NGINX 部署資源。

命令

名稱	Description	類型	狀態
az nginx deployment api-key	管理 Nginxaas 部署 API 金鑰。	外延	加語
az nginx deployment api-key create	建立 Nginx 部署的 API 金鑰，以存取數據平面 API 端點。	外延	加語
az nginx deployment api-key delete	刪除 Nginx 部署的 API 金鑰。	外延	加語
az nginx deployment api-key list	列出指定 Nginx 部署的所有 API 金鑰。	外延	加語
az nginx deployment api-key show	取得指定 Nginx 部署的指定 API 金鑰。	外延	加語
az nginx deployment api-key update	更新 Nginx 部署的 API 金鑰，以存取資料平面 API 端點。	外延	加語
az nginx deployment certificate	管理 NGINX 憑證資源。	外延	加語
az nginx deployment certificate create	建立 NGINX 部署的憑證。	外延	加語
az nginx deployment certificate delete	刪除 NGINX 部署憑證。	外延	加語
az nginx deployment certificate list	列出指定部署和資源群組下的所有憑證。	外延	加語
az nginx deployment certificate show	取得特定 NGINX 憑證的屬性。	外延	加語
az nginx deployment certificate update	更新 NGINX 部署憑證。	外延	加語
az nginx deployment certificate wait	將 CLI 置於等候狀態，直到符合條件為止。	外延	加語
az nginx deployment configuration	管理 NGINX 組態資源。	外延	加語
az nginx deployment configuration analyze	分析 NGINX 組態，而不將其套用至 NGINXaaS 部署。	外延	加語
az nginx deployment configuration create	建立 NGINX 部署的組態。	外延	加語
az nginx deployment configuration delete	刪除 Nginx 組態。	外延	加語
az nginx deployment configuration list	列出指定部署和資源群組下的所有組態。	外延	加語
az nginx deployment configuration show	取得特定 NGINX 組態的屬性。	外延	加語
az nginx deployment configuration update	更新 NGINX 組態。	外延	加語
az nginx deployment configuration wait	將 CLI 置於等候狀態，直到符合條件為止。	外延	加語
az nginx deployment create	建立適用於 Azure 資源的 NGINX。	外延	加語
az nginx deployment delete	刪除 NGINX 部署。	外延	加語
az nginx deployment list	NGINX 部署清單。	外延	加語
az nginx deployment show	取得特定 NGINX 部署的屬性。	外延	加語
az nginx deployment update	更新 NGINX 部署。	外延	加語
az nginx deployment wait	將 CLI 置於等候狀態，直到符合條件為止。	外延	加語

az nginx deployment create

建立適用於 Azure 資源的 NGINX。

az nginx deployment create --deployment-name
                           --resource-group
                           [--auto-upgrade-profile]
                           [--enable-diagnostics {0, 1, f, false, n, no, t, true, y, yes}]
                           [--identity]
                           [--location]
                           [--logging]
                           [--network-profile]
                           [--nginx-app-protect]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--scaling-properties]
                           [--sku]
                           [--tags]
                           [--user-profile]

範例

使用 PublicIP 建立部署

az nginx deployment create --name myDeployment --resource-group myResourceGroup --location eastus2 --sku name="standard_Monthly_gmz7xq9ge3py" --network-profile front-end-ip-configuration="{public-ip-addresses:[{id:/subscriptions/mySubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/publicIPAddresses/myPublicIP}]}" network-interface-configuration="{subnet-id:/subscriptions/mySubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet}"

使用 PrivateIP 建立部署

az nginx deployment create --name myDeployment --resource-group myResourceGroup --location eastus2 --sku name="standard_Monthly_gmz7xq9ge3py" --network-profile front-end-ip-configuration="{private-ip-addresses:[{private-ip-allocation-method:Static,subnet-id:/subscriptions/mySubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet,private-ip-address:10.0.0.2}]}" network-interface-configuration="{subnet-id:/subscriptions/mySubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet}"
az nginx deployment create --name myDeployment --resource-group myResourceGroup --location eastus2 --sku name="standard_Monthly_gmz7xq9ge3py" --network-profile front-end-ip-configuration="{private-ip-addresses:[{private-ip-allocation-method:Dynamic,subnet-id:/subscriptions/mySubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet,private-ip-address:10.0.0.2}]}" network-interface-configuration="{subnet-id:/subscriptions/mySubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet}"

使用受控識別、記憶體帳戶和調整進行部署

az anginx deployment  create --deployment-name myDeployment --myResourceGroup azclitest-geo --location eastus --sku name=standard_Monthly_gmz7xq9ge3py --network-profile network-interface-configuration='{subnet-id:/subscriptions/subscriptionId/resourcegroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-azclitest/subnets/mySubnet}' front-end-ip-configuration='{public-ip-addresses:[{id:/subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.Network/publicIPAddresses/myPublicIP}]}' --identity '{"type":"UserAssigned","userAssignedIdentities":{"/subscriptions/subscriptionId/resourcegroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myManagedIdentity":{}}}' --logging storage-account='{"account-name":"myStorageAccount","container-name":"myContainer"}' --scaling-properties capacity=10

使用受控識別、記憶體帳戶和系統指派的受控識別進行部署

az az anginx deployment create --deployment-name myDeployment --myResourceGroup azclitest-geo --location eastus --sku name=standard_Monthly_gmz7xq9ge3py --network-profile network-interface-configuration='{subnet-id:/subscriptions/subscriptionId/resourcegroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/vnet-azclitest/subnets/mySubnet}' front-end-ip-configuration='{public-ip-addresses:[{id:/subscriptions/subscriptionId/resourceGroups/myResourceGroup/providers/Microsoft.Network/publicIPAddresses/myPublicIP}]}' --identity '{"type":"SystemAssigned"}' --logging storage-account='{"account-name":"myStorageAccount","container-name":"myContainer"}' --scaling-properties capacity=10

必要參數

--deployment-name --name -n

目標 NGINX 部署的名稱。

--resource-group -g

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

選擇性參數

--auto-upgrade-profile

部署的自動升級設定。可以是穩定或預覽支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--enable-diagnostics

布爾值可啟用/停用診斷支援。

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

--identity

在 Azure 金鑰保存庫或記憶體帳戶上執行作業的受控識別支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--location -l

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

--logging

若要將記錄傳送至您的記憶體帳戶。必須在 Azure 記憶體帳戶上指定具有 Blob 參與者角色的受控識別支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--network-profile

IP 位址和 VNet + 子網資訊支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--nginx-app-protect

NGINX 應用程式保護（NAP）的設定支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--no-wait

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

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

--scaling-properties

調整 NGINX 容量單位（NCU）支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--sku

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

--tags

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

--user-profile

選擇性：慣用通訊電子郵件支援速記語法、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 nginx deployment delete

刪除 NGINX 部署。

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

範例

部署刪除

az nginx deployment delete --name myDeployment --resource-group myResourceGroup

選擇性參數

--deployment-name --name -n

目標 NGINX 部署的名稱。

--ids

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

--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 nginx deployment list

NGINX 部署清單。

列出指定訂用帳戶下的所有部署。列出指定資源群組下的所有 Nginx 部署。

az nginx deployment list [--max-items]
                         [--next-token]
                         [--resource-group]

範例

部署清單

az nginx deployment list
az nginx deployment list --resource-group myResourceGroup

選擇性參數

--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 nginx deployment show

取得特定 NGINX 部署的屬性。

az nginx deployment show [--deployment-name]
                         [--ids]
                         [--resource-group]
                         [--subscription]

範例

部署取得

az nginx deployment show --name myDeployment --resource-group myResourceGroup

選擇性參數

--deployment-name --name -n

目標 Nginx 部署的名稱。

--ids

--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 nginx deployment update

更新 NGINX 部署。

az nginx deployment update [--add]
                           [--auto-upgrade-profile]
                           [--deployment-name]
                           [--enable-diagnostics {0, 1, f, false, n, no, t, true, y, yes}]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--identity]
                           [--ids]
                           [--logging]
                           [--network-profile]
                           [--nginx-app-protect]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--remove]
                           [--resource-group]
                           [--scaling-properties]
                           [--set]
                           [--sku]
                           [--subscription]
                           [--tags]
                           [--user-profile]

範例

更新標籤並啟用部署的診斷支援

az nginx deployment update --name myDeployment --resource-group myResourceGroup --location eastus2 --tags tag1="value1" tag2="value2" --enable-diagnostics

選擇性參數

--add

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

--auto-upgrade-profile

部署的自動升級設定。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--deployment-name --name -n

目標 Nginx 部署的名稱。

--enable-diagnostics

布爾值可啟用/停用診斷支援。

接受的值: 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

在 Azure 金鑰保存庫或記憶體帳戶上執行作業的受控識別支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--ids

--logging

--network-profile

IP 位址和 VNet + 子網資訊支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--nginx-app-protect

NGINX 應用程式保護（NAP）的設定支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--no-wait

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

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

--remove

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

--resource-group -g

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

--scaling-properties

調整 NGINX 容量單位（NCU）支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--set

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

--sku

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

--subscription

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

--tags

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

--user-profile

選擇性：慣用通訊電子郵件支援速記語法、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 nginx deployment wait

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

az nginx deployment wait [--created]
                         [--custom]
                         [--deleted]
                         [--deployment-name]
                         [--exists]
                         [--ids]
                         [--interval]
                         [--resource-group]
                         [--subscription]
                         [--timeout]
                         [--updated]

選擇性參數

--created

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

預設值: False

--custom

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

--deleted

等到刪除為止。

預設值: False

--deployment-name --name -n

目標 Nginx 部署的名稱。

--exists

等候資源存在。

預設值: False

--ids

--interval

輪詢間隔以秒為單位。

預設值: 30

--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 nginx deployment

命令

az nginx deployment create

範例

必要參數

選擇性參數

az nginx deployment delete

範例

選擇性參數

az nginx deployment list

範例

選擇性參數

az nginx deployment show

範例

選擇性參數

az nginx deployment update

範例

選擇性參數

az nginx deployment wait

選擇性參數

其他資源