Instalações (obsoleto)

Em maio de 2023, o Equinix Metal ™ descontinuará endpoints e suporte de API específicos para cada instalação. Todos os conceitos relacionados à localização, incluindo o provisionamento de dispositivos e outras infraestruturas, serão transferidos para o nível área metropolitana .

A partir de May 30th, 2023:

• A API retorna cabeçalhos de resposta contendo mensagens de descontinuação e desativação para solicitações enviadas a pontos de extremidade de instalações ou solicitações que usam instalações em seus parâmetros.
• Novas organizações (aquelas criadas após 30 de maio) não terão acesso aos pontos de extremidade das instalações nem poderão usar as instalações em seus parâmetros de solicitar .

O uso de endpoints específicos das instalações e parâmetros de solicitar será desativado permanentemente para todos os usuários no final de 2023.

Encontrando informações gerais sobre o área metropolitana

Com a descontinuação dos endpoints de Facilities, as respostas às seguintes solicitações de CLI e API retornarão cabeçalhos de resposta contendo informações sobre a descontinuação. Atualize todos os scripts ou automações que utilizam esses endpoints para consultar o Metros.

• O comando metal facilities get.
• O ponto final /facilities.
• O ponto final /projects/{id}/facilities.
• O ponto final /organizations/{id}/facilities.

Em vez disso, use os seguintes comandos e endpoints para Metros.

• O comando metal metros get.
• O endpoint /locations/metros.
• O endpoint /locations/metros/{id}.

Observação: todos os metrôs são visíveis para todas as organizações e projetos.

Provisionamento

Com a descontinuação dos endpoints do Facilities, as respostas às seguintes solicitações de CLI e API retornarão cabeçalhos de resposta contendo informações sobre a descontinuação. Atualize todos os scripts ou automações que utilizam esses endpoints para provisionar usando Metros.

CLI

Ao você o comando metal device create, use o parâmetro --metro ou -m para especificar o área metropolitana em vez de uma instalação.

metal device create -p $METAL_PROJECT_ID -P <plan> -m <metro> -H <hostname> -O <operating_system>

API

Ao você o endpoint de solicitar de provisionamento POST projects/{id}/devices, use o campo "metro" com o metro_code onde você deseja que o servidor fique em vez de especificar uma Facility.

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/devices" \
-d '{
    "metro": "<metro_code>",
    "plan": "<server_type>",
    "operating_system": "<os_code>"
}'

Observação: "metro" aceita apenas um tipo string. "facilities costumava aceitar uma string ou um array de strings.

Usando metrôs em vez de instalações

Semelhante ao provisionamento de servidores sob demanda, outras opções de implantação e características de plataforma que anteriormente suportavam o provisionamento em instalações específicas retornarão cabeçalhos de resposta indicando sua descontinuação.

Atualize seus scripts ou automações para usar Metros no lugar de recursos na CLI ou API.

Atenção: o uso do parâmetro "facilities" é mutuamente exclusivo do parâmetro "metros"; não é possível usar ambos.

Consultas de capacidade

Com a descontinuação dos endpoints de Facilities, as respostas às seguintes solicitações de CLI e API retornarão cabeçalhos de resposta contendo informações sobre a descontinuação. Atualize quaisquer scripts ou automações que usem esses endpoints para consultar área metropolitana capacidade em vez disso.

• O comando metal capacity quando usado com uma Facility em vez de um área metropolitana.
• O comando metal capacity check quando usado com uma Facility em vez de um área metropolitana.
• O endpoint /capacity.

Em qual área metropolitana ou instalação meu servidor está?

As respostas para servidores e outras infraestruturas que contêm um objeto "facilities" continuarão a retorná-lo. Para infraestruturas provisionadas no nível Metro, o objeto "facilities" pode estar vazio.

Todas as respostas contêm um objeto "metro", para identificar em qual área metropolitana ela está provisionada.

Você ainda pode descobrir em qual Facility seu servidor está localizado, mas você que a diversidade em nível de facility não oferece garantias de alta disponibilidade ou redundância . Para instalar e configurar a alta disponibilidade, você deve buscar uma arquitetura multi-metro.

CLI

Use o comando metal device e especifique que você uma resposta JSON usando o sinalizador de saída -o.

metal device get -i <device_id> -o json

API

Envie uma solicitar GET para o endpoint devices/{id}.

curl -X GET -H 'X-Auth-Token: <API_TOKEN>' https://api.equinix.com/metal/v1/devices/{id}

Tanto a CLI quanto a API retornam uma resposta que inclui um objeto "facility". Exemplo de resposta:

{
"id": "0dd71771-143e-4964-87d2-7e6f0348253a",
...
 "facility": {
    "id": "917e9941-8323-487f-8688-2b0b11baacd4",
    "name": "Silicon Valley",
    "code": "sv15",
    "features": [
      "baremetal",
      "backend_transfer",
      "layer_2",
      "global_ipv4",
      "ibx"
    ],
    "address": {
      ...
      }
    },
    "metro": {
      "id": "2991b022-b8c4-497e-8db7-5a407c3a209b",
      "name": "Silicon Valley",
      "code": "sv",
      "country": "US"
    }
  },
...
}