Gerenciando a conectividade com as APIs da Megaport como provedor de serviços
Os provedores de serviços podem integrar perfeitamente as funcionalidades da Megaport à sua plataforma. Eles podem controlar o acesso dos clientes aos seus on-ramps, como Ports.
Os provedores de serviços podem usar uma chave de serviço para gerenciar o acesso do cliente e proteger a conectividade aos seus on-ramps. Eles podem definir limites de taxa específicos e segmentar o tráfego dos clientes usando VLANs.
Uma chave de serviço é um código fornecido por um titular de conta da Megaport a outro para conectar duas empresas distintas entre si. Clientes que possuem contas separadas da Megaport podem conectar seus Ports, MCRs ou MVEs entre si pela rede da Megaport, possibilitando VXCs entre empresas.
Antes de permitir que seus clientes se conectem a um on-ramp usando uma chave de serviço, um provedor de serviços deve primeiro se conectar à rede da Megaport. Depois de conectados, eles devem:
- decidir quais de suas conexões devem ser usadas como on-ramps
- mapear esses locais de on-ramp para suas regiões ou zonas definidas pelo usuário
- considerar a capacidade e as zonas de diversidade para o gerenciamento de redundância
Este tópico descreve como você, como provedor de serviços, pode usar as APIs da Megaport para reduzir o esforço manual e permitir um provisionamento mais rápido de serviços. Isso facilitará a venda de conectividade privada para seus clientes.
Cenário
A QuantumGPU é uma pequena empresa provedora de serviços, com sede em Los Angeles, Califórnia, atuando como uma plataforma de GPU como Serviço (GPUaaS) self-service e sob demanda. Ao capacitar empresas com computação acelerada por GPU em diversas localidades geográficas, a QuantumGPU opera os seguintes Ports:
- 2 Ports em Los Angeles, EUA (Equinix LA1 e CoreSite LA1)
- 1 Port em Nova York, Estados Unidos (Telehouse)
- 1 Port em Londres, Reino Unido (Telehouse North)
- 1 Port em Osaka, Japão (Equinix OS1)
- 1 Port em Sydney, Austrália (Global Switch Sydney West)
A QuantumGPU precisa controlar como seus clientes se conectam aos Ports e automatizar o processo com APIs.
A QuantumGPU (provedor de serviços) planeja implementar o seguinte cenário:
Termos relacionados
Certifique-se de que você está familiarizado com a terminologia a seguir usada neste tópico:
Megaport Cloud Router (MCR)
O MCR é um serviço de roteador virtual gerenciado que estabelece conectividade de Camada 3 na rede definida por software (SDN) global da Megaport. As instâncias do MCR são pré-configuradas em data centers nas principais zonas globais de roteamento. Um MCR permite a transferência de dados entre redes multicloud ou de cloud híbrida, provedores de serviços de rede e provedores de serviços de cloud.
Megaport Virtual Edge (MVE)
O MVE é uma plataforma de Virtualização de Funções de Rede (NFV) sob demanda, agnóstica a fornecedores, que fornece infraestrutura virtual para serviços de rede na borda da rede global definida por software (SDN) da Megaport. Tecnologias de rede como SD-WAN e NGFW são hospedadas diretamente na rede global da Megaport via Megaport Virtual Edge.
On-ramp
Um on-ramp é uma conexão direta e privada aos recursos disponíveis de um provedor de serviços, por exemplo, por meio de uma conexão Megaport. Para garantir conexões rápidas e confiáveis, o provedor de serviços mapeia esses recursos para suas regiões ou zonas, define limites de taxa, gerencia a capacidade de VLAN por cliente e assim por diante.
Port
Uma Port é a interface Ethernet de alta velocidade que se conecta à rede global definida por software (SDN) da Megaport. Ports estão disponíveis em 1 Gbps, 10 Gbps, 100 Gbps, ou opções de velocidade superior, dependendo da localização e da disponibilidade do serviço.
Diversidade de Port
A diversidade de Port melhora a robustez da sua rede ao fornecer serviços de Port em diferentes dispositivos físicos em um único local da Megaport. Os Ports são atribuídos a zonas de diversidade. Uma zona de diversidade agrupa dispositivos no mesmo local para garantir que os serviços sejam provisionados em dispositivos fisicamente separados que permaneçam sempre diversos.
Chave de serviço
Uma chave de serviço é um código fornecido por um titular de conta da Megaport a outro para conectar duas empresas distintas entre si. Clientes que possuem contas separadas da Megaport podem conectar seus Ports, MCRs ou MVEs entre si pela rede da Megaport, possibilitando VXCs entre empresas.
Virtual Cross Connect (VXC)
Uma VXC é um circuito Ethernet de Camada 2 direto que fornece conexões privadas, flexíveis e sob demanda entre quaisquer locais na rede da Megaport, oferecendo capacidades que variam de 1 Mbps até altas velocidades multi-Gbps, com níveis mais altos disponíveis em regiões selecionadas.
Autenticando como usuário de API
Antes de poder usar as APIs da Megaport, você deve se autenticar com um token de acesso. Antes de gerar o token de acesso, você deve criar uma chave de API no Megaport Portal. Para mais informações, veja Criando uma chave de API.
A chave de API consiste em um ID de cliente e um segredo de cliente. Você pode usá-la para gerar o token de acesso usado para se autenticar como usuário de API.
Os tokens de acesso são válidos por 24 horas e devem ser gerados novamente após esse período. Sua integração com a API da Megaport precisará levar isso em consideração. Para mais informações, veja Gerando um token de acesso.
Gerenciando on-ramps
Quando seu cliente solicitar uma conexão com você, será necessário mapear a região ou zona da conexão para um on-ramp físico para gerar a chave de serviço.
Esta seção descreve as chamadas de API para mapear a região ou zona de serviço dos seus usuários para o seu on-ramp da Megaport. Os identificadores de local e de produto da Megaport são constantes, portanto isso pode ser armazenado em cache ou salvo com segurança sem a necessidade de atualizar todas as vezes.
Estas instruções descrevem como fazer isso usando o Postman e a coleção de APIs da Megaport. Para mais informações sobre a configuração do Postman, veja Visão geral da API do Megaport.
Pré-requisitos
Esta seção pressupõe que você:
- já integrou a Megaport à sua plataforma. Para mais informações, veja Integrando Megaport à sua plataforma.
- está autenticado como usuário de API. Para mais informações, veja Autenticando como usuário de API.
Listando locais de on-ramp
Esta tarefa descreve como consultar e listar seus locais de on-ramp disponíveis (locais de Port no nosso cenário) usando os identificadores de local.
Para listar locais de on-ramp
Nota
Este exemplo usa Ports, mas você também pode usar MCRs e MVEs.
-
Depois que seu cliente solicitar a conexão a um on-ramp, por exemplo, a um Port, use a Get Product List API (API Obter lista de produtos) com
"provisioningStatus": "LIVE"para consultar todos os Ports ativos que você possui.GET /v2/products?provisioningStatus=LIVE -
Filtre e liste a resposta usando o valor country.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"No nosso cenário, a lista é a seguinte:
- USA
- UK
- Japan
- Australia
-
Depois que seu cliente selecionar uma região (USA), filtre e liste a resposta no valor metro.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"No nosso cenário, a lista é a seguinte:
- Los Angeles
- New York
-
Depois que seu cliente selecionar uma região (US-West), filtre e liste a resposta no valor locationId.
"locationId": 60, "location": "CoreSite LA1", "locationDetail": { "name": "CoreSite LA1", "city": "Los Angeles", "metro": "Los Angeles", "country": "USA"No nosso cenário, a lista é a seguinte:
- “locationId”: 59
- “locationId”: 60
Mapeando um local de on-ramp para uma região ou zona definida pelo usuário
Você pode usar os identificadores de local listados, como locationId, metro ou country, e mapeá-los para os nomes personalizados de região ou zona que você definiu previamente.
Ao mapear os on-ramps disponíveis, como Los Angeles 1 (“locationId”: 59) e Los Angeles 2 (“locationId”: 60), para a região US-West predefinida, seus clientes podem selecionar US-West na sua plataforma e se conectar a um on-ramp disponível.
Selecionando um on-ramp
Você pode usar APIs para identificar a qual on-ramp se conectar, por exemplo, para se conectar ao Port com menor uso. Você pode considerar fatores como número de conexões, capacidade ou utilização. Além disso, pode considerar fatores como zonas de diversidade para gerenciar a redundância.
Use a resposta dos Ports filtrados para considerar os atributos do Port conforme a seguir:
| Atributo | Considerar |
|---|---|
| diversityZone | Verifique se o local atual oferece suporte a diversidade. Para mais informações, veja Diversidade de Port. |
| portSpeed | Verifique a velocidade disponível do Port. |
| rateLimit | O limite de taxa do VXC não pode exceder a velocidade do Port de menor velocidade. Para mais informações, veja Visão geral de conexões. |
| associatedVxcs | Verifique se VXCs estão associados ao Port e a capacidade alocada. |
| maxVxcSpeed | Verifique a velocidade máxima do VXC disponível para o Port. |
| vxcPermitted | Garanta que vxcPermitted seja true. Se o valor de vxcPermitted for false, você não pode criar um VXC para esse Port. |
Depois de considerar os Ports selecionados, você pode exibir um Port que atenda aos critérios necessários, por exemplo, um Port com menor uso. Para mais informações, veja Visão geral da API do Megaport.
Gerenciando conexões
Seguindo as melhores práticas no gerenciamento de chaves de serviço e IDs de VLAN, você pode manter conexões organizadas e seguras.
Gerenciando chaves de serviço
As chaves de serviço permitem que seus clientes estabeleçam conexões com seus on-ramps específicos.
Gerenciar chaves de serviço envolve criar, compartilhar e monitorar as chaves de serviço.
Esse processo é mostrado e explicado em mais detalhes a seguir:
Depois de selecionar o serviço de on-ramp, você pode criar uma chave de serviço para o on-ramp. Criar a chave de serviço não tem custo extra para você, independentemente de seu cliente usar a chave ou não.
Compartilhe a chave de serviço com seu cliente. Opcionalmente, crie um fluxo de trabalho para seu cliente, descrevendo as etapas necessárias e um prazo indicativo para usar a chave de serviço recebida.
Como pré-requisito, seu cliente deve ter uma conta na Megaport e um Port disponível.
Usando a chave de serviço, seu cliente pode criar um VXC e se conectar ao on-ramp com base nos parâmetros que você especificou. Seu cliente é responsável pelas cobranças do VXC associadas ao local do on-ramp selecionado.
Use a API GET List Service Keys (Listar chaves de serviço) para monitorar continuamente e acompanhar o status das suas chaves de serviço. Por exemplo, verifique se uma chave de serviço que você criou e enviou a um cliente foi utilizada. Depois que seu cliente usa a chave de serviço, ela se torna obsoleta e o ID da chave de serviço não é mantido. Isso significa que não há conexão entre a chave de serviço e o serviço que ela ativou.
A chave de serviço é específica do serviço. Para garantir redundância e resiliência em caso de falhas ou interrupções, recomendamos que você crie on-ramps localizados em diferentes zonas de diversidade. Nesse caso, você também deve criar chaves de serviço separadas para cada on-ramp, por exemplo:
- 1 chave para Los Angeles 1 na zona de diversidade azul
- 1 chave para Los Angeles 2 na zona de diversidade vermelha
Você pode criar uma chave de serviço de uso único ou de uso múltiplo. Com uma chave de serviço de uso único, o cliente com quem você compartilha a chave pode solicitar uma única conexão para um on-ramp específico. Com uma chave de uso múltiplo, o cliente com quem você compartilha a chave pode solicitar várias conexões. Nesses casos, o sistema aloca automaticamente o próximo ID de VLAN disponível.
Gerenciando IDs de VLAN
Para chaves de serviço de uso único, especifique um ID de VLAN, que você pode usar para vincular os clientes aos respectivos VXCs. Ao atribuir um ID de VLAN à chave de serviço, isso indica que o VXC atribuído é dedicado a um cliente específico. Cada VXC é entregue como uma VLAN separada no seu on-ramp. Esse deve ser um ID de VLAN exclusivo nesse on-ramp e pode variar de 2 a 4093.
A imagem abaixo mostra que você atribuiu IDs de VLAN diferentes para cada cliente da seguinte forma:
- ID de VLAN 100 atribuído ao Cliente 1
- ID de VLAN 200 atribuído ao Cliente 2
Os IDs de VLAN (100 e 200) atribuídos por você podem diferir dos IDs de VLAN atribuídos pelos seus clientes (123 e 10) ou dos IDs de VLAN atribuídos a outras conexões de Port que eles tenham, como aquelas para provedores de cloud como AWS, Oracle ou Azure (124, 125 e 20).
Para mais informações, veja Configurando chaves de serviço e Criando uma chave de serviço com a API.
Resumo
Este tópico descreveu como você pode gerenciar com eficiência as conexões dos clientes aos seus on-ramps.
Usando as APIs da Megaport, para consultar Ports, selecionar Ports com base em capacidade, diversidade e assim por diante, você pode automatizar o processo, reduzindo o esforço manual e possibilitando um provisionamento rápido de serviços.
Resumo das APIs usadas
Esta tabela mostra o processo e as APIs usadas neste cenário:
Nota
Este exemplo usa Ports, mas o mesmo processo é usado para MCRs e MVEs.
| Ação do cliente do provedor de serviços | Ação do provedor de serviços | Solicitações de API e valores usados para filtragem | Resultado |
|---|---|---|---|
| Na plataforma do provedor de serviços, solicite uma conexão para um on-ramp. | Listar regiões com Ports ativos, MCRs ou MVEs. | GET /v2/products? provisioningStatus=LIVE Listar valores "country". |
|
| Selecione uma região (EUA). | Listar cidades com Ports ativos, MCRs ou MVEs nos EUA. | GET /v2/products? provisioningStatus=LIVE &country=USA Listar valores “metro". |
|
| Listar Ports em Los Angeles. Mapear os Ports disponíveis, por exemplo, Los Angeles 1 (“locationId”: 59) e Los Angeles 2 (“locationId”: 60), para uma região chamada US-West. Em seguida, na sua plataforma, seus clientes podem se conectar a um dos Ports disponíveis em US-West. Decidir qual on-ramp oferecer ao cliente. Considerar capacidade/uso e diversidade. |
GET /v2/products? provisioningStatus=LIVE &country=USA&metro=Los Angeles Listar valores "locationId". |
|
|
| Selecione US-West e adicione diversidade. | Criar chaves de serviço para os Ports selecionados. Enviar as chaves de serviço de volta ao seu cliente. |
POST /v2/service/key Valor obrigatório: "productUid" |
2 chaves separadas são criadas para:
“key”: “106e38ae-eb59-415f-ac81-526a5299851d”, |
| Criar conexões com as chaves de serviço. |
Integrando Megaport à sua plataforma
Para um exemplo de como integrar a Megaport à sua plataforma, veja o projeto de demonstração em https://github.com/megaport/megaportgo.