Freigeben über


Endpoints - Create Or Update

Erstellen oder Aktualisieren eines Traffic Manager-Endpunkts

PUT 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, der erstellt oder aktualisiert werden soll.

endpointType
path True

EndpointType

Der Typ des Traffic Manager-Endpunkts, der erstellt oder aktualisiert werden soll.

profileName
path True

string

Der Name des Traffic Manager-Profils.

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.

Anforderungstext

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.

Antworten

Name Typ Beschreibung
200 OK

Endpoint

Der erstellte oder aktualisierte Endpunkt.

201 Created

Endpoint

Der erstellte oder aktualisierte Endpunkt.

Other Status Codes

CloudError

Standardantwort. Es wird gemäß der Fehlerdefinition deserialisiert.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Endpoint-PUT-External-WithAlwaysServe
Endpoint-PUT-External-WithCustomHeaders
Endpoint-PUT-External-WithGeoMapping
Endpoint-PUT-External-WithLocation
Endpoint-PUT-External-WithSubnetMapping

Endpoint-PUT-External-WithAlwaysServe

Beispielanforderung

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

{
  "name": "azsmnet7187",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "endpointLocation": "North Europe",
    "alwaysServe": "Enabled"
  }
}

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",
    "alwaysServe": "Enabled"
  }
}
{
  "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",
    "alwaysServe": "Enabled"
  }
}

Endpoint-PUT-External-WithCustomHeaders

Beispielanforderung

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

{
  "name": "azsmnet7187",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "endpointLocation": "North Europe",
    "customHeaders": [
      {
        "name": "header-1",
        "value": "value-1"
      },
      {
        "name": "header-2",
        "value": "value-2"
      }
    ]
  }
}

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",
    "customHeaders": [
      {
        "name": "header-1",
        "value": "value-1"
      },
      {
        "name": "header-2",
        "value": "value-2"
      }
    ]
  }
}
{
  "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",
    "customHeaders": [
      {
        "name": "header-1",
        "value": "value-1"
      },
      {
        "name": "header-2",
        "value": "value-2"
      }
    ]
  }
}

Endpoint-PUT-External-WithGeoMapping

Beispielanforderung

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

{
  "name": "My external endpoint",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "geoMapping": [
      "GEO-AS",
      "GEO-AF"
    ]
  }
}

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

Beispielanforderung

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

{
  "name": "azsmnet7187",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "endpointLocation": "North Europe"
  }
}

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"
  }
}
{
  "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-PUT-External-WithSubnetMapping

Beispielanforderung

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

{
  "name": "My external endpoint",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "subnets": [
      {
        "first": "1.2.3.0",
        "scope": 24
      },
      {
        "first": "25.26.27.28",
        "last": "29.30.31.32"
      }
    ]
  }
}

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

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.

EndpointType

Der Typ des Traffic Manager-Endpunkts, der erstellt oder aktualisiert werden soll.

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.

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.

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

EndpointType

Der Typ des Traffic Manager-Endpunkts, der erstellt oder aktualisiert werden soll.

Name Typ Beschreibung
AzureEndpoints

string

ExternalEndpoints

string

NestedEndpoints

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).