az cdn endpoint

Note

此參考文獻是 Azure CLI（版本 2.85.0 或更高版本）cdn 擴充的一部分。 這個擴充功能會在你第一次執行 az cdn endpoint 指令時自動安裝。 深入了解擴充功能。

管理 CDN 端點。

命令

名稱	Description	類型	狀態
az cdn endpoint create	在指定的訂用帳戶、資源群組和配置檔下，建立具有指定端點名稱的新 CDN 端點。	擴充功能	GA
az cdn endpoint delete	在指定的訂用帳戶、資源群組和配置檔下，刪除具有指定端點名稱的現有CDN端點。	擴充功能	GA
az cdn endpoint list	列出現有的CDN端點。	擴充功能	GA
az cdn endpoint load	將內容預先載入CDN。 適用於 Verizon 設定檔。	擴充功能	GA
az cdn endpoint name-exists	檢查資源名稱的可用性。 對於名稱為全域唯一的資源，例如 CDN 端點，則需要此專案。	擴充功能	GA
az cdn endpoint purge	從CDN 移除內容。	擴充功能	GA
az cdn endpoint rule	管理端點的傳遞規則。	擴充功能	Preview
az cdn endpoint rule action	管理端點的傳遞規則動作。	擴充功能	Preview
az cdn endpoint rule action add	將動作新增至傳遞規則。	擴充功能	Preview
az cdn endpoint rule action remove	從傳遞規則移除動作。	擴充功能	Preview
az cdn endpoint rule action show	使用端點顯示傳遞規則。	擴充功能	Preview
az cdn endpoint rule add	將傳遞規則新增至CDN端點。	擴充功能	Preview
az cdn endpoint rule condition	管理端點的傳遞規則條件。	擴充功能	Preview
az cdn endpoint rule condition add	將條件新增至傳遞規則。	擴充功能	Preview
az cdn endpoint rule condition remove	從傳遞規則中移除條件。	擴充功能	Preview
az cdn endpoint rule condition show	顯示與端點相關聯的傳遞規則。	擴充功能	Preview
az cdn endpoint rule remove	從端點移除傳遞規則。	擴充功能	Preview
az cdn endpoint rule show	顯示與端點相關聯的傳遞規則。	擴充功能	Preview
az cdn endpoint show	在指定的訂用帳戶、資源群組和配置檔下，取得具有指定端點名稱的現有CDN端點。	擴充功能	GA
az cdn endpoint start	啟動處於已停止狀態的現有CDN端點。	擴充功能	GA
az cdn endpoint stop	停止現有的執行 CDN 端點。	擴充功能	GA
az cdn endpoint update	在指定的訂用帳戶、資源群組和配置檔下，以指定的端點名稱更新現有的 CDN 端點。 建立端點之後，只能更新標記。 若要更新原始來源，請使用Update Origin作業。 若要更新原始群組，請使用更新來源群組作業。 若要更新自定義網域，請使用更新自定義網域作業。	擴充功能	GA
az cdn endpoint validate-custom-domain	驗證自定義網域對應，以確保其對應至 DNS 中正確的 CDN 端點。	擴充功能	GA
az cdn endpoint wait	將 CLI 置於等候狀態，直到符合條件為止。	擴充功能	GA

az cdn endpoint create

在指定的訂用帳戶、資源群組和配置檔下，建立具有指定端點名稱的新 CDN 端點。

az cdn endpoint create --endpoint-name --name
                       --origin
                       --profile-name
                       --resource-group
                       [--acquire-policy-token]
                       [--change-reference]
                       [--content-types-to-compress]
                       [--default-origin-group]
                       [--delivery-policy]
                       [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                       [--geo-filters]
                       [--location]
                       [--no-http {0, 1, f, false, n, no, t, true, y, yes}]
                       [--no-https {0, 1, f, false, n, no, t, true, y, yes}]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--optimization-type {DynamicSiteAcceleration, GeneralMediaStreaming, GeneralWebDelivery, LargeFileDownload, VideoOnDemandMediaStreaming}]
                       [--origin-groups]
                       [--origin-host-header]
                       [--origin-path]
                       [--probe-path]
                       [--query-string-caching-behavior {BypassCaching, IgnoreQueryString, NotSet, UseQueryString}]
                       [--tags]
                       [--url-signing-keys]
                       [--web-application-firewall-policy-link]

