내보내기(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-01 이후로 설정되어야 합니다. 버전 관리 헤더에 대한 자세한 내용은 서비스 관리 버전 관리를 참조하십시오.

요청 본문의 형식은 다음과 같습니다.


<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>
        <Weight>load-balancing-priority</Weight>
      </Endpoint>
    </Endpoints>
  </Policy>
</Definition>

다음 표에서는 요청 본문의 요소에 대해 설명합니다.

 

매개 변수 이름 설명

TimeToLiveInSeconds

로컬 DNS 해결 프로그램에 DNS 항목을 캐시하는 데 걸리는 시간을 알려 주는 DNS TTL(Time to Live)을 지정합니다.

이 값은 30에서 999,999 사이의 정수입니다.

IntervalInSeconds

모니터링 끝점의 상태를 확인하기 위해 연속으로 시도하는 간격(초)을 지정합니다. 이 값은 30으로 설정해야 합니다.

TimeoutInSeconds

모니터링 끝점의 응답을 기다리는 시간을 지정합니다. 이 값은 10으로 설정해야 합니다.

ToleratedNumberOfFailures

끝점을 회전에서 빼기 전까지 끝점 검색이 연속으로 실패하는 횟수를 지정합니다. 이 값은 3으로 설정해야 합니다.

프로토콜

끝점 상태를 모니터링하는 데 사용할 프로토콜을 지정합니다.

가능한 값은 다음과 같습니다.

  • HTTP

  • HTTPS

포트

끝점 상태를 모니터링하는 데 사용되는 포트를 지정합니다. 허용된 값은 0보다 크고 65,535보다 작거나 같은 정수 값입니다.

Verb

끝점 상태를 모니터링하기 위해 HTTP 요청을 수행할 때 사용할 동사를 지정합니다. 이 값은 GET으로 설정해야 합니다.

RelativePath

상태를 확인할 끝점 도메인 이름의 상대 경로를 지정합니다. 제한 사항은 다음과 같습니다.

  • 1에서 1,000자 사이여야 합니다.

  • 슬래시(/)로 시작해야 합니다.

  • XML 요소(<>)를 포함하지 않아야 합니다.

  • 이중 슬래시(//)를 포함하지 않아야 합니다.

  • 잘못된 HTML 이스케이프 문자를 포함하지 않아야 합니다. 예를 들어 %XY입니다.

ExpectedStatusCode

정상 끝점에서 예상되는 HTTP 상태 코드를 지정합니다. 지정한 상태 코드가 아닌 경우 끝점이 비정상으로 간주됩니다. 이 값은 200으로 설정해야 합니다.

LoadBalancingMethod

연결을 분산하는 데 사용할 부하 분산 방법을 지정합니다.

가능한 값은 다음과 같습니다.

  • Performance

  • Failover

  • RoundRobin

Endpoints

Azure 트래픽 관리자 끝점의 목록을 캡슐화합니다. 목록에서 최대 100개의 끝점을 정의할 수 있습니다.

부하 분산 방법이 Failover로 설정되어 있는 경우 끝점에 정의된 순차대로 끝점으로 들어오는 트래픽이 부하 분산됩니다.

DomainName

끝점 도메인 이름을 지정합니다. 값은 끝점 유형에 달려 있습니다. Type이 CloudService인 경우 값은 정의를 소유하는 구독 ID에 속하는 클라우드 서비스의 정규화된 도메인 이름(FQDN)이어야 합니다. Type이 AzureWebsite인 경우 값은 정의를 소유하는 구독 ID에 속하는 Azure 웹사이트의 FQDN이어야 합니다. Type이 Any인 경우 값은 Azure 서비스 또는 Azure 외부 서비스에 대해 어떤 FQDN도 될 수 있습니다.

상태

모니터링 끝점의 상태를 지정합니다. Enabled로 설정된 경우 부하 분산 방법에 따라 끝점이 처리되고 모니터링됩니다.

가능한 값은 다음과 같습니다.

  • Enabled

  • Disabled

Type

선택적 요소입니다. 정의에 추가할 끝점의 유형을 지정합니다.

가능한 값은 다음과 같습니다.

  • CloudService

  • AzureWebsite

  • Any

AzureWebsite 끝점이 둘 이상인 경우 서로 다른 데이터 센터에 있어야 합니다. 클라우드 서비스에는 이 제한이 적용되지 않습니다. 기본값은 CloudService입니다.

위치

LoadBalancingMethodPerformance로 설정되었을 때와 TypeAny로 설정되었을 때 필요하며 그렇지 않은 경우에는 선택 사항입니다. Azure 지역의 이름을 지정합니다. 자세한 정보는 위치 나열을 참조하세요.

Weight

선택적 요소입니다. 부하 분산의 끝점 우선 순위를 지정합니다. 가중치가 커질수록 부하 분산 장치에 끝점이 제공되는 빈도가 잦아집니다. 값은 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