Delen via


Profiles - List By Resource Group

Lijsten alle Traffic Manager-profielen binnen een resourcegroep.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

subscriptionId
path True

string

Hiermee haalt u abonnementsreferenties op waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

ProfileListResult

De lijst met Traffic Manager-profielen.

Other Status Codes

CloudError

Standaardantwoord. Het wordt gedeserialiseerd volgens de foutdefinitie.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

ListProfilesByResourceGroup

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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"
            }
          }
        ]
      }
    }
  ]
}

Definities

Name Description
AllowedEndpointRecordType

Het toegestane type DNS-recordtypen voor dit profiel.

AlwaysServe

Als Altijd serveren is ingeschakeld, wordt het testen op de eindpuntstatus uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

CloudError

Een fout die is geretourneerd door de Azure-Resource Manager

CloudErrorBody

De inhoud van een fout die wordt geretourneerd door de Azure-Resource Manager

CustomHeaders

Lijst met aangepaste headers.

DnsConfig

Klasse met DNS-instellingen in een Traffic Manager-profiel.

Endpoint

Klasse die een Traffic Manager-eindpunt vertegenwoordigt.

EndpointMonitorStatus

De bewakingsstatus van het eindpunt.

EndpointStatus

De status van het eindpunt. Als het eindpunt is ingeschakeld, wordt het gecontroleerd op de eindpuntstatus en opgenomen in de verkeersrouteringsmethode.

ExpectedStatusCodeRanges

Lijst met verwachte statuscodebereiken.

MonitorConfig

Klasse met instellingen voor eindpuntbewaking in een Traffic Manager-profiel.

MonitorProtocol

Het protocol (HTTP, HTTPS of TCP) dat wordt gebruikt om de status van het eindpunt te controleren.

Profile

Klasse die een Traffic Manager-profiel vertegenwoordigt.

ProfileListResult

Het bewerkingsantwoord voor Traffic Manager-profielen in de lijst.

ProfileMonitorStatus

De bewakingsstatus op profielniveau van het Traffic Manager-profiel.

ProfileStatus

De status van het Traffic Manager-profiel.

Subnets

De lijst met subnetten, IP-adressen en/of adresbereiken die aan dit eindpunt zijn toegewezen bij gebruik van de verkeersrouteringsmethode 'Subnet'. Een lege lijst komt overeen met alle bereiken die niet door andere eindpunten worden gedekt.

TrafficRoutingMethod

De verkeersrouteringsmethode van het Traffic Manager-profiel.

TrafficViewEnrollmentStatus

Geeft aan of de verkeersweergave is ingeschakeld of uitgeschakeld voor het Traffic Manager-profiel. Null, geeft 'Uitgeschakeld' aan. Als u deze functie inschakelt, worden de kosten van het profiel Traffic Manage verhoogd.

AllowedEndpointRecordType

Het toegestane type DNS-recordtypen voor dit profiel.

Name Type Description
Any

string

DomainName

string

IPv4Address

string

IPv6Address

string

AlwaysServe

Als Altijd serveren is ingeschakeld, wordt het testen op de eindpuntstatus uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

Name Type Description
Disabled

string

Enabled

string

CloudError

Een fout die is geretourneerd door de Azure-Resource Manager

Name Type Description
error

CloudErrorBody

De inhoud van de fout.

CloudErrorBody

De inhoud van een fout die wordt geretourneerd door de Azure-Resource Manager

Name Type Description
code

string

Foutcode

details

CloudErrorBody[]

Foutdetails

message

string

Foutbericht

target

string

Foutdoel

CustomHeaders

Lijst met aangepaste headers.

Name Type Description
name

string

Koptekstnaam.

value

string

Headerwaarde.

DnsConfig

Klasse met DNS-instellingen in een Traffic Manager-profiel.

Name Type Description
fqdn

string

De FQDN (Fully Qualified Domain Name) van het Traffic Manager-profiel. Dit wordt gevormd door de samenvoeging van de RelativeName met het DNS-domein dat wordt gebruikt door Azure Traffic Manager.

relativeName

string

De relatieve DNS-naam die door dit Traffic Manager-profiel wordt opgegeven. Deze waarde wordt gecombineerd met de DNS-domeinnaam die door Azure Traffic Manager wordt gebruikt om de FQDN (Fully Qualified Domain Name) van het profiel te vormen.

ttl

integer

