Profiles - List By Resource Group
리소스 그룹 내의 모든 Traffic Manager 프로필을 Lists.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles?api-version=2022-04-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명을 가져옵니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
Traffic Manager 프로필 목록입니다. |
|
Other Status Codes |
기본 응답입니다. 오류 정의에 따라 역직렬화됩니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
ListProfilesByResourceGroup
샘플 요청
샘플 응답
{
"value": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager1005",
"name": "azuresdkfornetautoresttrafficmanager1005",
"type": "Microsoft.Network/trafficManagerProfiles",
"location": "global",
"tags": {},
"properties": {
"profileStatus": "Enabled",
"trafficRoutingMethod": "Performance",
"dnsConfig": {
"relativeName": "azuresdkfornetautoresttrafficmanager1005",
"fqdn": "azuresdkfornetautoresttrafficmanager1005.tmpreview.watmtest.azure-test.net",
"ttl": 35
},
"monitorConfig": {
"profileMonitorStatus": "Online",
"protocol": "HTTP",
"port": 80,
"path": "/testpath.aspx",
"intervalInSeconds": 30,
"toleratedNumberOfFailures": 3,
"timeoutInSeconds": 10
},
"endpoints": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager1005/externalEndpoints/My external endpoint",
"name": "My external endpoint",
"type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
"properties": {
"endpointStatus": "Enabled",
"endpointMonitorStatus": "CheckingEndpoint",
"target": "foobar.contoso.com",
"weight": 1,
"priority": 1,
"endpointLocation": "North Europe"
}
}
]
}
},
{
"id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager959",
"name": "azuresdkfornetautoresttrafficmanager959",
"type": "Microsoft.Network/trafficManagerProfiles",
"location": "global",
"tags": {},
"properties": {
"profileStatus": "Enabled",
"trafficRoutingMethod": "Performance",
"dnsConfig": {
"relativeName": "azuresdkfornetautoresttrafficmanager959",
"fqdn": "azuresdkfornetautoresttrafficmanager959.tmpreview.watmtest.azure-test.net",
"ttl": 35
},
"monitorConfig": {
"profileMonitorStatus": "Online",
"protocol": "HTTP",
"port": 80,
"path": "/testpath.aspx",
"intervalInSeconds": 30,
"toleratedNumberOfFailures": 3,
"timeoutInSeconds": 10
},
"endpoints": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager959/externalEndpoints/My external endpoint",
"name": "My external endpoint",
"type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
"properties": {
"endpointStatus": "Enabled",
"endpointMonitorStatus": "Online",
"target": "foobar.contoso.com",
"weight": 1,
"priority": 1,
"endpointLocation": "North Europe"
}
}
]
}
}
]
}
정의
Name | Description |
---|---|
Allowed |
이 프로필에 허용되는 형식 DNS 레코드 형식입니다. |
Always |
Always Serve를 사용하도록 설정하면 엔드포인트 상태에 대한 검색이 비활성화되고 엔드포인트가 트래픽 라우팅 메서드에 포함됩니다. |
Cloud |
Azure Resource Manager 반환된 오류 |
Cloud |
Azure Resource Manager 반환된 오류의 내용 |
Custom |
사용자 지정 헤더 목록입니다. |
Dns |
Traffic Manager 프로필의 DNS 설정을 포함하는 클래스입니다. |
Endpoint |
Traffic Manager 엔드포인트를 나타내는 클래스입니다. |
Endpoint |
엔드포인트의 모니터링 상태. |
Endpoint |
엔드포인트의 상태. 엔드포인트 상태가 Enabled이면 엔드포인트 상태가 검색된 것이며 엔드포인트가 트래픽 라우팅 방법에 포함됩니다. |
Expected |
예상되는 상태 코드 범위 목록입니다. |
Monitor |
Traffic Manager 프로필의 엔드포인트 모니터링 설정을 포함하는 클래스입니다. |
Monitor |
엔드포인트 상태를 검색하는 데 사용되는 프로토콜(HTTP, HTTPS 또는 TCP)입니다. |
Profile |
Traffic Manager 프로필을 나타내는 클래스입니다. |
Profile |
Traffic Manager 프로필 작업 응답 목록입니다. |
Profile |
Traffic Manager 프로필의 프로필 수준 모니터링 상태. |
Profile |
Traffic Manager 프로필의 상태. |
Subnets |
'서브넷' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트에 매핑된 서브넷, IP 주소 및/또는 주소 범위 목록입니다. 빈 목록은 다른 엔드포인트에서 다루지 않는 모든 범위와 일치합니다. |
Traffic |
Traffic Manager 프로필의 트래픽 라우팅 메서드입니다. |
Traffic |
Traffic Manager 프로필에 대한 트래픽 보기가 '사용' 또는 '사용 안 함'인지 여부를 나타냅니다. Null은 'Disabled'를 나타냅니다. 이 기능을 사용하도록 설정하면 트래픽 관리 프로필의 비용이 증가합니다. |
AllowedEndpointRecordType
이 프로필에 허용되는 형식 DNS 레코드 형식입니다.
Name | 형식 | Description |
---|---|---|
Any |
string |
|
DomainName |
string |
|
IPv4Address |
string |
|
IPv6Address |
string |
AlwaysServe
Always Serve를 사용하도록 설정하면 엔드포인트 상태에 대한 검색이 비활성화되고 엔드포인트가 트래픽 라우팅 메서드에 포함됩니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
CloudError
Azure Resource Manager 반환된 오류
Name | 형식 | Description |
---|---|---|
error |
오류의 내용입니다. |
CloudErrorBody
Azure Resource Manager 반환된 오류의 내용
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드 |
details |
오류 세부 정보 |
|
message |
string |
오류 메시지 |
target |
string |
오류 대상 |
CustomHeaders
사용자 지정 헤더 목록입니다.
Name | 형식 | Description |
---|---|---|
name |
string |
헤더 이름입니다. |
value |
string |
헤더 값입니다. |
DnsConfig
Traffic Manager 프로필의 DNS 설정을 포함하는 클래스입니다.
Name | 형식 | Description |
---|---|---|
fqdn |
string |
Traffic Manager 프로필의 FQDN(정규화된 도메인 이름)입니다. 이는 RelativeName과 Azure Traffic Manager에서 사용하는 DNS 도메인의 연결에서 형성됩니다. |
relativeName |
string |
이 Traffic Manager 프로필에서 제공하는 상대 DNS 이름입니다. 이 값은 프로필의 FQDN(정규화된 도메인 이름)을 형성하여 Azure Traffic Manager가 사용하는 DNS 도메인 이름과 결합됩니다. |
ttl |
integer |
DNS TTL(Time To Live)(초)입니다. 그러면 로컬 DNS 확인자 및 DNS 클라이언트가 이 Traffic Manager 프로필에서 제공하는 DNS 응답을 캐시하는 기간을 알 수 있습니다. |
Endpoint
Traffic Manager 엔드포인트를 나타내는 클래스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
name |
string |
리소스의 이름입니다. |
properties.alwaysServe |
Always Serve를 사용하도록 설정하면 엔드포인트 상태에 대한 검색이 비활성화되고 엔드포인트가 트래픽 라우팅 메서드에 포함됩니다. |
|
properties.customHeaders |
사용자 지정 헤더 목록입니다. |
|
properties.endpointLocation |
string |
'성능' 트래픽 라우팅 방법을 사용할 때 외부 또는 중첩 엔드포인트의 위치를 지정합니다. |
properties.endpointMonitorStatus |
엔드포인트의 모니터링 상태. |
|
properties.endpointStatus |
엔드포인트의 상태. 엔드포인트 상태가 Enabled이면 엔드포인트 상태가 검색된 것이며 엔드포인트가 트래픽 라우팅 방법에 포함됩니다. |
|
properties.geoMapping |
string[] |
'지리적' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트에 매핑된 국가/지역 목록입니다. 허용되는 값의 전체 목록은 Traffic Manager 지리적 설명서를 참조하세요. |
properties.minChildEndpoints |
integer |
부모 프로필을 사용할 수 있는 것으로 간주하려면 자식 프로필에서 사용할 수 있어야 하는 최소 엔드포인트 수입니다. 'NestedEndpoints' 형식의 엔드포인트에만 적용됩니다. |
properties.minChildEndpointsIPv4 |
integer |
부모 프로필을 사용할 수 있는 것으로 간주하려면 자식 프로필에서 사용할 수 있어야 하는 최소 IPv4(DNS 레코드 형식 A) 엔드포인트 수입니다. 'NestedEndpoints' 형식의 엔드포인트에만 적용됩니다. |
properties.minChildEndpointsIPv6 |
integer |
부모 프로필을 사용할 수 있는 것으로 간주하려면 자식 프로필에서 사용할 수 있어야 하는 최소 IPv6(DNS 레코드 형식 AAAA) 엔드포인트 수입니다. 'NestedEndpoints' 형식의 엔드포인트에만 적용됩니다. |
properties.priority |
integer |
'우선 순위' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트의 우선 순위입니다. 가능한 값은 1에서 1000까지이며, 낮은 값은 더 높은 우선 순위를 나타냅니다. 선택적 매개 변수입니다. 지정하는 경우에는 모든 엔드포인트에서 지정해야 하며 두 엔드포인트가 같은 우선 순위 값을 공유할 수는 없습니다. |
properties.subnets |
Subnets[] |
'서브넷' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트에 매핑된 서브넷, IP 주소 및/또는 주소 범위 목록입니다. 빈 목록은 다른 엔드포인트에서 다루지 않는 모든 범위와 일치합니다. |
properties.target |
string |
엔드포인트의 정규화된 DNS 이름 또는 IP 주소입니다. 트래픽 관리자는 DNS 응답에서 이 값을 반환하여 트래픽을 이 엔드포인트로 이동합니다. |
properties.targetResourceId |
string |
엔드포인트의 의 Azure 리소스 URI입니다. 'ExternalEndpoints' 형식의 엔드포인트에는 적용되지 않습니다. |
properties.weight |
integer |
'가중치' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트의 가중치입니다. 가능한 값은 1에서 1000까지입니다. |
type |
string |
리소스 형식입니다. 예- Microsoft.Network/trafficManagerProfiles. |
EndpointMonitorStatus
엔드포인트의 모니터링 상태.
Name | 형식 | Description |
---|---|---|
CheckingEndpoint |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
|
Stopped |
string |
|
Unmonitored |
string |
EndpointStatus
엔드포인트의 상태. 엔드포인트 상태가 Enabled이면 엔드포인트 상태가 검색된 것이며 엔드포인트가 트래픽 라우팅 방법에 포함됩니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpectedStatusCodeRanges
예상되는 상태 코드 범위 목록입니다.
Name | 형식 | Description |
---|---|---|
max |
integer |
최대 상태 코드입니다. |
min |
integer |
최소 상태 코드입니다. |
MonitorConfig
Traffic Manager 프로필의 엔드포인트 모니터링 설정을 포함하는 클래스입니다.
Name | 형식 | Description |
---|---|---|
customHeaders |
사용자 지정 헤더 목록입니다. |
|
expectedStatusCodeRanges |
예상되는 상태 코드 범위 목록입니다. |
|
intervalInSeconds |
integer |
이 프로필의 엔드포인트에 대한 모니터 간격입니다. 이 간격은 Traffic Manager가 이 프로필에서 각 엔드포인트의 상태를 검사 간격입니다. |
path |
string |
엔드포인트 상태를 검색하는 데 사용되는 엔드포인트 도메인 이름을 기준으로 하는 경로입니다. |
port |
integer |
엔드포인트 상태를 검색하는 데 사용되는 TCP 포트입니다. |
profileMonitorStatus |
Traffic Manager 프로필의 프로필 수준 모니터링 상태. |
|
protocol |
엔드포인트 상태를 검색하는 데 사용되는 프로토콜(HTTP, HTTPS 또는 TCP)입니다. |
|
timeoutInSeconds |
integer |
이 프로필의 엔드포인트에 대한 모니터 시간 제한입니다. Traffic Manager가 이 프로필의 엔드포인트가 상태 검사 응답하도록 허용하는 시간입니다. |
toleratedNumberOfFailures |
integer |
이 프로필에서 엔드포인트를 선언하기 전에 Traffic Manager가 허용할 수 있는 연속 실패 상태 검사 수는 다음 실패 상태 검사 후 성능이 저하되었습니다. |
MonitorProtocol
엔드포인트 상태를 검색하는 데 사용되는 프로토콜(HTTP, HTTPS 또는 TCP)입니다.
Name | 형식 | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
|
TCP |
string |
Profile
Traffic Manager 프로필을 나타내는 클래스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
리소스가 있는 Azure 지역 |
name |
string |
리소스의 이름입니다. |
properties.allowedEndpointRecordTypes |
허용되는 엔드포인트 레코드 유형의 목록입니다. |
|
properties.dnsConfig |
Traffic Manager 프로필의 DNS 설정입니다. |
|
properties.endpoints |
Endpoint[] |
Traffic Manager 프로필의 엔드포인트 목록입니다. |
properties.maxReturn |
integer |
MultiValue 라우팅 유형에 대해 반환할 최대 엔드포인트 수입니다. |
properties.monitorConfig |
Traffic Manager 프로필의 엔드포인트 모니터링 설정입니다. |
|
properties.profileStatus |
Traffic Manager 프로필의 상태. |
|
properties.trafficRoutingMethod |
Traffic Manager 프로필의 트래픽 라우팅 메서드입니다. |
|
properties.trafficViewEnrollmentStatus |
Traffic Manager 프로필에 대한 트래픽 보기가 '사용' 또는 '사용 안 함'인지 여부를 나타냅니다. Null은 'Disabled'를 나타냅니다. 이 기능을 사용하도록 설정하면 트래픽 관리 프로필의 비용이 증가합니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 형식입니다. 예- Microsoft.Network/trafficManagerProfiles. |
ProfileListResult
Traffic Manager 프로필 작업 응답 목록입니다.
Name | 형식 | Description |
---|---|---|
value |
Profile[] |
Traffic Manager 프로필 목록을 가져옵니다. |
ProfileMonitorStatus
Traffic Manager 프로필의 프로필 수준 모니터링 상태.
Name | 형식 | Description |
---|---|---|
CheckingEndpoints |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
ProfileStatus
Traffic Manager 프로필의 상태.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnets
'서브넷' 트래픽 라우팅 방법을 사용할 때 이 엔드포인트에 매핑된 서브넷, IP 주소 및/또는 주소 범위 목록입니다. 빈 목록은 다른 엔드포인트에서 다루지 않는 모든 범위와 일치합니다.
Name | 형식 | Description |
---|---|---|
first |
string |
서브넷의 첫 번째 주소입니다. |
last |
string |
서브넷의 마지막 주소입니다. |
scope |
integer |
블록 크기(서브넷 마스크의 선행 비트 수). |
TrafficRoutingMethod
Traffic Manager 프로필의 트래픽 라우팅 메서드입니다.
Name | 형식 | Description |
---|---|---|
Geographic |
string |
|
MultiValue |
string |
|
Performance |
string |
|
Priority |
string |
|
Subnet |
string |
|
Weighted |
string |
TrafficViewEnrollmentStatus
Traffic Manager 프로필에 대한 트래픽 보기가 '사용' 또는 '사용 안 함'인지 여부를 나타냅니다. Null은 'Disabled'를 나타냅니다. 이 기능을 사용하도록 설정하면 트래픽 관리 프로필의 비용이 증가합니다.
Name | 형식 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |