Freigeben über


Endpoints - Get

Ruft einen Traffic Manager-Endpunkt ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpointName
path True

string

Der Name des Traffic Manager-Endpunkts.

endpointType
path True

EndpointType

Der Typ des Traffic Manager-Endpunkts.

profileName
path True

string

Der Name des Traffic Manager-Profils.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

Ruft 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

Endpoint

Der Traffic Manager-Endpunkt.

Other Status Codes

CloudError

Standardantwort. Sie wird gemäß der Fehlerdefinition deserialisiert.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Endpoint-GET-External-WithGeoMapping
Endpoint-GET-External-WithLocation
Endpoint-GET-External-WithSubnetMapping

Endpoint-GET-External-WithGeoMapping

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager8224/ExternalEndpoints/My%20external%20endpoint?api-version=2022-04-01

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager8224/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,
    "geoMapping": [
      "GEO-AS",
      "GEO-AF"
    ]
  }
}

Endpoint-GET-External-WithLocation

Beispielanforderung

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

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "name": "azsmnet7187",
  "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
  "properties": {
    "endpointStatus": "Enabled",
    "endpointMonitorStatus": "CheckingEndpoint",
    "target": "foobar.contoso.com",
    "weight": 1,
    "priority": 1,
    "endpointLocation": "North Europe"
  }
}

Endpoint-GET-External-WithSubnetMapping

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager8224/ExternalEndpoints/My%20external%20endpoint?api-version=2022-04-01

Beispiel für eine Antwort

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager8224/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,
    "subnets": [
      {
        "first": "1.2.3.0",
        "scope": 24
      },
      {
        "first": "25.26.27.28",
        "last": "29.30.31.32"
      }
    ]
  }
}

Definitionen

Name Beschreibung
AlwaysServe

Wenn Always Serve aktiviert ist, wird die Ermittlung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen.

CloudError

Ein Fehler, der vom Azure Resource Manager zurückgegeben wird

CloudErrorBody

Der Inhalt eines Fehlers, der vom Azure Resource Manager zurückgegeben wird

CustomHeaders

Liste der benutzerdefinierten Kopfzeilen.

Endpoint

Klasse, die einen Traffic Manager-Endpunkt darstellt.

EndpointMonitorStatus

Der Überwachungsstatus des Endpunkts.

EndpointStatus

Der Status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird er auf die Endpunktintegrität untersucht und in der Datenverkehrsroutingmethode enthalten.

EndpointType

Der Typ des Traffic Manager-Endpunkts.

Subnets

Die Liste der Subnetze, IP-Adressen und/oder Adressbereiche, die diesem Endpunkt bei Verwendung der Routingmethode "Subnetz" zugeordnet sind. Eine leere Liste entspricht allen Bereichen, die nicht von anderen Endpunkten abgedeckt werden.

AlwaysServe

Wenn Always Serve aktiviert ist, wird die Ermittlung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen.

Wert Beschreibung
Disabled
Enabled

CloudError

Ein Fehler, der vom Azure Resource Manager zurückgegeben wird

Name Typ Beschreibung
error

CloudErrorBody

Der Inhalt des Fehlers.

CloudErrorBody

Der Inhalt eines Fehlers, der vom Azure Resource Manager zurückgegeben wird

Name Typ Beschreibung
code

string

Fehlercode

details

CloudErrorBody[]

Fehlerdetails

message

string

Fehlermeldung

target

string

Fehlerziel

CustomHeaders

Liste der benutzerdefinierten Kopfzeilen.

Name Typ Beschreibung
name

string

Kopfzeilenname.

value

string

Headerwert.

Endpoint

Klasse, die einen Traffic Manager-Endpunkt darstellt.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /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 Ermittlung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen.

properties.customHeaders

CustomHeaders[]

Liste der benutzerdefinierten Kopfzeilen.

properties.endpointLocation

string

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

properties.endpointMonitorStatus

EndpointMonitorStatus

Der Überwachungsstatus des Endpunkts.

properties.endpointStatus

EndpointStatus

Der Status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird er auf die Endpunktintegrität untersucht und in der Datenverkehrsroutingmethode enthalten.

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 Dokumentation "Traffic Manager Geographic".

properties.minChildEndpoints

integer (int64)

Die Mindestanzahl der Endpunkte, die im untergeordneten Profil verfügbar sein müssen, damit das übergeordnete Profil als verfügbar betrachtet werden kann. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.

properties.minChildEndpointsIPv4

integer (int64)

Die Mindestanzahl der IPv4-Endpunkte (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 den Endpunkt vom Typ 'NestedEndpoints'.

properties.minChildEndpointsIPv6

integer (int64)

Die Mindestanzahl der IPv6-Endpunkte (DNS-Eintragstyp AAAA), die im untergeordneten Profil verfügbar sein müssen, damit das übergeordnete Profil als verfügbar betrachtet werden kann. Gilt nur für den Endpunkt vom Typ 'NestedEndpoints'.

properties.priority

integer (int64)

Die Priorität dieses Endpunkts bei Verwendung der Datenverkehrsroutingmethode "Priorität". Mögliche Werte liegen zwischen 1 und 1000, niedrigere Werte stellen eine höhere Priorität dar. Dies ist ein optionaler Parameter. Wenn angegeben, muss sie auf allen Endpunkten angegeben werden, und keine zwei Endpunkte können denselben Prioritätswert gemeinsam nutzen.

properties.subnets

Subnets[]

Die Liste der Subnetze, IP-Adressen und/oder Adressbereiche, die diesem Endpunkt bei Verwendung der Routingmethode "Subnetz" zugeordnet sind. 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. Der Datenverkehrs-Manager gibt diesen Wert in DNS-Antworten zurück, um den Datenverkehr an diesen Endpunkt zu leiten.

properties.targetResourceId

string

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

properties.weight

integer (int64)

Die Gewichtung dieses Endpunkts bei Verwendung der "Weighted"-Datenverkehrsroutingmethode. Mögliche Werte liegen zwischen 1 und 1000.

type

string

Der Typ der Ressource. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Der Überwachungsstatus des Endpunkts.

Wert Beschreibung
CheckingEndpoint
Degraded
Disabled
Inactive
Online
Stopped
Unmonitored

EndpointStatus

Der Status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird er auf die Endpunktintegrität untersucht und in der Datenverkehrsroutingmethode enthalten.

Wert Beschreibung
Disabled
Enabled

EndpointType

Der Typ des Traffic Manager-Endpunkts.

Wert Beschreibung
AzureEndpoints
ExternalEndpoints
NestedEndpoints

Subnets

Die Liste der Subnetze, IP-Adressen und/oder Adressbereiche, die diesem Endpunkt bei Verwendung der Routingmethode "Subnetz" zugeordnet sind. 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).