Compartilhar via


Endpoints - Create Or Update

Criar ou atualizar um ponto de extremidade do Gerenciador de Tráfego.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpointName
path True

string

O nome do ponto de extremidade do Gerenciador de Tráfego a ser criado ou atualizado.

endpointType
path True

EndpointType

O tipo do ponto de extremidade do Gerenciador de Tráfego a ser criado ou atualizado.

profileName
path True

string

O nome do perfil do Gerenciador de Tráfego.

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

Obtém as credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

api-version
query True

string

Versão da API do cliente.

Corpo da solicitação

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

O nome do recurso

properties.alwaysServe

AlwaysServe

Se o Always Serve estiver habilitado, a investigação da integridade do ponto de extremidade será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.

properties.customHeaders

CustomHeaders[]

Lista de cabeçalhos personalizados.

properties.endpointLocation

string

Especifica o local dos pontos de extremidade externos ou aninhados ao usar o método de roteamento de tráfego "Desempenho".

properties.endpointMonitorStatus

EndpointMonitorStatus

O status de monitoramento do ponto de extremidade.

properties.endpointStatus

EndpointStatus

O status do ponto de extremidade. Se o ponto de extremidade estiver Habilitado, sua integridade é analisada e ele é incluído no método de roteamento de tráfego.

properties.geoMapping

string[]

A lista de países/regiões mapeadas para esse ponto de extremidade ao usar o método de roteamento de tráfego 'Geográfico'. Consulte a documentação geográfica do Gerenciador de Tráfego para obter uma lista completa dos valores aceitos.

properties.minChildEndpoints

integer

O número mínimo de pontos de extremidade que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

properties.minChildEndpointsIPv4

integer

O número mínimo de pontos de extremidade IPv4 (tipo de registro DNS A) que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

properties.minChildEndpointsIPv6

integer

O número mínimo de pontos de extremidade IPv6 (tipo de registro DNS AAAA) que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

properties.priority

integer

A prioridade desse ponto de extremidade ao usar o método de roteamento de tráfego 'Priority'. Os valores possíveis são de 1 a 1000, os valores mais baixos representam prioridade mais alta. Esse é um parâmetro opcional. Se especificado, ele deve ser especificado em todos os pontos de extremidade e dois pontos de extremidade não podem compartilhar o mesmo valor de prioridade.

properties.subnets

Subnets[]

A lista de sub-redes, endereços IP e/ou intervalos de endereços mapeados para esse ponto de extremidade ao usar o método de roteamento de tráfego "Sub-rede". Uma lista vazia corresponderá a todos os intervalos não cobertos por outros pontos de extremidade.

properties.target

string

O nome DNS totalmente qualificado ou o endereço IP do ponto de extremidade. O Gerenciador de Tráfego retorna esse valor nas respostas de DNS para direcionar tráfego para esse ponto de extremidade.

properties.targetResourceId

string

O URI de Recurso do Azure do do ponto de extremidade. Não aplicável a pontos de extremidade do tipo 'ExternalEndpoints'.

properties.weight

integer

O peso desse ponto de extremidade ao usar o método de roteamento de tráfego 'Ponderado'. Os valores possíveis são de 1 a 1000.

type

string

Tipo do recurso. Por exemplo, Microsoft.Network/trafficManagerProfiles.

Respostas

Nome Tipo Description
200 OK

Endpoint

O ponto de extremidade criado ou atualizado.

201 Created

Endpoint

O ponto de extremidade criado ou atualizado.

Other Status Codes

CloudError

Resposta padrão. Ele será desserializado de acordo com a definição de Erro.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

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

Endpoint-PUT-External-WithAlwaysServe

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
AlwaysServe

Se o Always Serve estiver habilitado, a investigação da integridade do ponto de extremidade será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.

CloudError

Um erro retornado pelo Resource Manager do Azure

CloudErrorBody

O conteúdo de um erro retornado pelo Resource Manager do Azure

CustomHeaders

Lista de cabeçalhos personalizados.

Endpoint

Classe que representa um ponto de extremidade do Gerenciador de Tráfego.

EndpointMonitorStatus

O status de monitoramento do ponto de extremidade.

EndpointStatus

O status do ponto de extremidade. Se o ponto de extremidade estiver Habilitado, sua integridade é analisada e ele é incluído no método de roteamento de tráfego.

EndpointType

O tipo do ponto de extremidade do Gerenciador de Tráfego a ser criado ou atualizado.

Subnets

A lista de sub-redes, endereços IP e/ou intervalos de endereços mapeados para esse ponto de extremidade ao usar o método de roteamento de tráfego "Sub-rede". Uma lista vazia corresponderá a todos os intervalos não cobertos por outros pontos de extremidade.

AlwaysServe

