Modificando uma instância de serviço

Após criar um serviço de Tempo de Precisão e o status dele ser "Provisionado", você poderá alterar a configuração. Antes de atualizar um serviço recém-provisionado, é necessário aguardar 6 horas. Durante esse período, o banco de dados de faturas atualiza seus registros para fornecer preços precisos.

Para visualizar e modificar os serviços de Tempo de Precisão, você precisa da função Administrador de Serviço EPT.

Para acessar as informações do serviço Precision Time no Portal do Cliente, [faça login e navegue até seu Inventário do Precision Time.

Para acessar as informações do serviço Precision Time na API, você deve enviar seu ID do Cliente e Segredo do Cliente para autenticação OAuth2. Consulte Autenticação da API para obter instruções sobre como chamar a API OAuth para validar e autenticar suas credenciais.

aviso

Alterar a configuração pode interromper o serviço.

Nome do serviço

Portal

Clique em Editar ao lado do nome do serviço.

Digite um novo nome e clique em Enviar.

API

Para atualizar o nome de um serviço de tempo, envie uma solicitação PATCH para o endpoint /fabric/v4/timeServices/{serviceId}.

No corpo da solicitar, especifique:

• op - replace.
• path - /name.
• value - The new name for your service.

Exemplo de solicitação cURL:

curl -X  
PATCH 'https: //api.equinix.com/fabric/v4/timeServices/<service_id>'
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[  
{
    "op": "replace",
    "path": "/name",
    "value": "<new-service-name>"
}
]'

Pacote de serviços

observação

Se uma instância do serviço Precision Time foi criada manualmente por um representante de vendas da Equinix, você deve entrar em contato com ele para alterar o nível do serviço. Não será possível alterar o nível do serviço usando o Portal ou a API.

Portal

Clique em Editar na seção Detalhes do Pacote. Altere o pacote e, em seguida, visualize e aceite o novo preço. Clique em Enviar.

API

Para atualizar seu pacote de serviços, envie uma solicitação PATCH para o endpoint /fabric/v4/timeServices/{serviceId}.

No corpo da solicitar, especifique:

• op - replace.
• path - /package/code.
• value - The new package code: NTP_STANDARD, NTP_ENTERPRISE, PTP_STANDARD, or PTP_ENTERPRISE.

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/<service_id>'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/package/code",
    "value": "<new_package_code>"
  }
]'

Detalhes do ativo

Clique em Editar nos Detalhes do Ativo. Somente os serviços provisionados podem ser editados.

A janela Editar detalhes do recurso de tempo de precisão será exibida. Somente as portas elegíveis aparecerão com base na rede metropolitana, encapsulamento, ID da VLAN anterior e tipo de porta.

• Selecione a porta desejada e clique em Avançar.
• O ID da VLAN previamente selecionada será exibido.
• Clique em Salvar. Os detalhes da conexão da porta serão atualizados.

Detalhes da rede

Portal

Clique em Editar na seção Detalhes da Rede para atualizar o IP Primário, o IP Secundário, a Máscara de Rede e a Interface IP do Gateway.

API

Para atualizar os detalhes de rede de um serviço, envie uma solicitação PATCH para o endpoint /fabric/v4/timeServices/{serviceId}.

No corpo da solicitar, especifique:

• op - replace.
• path - /ipv4.
• value - Specify new values for the primary IP address, secondary IP address, network mask, and gateway IP address.

Exemplo de solicitação cURL:

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/3a58dd05-f46d-4b1d-a154-2e85c396ea62'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/ipv4",
    "value": {
      "primary": "192.168.254.241",
      "secondary": "192.168.254.242",
      "networkMask": "255.255.255.240",
      "defaultGateway": "192.168.254.254"
    }
  }
]'

Detalhes da configuração avançada do PTP

Você pode modificar os seguintes detalhes de configuração avançada do PTP:

• Cronograma:

  • ARB - Gera registros de data e hora no formato UTC com deslocamento UTC igual a 0. (Este é o padrão.)
  • PTP - Gera registros de data e hora no formato TAI com o valor de deslocamento UTC atual.

• Domínio - Insira um valor de domínio PTP para o servidor de tempo. Todos os relógios que sincronizam com este servidor devem ser configurados com o mesmo valor de domínio. O intervalo é de 0 (o padrão) a 127.

• Prioridade 1 e Prioridade 2 - Insira um valor entre 0 e 248. Valores menores indicam maior prioridade.

• Intervalo de Anúncio de Log - Selecione uma opção na lista suspensa. Este valor logarítmico controla a taxa de pacotes de anúncio PTP do servidor PTP. O padrão é 1, o que indica 1 pacote a cada 2 segundos.

• Intervalo de Sincronização de Logs - Selecione uma opção na lista suspensa. Este valor logarítmico controla a taxa de pacotes de sincronização PTP. O padrão é -4, o que indica 16 pacotes por segundo.

• Intervalo de Solicitação de Atraso de Log - Selecione uma opção na lista suspensa. Este valor logarítmico controla a taxa de pacotes PTP DelayReq. Esta configuração também pode precisar ser especificada no cliente PTP. O padrão é -4, o que indica 16 pacotes por segundo.

• Modo de transporte - Escolha Multicast (padrão), Unicast ou Híbrido.

Portal

Clique em Editar na seção Detalhes de Configuração Avançada para atualizar as Configurações PTP.

API

Para atualizar os detalhes de configuração PTP do seu serviço, envie uma solicitação PATCH para o endpoint /fabric/v4/timeServices/{serviceId}.

No corpo da solicitar, especifique:

• op - replace.
• path - /ptpAdvancedConfiguration.
• value - An object containing your new configuration details.

Exemplo de solicitação cURL:

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/<service_id>'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/ptpAdvancedConfiguration",
    "value": {
      "timeScale": "PTP",
      "domain": 20,
      "priority1": 20,
      "priority2": 20,
      "logAnnounceInterval": 1,
      "logSyncInterval": -4,
      "logDelayReqInterval": -4,
      "transportMode": "UNICAST",
      "grantTime": 300
    }
  }
]'

Detalhes da configuração avançada do NTP

observação

A modificação da configuração avançada do NTP só é compatível com o NTP Enterprise.

Você pode modificar os seguintes detalhes de configuração avançada do NTP:

• Tipo de MD5 - Selecione o tipo de string de chave: ASCII ou HEX.

• Número da chave MD5 - Insira o número da chave. Números inteiros de 1 a 65535 são válidos.

• Chave MD5 - Insira uma chave que contenha de 10 a 40 caracteres:

Portal

Clique em Editar na seção Detalhes de Configuração Avançada para adicionar ou atualizar chaves.

Após efetuar todas as alterações, clique em Enviar.

O número da ordem de serviço é atualizado e, se necessário, a instância é reconfigurada e reaprovisionada.

API

Para atualizar os detalhes de configuração NTP do seu serviço, envie uma solicitação PATCH para o endpoint /fabric/v4/timeServices/{serviceId}.

No corpo da solicitar, especifique:

• op - replace.
• path - /ntpAdvancedConfiguration.
• value - An object containing your new configuration details.

Exemplo de solicitação cURL:

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/<service_id>'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/ntpAdvancedConfiguration",
    "value": [
      {
        "type": "ASCII",
        "keyNumber": 65534,
        "key": "base64-encoded-ascii"
      },
      {
        "type": "HEX",
        "keyNumber": 65535,
        "key": "base64-encoded-hex"
      }
    ]
  }
]'