Delen via


Endpoints - Get

Hiermee haalt u een Traffic Manager-eindpunt op.

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

URI-parameters

Name In Vereist Type Description
endpointName
path True

string

De naam van het Traffic Manager-eindpunt.

endpointType
path True

EndpointType

Het type van het Traffic Manager-eindpunt.

profileName
path True

string

De naam van het Traffic Manager-profiel.

resourceGroupName
path True

string

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

subscriptionId
path True

string

Hiermee worden abonnementsreferenties opgehaald 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

Endpoint

Het Traffic Manager-eindpunt.

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

Endpoint-GET-External-WithGeoMapping
Endpoint-GET-External-WithLocation
Endpoint-GET-External-WithSubnetMapping

Endpoint-GET-External-WithGeoMapping

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager8224/ExternalEndpoints/My%20external%20endpoint?api-version=2022-04-01

Voorbeeldrespons

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager8224/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,
    "geoMapping": [
      "GEO-AS",
      "GEO-AF"
    ]
  }
}

Endpoint-GET-External-WithLocation

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "name": "azsmnet7187",
  "type": "Microsoft.Network/trafficManagerProfiles/externalEndpoints",
  "properties": {
    "endpointStatus": "Enabled",
    "endpointMonitorStatus": "CheckingEndpoint",
    "target": "foobar.contoso.com",
    "weight": 1,
    "priority": 1,
    "endpointLocation": "North Europe"
  }
}

Endpoint-GET-External-WithSubnetMapping

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficmanagerprofiles/azuresdkfornetautoresttrafficmanager8224/ExternalEndpoints/My%20external%20endpoint?api-version=2022-04-01

Voorbeeldrespons

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager2191/providers/Microsoft.Network/trafficManagerProfiles/azuresdkfornetautoresttrafficmanager8224/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,
    "subnets": [
      {
        "first": "1.2.3.0",
        "scope": 24
      },
      {
        "first": "25.26.27.28",
        "last": "29.30.31.32"
      }
    ]
  }
}

Definities

Name Description
AlwaysServe

Als Always Serve is ingeschakeld, wordt het testen op de status van het eindpunt uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

CloudError

Een fout die wordt geretourneerd door de Azure Resource Manager

CloudErrorBody

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

CustomHeaders

Lijst met aangepaste kopteksten.

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 status van het eindpunt en opgenomen in de verkeersrouteringsmethode.

EndpointType

Het type van het Traffic Manager-eindpunt.

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.

AlwaysServe

Als Always Serve is ingeschakeld, wordt het testen op de status van het eindpunt uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

Name Type Description
Disabled

string

Enabled

string

CloudError

Een fout die wordt geretourneerd door de Azure Resource Manager

Name Type Description
error

CloudErrorBody

De inhoud van de fout.

CloudErrorBody

De inhoud van een fout die is 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 kopteksten.

Name Type Description
name

string

Koptekstnaam.

value

string

Headerwaarde.

Endpoint

Klasse die een Traffic Manager-eindpunt vertegenwoordigt.

Name Type Description
id

string

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

name

string

De naam van de resource

properties.alwaysServe

AlwaysServe

Als Always Serve is ingeschakeld, wordt het testen op de status van het eindpunt uitgeschakeld en worden eindpunten opgenomen in de verkeersrouteringsmethode.

properties.customHeaders

CustomHeaders[]

Lijst met aangepaste kopteksten.

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 status van het eindpunt en opgenomen in de verkeersrouteringsmethode.

properties.geoMapping

string[]

De lijst met landen/regio's die aan dit eindpunt zijn toegewezen bij gebruik van de verkeersrouteringsmethode 'Geografisch'. Raadpleeg de documentatie van Traffic Manager Geographic 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 minimale 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 gebruik van de verkeersrouteringsmethode Priority. Mogelijke waarden liggen tussen 1 en 1000, lagere waarden vertegenwoordigen een hogere prioriteit. Dit is een optionele parameter. Indien opgegeven, moet deze worden opgegeven voor 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. Ex- 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 status van het eindpunt en opgenomen in de verkeersrouteringsmethode.

Name Type Description
Disabled

string

Enabled

string

EndpointType

Het type van het Traffic Manager-eindpunt.

Name Type Description
AzureEndpoints

string

ExternalEndpoints

string

NestedEndpoints

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