Freigeben über


Endpoints - Update

Aktualisieren sie einen Traffic Manager-Endpunkt.

PATCH 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 zu aktualisierenden Traffic Manager-Endpunkts.

endpointType
path True

EndpointType

Der Typ des zu aktualisierenden Traffic Manager-Endpunkts.

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

properties.customHeaders

CustomHeaders[]

Liste der benutzerdefinierten Header.

properties.endpointLocation

string

Gibt den Speicherort der externen oder geschachtelten Endpunkte an, wenn die Datenverkehrsroutingmethode "Leistung" 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 Methode "Geografisches" Datenverkehrsrouting verwendet wird. Eine vollständige Liste der akzeptierten Werte finden Sie in der Traffic Manager Geographic-Dokumentation.

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 den Endpunkt 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 den Endpunkt 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 den Endpunkt vom Typ "NestedEndpoints".

properties.priority

integer

Die Priorität dieses Endpunkts bei Verwendung der Datenverkehrsroutingmethode "Priority". Mögliche Werte liegen 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 des Endpunkts. Gilt nicht für Endpunkte vom Typ "ExternalEndpoints".

properties.weight

integer

Die Gewichtung dieses Endpunkts bei Verwendung der Methode "Gewichtetes" Datenverkehrsrouting. Mögliche Werte liegen zwischen 1 und 1000.

type

string

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

Antworten

Name Typ Beschreibung
200 OK

Endpoint

Der aktualisierte Traffic Manager-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-PATCH-External-Target

Beispielanforderung

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

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "name": "azsmnet7187",
  "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
  "properties": {
    "target": "another.foobar.contoso.com"
  }
}

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": "another.foobar.contoso.com",
    "weight": 1,
    "priority": 1,
    "endpointLocation": "North Europe"
  }
}

Definitionen

Name Beschreibung
AlwaysServe

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

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 zu aktualisierenden Traffic Manager-Endpunkts.

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

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

properties.customHeaders

CustomHeaders[]

Liste der benutzerdefinierten Header.

properties.endpointLocation

string

Gibt den Speicherort der externen oder geschachtelten Endpunkte an, wenn die Datenverkehrsroutingmethode "Leistung" 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 Methode "Geografisches" Datenverkehrsrouting verwendet wird. Eine vollständige Liste der akzeptierten Werte finden Sie in der Traffic Manager Geographic-Dokumentation.

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 den Endpunkt 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 den Endpunkt 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 den Endpunkt vom Typ "NestedEndpoints".

properties.priority

integer

Die Priorität dieses Endpunkts bei Verwendung der Datenverkehrsroutingmethode "Priority". Mögliche Werte liegen 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 des Endpunkts. Gilt nicht für Endpunkte vom Typ "ExternalEndpoints".

properties.weight

integer

Die Gewichtung dieses Endpunkts bei Verwendung der Methode "Gewichtetes" Datenverkehrsrouting. Mögliche Werte liegen zwischen 1 und 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 zu aktualisierenden Traffic Manager-Endpunkts.

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