Condividi tramite


Profiles - Get

Ottiene un profilo di Gestione traffico.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
profileName
path True

string

Nome del profilo di Gestione traffico.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

subscriptionId
path True

string

Ottiene le credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.

api-version
query True

string

Versione dell'API client.

Risposte

Nome Tipo Descrizione
200 OK

Profile

Profilo di Gestione traffico.

Other Status Codes

CloudError

Risposta predefinita. Verrà deserializzato in base alla definizione di errore.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

Profile-GET-WithEndpoints
Profile-GET-WithTrafficViewDisabled
Profile-GET-WithTrafficViewEnabled

Profile-GET-WithEndpoints

Esempio di richiesta

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

Risposta di esempio

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1323/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3880",
  "name": "azuresdkfornetautoresttrafficmanager3880",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "tags": {},
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager3880",
      "fqdn": "azuresdkfornetautoresttrafficmanager3880.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1323/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3880/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"
        }
      }
    ]
  }
}

Profile-GET-WithTrafficViewDisabled

Esempio di richiesta

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

Risposta di esempio

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1323/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3880",
  "name": "azuresdkfornetautoresttrafficmanager3880",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "tags": {},
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager3880",
      "fqdn": "azuresdkfornetautoresttrafficmanager3880.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1323/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3880/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"
        }
      }
    ],
    "trafficViewEnrollmentStatus": "Disabled"
  }
}

Profile-GET-WithTrafficViewEnabled

Esempio di richiesta

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

Risposta di esempio

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1323/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3880",
  "name": "azuresdkfornetautoresttrafficmanager3880",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "location": "global",
  "tags": {},
  "properties": {
    "profileStatus": "Enabled",
    "trafficRoutingMethod": "Performance",
    "dnsConfig": {
      "relativeName": "azuresdkfornetautoresttrafficmanager3880",
      "fqdn": "azuresdkfornetautoresttrafficmanager3880.tmpreview.watmtest.azure-test.net",
      "ttl": 35
    },
    "monitorConfig": {
      "profileMonitorStatus": "CheckingEndpoints",
      "protocol": "HTTP",
      "port": 80,
      "path": "/testpath.aspx",
      "intervalInSeconds": 30,
      "toleratedNumberOfFailures": 3,
      "timeoutInSeconds": 10
    },
    "endpoints": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1323/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3880/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"
        }
      }
    ],
    "trafficViewEnrollmentStatus": "Enabled"
  }
}

Definizioni

Nome Descrizione
AllowedEndpointRecordType

Tipi di record DNS di tipo consentiti per questo profilo.

AlwaysServe

Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.

CloudError

Errore restituito da Azure Resource Manager

CloudErrorBody

Contenuto di un errore restituito da Azure Resource Manager

CustomHeaders

Elenco di intestazioni personalizzate.

DnsConfig

Classe contenente le impostazioni DNS in un profilo di Gestione traffico.

Endpoint

Classe che rappresenta un endpoint di Gestione traffico.

EndpointMonitorStatus

Stato di monitoraggio dell'endpoint.

EndpointStatus

Stato dell'endpoint. Se l'endpoint è Abilitato, viene eseguito il probe per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.

ExpectedStatusCodeRanges

Elenco degli intervalli di codici di stato previsti.

MonitorConfig

Classe contenente le impostazioni di monitoraggio degli endpoint in un profilo di Gestione traffico.

MonitorProtocol

Protocollo (HTTP, HTTPS o TCP) usato per eseguire il probe dell'integrità dell'endpoint.

Profile

Classe che rappresenta un profilo di Gestione traffico.

ProfileMonitorStatus

Stato di monitoraggio a livello di profilo del profilo di Gestione traffico.

ProfileStatus

Stato del profilo di Gestione traffico.

Subnets

Elenco di subnet, indirizzi IP e/o intervalli di indirizzi mappati a questo endpoint quando si usa il metodo di routing del traffico "Subnet". Un elenco vuoto corrisponderà a tutti gli intervalli non coperti da altri endpoint.

TrafficRoutingMethod

Metodo di routing del traffico del profilo di Gestione traffico.

TrafficViewEnrollmentStatus

Indica se la visualizzazione traffico è "Abilitata" o "Disabilitata" per il profilo di Gestione traffico. Null, indica 'Disabled'. L'abilitazione di questa funzionalità aumenterà il costo del profilo di gestione traffico.

AllowedEndpointRecordType

Tipi di record DNS di tipo consentiti per questo profilo.

Valore Descrizione
Any
DomainName
IPv4Address
IPv6Address

