Udostępnij za pośrednictwem


Endpoints - Create Or Update

Tworzenie lub aktualizowanie punktu końcowego usługi Traffic Manager.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
endpointName
path True

string

Nazwa punktu końcowego usługi Traffic Manager, który ma zostać utworzony lub zaktualizowany.

endpointType
path True

EndpointType

Typ punktu końcowego usługi Traffic Manager do utworzenia lub zaktualizowania.

profileName
path True

string

Nazwa profilu usługi Traffic Manager.

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True

string

Pobiera poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

api-version
query True

string

Wersja interfejsu API klienta.

Treść żądania

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Nazwa zasobu

properties.alwaysServe

AlwaysServe

Jeśli funkcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

properties.customHeaders

CustomHeaders[]

Lista nagłówków niestandardowych.

properties.endpointLocation

string

Określa lokalizację zewnętrznych lub zagnieżdżonych punktów końcowych podczas korzystania z metody routingu ruchu "Wydajność".

properties.endpointMonitorStatus

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

properties.endpointStatus

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

properties.geoMapping

string[]

Lista krajów/regionów zamapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu geograficznego. Aby uzyskać pełną listę akceptowanych wartości, zapoznaj się z dokumentacją geograficzną usługi Traffic Manager.

properties.minChildEndpoints

integer

Minimalna liczba punktów końcowych, które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.minChildEndpointsIPv4

integer

Minimalna liczba punktów końcowych IPv4 (typ rekordu DNS A), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.minChildEndpointsIPv6

integer

Minimalna liczba punktów końcowych IPv6 (typu rekordu DNS AAAA), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.priority

integer

Priorytet tego punktu końcowego podczas korzystania z metody routingu ruchu "Priorytet". Możliwe wartości to od 1 do 1000, niższe wartości reprezentują wyższy priorytet. Jest to opcjonalny parametr. Jeśli zostanie określony, należy go określić we wszystkich punktach końcowych, a żadne dwa punkty końcowe nie mogą współdzielić tej samej wartości priorytetu.

properties.subnets

Subnets[]

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

properties.target

string

W pełni kwalifikowana nazwa DNS lub adres IP punktu końcowego. Usługa Traffic Manager zwraca tę wartość w odpowiedziach DNS, aby skierować ruch do tego punktu końcowego.

properties.targetResourceId

string

Identyfikator URI zasobu platformy Azure punktu końcowego. Nie dotyczy punktów końcowych typu "ExternalEndpoints".

properties.weight

integer

Waga tego punktu końcowego podczas korzystania z metody routingu ruchu "Ważona". Możliwe wartości to od 1 do 1000.

type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

Odpowiedzi

Nazwa Typ Opis
200 OK

Endpoint

Utworzony lub zaktualizowany punkt końcowy.

201 Created

Endpoint

Utworzony lub zaktualizowany punkt końcowy.

Other Status Codes

CloudError

Odpowiedź domyślna. Zostanie ona zdeserializowana zgodnie z definicją błędu.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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

Endpoint-PUT-External-WithAlwaysServe

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
AlwaysServe

Jeśli funkcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

CloudError

Błąd zwrócony przez usługę Azure Resource Manager

CloudErrorBody

Zawartość błędu zwróconego przez usługę Azure Resource Manager

CustomHeaders

Lista nagłówków niestandardowych.

Endpoint

Klasa reprezentująca punkt końcowy usługi Traffic Manager.

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

EndpointType

Typ punktu końcowego usługi Traffic Manager do utworzenia lub zaktualizowania.

Subnets

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

AlwaysServe

Jeśli funkcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

Nazwa Typ Opis
Disabled

string

Enabled

string

CloudError

Błąd zwrócony przez usługę Azure Resource Manager

Nazwa Typ Opis
error

CloudErrorBody

Zawartość błędu.

CloudErrorBody

Zawartość błędu zwróconego przez usługę Azure Resource Manager

