Profiles - Update
Aktualisieren sie ein Traffic Manager-Profil.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}?api-version=2022-04-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
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} |
location |
string |
Die Azure-Region, in der sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.allowedEndpointRecordTypes |
Die Liste der zulässigen Endpunktdatensatztypen. |
|
properties.dnsConfig |
Die DNS-Einstellungen des Traffic Manager-Profils. |
|
properties.endpoints |
Endpoint[] |
Die Liste der Endpunkte im Traffic Manager-Profil. |
properties.maxReturn |
integer |
Maximale Anzahl von Endpunkten, die für den MultiValue-Routingtyp zurückgegeben werden sollen. |
properties.monitorConfig |
Die Endpunktüberwachungseinstellungen des Traffic Manager-Profils. |
|
properties.profileStatus |
Die status des Traffic Manager-Profils. |
|
properties.trafficRoutingMethod |
Die Datenverkehrsroutingmethode des Traffic Manager-Profils. |
|
properties.trafficViewEnrollmentStatus |
Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. Null, gibt "Deaktiviert" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung". |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Beispiel: Microsoft.Network/trafficManagerProfiles. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Das aktualisierte Traffic Manager-Profil. |
|
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
Profile-PATCH-MonitorConfig
Beispielanforderung
PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager6192?api-version=2022-04-01
{
"properties": {
"monitorConfig": {
"protocol": "HTTP",
"port": 80,
"path": "/testpath.aspx",
"intervalInSeconds": 30,
"timeoutInSeconds": 6,
"toleratedNumberOfFailures": 4,
"customHeaders": [
{
"name": "header-1",
"value": "value-1"
},
{
"name": "header-2",
"value": "value-2"
}
]
}
}
}
Beispiel für eine Antwort
{
"id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192",
"name": "azuresdkfornetautoresttrafficmanager6192",
"type": "Microsoft.Network/trafficManagerProfiles",
"location": "global",
"tags": {},
"properties": {
"profileStatus": "Enabled",
"trafficRoutingMethod": "Performance",
"dnsConfig": {
"relativeName": "azuresdkfornetautoresttrafficmanager6192",
"fqdn": "azuresdkfornetautoresttrafficmanager6192.tmpreview.watmtest.azure-test.net",
"ttl": 35
},
"monitorConfig": {
"profileMonitorStatus": "CheckingEndpoints",
"protocol": "HTTP",
"port": 80,
"path": "/testpath.aspx",
"intervalInSeconds": 30,
"toleratedNumberOfFailures": 4,
"timeoutInSeconds": 6,
"customHeaders": [
{
"name": "header-1",
"value": "value-1"
},
{
"name": "header-2",
"value": "value-2"
}
]
},
"endpoints": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2583/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager6192/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,
"endpointLocation": "North Europe"
}
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
Allowed |
Die zulässigen DNS-Eintragstypen für dieses Profil. |
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. |
Dns |
Klasse, die DNS-Einstellungen in einem Traffic Manager-Profil enthält. |
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. |
Expected |
Liste der erwarteten status Codebereiche. |
Monitor |
Klasse, die Endpunktüberwachungseinstellungen in einem Traffic Manager-Profil enthält. |
Monitor |
Das Protokoll (HTTP, HTTPS oder TCP), mit dem die Endpunktintegrität untersucht wird. |
Profile |
Klasse, die ein Traffic Manager-Profil darstellt. |
Profile |
Die Überwachung auf Profilebene status des Traffic Manager-Profils. |
Profile |
Die status des Traffic Manager-Profils. |
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. |
Traffic |
Die Datenverkehrsroutingmethode des Traffic Manager-Profils. |
Traffic |
Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. Null, gibt "Deaktiviert" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung". |
AllowedEndpointRecordType
Die zulässigen DNS-Eintragstypen für dieses Profil.
Name | Typ | Beschreibung |
---|---|---|
Any |
string |
|
DomainName |
string |
|
IPv4Address |
string |
|
IPv6Address |
string |
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. |
DnsConfig
Klasse, die DNS-Einstellungen in einem Traffic Manager-Profil enthält.
Name | Typ | Beschreibung |
---|---|---|
fqdn |
string |
Der vollqualifizierte Domänenname (FQDN) des Traffic Manager-Profils. Dies entsteht aus der Verkettung von RelativeName mit der DNS-Domäne, die von Azure Traffic Manager verwendet wird. |
relativeName |
string |
Der relative DNS-Name, der von diesem Traffic Manager-Profil bereitgestellt wird. Dieser Wert wird mit dem DNS-Domänennamen kombiniert, der von Azure Traffic Manager zum Erstellen des vollqualifizierten Domänennamens (FQDN) des Profils verwendet wird. |
ttl |
integer |
Die DNS-Laufzeit (Time-to-Live, TTL) in Sekunden. Dadurch werden die lokalen DNS-Resolver und DNS-Clients darüber informiert, wie lange DNS-Antworten, die von diesem Traffic Manager-Profil bereitgestellt werden, zwischengespeichert werden sollen. |
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 |
ExpectedStatusCodeRanges
Liste der erwarteten status Codebereiche.
Name | Typ | Beschreibung |
---|---|---|
max |
integer |
Max status Code. |
min |
integer |
Min. status Code. |
MonitorConfig
Klasse, die Endpunktüberwachungseinstellungen in einem Traffic Manager-Profil enthält.
Name | Typ | Beschreibung |
---|---|---|
customHeaders |
Liste der benutzerdefinierten Header. |
|
expectedStatusCodeRanges |
Liste der erwarteten status Codebereiche. |
|
intervalInSeconds |
integer |
Das Überwachungsintervall für Endpunkte in diesem Profil. Dies ist das Intervall, in dem Traffic Manager die Integrität der einzelnen Endpunkte in diesem Profil überprüft. |
path |
string |
Der Pfad relativ zum Endpunktdomänennamen, der zum Überprüfen der Endpunktintegrität verwendet wird. |
port |
integer |
Der TCP-Port, der verwendet wird, um die Endpunktintegrität zu überprüfen. |
profileMonitorStatus |
Die Überwachung auf Profilebene status des Traffic Manager-Profils. |
|
protocol |
Das Protokoll (HTTP, HTTPS oder TCP), mit dem die Endpunktintegrität untersucht wird. |
|
timeoutInSeconds |
integer |
Das Monitortimeout für Endpunkte in diesem Profil. Dies ist der Zeitpunkt, zu dem Traffic Manager Endpunkten in diesem Profil erlaubt, auf die Integritätsprüfung zu reagieren. |
toleratedNumberOfFailures |
integer |
Die Anzahl der aufeinanderfolgenden fehlerhaften Integritätsprüfung, die Traffic Manager toleriert, bevor ein Endpunkt in diesem Profil nach der nächsten fehlerhaften Integritätsprüfung deklariert wird. |
MonitorProtocol
Das Protokoll (HTTP, HTTPS oder TCP), mit dem die Endpunktintegrität untersucht wird.
Name | Typ | Beschreibung |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
|
TCP |
string |
Profile
Klasse, die ein Traffic Manager-Profil darstellt.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Die Azure-Region, in der sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.allowedEndpointRecordTypes |
Die Liste der zulässigen Endpunktdatensatztypen. |
|
properties.dnsConfig |
Die DNS-Einstellungen des Traffic Manager-Profils. |
|
properties.endpoints |
Endpoint[] |
Die Liste der Endpunkte im Traffic Manager-Profil. |
properties.maxReturn |
integer |
Maximale Anzahl von Endpunkten, die für den MultiValue-Routingtyp zurückgegeben werden sollen. |
properties.monitorConfig |
Die Endpunktüberwachungseinstellungen des Traffic Manager-Profils. |
|
properties.profileStatus |
Die status des Traffic Manager-Profils. |
|
properties.trafficRoutingMethod |
Die Datenverkehrsroutingmethode des Traffic Manager-Profils. |
|
properties.trafficViewEnrollmentStatus |
Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. Null, gibt "Deaktiviert" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung". |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Beispiel: Microsoft.Network/trafficManagerProfiles. |
ProfileMonitorStatus
Die Überwachung auf Profilebene status des Traffic Manager-Profils.
Name | Typ | Beschreibung |
---|---|---|
CheckingEndpoints |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
ProfileStatus
Die status des Traffic Manager-Profils.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
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). |
TrafficRoutingMethod
Die Datenverkehrsroutingmethode des Traffic Manager-Profils.
Name | Typ | Beschreibung |
---|---|---|
Geographic |
string |
|
MultiValue |
string |
|
Performance |
string |
|
Priority |
string |
|
Subnet |
string |
|
Weighted |
string |
TrafficViewEnrollmentStatus
Gibt an, ob die Traffic View für das Traffic Manager-Profil "Aktiviert" oder "Deaktiviert" ist. Null, gibt "Deaktiviert" an. Wenn Sie dieses Feature aktivieren, erhöhen sich die Kosten für das Profil "Datenverkehrsverwaltung".
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |