Sdílet prostřednictvím


Profiles - List By Subscription

Seznamy všechny profily Traffic Manageru v rámci předplatného.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
subscriptionId
path True

string

Získá přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby.

api-version
query True

string

Verze rozhraní API klienta.

Odpovědi

Name Typ Description
200 OK

ProfileListResult

Seznam profilů Traffic Manageru.

Other Status Codes

CloudError

Výchozí odpověď Bude deserializován podle definice chyby.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

ListBySubscription

Ukázkový požadavek

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

Ukázková odpověď

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/azsmnet1719/providers/Microsoft.Network/trafficManagerProfiles/azsmnet5183",
      "name": "azsmnet5183",
      "type": "Microsoft.Network/trafficManagerProfiles",
      "location": "global",
      "tags": {},
      "properties": {
        "profileStatus": "Enabled",
        "trafficRoutingMethod": "Performance",
        "dnsConfig": {
          "relativeName": "azsmnet4696",
          "fqdn": "azsmnet4696.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/azuresdkfornetautoresttrafficmanager5168/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3440",
      "name": "azuresdkfornetautoresttrafficmanager3440",
      "type": "Microsoft.Network/trafficManagerProfiles",
      "location": "global",
      "tags": {},
      "properties": {
        "profileStatus": "Enabled",
        "trafficRoutingMethod": "Performance",
        "dnsConfig": {
          "relativeName": "azuresdkfornetautoresttrafficmanager3440",
          "fqdn": "azuresdkfornetautoresttrafficmanager3440.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/azuresdkfornetautoresttrafficmanager5168/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager3440/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"
            }
          }
        ]
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/onesdk9785/providers/Microsoft.Network/trafficManagerProfiles/onesdk8819",
      "name": "onesdk8819",
      "type": "Microsoft.Network/trafficManagerProfiles",
      "location": "global",
      "tags": {},
      "properties": {
        "profileStatus": "Enabled",
        "trafficRoutingMethod": "Performance",
        "dnsConfig": {
          "relativeName": "onesdk7242",
          "fqdn": "onesdk7242.tmpreview.watmtest.azure-test.net",
          "ttl": 51
        },
        "monitorConfig": {
          "profileMonitorStatus": "Online",
          "protocol": "HTTPS",
          "port": 111,
          "path": "/testparent.asp",
          "intervalInSeconds": 30,
          "toleratedNumberOfFailures": 3,
          "timeoutInSeconds": 10
        },
        "endpoints": [
          {
            "id": "/subscriptions/{subscription-id}/resourceGroups/onesdk9785/providers/Microsoft.Network/trafficManagerProfiles/onesdk8819/nestedEndpoints/MyNestedEndpoint",
            "name": "MyNestedEndpoint",
            "type": "Microsoft.Network/trafficManagerProfiles/nestedEndpoints",
            "properties": {
              "endpointStatus": "Enabled",
              "endpointMonitorStatus": "Stopped",
              "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/onesdk9785/providers/Microsoft.Network/trafficManagerProfiles/onesdk1792",
              "target": "onesdk4285.tmpreview.watmtest.azure-test.net",
              "weight": 1,
              "priority": 1,
              "endpointLocation": "West Europe",
              "minChildEndpoints": 1
            }
          }
        ]
      }
    }
  ]
}

Definice

Name Description
AllowedEndpointRecordType

Povolené typy záznamů DNS pro tento profil.

AlwaysServe

Pokud je povolená funkce Always Serve, bude testování stavu koncového bodu zakázané a koncové body budou zahrnuty do metody směrování provozu.

CloudError

Chyba vrácená službou Azure Resource Manager

CloudErrorBody

Obsah chyby vrácené službou Azure Resource Manager

CustomHeaders

Seznam vlastních hlaviček

DnsConfig

Třída obsahující nastavení DNS v profilu služby Traffic Manager.

Endpoint

Třída představující koncový bod Traffic Manageru.

EndpointMonitorStatus

Stav monitorování koncového bodu.

EndpointStatus

Stav koncového bodu. Pokud je koncový bod povolený, dotazuje se na stav koncového bodu a je zahrnutý v metodě směrování provozu.

ExpectedStatusCodeRanges

Seznam očekávaných rozsahů stavových kódů

MonitorConfig

Třída obsahující nastavení monitorování koncového bodu v profilu služby Traffic Manager.

MonitorProtocol

Protokol (HTTP, HTTPS nebo TCP) používaný k testování stavu koncového bodu.

Profile

Třída představující profil služby Traffic Manager.

ProfileListResult

Seznam odezvy operace profilů Služby Traffic Manager.

ProfileMonitorStatus

Stav monitorování na úrovni profilu služby Traffic Manager.

ProfileStatus

Stav profilu služby Traffic Manager.

Subnets

