Profiles - List By Resource Group
Listas todos los perfiles de Traffic Manager dentro de un grupo de recursos.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficmanagerprofiles?api-version=2022-04-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
subscription
|
path | True |
string |
Obtiene las credenciales de suscripción que identifican a la suscripción de Microsoft Azure de forma única. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
api-version
|
query | True |
string |
Versión de api de cliente. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Lista de perfiles de Traffic Manager. |
|
Other Status Codes |
Respuesta predeterminada. Se deserializará según la definición de error. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantación de su cuenta de usuario |
Ejemplos
ListProfilesByResourceGroup
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
}
]
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Allowed |
Los tipos de registro DNS permitidos para este perfil. |
Always |
Si Always Serve está habilitado, se deshabilitará el sondeo del estado del punto de conexión y los puntos de conexión se incluirán en el método de enrutamiento del tráfico. |
Cloud |
Error devuelto por azure Resource Manager |
Cloud |
El contenido de un error devuelto por azure Resource Manager |
Custom |
Lista de encabezados personalizados. |
Dns |
Clase que contiene la configuración de DNS en un perfil de Traffic Manager. |
Endpoint |
Clase que representa un punto de conexión de Traffic Manager. |
Endpoint |
Estado de supervisión del punto de conexión. |
Endpoint |
Estado del punto de conexión. Si el valor del extremo es Enabled, se sondea el mantenimiento del extremo y se incluye en el método de enrutamiento de tráfico. |
Expected |
Lista de intervalos de código de estado esperados. |
Monitor |
Clase que contiene la configuración de supervisión de puntos de conexión en un perfil de Traffic Manager. |
Monitor |
Protocolo (HTTP, HTTPS o TCP) que se usa para sondear el estado del punto de conexión. |
Profile |
Clase que representa un perfil de Traffic Manager. |
Profile |
Respuesta de la operación de perfiles de Traffic Manager de lista. |
Profile |
Estado de supervisión de nivel de perfil del perfil de Traffic Manager. |
Profile |
Estado del perfil de Traffic Manager. |
Subnets |
La lista de subredes, direcciones IP o intervalos de direcciones asignados a este punto de conexión cuando se usa el método de enrutamiento de tráfico "Subred". Una lista vacía coincidirá con todos los intervalos no cubiertos por otros puntos de conexión. |
Traffic |
Método de enrutamiento de tráfico del perfil de Traffic Manager. |
Traffic |
Indica si Traffic View es "Habilitado" o "Deshabilitado" para el perfil de Traffic Manager. Null, indica "Disabled". La habilitación de esta característica aumentará el costo del perfil de Administración de tráfico. |
AllowedEndpointRecordType
Los tipos de registro DNS permitidos para este perfil.
Nombre | Tipo | Description |
---|---|---|
Any |
string |
|
DomainName |
string |
|
IPv4Address |
string |
|
IPv6Address |
string |
AlwaysServe
Si Always Serve está habilitado, se deshabilitará el sondeo del estado del punto de conexión y los puntos de conexión se incluirán en el método de enrutamiento del tráfico.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
CloudError
Error devuelto por azure Resource Manager
Nombre | Tipo | Description |
---|---|---|
error |
Contenido del error. |
CloudErrorBody
El contenido de un error devuelto por azure Resource Manager
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error |
details |
Detalles del error |
|
message |
string |
Mensaje de error |
target |
string |
Destino de error |
CustomHeaders
Lista de encabezados personalizados.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre del encabezado. |
value |
string |
Valor del encabezado. |
DnsConfig
Clase que contiene la configuración de DNS en un perfil de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
fqdn |
string |
Nombre de dominio completo (FQDN) del perfil de Traffic Manager. Esto se forma a partir de la concatenación de RelativeName con el dominio DNS usado por Azure Traffic Manager. |
relativeName |
string |
Nombre DNS relativo proporcionado por este perfil de Traffic Manager. Este valor se combina con el nombre de dominio DNS utilizado por el Administrador de tráfico de Azure para formar el nombre de dominio completo (FQDN) del perfil. |
ttl |
integer |
Tiempo de vida de DNS (TTL), en segundos. Esto informa a los solucionadores DNS locales y a los clientes DNS cuánto tiempo se almacenan en caché las respuestas DNS proporcionadas por este perfil de Traffic Manager. |
Endpoint
Clase que representa un punto de conexión de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
name |
string |
Nombre del recurso. |
properties.alwaysServe |
Si Always Serve está habilitado, el sondeo para el estado del punto de conexión se deshabilitará y los puntos de conexión se incluirán en el método de enrutamiento del tráfico. |
|
properties.customHeaders |
Lista de encabezados personalizados. |
|
properties.endpointLocation |
string |
Especifica la ubicación de los puntos de conexión externos o anidados cuando se usa el método de enrutamiento de tráfico "Rendimiento". |
properties.endpointMonitorStatus |
Estado de supervisión del punto de conexión. |
|
properties.endpointStatus |
Estado del punto de conexión. Si el valor del extremo es Enabled, se sondea el mantenimiento del extremo y se incluye en el método de enrutamiento de tráfico. |
|
properties.geoMapping |
string[] |
La lista de países o regiones asignados a este punto de conexión cuando se usa el método de enrutamiento de tráfico "Geográfico". Consulte la documentación geográfica de Traffic Manager para obtener una lista completa de los valores aceptados. |
properties.minChildEndpoints |
integer |
Número mínimo de puntos de conexión que deben estar disponibles en el perfil secundario para que el perfil primario se considere disponible. Solo se aplica al punto de conexión de tipo "NestedEndpoints". |
properties.minChildEndpointsIPv4 |
integer |
Número mínimo de puntos de conexión IPv4 (tipo de registro DNS A) que deben estar disponibles en el perfil secundario para que el perfil primario se considere disponible. Solo se aplica al punto de conexión de tipo "NestedEndpoints". |
properties.minChildEndpointsIPv6 |
integer |
Número mínimo de puntos de conexión IPv6 (AAAA del tipo de registro DNS) que deben estar disponibles en el perfil secundario para que el perfil primario se considere disponible. Solo se aplica al punto de conexión de tipo "NestedEndpoints". |
properties.priority |
integer |
Prioridad de este punto de conexión cuando se usa el método de enrutamiento de tráfico "Prioridad". Los valores posibles son de 1 a 1000, los valores inferiores representan una prioridad más alta. Se trata de un parámetro opcional. Si se especifica, se debe especificar en todos los extremos y no puede haber dos extremos que compartan el mismo valor de prioridad. |
properties.subnets |
Subnets[] |
La lista de subredes, direcciones IP o intervalos de direcciones asignados a este punto de conexión cuando se usa el método de enrutamiento de tráfico "Subred". Una lista vacía coincidirá con todos los intervalos no cubiertos por otros puntos de conexión. |
properties.target |
string |
Nombre DNS completo o dirección IP del punto de conexión. El Administrador de tráfico devuelve este valor en las respuestas de DNS para dirigir el tráfico a este extremo. |
properties.targetResourceId |
string |
URI del recurso de Azure del punto de conexión. No es aplicable a los puntos de conexión de tipo "ExternalEndpoints". |
properties.weight |
integer |
El peso de este punto de conexión cuando se usa el método de enrutamiento de tráfico "Ponderado". Los valores posibles son de 1 a 1000. |
type |
string |
Tipo de recurso. Ex- Microsoft.Network/trafficManagerProfiles. |
EndpointMonitorStatus
Estado de supervisión del punto de conexión.
Nombre | Tipo | Description |
---|---|---|
CheckingEndpoint |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
|
Stopped |
string |
|
Unmonitored |
string |
EndpointStatus
Estado del punto de conexión. Si el valor del extremo es Enabled, se sondea el mantenimiento del extremo y se incluye en el método de enrutamiento de tráfico.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpectedStatusCodeRanges
Lista de intervalos de código de estado esperados.
Nombre | Tipo | Description |
---|---|---|
max |
integer |
Código de estado máximo. |
min |
integer |
Código de estado mínimo. |
MonitorConfig
Clase que contiene la configuración de supervisión de puntos de conexión en un perfil de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
customHeaders |
Lista de encabezados personalizados. |
|
expectedStatusCodeRanges |
Lista de intervalos de código de estado esperados. |
|
intervalInSeconds |
integer |
El intervalo de supervisión de los puntos de conexión de este perfil. Este es el intervalo en el que Traffic Manager comprobará el estado de cada punto de conexión de este perfil. |
path |
string |
Ruta de acceso relativa al nombre de dominio del punto de conexión que se usa para sondear el estado del punto de conexión. |
port |
integer |
Puerto TCP que se usa para sondear el estado del punto de conexión. |
profileMonitorStatus |
Estado de supervisión de nivel de perfil del perfil de Traffic Manager. |
|
protocol |
Protocolo (HTTP, HTTPS o TCP) que se usa para sondear el estado del punto de conexión. |
|
timeoutInSeconds |
integer |
Tiempo de espera de supervisión de los puntos de conexión de este perfil. Este es el momento en que Traffic Manager permite que los puntos de conexión de este perfil responda a la comprobación de estado. |
toleratedNumberOfFailures |
integer |
Número de comprobaciones consecutivas de estado erróneas que Traffic Manager tolera antes de declarar un punto de conexión en este perfil Degradado después de la siguiente comprobación de estado con errores. |
MonitorProtocol
Protocolo (HTTP, HTTPS o TCP) que se usa para sondear el estado del punto de conexión.
Nombre | Tipo | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
|
TCP |
string |
Profile
Clase que representa un perfil de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName} |
location |
string |
Región de Azure donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.allowedEndpointRecordTypes |
Lista de tipos de registro de punto de conexión permitidos. |
|
properties.dnsConfig |
Configuración dns del perfil de Traffic Manager. |
|
properties.endpoints |
Endpoint[] |
Lista de puntos de conexión en el perfil de Traffic Manager. |
properties.maxReturn |
integer |
Número máximo de puntos de conexión que se van a devolver para el tipo de enrutamiento MultiValue. |
properties.monitorConfig |
La configuración de supervisión de puntos de conexión del perfil de Traffic Manager. |
|
properties.profileStatus |
Estado del perfil de Traffic Manager. |
|
properties.trafficRoutingMethod |
Método de enrutamiento de tráfico del perfil de Traffic Manager. |
|
properties.trafficViewEnrollmentStatus |
Indica si Traffic View es "Habilitado" o "Deshabilitado" para el perfil de Traffic Manager. Null, indica "Disabled". La habilitación de esta característica aumentará el costo del perfil de Administración de tráfico. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Ex- Microsoft.Network/trafficManagerProfiles. |
ProfileListResult
Respuesta de la operación de perfiles de Traffic Manager de lista.
Nombre | Tipo | Description |
---|---|---|
value |
Profile[] |
Obtiene la lista de perfiles de Traffic Manager. |
ProfileMonitorStatus
Estado de supervisión de nivel de perfil del perfil de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
CheckingEndpoints |
string |
|
Degraded |
string |
|
Disabled |
string |
|
Inactive |
string |
|
Online |
string |
ProfileStatus
Estado del perfil de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnets
La lista de subredes, direcciones IP o intervalos de direcciones asignados a este punto de conexión cuando se usa el método de enrutamiento de tráfico "Subred". Una lista vacía coincidirá con todos los intervalos no cubiertos por otros puntos de conexión.
Nombre | Tipo | Description |
---|---|---|
first |
string |
Primera dirección de la subred. |
last |
string |
Última dirección de la subred. |
scope |
integer |
Tamaño de bloque (número de bits iniciales en la máscara de subred). |
TrafficRoutingMethod
Método de enrutamiento de tráfico del perfil de Traffic Manager.
Nombre | Tipo | Description |
---|---|---|
Geographic |
string |
|
MultiValue |
string |
|
Performance |
string |
|
Priority |
string |
|
Subnet |
string |
|
Weighted |
string |
TrafficViewEnrollmentStatus
Indica si Traffic View es "Habilitado" o "Deshabilitado" para el perfil de Traffic Manager. Null, indica "Disabled". La habilitación de esta característica aumentará el costo del perfil de Administración de tráfico.
Nombre | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |