az cdn custom-domain

  • 參考

管理 Azure CDN 自訂網域，以提供端點的自定義主機名。

命令

名稱 Description 類型 狀態
az cdn custom-domain create

在端點內建立新的自定義網域。

 核心 GA
az cdn custom-domain delete

刪除端點內現有的自定義網域。

 核心 GA
az cdn custom-domain disable-https

停用自定義網域的 HTTPs 傳遞。

 核心 GA
az cdn custom-domain enable-https

針對自訂網域啟用 HTTPS。 您可以使用 「az cdn custom-domain list」 來取得自定義網域的資源名稱。

 核心 GA
az cdn custom-domain list

列出端點內的所有現有自定義網域。

 核心 GA
az cdn custom-domain show

取得端點內現有的自定義網域。

 核心 GA
az cdn custom-domain update

更新端點內的新自定義網域。

 核心 GA
az cdn custom-domain wait

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

 核心 GA

az cdn custom-domain create

編輯

在端點內建立新的自定義網域。

az cdn custom-domain create --custom-domain-name
                            --endpoint-name
                            --profile-name
                            --resource-group
                            [--hostname]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

範例

在端點和配置檔內建立資源名稱 customdomain1 的自定義網域。

az cdn custom-domain create -g group --endpoint-name endpoint --profile-name profile -n customdomain1 --hostname www.example.com

必要參數

--custom-domain-name --name -n

端點內自定義網域的名稱。

--endpoint-name

配置檔底下唯一的端點名稱。

--profile-name

資源群組內唯一的CDN配置檔名稱。

--resource-group -g

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

選擇性參數

--hostname

自定義網域的主機名。 必須是功能變數名稱。

--no-wait

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

接受的值: 0, 1, f, false, n, no, t, true, y, yes
全域參數
--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 cdn custom-domain delete

編輯

刪除端點內現有的自定義網域。

az cdn custom-domain delete [--custom-domain-name]
                            [--endpoint-name]
                            [--ids]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--profile-name]
                            [--resource-group]
                            [--subscription]

範例

刪除CDN的自訂網域。

az cdn custom-domain delete -g group --endpoint-name endpoint --profile-name profile -n customdomain1

選擇性參數

--custom-domain-name --name -n

端點內自定義網域的名稱。

--endpoint-name

配置檔底下唯一的端點名稱。

--ids

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

--no-wait

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

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

資源群組內唯一的CDN配置檔名稱。

--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 cdn custom-domain disable-https

編輯

停用自定義網域的 HTTPs 傳遞。

az cdn custom-domain disable-https --endpoint-name
                                   --name
                                   --profile-name
                                   --resource-group

必要參數

--endpoint-name

配置檔底下唯一的端點名稱。

--name -n

自訂網域的資源名稱。

--profile-name

資源群組內唯一的CDN配置檔名稱。

--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 cdn custom-domain enable-https

編輯

針對自訂網域啟用 HTTPS。 您可以使用 「az cdn custom-domain list」 來取得自定義網域的資源名稱。

az cdn custom-domain enable-https --endpoint-name
                                  --name
                                  --profile-name
                                  --resource-group
                                  [--min-tls-version {1.0, 1.2, none}]
                                  [--user-cert-group-name]
                                  [--user-cert-protocol-type {ip, sni}]
                                  [--user-cert-secret-name]
                                  [--user-cert-secret-version]
                                  [--user-cert-subscription-id]
                                  [--user-cert-vault-name]

範例

使用 CDN 管理的憑證為具有資源名稱 customdomain1 的自定義網域啟用 HTTPS

az cdn custom-domain enable-https -g group --profile-name profile --endpoint-name endpoint -n customdomain1

使用 CDN 管理的憑證為具有資源名稱 customdomain1 的自定義網域啟用 HTTPS，並將最低 TLS 版本設定為 1.2

az cdn custom-domain enable-https -g group --profile-name profile --endpoint-name endpoint -n customdomain1 --min-tls-version 1.2

必要參數

--endpoint-name

父端點的名稱。

--name -n

自訂網域的資源名稱。

--profile-name

父配置檔的名稱。

--resource-group -g

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

選擇性參數

--min-tls-version

自定義網域所需的最低 TLS 版本。

接受的值: 1.0, 1.2, none
--user-cert-group-name

KeyVault 憑證的資源群組。

--user-cert-protocol-type

憑證的通訊協定類型。

接受的值: ip, sni
--user-cert-secret-name

KeyVault 憑證的秘密名稱。

--user-cert-secret-version

如果未指定 KeyVault 憑證的秘密版本，一律會使用「最新」版本，而且當有較新版本的憑證可用時，部署的憑證會自動輪替至最新版本。

--user-cert-subscription-id

KeyVault 憑證的訂用帳戶標識碼。

--user-cert-vault-name

KeyVault 憑證的保存庫名稱。

全域參數
--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 cdn custom-domain list

編輯

列出端點內的所有現有自定義網域。

az cdn custom-domain list --endpoint-name
                          --profile-name
                          --resource-group
                          [--max-items]
                          [--next-token]

必要參數

--endpoint-name

配置檔底下唯一的端點名稱。

--profile-name

資源群組內唯一的CDN配置檔名稱。

--resource-group -g

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

選擇性參數

--max-items

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

--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 cdn custom-domain show

編輯

取得端點內現有的自定義網域。

az cdn custom-domain show [--custom-domain-name]
                          [--endpoint-name]
                          [--ids]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]

範例

取得具有資源名稱 customdomain1 的自定義網域詳細數據。

az cdn custom-domain show -g group --endpoint-name endpoint --profile-name profile -n customdomain1

選擇性參數

--custom-domain-name --name -n

端點內自定義網域的名稱。

--endpoint-name

配置檔底下唯一的端點名稱。

--ids

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

--profile-name

資源群組內唯一的CDN配置檔名稱。

--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 cdn custom-domain update

編輯

更新端點內的新自定義網域。

az cdn custom-domain update [--add]
                            [--custom-domain-name]
                            [--endpoint-name]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--hostname]
                            [--ids]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--profile-name]
                            [--remove]
                            [--resource-group]
                            [--set]
                            [--subscription]

選擇性參數

--add

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

--custom-domain-name --name -n

端點內自定義網域的名稱。

--endpoint-name

配置檔底下唯一的端點名稱。

--force-string

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

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

自定義網域的主機名。 必須是功能變數名稱。

--ids

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

--no-wait

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

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

資源群組內唯一的CDN配置檔名稱。

--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帳戶。

全域參數
--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 cdn custom-domain wait

編輯

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

az cdn custom-domain wait [--created]
                          [--custom]
                          [--custom-domain-name]
                          [--deleted]
                          [--endpoint-name]
                          [--exists]
                          [--ids]
                          [--interval]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]
                          [--timeout]
                          [--updated]

選擇性參數

--created

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

預設值: False
--custom

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

--custom-domain-name --name -n

端點內自定義網域的名稱。

--deleted

等到刪除為止。

預設值: False
--endpoint-name

配置檔底下唯一的端點名稱。

--exists

等候資源存在。

預設值: False
--ids

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

--interval

輪詢間隔以秒為單位。

預設值: 30
--profile-name

資源群組內唯一的CDN配置檔名稱。

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