De DNS Time To Live (TTL), in seconden. Hiermee worden de lokale DNS-resolvers en DNS-clients geïnformeerd over hoe lang DNS-antwoorden van dit Traffic Manager-profiel in de cache moeten worden opgeslagen.

Endpoint

Klasse die een Traffic Manager-eindpunt vertegenwoordigt.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

De naam van de resource

properties.alwaysServe

AlwaysServe

Als Altijd serveren is ingeschakeld, wordt het testen op de eindpuntstatus uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

properties.customHeaders

CustomHeaders[]

Lijst met aangepaste headers.

properties.endpointLocation

string

Hiermee geeft u de locatie van de externe of geneste eindpunten bij gebruik van de verkeersrouteringsmethode 'Prestaties'.

properties.endpointMonitorStatus

EndpointMonitorStatus

De bewakingsstatus van het eindpunt.

properties.endpointStatus

EndpointStatus

De status van het eindpunt. Als het eindpunt is ingeschakeld, wordt het gecontroleerd op de eindpuntstatus en opgenomen in de verkeersrouteringsmethode.

properties.geoMapping

string[]

De lijst met landen/regio's die aan dit eindpunt zijn toegewezen bij gebruik van de methode geografische verkeersroutering. Raadpleeg de geografische documentatie van Traffic Manager voor een volledige lijst met geaccepteerde waarden.

properties.minChildEndpoints

integer

Het minimale aantal eindpunten dat beschikbaar moet zijn in het onderliggende profiel om het bovenliggende profiel als beschikbaar te kunnen beschouwen. Alleen van toepassing op eindpunt van het type NestedEndpoints.

properties.minChildEndpointsIPv4

integer

Het minimale aantal IPv4-eindpunten (DNS-recordtype A) dat beschikbaar moet zijn in het onderliggende profiel om het bovenliggende profiel als beschikbaar te kunnen beschouwen. Alleen van toepassing op eindpunt van het type NestedEndpoints.

properties.minChildEndpointsIPv6

integer

Het minimum aantal IPv6-eindpunten (DNS-recordtype AAAA) dat beschikbaar moet zijn in het onderliggende profiel om het bovenliggende profiel als beschikbaar te kunnen beschouwen. Alleen van toepassing op eindpunt van het type NestedEndpoints.

properties.priority

integer

De prioriteit van dit eindpunt bij het gebruik van de verkeersrouteringsmethode 'Prioriteit'. Mogelijke waarden liggen tussen 1 en 1000, lagere waarden staan voor een hogere prioriteit. Dit is een optionele parameter. Indien opgegeven, moet deze worden opgegeven op alle eindpunten en kunnen geen twee eindpunten dezelfde prioriteitswaarde delen.

properties.subnets

Subnets[]

De lijst met subnetten, IP-adressen en/of adresbereiken die aan dit eindpunt zijn toegewezen bij gebruik van de verkeersrouteringsmethode 'Subnet'. Een lege lijst komt overeen met alle bereiken die niet door andere eindpunten worden gedekt.

properties.target

string

De volledig gekwalificeerde DNS-naam of het IP-adres van het eindpunt. Traffic Manager retourneert deze waarde in DNS-antwoorden om verkeer naar dit eindpunt te leiden.

properties.targetResourceId

string

De Azure-resource-URI van het eindpunt. Niet van toepassing op eindpunten van het type ExternalEndpoints.

properties.weight

integer

Het gewicht van dit eindpunt bij gebruik van de verkeersrouteringsmethode 'Gewogen'. Mogelijke waarden liggen tussen 1 en 1000.

type

string

Het type resource. Bijvoorbeeld Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

De bewakingsstatus van het eindpunt.

Name Type Description
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

De status van het eindpunt. Als het eindpunt is ingeschakeld, wordt het gecontroleerd op de eindpuntstatus en opgenomen in de verkeersrouteringsmethode.

Name Type Description
Disabled

string

Enabled

string

ExpectedStatusCodeRanges

Lijst met verwachte statuscodebereiken.

Name Type Description
max

integer

Maximale statuscode.

min

integer

Minimale statuscode.

MonitorConfig

Klasse met instellingen voor eindpuntbewaking in een Traffic Manager-profiel.

Name Type Description
customHeaders

CustomHeaders[]

Lijst met aangepaste headers.

expectedStatusCodeRanges

ExpectedStatusCodeRanges[]

Lijst met verwachte statuscodebereiken.

intervalInSeconds

integer

Het bewakingsinterval voor eindpunten in dit profiel. Dit is het interval waarmee Traffic Manager de status van elk eindpunt in dit profiel controleert.

path

string

Het pad ten opzichte van de naam van het eindpuntdomein dat wordt gebruikt om de status van het eindpunt te controleren.

port

integer

De TCP-poort die wordt gebruikt om te testen op de status van het eindpunt.

profileMonitorStatus

ProfileMonitorStatus

De bewakingsstatus op profielniveau van het Traffic Manager-profiel.

protocol

MonitorProtocol

Het protocol (HTTP, HTTPS of TCP) dat wordt gebruikt om de status van het eindpunt te controleren.

timeoutInSeconds

integer

De time-out van de controle voor eindpunten in dit profiel. Dit is het tijdstip waarop Traffic Manager eindpunten in dit profiel toestaat om te reageren op de statuscontrole.

toleratedNumberOfFailures

integer

Het aantal opeenvolgende mislukte statuscontroles dat Traffic Manager tolereert voordat een eindpunt in dit profiel wordt gedegradeerd na de volgende mislukte statuscontrole.

MonitorProtocol

Het protocol (HTTP, HTTPS of TCP) dat wordt gebruikt om de status van het eindpunt te controleren.

Name Type Description
HTTP

string

HTTPS

string

TCP

string

Profile

Klasse die een Traffic Manager-profiel vertegenwoordigt.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

location

string

De Azure-regio waar de resource zich bevindt

name

string

De naam van de resource

properties.allowedEndpointRecordTypes

AllowedEndpointRecordType[]

De lijst met toegestane eindpuntrecordtypen.

properties.dnsConfig

DnsConfig

De DNS-instellingen van het Traffic Manager-profiel.

properties.endpoints

Endpoint[]

De lijst met eindpunten in het Traffic Manager-profiel.

properties.maxReturn

integer

Maximum aantal eindpunten dat moet worden geretourneerd voor het routeringstype Meerdere waarden.

properties.monitorConfig

MonitorConfig

De instellingen voor eindpuntbewaking van het Traffic Manager-profiel.

properties.profileStatus

ProfileStatus

De status van het Traffic Manager-profiel.

properties.trafficRoutingMethod

TrafficRoutingMethod

De verkeersrouteringsmethode van het Traffic Manager-profiel.

properties.trafficViewEnrollmentStatus

TrafficViewEnrollmentStatus

Geeft aan of de verkeersweergave is ingeschakeld of uitgeschakeld voor het Traffic Manager-profiel. Null, geeft 'Uitgeschakeld' aan. Als u deze functie inschakelt, worden de kosten van het profiel Traffic Manage verhoogd.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld Microsoft.Network/trafficManagerProfiles.

ProfileListResult

Het bewerkingsantwoord voor Traffic Manager-profielen in de lijst.

Name Type Description
value

Profile[]

Hiermee haalt u de lijst met Traffic Manager-profielen op.

ProfileMonitorStatus

De bewakingsstatus op profielniveau van het Traffic Manager-profiel.

Name Type Description
CheckingEndpoints

string

Degraded

string

Disabled

string

Inactive

string

Online

string

ProfileStatus

De status van het Traffic Manager-profiel.

Name Type Description
Disabled

string

Enabled

string

Subnets

De lijst met subnetten, IP-adressen en/of adresbereiken die aan dit eindpunt zijn toegewezen bij gebruik van de verkeersrouteringsmethode 'Subnet'. Een lege lijst komt overeen met alle bereiken die niet door andere eindpunten worden gedekt.

Name Type Description
first

string

Eerste adres in het subnet.

last

string

Laatste adres in het subnet.

scope

integer

Blokgrootte (aantal voorloopbits in het subnetmasker).

TrafficRoutingMethod

De verkeersrouteringsmethode van het Traffic Manager-profiel.

Name Type Description
Geographic

string

MultiValue

string

Performance

string

Priority

string

Subnet

string

Weighted

string

TrafficViewEnrollmentStatus

Geeft aan of de verkeersweergave is ingeschakeld of uitgeschakeld voor het Traffic Manager-profiel. Null, geeft 'Uitgeschakeld' aan. Als u deze functie inschakelt, worden de kosten van het profiel Traffic Manage verhoogd.

Name Type Description
Disabled

string

Enabled

string