Udostępnij za pośrednictwem


Profiles - List By Resource Group

Listy wszystkich profilów usługi Traffic Manager w grupie zasobów.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles?api-version=2022-04-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Pobiera poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True

string

Wersja interfejsu API klienta.

Odpowiedzi

Nazwa Typ Opis
200 OK

ProfileListResult

Lista profilów usługi Traffic Manager.

Other Status Codes

CloudError

Domyślna odpowiedź. Zostanie ona deserializacji zgodnie z definicją błędu.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

ListProfilesByResourceGroup

Przykładowe żądanie

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficmanagerprofiles?api-version=2022-04-01

Przykładowa odpowiedź

{
  "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"
            }
          }
        ]
      }
    }
  ]
}

Definicje

Nazwa Opis
AllowedEndpointRecordType

Dozwolony typ typów rekordów DNS dla tego profilu.

AlwaysServe

Jeśli opcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

CloudError

Błąd zwrócony przez usługę Azure Resource Manager

CloudErrorBody

Zawartość błędu zwróconego przez usługę Azure Resource Manager

CustomHeaders

Lista nagłówków niestandardowych.

DnsConfig

Klasa zawierająca ustawienia DNS w profilu usługi Traffic Manager.

Endpoint

Klasa reprezentująca punkt końcowy usługi Traffic Manager.

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

ExpectedStatusCodeRanges

Lista oczekiwanych zakresów kodu stanu.

MonitorConfig

Klasa zawierająca ustawienia monitorowania punktu końcowego w profilu usługi Traffic Manager.

MonitorProtocol

Protokół (HTTP, HTTPS lub TCP) używany do sondowania kondycji punktu końcowego.

Profile

Klasa reprezentująca profil usługi Traffic Manager.

ProfileListResult

Lista odpowiedzi operacji profilów usługi Traffic Manager.

ProfileMonitorStatus

Stan monitorowania na poziomie profilu usługi Traffic Manager.

ProfileStatus

Stan profilu usługi Traffic Manager.

Subnets

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

TrafficRoutingMethod

Metoda routingu ruchu profilu usługi Traffic Manager.

TrafficViewEnrollmentStatus

Wskazuje, czy widok ruchu jest włączony, czy wyłączony dla profilu usługi Traffic Manager. Wartość null oznacza wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.

AllowedEndpointRecordType

Dozwolony typ typów rekordów DNS dla tego profilu.

Nazwa Typ Opis
Any

string

DomainName

string

IPv4Address

string

IPv6Address

string

AlwaysServe

Jeśli opcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

Nazwa Typ Opis
Disabled

string

Enabled

string

CloudError

Błąd zwrócony przez usługę Azure Resource Manager

Nazwa Typ Opis
error

CloudErrorBody

Zawartość błędu.

CloudErrorBody

Zawartość błędu zwróconego przez usługę Azure Resource Manager

Nazwa Typ Opis
code

string

Kod błędu

details

CloudErrorBody[]

Szczegóły błędu

message

string

Komunikat o błędzie

target

string

Błąd docelowy

CustomHeaders

Lista nagłówków niestandardowych.

Nazwa Typ Opis
name

string

Nazwa nagłówka.

value

string

Wartość nagłówka.

DnsConfig

Klasa zawierająca ustawienia DNS w profilu usługi Traffic Manager.

Nazwa Typ Opis
fqdn

string

W pełni kwalifikowana nazwa domeny (FQDN) profilu usługi Traffic Manager. Jest to tworzone na podstawie łączenia nazwy względnej z domeną DNS używaną przez usługę Azure Traffic Manager.

relativeName

string

Względna nazwa DNS podana przez ten profil usługi Traffic Manager. Ta wartość jest połączona z nazwą domeny DNS używaną przez usługę Azure Traffic Manager w celu utworzenia w pełni kwalifikowanej nazwy domeny (FQDN) profilu.

ttl

integer

Czas wygaśnięcia (TTL) w systemie DNS w sekundach. Informuje to o tym lokalnych programach rozpoznawania nazw DNS i klientach DNS, jak długo buforować odpowiedzi DNS dostarczone przez ten profil usługi Traffic Manager.

Endpoint

Klasa reprezentująca punkt końcowy usługi Traffic Manager.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Nazwa zasobu

properties.alwaysServe

AlwaysServe

Jeśli funkcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

properties.customHeaders

CustomHeaders[]

Lista nagłówków niestandardowych.

properties.endpointLocation

string

Określa lokalizację zewnętrznych lub zagnieżdżonych punktów końcowych podczas korzystania z metody routingu ruchu "Wydajność".

properties.endpointMonitorStatus

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

properties.endpointStatus

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

properties.geoMapping

string[]

Lista krajów/regionów zamapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu geograficznego. Aby uzyskać pełną listę akceptowanych wartości, zapoznaj się z dokumentacją geograficzną usługi Traffic Manager.

properties.minChildEndpoints

integer

Minimalna liczba punktów końcowych, które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.minChildEndpointsIPv4

integer

Minimalna liczba punktów końcowych IPv4 (typ rekordu DNS A), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.minChildEndpointsIPv6

integer

Minimalna liczba punktów końcowych IPv6 (typu rekordu DNS AAAA), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.priority

integer

Priorytet tego punktu końcowego podczas korzystania z metody routingu ruchu "Priorytet". Możliwe wartości to od 1 do 1000, niższe wartości reprezentują wyższy priorytet. Jest to opcjonalny parametr. Jeśli zostanie określony, należy go określić we wszystkich punktach końcowych, a żadne dwa punkty końcowe nie mogą współdzielić tej samej wartości priorytetu.

properties.subnets

Subnets[]

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

properties.target

string

W pełni kwalifikowana nazwa DNS lub adres IP punktu końcowego. Usługa Traffic Manager zwraca tę wartość w odpowiedziach DNS, aby skierować ruch do tego punktu końcowego.

properties.targetResourceId

string

Identyfikator URI zasobu platformy Azure punktu końcowego. Nie dotyczy punktów końcowych typu "ExternalEndpoints".

properties.weight

integer

Waga tego punktu końcowego podczas korzystania z metody routingu ruchu "Ważona". Możliwe wartości to od 1 do 1000.

type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

Nazwa Typ Opis
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

Nazwa Typ Opis
Disabled

string

Enabled

string

ExpectedStatusCodeRanges

Lista oczekiwanych zakresów kodu stanu.

Nazwa Typ Opis
max

integer

Maksymalny kod stanu.

min

integer

Minimalny kod stanu.

MonitorConfig

Klasa zawierająca ustawienia monitorowania punktu końcowego w profilu usługi Traffic Manager.

Nazwa Typ Opis
customHeaders

CustomHeaders[]

Lista nagłówków niestandardowych.

expectedStatusCodeRanges

ExpectedStatusCodeRanges[]

Lista oczekiwanych zakresów kodu stanu.

intervalInSeconds

integer

Interwał monitorowania punktów końcowych w tym profilu. Jest to interwał, w którym usługa Traffic Manager sprawdzi kondycję każdego punktu końcowego w tym profilu.

path

string

Ścieżka względem nazwy domeny punktu końcowego używanej do sondowania kondycji punktu końcowego.

port

integer

Port TCP używany do sondowania kondycji punktu końcowego.

profileMonitorStatus

ProfileMonitorStatus

Stan monitorowania na poziomie profilu usługi Traffic Manager.

protocol

MonitorProtocol

Protokół (HTTP, HTTPS lub TCP) używany do sondowania kondycji punktu końcowego.

timeoutInSeconds

integer

Limit czasu monitora dla punktów końcowych w tym profilu. Jest to czas, przez który usługa Traffic Manager zezwala punktom końcowym w tym profilu na reagowanie na kontrolę kondycji.

toleratedNumberOfFailures

integer

Liczba kolejnych nieudanych kontroli kondycji, które usługa Traffic Manager tolerowała przed zadeklarowaniem punktu końcowego w tym profilu Obniżona wydajność po następnym nieudanym sprawdzeniu kondycji.

MonitorProtocol

Protokół (HTTP, HTTPS lub TCP) używany do sondowania kondycji punktu końcowego.

Nazwa Typ Opis
HTTP

string

HTTPS

string

TCP

string

Profile

Klasa reprezentująca profil usługi Traffic Manager.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

location

string

Region świadczenia usługi Azure, w którym znajduje się zasób

name

string

Nazwa zasobu

properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

Lista dozwolonych typów rekordów punktu końcowego.

properties.dnsConfig

DnsConfig

Ustawienia DNS profilu usługi Traffic Manager.

properties.endpoints

Endpoint[]

Lista punktów końcowych w profilu usługi Traffic Manager.

properties.maxReturn

integer

Maksymalna liczba punktów końcowych do zwrócenia dla typu routingu MultiValue.

properties.monitorConfig

MonitorConfig

Ustawienia monitorowania punktu końcowego profilu usługi Traffic Manager.

properties.profileStatus

ProfileStatus

Stan profilu usługi Traffic Manager.

properties.trafficRoutingMethod

TrafficRoutingMethod

Metoda routingu ruchu profilu usługi Traffic Manager.

properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Wskazuje, czy widok ruchu jest włączony, czy wyłączony dla profilu usługi Traffic Manager. Wartość null oznacza wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

ProfileListResult

Lista odpowiedzi operacji profilów usługi Traffic Manager.

Nazwa Typ Opis
value

Profile[]

Pobiera listę profilów usługi Traffic Manager.

ProfileMonitorStatus

Stan monitorowania na poziomie profilu usługi Traffic Manager.

Nazwa Typ Opis
CheckingEndpoints

string

Degraded

string

Disabled

string

Inactive

string

Online

string

ProfileStatus

Stan profilu usługi Traffic Manager.

Nazwa Typ Opis
Disabled

string

Enabled

string

Subnets

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

Nazwa Typ Opis
first

string

Pierwszy adres w podsieci.

last

string

Ostatni adres w podsieci.

scope

integer

Rozmiar bloku (liczba bitów wiodących w masce podsieci).

TrafficRoutingMethod

Metoda routingu ruchu profilu usługi Traffic Manager.

Nazwa Typ Opis
Geographic

string

MultiValue

string

Performance

string

Priority

string

Subnet

string

Weighted

string

TrafficViewEnrollmentStatus

Wskazuje, czy widok ruchu jest włączony, czy wyłączony dla profilu usługi Traffic Manager. Wartość null oznacza wartość "Disabled". Włączenie tej funkcji zwiększy koszt profilu Zarządzanie ruchem.

Nazwa Typ Opis
Disabled

string

Enabled

string