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 |
---|---|---|---|---|
endpoint
|
path | True |
string |
Der Name des zu aktualisierenden Traffic Manager-Endpunkts. |
endpoint
|
path | True |
Der Typ des zu aktualisierenden Traffic Manager-Endpunkts. |
|
profile
|
path | True |
string |
Der Name des Traffic Manager-Profils. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
subscription
|
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 |
Wenn Always Serve aktiviert ist, wird die Überprüfung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen. |
|
properties.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 |
Die Überwachung status des Endpunkts. |
|
properties.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 |
Der aktualisierte Traffic Manager-Endpunkt. |
|
Other Status Codes |
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 |
---|---|
Always |
Wenn Always Serve aktiviert ist, wird die Überprüfung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen. |
Cloud |
Vom Azure-Resource Manager zurückgegebener Fehler |
Cloud |
Der Inhalt eines vom Azure-Resource Manager zurückgegebenen Fehlers |
Custom |
Liste der benutzerdefinierten Header. |
Endpoint |
Klasse, die einen Traffic Manager-Endpunkt darstellt. |
Endpoint |
Die Überwachung status des Endpunkts. |
Endpoint |
Die status des Endpunkts. Wenn der Endpunkt aktiviert ist, wird dessen Integrität überprüft und der Endpunkt in die Verkehrsroutingmethode eingeschlossen. |
Endpoint |
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 |
Der Inhalt des Fehlers. |
CloudErrorBody
Der Inhalt eines vom Azure-Resource Manager zurückgegebenen Fehlers
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode |
details |
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 |
Wenn Always Serve aktiviert ist, wird die Überprüfung der Endpunktintegrität deaktiviert, und Endpunkte werden in die Datenverkehrsroutingmethode einbezogen. |
|
properties.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 |
Die Überwachung status des Endpunkts. |
|
properties.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). |