Endpoints - Update

Dienst:: Traffic Manager

API-Version:: 2022-04-01

Aktualisieren eines Traffic Manager-Endpunkts.

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 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 minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
id	string (arm-id)	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	EndpointPropertiesCustomHeadersItem[]	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	EndpointPropertiesSubnetsItem[]	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.

Antworten

Name	Typ	Beschreibung
200 OK	Endpoint	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

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-PATCH-External-Target

Beispielanforderung

HTTP

PATCH 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",
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "properties": {
    "target": "another.foobar.contoso.com"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

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

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
Endpoint	Klasse, die einen Traffic Manager-Endpunkt darstellt.
EndpointMonitorStatus	Der Überwachungsstatus des Endpunkts.
EndpointPropertiesCustomHeadersItem	Name und Wert des benutzerdefinierten Headers.
EndpointPropertiesSubnetsItem	Erste Adresse, Bereich und/oder letzte Adresse des Subnetzes.
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.

AlwaysServe

Enumeration

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

Wert	Beschreibung
Enabled
Disabled

CloudError

Objekt

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

Name	Typ	Beschreibung
error	CloudErrorBody	Der Inhalt des Fehlers.

CloudErrorBody

Objekt

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

Endpoint

Objekt

Klasse, die einen Traffic Manager-Endpunkt darstellt.

Name	Typ	Beschreibung
id	string (arm-id)	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	EndpointPropertiesCustomHeadersItem[]	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	EndpointPropertiesSubnetsItem[]	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

Enumeration

Der Überwachungsstatus des Endpunkts.

Wert	Beschreibung
CheckingEndpoint
Online
Degraded
Disabled
Inactive
Stopped
Unmonitored

EndpointPropertiesCustomHeadersItem

Objekt

Name und Wert des benutzerdefinierten Headers.

Name	Typ	Beschreibung
name	string	Kopfzeilenname.
value	string	Headerwert.

EndpointPropertiesSubnetsItem

Objekt

Erste Adresse, Bereich und/oder letzte Adresse des Subnetzes.

Name	Typ	Beschreibung
first	string	Erste Adresse im Subnetz.
last	string	Letzte Adresse im Subnetz.
scope	integer (int32)	Blockgröße (Anzahl der führenden Bits in der Subnetzmaske).

EndpointStatus

Enumeration

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

Wert	Beschreibung
Enabled
Disabled

EndpointType

Enumeration

Der Typ des Traffic Manager-Endpunkts.

Wert	Beschreibung
AzureEndpoints
ExternalEndpoints
NestedEndpoints

Freigeben über

Endpoints - Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Endpoint-PATCH-External-Target

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AlwaysServe

CloudError

CloudErrorBody

Endpoint

EndpointMonitorStatus

EndpointPropertiesCustomHeadersItem

EndpointPropertiesSubnetsItem

EndpointStatus

EndpointType