Endpoints - Update

Serviço:: Traffic Manager

Versão da API:: 2022-04-01

Atualize um ponto de extremidade do Gerenciador de Tráfego.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpointName	path	True	string	O nome do ponto de extremidade do Gerenciador de Tráfego.
endpointType	path	True	EndpointType	O tipo de ponto de extremidade do Gerenciador de Tráfego.
profileName	path	True	string	O nome do perfil do Gerenciador de Tráfego.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
id	string (arm-id)	ID do recurso totalmente qualificado 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 sondagem da integridade do endpoint será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.
properties.customHeaders	EndpointPropertiesCustomHeadersItem[]	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, ele será investigado quanto à integridade do ponto de extremidade e será incluído no método de roteamento de tráfego.
properties.geoMapping	string[]	A lista de países/regiões mapeados para este ponto final ao usar o método de roteamento de tráfego 'Geográfico'. Consulte a documentação geográfica do Traffic Manager para obter uma lista completa dos valores aceites.
properties.minChildEndpoints	integer (int64)	O número mínimo de pontos finais que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável apenas ao ponto de extremidade do tipo 'NestedEndpoints'.
properties.minChildEndpointsIPv4	integer (int64)	O número mínimo de pontos de extremidade IPv4 (registro DNS tipo A) que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável apenas ao ponto de extremidade do tipo 'NestedEndpoints'.
properties.minChildEndpointsIPv6	integer (int64)	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 apenas ao ponto de extremidade do tipo 'NestedEndpoints'.
properties.priority	integer (int64)	A prioridade deste ponto de extremidade ao usar o método de roteamento de tráfego 'Priority'. Os valores possíveis são de 1 a 1000, valores mais baixos representam maior prioridade. Este é um parâmetro opcional. Se especificado, ele deve ser especificado em todos os pontos de extremidade, e nenhum dois pontos de extremidade pode compartilhar o mesmo valor de prioridade.
properties.subnets	EndpointPropertiesSubnetsItem[]	A lista de sub-redes, endereços IP e/ou intervalos de endereços mapeados para este 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 ou endereço IP totalmente qualificado do ponto de extremidade. O Gerenciador de Tráfego retorna esse valor em respostas DNS para direcionar o tráfego para esse ponto de extremidade.
properties.targetResourceId	string	O URI do recurso do Azure do ponto de extremidade. Não aplicável a parâmetros do tipo 'ExternalEndpoints'.
properties.weight	integer (int64)	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	O tipo do recurso. Ex- Microsoft.Network/trafficManagerProfiles.

Respostas

Name	Tipo	Description
200 OK	Endpoint	Operação do Azure concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Endpoint-PATCH-External-Target

Pedido de amostra

HTTP

PATCH 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",
  "id": "/subscriptions/{subscription-id}/resourceGroups/azuresdkfornetautoresttrafficmanager1421/providers/Microsoft.Network/trafficManagerProfiles/azsmnet6386/externalEndpoints/azsmnet7187",
  "properties": {
    "target": "another.foobar.contoso.com"
  }
}

Resposta da amostra

Código de estado:: 200

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

Definições

Name	Description
AlwaysServe	Se o Always Serve estiver habilitado, a sondagem da integridade do endpoint será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.
CloudError	Um erro retornado pelo Azure Resource Manager
CloudErrorBody	O conteúdo de um erro retornado pelo Azure Resource Manager
Endpoint	Classe que representa um ponto de extremidade do Gerenciador de Tráfego.
EndpointMonitorStatus	O status de monitoramento do ponto de extremidade.
EndpointPropertiesCustomHeadersItem	Nome e valor do cabeçalho personalizado.
EndpointPropertiesSubnetsItem	Primeiro endereço, escopo e/ou último endereço da sub-rede.
EndpointStatus	O status do ponto de extremidade. Se o ponto de extremidade estiver Habilitado, ele será investigado quanto à integridade do ponto de extremidade e será incluído no método de roteamento de tráfego.
EndpointType	O tipo de ponto de extremidade do Gerenciador de Tráfego.

AlwaysServe

Enumeração

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

Valor	Description
Enabled
Disabled

CloudError

Object

Um erro retornado pelo Azure Resource Manager

Name	Tipo	Description
error	CloudErrorBody	O conteúdo do erro.

CloudErrorBody

Object

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

Name	Tipo	Description
code	string	Código de erro
details	CloudErrorBody[]	Detalhes do erro
message	string	Mensagem de erro
target	string	Alvo de erro

Endpoint

Object

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

Name	Tipo	Description
id	string (arm-id)	ID do recurso totalmente qualificado 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 sondagem da integridade do endpoint será desabilitada e os pontos de extremidade serão incluídos no método de roteamento de tráfego.
properties.customHeaders	EndpointPropertiesCustomHeadersItem[]	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, ele será investigado quanto à integridade do ponto de extremidade e será incluído no método de roteamento de tráfego.
properties.geoMapping	string[]	A lista de países/regiões mapeados para este ponto final ao usar o método de roteamento de tráfego 'Geográfico'. Consulte a documentação geográfica do Traffic Manager para obter uma lista completa dos valores aceites.
properties.minChildEndpoints	integer (int64)	O número mínimo de pontos finais que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável apenas ao ponto de extremidade do tipo 'NestedEndpoints'.
properties.minChildEndpointsIPv4	integer (int64)	O número mínimo de pontos de extremidade IPv4 (registro DNS tipo A) que devem estar disponíveis no perfil filho para que o perfil pai seja considerado disponível. Aplicável apenas ao ponto de extremidade do tipo 'NestedEndpoints'.
properties.minChildEndpointsIPv6	integer (int64)	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 apenas ao ponto de extremidade do tipo 'NestedEndpoints'.
properties.priority	integer (int64)	A prioridade deste ponto de extremidade ao usar o método de roteamento de tráfego 'Priority'. Os valores possíveis são de 1 a 1000, valores mais baixos representam maior prioridade. Este é um parâmetro opcional. Se especificado, ele deve ser especificado em todos os pontos de extremidade, e nenhum dois pontos de extremidade pode compartilhar o mesmo valor de prioridade.
properties.subnets	EndpointPropertiesSubnetsItem[]	A lista de sub-redes, endereços IP e/ou intervalos de endereços mapeados para este 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 ou endereço IP totalmente qualificado do ponto de extremidade. O Gerenciador de Tráfego retorna esse valor em respostas DNS para direcionar o tráfego para esse ponto de extremidade.
properties.targetResourceId	string	O URI do recurso do Azure do ponto de extremidade. Não aplicável a parâmetros do tipo 'ExternalEndpoints'.
properties.weight	integer (int64)	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	O tipo do recurso. Ex- Microsoft.Network/trafficManagerProfiles.

EndpointMonitorStatus

Enumeração

O status de monitoramento do ponto de extremidade.

Valor	Description
CheckingEndpoint
Online
Degraded
Disabled
Inactive
Stopped
Unmonitored

EndpointPropertiesCustomHeadersItem

Object

Nome e valor do cabeçalho personalizado.

Name	Tipo	Description
name	string	Nome do cabeçalho.
value	string	Valor do cabeçalho.

EndpointPropertiesSubnetsItem

Object

Primeiro endereço, escopo e/ou último endereço da sub-rede.

Name	Tipo	Description
first	string	Primeiro endereço na sub-rede.
last	string	Último endereço na sub-rede.
scope	integer (int32)	Tamanho do bloco (número de bits à esquerda na máscara de sub-rede).

EndpointStatus

Enumeração

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

Valor	Description
Enabled
Disabled

EndpointType

Enumeração

O tipo de ponto de extremidade do Gerenciador de Tráfego.

Valor	Description
AzureEndpoints
ExternalEndpoints
NestedEndpoints

Partilhar via

Endpoints - Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Endpoint-PATCH-External-Target

Pedido de amostra

Resposta da amostra

Definições

AlwaysServe

CloudError

CloudErrorBody

Endpoint

EndpointMonitorStatus

EndpointPropertiesCustomHeadersItem

EndpointPropertiesSubnetsItem

EndpointStatus

EndpointType