Microsoft.Network trafficmanagerprofiles 2017-05-01
Bicep リソース定義
trafficmanagerprofiles リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Network/trafficmanagerprofiles リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Network/trafficmanagerprofiles@2017-05-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
properties: {
dnsConfig: {
relativeName: 'string'
ttl: int
}
endpoints: [
{
properties: {
endpointLocation: 'string'
endpointMonitorStatus: 'string'
endpointStatus: 'string'
geoMapping: [
'string'
]
minChildEndpoints: int
priority: int
target: 'string'
targetResourceId: 'string'
weight: int
}
}
]
monitorConfig: {
intervalInSeconds: int
path: 'string'
port: int
profileMonitorStatus: 'string'
protocol: 'string'
timeoutInSeconds: int
toleratedNumberOfFailures: int
}
profileStatus: 'string'
trafficRoutingMethod: 'string'
}
}
プロパティ値
trafficmanagerprofiles
名前 | 説明 | 値 |
---|---|---|
name | リソース名 | string (必須) 文字数制限: 1 から 63 有効な文字: 英数字、ハイフン、およびピリオド。 先頭と末尾には英数字を使用します。 リソース名は、Azure 全体で一意である必要があります。 |
location | リソースが保存されている Azure リージョン | string |
tags | リソース タグ。 | タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください |
properties | Traffic Manager プロファイルのプロパティ。 | ProfileProperties |
ProfileProperties
名前 | 説明 | 値 |
---|---|---|
dnsConfig | Traffic Manager プロファイルの DNS 設定。 | DnsConfig |
エンドポイント | Traffic Manager プロファイル内のエンドポイントの一覧。 | Endpoint[] |
monitorConfig | Traffic Manager プロファイルのエンドポイント監視設定。 | MonitorConfig |
profileStatus | Traffic Manager プロファイルの状態。 | 'Disabled' 'Enabled' |
trafficRoutingMethod | Traffic Manager プロファイルのトラフィック ルーティング方法。 | '地理的' 'パフォーマンス' 'Priority' '重み付け' |
DnsConfig
名前 | 説明 | 値 |
---|---|---|
relativeName | この Traffic Manager プロファイルによって提供される相対 DNS 名。 Azure Traffic Manager が使用する DNS ドメイン名とこの値を組み合わせて、プロファイルの完全修飾ドメイン名 (FQDN) が形成されます。 | string |
ttl | DNS Time-To-Live (TTL) (秒単位)。 これにより、ローカル DNS リゾルバーと DNS クライアントに、この Traffic Manager プロファイルによって提供される DNS 応答をキャッシュする時間が通知されます。 | INT |
エンドポイント
名前 | 説明 | 値 |
---|---|---|
properties | Traffic Manager エンドポイントのプロパティ。 | EndpointProperties |
EndpointProperties
名前 | 説明 | 値 |
---|---|---|
endpointLocation | "パフォーマンス" トラフィック ルーティング方法を使用する場合の外部エンドポイントまたは入れ子になったエンドポイントの場所を指定します。 | string |
endpointMonitorStatus | エンドポイントの監視状態。 | 'CheckingEndpoint' 'Degraded' 'Disabled' '非アクティブ' 'Online' 'Stopped' |
endpointStatus | エンドポイントの状態。 エンドポイントが有効な場合、これはエンドポイントの正常性をプローブし、トラフィックのルーティング方法に含まれます。 | 'Disabled' 'Enabled' |
geoMapping | "地理的" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされる国/地域の一覧。 受け入れられる値の完全な一覧については、Traffic Manager の地理的なドキュメントを参照してください。 | string[] |
minChildEndpoints | 親プロファイルを使用可能と見なすために子プロファイルで使用できる必要があるエンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。 | INT |
priority | "Priority" トラフィック ルーティング方法を使用する場合の、このエンドポイントの優先度。 使用できる値は 1 から 1000 で、低い値は優先度が高いことを表します。 これは省略可能なパラメーターです。 指定した場合、すべてのエンドポイントに指定する必要があります。2 つのエンドポイントが同じ優先度の値を共有することはできません。 | INT |
ターゲット (target) | エンドポイントの完全修飾 DNS 名。 トラフィック マネージャーは、このエンドポイントにトラフィックをダイレクトする DNS 応答にこの値を返します。 | string |
targetResourceId | エンドポイントの の Azure リソース URI。 "ExternalEndpoints" 型のエンドポイントには適用されません。 | string |
weight | "重み付け" トラフィック ルーティング方法を使用する場合の、このエンドポイントの重み。 使用できる値は 1 から 1000 です。 | INT |
MonitorConfig
Name | 説明 | 値 |
---|---|---|
intervalInSeconds | このプロファイル内のエンドポイントの監視間隔。 これは、Traffic Manager がこのプロファイル内の各エンドポイントの正常性をチェックする間隔です。 | INT |
path | エンドポイントの正常性のプローブに使用されるエンドポイント ドメイン名に対する相対パス。 | string |
port | エンドポイントの正常性のプローブに使用される TCP ポート。 | INT |
profileMonitorStatus | Traffic Manager プロファイルのプロファイル レベルの監視状態。 | 'CheckingEndpoints' 'Degraded' 'Disabled' '非アクティブ' 'Online' |
protocol | エンドポイントの正常性のプローブに使用されるプロトコル (HTTP、HTTPS、または TCP)。 | 'HTTP' 'HTTPS' 'TCP' |
timeoutInSeconds | このプロファイル内のエンドポイントのモニター タイムアウト。 これは、Traffic Manager によって、このプロファイル内のエンドポイントが正常性チェックへの応答を許可する時間です。 | INT |
toleratedNumberOfFailures | このプロファイルでエンドポイントを宣言する前に Traffic Manager が許容する連続した失敗した正常性チェックの数は、次に失敗した正常性チェック後に低下します。 | INT |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
多層トラフィック マネージャー、L4 ILB、L7 AppGateway |
このテンプレートは、Virtual Networkをデプロイし、サブネットを介してネットワークを分離し、VM をデプロイして負荷分散を構成します |
Azure Traffic Manager + Application Gateways デモセットアップ |
このテンプレートを使用すると、Application Gateways デモの上に Azure Traffic Manager をすばやくデプロイして、異なるリージョン間のトラフィック分散をテストできます。 |
Azure Traffic Manager デモのセットアップ |
このテンプレートを使用すると、Azure Traffic Manager デモをすばやくデプロイして、異なるリージョン間のトラフィック分散をテストできます。 |
Azure Traffic Manager 外部エンドポイントの例 |
このテンプレートでは、外部エンドポイントを使用して Azure Traffic Manager プロファイルを作成する方法を示します。 |
Azure Traffic Manager の複数値ルーティング |
このテンプレートでは、最小子ルーティングと複数値ルーティングを使用して、入れ子になったエンドポイントを使用して Azure Traffic Manager プロファイルを作成する方法を示します。 |
Azure Traffic Manager VM の例 |
このテンプレートでは、複数の仮想マシン間で Azure Traffic Manager プロファイルの負荷分散を作成する方法を示します。 |
Availability Zonesを使用した Azure Traffic Manager VM の例 |
このテンプレートでは、Availability Zonesに配置された複数の仮想マシン間で Azure Traffic Manager プロファイルの負荷分散を作成する方法を示します。 |
Azure Traffic Manager Web アプリの例 |
このテンプレートは、App Serviceの Azure Traffic Manager プロファイルを作成する方法を示しています。 |
ARM テンプレート リソース定義
trafficmanagerprofiles リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Network/trafficmanagerprofiles リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Network/trafficmanagerprofiles",
"apiVersion": "2017-05-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"dnsConfig": {
"relativeName": "string",
"ttl": "int"
},
"endpoints": [
{
"properties": {
"endpointLocation": "string",
"endpointMonitorStatus": "string",
"endpointStatus": "string",
"geoMapping": [ "string" ],
"minChildEndpoints": "int",
"priority": "int",
"target": "string",
"targetResourceId": "string",
"weight": "int"
}
}
],
"monitorConfig": {
"intervalInSeconds": "int",
"path": "string",
"port": "int",
"profileMonitorStatus": "string",
"protocol": "string",
"timeoutInSeconds": "int",
"toleratedNumberOfFailures": "int"
},
"profileStatus": "string",
"trafficRoutingMethod": "string"
}
}
プロパティ値
trafficmanagerprofiles
Name | 説明 | 値 |
---|---|---|
type | リソースの種類 | 'Microsoft.Network/trafficmanagerprofiles' |
apiVersion | リソース API のバージョン | '2017-05-01' |
name | リソース名 | string (必須) 文字制限: 1 から 63 有効な文字: 英数字、ハイフン、およびピリオド。 先頭と末尾には英数字を使用します。 リソース名は、Azure 全体で一意である必要があります。 |
location | リソースが保存されている Azure リージョン | string |
tags | リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
properties | Traffic Manager プロファイルのプロパティ。 | ProfileProperties |
ProfileProperties
名前 | 説明 | 値 |
---|---|---|
dnsConfig | Traffic Manager プロファイルの DNS 設定。 | DnsConfig |
エンドポイント | Traffic Manager プロファイル内のエンドポイントの一覧。 | Endpoint[] |
monitorConfig | Traffic Manager プロファイルのエンドポイント監視設定。 | MonitorConfig |
profileStatus | Traffic Manager プロファイルの状態。 | 'Disabled' 'Enabled' |
trafficRoutingMethod | Traffic Manager プロファイルのトラフィック ルーティング方法。 | 'Geographic' 'Performance' 'Priority' '重み付け' |
DnsConfig
Name | 説明 | 値 |
---|---|---|
relativeName | この Traffic Manager プロファイルによって提供される相対 DNS 名。 Azure Traffic Manager が使用する DNS ドメイン名とこの値を組み合わせて、プロファイルの完全修飾ドメイン名 (FQDN) が形成されます。 | string |
ttl | DNS Time-To-Live (TTL) (秒単位)。 これにより、ローカル DNS リゾルバーと DNS クライアントに、この Traffic Manager プロファイルによって提供される DNS 応答をキャッシュする時間が通知されます。 | INT |
エンドポイント
名前 | 説明 | 値 |
---|---|---|
properties | Traffic Manager エンドポイントのプロパティ。 | EndpointProperties |
EndpointProperties
名前 | 説明 | 値 |
---|---|---|
endpointLocation | "パフォーマンス" トラフィック ルーティング方法を使用する場合の外部エンドポイントまたは入れ子になったエンドポイントの場所を指定します。 | string |
endpointMonitorStatus | エンドポイントの監視状態。 | 'CheckingEndpoint' 'Degraded' 'Disabled' '非アクティブ' 'Online' 'Stopped' |
endpointStatus | エンドポイントの状態。 エンドポイントが有効な場合、これはエンドポイントの正常性をプローブし、トラフィックのルーティング方法に含まれます。 | 'Disabled' 'Enabled' |
geoMapping | "地理的" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされる国/地域の一覧。 受け入れられる値の完全な一覧については、Traffic Manager の地理的なドキュメントを参照してください。 | string[] |
minChildEndpoints | 親プロファイルを使用可能と見なすために子プロファイルで使用できる必要があるエンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。 | INT |
priority | "Priority" トラフィック ルーティング方法を使用する場合の、このエンドポイントの優先度。 使用できる値は 1 から 1000 で、低い値は優先度が高いことを表します。 これは省略可能なパラメーターです。 指定した場合、すべてのエンドポイントに指定する必要があります。2 つのエンドポイントが同じ優先度の値を共有することはできません。 | INT |
ターゲット (target) | エンドポイントの完全修飾 DNS 名。 トラフィック マネージャーは、このエンドポイントにトラフィックをダイレクトする DNS 応答にこの値を返します。 | string |
targetResourceId | エンドポイントの の Azure リソース URI。 型 'ExternalEndpoints' のエンドポイントには適用されません。 | string |
weight | "重み付け" トラフィック ルーティング方法を使用する場合の、このエンドポイントの重み。 指定できる値は 1 ~ 1000 です。 | INT |
MonitorConfig
Name | 説明 | 値 |
---|---|---|
intervalInSeconds | このプロファイル内のエンドポイントの監視間隔。 これは、Traffic Manager がこのプロファイル内の各エンドポイントの正常性をチェックする間隔です。 | INT |
path | エンドポイントの正常性のプローブに使用されるエンドポイント ドメイン名に対する相対パス。 | string |
port | エンドポイントの正常性のプローブに使用される TCP ポート。 | INT |
profileMonitorStatus | Traffic Manager プロファイルのプロファイル レベルの監視状態。 | 'CheckingEndpoints' 'Degraded' 'Disabled' '非アクティブ' 'Online' |
protocol | エンドポイントの正常性のプローブに使用されるプロトコル (HTTP、HTTPS、または TCP)。 | 'HTTP' 'HTTPS' 'TCP' |
timeoutInSeconds | このプロファイル内のエンドポイントのモニター タイムアウト。 Traffic Manager で、このプロファイル内のエンドポイントが正常性チェックへの応答を許可する時刻です。 | INT |
toleratedNumberOfFailures | このプロファイルでエンドポイントを宣言する前に Traffic Manager が許容する連続した失敗した正常性チェックの数は、次の正常性チェックが失敗した後に低下しました。 | INT |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
多層トラフィック マネージャー、L4 ILB、L7 AppGateway |
このテンプレートは、Virtual Networkをデプロイし、サブネットを介してネットワークを分離し、VM をデプロイし、負荷分散を構成します |
Azure Traffic Manager + Application Gateways デモのセットアップ |
このテンプレートを使用すると、Application Gateways デモの上に Azure Traffic Manager をすばやくデプロイして、異なるリージョン間のトラフィック分散をテストできます。 |
Azure Traffic Manager デモのセットアップ |
このテンプレートを使用すると、Azure Traffic Manager デモをすばやくデプロイして、異なるリージョン間のトラフィック分散をテストできます。 |
Azure Traffic Manager 外部エンドポイントの例 |
このテンプレートでは、外部エンドポイントを使用して Azure Traffic Manager プロファイルを作成する方法を示します。 |
Azure Traffic Manager の複数値ルーティング |
このテンプレートでは、最小子ルーティングと複数値ルーティングを使用して、入れ子になったエンドポイントを使用して Azure Traffic Manager プロファイルを作成する方法を示します。 |
Azure Traffic Manager VM の例 |
このテンプレートでは、複数の仮想マシン間で Azure Traffic Manager プロファイルの負荷分散を作成する方法を示します。 |
Availability Zonesを使用した Azure Traffic Manager VM の例 |
このテンプレートでは、Availability Zonesに配置された複数の仮想マシン間で Azure Traffic Manager プロファイルの負荷分散を作成する方法を示します。 |
Azure Traffic Manager Web アプリの例 |
このテンプレートは、App Serviceの Azure Traffic Manager プロファイルを作成する方法を示しています。 |
Terraform (AzAPI プロバイダー) リソース定義
trafficmanagerprofiles リソースの種類は、次をターゲットとする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Network/trafficmanagerprofiles リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/trafficmanagerprofiles@2017-05-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
dnsConfig = {
relativeName = "string"
ttl = int
}
endpoints = [
{
properties = {
endpointLocation = "string"
endpointMonitorStatus = "string"
endpointStatus = "string"
geoMapping = [
"string"
]
minChildEndpoints = int
priority = int
target = "string"
targetResourceId = "string"
weight = int
}
}
]
monitorConfig = {
intervalInSeconds = int
path = "string"
port = int
profileMonitorStatus = "string"
protocol = "string"
timeoutInSeconds = int
toleratedNumberOfFailures = int
}
profileStatus = "string"
trafficRoutingMethod = "string"
}
})
}
プロパティ値
trafficmanagerprofiles
Name | 説明 | 値 |
---|---|---|
type | リソースの種類 | "Microsoft.Network/trafficmanagerprofiles@2017-05-01" |
name | リソース名 | string (必須) 文字数制限: 1 から 63 有効な文字: 英数字、ハイフン、およびピリオド。 先頭と末尾には英数字を使用します。 リソース名は、Azure 全体で一意である必要があります。 |
location | リソースが保存されている Azure リージョン | string |
parent_id | リソース グループにデプロイするには、そのリソース グループの ID を使用します。 | string (必須) |
tags | リソース タグ。 | タグの名前と値のディクショナリ。 |
properties | Traffic Manager プロファイルのプロパティ。 | ProfileProperties |
ProfileProperties
名前 | 説明 | 値 |
---|---|---|
dnsConfig | Traffic Manager プロファイルの DNS 設定。 | DnsConfig |
エンドポイント | Traffic Manager プロファイル内のエンドポイントの一覧。 | Endpoint[] |
monitorConfig | Traffic Manager プロファイルのエンドポイント監視設定。 | MonitorConfig |
profileStatus | Traffic Manager プロファイルの状態。 | "無効" "有効" |
trafficRoutingMethod | Traffic Manager プロファイルのトラフィック ルーティング方法。 | "地理的" "パフォーマンス" "Priority" "重み付け" |
DnsConfig
Name | 説明 | 値 |
---|---|---|
relativeName | この Traffic Manager プロファイルによって提供される相対 DNS 名。 Azure Traffic Manager が使用する DNS ドメイン名とこの値を組み合わせて、プロファイルの完全修飾ドメイン名 (FQDN) が形成されます。 | string |
ttl | DNS Time-To-Live (TTL) (秒単位)。 これにより、ローカル DNS リゾルバーと DNS クライアントに、この Traffic Manager プロファイルによって提供される DNS 応答をキャッシュする時間が通知されます。 | INT |
エンドポイント
Name | 説明 | 値 |
---|---|---|
properties | Traffic Manager エンドポイントのプロパティ。 | EndpointProperties |
EndpointProperties
名前 | 説明 | 値 |
---|---|---|
endpointLocation | "パフォーマンス" トラフィック ルーティング方法を使用する場合の外部エンドポイントまたは入れ子になったエンドポイントの場所を指定します。 | string |
endpointMonitorStatus | エンドポイントの監視状態。 | "CheckingEndpoint" "機能低下" "無効" "非アクティブ" "オンライン" "停止しました" |
endpointStatus | エンドポイントの状態。 エンドポイントが有効な場合、これはエンドポイントの正常性をプローブし、トラフィックのルーティング方法に含まれます。 | "無効" "有効" |
geoMapping | "地理的" トラフィック ルーティング方法を使用する場合に、このエンドポイントにマップされる国/地域の一覧。 受け入れられる値の完全な一覧については、Traffic Manager の地理的なドキュメントを参照してください。 | string[] |
minChildEndpoints | 親プロファイルを使用可能と見なすために子プロファイルで使用できる必要があるエンドポイントの最小数。 型 'NestedEndpoints' のエンドポイントにのみ適用されます。 | INT |
priority | "Priority" トラフィック ルーティング方法を使用する場合の、このエンドポイントの優先度。 使用できる値は 1 から 1000 で、低い値は優先度が高いことを表します。 これは省略可能なパラメーターです。 指定した場合、すべてのエンドポイントに指定する必要があります。2 つのエンドポイントが同じ優先度の値を共有することはできません。 | INT |
ターゲット (target) | エンドポイントの完全修飾 DNS 名。 トラフィック マネージャーは、このエンドポイントにトラフィックをダイレクトする DNS 応答にこの値を返します。 | string |
targetResourceId | エンドポイントの の Azure リソース URI。 "ExternalEndpoints" 型のエンドポイントには適用されません。 | string |
weight | "重み付け" トラフィック ルーティング方法を使用する場合の、このエンドポイントの重み。 使用できる値は 1 から 1000 です。 | INT |
MonitorConfig
Name | 説明 | 値 |
---|---|---|
intervalInSeconds | このプロファイル内のエンドポイントの監視間隔。 これは、Traffic Manager がこのプロファイル内の各エンドポイントの正常性をチェックする間隔です。 | INT |
path | エンドポイントの正常性のプローブに使用されるエンドポイント ドメイン名に対する相対パス。 | string |
port | エンドポイントの正常性のプローブに使用される TCP ポート。 | INT |
profileMonitorStatus | Traffic Manager プロファイルのプロファイル レベルの監視状態。 | "CheckingEndpoints" "機能低下" "無効" "非アクティブ" "オンライン" |
protocol | エンドポイントの正常性のプローブに使用されるプロトコル (HTTP、HTTPS、または TCP)。 | "HTTP" "HTTPS" "TCP" |
timeoutInSeconds | このプロファイル内のエンドポイントのモニター タイムアウト。 これは、Traffic Manager によって、このプロファイル内のエンドポイントが正常性チェックへの応答を許可する時間です。 | INT |
toleratedNumberOfFailures | このプロファイルでエンドポイントを宣言する前に Traffic Manager が許容する連続した失敗した正常性チェックの数は、次に失敗した正常性チェック後に低下します。 | int |