你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Routes - Update

参考

Service:: Front Door Service

API Version:: 2023-05-01

汇报指定订阅、资源组、配置文件和 AzureFrontDoor 终结点下具有指定路由名称的现有路由。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}?api-version=2023-05-01

URI 参数

名称	在	必需	类型	说明
endpointName	path	True	string	配置文件下全局唯一的终结点的名称。
profileName	path	True	string	资源组中唯一的 Azure Front Door Standard 或 Azure Front Door Premium 配置文件的名称。
resourceGroupName	path	True	string	Azure 订阅中的资源组的名称。 Regex pattern: `^[-\w\._]+$`
routeName	path	True	string	路由规则的名称。
subscriptionId	path	True	string	Azure 订阅 ID。
api-version	query	True	string	要与客户端请求一起使用的 API 的版本。当前版本为 2023-05-01。

请求正文

名称	类型	说明
properties.cacheConfiguration	AfdRouteCacheConfiguration	此路由的缓存配置。若要禁用缓存，请不要提供 cacheConfiguration 对象。
properties.customDomains	ActivatedResourceReference[]	此终结点引用的域。
properties.enabledState	EnabledState	是否要启用此规则。允许的值为“Enabled”或“Disabled”
properties.forwardingProtocol	ForwardingProtocol	将流量转发到后端时此规则将使用的协议。
properties.httpsRedirect	httpsRedirect	是否自动将 HTTP 流量重定向到 HTTPS 流量。请注意，这是设置此规则的简单方法，这将是执行的第一个规则。
properties.linkToDefaultDomain	LinkToDefaultDomain	此路由是否将链接到默认终结点域。
properties.originGroup	ResourceReference	对源组的引用。
properties.originPath	string	AzureFrontDoor 可用于从中检索内容的源上的目录路径，例如 contoso.cloudapp.net/originpath。
properties.patternsToMatch	string[]	规则的路由模式。
properties.ruleSets	ResourceReference[]	此终结点引用的规则集。
properties.supportedProtocols	AFDEndpointProtocols[]	此路由支持的协议列表。

响应

名称	类型	说明
200 OK	Route	确定
202 Accepted	Route	已接受。已接受请求进行处理，操作将以异步方式完成。 Headers location: string
Other Status Codes	AfdErrorResponse	描述操作失败原因的 Azure Front Door 错误响应

名称

类型

说明

200 OK

Route

确定

202 Accepted

Route

已接受。已接受请求进行处理，操作将以异步方式完成。

Headers

location: string

Other Status Codes

AfdErrorResponse

描述操作失败原因的 Azure Front Door 错误响应

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Routes_Update

Sample Request

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdEndpoints/endpoint1/routes/route1?api-version=2023-05-01

{
  "properties": {
    "customDomains": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"
      }
    ],
    "originGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"
    },
    "originPath": null,
    "ruleSets": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"
      }
    ],
    "supportedProtocols": [
      "Https",
      "Http"
    ],
    "patternsToMatch": [
      "/*"
    ],
    "cacheConfiguration": {
      "compressionSettings": {
        "contentTypesToCompress": [
          "text/html",
          "application/octet-stream"
        ],
        "isCompressionEnabled": true
      },
      "queryStringCachingBehavior": "IgnoreQueryString"
    },
    "forwardingProtocol": "MatchRequest",
    "linkToDefaultDomain": "Enabled",
    "httpsRedirect": "Enabled",
    "enabledState": "Enabled"
  }
}


import com.azure.resourcemanager.cdn.models.ActivatedResourceReference;
import com.azure.resourcemanager.cdn.models.AfdEndpointProtocols;
import com.azure.resourcemanager.cdn.models.AfdQueryStringCachingBehavior;
import com.azure.resourcemanager.cdn.models.AfdRouteCacheConfiguration;
import com.azure.resourcemanager.cdn.models.CompressionSettings;
import com.azure.resourcemanager.cdn.models.EnabledState;
import com.azure.resourcemanager.cdn.models.ForwardingProtocol;
import com.azure.resourcemanager.cdn.models.HttpsRedirect;
import com.azure.resourcemanager.cdn.models.LinkToDefaultDomain;
import com.azure.resourcemanager.cdn.models.ResourceReference;
import com.azure.resourcemanager.cdn.models.RouteUpdateParameters;
import java.util.Arrays;

