내보내기(0) 인쇄
모두 확장

정의 가져오기

업데이트 날짜: 2015년 1월

Get Definition 작업은 기존 프로필 정의를 반환합니다.

다음과 같이 Get Definition 요청을 지정합니다. <subscription-id>를 구독 ID로 바꾸고, <profile-name>을 프로필 이름(예: myapp-trafficmanager)으로 바꾸세요.

 

방법 요청 URI

GET

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

관리 서비스에 대한 요청이 안전한지 확인해야 합니다. 자세한 내용은 서비스 관리 요청 인증을 참조하세요.

다음 표에서는 요청 헤더에 대해 설명합니다.

 

요청 헤더 설명

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더는 01.10.11 이후로 설정되어야 합니다. 버전 관리 헤더에 대한 자세한 내용은 서비스 관리 버전 관리를 참조하세요.

없음.

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하십시오.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.

응답 본문의 형식은 다음과 같습니다.


<Definition xmlns="http://schemas.microsoft.com/windowsazure">
  <DnsOptions>
    <TimeToLiveInSeconds>dns-time-to-live</TimeToLiveInSeconds>
  </DnsOptions>  
  <Status>status-of-definition</Status>
  <Version>version-of-definition</Version>
  <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>
        <MonitorStatus>monitor-status</MonitorStatus>
        <Location>endpoint-location</Location>
        <MinChildEndpoints>min-child-endpoints</MinChildEndpoints>
        <Weight>load-balancing-priority</Weight>
      </Endpoint>
    </Endpoints>
    <MonitorStatus>monitor-status</MonitorStatus>
  </Policy>
</Definition>

 

요소 이름 설명

TimeToLiveInSeconds

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

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

상태

이 정의가 프로필에 사용되도록 설정되었는지 여부를 나타냅니다.

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

  • Enabled

  • Disabled

버전

반환된 정의의 버전을 나타냅니다. 이 값은 항상 1입니다.

IntervalInSeconds

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

TimeoutInSeconds

모니터링 끝점의 응답을 기다리는 시간을 지정합니다.

ToleratedNumberOfFailures

끝점을 부하 분산 장치의 회전에서 빼기 전까지 끝점에 대해 허용할 연속 실패 횟수를 지정합니다.

프로토콜

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

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

  • HTTP

  • HTTPS

포트

끝점 상태를 모니터링하는 데 사용되는 포트를 지정합니다.

Verb

끝점 상태를 모니터링하기 위해 HTTP 요청을 수행할 때 사용할 동사를 지정합니다.

RelativePath

상태를 확인할 끝점 도메인 이름의 상대 경로를 지정합니다.

ExpectedStatusCode

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

LoadBalancingMethod

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

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

  • Performance

  • Failover

  • RoundRobin

끝점

Azure 트래픽 관리자 끝점의 목록을 캡슐화합니다.

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

DomainName

끝점 도메인 이름을 지정합니다.

상태

끝점에 대한 모니터링 상태를 지정합니다.

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

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

  • Enabled

  • Disabled

MonitorStatus

Policy의 일부로 정의된 경우 전체 부하 분산 정책의 상태를 나타냅니다.

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

  • Online

  • Degraded

  • Inactive

  • Disabled

  • CheckingEndpoints

Endpoint의 일부로 정의된 경우 끝점의 상태를 나타냅니다.

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

  • Online

  • Degraded

  • Inactive

  • Disabled

  • Stopped

  • CheckingEndpoint

위치

TrafficManagerAny 끝점 유형의 위치를 지정합니다(이들 유형이 설정된 경우에만). CloudServiceAzureWebsite 끝점 유형의 경우 위치를 설정할 수 없고 위치가 반환되지 않습니다. 이러한 유형의 위치는 Azure 웹 사이트나 클라우드 서비스에서 확인할 수 있습니다.

MinChildEndpoints

중첩된 프로필 내에 있는 정상 끝점의 최소 수를 지정합니다. 이 수에 따라 해당 프로필 내의 끝점이 트래픽을 수신할 수 있는지 여부가 결정됩니다. 기본값은 1입니다.

Weight

부하 분산의 끝점 우선 순위를 지정합니다. 가중치가 커질수록 부하 분산 장치에 끝점이 제공되는 빈도가 잦아집니다. 가중치 값을 지정하지 않는 끝점에 대해서는 기본 가중치 값인 1이 사용됩니다.

참고 항목

표시:
© 2015 Microsoft