Profiles - Update
Aktualizujte profil služby Traffic Manager.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}?api-version=2022-04-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
profile
|
path | True |
string |
Název profilu služby Traffic Manager. |
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
subscription
|
path | True |
string |
Získá přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
Text požadavku
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Oblast Azure, ve které se prostředek nachází |
name |
string |
Název prostředku |
properties.allowedEndpointRecordTypes |
Seznam povolených typů záznamů koncového bodu |
|
properties.dnsConfig |
Nastavení DNS profilu služby Traffic Manager. |
|
properties.endpoints |
Endpoint[] |
Seznam koncových bodů v profilu Služby Traffic Manager. |
properties.maxReturn |
integer |
Maximální počet koncových bodů, které se mají vrátit pro typ směrování MultiValue. |
properties.monitorConfig |
Nastavení monitorování koncového bodu profilu služby Traffic Manager. |
|
properties.profileStatus |
Stav profilu služby Traffic Manager. |
|
properties.trafficRoutingMethod |
Metoda směrování provozu profilu služby Traffic Manager. |
|
properties.trafficViewEnrollmentStatus |
Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu. |
|
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. Příklad: Microsoft.Network/trafficManagerProfiles. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Aktualizovaný profil služby Traffic Manager. |
|
Other Status Codes |
Výchozí odpověď. Bude deserializována podle definice chyby. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Profile-PATCH-MonitorConfig
Ukázkový požadavek
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"
}
]
}
}
}
Ukázková odpověď
{
"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"
}
}
]
}
}
Definice
Name | Description |
---|---|
Allowed |
Povolené typy záznamů DNS pro tento profil. |
Always |
Pokud je povolená funkce Always Serve, bude testování stavu koncového bodu zakázáno a koncové body budou zahrnuty do metody směrování provozu. |
Cloud |
Chyba vrácená službou Azure Resource Manager |
Cloud |
Obsah chyby vrácené službou Azure Resource Manager |
Custom |
Seznam vlastních hlaviček |
Dns |
Třída obsahující nastavení DNS v profilu služby Traffic Manager. |
Endpoint |
Třída představující koncový bod Traffic Manageru. |
Endpoint |
Stav monitorování koncového bodu. |
Endpoint |
Stav koncového bodu. Pokud je koncový bod povolený, dotazuje se na stav koncového bodu a je zahrnutý v metodě směrování provozu. |
Expected |
Seznam očekávaných rozsahů stavových kódů |
Monitor |
Třída obsahující nastavení monitorování koncového bodu v profilu služby Traffic Manager. |
Monitor |
Protokol (HTTP, HTTPS nebo TCP) používaný k testování stavu koncového bodu. |
Profile |
Třída představující profil služby Traffic Manager. |
Profile |
Stav monitorování na úrovni profilu služby Traffic Manager. |
Profile |
Stav profilu služby Traffic Manager. |
Subnets |
Seznam podsítí, IP adres nebo rozsahů adres mapovaných na tento koncový bod při použití metody směrování provozu Subnet. Prázdný seznam bude odpovídat všem rozsahům, které ostatní koncové body nepokrývala. |
Traffic |
Metoda směrování provozu profilu služby Traffic Manager. |
Traffic |
Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu. |
AllowedEndpointRecordType
Povolené typy záznamů DNS pro tento profil.
Name | Typ | Description |
---|---|---|
Any |
string |
|
DomainName |
string |
|
IPv4Address |
string |
|
IPv6Address |
string |
AlwaysServe
Pokud je povolená funkce Always Serve, bude testování stavu koncového bodu zakázáno a koncové body budou zahrnuty do metody směrování provozu.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
CloudError
Chyba vrácená službou Azure Resource Manager
Name | Typ | Description |
---|---|---|
error |
Obsah chyby. |
CloudErrorBody
Obsah chyby vrácené službou Azure Resource Manager
Name | Typ | Description |
---|---|---|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby |
CustomHeaders
Seznam vlastních hlaviček
Name | Typ | Description |
---|---|---|
name |
string |
Název hlavičky. |
value |
string |
Hodnota hlavičky. |
DnsConfig
Třída obsahující nastavení DNS v profilu služby Traffic Manager.
Name | Typ | Description |
---|---|---|
fqdn |
string |
Plně kvalifikovaný název domény (FQDN) profilu traffic manageru. Vytvoří se zřetězením RelativeName s doménou DNS, kterou používá Azure Traffic Manager. |
relativeName |
string |
Relativní název DNS zadaný tímto profilem služby Traffic Manager. Tato hodnota se zkombinuje s názvem domény DNS, který azure Traffic Manager používá k vytvoření plně kvalifikovaného názvu domény (FQDN) profilu. |
ttl |
integer |
Hodnota TTL (Time to Live) DNS v sekundách. To informuje místní překladače DNS a klienty DNS, jak dlouho mají ukládat odpovědi DNS poskytnuté tímto profilem služby Traffic Manager do mezipaměti. |
Endpoint
Třída představující koncový bod Traffic Manageru.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
name |
string |
Název prostředku |
properties.alwaysServe |
Pokud je povolená funkce Always Serve, bude testování stavu koncového bodu zakázáno a koncové body budou zahrnuty do metody směrování provozu. |
|
properties.customHeaders |
Seznam vlastních hlaviček |
|
properties.endpointLocation |
string |
Určuje umístění externích nebo vnořených koncových bodů při použití metody směrování provozu Performance. |
properties.endpointMonitorStatus |
Stav monitorování koncového bodu. |
|
properties.endpointStatus |
Stav koncového bodu. Pokud je koncový bod povolený, dotazuje se na stav koncového bodu a je zahrnutý v metodě směrování provozu. |
|
properties.geoMapping |
string[] |
Seznam zemí nebo oblastí namapovaných na tento koncový bod při použití metody geografického směrování provozu Úplný seznam přijatých hodnot najdete v geografické dokumentaci traffic manageru. |
properties.minChildEndpoints |
integer |
Minimální počet koncových bodů, které musí být dostupné v podřízeného profilu, aby se nadřazený profil považoval za dostupný. Platí jenom pro koncový bod typu NestedEndpoints. |
properties.minChildEndpointsIPv4 |
integer |
Minimální počet koncových bodů IPv4 (záznam DNS typu A), které musí být dostupné v podřízeného profilu, aby se nadřazený profil považoval za dostupný. Platí jenom pro koncový bod typu NestedEndpoints. |
properties.minChildEndpointsIPv6 |
integer |
Minimální počet koncových bodů IPv6 (typ záznamu DNS AAAA), které musí být dostupné v podřízeného profilu, aby bylo možné nadřazený profil považovat za dostupný. Platí jenom pro koncový bod typu NestedEndpoints. |
properties.priority |
integer |
Priorita tohoto koncového bodu při použití metody směrování provozu Priority Možné hodnoty jsou od 1 do 1000, nižší hodnoty představují vyšší prioritu. Jedná se o volitelný parametr. Pokud je zadaný, musí být zadaný na všech koncových bodech a žádné dva koncové body nemůžou sdílet stejnou hodnotu priority. |
properties.subnets |
Subnets[] |
Seznam podsítí, IP adres nebo rozsahů adres mapovaných na tento koncový bod při použití metody směrování provozu Subnet. Prázdný seznam bude odpovídat všem rozsahům, které ostatní koncové body nepokrývala. |
properties.target |
string |
Plně kvalifikovaný název DNS nebo IP adresa koncového bodu. Traffic Manager vrátí tuto hodnotu v odpovědích DNS pro směrování provozu do tohoto koncového bodu. |
properties.targetResourceId |
string |
Identifikátor URI prostředku Azure koncového bodu. Nevztahuje se na koncové body typu ExternalEndpoints. |
properties.weight |
integer |
Váha tohoto koncového bodu při použití metody směrování váženého provozu Možné hodnoty jsou od 1 do 1000. |
type |
string |
Typ prostředku. Příklad: Microsoft.Network/trafficManagerProfiles. |
EndpointMonitorStatus
Stav monitorování koncového bodu.
Name | Typ | Description |
---|---|---|
CheckingEndpoint |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
|
Stopped |
string |
|
Unmonitored |
string |
EndpointStatus
Stav koncového bodu. Pokud je koncový bod povolený, dotazuje se na stav koncového bodu a je zahrnutý v metodě směrování provozu.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpectedStatusCodeRanges
Seznam očekávaných rozsahů stavových kódů
Name | Typ | Description |
---|---|---|
max |
integer |
Maximální stavový kód. |
min |
integer |
Minimální stavový kód. |
MonitorConfig
Třída obsahující nastavení monitorování koncového bodu v profilu služby Traffic Manager.
Name | Typ | Description |
---|---|---|
customHeaders |
Seznam vlastních hlaviček |
|
expectedStatusCodeRanges |
Seznam očekávaných rozsahů stavových kódů |
|
intervalInSeconds |
integer |
Interval monitorování pro koncové body v tomto profilu. Jedná se o interval, ve kterém Traffic Manager zkontroluje stav jednotlivých koncových bodů v tomto profilu. |
path |
string |
Cesta relativní k názvu domény koncového bodu, která se používá k sondování stavu koncového bodu. |
port |
integer |
Port TCP použitý k sondování stavu koncového bodu. |
profileMonitorStatus |
Stav monitorování na úrovni profilu služby Traffic Manager. |
|
protocol |
Protokol (HTTP, HTTPS nebo TCP) používaný k testování stavu koncového bodu. |
|
timeoutInSeconds |
integer |
Časový limit monitorování pro koncové body v tomto profilu. To je čas, kdy Traffic Manager umožňuje koncovým bodům v tomto profilu reagovat na kontrolu stavu. |
toleratedNumberOfFailures |
integer |
Počet po sobě jdoucích neúspěšných kontrol stavu, které Traffic Manager toleruje před deklarováním koncového bodu v tomto profilu, snížený po další neúspěšné kontrole stavu. |
MonitorProtocol
Protokol (HTTP, HTTPS nebo TCP) používaný k testování stavu koncového bodu.
Name | Typ | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
|
TCP |
string |
Profile
Třída představující profil služby Traffic Manager.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Oblast Azure, ve které se prostředek nachází |
name |
string |
Název prostředku |
properties.allowedEndpointRecordTypes |
Seznam povolených typů záznamů koncového bodu |
|
properties.dnsConfig |
Nastavení DNS profilu služby Traffic Manager. |
|
properties.endpoints |
Endpoint[] |
Seznam koncových bodů v profilu Služby Traffic Manager. |
properties.maxReturn |
integer |
Maximální počet koncových bodů, které se mají vrátit pro typ směrování MultiValue. |
properties.monitorConfig |
Nastavení monitorování koncového bodu profilu služby Traffic Manager. |
|
properties.profileStatus |
Stav profilu služby Traffic Manager. |
|
properties.trafficRoutingMethod |
Metoda směrování provozu profilu služby Traffic Manager. |
|
properties.trafficViewEnrollmentStatus |
Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu. |
|
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. Příklad: Microsoft.Network/trafficManagerProfiles. |
ProfileMonitorStatus
Stav monitorování na úrovni profilu služby Traffic Manager.
Name | Typ | Description |
---|---|---|
CheckingEndpoints |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
ProfileStatus
Stav profilu služby Traffic Manager.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnets
Seznam podsítí, IP adres nebo rozsahů adres mapovaných na tento koncový bod při použití metody směrování provozu Subnet. Prázdný seznam bude odpovídat všem rozsahům, které ostatní koncové body nepokrývala.
Name | Typ | Description |
---|---|---|
first |
string |
První adresa v podsíti. |
last |
string |
Poslední adresa v podsíti. |
scope |
integer |
Velikost bloku (počet počátečních bitů v masce podsítě) |
TrafficRoutingMethod
Metoda směrování provozu profilu služby Traffic Manager.
Name | Typ | Description |
---|---|---|
Geographic |
string |
|
MultiValue |
string |
|
Performance |
string |
|
Priority |
string |
|
Subnet |
string |
|
Weighted |
string |
TrafficViewEnrollmentStatus
Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |