导出 (0) 打印
全部展开

创建定义

更新时间: 2014年9月

Create Definition操作创建指定配置文件的新定义。服务将向此定义分配一个版本号。有关创建配置文件的详细信息,请参阅创建配置文件

按如下所示指定 Create Definition 请求。将 <subscription-id> 替换为订阅 ID,并将 <profile-name> 替换为配置文件名称。例如 myapp-trafficmanager-net

 

方法 请求 URI

POST

https://management.core.windows.net/<subscription-id>/services/WATM/profiles/<profile-name>/definitions

你必须确保向管理服务发出的请求是安全的。有关其他详细信息,请参见对服务管理请求进行身份验证

无。

下表介绍请求标头。

 

请求标头 说明

x-ms-version

必需。指定用于此请求的操作的版本。应将此标头设置为 2011/10/1 或更高版本。有关版本控制标头的详细信息,请参阅服务管理版本控制

请求正文的格式如下所示:


<Definition xmlns="http://schemas.microsoft.com/windowsazure">
  <DnsOptions>
    <TimeToLiveInSeconds>dns-time-to-live</TimeToLiveInSeconds>
  </DnsOptions>
  <Monitors>
    <Monitor>
      <IntervalInSeconds>interval-in-seconds</IntervalInSeconds>
      <TimeoutInSeconds>timeout-in-seconds</TimeoutInSeconds>
      <ToleratedNumberOfFailures>number-of-failures</ToleratedNumberOfFailures>
      <Protocol>monitor-protocol</Protocol>
      <Port>port-number</Port>
      <HttpOptions>
        <Verb>http-verb</Verb>
        <RelativePath>path-relative-to-endpoint</RelativePath>
        <ExpectedStatusCode>expected-status</ExpectedStatusCode>
      </HttpOptions>
    </Monitor>
  </Monitors>
  <Policy>
    <LoadBalancingMethod>load-balancing-method</LoadBalancingMethod>
    <Endpoints>
      <Endpoint>
        <DomainName>domain-name</DomainName>
        <Status>endpoint-status</Status>
        <Type>endpoint-type</Type>
        <Location>endpoint-location</Location>
        <MinChildEndpoints>min-child-endpoints</MinChildEndpoints>
        <Weight>load-balancing-priority</Weight>
      </Endpoint>
    </Endpoints>
  </Policy>
</Definition>

下表说明了请求正文的元素。

 

参数名称 说明

TimeToLiveInSeconds

指定告知本地 DNS 解析器要将 DNS 条目缓存多久的 DNS 生存时间 (TTL)。

该值为 30 到 999999 的整数。

IntervalInSeconds

指定连续两次尝试检查监视终结点状态之间的秒数。必须将该值设置为 30。

TimeoutInSeconds

指定要等待监视终结点作出响应的时间。必须将该值设置为 10。

ToleratedNumberOfFailures

指定使终结点脱离轮换之前探测终结点的连续失败次数。必须将该值设置为 3。

协议

指定用于监视终结点运行状况的协议。

可能的值有:

  • HTTP

  • HTTPS

Port

指定用于监视终结点运行状况的端口。接受的值为大于 0 且小于或等于 65535 的整数值。

Verb

指定在通过 HTTP 请求监视终结点运行状况时使用的谓词。必须将该值设置为 GET。

RelativePath

指定用于探测运行状况的相对于终结点域名的路径。有以下限制:

  • 路径必须为 1 到 1000 个字符。

  • 该路径必须以正斜杠 / 开头。

  • 该路径不能包含括号 <>

  • 该路径不得包含双斜线 //

  • 该路径必须是格式正确的 URI 字符串。有关详细信息,请参阅 Uri.IsWellFormedUriString 方法

ExpectedStatusCode

指定正常运行的终结点应有的 HTTP 状态代码。在其他情况下,将终结点视为不正常。必须将该值设置为 200。

LoadBalancingMethod

指定用于分配连接的负载平衡方法。

可能的值有:

  • 性能

  • Failover

  • RoundRobin

Endpoints

封装 Azure Traffic Manager 终结点的列表。最多可在该列表中定义 100 个终结点。

如果将负载平衡方法设置为 Failover,则按定义终结点的顺序对通往终结点的流量进行负载平衡。

DomainName

指定终结点域名。此值取决于终结点类型。如果类型为 CloudService,则此值必须是属于拥有该定义的订阅 ID 的云服务的完全限定域名 (FQDN)。如果类型为 AzureWebsite,则此值必须是属于拥有该定义的订阅 ID 的 Azure 网站的 FQDN。如果类型为 Any,则此值可以是 Azure 服务或 Azure 以外的服务的任何 FQDN。

状态

指定监视终结点的状态。如果设置为 Enabled,则负载平衡方法要考虑终结点并且对终结点进行监视。

可能的值有:

  • Enabled

  • Disabled

类型

可选。指定要添加到定义中的终结点的类型。

可能的值有:

  • CloudService

  • AzureWebsite

  • Any

  • TrafficManager

如果存在多个 AzureWebsite 终结点,则这些终结点必须位于不同的数据中心内。此限制不适用于云服务。默认值为 CloudService。在配置嵌套配置文件时,请使用 TrafficManager 类型。有关详细信息,请参阅Traffic Manager 概述

位置

LoadBalancingMethod 设为 PerformanceType 设为 AnyTrafficManager 时必需。指定 Azure 区域的名称。不能为 CloudServiceAzureWebsite 类型的终结点指定位置,其位置由服务确定。有关详细信息,请参阅列出位置

MinChildEndpoints

可选。当 Type 设为 TrafficManager 时可以指定。嵌套配置文件中正常运行的最小终结点数,确定该配置文件中的任何终结点是否可以接收流量。默认值为 1。

权重

可选。指定终结点在负载平衡中的优先级。权重越大,终结点可供负载平衡器使用的频率越高。此值必须大于 0。对于未指定权重值的终结点,将使用默认权重 1。

响应包括 HTTP 状态代码、一组响应标头和响应正文。

此操作成功后返回状态代码 200(正常)。有关状态代码的信息,请参阅服务管理状态和错误代码

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都符合 HTTP/1.1 协议规范

 

响应标头 说明

x-ms-request-id

一个值,它唯一地标识对管理服务做出的请求。

响应正文的格式如下所示:


<Definition xmlns="http://schemas.microsoft.com/windowsazure">
  <Version>1</Version>
</Definition>

下表介绍响应正文中的元素。

 

元素名称 说明

Version

分配给新定义的版本号。此值始终为 1。

显示:
© 2014 Microsoft