Seznam podsítí, IP adres nebo rozsahů adres mapovaných na tento koncový bod při použití metody směrování provozu Subnet. Prázdný seznam bude odpovídat všem rozsahům, které ostatní koncové body nepokrývala.

TrafficRoutingMethod

Metoda směrování provozu profilu služby Traffic Manager.

TrafficViewEnrollmentStatus

Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu.

AllowedEndpointRecordType

Povolené typy záznamů DNS pro tento profil.

Name Typ Description
Any

string

DomainName

string

IPv4Address

string

IPv6Address

string

AlwaysServe

Pokud je povolená funkce Always Serve, bude testování stavu koncového bodu zakázané a koncové body budou zahrnuty do metody směrování provozu.

Name Typ Description
Disabled

string

Enabled

string

CloudError

Chyba vrácená službou Azure Resource Manager

Name Typ Description
error

CloudErrorBody

Obsah chyby.

CloudErrorBody

Obsah chyby vrácené službou Azure Resource Manager

Name Typ Description
code

string

Kód chyby

details

CloudErrorBody[]

Podrobnosti o chybě

message

string

Chybová zpráva

target

string

Cíl chyby

CustomHeaders

Seznam vlastních hlaviček

Name Typ Description
name

string

Název hlavičky.

value

string

Hodnota hlavičky.

DnsConfig

Třída obsahující nastavení DNS v profilu služby Traffic Manager.

Name Typ Description
fqdn

string

Plně kvalifikovaný název domény (FQDN) profilu traffic manageru. Vytvoří se zřetězením RelativeName s doménou DNS, kterou používá Azure Traffic Manager.

relativeName

string

Relativní název DNS zadaný tímto profilem služby Traffic Manager. Tato hodnota se zkombinuje s názvem domény DNS, který azure Traffic Manager používá k vytvoření plně kvalifikovaného názvu domény (FQDN) profilu.

ttl

integer

Hodnota TTL (Time to Live) DNS v sekundách. To informuje místní překladače DNS a klienty DNS, jak dlouho mají ukládat odpovědi DNS poskytnuté tímto profilem služby Traffic Manager do mezipaměti.

Endpoint

Třída představující koncový bod Traffic Manageru.

Name Typ Description
id

string

Plně kvalifikované ID prostředku. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Název prostředku

properties.alwaysServe

AlwaysServe

Pokud je povolená funkce Always Serve, bude testování stavu koncového bodu zakázáno a koncové body budou zahrnuty do metody směrování provozu.

properties.customHeaders

CustomHeaders[]

Seznam vlastních hlaviček

properties.endpointLocation

string

Určuje umístění externích nebo vnořených koncových bodů při použití metody směrování provozu Performance.

properties.endpointMonitorStatus

EndpointMonitorStatus

Stav monitorování koncového bodu.

properties.endpointStatus

EndpointStatus

Stav koncového bodu. Pokud je koncový bod povolený, dotazuje se na stav koncového bodu a je zahrnutý v metodě směrování provozu.

properties.geoMapping

string[]

Seznam zemí nebo oblastí namapovaných na tento koncový bod při použití metody geografického směrování provozu Úplný seznam přijatých hodnot najdete v geografické dokumentaci traffic manageru.

properties.minChildEndpoints

integer

Minimální počet koncových bodů, které musí být dostupné v podřízeného profilu, aby se nadřazený profil považoval za dostupný. Platí jenom pro koncový bod typu NestedEndpoints.

properties.minChildEndpointsIPv4

integer

Minimální počet koncových bodů IPv4 (záznam DNS typu A), které musí být dostupné v podřízeného profilu, aby se nadřazený profil považoval za dostupný. Platí jenom pro koncový bod typu NestedEndpoints.

properties.minChildEndpointsIPv6

integer

Minimální počet koncových bodů IPv6 (typ záznamu DNS AAAA), které musí být dostupné v podřízeného profilu, aby bylo možné nadřazený profil považovat za dostupný. Platí jenom pro koncový bod typu NestedEndpoints.

properties.priority

integer

Priorita tohoto koncového bodu při použití metody směrování provozu Priority Možné hodnoty jsou od 1 do 1000, nižší hodnoty představují vyšší prioritu. Jedná se o volitelný parametr. Pokud je zadaný, musí být zadaný na všech koncových bodech a žádné dva koncové body nemůžou sdílet stejnou hodnotu priority.

properties.subnets

Subnets[]

Seznam podsítí, IP adres nebo rozsahů adres mapovaných na tento koncový bod při použití metody směrování provozu Subnet. Prázdný seznam bude odpovídat všem rozsahům, které ostatní koncové body nepokrývala.

properties.target

string

Plně kvalifikovaný název DNS nebo IP adresa koncového bodu. Traffic Manager vrátí tuto hodnotu v odpovědích DNS pro směrování provozu do tohoto koncového bodu.

properties.targetResourceId

string