Se o Always Serve estiver habilitado, a investigação da integridade do ponto de extremidade será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.

Nome Tipo Description
Disabled

string

Enabled

string

CloudError

Um erro retornado pelo Resource Manager do Azure

Nome Tipo Description
error

CloudErrorBody

O conteúdo do erro.

CloudErrorBody

O conteúdo de um erro retornado pelo Resource Manager do Azure

Nome Tipo Description
code

string

Código do erro

details

CloudErrorBody[]

Detalhes do erro

message

string

Mensagem de erro

target

string

Destino de erro

CustomHeaders

Lista de cabeçalhos personalizados.

Nome Tipo Description
name

string

Nome do cabeçalho.

value

string

Valor do cabeçalho.

Endpoint

Classe que representa um ponto de extremidade do Gerenciador de Tráfego.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{resourceName}

name

string

O nome do recurso

properties.alwaysServe

AlwaysServe

Se o Always Serve estiver habilitado, a investigação da integridade do ponto de extremidade será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.

properties.customHeaders

CustomHeaders[]

Lista de cabeçalhos personalizados.

properties.endpointLocation

string

Especifica o local dos pontos de extremidade externos ou aninhados ao usar o método de roteamento de tráfego "Desempenho".

properties.endpointMonitorStatus

EndpointMonitorStatus

O status de monitoramento do ponto de extremidade.

properties.endpointStatus

EndpointStatus

O status do ponto de extremidade. Se o ponto de extremidade estiver Habilitado, sua integridade é analisada e ele é incluído no método de roteamento de tráfego.

properties.geoMapping

string[]

A lista de países/regiões mapeadas para esse ponto de extremidade ao usar o método de roteamento de tráfego 'Geográfico'. Consulte a documentação geográfica do Gerenciador de Tráfego para obter uma lista completa dos valores aceitos.

properties.minChildEndpoints

integer

O número mínimo de pontos de extremidade que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

properties.minChildEndpointsIPv4

integer

O número mínimo de pontos de extremidade IPv4 (tipo de registro DNS A) que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

properties.minChildEndpointsIPv6

integer

O número mínimo de pontos de extremidade IPv6 (tipo de registro DNS AAAA) que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável somente ao ponto de extremidade do tipo 'NestedEndpoints'.

properties.priority

integer

A prioridade desse ponto de extremidade ao usar o método de roteamento de tráfego 'Priority'. Os valores possíveis são de 1 a 1000, os valores mais baixos representam prioridade mais alta. Esse é um parâmetro opcional. Se especificado, ele deve ser especificado em todos os pontos de extremidade e dois pontos de extremidade não podem compartilhar o mesmo valor de prioridade.

properties.subnets

Subnets[]

A lista de sub-redes, endereços IP e/ou intervalos de endereços mapeados para esse ponto de extremidade ao usar o método de roteamento de tráfego "Sub-rede". Uma lista vazia corresponderá a todos os intervalos não cobertos por outros pontos de extremidade.

properties.target

string

O nome DNS totalmente qualificado ou o endereço IP do ponto de extremidade. O Gerenciador de Tráfego retorna esse valor nas respostas de DNS para direcionar tráfego para esse ponto de extremidade.

properties.targetResourceId

string

O URI de Recurso do Azure do do ponto de extremidade. Não aplicável a pontos de extremidade do tipo 'ExternalEndpoints'.

properties.weight

integer

O peso desse ponto de extremidade ao usar o método de roteamento de tráfego 'Ponderado'. Os valores possíveis são de 1 a 1000.

type

string

Tipo do recurso. Por exemplo, Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

O status de monitoramento do ponto de extremidade.

Nome Tipo Description
CheckingEndpoint

string

Degraded

string

Disabled

string

Inactive

string

Online

string

Stopped

string

Unmonitored

string

EndpointStatus

O status do ponto de extremidade. Se o ponto de extremidade estiver Habilitado, sua integridade é analisada e ele é incluído no método de roteamento de tráfego.

Nome Tipo Description
Disabled

string

Enabled

string

EndpointType

O tipo do ponto de extremidade do Gerenciador de Tráfego a ser criado ou atualizado.

Nome Tipo Description
AzureEndpoints

string

ExternalEndpoints

string

NestedEndpoints

string

Subnets

A lista de sub-redes, endereços IP e/ou intervalos de endereços mapeados para esse ponto de extremidade ao usar o método de roteamento de tráfego "Sub-rede". Uma lista vazia corresponderá a todos os intervalos não cobertos por outros pontos de extremidade.

Nome Tipo Description
first

string

Primeiro endereço na sub-rede.

last

string

Último endereço na sub-rede.

scope

integer

Tamanho do bloco (número de bits à esquerda na máscara de sub-rede).