Delen via


Endpoints - Create Or Update

Een Traffic Manager-eindpunt maken of bijwerken.

PUT 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 dat moet worden gemaakt of bijgewerkt.

endpointType
path True

EndpointType

Het type traffic manager-eindpunt dat moet worden gemaakt of bijgewerkt.

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

Aanvraagbody

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.

Antwoorden

Name Type Description
200 OK

Endpoint

Het gemaakte of bijgewerkte eindpunt.

201 Created

Endpoint

Het gemaakte of bijgewerkte 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-PUT-External-WithAlwaysServe
Endpoint-PUT-External-WithCustomHeaders
Endpoint-PUT-External-WithGeoMapping
Endpoint-PUT-External-WithLocation
Endpoint-PUT-External-WithSubnetMapping

Endpoint-PUT-External-WithAlwaysServe

Voorbeeldaanvraag

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

{
  "name": "azsmnet7187",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "endpointLocation": "North Europe",
    "alwaysServe": "Enabled"
  }
}

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",
    "alwaysServe": "Enabled"
  }
}
{
  "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",
    "alwaysServe": "Enabled"
  }
}

Endpoint-PUT-External-WithCustomHeaders

Voorbeeldaanvraag

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

{
  "name": "azsmnet7187",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "endpointLocation": "North Europe",
    "customHeaders": [
      {
        "name": "header-1",
        "value": "value-1"
      },
      {
        "name": "header-2",
        "value": "value-2"
      }
    ]
  }
}

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",
    "customHeaders": [
      {
        "name": "header-1",
        "value": "value-1"
      },
      {
        "name": "header-2",
        "value": "value-2"
      }
    ]
  }
}
{
  "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",
    "customHeaders": [
      {
        "name": "header-1",
        "value": "value-1"
      },
      {
        "name": "header-2",
        "value": "value-2"
      }
    ]
  }
}

Endpoint-PUT-External-WithGeoMapping

Voorbeeldaanvraag

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

{
  "name": "My external endpoint",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "geoMapping": [
      "GEO-AS",
      "GEO-AF"
    ]
  }
}

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

Voorbeeldaanvraag

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

{
  "name": "azsmnet7187",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "endpointLocation": "North Europe"
  }
}

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"
  }
}
{
  "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-PUT-External-WithSubnetMapping

Voorbeeldaanvraag

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

{
  "name": "My external endpoint",
  "type": "Microsoft.network/TrafficManagerProfiles/ExternalEndpoints",
  "properties": {
    "target": "foobar.contoso.com",
    "endpointStatus": "Enabled",
    "subnets": [
      {
        "first": "1.2.3.0",
        "scope": 24
      },
      {
        "first": "25.26.27.28",
        "last": "29.30.31.32"
      }
    ]
  }
}

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

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.

EndpointType

Het type traffic manager-eindpunt dat moet worden gemaakt of bijgewerkt.

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

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

EndpointType

Het type traffic manager-eindpunt dat moet worden gemaakt of bijgewerkt.

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