範例

Endpoints_Create

az cdn endpoint create --resource-group RG --profile-name profile1 --endpoint-name endpoint1 --location WestUs --content-types-to-compress "[text/html,application/octet-stream]" --default-origin-group /subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1 --delivery-policy "{description:'Test description for a policy.',rules:[{name:rule1,actions:[{parameters:{cacheBehavior:Override,cacheDuration:'10:10:09',cacheType:All,typeName:DeliveryRuleCacheExpirationActionParameters},cache-expiration:{parameters:{typeName:DeliveryRuleCacheExpirationActionParameters,cache-behavior:Override,cache-duration:'10:10:09',cache-type:All}}},{parameters:{headerAction:Overwrite,headerName:Access-Control-Allow-Origin,typeName:DeliveryRuleHeaderActionParameters,value:*},modify-response-header:{parameters:{headerAction:Overwrite,headerName:Access-Control-Allow-Origin,typeName:DeliveryRuleHeaderActionParameters,value:*}}},{parameters:{headerAction:Overwrite,headerName:Accept-Encoding,typeName:DeliveryRuleHeaderActionParameters,value:gzip},modify-request-header:{parameters:{headerAction:Overwrite,headerName:Accept-Encoding,typeName:DeliveryRuleHeaderActionParameters,value:gzip}}}],conditions:[{parameters:{matchValues:[192.168.1.0/24,10.0.0.0/24],negateCondition:True,operator:IPMatch,typeName:DeliveryRuleRemoteAddressConditionParameters},remote-address:{parameters:{typeName:DeliveryRuleRemoteAddressConditionParameters,match-values:[192.168.1.0/24,10.0.0.0/24],negate-condition:True,operator:IPMatch}}}],order:1}]}" --is-compression-enabled True --is-http-allowed True --is-https-allowed True --origin-groups "[{name:originGroup1,health-probe-settings:{probe-interval-in-seconds:120,probe-path:/health.aspx,probe-protocol:Http,probe-request-type:GET},origins:[{id:/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1},{id:/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2}],response-based-origin-error-detection-settings:{response-based-detected-error-types:TcpErrorsOnly,response-based-failover-threshold-percentage:10}}]" --origin-host-header www.bing.com --origin-path /photos --origins "[{name:origin1,enabled:True,host-name:www.someDomain1.net,http-port:80,https-port:443,origin-host-header:www.someDomain1.net,priority:1,weight:50},{name:origin2,enabled:True,host-name:www.someDomain2.net,http-port:80,https-port:443,origin-host-header:www.someDomain2.net,priority:2,weight:50}]" --query-string-caching-behavior BypassCaching --tags "{key1:value1}"

必要參數

--endpoint-name --name -n

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

--origin

下列以空格分隔的 7 Tuple 所指定的端點來源： www.example.com http_port https_port private_link_resource_id private_link_location private_link_approval_message origin_name。 HTTP 和 HTTPS 連接埠和私人鏈接資源識別碼和位置是選擇性的。 HTTP 和 HTTPS 連接埠分別預設為 80 和 443。 私人連結欄位僅適用於sku Standard_Microsoft，而且如果設定private_link_resource_id，則需要private_link_location。 原始名稱是選擇性的，預設為 origin。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--profile-name

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

--resource-group -g

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

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--content-types-to-compress

要套用壓縮的內容類型清單。 此值應該是有效的MIME類型。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--default-origin-group

要用於原始來源的源群組未明確包含在原始群組中。 可以指定為資源識別碼或此端點的來源群組名稱。

屬性	值
參數群組:	DefaultOriginGroup Arguments

--delivery-policy