AlwaysServe

Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.

Valore Descrizione
Disabled
Enabled

CloudError

Errore restituito da Azure Resource Manager

Nome Tipo Descrizione
error

CloudErrorBody

Contenuto dell'errore.

CloudErrorBody

Contenuto di un errore restituito da Azure Resource Manager

Nome Tipo Descrizione
code

string

Codice di errore

details

CloudErrorBody[]

Dettagli errore

message

string

Messaggio di errore

target

string

Destinazione errore

CustomHeaders

Elenco di intestazioni personalizzate.

Nome Tipo Descrizione
name

string

Nome intestazione.

value

string

Valore dell'intestazione.

DnsConfig

Classe contenente le impostazioni DNS in un profilo di Gestione traffico.

Nome Tipo Descrizione
fqdn

string

Nome di dominio completo (FQDN) del profilo di Gestione traffico. Questo formato deriva dalla concatenazione di RelativeName con il dominio DNS usato da Gestione traffico di Azure.

relativeName

string

Nome DNS relativo fornito da questo profilo di Gestione traffico. Questo valore viene combinato con il nome di dominio DNS usato da Gestione traffico di Azure per formare il nome di dominio completo (FQDN) del profilo.

ttl

integer (int64)

Tempo DNS-To-Live (TTL) in secondi. Ciò informa i resolver DNS locali e i client DNS per quanto tempo memorizzare nella cache le risposte DNS fornite da questo profilo di Gestione traffico.

Endpoint

Classe che rappresenta un endpoint di Gestione traffico.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Nome della risorsa

properties.alwaysServe

AlwaysServe

Se Always Serve è abilitato, il probe per l'integrità degli endpoint verrà disabilitato e gli endpoint verranno inclusi nel metodo di routing del traffico.

properties.customHeaders

CustomHeaders[]

Elenco di intestazioni personalizzate.

properties.endpointLocation

string

Specifica il percorso degli endpoint esterni o annidati quando si usa il metodo di routing del traffico "Prestazioni".

properties.endpointMonitorStatus

EndpointMonitorStatus

Stato di monitoraggio dell'endpoint.

properties.endpointStatus

EndpointStatus

Stato dell'endpoint. Se l'endpoint è Abilitato, viene eseguito il probe per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.

properties.geoMapping

string[]

Elenco di paesi/aree mappate a questo endpoint quando si usa il metodo di routing del traffico 'Geografico'. Consultare la documentazione geografica di Gestione traffico per un elenco completo dei valori accettati.

properties.minChildEndpoints

integer (int64)

Numero minimo di endpoint che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.

properties.minChildEndpointsIPv4

integer (int64)

Numero minimo di endpoint IPv4 (tipo di record DNS A) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.

properties.minChildEndpointsIPv6

integer (int64)

Numero minimo di endpoint IPv6 (tipo di record DNS AAAA) che devono essere disponibili nel profilo figlio affinché il profilo padre sia considerato disponibile. Applicabile solo all'endpoint di tipo 'NestedEndpoints'.

properties.priority

integer (int64)

Priorità di questo endpoint quando si usa il metodo di routing del traffico "Priority". I valori possibili sono compresi tra 1 e 1000, i valori inferiori rappresentano una priorità più alta. Questo è un parametro opzionale. Se specificato, deve essere specificato in tutti gli endpoint e nessun endpoint può condividere lo stesso valore di priorità.

properties.subnets

Subnets[]

Elenco di subnet, indirizzi IP e/o intervalli di indirizzi mappati a questo endpoint quando si usa il metodo di routing del traffico "Subnet". Un elenco vuoto corrisponderà a tutti gli intervalli non coperti da altri endpoint.

properties.target

string

Nome DNS completo o indirizzo IP dell'endpoint. Gestione traffico restituisce questo valore nelle risposte DNS per indirizzare il traffico a questo endpoint.

properties.targetResourceId

string

URI della risorsa di Azure dell'endpoint. Non applicabile agli endpoint di tipo 'ExternalEndpoints'.

properties.weight

integer (int64)

Peso di questo endpoint quando si usa il metodo di routing del traffico "Ponderato". I valori possibili sono compresi tra 1 e 1000.

type

string

Tipo della risorsa. Ad esempio Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Stato di monitoraggio dell'endpoint.

Valore Descrizione
CheckingEndpoint
Degraded
Disabled
Inactive
Online
Stopped
Unmonitored

EndpointStatus

Stato dell'endpoint. Se l'endpoint è Abilitato, viene eseguito il probe per l'integrità dell'endpoint e viene incluso nel metodo di routing del traffico.

