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

AFD Origins - Update

更新源组中的现有源。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins/{originName}?api-version=2021-06-01

URI 参数

Name In Required Type Description
originGroupName
path True
  • string

在配置文件中唯一的源组的名称。

originName
path True
  • string

在配置文件中唯一的源的名称。

profileName
path True
  • string

Azure Front Door Standard 或 Azure Front Door 高级版配置文件的名称,该配置文件在资源组中是唯一的。

resourceGroupName
path True
  • string

Azure 订阅中的资源组的名称。

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

Azure 订阅 ID。

api-version
query True
  • string

要与客户端请求一起使用的 API 版本。 当前版本为 2021-06-01。

请求正文

Name Type Description
properties.azureOrigin

对 Azure 源资源的资源引用。

properties.enabledState

是否针对在 backendPools 下定义的后端启用运行状况探测。 仅当单个启用的后端池中有一个启用的后端时,才能禁用运行状况探测。

properties.enforceCertificateNameCheck
  • boolean

是否在源级别启用证书名称检查

properties.hostName
  • string

源的地址。 支持域名、IPv4 地址和 IPv6 地址。这在终结点中的所有源中应是唯一的。

properties.httpPort
  • integer

HTTP 端口的值。 必须介于 1 和 65535 之间。

properties.httpsPort
  • integer

HTTPS 端口的值。 必须介于 1 和 65535 之间。

properties.originHostHeader
  • string

随每个请求发送到源的主机标头值。 如果将此保留为空,则请求主机名将确定此值。 Azure CDN源(如 Web 应用、Blob 存储 和 云服务)默认要求此主机标头值与源主机名匹配。 这会替代在终结点上定义的主机标头

properties.priority
  • integer

给定源组中用于负载均衡的源优先级。 如果优先级较低的源正常,则高优先级不会用于负载均衡。必须介于 1 和 5 之间

properties.sharedPrivateLinkResource

专用源的专用链接资源的属性。

properties.weight
  • integer

给定源组中用于负载均衡的源的权重。 必须介于 1 和 1000 之间

响应

Name Type Description
200 OK

OK

202 Accepted

已接受

Other Status Codes

CDN错误响应,描述操作失败的原因。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

AFDOrigins_Update

Sample Request

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/originGroups/origingroup1/origins/origin1?api-version=2021-06-01

