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

AFD Origin Groups - Create

在指定的配置文件中创建新的源组。

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

URI 参数

Name In Required Type Description
originGroupName
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.healthProbeSettings

运行状况探测设置到用于确定源运行状况的源。

properties.loadBalancingSettings

后端池的负载均衡设置

properties.sessionAffinityState

是否允许此主机上的会话相关性。 有效选项为“已启用”或“已禁用”

properties.trafficRestorationTimeToHealedOrNewEndpointsInMinutes
  • integer

当运行不正常的终结点或添加新终结点时,将流量逐渐转移到终结点的时间(以分钟为单位)。 默认值为 10 分钟。 当前不支持此属性。

响应

Name Type Description
200 OK

OK

201 Created

Created. 请求已完成,并创建了一个新的源组。

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 模拟用户帐户

示例

AFDOriginGroups_Create

Sample Request

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

{
  "properties": {
    "loadBalancingSettings": {
      "sampleSize": 3,
      "successfulSamplesRequired": 3,
      "additionalLatencyInMilliseconds": 1000
    },
    "healthProbeSettings": {
      "probePath": "/path2",
      "probeRequestType": "NotSet",
      "probeProtocol": "NotSet",
      "probeIntervalInSeconds": 10
    },
    "trafficRestorationTimeToHealedOrNewEndpointsInMinutes": 5
  }
}

Sample Response

{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1",
  "type": "Microsoft.Cdn/profiles/origingroups",
  "name": "origingroup1",
  "properties": {
    "loadBalancingSettings": {
      "sampleSize": 3,
      "successfulSamplesRequired": 3,
      "additionalLatencyInMilliseconds": 1000
    },
    "healthProbeSettings": {
      "probePath": "/path1",
      "probeRequestType": "HEAD",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 10
    },
    "trafficRestorationTimeToHealedOrNewEndpointsInMinutes": 5,
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted"
  }
}
{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1",
  "type": "Microsoft.Cdn/profiles/origingroups",
  "name": "origingroup1",
  "properties": {
    "loadBalancingSettings": {
      "sampleSize": 3,
      "successfulSamplesRequired": 3,
      "additionalLatencyInMilliseconds": 1000
    },
    "healthProbeSettings": {
      "probePath": "/path1",
      "probeRequestType": "HEAD",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 10
    },
    "trafficRestorationTimeToHealedOrNewEndpointsInMinutes": 5,
    "provisioningState": "Succeeded",
    "deploymentStatus": "NotStarted"
  }
}
{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/origingroups/origingroup1",
  "type": "Microsoft.Cdn/profiles/origingroups",
  "name": "origingroup1",
  "properties": {
    "loadBalancingSettings": {
      "sampleSize": 3,
      "successfulSamplesRequired": 3,
      "additionalLatencyInMilliseconds": 1000
    },
    "healthProbeSettings": {
      "probePath": "/path1",
      "probeRequestType": "HEAD",
      "probeProtocol": "Http",
      "probeIntervalInSeconds": 10
    },
    "trafficRestorationTimeToHealedOrNewEndpointsInMinutes": 5,
    "provisioningState": "Creating",
    "deploymentStatus": "NotStarted"
  }
}

定义

AfdErrorResponse

错误响应

AFDOriginGroup

当无法从CDN提供内容时,使用由源组成的 AFDOrigin 组对源进行负载均衡。

AfdProvisioningState

预配状态

DeploymentStatus
EnabledState

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

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

HealthProbeParameters

包含将运行状况探测发送到源的属性的 JSON 对象。

HealthProbeRequestType

发出的运行状况探测请求的类型。

IdentityType

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

LoadBalancingSettingsParameters

Round-Robin后端池的负载均衡设置

ProbeProtocol

用于运行状况探测的协议。

SystemData

只读系统数据

AfdErrorResponse

错误响应

Name Type Description
error

错误对象。

AFDOriginGroup

当无法从CDN提供内容时,使用由源组成的 AFDOrigin 组对源进行负载均衡。

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.deploymentStatus
properties.healthProbeSettings

运行状况探测设置到用于确定源运行状况的源。

properties.loadBalancingSettings

后端池的负载均衡设置

properties.profileName
  • string

保存源组的配置文件的名称。

properties.provisioningState

预配状态

properties.sessionAffinityState

是否允许此主机上的会话相关性。 有效选项为“已启用”或“已禁用”

properties.trafficRestorationTimeToHealedOrNewEndpointsInMinutes
  • integer

当运行不正常的终结点或添加新终结点时,将流量逐渐转移到终结点的时间(以分钟为单位)。 默认值为 10 分钟。 当前不支持此属性。

systemData

只读系统数据

type
  • string

资源类型。

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

错误目标。

HealthProbeParameters

包含将运行状况探测发送到源的属性的 JSON 对象。

Name Type Description
probeIntervalInSeconds
  • integer

运行状况探测之间的秒数。默认值为 240 秒。

probePath
  • string

相对于用于确定源运行状况的源的路径。

probeProtocol

用于运行状况探测的协议。

probeRequestType

发出的运行状况探测请求的类型。

HealthProbeRequestType

发出的运行状况探测请求的类型。

Name Type Description
GET
  • string
HEAD
  • string
NotSet
  • string

IdentityType

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

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

LoadBalancingSettingsParameters

Round-Robin后端池的负载均衡设置

Name Type Description
additionalLatencyInMilliseconds
  • integer

探测的额外延迟(以毫秒为单位)落入最低延迟存储桶

sampleSize
  • integer

要考虑的负载均衡决策的示例数

successfulSamplesRequired
  • integer

必须成功的示例周期中的样本数

ProbeProtocol

用于运行状况探测的协议。

Name Type Description
Http
  • string
Https
  • string
NotSet
  • string

SystemData

只读系统数据

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC)

createdBy
  • string

创建资源的标识的标识符

createdByType

创建资源的标识的类型

lastModifiedAt
  • string

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

lastModifiedBy
  • string

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

lastModifiedByType

上次修改资源的标识类型