Exportar (0) Imprimir
Expandir Tudo

Criar definição

Atualizado: janeiro de 2015

A operação Create Definition cria uma nova definição para um perfil especificado. Esta definição receberá um número de versão pelo serviço. Para obter mais informações sobre como criar um perfil, consulte Criar perfil.

A solicitação Create Definition é especificada como a seguir. Substitua <subscription-id> pela ID da assinatura e <profile-name> pelo nome do perfil. Por exemplo, myapp-trafficmanager-net.

 

Método URI de solicitação

POST

https://management.core.windows.net/<subscription-id>/services/WATM/profiles/<profile-name>/definitions

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

Nenhuma.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 01.10.11 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviço.

Formato do corpo da solicitação:


<Definition xmlns="http://schemas.microsoft.com/windowsazure">
  <DnsOptions>
    <TimeToLiveInSeconds>dns-time-to-live</TimeToLiveInSeconds>
  </DnsOptions>
  <Monitors>
    <Monitor>
      <IntervalInSeconds>interval-in-seconds</IntervalInSeconds>
      <TimeoutInSeconds>timeout-in-seconds</TimeoutInSeconds>
      <ToleratedNumberOfFailures>number-of-failures</ToleratedNumberOfFailures>
      <Protocol>monitor-protocol</Protocol>
      <Port>port-number</Port>
      <HttpOptions>
        <Verb>http-verb</Verb>
        <RelativePath>path-relative-to-endpoint</RelativePath>
        <ExpectedStatusCode>expected-status</ExpectedStatusCode>
      </HttpOptions>
    </Monitor>
  </Monitors>
  <Policy>
    <LoadBalancingMethod>load-balancing-method</LoadBalancingMethod>
    <Endpoints>
      <Endpoint>
        <DomainName>domain-name</DomainName>
        <Status>endpoint-status</Status>
        <Type>endpoint-type</Type>
        <Location>endpoint-location</Location>
        <MinChildEndpoints>min-child-endpoints</MinChildEndpoints>
        <Weight>load-balancing-priority</Weight>
      </Endpoint>
    </Endpoints>
  </Policy>
</Definition>

A tabela a seguir descreve os elementos no corpo da solicitação.

 

Nome do parâmetro Descrição

TimeToLiveInSeconds

Especifica a TTL (Vida Útil) que informa os resolvedores de DNS Locais por quanto tempo armazenar em cache as entradas DNS.

O valor é um número inteiro de 30 a 999.999.

IntervalInSeconds

Especifica o número de segundos entre tentativas consecutivas de verificar o status de um ponto de extremidade de monitoramento. O valor deve ser definido como 30.

TimeoutInSeconds

Especifica o tempo de espera por uma resposta do ponto de extremidade de monitoramento. O valor deve ser definido como 10.

ToleratedNumberOfFailures

Especifica o número de falhas consecutivas a serem sondadas em um ponto de extremidade antes de retirar o ponto de extremidade da rotação. O valor deve ser definido como 3.

Protocolo

Especifica o protocolo a ser usado para monitorar a integridade do ponto de extremidade.

Os possíveis valores são:

  • HTTP

  • HTTPS

Porta

Especifica a porta usada para monitorar a integridade do ponto de extremidade. Os valores aceitos são valores inteiros maiores que 0 e menores que ou iguais a 65.535.

Verbo

Especifica o verbo a ser usado ao fazer uma solicitação HTTP para monitorar a integridade do ponto de extremidade. O valor deve ser definido como GET.

RelativePath

Especifica o caminho relativo para o nome de domínio do ponto de extremidade para sondar o estado de integridade. As restrições são:

  • O caminho deve ter de 1 a 1000 caracteres.

  • Ele deve iniciar com uma barra invertida /.

  • Não deve conter nenhum colchete <>.

  • Não deve conter nenhuma barra dupla //.

  • Deve ser uma cadeia de caracteres do URI bem formada. Para mais informações, consulte Método Uri.IsWellFormedUriString.

ExpectedStatusCode

Especifica o código de status HTTP esperado de um ponto de extremidade íntegro. Caso contrário, o ponto de extremidade será considerado como não íntegro. O valor deve ser definido como 200.

LoadBalancingMethod

Especifica o método de balanceamento de carga para distribuir conexão.

Os possíveis valores são:

  • Desempenho

  • Failover

  • RoundRobin

Pontos de extremidade

Encapsula a lista de pontos de extremidade do Azure Traffic Manager. Você pode definir até 100 pontos de extremidade na lista.

Se o método de balanceamento de carga for definido como Failover, o tráfego para os pontos de extremidade terá balanceamento de carga na ordem sequencial em que os pontos de extremidade forem definidos.

DomainName

Especifica o nome de domínio do ponto de extremidade. O valor depende do tipo de ponto de extremidade. Se o Tipo é CloudService, o valor deve ser um nome de domínio totalmente qualificado (FQDN) de um serviço de nuvem que pertence ao ID da assinatura que possui a definição. Se o Tipo é AzureWebsite, o valor deve ser um FQDN de um site Azure que pertence ao ID de assinatura que possui a definição. Se o Tipo é Qualquer, o valor pode ser qualquer FQDN para um serviço Azure ou um serviço fora do Azure.

Status

Especifica o status do ponto de extremidade de monitoramento. Se definido como Enabled, o ponto de extremidade será considerado pelo método de balanceamento de carga e será monitorado.

Os possíveis valores são:

  • Enabled

  • Disabled

Tipo

Opcional. Especifica o tipo de ponto de extremidade a ser adicionado à definição.

Os possíveis valores são:

  • CloudService

  • AzureWebsite

  • Any

  • TrafficManager

Se houver mais de um ponto de extremidade AzureWebsite, eles deverão estar em data centers diferentes. Essa limitação não se aplica a serviços de nuvem. O valor padrão é CloudService. Use o tipo TrafficManager ao configurar perfis aninhados. Para obter mais informações, consulte Visão Geral do Traffic Manager.

Local

Requerido quando LoadBalancingMethod é definido para Desempenho e Tipo é definido para Qualquer ou TrafficManager. Especifica o nome da região do Azure. O Local não pode ser especificado para os pontos de extremidade do tipo CloudService ou AzureWebsite, nos quais os locais são determinados a partir do serviço. Para mais informações, consulte Localizações de Lista.

MinChildEndpoints

Opcional. Pode ser especificado quando o Tipo é definido para TrafficManager. O número mínimo de pontos de extremidade íntegros em um perfil aninhado que determina se qualquer um dos pontos de extremidade nesse perfil pode receber tráfego. O valor padrão é 1.

Peso

Opcional. Especifica a prioridade do ponto de extremidade de balanceamento de carga. Quanto maior o peso, mais frequentemente o ponto de extremidade será disponibilizado para o balanceador de carga. O valor deve ser maior que 0. Para os pontos de extremidade que não especificam um valor de peso, será usado um peso padrão de 1.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

Formato do corpo da resposta:


<Definition xmlns="http://schemas.microsoft.com/windowsazure">
  <Version>1</Version>
</Definition>

A tabela a seguir descreve os elementos no corpo da resposta.

 

Nome de elemento Descrição

Versão

O número de versão atribuído à nova definição. Esse valor é sempre 1.

Consulte também

Mostrar:
© 2015 Microsoft