原則，指定要用於端點的傳遞規則。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--enable-compression

如果啟用壓縮，如果使用者要求壓縮版本，內容將會做為壓縮。 當要求的內容小於 1 位元組或大於 1 MB 時，內容將不會壓縮在 CDN 上。

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

--geo-filters

定義CDN端點內使用者異地存取的規則清單。 每個地理篩選會定義指定路徑或內容的存取規則，例如封鎖路徑 /pictures/ 支援的速記語法、json-file 和 yaml-file 的 APAC。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--location -l

資源位置。 未指定時，將會使用資源群組的位置。

屬性	值
參數群組:	Endpoint Arguments

--no-http

停用 HTTP 流量。指出端點上是否不允許 HTTP 流量。 預設值為允許 HTTP 流量。

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

--no-https

指出端點上是否不允許 HTTPS 流量。 預設值為允許 HTTPS 流量。

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

--no-wait

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

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

--optimization-type

指定客戶想要此 CDN 端點針對哪些案例進行優化，例如下載、媒體服務。 透過這項資訊，CDN 可以套用案例驅動優化。

屬性	值
參數群組:	Properties Arguments
接受的值:	DynamicSiteAcceleration, GeneralMediaStreaming, GeneralWebDelivery, LargeFileDownload, VideoOnDemandMediaStreaming

--origin-groups

由來源群組組成，這些來源會根據可用性來平衡流量的負載平衡。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--origin-host-header

每個要求傳送至來源的主機標頭值。 只有在端點使用單一原始來源時，才允許在端點上使用這個屬性，而且可以由在原始來源指定的相同屬性覆寫。如果您將此保留空白，要求主機名會決定此值。 Azure CDN 起源，例如 Web Apps、Blob 儲存體 和 Cloud Services，預設要求此主機標頭值必須與來源主機名稱相符。

屬性	值
參數群組:	Properties Arguments

--origin-path

來源上的目錄路徑，CDN 可用來從中擷取內容，例如 contoso.cloudapp.net/originpath。

屬性	值
參數群組:	Properties Arguments

--probe-path

裝載在來源上的檔案路徑，有助於加速動態內容的傳遞，並計算CDN的最佳路由。 這是相對於原始路徑。 此屬性只有在使用單一原始來源時才相關。

屬性	值
參數群組:	Properties Arguments

--query-string-caching-behavior

定義CDN如何快取包含查詢字串的要求。 您可以在快取時忽略任何查詢字串、略過快取以防止包含查詢字串的要求，或使用唯一 URL 快取每個要求。

屬性	值
參數群組:	Properties Arguments
預設值:	NotSet
接受的值:	BypassCaching, IgnoreQueryString, NotSet, UseQueryString

--tags

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

屬性	值
參數群組:	Endpoint Arguments

--url-signing-keys

用來驗證已簽署 URL 哈希的金鑰清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--web-application-firewall-policy-link

定義端點（如適用）的 Web 應用程式防火牆 政策。支援簡寫語法、json 檔案及 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

全域參數

--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 cdn endpoint delete

在指定的訂用帳戶、資源群組和配置檔下，刪除具有指定端點名稱的現有CDN端點。

az cdn endpoint delete [--acquire-policy-token]
                       [--change-reference]
                       [--endpoint-name --name]
                       [--ids]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--profile-name]
                       [--resource-group]
                       [--subscription]

範例

Endpoints_Delete

az cdn endpoint delete --resource-group RG --profile-name profile1 --endpoint-name endpoint1

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

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

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint list

列出現有的CDN端點。

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

範例

Endpoints_ListByProfile

az cdn endpoint list --resource-group RG --profile-name profile1

必要參數

--profile-name

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

--resource-group -g

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

選擇性參數

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

--max-items

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

屬性	值
參數群組:	Pagination Arguments

--next-token

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

屬性	值
參數群組:	Pagination Arguments

全域參數

--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 cdn endpoint load

將內容預先載入CDN。 適用於 Verizon 設定檔。

