Profiles - Update
Uppdatera en Traffic Manager-profil.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}?api-version=2022-04-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
profile
|
path | True |
string |
Namnet på Traffic Manager-profilen. |
resource
|
path | True |
string |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
subscription
|
path | True |
string |
Hämtar autentiseringsuppgifter för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
api-version
|
query | True |
string |
Klient-API-version. |
Begärandetext
Name | Typ | Description |
---|---|---|
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Den Azure-region där resursen finns |
name |
string |
Namnet på resursen |
properties.allowedEndpointRecordTypes |
Listan över tillåtna typer av slutpunktsposter. |
|
properties.dnsConfig |
DNS-inställningarna för Traffic Manager-profilen. |
|
properties.endpoints |
Endpoint[] |
Listan över slutpunkter i Traffic Manager-profilen. |
properties.maxReturn |
integer |
Maximalt antal slutpunkter som ska returneras för Routningstypen MultiValue. |
properties.monitorConfig |
Slutpunktsövervakningsinställningarna för Traffic Manager-profilen. |
|
properties.profileStatus |
Status för Traffic Manager-profilen. |
|
properties.trafficRoutingMethod |
Trafikroutningsmetoden för Traffic Manager-profilen. |
|
properties.trafficViewEnrollmentStatus |
Anger om trafikvyn är "Aktiverad" eller "Inaktiverad" för Traffic Manager-profilen. Null, anger "Disabled". Om du aktiverar den här funktionen ökar kostnaden för traffic manage-profilen. |
|
tags |
object |
Resurstaggar. |
type |
string |
Resurstypen. Ex- Microsoft.Network/trafficManagerProfiles. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Den uppdaterade Traffic Manager-profilen. |
|
Other Status Codes |
Standardsvar. Den kommer att deserialiseras enligt feldefinitionen. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
Profile-PATCH-MonitorConfig
Exempelbegäran
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"
}
]
}
}
}
Exempelsvar
{
"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"
}
}
]
}
}
Definitioner
Name | Description |
---|---|
Allowed |
Den tillåtna typen DNS-posttyper för den här profilen. |
Always |
Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden. |
Cloud |
Ett fel som returneras av Azure Resource Manager |
Cloud |
Innehållet i ett fel som returneras av Azure Resource Manager |
Custom |
Lista över anpassade rubriker. |
Dns |
Klass som innehåller DNS-inställningar i en Traffic Manager-profil. |
Endpoint |
Klass som representerar en Traffic Manager-slutpunkt. |
Endpoint |
Slutpunktens övervakningsstatus. |
Endpoint |
Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden. |
Expected |
Lista över förväntade statuskodintervall. |
Monitor |
Klass som innehåller inställningar för slutpunktsövervakning i en Traffic Manager-profil. |
Monitor |
Protokollet (HTTP, HTTPS eller TCP) som används för avsökning för slutpunktshälsa. |
Profile |
Klass som representerar en Traffic Manager-profil. |
Profile |
Övervakningsstatus på profilnivå för Traffic Manager-profilen. |
Profile |
Status för Traffic Manager-profilen. |
Subnets |
Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter. |
Traffic |
Trafikroutningsmetoden för Traffic Manager-profilen. |
Traffic |
Anger om trafikvyn är "Aktiverad" eller "Inaktiverad" för Traffic Manager-profilen. Null, anger "Inaktiverad". Om du aktiverar den här funktionen ökar kostnaden för traffic manage-profilen. |
AllowedEndpointRecordType
Den tillåtna typen DNS-posttyper för den här profilen.
Name | Typ | Description |
---|---|---|
Any |
string |
|
DomainName |
string |
|
IPv4Address |
string |
|
IPv6Address |
string |
AlwaysServe
Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
CloudError
Ett fel som returneras av Azure Resource Manager
Name | Typ | Description |
---|---|---|
error |
Innehållet i felet. |
CloudErrorBody
Innehållet i ett fel som returneras av Azure Resource Manager
Name | Typ | Description |
---|---|---|
code |
string |
Felkod |
details |
Felinformation |
|
message |
string |
Felmeddelande |
target |
string |
Felmål |
CustomHeaders
Lista över anpassade rubriker.
Name | Typ | Description |
---|---|---|
name |
string |
Rubriknamn. |
value |
string |
Rubrikvärde. |
DnsConfig
Klass som innehåller DNS-inställningar i en Traffic Manager-profil.
Name | Typ | Description |
---|---|---|
fqdn |
string |
Det fullständigt kvalificerade domännamnet (FQDN) för Traffic Manager-profilen. Detta bildas från sammanlänkningen av RelativeName med DNS-domänen som används av Azure Traffic Manager. |
relativeName |
string |
Det relativa DNS-namnet som tillhandahålls av den här Traffic Manager-profilen. Det här värdet kombineras med dns-domännamnet som används av Azure Traffic Manager för att bilda profilens fullständigt kvalificerade domännamn (FQDN). |
ttl |
integer |
TTL (Time To Live) för DNS i sekunder. Detta informerar de lokala DNS-matcharna och DNS-klienterna hur länge DNS-svar som tillhandahålls av den här Traffic Manager-profilen ska cachelagras. |
Endpoint
Klass som representerar en Traffic Manager-slutpunkt.
Name | Typ | Description |
---|---|---|
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
name |
string |
Namnet på resursen |
properties.alwaysServe |
Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden. |
|
properties.customHeaders |
Lista över anpassade rubriker. |
|
properties.endpointLocation |
string |
Anger platsen för de externa eller kapslade slutpunkterna när du använder trafikroutningsmetoden Prestanda. |
properties.endpointMonitorStatus |
Slutpunktens övervakningsstatus. |
|
properties.endpointStatus |
Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden. |
|
properties.geoMapping |
string[] |
Listan över länder/regioner som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Geografisk". Se Traffic Manager Geographic-dokumentationen för en fullständig lista över godkända värden. |
properties.minChildEndpoints |
integer |
Det minsta antalet slutpunkter som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints". |
properties.minChildEndpointsIPv4 |
integer |
Det minsta antalet IPv4-slutpunkter (DNS-posttyp A) som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints". |
properties.minChildEndpointsIPv6 |
integer |
Det minsta antalet IPv6-slutpunkter (DNS-posttyp AAAA) som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints". |
properties.priority |
integer |
Prioriteten för den här slutpunkten när du använder trafikroutningsmetoden "Prioritet". Möjliga värden är från 1 till 1 000, lägre värden representerar högre prioritet. Det här är en valfri parameter. Om det anges måste det anges på alla slutpunkter och inga två slutpunkter kan dela samma prioritetsvärde. |
properties.subnets |
Subnets[] |
Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter. |
properties.target |
string |
Slutpunktens fullständigt kvalificerade DNS-namn eller IP-adress. Traffic Manager returnerar det här värdet i DNS-svar för att dirigera trafik till den här slutpunkten. |
properties.targetResourceId |
string |
Azure Resource-URI:n för slutpunkten. Gäller inte för slutpunkter av typen "ExternalEndpoints". |
properties.weight |
integer |
Vikten för den här slutpunkten när du använder trafikroutningsmetoden Viktad. Möjliga värden är från 1 till 1 000. |
type |
string |
Resurstypen. Ex- Microsoft.Network/trafficManagerProfiles. |
EndpointMonitorStatus
Slutpunktens övervakningsstatus.
Name | Typ | Description |
---|---|---|
CheckingEndpoint |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
|
Stopped |
string |
|
Unmonitored |
string |
EndpointStatus
Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpectedStatusCodeRanges
Lista över förväntade statuskodintervall.
Name | Typ | Description |
---|---|---|
max |
integer |
Maximal statuskod. |
min |
integer |
Lägsta statuskod. |
MonitorConfig
Klass som innehåller inställningar för slutpunktsövervakning i en Traffic Manager-profil.
Name | Typ | Description |
---|---|---|
customHeaders |
Lista över anpassade rubriker. |
|
expectedStatusCodeRanges |
Lista över förväntade statuskodintervall. |
|
intervalInSeconds |
integer |
Övervakningsintervallet för slutpunkter i den här profilen. Det här är intervallet då Traffic Manager kontrollerar hälsotillståndet för varje slutpunkt i den här profilen. |
path |
string |
Sökvägen i förhållande till det slutpunktsdomännamn som används för att söka efter slutpunktshälsa. |
port |
integer |
TCP-porten som används för att söka efter slutpunktshälsa. |
profileMonitorStatus |
Övervakningsstatus på profilnivå för Traffic Manager-profilen. |
|
protocol |
Protokollet (HTTP, HTTPS eller TCP) som används för avsökning för slutpunktshälsa. |
|
timeoutInSeconds |
integer |
Tidsgränsen för övervakaren för slutpunkter i den här profilen. Det här är den tid då Traffic Manager tillåter att slutpunkter i den här profilen svarar på hälsokontrollen. |
toleratedNumberOfFailures |
integer |
Antalet efterföljande misslyckade hälsokontroller som Traffic Manager tolererar innan du deklarerar en slutpunkt i den här profilen Degraderas efter nästa misslyckade hälsokontroll. |
MonitorProtocol
Protokollet (HTTP, HTTPS eller TCP) som används för avsökning för slutpunktshälsa.
Name | Typ | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
|
TCP |
string |
Profile
Klass som representerar en Traffic Manager-profil.
Name | Typ | Description |
---|---|---|
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Den Azure-region där resursen finns |
name |
string |
Namnet på resursen |
properties.allowedEndpointRecordTypes |
Listan över tillåtna typer av slutpunktsposter. |
|
properties.dnsConfig |
DNS-inställningarna för Traffic Manager-profilen. |
|
properties.endpoints |
Endpoint[] |
Listan över slutpunkter i Traffic Manager-profilen. |
properties.maxReturn |
integer |
Maximalt antal slutpunkter som ska returneras för MultiValue-routningstyp. |
properties.monitorConfig |
Inställningarna för slutpunktsövervakning för Traffic Manager-profilen. |
|
properties.profileStatus |
Status för Traffic Manager-profilen. |
|
properties.trafficRoutingMethod |
Trafikroutningsmetoden för Traffic Manager-profilen. |
|
properties.trafficViewEnrollmentStatus |
Anger om trafikvyn är "Aktiverad" eller "Inaktiverad" för Traffic Manager-profilen. Null, anger "Inaktiverad". Om du aktiverar den här funktionen ökar kostnaden för traffic manage-profilen. |
|
tags |
object |
Resurstaggar. |
type |
string |
Resurstypen. Ex- Microsoft.Network/trafficManagerProfiles. |
ProfileMonitorStatus
Övervakningsstatus på profilnivå för Traffic Manager-profilen.
Name | Typ | Description |
---|---|---|
CheckingEndpoints |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
ProfileStatus
Status för Traffic Manager-profilen.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnets
Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter.
Name | Typ | Description |
---|---|---|
first |
string |
Första adressen i undernätet. |
last |
string |
Sista adressen i undernätet. |
scope |
integer |
Blockstorlek (antal inledande bitar i nätmasken). |
TrafficRoutingMethod
Trafikroutningsmetoden för Traffic Manager-profilen.
Name | Typ | Description |
---|---|---|
Geographic |
string |
|
MultiValue |
string |
|
Performance |
string |
|
Priority |
string |
|
Subnet |
string |
|
Weighted |
string |
TrafficViewEnrollmentStatus
Anger om trafikvyn är "Aktiverad" eller "Inaktiverad" för Traffic Manager-profilen. Null, anger "Inaktiverad". Om du aktiverar den här funktionen ökar kostnaden för traffic manage-profilen.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |