Profiles - Update
Mettez à jour un profil Traffic Manager.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}?api-version=2022-04-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
profile
|
path | True |
string |
Nom du profil Traffic Manager. |
resource
|
path | True |
string |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
subscription
|
path | True |
string |
Obtient les informations d'identification d'abonnement qui identifient l'abonnement Microsoft Azure de manière unique. L’ID d’abonnement fait partie de l’URI pour chaque appel de service. |
api-version
|
query | True |
string |
Version de l’API cliente. |
Corps de la demande
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Région Azure où réside la ressource |
name |
string |
nom de la ressource. |
properties.allowedEndpointRecordTypes |
Liste des types d’enregistrements de point de terminaison autorisés. |
|
properties.dnsConfig |
Paramètres DNS du profil Traffic Manager. |
|
properties.endpoints |
Endpoint[] |
Liste des points de terminaison dans le profil Traffic Manager. |
properties.maxReturn |
integer |
Nombre maximal de points de terminaison à retourner pour le type de routage MultiValue. |
properties.monitorConfig |
Paramètres de surveillance du point de terminaison du profil Traffic Manager. |
|
properties.profileStatus |
Status du profil Traffic Manager. |
|
properties.trafficRoutingMethod |
Méthode de routage du trafic du profil Traffic Manager. |
|
properties.trafficViewEnrollmentStatus |
Indique si le mode Trafic est « Activé » ou « Désactivé » pour le profil Traffic Manager. Null, indique « Désactivé ». L’activation de cette fonctionnalité augmente le coût du profil Traffic Manage. |
|
tags |
object |
Balises de ressource. |
type |
string |
Type de la ressource. Ex- Microsoft.Network/trafficManagerProfiles. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Profil Traffic Manager mis à jour. |
|
Other Status Codes |
Réponse par défaut. Il sera désérialisé conformément à la définition d’erreur. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
Profile-PATCH-MonitorConfig
Exemple de requête
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"
}
]
}
}
}
Exemple de réponse
{
"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"
}
}
]
}
}
Définitions
Nom | Description |
---|---|
Allowed |
Types d’enregistrements DNS de type autorisé pour ce profil. |
Always |
Si Always Serve est activé, la vérification de l’intégrité du point de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic. |
Cloud |
Erreur retournée par azure Resource Manager |
Cloud |
Contenu d’une erreur retournée par le Resource Manager Azure |
Custom |
Liste des en-têtes personnalisés. |
Dns |
Classe contenant des paramètres DNS dans un profil Traffic Manager. |
Endpoint |
Classe représentant un point de terminaison Traffic Manager. |
Endpoint |
Status de surveillance du point de terminaison. |
Endpoint |
Status du point de terminaison. Si le point de terminaison est activé, la sonde vérifie son intégrité, et il est inclus dans la méthode de routage du trafic. |
Expected |
Liste des plages de code status attendues. |
Monitor |
Classe contenant les paramètres de surveillance des points de terminaison dans un profil Traffic Manager. |
Monitor |
Protocole (HTTP, HTTPS ou TCP) utilisé pour sonder l’intégrité du point de terminaison. |
Profile |
Classe représentant un profil Traffic Manager. |
Profile |
La surveillance au niveau du profil status du profil Traffic Manager. |
Profile |
Status du profil Traffic Manager. |
Subnets |
Liste des sous-réseaux, adresses IP et/ou plages d’adresses mappées à ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Sous-réseau ». Une liste vide correspond à toutes les plages non couvertes par d’autres points de terminaison. |
Traffic |
Méthode de routage du trafic du profil Traffic Manager. |
Traffic |
Indique si le mode Trafic est « Activé » ou « Désactivé » pour le profil Traffic Manager. Null, indique « Désactivé ». L’activation de cette fonctionnalité augmente le coût du profil Traffic Manage. |
AllowedEndpointRecordType
Types d’enregistrements DNS de type autorisé pour ce profil.
Nom | Type | Description |
---|---|---|
Any |
string |
|
DomainName |
string |
|
IPv4Address |
string |
|
IPv6Address |
string |
AlwaysServe
Si Always Serve est activé, la vérification de l’intégrité du point de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic.
Nom | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
CloudError
Erreur retournée par azure Resource Manager
Nom | Type | Description |
---|---|---|
error |
Contenu de l’erreur. |
CloudErrorBody
Contenu d’une erreur retournée par le Resource Manager Azure
Nom | Type | Description |
---|---|---|
code |
string |
Code d'erreur |
details |
Détails de l’erreur |
|
message |
string |
Message d’erreur |
target |
string |
Cible d’erreur |
CustomHeaders
Liste des en-têtes personnalisés.
Nom | Type | Description |
---|---|---|
name |
string |
Nom de l’en-tête. |
value |
string |
Valeur de l’en-tête. |
DnsConfig
Classe contenant des paramètres DNS dans un profil Traffic Manager.
Nom | Type | Description |
---|---|---|
fqdn |
string |
Nom de domaine complet (FQDN) du profil Traffic Manager. Il est formé à partir de la concaténation du RelativeName avec le domaine DNS utilisé par Azure Traffic Manager. |
relativeName |
string |
Nom DNS relatif fourni par ce profil Traffic Manager. Cette valeur est combinée au nom de domaine DNS utilisé par Azure Traffic Manager pour former le nom de domaine complet (FQDN) du profil. |
ttl |
integer |
Durée de vie DNS (TTL), en secondes. Cela indique aux résolveurs DNS locaux et aux clients DNS la durée de mise en cache des réponses DNS fournies par ce profil Traffic Manager. |
Endpoint
Classe représentant un point de terminaison Traffic Manager.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
name |
string |
nom de la ressource. |
properties.alwaysServe |
Si Always Serve est activé, la vérification de l’intégrité du point de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic. |
|
properties.customHeaders |
Liste des en-têtes personnalisés. |
|
properties.endpointLocation |
string |
Spécifie l’emplacement des points de terminaison externes ou imbriqués lors de l’utilisation de la méthode de routage du trafic « Performances ». |
properties.endpointMonitorStatus |
Status de surveillance du point de terminaison. |
|
properties.endpointStatus |
Status du point de terminaison. Si le point de terminaison est activé, la sonde vérifie son intégrité, et il est inclus dans la méthode de routage du trafic. |
|
properties.geoMapping |
string[] |
Liste des pays/régions mappés à ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Géographique ». Consultez la documentation géographique traffic Manager pour obtenir la liste complète des valeurs acceptées. |
properties.minChildEndpoints |
integer |
Nombre minimal de points de terminaison qui doivent être disponibles dans le profil enfant pour que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ». |
properties.minChildEndpointsIPv4 |
integer |
Nombre minimal de points de terminaison IPv4 (type d’enregistrement DNS A) qui doivent être disponibles dans le profil enfant pour que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ». |
properties.minChildEndpointsIPv6 |
integer |
Nombre minimal de points de terminaison IPv6 (type d’enregistrement DNS AAAA) qui doivent être disponibles dans le profil enfant pour que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ». |
properties.priority |
integer |
Priorité de ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Priority ». Les valeurs possibles sont comprises entre 1 et 1 000, les valeurs inférieures représentant une priorité plus élevée. Il s'agit d'un paramètre facultatif. S'il est spécifié, il doit l'être pour tous les points de terminaison, et deux points de terminaison ne peuvent pas partager la même valeur de priorité. |
properties.subnets |
Subnets[] |
Liste des sous-réseaux, adresses IP et/ou plages d’adresses mappées à ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Sous-réseau ». Une liste vide correspond à toutes les plages non couvertes par d’autres points de terminaison. |
properties.target |
string |
Nom DNS complet ou adresse IP du point de terminaison. Traffic Manager renvoie cette valeur dans les réponses DNS pour diriger le trafic vers ce point de terminaison. |
properties.targetResourceId |
string |
URI de ressource Azure du du point de terminaison. Non applicable aux points de terminaison de type « ExternalEndpoints ». |
properties.weight |
integer |
Poids de ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Pondéré ». Les valeurs possibles sont comprises entre 1 et 1000. |
type |
string |
Type de la ressource. Ex- Microsoft.Network/trafficManagerProfiles. |
EndpointMonitorStatus
Status de surveillance du point de terminaison.
Nom | Type | Description |
---|---|---|
CheckingEndpoint |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
|
Stopped |
string |
|
Unmonitored |
string |
EndpointStatus
Status du point de terminaison. Si le point de terminaison est activé, la sonde vérifie son intégrité, et il est inclus dans la méthode de routage du trafic.
Nom | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpectedStatusCodeRanges
Liste des plages de code status attendues.
Nom | Type | Description |
---|---|---|
max |
integer |
Max status code. |
min |
integer |
Code status minimal. |
MonitorConfig
Classe contenant les paramètres de surveillance des points de terminaison dans un profil Traffic Manager.
Nom | Type | Description |
---|---|---|
customHeaders |
Liste des en-têtes personnalisés. |
|
expectedStatusCodeRanges |
Liste des plages de code status attendues. |
|
intervalInSeconds |
integer |
Intervalle de surveillance pour les points de terminaison dans ce profil. Il s’agit de l’intervalle auquel Traffic Manager case activée l’intégrité de chaque point de terminaison dans ce profil. |
path |
string |
Chemin relatif au nom de domaine du point de terminaison utilisé pour sonder l’intégrité du point de terminaison. |
port |
integer |
Port TCP utilisé pour sonder l’intégrité du point de terminaison. |
profileMonitorStatus |
La surveillance au niveau du profil status du profil Traffic Manager. |
|
protocol |
Protocole (HTTP, HTTPS ou TCP) utilisé pour sonder l’intégrité du point de terminaison. |
|
timeoutInSeconds |
integer |
Délai d’attente du moniteur pour les points de terminaison dans ce profil. Il s’agit du moment où Traffic Manager autorise les points de terminaison de ce profil à répondre au case activée d’intégrité. |
toleratedNumberOfFailures |
integer |
Le nombre d’échecs d’intégrité consécutifs case activée que Traffic Manager tolère avant de déclarer un point de terminaison dans ce profil Dégradé après la prochaine case activée d’intégrité défaillante. |
MonitorProtocol
Protocole (HTTP, HTTPS ou TCP) utilisé pour sonder l’intégrité du point de terminaison.
Nom | Type | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
|
TCP |
string |
Profile
Classe représentant un profil Traffic Manager.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Région Azure où réside la ressource |
name |
string |
nom de la ressource. |
properties.allowedEndpointRecordTypes |
Liste des types d’enregistrements de point de terminaison autorisés. |
|
properties.dnsConfig |
Paramètres DNS du profil Traffic Manager. |
|
properties.endpoints |
Endpoint[] |
Liste des points de terminaison dans le profil Traffic Manager. |
properties.maxReturn |
integer |
Nombre maximal de points de terminaison à retourner pour le type de routage MultiValue. |
properties.monitorConfig |
Paramètres de surveillance du point de terminaison du profil Traffic Manager. |
|
properties.profileStatus |
Status du profil Traffic Manager. |
|
properties.trafficRoutingMethod |
Méthode de routage du trafic du profil Traffic Manager. |
|
properties.trafficViewEnrollmentStatus |
Indique si le mode Trafic est « Activé » ou « Désactivé » pour le profil Traffic Manager. Null, indique « Désactivé ». L’activation de cette fonctionnalité augmente le coût du profil Traffic Manage. |
|
tags |
object |
Balises de ressource. |
type |
string |
Type de la ressource. Ex- Microsoft.Network/trafficManagerProfiles. |
ProfileMonitorStatus
La surveillance au niveau du profil status du profil Traffic Manager.
Nom | Type | Description |
---|---|---|
CheckingEndpoints |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
ProfileStatus
Status du profil Traffic Manager.
Nom | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnets
Liste des sous-réseaux, adresses IP et/ou plages d’adresses mappées à ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Sous-réseau ». Une liste vide correspond à toutes les plages non couvertes par d’autres points de terminaison.
Nom | Type | Description |
---|---|---|
first |
string |
Première adresse dans le sous-réseau. |
last |
string |
Dernière adresse dans le sous-réseau. |
scope |
integer |
Taille du bloc (nombre de bits de début dans le masque de sous-réseau). |
TrafficRoutingMethod
Méthode de routage du trafic du profil Traffic Manager.
Nom | Type | Description |
---|---|---|
Geographic |
string |
|
MultiValue |
string |
|
Performance |
string |
|
Priority |
string |
|
Subnet |
string |
|
Weighted |
string |
TrafficViewEnrollmentStatus
Indique si le mode Trafic est « Activé » ou « Désactivé » pour le profil Traffic Manager. Null, indique « Désactivé ». L’activation de cette fonctionnalité augmente le coût du profil Traffic Manage.
Nom | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |