Endpoints - Update

Service:: Traffic Manager

Version d'API:: 2022-04-01

Mettez à jour un point de terminaison Traffic Manager.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles/{profileName}/{endpointType}/{endpointName}?api-version=2022-04-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpointName	path	True	string	Nom du point de terminaison Traffic Manager.
endpointType	path	True	EndpointType	Type de point de terminaison Traffic Manager.
profileName	path	True	string	Nom du profil Traffic Manager.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
id	string (arm-id)	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	AlwaysServe	Si Always Serve est activé, la détection de l’intégrité des points de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic.
properties.customHeaders	EndpointPropertiesCustomHeadersItem[]	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 « Performance ».
properties.endpointMonitorStatus	EndpointMonitorStatus	État de surveillance du point de terminaison.
properties.endpointStatus	EndpointStatus	État du point de terminaison. Si le point de terminaison est activé, il est sondé pour l’intégrité du point de terminaison et 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 de Traffic Manager pour obtenir la liste complète des valeurs acceptées.
properties.minChildEndpoints	integer (int64)	Nombre minimal de points de terminaison qui doivent être disponibles dans le profil enfant afin que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».
properties.minChildEndpointsIPv4	integer (int64)	Nombre minimal de points de terminaison IPv4 (type d’enregistrement DNS A) qui doivent être disponibles dans le profil enfant afin que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».
properties.minChildEndpointsIPv6	integer (int64)	Nombre minimal de points de terminaison IPv6 (type d’enregistrement DNS AAAA) qui doivent être disponibles dans le profil enfant afin que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».
properties.priority	integer (int64)	Priorité de ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Priorité ». Les valeurs possibles sont comprises entre 1 et 1 000, les valeurs inférieures représentent une priorité plus élevée. Il s’agit d’un paramètre facultatif. S’il est spécifié, il doit être spécifié sur tous les points de terminaison et aucun point de terminaison ne peut partager la même valeur de priorité.
properties.subnets	EndpointPropertiesSubnetsItem[]	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 « Subnet ». 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 retourne cette valeur dans les réponses DNS pour diriger le trafic vers ce point de terminaison.
properties.targetResourceId	string	URI de ressource Azure du point de terminaison. Non applicable aux points de terminaison de type « ExternalEndpoints ».
properties.weight	integer (int64)	Poids de ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Weighted ». Les valeurs possibles sont comprises entre 1 et 1 000.
type	string	Type de la ressource. Ex- Microsoft.Network/trafficManagerProfiles.

Réponses

Nom	Type	Description
200 OK	Endpoint	L’opération Azure s’est terminée avec succès.
Other Status Codes	CloudError	Réponse d’erreur inattendue.

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

Endpoint-PATCH-External-Target

Exemple de requête

HTTP

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficmanagerprofiles/azsmnet6386/ExternalEndpoints/azsmnet7187?api-version=2022-04-01

{
  "name": "azsmnet7187",
  "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "properties": {
    "target": "another.foobar.contoso.com"
  }
}

Exemple de réponse

Code d’état:: 200

{
  "name": "azsmnet7187",
  "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "properties": {
    "endpointLocation": "North Europe",
    "endpointMonitorStatus": "CheckingEndpoint",
    "endpointStatus": "Enabled",
    "priority": 1,
    "target": "another.foobar.contoso.com",
    "weight": 1
  }
}

Définitions

Nom	Description
AlwaysServe	Si Always Serve est activé, la détection de l’intégrité des points de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic.
CloudError	Erreur retournée par Azure Resource Manager
CloudErrorBody	Contenu d’une erreur retournée par Azure Resource Manager
Endpoint	Classe représentant un point de terminaison Traffic Manager.
EndpointMonitorStatus	État de surveillance du point de terminaison.
EndpointPropertiesCustomHeadersItem	Nom et valeur de l’en-tête personnalisé.
EndpointPropertiesSubnetsItem	Première adresse, portée et/ou dernière adresse du sous-réseau.
EndpointStatus	État du point de terminaison. Si le point de terminaison est activé, il est sondé pour l’intégrité du point de terminaison et est inclus dans la méthode de routage du trafic.
EndpointType	Type de point de terminaison Traffic Manager.

AlwaysServe

Énumération

