Freigeben über


Profiles - List By Resource Group

Listen alle Traffic Manager-Profile innerhalb einer Ressourcengruppe.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

Ruft die Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

ProfileListResult

Die Liste der Traffic Manager-Profile.

Other Status Codes

CloudError

Standardantwort. Es wird gemäß der Fehlerdefinition deserialisiert.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

ListProfilesByResourceGroup

Sample Request

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

Sample Response

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

Definitionen

Name Beschreibung
AllowedEndpointRecordType

Die zulässigen DNS-Eintragstypen für dieses Profil.

AlwaysServe

Wenn Always Serve aktiviert ist, wird die Überprüfung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode eingeschlossen.

CloudError

Vom Azure-Resource Manager zurückgegebener Fehler

CloudErrorBody

Der Inhalt eines vom Azure-Resource Manager zurückgegebenen Fehlers

CustomHeaders

Liste der benutzerdefinierten Header.

DnsConfig

Klasse, die DNS-Einstellungen in einem Traffic Manager-Profil enthält.

Endpoint

Klasse, die einen Traffic Manager-Endpunkt darstellt.

EndpointMonitorStatus

Die überwachung status des Endpunkts.

EndpointStatus

Die status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird dessen Integrität überprüft und der Endpunkt in die Verkehrsroutingmethode eingeschlossen.

ExpectedStatusCodeRanges

Liste der erwarteten status Codebereiche.

MonitorConfig

Klasse, die Endpunktüberwachungseinstellungen in einem Traffic Manager-Profil enthält.

MonitorProtocol

Das Protokoll (HTTP, HTTPS oder TCP), das zum Überprüfen der Endpunktintegrität verwendet wird.

Profile

Klasse, die ein Traffic Manager-Profil darstellt.

ProfileListResult

Die Antwort auf den Vorgang "Traffic Manager-Profile".

ProfileMonitorStatus

Die überwachung auf Profilebene status des Traffic Manager-Profils.

ProfileStatus

Die status des Traffic Manager-Profils.

Subnets

Die Liste der Subnetze, IP-Adressen und/oder Adressbereiche, die diesem Endpunkt zugeordnet sind, wenn die Datenverkehrsroutingmethode "Subnet" verwendet wird. Eine leere Liste entspricht allen Bereichen, die nicht von anderen Endpunkten abgedeckt werden.

TrafficRoutingMethod

Die Datenverkehrsroutingmethode des Traffic Manager-Profils.

TrafficViewEnrollmentStatus

Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. NULL, gibt "Disabled" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung".

AllowedEndpointRecordType

Die zulässigen DNS-Eintragstypen für dieses Profil.

Name Typ Beschreibung
Any

string

DomainName

string

IPv4Address

string

IPv6Address

string

AlwaysServe

Wenn Always Serve aktiviert ist, wird die Überprüfung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode eingeschlossen.

Name Typ Beschreibung
Disabled

string

Enabled

string

CloudError

Vom Azure-Resource Manager zurückgegebener Fehler

Name Typ Beschreibung
error

CloudErrorBody

Der Inhalt des Fehlers.

CloudErrorBody

Der Inhalt eines vom Azure-Resource Manager zurückgegebenen Fehlers

Name Typ Beschreibung
code

string

Fehlercode

details

CloudErrorBody[]

Fehlerdetails

message

string

Fehlermeldung

target

string

Fehlerziel

CustomHeaders

Liste der benutzerdefinierten Header.

Name Typ Beschreibung
name

string

Headername.

value

string

Headerwert.

DnsConfig

Klasse, die DNS-Einstellungen in einem Traffic Manager-Profil enthält.

Name Typ Beschreibung
fqdn

string

Der vollqualifizierte Domänenname (FQDN) des Traffic Manager-Profils. Dies wird aus der Verkettung von RelativeName mit der dns-Domäne gebildet, die von Azure Traffic Manager verwendet wird.

relativeName

string

Der relative DNS-Name, der von diesem Traffic Manager-Profil bereitgestellt wird. Dieser Wert wird mit dem DNS-Domänennamen kombiniert, der von Azure Traffic Manager zum Erstellen des vollqualifizierten Domänennamens (FQDN) des Profils verwendet wird.

ttl

integer

Die DNS-Gültigkeitsdauer (TTL) in Sekunden. Dadurch werden die lokalen DNS-Resolver und DNS-Clients darüber informiert, wie lange dns-Antworten, die von diesem Traffic Manager-Profil bereitgestellt werden, zwischengespeichert werden sollen.

Endpoint

Klasse, die einen Traffic Manager-Endpunkt darstellt.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Der Name der Ressource

properties.alwaysServe

AlwaysServe

Wenn Always Serve aktiviert ist, wird die Überprüfung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode eingeschlossen.

properties.customHeaders

CustomHeaders[]

Liste der benutzerdefinierten Header.

properties.endpointLocation

string

Gibt den Speicherort der externen oder geschachtelten Endpunkte an, wenn die Datenverkehrsroutingmethode "Performance" verwendet wird.

properties.endpointMonitorStatus

EndpointMonitorStatus

Die überwachung status des Endpunkts.

properties.endpointStatus

EndpointStatus

Die status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird dessen Integrität überprüft und der Endpunkt in die Verkehrsroutingmethode eingeschlossen.

properties.geoMapping

string[]

Die Liste der Länder/Regionen, die diesem Endpunkt zugeordnet sind, wenn die Routingmethode "Geografischer Datenverkehr" verwendet wird. Eine vollständige Liste der akzeptierten Werte finden Sie in der geografischen Dokumentation zu Traffic Manager.

properties.minChildEndpoints

integer

Die Mindestanzahl von Endpunkten, die im untergeordneten Profil verfügbar sein müssen, damit das übergeordnete Profil als verfügbar betrachtet wird. Gilt nur für Endpunkte vom Typ "NestedEndpoints".

properties.minChildEndpointsIPv4

integer

Die Mindestanzahl von IPv4-Endpunkten (DNS-Eintragstyp A), die im untergeordneten Profil verfügbar sein müssen, damit das übergeordnete Profil als verfügbar betrachtet wird. Gilt nur für Endpunkte vom Typ "NestedEndpoints".

properties.minChildEndpointsIPv6

integer

Die Mindestanzahl von IPv6-Endpunkten (DNS-Eintragstyp AAAA), die im untergeordneten Profil verfügbar sein müssen, damit das übergeordnete Profil als verfügbar betrachtet wird. Gilt nur für Endpunkte vom Typ "NestedEndpoints".

properties.priority

integer

Die Priorität dieses Endpunkts bei Verwendung der Datenverkehrsroutingmethode "Priority". Mögliche Werte sind zwischen 1 und 1000, niedrigere Werte stellen eine höhere Priorität dar. Dies ist ein optionaler Parameter. Falls angegeben, muss er für alle Endpunkte festgelegt werden. Außerdem dürfen zwei Endpunkte nicht denselben Prioritätswert aufweisen.

properties.subnets

Subnets[]

Die Liste der Subnetze, IP-Adressen und/oder Adressbereiche, die diesem Endpunkt zugeordnet sind, wenn die Datenverkehrsroutingmethode "Subnet" verwendet wird. Eine leere Liste entspricht allen Bereichen, die nicht von anderen Endpunkten abgedeckt werden.

properties.target

string

Der vollqualifizierte DNS-Name oder die IP-Adresse des Endpunkts. Traffic Manager gibt diesen Wert in DNS-Antworten zurück, um den Datenverkehr an diesen Endpunkt umzuleiten.

properties.targetResourceId

string

Der Azure-Ressourcen-URI des Endpunkts. Gilt nicht für Endpunkte vom Typ "ExternalEndpoints".

properties.weight

integer

Die Gewichtung dieses Endpunkts bei Verwendung der Datenverkehrsroutingmethode "Gewichtet". Mögliche Werte sind 1 bis 1000.

type

string

Der Typ der Ressource. Beispiel: Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Die überwachung status des Endpunkts.

Name Typ Beschreibung
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

Die status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird dessen Integrität überprüft und der Endpunkt in die Verkehrsroutingmethode eingeschlossen.

Name Typ Beschreibung
Disabled

string

Enabled

string

ExpectedStatusCodeRanges

Liste der erwarteten status Codebereiche.

Name Typ Beschreibung
max

integer

Max. status Code.

min

integer

Min. status Code.

MonitorConfig

Klasse, die Endpunktüberwachungseinstellungen in einem Traffic Manager-Profil enthält.

Name Typ Beschreibung
customHeaders