Valore Descrizione
Disabled
Enabled

ExpectedStatusCodeRanges

Elenco degli intervalli di codici di stato previsti.

Nome Tipo Descrizione
max

integer

Codice di stato massimo.

min

integer

Codice di stato minimo.

MonitorConfig

Classe contenente le impostazioni di monitoraggio degli endpoint in un profilo di Gestione traffico.

Nome Tipo Descrizione
customHeaders

CustomHeaders[]

Elenco di intestazioni personalizzate.

expectedStatusCodeRanges

ExpectedStatusCodeRanges[]

Elenco degli intervalli di codici di stato previsti.

intervalInSeconds

integer (int64)

Intervallo di monitoraggio per gli endpoint in questo profilo. Questo è l'intervallo in cui Gestione traffico verificherà l'integrità di ogni endpoint in questo profilo.

path

string

Percorso relativo al nome di dominio dell'endpoint usato per verificare l'integrità dell'endpoint.

port

integer (int64)

Porta TCP usata per verificare l'integrità dell'endpoint.

profileMonitorStatus

ProfileMonitorStatus

Stato di monitoraggio a livello di profilo del profilo di Gestione traffico.

protocol

MonitorProtocol

Protocollo (HTTP, HTTPS o TCP) usato per eseguire il probe dell'integrità dell'endpoint.

timeoutInSeconds

integer (int64)

Timeout di monitoraggio per gli endpoint in questo profilo. Questo è il momento in cui Gestione traffico consente agli endpoint in questo profilo di rispondere al controllo di integrità.

toleratedNumberOfFailures

integer (int64)

Numero di controlli di integrità consecutivi non riusciti che Gestione traffico tollera prima di dichiarare un endpoint in questo profilo danneggiato dopo il successivo controllo di integrità non riuscito.

MonitorProtocol

Protocollo (HTTP, HTTPS o TCP) usato per eseguire il probe dell'integrità dell'endpoint.

Valore Descrizione
HTTP
HTTPS
TCP

Profile

Classe che rappresenta un profilo di Gestione traffico.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

location

string

Area di Azure in cui si trova la risorsa

name

string

Nome della risorsa

properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

Elenco dei tipi di record di endpoint consentiti.

properties.dnsConfig

DnsConfig

Impostazioni DNS del profilo di Gestione traffico.

properties.endpoints

Endpoint[]

Elenco di endpoint nel profilo di Gestione traffico.

properties.maxReturn

integer (int64)

Numero massimo di endpoint da restituire per il tipo di routing MultiValue.

properties.monitorConfig

MonitorConfig

Impostazioni di monitoraggio degli endpoint del profilo di Gestione traffico.

properties.profileStatus

ProfileStatus

Stato del profilo di Gestione traffico.

properties.trafficRoutingMethod

TrafficRoutingMethod

Metodo di routing del traffico del profilo di Gestione traffico.

properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Indica se la visualizzazione traffico è "Abilitata" o "Disabilitata" per il profilo di Gestione traffico. Null, indica 'Disabled'. L'abilitazione di questa funzionalità aumenterà il costo del profilo di gestione traffico.

tags

object

Tag di risorsa.

type

string

Tipo della risorsa. Ad esempio Microsoft.Network/trafficManagerProfiles.

ProfileMonitorStatus

Stato di monitoraggio a livello di profilo del profilo di Gestione traffico.

Valore Descrizione
CheckingEndpoints
Degraded
Disabled
Inactive
Online

ProfileStatus

Stato del profilo di Gestione traffico.

Valore Descrizione
Disabled
Enabled

Subnets

Elenco di subnet, indirizzi IP e/o intervalli di indirizzi mappati a questo endpoint quando si usa il metodo di routing del traffico "Subnet". Un elenco vuoto corrisponderà a tutti gli intervalli non coperti da altri endpoint.

Nome Tipo Descrizione
first

string

Primo indirizzo nella subnet.

last

string

Ultimo indirizzo nella subnet.

scope

integer

Dimensioni del blocco (numero di bit iniziali nella subnet mask).

TrafficRoutingMethod

Metodo di routing del traffico del profilo di Gestione traffico.

Valore Descrizione
Geographic
MultiValue
Performance
Priority
Subnet
Weighted

TrafficViewEnrollmentStatus

Indica se la visualizzazione traffico è "Abilitata" o "Disabilitata" per il profilo di Gestione traffico. Null, indica 'Disabled'. L'abilitazione di questa funzionalità aumenterà il costo del profilo di gestione traffico.

Valore Descrizione
Disabled
Enabled