Dela via


Endpoints - Create Or Update

Skapa eller uppdatera en Traffic Manager-slutpunkt.

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

URI-parametrar

Name I Obligatorisk Typ Description
endpointName
path True

string

Namnet på den Traffic Manager-slutpunkt som ska skapas eller uppdateras.

endpointType
path True

EndpointType

Typen av Traffic Manager-slutpunkt som ska skapas eller uppdateras.

profileName
path True

string

Namnet på Traffic Manager-profilen.

resourceGroupName
path True

string

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

Hämtar autentiseringsuppgifter för prenumerationen som unikt identifierar Microsoft Azure-prenumerationen. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

api-version
query True

string

Klient-API-version.

Begärandetext

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Namnet på resursen

properties.alwaysServe

AlwaysServe

Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden.

properties.customHeaders

CustomHeaders[]

Lista över anpassade rubriker.

properties.endpointLocation

string

Anger platsen för de externa eller kapslade slutpunkterna när du använder trafikroutningsmetoden Prestanda.

properties.endpointMonitorStatus

EndpointMonitorStatus

Slutpunktens övervakningsstatus.

properties.endpointStatus

EndpointStatus

Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden.

properties.geoMapping

string[]

Listan över länder/regioner som mappas till den här slutpunkten när du använder trafikroutningsmetoden Geografisk. En fullständig lista över godkända värden finns i Traffic Manager Geographic-dokumentationen.

properties.minChildEndpoints

integer

Det minsta antalet slutpunkter som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

properties.minChildEndpointsIPv4

integer

Det minsta antalet IPv4-slutpunkter (DNS-posttyp A) som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

properties.minChildEndpointsIPv6

integer

Det minsta antalet IPv6-slutpunkter (DNS-posttyp AAAA) som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

properties.priority

integer

Prioriteten för den här slutpunkten när du använder trafikroutningsmetoden Prioritet. Möjliga värden är från 1 till 1 000, lägre värden representerar högre prioritet. Det här är en valfri parameter. Om den anges måste den anges på alla slutpunkter och inga två slutpunkter kan dela samma prioritetsvärde.

properties.subnets

Subnets[]

Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter.

properties.target

string

Slutpunktens fullständigt kvalificerade DNS-namn eller IP-adress. Traffic Manager returnerar det här värdet i DNS-svar för att dirigera trafik till den här slutpunkten.

properties.targetResourceId

string

Azure-resursens URI för slutpunkten. Gäller inte för slutpunkter av typen ExternalEndpoints.

properties.weight

integer

Vikten för den här slutpunkten när du använder trafikroutningsmetoden Viktad. Möjliga värden är från 1 till 1 000.

type

string

Resurstypen. Ex- Microsoft.Network/trafficManagerProfiles.

Svar

Name Typ Description
200 OK

Endpoint

Den skapade eller uppdaterade slutpunkten.

201 Created

Endpoint

Den skapade eller uppdaterade slutpunkten.

Other Status Codes

CloudError

Standardsvar. Den kommer att deserialiseras enligt feldefinitionen.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Endpoint-PUT-External-WithAlwaysServe
Endpoint-PUT-External-WithCustomHeaders
Endpoint-PUT-External-WithGeoMapping
Endpoint-PUT-External-WithLocation
Endpoint-PUT-External-WithSubnetMapping

Endpoint-PUT-External-WithAlwaysServe

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
AlwaysServe

Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden.

CloudError

Ett fel som returneras av Azure Resource Manager

CloudErrorBody

Innehållet i ett fel som returneras av Azure Resource Manager

CustomHeaders

Lista över anpassade rubriker.

Endpoint

Klass som representerar en Traffic Manager-slutpunkt.

EndpointMonitorStatus

Slutpunktens övervakningsstatus.

EndpointStatus

Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden.

EndpointType

Typen av Traffic Manager-slutpunkt som ska skapas eller uppdateras.

