エクスポート (0) 印刷
すべて展開

Get Definition

更新日: 2014年9月

Get Definition 操作は、既存のプロファイル定義を返します。

Delete Profile 要求は、次のように指定します。<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

必須。この要求に使用する操作のバージョンを指定します。このヘッダーには、2011/10/01 以降のバージョンを設定する必要があります。バージョン ヘッダーの詳細については、「サービス管理のバージョン管理」を参照してください。

ありません。

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

操作が正常に終了すると、ステータス コード 200 (OK) が返されます。ステータス コードの詳細については、「サービス管理のステータス コードとエラー コード」を参照してください。

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 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>
        <Weight>load-balancing-priority</Weight>
      </Endpoint>
    </Endpoints>
    <MonitorStatus>monitor-status</MonitorStatus>
  </Policy>
</Definition>

 

要素名 説明

TimeToLiveInSeconds

DNS エントリをキャッシュする時間をローカル DNS リゾルバーに通知する DNS TTL (Time-to-Live) を指定します。

値には、30 ~ 999,999 の整数を指定します。

Status

プロファイルに対して、この定義を有効にするか無効にするかを示します。

次の値をとります。

  • Enabled

  • Disabled

Version

返される定義のバージョンを示します。この値は常に 1 です。

IntervalInSeconds

監視エンドポイントのステータス チェックを連続で試行するときの試行間隔を秒単位で指定します。

TimeoutInSeconds

監視エンドポイントからの応答を待機する時間を指定します。

ToleratedNumberOfFailures

エンドポイントをロード バランサーのローテーションから外すまでにエンドポイントで許可される連続エラー数を指定します。

プロトコル

エンドポイントの正常性の監視に使用するプロトコルを指定します。

次の値をとります。

  • HTTP

  • HTTPS

ポート

エンドポイントの正常性の監視に使用するポートを指定します。

動詞

エンドポイントの正常性を監視する HTTP 要求に使用する動詞を指定します。

RelativePath

正常性状態を調べるエンドポイントのドメイン名の相対パスを指定します。

ExpectedStatusCode

正常なエンドポイントの HTTP ステータス コードを指定します。これ以外の場合、エンドポイントは異常と見なされます。

LoadBalancingMethod

接続を分散する際に使用する負荷分散方法を指定します。

次の値をとります。

  • Performance

  • Failover

  • RoundRobin

エンドポイント

Azure Traffic Manager エンドポイントのリストをカプセル化します。

負荷分散方法が Failover に設定されている場合、エンドポイントへのトラフィックは、エンドポイントが返される順番に負荷分散されます。

DomainName

エンドポイントのドメイン名を指定します。

Status

エンドポイントの監視のステータスを指定します。

Enabled に設定すると、そのエンドポイントは負荷分散の対象と見なされ、監視されます。

次の値をとります。

  • Enabled

  • Disabled

MonitorStatus

Policy の一部として定義したときは、負荷分散ポリシー全体の正常性状態を示します。

次の値をとります。

  • Online

  • Degraded

  • Inactive

  • Disabled

  • CheckingEndpoints

Endpoint の一部として定義したときは、エンドポイントの正常性状態を示します。

次の値をとります。

  • Online

  • Degraded

  • Inactive

  • Disabled

  • Stopped

  • CheckingEndpoint

重み

負荷分散におけるエンドポイントの優先順位を指定します。重みが高くなればなるほど、より頻繁にエンドポイントを負荷分散で使用できるようになります。重み値を指定していないエンドポイントの場合、既定の重み値として 1 が使用されます。

表示:
© 2014 Microsoft