Nazwa Typ Opis
code

string

Kod błędu

details

CloudErrorBody[]

Szczegóły błędu

message

string

Komunikat o błędzie

target

string

Błąd docelowy

CustomHeaders

Lista nagłówków niestandardowych.

Nazwa Typ Opis
name

string

Nazwa nagłówka.

value

string

Wartość nagłówka.

Endpoint

Klasa reprezentująca punkt końcowy usługi Traffic Manager.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

Nazwa zasobu

properties.alwaysServe

AlwaysServe

Jeśli funkcja Always Serve jest włączona, sondowanie kondycji punktu końcowego zostanie wyłączone, a punkty końcowe zostaną uwzględnione w metodzie routingu ruchu.

properties.customHeaders

CustomHeaders[]

Lista nagłówków niestandardowych.

properties.endpointLocation

string

Określa lokalizację zewnętrznych lub zagnieżdżonych punktów końcowych podczas korzystania z metody routingu ruchu "Wydajność".

properties.endpointMonitorStatus

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

properties.endpointStatus

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

properties.geoMapping

string[]

Lista krajów/regionów zamapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu geograficznego. Aby uzyskać pełną listę akceptowanych wartości, zapoznaj się z dokumentacją geograficzną usługi Traffic Manager.

properties.minChildEndpoints

integer

Minimalna liczba punktów końcowych, które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.minChildEndpointsIPv4

integer

Minimalna liczba punktów końcowych IPv4 (typ rekordu DNS A), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.minChildEndpointsIPv6

integer

Minimalna liczba punktów końcowych IPv6 (typu rekordu DNS AAAA), które muszą być dostępne w profilu podrzędnym, aby profil nadrzędny był uznawany za dostępny. Dotyczy tylko punktu końcowego typu "NestedEndpoints".

properties.priority

integer

Priorytet tego punktu końcowego podczas korzystania z metody routingu ruchu "Priorytet". Możliwe wartości to od 1 do 1000, niższe wartości reprezentują wyższy priorytet. Jest to opcjonalny parametr. Jeśli zostanie określony, należy go określić we wszystkich punktach końcowych, a żadne dwa punkty końcowe nie mogą współdzielić tej samej wartości priorytetu.

properties.subnets

Subnets[]

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

properties.target

string

W pełni kwalifikowana nazwa DNS lub adres IP punktu końcowego. Usługa Traffic Manager zwraca tę wartość w odpowiedziach DNS, aby skierować ruch do tego punktu końcowego.

properties.targetResourceId

string

Identyfikator URI zasobu platformy Azure punktu końcowego. Nie dotyczy punktów końcowych typu "ExternalEndpoints".

properties.weight

integer

Waga tego punktu końcowego podczas korzystania z metody routingu ruchu "Ważona". Możliwe wartości to od 1 do 1000.

type

string

Typ zasobu. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Stan monitorowania punktu końcowego.

Nazwa Typ Opis
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

Stan punktu końcowego. Jeśli punkt końcowy jest włączony, jest sondowany pod kątem kondycji punktu końcowego i jest uwzględniony w metodzie routingu ruchu.

Nazwa Typ Opis
Disabled

string

Enabled

string

EndpointType

Typ punktu końcowego usługi Traffic Manager do utworzenia lub zaktualizowania.

Nazwa Typ Opis
AzureEndpoints

string

ExternalEndpoints

string

NestedEndpoints

string

Subnets

Lista podsieci, adresów IP i/lub zakresów adresów mapowanych na ten punkt końcowy podczas korzystania z metody routingu ruchu "Podsieć". Pusta lista będzie zgodna ze wszystkimi zakresami, które nie są objęte innymi punktami końcowymi.

Nazwa Typ Opis
first

string

Pierwszy adres w podsieci.

last

string

Ostatni adres w podsieci.

scope

integer

Rozmiar bloku (liczba bitów wiodących w masce podsieci).