Subnets

Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter.

AlwaysServe

Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden.

Name Typ Description
Disabled

string

Enabled

string

CloudError

Ett fel som returneras av Azure Resource Manager

Name Typ Description
error

CloudErrorBody

Innehållet i felet.

CloudErrorBody

Innehållet i ett fel som returneras av Azure Resource Manager

Name Typ Description
code

string

Felkod

details

CloudErrorBody[]

Felinformation

message

string

Felmeddelande

target

string

Felmål

CustomHeaders

Lista över anpassade rubriker.

Name Typ Description
name

string

Rubriknamn.

value

string

Rubrikvärde.

Endpoint

Klass som representerar en Traffic Manager-slutpunkt.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Namnet på resursen

properties.alwaysServe

AlwaysServe

Om Always Serve är aktiverat inaktiveras avsökning för slutpunktshälsa och slutpunkter inkluderas i trafikroutningsmetoden.

properties.customHeaders

CustomHeaders[]

Lista över anpassade rubriker.

properties.endpointLocation

string

Anger platsen för de externa eller kapslade slutpunkterna när du använder trafikroutningsmetoden Prestanda.

properties.endpointMonitorStatus

EndpointMonitorStatus

Slutpunktens övervakningsstatus.

properties.endpointStatus

EndpointStatus

Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden.

properties.geoMapping

string[]

Listan över länder/regioner som mappas till den här slutpunkten när du använder trafikroutningsmetoden Geografisk. En fullständig lista över godkända värden finns i Traffic Manager Geographic-dokumentationen.

properties.minChildEndpoints

integer

Det minsta antalet slutpunkter som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

properties.minChildEndpointsIPv4

integer

Det minsta antalet IPv4-slutpunkter (DNS-posttyp A) som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

properties.minChildEndpointsIPv6

integer

Det minsta antalet IPv6-slutpunkter (DNS-posttyp AAAA) som måste vara tillgängliga i den underordnade profilen för att den överordnade profilen ska anses vara tillgänglig. Gäller endast för slutpunkten av typen "NestedEndpoints".

properties.priority

integer

Prioriteten för den här slutpunkten när du använder trafikroutningsmetoden Prioritet. Möjliga värden är från 1 till 1 000, lägre värden representerar högre prioritet. Det här är en valfri parameter. Om den anges måste den anges på alla slutpunkter och inga två slutpunkter kan dela samma prioritetsvärde.

properties.subnets

Subnets[]

Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter.

properties.target

string

Slutpunktens fullständigt kvalificerade DNS-namn eller IP-adress. Traffic Manager returnerar det här värdet i DNS-svar för att dirigera trafik till den här slutpunkten.

properties.targetResourceId

string

Azure-resursens URI för slutpunkten. Gäller inte för slutpunkter av typen ExternalEndpoints.

properties.weight

integer

Vikten för den här slutpunkten när du använder trafikroutningsmetoden Viktad. Möjliga värden är från 1 till 1 000.

type

string

Resurstypen. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Slutpunktens övervakningsstatus.

Name Typ Description
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

Slutpunktens status. Om slutpunkten är Aktiverad avsöks den för slutpunktshälsa och ingår i trafikroutningsmetoden.

Name Typ Description
Disabled

string

Enabled

string

EndpointType

Typen av Traffic Manager-slutpunkt som ska skapas eller uppdateras.

Name Typ Description
AzureEndpoints

string

ExternalEndpoints

string

NestedEndpoints

string

Subnets

Listan över undernät, IP-adresser och/eller adressintervall som mappas till den här slutpunkten när du använder trafikroutningsmetoden "Undernät". En tom lista matchar alla intervall som inte omfattas av andra slutpunkter.

Name Typ Description
first

string

Första adressen i undernätet.

last

string

Sista adressen i undernätet.

scope

integer

Blockstorlek (antal inledande bitar i nätmasken).