{
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "enabledState": "Enabled"
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1/origins/origin1",
  "type": "Microsoft.Cdn/profiles/origingroups/origins",
  "name": "origin1",
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "originHostHeader": "host1.foo.com",
    "priority": null,
    "weight": null,
    "enabledState": "Enabled",
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted",
    "originGroupName": "origingroup1",
    "sharedPrivateLinkResource": null,
    "enforceCertificateNameCheck": true
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2021-06-01
{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1/origins/origin1",
  "type": "Microsoft.Cdn/profiles/origingroups/origins",
  "name": "origin1",
  "properties": {
    "hostName": "host1.blob.core.windows.net",
    "httpPort": 80,
    "httpsPort": 443,
    "originHostHeader": "host1.foo.com",
    "priority": null,
    "weight": null,
    "enabledState": "Enabled",
    "provisioningState": "Updating",
    "deploymentStatus": "NotStarted",
    "originGroupName": "origingroup1",
    "sharedPrivateLinkResource": null,
    "enforceCertificateNameCheck": true
  }
}

定义

AfdErrorResponse

错误响应

AFDOrigin

CDN源是通过CDN传送的内容的来源。 当终结点表示的边缘节点没有缓存请求的内容时,它们会尝试从一个或多个配置的源中提取它。

AFDOriginUpdateParameters

源更新所需的 AFDOrigin 属性。

AfdProvisioningState

预配状态

DeploymentStatus
EnabledState

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

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

IdentityType

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

ResourceReference

对另一个资源的引用。

SharedPrivateLinkResourceProperties

描述连接到专用源时要使用的现有共享专用链接资源的属性。

SharedPrivateLinkResourceStatus

共享专用链接资源的状态。 可以是挂起、已批准、已拒绝、已断开连接或超时。

SystemData

只读系统数据

AfdErrorResponse

错误响应

Name Type Description
error

错误对象。

AFDOrigin

CDN源是通过CDN传送的内容的来源。 当终结点表示的边缘节点没有缓存请求的内容时,它们会尝试从一个或多个配置的源中提取它。

Name Type Default Value Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.azureOrigin

对 Azure 源资源的资源引用。

properties.deploymentStatus
properties.enabledState

是否针对在 backendPools 下定义的后端启用运行状况探测。 仅当单个启用的后端池中有一个启用的后端时,才能禁用运行状况探测。

properties.enforceCertificateNameCheck
  • boolean
True

是否在源级别启用证书名称检查

properties.hostName
  • string

源的地址。 支持域名、IPv4 地址和 IPv6 地址。这在终结点中的所有源中应是唯一的。

properties.httpPort
  • integer

HTTP 端口的值。 必须介于 1 和 65535 之间。

properties.httpsPort
  • integer

HTTPS 端口的值。 必须介于 1 和 65535 之间。

properties.originGroupName
  • string

包含此源的源组的名称。

properties.originHostHeader
  • string

随每个请求发送到源的主机标头值。 如果将此保留为空,则请求主机名将确定此值。 Azure CDN源(如 Web 应用、Blob 存储 和 云服务)默认要求此主机标头值与源主机名匹配。 这会替代在终结点上定义的主机标头

properties.priority
  • integer

给定源组中用于负载均衡的源优先级。 如果优先级较低的源正常,则高优先级不会用于负载均衡。必须介于 1 和 5 之间

properties.provisioningState

预配状态

properties.sharedPrivateLinkResource

专用源的专用链接资源的属性。

properties.weight
  • integer

给定源组中用于负载均衡的源的权重。 必须介于 1 和 1000 之间

systemData

只读系统数据

type
  • string

资源类型。

AFDOriginUpdateParameters

源更新所需的 AFDOrigin 属性。

Name Type Default Value Description
properties.azureOrigin

对 Azure 源资源的资源引用。

properties.enabledState

是否针对在 backendPools 下定义的后端启用运行状况探测。 仅当单个启用的后端池中有一个启用的后端时,才能禁用运行状况探测。

properties.enforceCertificateNameCheck
  • boolean
True

是否在源级别启用证书名称检查

properties.hostName
  • string

源的地址。 支持域名、IPv4 地址和 IPv6 地址。这在终结点中的所有源中应是唯一的。

properties.httpPort
  • integer

HTTP 端口的值。 必须介于 1 和 65535 之间。

properties.httpsPort
  • integer

HTTPS 端口的值。 必须介于 1 和 65535 之间。

properties.originGroupName
  • string

包含此源的源组的名称。

properties.originHostHeader
  • string

随每个请求发送到源的主机标头值。 如果将此保留为空,则请求主机名将确定此值。 Azure CDN源(如 Web 应用、Blob 存储 和 云服务)默认要求此主机标头值与源主机名匹配。 这会替代在终结点上定义的主机标头

properties.priority
  • integer

给定源组中用于负载均衡的源优先级。 如果优先级较低的源正常,则高优先级不会用于负载均衡。必须介于 1 和 5 之间

properties.sharedPrivateLinkResource

专用源的专用链接资源的属性。

properties.weight
  • integer

给定源组中用于负载均衡的源的权重。 必须介于 1 和 1000 之间

AfdProvisioningState

预配状态

Name Type Description
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

DeploymentStatus

Name Type Description
Failed
  • string
InProgress
  • string
NotStarted
  • string
Succeeded
  • string

EnabledState

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

Name Type Description
Disabled
  • string
Enabled
  • string

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

ErrorDetail

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

IdentityType

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

Name Type Description
application
  • string
key
  • string
managedIdentity
  • string
user
  • string

ResourceReference

对另一个资源的引用。

Name Type Description
id
  • string

资源 ID。

SharedPrivateLinkResourceProperties

描述连接到专用源时要使用的现有共享专用链接资源的属性。

Name Type Description
groupId
  • string

共享专用链接资源的提供程序中的组 ID。

privateLink

共享专用链接资源的资源的资源 ID。

privateLinkLocation
  • string

共享专用链接资源的位置

requestMessage
  • string

请求消息,用于请求批准共享专用链接资源。

status

共享专用链接资源的状态。 可以是挂起、已批准、已拒绝、已断开连接或超时。

SharedPrivateLinkResourceStatus

共享专用链接资源的状态。 可以是挂起、已批准、已拒绝、已断开连接或超时。

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string
Timeout
  • string

SystemData

只读系统数据

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC)

createdBy
  • string

创建资源的标识的标识符

createdByType

创建资源的标识的类型

lastModifiedAt
  • string

资源上次修改的时间戳 (UTC)

lastModifiedBy
  • string

上次修改资源的标识的标识符

lastModifiedByType

上次修改资源的标识类型