Identifikátor URI prostředku Azure koncového bodu. Nevztahuje se na koncové body typu ExternalEndpoints.

properties.weight

integer

Váha tohoto koncového bodu při použití metody směrování váženého provozu Možné hodnoty jsou od 1 do 1000.

type

string

Typ prostředku. Příklad: Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Stav monitorování koncového bodu.

Name Typ Description
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

Stav koncového bodu. Pokud je koncový bod povolený, dotazuje se na stav koncového bodu a je zahrnutý v metodě směrování provozu.

Name Typ Description
Disabled

string

Enabled

string

ExpectedStatusCodeRanges

Seznam očekávaných rozsahů stavových kódů

Name Typ Description
max

integer

Maximální stavový kód.

min

integer

Minimální stavový kód.

MonitorConfig

Třída obsahující nastavení monitorování koncového bodu v profilu služby Traffic Manager.

Name Typ Description
customHeaders

CustomHeaders[]

Seznam vlastních hlaviček

expectedStatusCodeRanges

ExpectedStatusCodeRanges[]

Seznam očekávaných rozsahů stavových kódů

intervalInSeconds

integer

Interval monitorování pro koncové body v tomto profilu. Jedná se o interval, ve kterém Traffic Manager zkontroluje stav jednotlivých koncových bodů v tomto profilu.

path

string

Cesta relativní k názvu domény koncového bodu, která se používá k sondování stavu koncového bodu.

port

integer

Port TCP použitý k sondování stavu koncového bodu.

profileMonitorStatus

ProfileMonitorStatus

Stav monitorování na úrovni profilu služby Traffic Manager.

protocol

MonitorProtocol

Protokol (HTTP, HTTPS nebo TCP) používaný k testování stavu koncového bodu.

timeoutInSeconds

integer

Časový limit monitorování pro koncové body v tomto profilu. To je čas, kdy Traffic Manager umožňuje koncovým bodům v tomto profilu reagovat na kontrolu stavu.

toleratedNumberOfFailures

integer

Počet po sobě jdoucích neúspěšných kontrol stavu, které Traffic Manager toleruje před deklarováním koncového bodu v tomto profilu, snížený po další neúspěšné kontrole stavu.

MonitorProtocol

Protokol (HTTP, HTTPS nebo TCP) používaný k testování stavu koncového bodu.

Name Typ Description
HTTP

string

HTTPS

string

TCP

string

Profile

Třída představující profil služby Traffic Manager.

Name Typ Description
id

string

Plně kvalifikované ID prostředku. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

location

string

Oblast Azure, ve které se prostředek nachází

name

string

Název prostředku

properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

Seznam povolených typů záznamů koncového bodu

properties.dnsConfig

DnsConfig

Nastavení DNS profilu služby Traffic Manager.

properties.endpoints

Endpoint[]

Seznam koncových bodů v profilu Služby Traffic Manager.

properties.maxReturn

integer

Maximální počet koncových bodů, které se mají vrátit pro typ směrování MultiValue.

properties.monitorConfig

MonitorConfig

Nastavení monitorování koncového bodu profilu služby Traffic Manager.

properties.profileStatus

ProfileStatus

Stav profilu služby Traffic Manager.

properties.trafficRoutingMethod

TrafficRoutingMethod

Metoda směrování provozu profilu služby Traffic Manager.

properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu.

tags

object

Značky prostředků.

type

string

Typ prostředku. Příklad: Microsoft.Network/trafficManagerProfiles.

ProfileListResult

Seznam odezvy operace profilů Služby Traffic Manager.

Name Typ Description
value

Profile[]

Získá seznam profilů Traffic Manageru.

ProfileMonitorStatus

Stav monitorování na úrovni profilu služby Traffic Manager.

Name Typ Description
CheckingEndpoints

string

Degraded

string

Disabled

string

Inactive

string

Online

string

ProfileStatus

Stav profilu služby Traffic Manager.

Name Typ Description
Disabled

string

Enabled

string

Subnets

Seznam podsítí, IP adres nebo rozsahů adres mapovaných na tento koncový bod při použití metody směrování provozu Subnet. Prázdný seznam bude odpovídat všem rozsahům, které ostatní koncové body nepokrývala.

Name Typ Description
first

string

První adresa v podsíti.

last

string

Poslední adresa v podsíti.

scope

integer

Velikost bloku (počet počátečních bitů v masce podsítě)

TrafficRoutingMethod

Metoda směrování provozu profilu služby Traffic Manager.

Name Typ Description
Geographic

string

MultiValue

string

Performance

string

Priority

string

Subnet

string

Weighted

string

TrafficViewEnrollmentStatus

Určuje, jestli je zobrazení provozu pro profil služby Traffic Manager povoleno nebo zakázáno. Null, označuje Zakázáno. Povolením této funkce se zvýší náklady na profil Správy provozu.

Name Typ Description
Disabled

string

Enabled

string