A API Equinix
A Equinix™ fornece uma API HTTP RESTful que pode ser acessada em https://api.equinix.com/. Este documento descreve a API e como usá-la.
A API permite que você interaja programaticamente com seus recursos Equinix, incluindo projetos, dispositivos, conexões, pedidos, implantações de colocation, tickets de suporte e gerenciamento de Identidade e acesso.
Usando a API Equinix
A utilização da API pode ser dividida em fluxo de autorização e fluxo de requisição.
A interação com produtos Equinix via API requer:
- Conta no Portal do Cliente Equinix ou um Provedor OIDC.
- Permissões específicas do produto para criar, modificar e excluir itens.
Fluxo de autorização do usuário
-
Registre e autorize um pedido no Portal do Cliente.
-
Solicite informações de token de acesso e atualização chamando
/oauth2/v1/tokencom a chave do consumidor, o segredo do consumidor e suas credenciais de usuário .
-
Sua solicitação retorna o token de acesso OAuth de curta duração e o token de atualização associado.
Para obter mais informações e instruções mais detalhadas, consulte Autenticação de API.
Fluxo de autorização de token OIDC
-
Create an OIDC Provider in either the Customer Portal or the Equinix API.
-
Solicite acesso chamando o endpoint
/v1/tokencom seu token de provedor de identidade e escopo.
- Sua solicitação retorna o token de acesso de curta duração.
Para obter mais informações, consulte Autenticação da API OIDC.
O fluxo de solicitação
-
Usando um token de acesso OAuth válido para autorizar uma solicitação, faça uma chamada para um ponto de extremidade da API com o cabeçalho de autorização necessário.
-
O gateway de API valida a solicitação e chama a API Equinix relevante.
-
A resposta é recebida pelo gateway da API.
-
A resposta é enviada de volta para você.
Infraestrutura como código com Terraform
Além da API REST, a Equinix também fornece um provedor Terraform que permite gerenciar recursos da Equinix usando infraestrutura como código. O provedor Terraform encapsula a API da Equinix e fornece uma maneira declarativa de definir e gerenciar sua infraestrutura.
O provedor Terraform da Equinix oferece suporte a:
- Equinix Metal - Servidores bare metal, redes e infraestrutura
- Equinix Fabric - Conexões virtuais, roteadores em nuvem, fluxos de dados e tempo de precisão.
- Borda da Rede - Dispositivos de rede virtuais
Para obter documentação completa, exemplos e recursos disponíveis, consulte a Documentação do provedor Terraform.
Referências de API
A API Equinix é organizada em grupos funcionais versionados. Cada grupo funcional contém um conjunto de endpoints de API que você executar operações relacionadas a esse grupo.
As referências de API são fornecidas no formato OpenAPI, que inclui informações detalhadas sobre cada endpoint, incluindo os formatos de solicitar e resposta, parâmetros necessários e exemplos de solicitações. Ao longo da Documentação do Produto Equinix, você encontrará links para a "Referência de API " correspondente ao produto ou serviço em questão.
Para visualizar uma biblioteca de todas as Referências de API da Equinix por grupos funcionais, consulte o Catálogo de APIs. Você também pode encontrar links para todas as Referências de API da Equinix usando a seguinte árvore de navegação. Cada caminho de API principal está vinculado à sua Referência de API correspondente nesta visualização.