CustomHeaders[]

Liste der benutzerdefinierten Header.

expectedStatusCodeRanges

ExpectedStatusCodeRanges[]

Liste der erwarteten status Codebereiche.

intervalInSeconds

integer

Das Überwachungsintervall für Endpunkte in diesem Profil. Dies ist das Intervall, in dem Traffic Manager die Integrität der einzelnen Endpunkte in diesem Profil überprüft.

path

string

Der Pfad relativ zum Endpunktdomänennamen, der zum Überprüfen der Endpunktintegrität verwendet wird.

port

integer

Der TCP-Port, der verwendet wird, um die Endpunktintegrität zu überprüfen.

profileMonitorStatus

ProfileMonitorStatus

Die überwachung auf Profilebene status des Traffic Manager-Profils.

protocol

MonitorProtocol

Das Protokoll (HTTP, HTTPS oder TCP), das zum Überprüfen der Endpunktintegrität verwendet wird.

timeoutInSeconds

integer

Das Monitortimeout für Endpunkte in diesem Profil. Dies ist der Zeitpunkt, zu dem Traffic Manager Endpunkten in diesem Profil erlaubt, auf die Integritätsprüfung zu reagieren.

toleratedNumberOfFailures

integer

Die Anzahl der aufeinanderfolgenden fehlerhaften Integritätsprüfung, die Traffic Manager toleriert, bevor ein Endpunkt in diesem Profil nach der nächsten fehlerhaften Integritätsprüfung als herabgestuft deklariert wird.

MonitorProtocol

Das Protokoll (HTTP, HTTPS oder TCP), das zum Überprüfen der Endpunktintegrität verwendet wird.

Name Typ Beschreibung
HTTP

string

HTTPS

string

TCP

string

Profile

Klasse, die ein Traffic Manager-Profil darstellt.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

location

string

Die Azure-Region, in der sich die Ressource befindet

name

string

Der Name der Ressource

properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

Die Liste der zulässigen Endpunktdatensatztypen.

properties.dnsConfig

DnsConfig

Die DNS-Einstellungen des Traffic Manager-Profils.

properties.endpoints

Endpoint[]

Die Liste der Endpunkte im Traffic Manager-Profil.

properties.maxReturn

integer

Maximale Anzahl von Endpunkten, die für den MultiValue-Routingtyp zurückgegeben werden sollen.

properties.monitorConfig

MonitorConfig

Die Endpunktüberwachungseinstellungen des Traffic Manager-Profils.

properties.profileStatus

ProfileStatus

Die status des Traffic Manager-Profils.

properties.trafficRoutingMethod

TrafficRoutingMethod

Die Datenverkehrsroutingmethode des Traffic Manager-Profils.

properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. NULL, gibt "Disabled" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung".

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Beispiel: Microsoft.Network/trafficManagerProfiles.

ProfileListResult

Die Antwort auf den Vorgang "Traffic Manager-Profile".

Name Typ Beschreibung
value

Profile[]

Ruft die Liste der Traffic Manager-Profile ab.

ProfileMonitorStatus

Die überwachung auf Profilebene status des Traffic Manager-Profils.

Name Typ Beschreibung
CheckingEndpoints

string

Degraded

string

Disabled

string

Inactive

string

Online

string

ProfileStatus

Die status des Traffic Manager-Profils.

Name Typ Beschreibung
Disabled

string

Enabled

string

Subnets

Die Liste der Subnetze, IP-Adressen und/oder Adressbereiche, die diesem Endpunkt zugeordnet sind, wenn die Datenverkehrsroutingmethode "Subnet" verwendet wird. Eine leere Liste entspricht allen Bereichen, die nicht von anderen Endpunkten abgedeckt werden.

Name Typ Beschreibung
first

string

Erste Adresse im Subnetz.

last

string

Letzte Adresse im Subnetz.

scope

integer

Blockgröße (Anzahl der führenden Bits in der Subnetzmaske).

TrafficRoutingMethod

Die Datenverkehrsroutingmethode des Traffic Manager-Profils.

Name Typ Beschreibung
Geographic

string

MultiValue

string

Performance

string

Priority

string

Subnet

string

Weighted

string

TrafficViewEnrollmentStatus

Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. NULL, gibt "Disabled" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung".

Name Typ Beschreibung
Disabled

string

Enabled

string