/** Samples for Routes Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/Routes_Update.json
     */
    /**
     * Sample code: Routes_Update.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void routesUpdate(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.cdnProfiles().manager().serviceClient().getRoutes().update("RG", "profile1", "endpoint1", "route1",
            new RouteUpdateParameters().withCustomDomains(Arrays.asList(new ActivatedResourceReference().withId(
                "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1")))
                .withOriginGroup(new ResourceReference().withId(
                    "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"))
                .withRuleSets(Arrays.asList(new ResourceReference().withId(
                    "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1")))
                .withSupportedProtocols(Arrays.asList(AfdEndpointProtocols.HTTPS, AfdEndpointProtocols.HTTP))
                .withPatternsToMatch(Arrays.asList("/*"))
                .withCacheConfiguration(new AfdRouteCacheConfiguration()
                    .withQueryStringCachingBehavior(AfdQueryStringCachingBehavior.IGNORE_QUERY_STRING)
                    .withCompressionSettings(new CompressionSettings()
                        .withContentTypesToCompress(Arrays.asList("text/html", "application/octet-stream"))
                        .withIsCompressionEnabled(true)))
                .withForwardingProtocol(ForwardingProtocol.MATCH_REQUEST)
                .withLinkToDefaultDomain(LinkToDefaultDomain.ENABLED).withHttpsRedirect(HttpsRedirect.ENABLED)
                .withEnabledState(EnabledState.ENABLED),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential
from azure.mgmt.cdn import CdnManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cdn
# USAGE
    python routes_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = CdnManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.routes.begin_update(
        resource_group_name="RG",
        profile_name="profile1",
        endpoint_name="endpoint1",
        route_name="route1",
        route_update_properties={
            "properties": {
                "cacheConfiguration": {
                    "compressionSettings": {
                        "contentTypesToCompress": ["text/html", "application/octet-stream"],
                        "isCompressionEnabled": True,
                    },
                    "queryStringCachingBehavior": "IgnoreQueryString",
                },
                "customDomains": [
                    {
                        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"
                    }
                ],
                "enabledState": "Enabled",
                "forwardingProtocol": "MatchRequest",
                "httpsRedirect": "Enabled",
                "linkToDefaultDomain": "Enabled",
                "originGroup": {
                    "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"
                },
                "originPath": None,
                "patternsToMatch": ["/*"],
                "ruleSets": [
                    {
                        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"
                    }
                ],
                "supportedProtocols": ["Https", "Http"],
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/Routes_Update.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcdn_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cdn/armcdn/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7b551033155a63739b6d28f79b9c07569f6179b8/specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/Routes_Update.json
func ExampleRoutesClient_BeginUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcdn.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewRoutesClient().BeginUpdate(ctx, "RG", "profile1", "endpoint1", "route1", armcdn.RouteUpdateParameters{
		Properties: &armcdn.RouteUpdatePropertiesParameters{
			CacheConfiguration: &armcdn.AfdRouteCacheConfiguration{
				CompressionSettings: &armcdn.CompressionSettings{
					ContentTypesToCompress: []*string{
						to.Ptr("text/html"),
						to.Ptr("application/octet-stream")},
					IsCompressionEnabled: to.Ptr(true),
				},
				QueryStringCachingBehavior: to.Ptr(armcdn.AfdQueryStringCachingBehaviorIgnoreQueryString),
			},
			CustomDomains: []*armcdn.ActivatedResourceReference{
				{
					ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"),
				}},
			EnabledState:        to.Ptr(armcdn.EnabledStateEnabled),
			ForwardingProtocol:  to.Ptr(armcdn.ForwardingProtocolMatchRequest),
			HTTPSRedirect:       to.Ptr(armcdn.HTTPSRedirectEnabled),
			LinkToDefaultDomain: to.Ptr(armcdn.LinkToDefaultDomainEnabled),
			OriginGroup: &armcdn.ResourceReference{
				ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"),
			},
			PatternsToMatch: []*string{
				to.Ptr("/*")},
			RuleSets: []*armcdn.ResourceReference{
				{
					ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"),
				}},
			SupportedProtocols: []*armcdn.AFDEndpointProtocols{
				to.Ptr(armcdn.AFDEndpointProtocolsHTTPS),
				to.Ptr(armcdn.AFDEndpointProtocolsHTTP)},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Route = armcdn.Route{
	// 	Name: to.Ptr("route1"),
	// 	Type: to.Ptr("Microsoft.Cdn/profiles/afdendpoints/routes"),
	// 	ID: to.Ptr("/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1/routes/route1"),
	// 	Properties: &armcdn.RouteProperties{
	// 		DeploymentStatus: to.Ptr(armcdn.DeploymentStatusNotStarted),
	// 		ProvisioningState: to.Ptr(armcdn.AfdProvisioningStateSucceeded),
	// 		CacheConfiguration: &armcdn.AfdRouteCacheConfiguration{
	// 			CompressionSettings: &armcdn.CompressionSettings{
	// 				ContentTypesToCompress: []*string{
	// 					to.Ptr("text/html"),
	// 					to.Ptr("application/octet-stream")},
	// 					IsCompressionEnabled: to.Ptr(true),
	// 				},
	// 				QueryStringCachingBehavior: to.Ptr(armcdn.AfdQueryStringCachingBehaviorIgnoreQueryString),
	// 			},
	// 			CustomDomains: []*armcdn.ActivatedResourceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"),
	// 			}},
	// 			EnabledState: to.Ptr(armcdn.EnabledStateEnabled),
	// 			ForwardingProtocol: to.Ptr(armcdn.ForwardingProtocolMatchRequest),
	// 			HTTPSRedirect: to.Ptr(armcdn.HTTPSRedirectEnabled),
	// 			LinkToDefaultDomain: to.Ptr(armcdn.LinkToDefaultDomainEnabled),
	// 			OriginGroup: &armcdn.ResourceReference{
	// 				ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"),
	// 			},
	// 			PatternsToMatch: []*string{
	// 				to.Ptr("/*")},
	// 				RuleSets: []*armcdn.ResourceReference{
	// 					{
	// 						ID: to.Ptr("/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"),
	// 				}},
	// 				SupportedProtocols: []*armcdn.AFDEndpointProtocols{
	// 					to.Ptr(armcdn.AFDEndpointProtocolsHTTPS),
	// 					to.Ptr(armcdn.AFDEndpointProtocolsHTTP)},
	// 				},
	// 			}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { CdnManagementClient } = require("@azure/arm-cdn");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates an existing route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
 *
 * @summary Updates an existing route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
 * x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/Routes_Update.json
 */