az cdn endpoint load --content-paths
                     [--acquire-policy-token]
                     [--change-reference]
                     [--endpoint-name --name]
                     [--ids]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--profile-name]
                     [--resource-group]
                     [--subscription]

範例

Endpoints_LoadContent

az cdn endpoint load --resource-group RG --profile-name profile1 --endpoint-name endpoint1 --content-paths "[/folder1]"

必要參數

--content-paths

要載入之內容的路徑。 路徑應該是來源的相對檔案URL。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	ContentFilePaths Arguments

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

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

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint name-exists

檢查資源名稱的可用性。 對於名稱為全域唯一的資源，例如 CDN 端點，則需要此專案。

az cdn endpoint name-exists --name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--type {Microsoft.Cdn/Profiles/AfdEndpoints, Microsoft.Cdn/Profiles/Endpoints}]

範例

檢查姓名可用性訂閱

az cdn name-exists --name sampleName --type Microsoft.Cdn/Profiles/Endpoints

必要參數

--name

要驗證的資源名稱。

屬性	值
參數群組:	CheckNameAvailabilityInput Arguments

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--type

要驗證其名稱的資源類型。

屬性	值
參數群組:	CheckNameAvailabilityInput Arguments
預設值:	Microsoft.Cdn/Profiles/Endpoints
接受的值:	Microsoft.Cdn/Profiles/AfdEndpoints, Microsoft.Cdn/Profiles/Endpoints

全域參數

--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 cdn endpoint purge

從CDN 移除內容。

az cdn endpoint purge --content-paths
                      [--acquire-policy-token]
                      [--change-reference]
                      [--endpoint-name --name]
                      [--ids]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--profile-name]
                      [--resource-group]
                      [--subscription]

範例

Endpoints_PurgeContent

az cdn endpoint purge --resource-group RG --profile-name profile1 --endpoint-name endpoint1 --content-paths "[/folder1]"

必要參數

--content-paths

要清除之內容的路徑。 可以描述檔案路徑或通配符目錄。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	ContentFilePaths Arguments

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

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

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint show

在指定的訂用帳戶、資源群組和配置檔下，取得具有指定端點名稱的現有CDN端點。

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

範例

Endpoints_Get

az cdn endpoint show --resource-group RG --profile-name profile1 --endpoint-name endpoint1

選擇性參數

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

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint start

啟動處於已停止狀態的現有CDN端點。

az cdn endpoint start [--acquire-policy-token]
                      [--change-reference]
                      [--endpoint-nameendpoint-name --name]
                      [--ids]
                      [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                      [--profile-name]
                      [--resource-group]
                      [--subscription]

範例

Endpoints_Start

az cdn endpoint start --resource-group RG --profile-name profile1 --endpoint-nameendpoint-name endpoint1

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint-nameendpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

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

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint stop

停止現有的執行 CDN 端點。

az cdn endpoint stop [--acquire-policy-token]
                     [--change-reference]
                     [--endpoint-name --name]
                     [--ids]
                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                     [--profile-name]
                     [--resource-group]
                     [--subscription]

範例

Endpoints_Stop

az cdn endpoint stop --resource-group RG --profile-name profile1 --endpoint-name endpoint1

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-wait

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

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

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint update

在指定的訂用帳戶、資源群組和配置檔下，以指定的端點名稱更新現有的 CDN 端點。 建立端點之後，只能更新標記。 若要更新原始來源，請使用Update Origin作業。 若要更新原始群組，請使用更新來源群組作業。 若要更新自定義網域，請使用更新自定義網域作業。

az cdn endpoint update [--acquire-policy-token]
                       [--add]
                       [--change-reference]
                       [--content-types-to-compress]
                       [--default-origin-group]
                       [--delivery-policy]
                       [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                       [--endpoint-name --name]
                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                       [--geo-filters]
                       [--ids]
                       [--no-http {0, 1, f, false, n, no, t, true, y, yes}]
                       [--no-https {0, 1, f, false, n, no, t, true, y, yes}]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--optimization-type {DynamicSiteAcceleration, GeneralMediaStreaming, GeneralWebDelivery, LargeFileDownload, VideoOnDemandMediaStreaming}]
                       [--origin-groups]
                       [--origin-host-header]
                       [--origin-path]
                       [--origins]
                       [--probe-path]
                       [--profile-name]
                       [--query-string-caching-behavior {BypassCaching, IgnoreQueryString, NotSet, UseQueryString}]
                       [--remove]
                       [--resource-group]
                       [--set]
                       [--subscription]
                       [--tags]
                       [--url-signing-keys]
                       [--web-application-firewall-policy-link]

範例

Endpoints_Create

az cdn endpoint update --resource-group RG --profile-name profile1 --endpoint-name endpoint1 --content-types-to-compress "[text/html,application/octet-stream]" --default-origin-group /subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1 --delivery-policy "{description:'Test description for a policy.',rules:[{name:rule1,actions:[{name:CacheExpiration,parameters:{cacheBehavior:Override,cacheDuration:'10:10:09',cacheType:All,typeName:DeliveryRuleCacheExpirationActionParameters}},{name:ModifyResponseHeader,parameters:{headerAction:Overwrite,headerName:Access-Control-Allow-Origin,typeName:DeliveryRuleHeaderActionParameters,value:*}},{name:ModifyRequestHeader,parameters:{headerAction:Overwrite,headerName:Accept-Encoding,typeName:DeliveryRuleHeaderActionParameters,value:gzip}}],conditions:[{name:RemoteAddress,parameters:{matchValues:[192.168.1.0/24,10.0.0.0/24],negateCondition:True,operator:IPMatch,typeName:DeliveryRuleRemoteAddressConditionParameters}}],order:1}]}" --is-compression-enabled True --is-http-allowed True --is-https-allowed True --origin-groups "[{name:originGroup1,health-probe-settings:{probe-interval-in-seconds:120,probe-path:/health.aspx,probe-protocol:Http,probe-request-type:GET},origins:[{id:/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1},{id:/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2}],response-based-origin-error-detection-settings:{response-based-detected-error-types:TcpErrorsOnly,response-based-failover-threshold-percentage:10}}]" --origin-host-header www.bing.com --origin-path /photos --origins "[{name:origin1,enabled:True,host-name:www.someDomain1.net,http-port:80,https-port:443,origin-host-header:www.someDomain1.net,priority:1,weight:50},{name:origin2,enabled:True,host-name:www.someDomain2.net,http-port:80,https-port:443,origin-host-header:www.someDomain2.net,priority:2,weight:50}]" --query-string-caching-behavior BypassCaching --tags "{key1:value1}"

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--add

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

屬性	值
參數群組:	Generic Update Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--content-types-to-compress

要套用壓縮的內容類型清單。 此值應該是有效的MIME類型。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--default-origin-group

要用於原始來源的源群組未明確包含在原始群組中。 可以指定為資源識別碼或此端點的來源群組名稱。

屬性	值
參數群組:	DefaultOriginGroup Arguments

--delivery-policy

原則，指定要用於端點的傳遞規則。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--enable-compression

如果啟用壓縮，如果使用者要求壓縮版本，內容將會做為壓縮。 當要求的內容小於 1 位元組或大於 1 MB 時，內容將不會壓縮在 CDN 上。

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

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--force-string

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

屬性	值
參數群組:	Generic Update Arguments
接受的值:	0, 1, f, false, n, no, t, true, y, yes

--geo-filters

定義CDN端點內使用者異地存取的規則清單。 每個地理篩選會定義指定路徑或內容的存取規則，例如封鎖路徑 /pictures/ 支援的速記語法、json-file 和 yaml-file 的 APAC。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--no-http

停用 HTTP 流量。指出端點上是否不允許 HTTP 流量。 預設值為允許 HTTP 流量。

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

--no-https

指出端點上是否不允許 HTTPS 流量。 預設值為允許 HTTPS 流量。

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

--no-wait

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

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

--optimization-type

指定客戶想要此 CDN 端點針對哪些案例進行優化，例如下載、媒體服務。 透過這項資訊，CDN 可以套用案例驅動優化。

屬性	值
參數群組:	Properties Arguments
接受的值:	DynamicSiteAcceleration, GeneralMediaStreaming, GeneralWebDelivery, LargeFileDownload, VideoOnDemandMediaStreaming

--origin-groups

由來源群組組成，這些來源會根據可用性來平衡流量的負載平衡。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--origin-host-header

每個要求傳送至來源的主機標頭值。 只有在端點使用單一原始來源時，才允許在端點上使用這個屬性，而且可以由在原始來源指定的相同屬性覆寫。如果您將此保留空白，要求主機名會決定此值。 Azure CDN 起源，例如 Web Apps、Blob 儲存體 和 Cloud Services，預設要求此主機標頭值必須與來源主機名稱相符。

屬性	值
參數群組:	Properties Arguments

--origin-path

來源上的目錄路徑，CDN 可用來從中擷取內容，例如 contoso.cloudapp.net/originpath。

屬性	值
參數群組:	Properties Arguments

--origins

透過CDN傳遞的內容來源。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--probe-path

裝載在來源上的檔案路徑，有助於加速動態內容的傳遞，並計算CDN的最佳路由。 這是相對於原始路徑。 此屬性只有在使用單一原始來源時才相關。

屬性	值
參數群組:	Properties Arguments

--profile-name

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

屬性	值
參數群組:	Resource Id Arguments

--query-string-caching-behavior

定義CDN如何快取包含查詢字串的要求。 您可以在快取時忽略任何查詢字串、略過快取以防止包含查詢字串的要求，或使用唯一 URL 快取每個要求。

屬性	值
參數群組:	Properties Arguments
接受的值:	BypassCaching, IgnoreQueryString, NotSet, UseQueryString

--remove

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

屬性	值
參數群組:	Generic Update Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--set

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

屬性	值
參數群組:	Generic Update Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

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

屬性	值
參數群組:	Endpoint Arguments

--url-signing-keys

用來驗證已簽署 URL 哈希的金鑰清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties Arguments

--web-application-firewall-policy-link

定義端點（如適用）的 Web 應用程式防火牆 政策。支援簡寫語法、json 檔案及 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Properties 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 cdn endpoint validate-custom-domain

驗證自定義網域對應，以確保其對應至 DNS 中正確的 CDN 端點。

az cdn endpoint validate-custom-domain --host-name
                                       [--acquire-policy-token]
                                       [--change-reference]
                                       [--endpoint-name --name]
                                       [--ids]
                                       [--profile-name]
                                       [--resource-group]
                                       [--subscription]

範例

Endpoints_ValidateCustomDomain

az cdn endpoint validate-custom-domain --resource-group RG --profile-name profile1 --endpoint-name endpoint1 --host-name www.someDomain.com

必要參數

--host-name

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

屬性	值
參數群組:	CustomDomainProperties Arguments

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--profile-name

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

屬性	值
參數群組:	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 cdn endpoint wait

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

az cdn endpoint wait [--acquire-policy-token]
                     [--change-reference]
                     [--created]
                     [--custom]
                     [--deleted]
                     [--endpoint-name --name]
                     [--exists]
                     [--ids]
                     [--interval]
                     [--profile-name]
                     [--resource-group]
                     [--subscription]
                     [--timeout]
                     [--updated]

選擇性參數

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

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--created

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

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--custom

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

屬性	值
參數群組:	Wait Condition Arguments

--deleted

等到刪除為止。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--endpoint-name --name -n

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

屬性	值
參數群組:	Resource Id Arguments

--exists

等候資源存在。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--interval

輪詢間隔以秒為單位。

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

--profile-name

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

屬性	值
參數群組:	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

--timeout

以秒為單位的等候上限。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	3600

--updated

等到 provisioningState 更新為 'Succeeded'。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	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