Partager via

Profiles - List By Resource Group

  • Référence
Service:
Traffic Manager
Version d'API:
2022-04-01

Listes tous les profils Traffic Manager au sein d’un groupe de ressources.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
 path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId
 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.

Réponses

Nom Type Description
200 OK

ProfileListResult

Liste des profils Traffic Manager.
Other Status Codes

CloudError

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

ListProfilesByResourceGroup

Exemple de requête

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficmanagerprofiles?api-version=2022-04-01

Exemple de réponse

Code d’état:
200 
{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager1005",
      "name": "azuresdkfornetautoresttrafficmanager1005",
      "type": "Microsoft.Network/trafficManagerProfiles",
      "location": "global",
      "tags": {},
      "properties": {
        "profileStatus": "Enabled",
        "trafficRoutingMethod": "Performance",
        "dnsConfig": {
          "relativeName": "azuresdkfornetautoresttrafficmanager1005",
          "fqdn": "azuresdkfornetautoresttrafficmanager1005.tmpreview.watmtest.azure-test.net",
          "ttl": 35
        },
        "monitorConfig": {
          "profileMonitorStatus": "Online",
          "protocol": "HTTP",
          "port": 80,
          "path": "/testpath.aspx",
          "intervalInSeconds": 30,
          "toleratedNumberOfFailures": 3,
          "timeoutInSeconds": 10
        },
        "endpoints": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager1005/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"
            }
          }
        ]
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager959",
      "name": "azuresdkfornetautoresttrafficmanager959",
      "type": "Microsoft.Network/trafficManagerProfiles",
      "location": "global",
      "tags": {},
      "properties": {
        "profileStatus": "Enabled",
        "trafficRoutingMethod": "Performance",
        "dnsConfig": {
          "relativeName": "azuresdkfornetautoresttrafficmanager959",
          "fqdn": "azuresdkfornetautoresttrafficmanager959.tmpreview.watmtest.azure-test.net",
          "ttl": 35
        },
        "monitorConfig": {
          "profileMonitorStatus": "Online",
          "protocol": "HTTP",
          "port": 80,
          "path": "/testpath.aspx",
          "intervalInSeconds": 30,
          "toleratedNumberOfFailures": 3,
          "timeoutInSeconds": 10
        },
        "endpoints": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager3640/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager959/externalEndpoints/My external endpoint",
            "name": "My external endpoint",
            "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
            "properties": {
              "endpointStatus": "Enabled",
              "endpointMonitorStatus": "Online",
              "target": "foobar.contoso.com",
              "weight": 1,
              "priority": 1,
              "endpointLocation": "North Europe"
            }
          }
        ]
      }
    }
  ]
}

Définitions

Nom Description
AllowedEndpointRecordType

Types d’enregistrements DNS de type autorisés pour ce profil.
AlwaysServe

Si Always Serve est activé, la recherche 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.
CloudError

Erreur retournée par le Resource Manager Azure
CloudErrorBody

Contenu d’une erreur retournée par azure Resource Manager
CustomHeaders

Liste des en-têtes personnalisés.
DnsConfig

Classe contenant des paramètres DNS dans un profil Traffic Manager.
Endpoint

Classe représentant un point de terminaison Traffic Manager.
EndpointMonitorStatus

Status de surveillance du point de terminaison.
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.
ExpectedStatusCodeRanges

Liste des plages de code status attendues.
MonitorConfig

Classe contenant les paramètres de surveillance des points de terminaison dans un profil Traffic Manager.
MonitorProtocol

Protocole (HTTP, HTTPS ou TCP) utilisé pour sonder l’intégrité du point de terminaison.
Profile

Classe représentant un profil Traffic Manager.
ProfileListResult

Lister la réponse de l’opération des profils Traffic Manager.
ProfileMonitorStatus

La surveillance au niveau du profil status du profil Traffic Manager.
ProfileStatus

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.
TrafficRoutingMethod

Méthode de routage du trafic du profil Traffic Manager.
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.

AllowedEndpointRecordType

Types d’enregistrements DNS de type autorisés pour ce profil.

Nom Type Description
Any

string

DomainName

string

IPv4Address

string

IPv6Address

string

AlwaysServe

Si Always Serve est activé, la recherche 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 le Resource Manager Azure

Nom Type Description
error

CloudErrorBody

Contenu de l’erreur.

CloudErrorBody

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

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. Cela 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 (TTL) DNS, 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

AlwaysServe

Si Always Serve est activé, la recherche 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

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 « Performance ».
properties.endpointMonitorStatus

EndpointMonitorStatus

Status de surveillance du point de terminaison.
properties.endpointStatus

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 de 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ésentent 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

Min status code.

MonitorConfig

Classe contenant les paramètres de surveillance des points de terminaison dans un profil Traffic Manager.

Nom Type Description
customHeaders

CustomHeaders[]

Liste des en-têtes personnalisés.
expectedStatusCodeRanges

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 d’accès relatif au nom de domaine de 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

ProfileMonitorStatus

La surveillance au niveau du profil status du profil Traffic Manager.
protocol

MonitorProtocol

Protocole (HTTP, HTTPS ou TCP) utilisé pour sonder l’intégrité du point de terminaison.
timeoutInSeconds

integer

Délai d’expiration du moniteur pour les points de terminaison dans ce profil. C’est le moment où Traffic Manager autorise les points de terminaison de ce profil à répondre aux case activée d’intégrité.
toleratedNumberOfFailures

integer

Nombre d’case activée d’intégrité consécutives que Traffic Manager tolère avant de déclarer un point de terminaison dans ce profil Détérioré 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

AllowedEndpointRecordType[]

Liste des types d’enregistrements de point de terminaison autorisés.
properties.dnsConfig

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

MonitorConfig

Paramètres de surveillance du point de terminaison du profil Traffic Manager.
properties.profileStatus

ProfileStatus

Status du profil Traffic Manager.
properties.trafficRoutingMethod

TrafficRoutingMethod

Méthode de routage du trafic du profil Traffic Manager.
properties.trafficViewEnrollmentStatus

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.

ProfileListResult

Lister la réponse de l’opération des profils Traffic Manager.

Nom Type Description
value

Profile[]

Obtient la liste des profils Traffic Manager.

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 du 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