async function routesUpdate() {
  const subscriptionId = process.env["CDN_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["CDN_RESOURCE_GROUP"] || "RG";
  const profileName = "profile1";
  const endpointName = "endpoint1";
  const routeName = "route1";
  const routeUpdateProperties = {
    cacheConfiguration: {
      compressionSettings: {
        contentTypesToCompress: ["text/html", "application/octet-stream"],
        isCompressionEnabled: true,
      },
      queryStringCachingBehavior: "IgnoreQueryString",
    },
    customDomains: [
      {
        id: "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1",
      },
    ],
    enabledState: "Enabled",
    forwardingProtocol: "MatchRequest",
    httpsRedirect: "Enabled",
    linkToDefaultDomain: "Enabled",
    originGroup: {
      id: "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1",
    },
    originPath: undefined,
    patternsToMatch: ["/*"],
    ruleSets: [
      {
        id: "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1",
      },
    ],
    supportedProtocols: ["Https", "Http"],
  };
  const credential = new DefaultAzureCredential();
  const client = new CdnManagementClient(credential, subscriptionId);
  const result = await client.routes.beginUpdateAndWait(
    resourceGroupName,
    profileName,
    endpointName,
    routeName,
    routeUpdateProperties
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "name": "route1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1/routes/route1",
  "type": "Microsoft.Cdn/profiles/afdendpoints/routes",
  "properties": {
    "customDomains": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"
      }
    ],
    "originGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"
    },
    "originPath": null,
    "ruleSets": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"
      }
    ],
    "supportedProtocols": [
      "Https",
      "Http"
    ],
    "patternsToMatch": [
      "/*"
    ],
    "cacheConfiguration": {
      "compressionSettings": {
        "contentTypesToCompress": [
          "text/html",
          "application/octet-stream"
        ],
        "isCompressionEnabled": true
      },
      "queryStringCachingBehavior": "IgnoreQueryString",
      "queryParameters": null
    },
    "forwardingProtocol": "MatchRequest",
    "linkToDefaultDomain": "Enabled",
    "httpsRedirect": "Enabled",
    "enabledState": "Enabled",
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted"
  }
}

Status code:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2023-05-01

Response Body

{
  "name": "route1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1/routes/route1",
  "type": "Microsoft.Cdn/profiles/afdendpoints/routes",
  "properties": {
    "customDomains": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/customDomains/domain1"
      }
    ],
    "originGroup": {
      "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/originGroup1"
    },
    "originPath": null,
    "ruleSets": [
      {
        "id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1"
      }
    ],
    "supportedProtocols": [
      "Https",
      "Http"
    ],
    "patternsToMatch": [
      "/*"
    ],
    "cacheConfiguration": {
      "compressionSettings": {
        "contentTypesToCompress": [
          "text/html",
          "application/octet-stream"
        ],
        "isCompressionEnabled": true
      },
      "queryStringCachingBehavior": "IgnoreQueryString",
      "queryParameters": null
    },
    "forwardingProtocol": "MatchRequest",
    "linkToDefaultDomain": "Enabled",
    "httpsRedirect": "Enabled",
    "enabledState": "Enabled",
    "provisioningState": "Updating",
    "deploymentStatus": "NotStarted"
  }
}

定义

名称	说明
ActivatedResourceReference	引用另一个资源及其状态。
AFDEndpointProtocols	客户的终结点支持的协议。
AfdErrorResponse	错误响应
AfdProvisioningState	预配状态
afdQueryStringCachingBehavior	定义 Frontdoor 如何缓存包含查询字符串的请求。可以在缓存时忽略任何查询字符串、忽略特定的查询字符串、使用唯一 URL 缓存每个请求或缓存特定的查询字符串。
AfdRouteCacheConfiguration	缓存类型路由的缓存设置。若要禁用缓存，请不要提供 cacheConfiguration 对象。
CompressionSettings	压缩设置。
DeploymentStatus
EnabledState	是否要启用此规则。允许的值为“Enabled”或“Disabled”
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ForwardingProtocol	将流量转发到后端时此规则将使用的协议。
httpsRedirect	是否自动将 HTTP 流量重定向到 HTTPS 流量。请注意，这是设置此规则的简单方法，这将是执行的第一个规则。
IdentityType	创建/修改资源的标识类型
LinkToDefaultDomain	此路由是否将链接到默认终结点域。
ResourceReference	对另一个资源的引用。
Route	友好路由名称映射到任何路由或机密相关信息。
RouteUpdateParameters	创建或更新域所需的域 JSON 对象。
SystemData	只读系统数据

ActivatedResourceReference

引用另一个资源及其状态。

名称	类型	说明
id	string	资源 ID。
isActive	boolean	资源是活动资源还是非活动资源

AFDEndpointProtocols

客户的终结点支持的协议。

名称	类型	说明
Http	string
Https	string

AfdErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

AfdProvisioningState

预配状态

名称	类型	说明
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

afdQueryStringCachingBehavior

定义 Frontdoor 如何缓存包含查询字符串的请求。可以在缓存时忽略任何查询字符串、忽略特定的查询字符串、使用唯一 URL 缓存每个请求或缓存特定的查询字符串。

名称	类型	说明
IgnoreQueryString	string
IgnoreSpecifiedQueryStrings	string
IncludeSpecifiedQueryStrings	string
UseQueryString	string

AfdRouteCacheConfiguration

缓存类型路由的缓存设置。若要禁用缓存，请不要提供 cacheConfiguration 对象。

名称	类型	说明
compressionSettings	CompressionSettings	压缩设置。
queryParameters	string	用于包含或排除 (逗号分隔) 的查询参数。
queryStringCachingBehavior	afdQueryStringCachingBehavior	定义 Frontdoor 如何缓存包含查询字符串的请求。可以在缓存时忽略任何查询字符串、忽略特定的查询字符串、使用唯一 URL 缓存每个请求或缓存特定的查询字符串。

CompressionSettings

压缩设置。

名称	类型	说明
contentTypesToCompress	string[]	应用压缩的内容类型列表。该值应为有效的 MIME 类型。
isCompressionEnabled	boolean	指示是否在 AzureFrontDoor 上启用内容压缩。默认值为 false。如果启用了压缩，当用户请求压缩版本时，内容将作为压缩内容提供。当请求的内容小于 1 字节或大于 1 MB 时，不会在 AzureFrontDoor 上压缩内容。

DeploymentStatus

名称	类型	说明
Failed	string
InProgress	string
NotStarted	string
Succeeded	string

EnabledState

是否要启用此规则。允许的值为“Enabled”或“Disabled”

名称	类型	说明
Disabled	string
Enabled	string

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ForwardingProtocol

将流量转发到后端时此规则将使用的协议。

名称	类型	说明
HttpOnly	string
HttpsOnly	string
MatchRequest	string

httpsRedirect

是否自动将 HTTP 流量重定向到 HTTPS 流量。请注意，这是设置此规则的简单方法，这将是执行的第一个规则。