Si Always Serve est activé, la détection de l’intégrité des points de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic.

Valeur	Description
Enabled
Disabled

CloudError

Objet

Erreur retournée par Azure Resource Manager

Nom	Type	Description
error	CloudErrorBody	Contenu de l’erreur.

CloudErrorBody

Objet

Contenu d’une erreur retournée par Azure Resource Manager

Nom	Type	Description
code	string	Code d’erreur
details	CloudErrorBody[]	Détails de l’erreur
message	string	Message d'erreur
target	string	Cible d’erreur

Endpoint

Objet

Classe représentant un point de terminaison Traffic Manager.

Nom	Type	Description
id	string (arm-id)	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	AlwaysServe	Si Always Serve est activé, la détection de l’intégrité des points de terminaison est désactivée et les points de terminaison sont inclus dans la méthode de routage du trafic.
properties.customHeaders	EndpointPropertiesCustomHeadersItem[]	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 « Performance ».
properties.endpointMonitorStatus	EndpointMonitorStatus	État de surveillance du point de terminaison.
properties.endpointStatus	EndpointStatus	État du point de terminaison. Si le point de terminaison est activé, il est sondé pour l’intégrité du point de terminaison et 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 de Traffic Manager pour obtenir la liste complète des valeurs acceptées.
properties.minChildEndpoints	integer (int64)	Nombre minimal de points de terminaison qui doivent être disponibles dans le profil enfant afin que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».
properties.minChildEndpointsIPv4	integer (int64)	Nombre minimal de points de terminaison IPv4 (type d’enregistrement DNS A) qui doivent être disponibles dans le profil enfant afin que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».
properties.minChildEndpointsIPv6	integer (int64)	Nombre minimal de points de terminaison IPv6 (type d’enregistrement DNS AAAA) qui doivent être disponibles dans le profil enfant afin que le profil parent soit considéré comme disponible. Applicable uniquement au point de terminaison de type « NestedEndpoints ».
properties.priority	integer (int64)	Priorité de ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Priorité ». Les valeurs possibles sont comprises entre 1 et 1 000, les valeurs inférieures représentent une priorité plus élevée. Il s’agit d’un paramètre facultatif. S’il est spécifié, il doit être spécifié sur tous les points de terminaison et aucun point de terminaison ne peut partager la même valeur de priorité.
properties.subnets	EndpointPropertiesSubnetsItem[]	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 « Subnet ». 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 retourne cette valeur dans les réponses DNS pour diriger le trafic vers ce point de terminaison.
properties.targetResourceId	string	URI de ressource Azure du point de terminaison. Non applicable aux points de terminaison de type « ExternalEndpoints ».
properties.weight	integer (int64)	Poids de ce point de terminaison lors de l’utilisation de la méthode de routage du trafic « Weighted ». Les valeurs possibles sont comprises entre 1 et 1 000.
type	string	Type de la ressource. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Énumération

État de surveillance du point de terminaison.

Valeur	Description
CheckingEndpoint
Online
Degraded
Disabled
Inactive
Stopped
Unmonitored

EndpointPropertiesCustomHeadersItem

Objet

Nom et valeur de l’en-tête personnalisé.

Nom	Type	Description
name	string	Nom de l’en-tête.
value	string	Valeur d’en-tête.

EndpointPropertiesSubnetsItem

Objet

Première adresse, portée et/ou dernière adresse du sous-réseau.

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 (int32)	Taille de bloc (nombre de bits de début dans le masque de sous-réseau).

EndpointStatus

Énumération

État du point de terminaison. Si le point de terminaison est activé, il est sondé pour l’intégrité du point de terminaison et est inclus dans la méthode de routage du trafic.

Valeur	Description
Enabled
Disabled

EndpointType

Énumération

Type de point de terminaison Traffic Manager.

Valeur	Description
AzureEndpoints
ExternalEndpoints
NestedEndpoints

Partager via

Endpoints - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Endpoint-PATCH-External-Target

Exemple de requête

Exemple de réponse

Définitions

AlwaysServe

CloudError

CloudErrorBody

Endpoint

EndpointMonitorStatus

EndpointPropertiesCustomHeadersItem

EndpointPropertiesSubnetsItem

EndpointStatus

EndpointType