名称	类型	说明
Disabled	string
Enabled	string

IdentityType

创建/修改资源的标识类型

名称	类型	说明
application	string
key	string
managedIdentity	string
user	string

LinkToDefaultDomain

此路由是否将链接到默认终结点域。

名称	类型	说明
Disabled	string
Enabled	string

ResourceReference

对另一个资源的引用。

名称	类型	说明
id	string	资源 ID。

Route

友好路由名称映射到任何路由或机密相关信息。

名称	类型	默认值	说明
id	string		资源 ID。
name	string		资源名称。
properties.cacheConfiguration	AfdRouteCacheConfiguration		此路由的缓存配置。若要禁用缓存，请不要提供 cacheConfiguration 对象。
properties.customDomains	ActivatedResourceReference[]		此终结点引用的域。
properties.deploymentStatus	DeploymentStatus
properties.enabledState	EnabledState		是否要启用此规则。允许的值为“Enabled”或“Disabled”
properties.endpointName	string		保存路由的终结点的名称。
properties.forwardingProtocol	ForwardingProtocol	MatchRequest	将流量转发到后端时此规则将使用的协议。
properties.httpsRedirect	httpsRedirect	Disabled	是否自动将 HTTP 流量重定向到 HTTPS 流量。请注意，这是设置此规则的简单方法，这将是执行的第一个规则。
properties.linkToDefaultDomain	LinkToDefaultDomain	Disabled	此路由是否将链接到默认终结点域。
properties.originGroup	ResourceReference		对源组的引用。
properties.originPath	string		AzureFrontDoor 可用于从中检索内容的源上的目录路径，例如 contoso.cloudapp.net/originpath。
properties.patternsToMatch	string[]		规则的路由模式。
properties.provisioningState	AfdProvisioningState		预配状态
properties.ruleSets	ResourceReference[]		此终结点引用的规则集。
properties.supportedProtocols	AFDEndpointProtocols[]	[ "Http", "Https" ]	此路由支持的协议列表。
systemData	SystemData		只读系统数据
type	string		资源类型。

RouteUpdateParameters

创建或更新域所需的域 JSON 对象。

名称	类型	默认值	说明
properties.cacheConfiguration	AfdRouteCacheConfiguration		此路由的缓存配置。若要禁用缓存，请不要提供 cacheConfiguration 对象。
properties.customDomains	ActivatedResourceReference[]		此终结点引用的域。
properties.enabledState	EnabledState		是否要启用此规则。允许的值为“Enabled”或“Disabled”
properties.endpointName	string		保存路由的终结点的名称。
properties.forwardingProtocol	ForwardingProtocol	MatchRequest	将流量转发到后端时此规则将使用的协议。
properties.httpsRedirect	httpsRedirect	Disabled	是否自动将 HTTP 流量重定向到 HTTPS 流量。请注意，这是设置此规则的简单方法，这将是执行的第一个规则。
properties.linkToDefaultDomain	LinkToDefaultDomain	Disabled	此路由是否将链接到默认终结点域。
properties.originGroup	ResourceReference		对源组的引用。
properties.originPath	string		AzureFrontDoor 可用于从中检索内容的源上的目录路径，例如 contoso.cloudapp.net/originpath。
properties.patternsToMatch	string[]		规则的路由模式。
properties.ruleSets	ResourceReference[]		此终结点引用的规则集。
properties.supportedProtocols	AFDEndpointProtocols[]	[ "Http", "Https" ]	此路由支持的协议列表。

SystemData

只读系统数据

名称	类型	说明
createdAt	string	资源的创建时间戳 (UTC)
createdBy	string	创建资源的标识的标识符
createdByType	IdentityType	创建资源的标识类型
lastModifiedAt	string	资源上次修改的时间戳 (UTC)
lastModifiedBy	string	上次修改资源的标识的标识符
lastModifiedByType	IdentityType	上次修改资源的标识类型

Routes - Update

URI 参数

请求正文

响应

安全性

azure_auth

Scopes

示例

Routes_Update

Sample Request

Sample Response

定义

ActivatedResourceReference

AFDEndpointProtocols

AfdErrorResponse

AfdProvisioningState

afdQueryStringCachingBehavior

AfdRouteCacheConfiguration

CompressionSettings

DeploymentStatus

EnabledState

ErrorAdditionalInfo

ErrorDetail

ForwardingProtocol

httpsRedirect

IdentityType

LinkToDefaultDomain

ResourceReference

Route

RouteUpdateParameters

SystemData

其他资源