Solicitar acesso à Internet com uma porta de tecido
O Equinix Internet Access (EIA) oferece acesso híbrido à internet, utilizando múltiplos provedores de serviços de internet (ISPs) de nível 1 e pontos de troca de internet (IXs) da Equinix para proporcionar alta disponibilidade, confiabilidade e velocidade.
- A conexão Fabric entre sua porta Fabric e o perfil de serviço de acesso à Internet da Equinix é fornecida gratuitamente.
- Ao desprovisionar sua instância de serviço de acesso à Internet , a conexão Fabric associada também é desprovisionada.
- Caso haja algum problema com o provisionamento de uma instância do serviço de Acesso à Internet, a conexão Fabric associada será desprovisionada automaticamente.
O Equinix Internet Access com Fabric está disponível para organizações integradas ao Gerenciamento de identidade e acesso Equinix , e a conta usada para enviar solicitações API deve ter a Equinix Fabric Manager função.
Se sua organização não foi integrada ao Gerenciamento de identidade e acesso Equinix, você pode solicitar Equinix Internet Access com porta dedicada .
Pré-requisitos
-
Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. autenticação. Consulte Autenticação API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.
-
Determine as informações do A-Side. Para obter as informações da porta do Fabric, envie uma
GETsolicitação para o/fabric/v4/portsendpoint. Você precisa do(s) UUID(s) da porta, o tipo de protocolo de link (DOT1Q ou QINQ). Se você estiver criando uma conexão redundante, escolha umaPRIMARYporta e umaSECONDARYporta. Você precisa dessas informações para a solicitação de criação de conexão. -
Determine as informações do Z-Side. O perfil de serviço de acesso à Internet é do tipo
IA_PROFILEe seu ID é32d81829-0bf8-45d5-84e2-7289a553dbb6. Para determinar a localização metropolitana do seu serviço, envie umaGETsolicitação ao/internetAccess/v2/ibxsterminal para encontrar os locais onde o acesso à Internet está disponível. Você precisa dessas informações para solicitar seu serviço de acesso à Internet.
Criando uma conexão de acesso à Internet
Para criar a conexão para seu serviço de acesso à Internet, envie uma POST solicitação para o /fabric/v4/connections terminal. A conexão type é IA_VC.
Forneça suas informações de porta no aSideobjeto, incluindo:
-
accessPoint.typecomoCOLO -
Forneça o UUID da sua porta para
port.uuidSe você estiver se conectando a partir de uma porta Dot1q:
- LinkProtocol.type como
DOT1Q - Forneça o ID do VLAN para
linkProtocol.vlanTag
Se você estiver se conectando a partir de uma porta QinQ:
- LinkProtocol.type como
QINQ - Forneça o ID da tag interna para
linkProtocol.vlanCTag - Forneça o ID da tag externa para
linkProtocol.vlanSTag
- LinkProtocol.type como
-
Se você estiver criando conexões redundantes, faça duas solicitações. Uma solicitação deve ter sua porta primária e
redundancy.prioritydefinida comoPRIMARYe a outra sua porta secundária eredundancy.prioritydefinida comoSECONDARYe você deve especificar como o UUID da primeira conexão.redundancy.group
Forneça o perfil de serviço de acesso à Internet no zSideobjeto, incluindo:
accessPoint.typeasSP.profile.typecomoIA_PROFILEprofile.uuidcomo32d81829-0bf8-45d5-84e2-7289a553dbb6metroCodeComo o código estratégico de duas letras do metrô de acesso à Internet ao qual você está se conectando.
Exemplos de requisições cURL:
Exemplo de conexão primária
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"type": "IA_VC",
"name": "<your_connection_name>",
"bandwidth": <connection_speed>,
"redundancy": {
"priority": "PRIMARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "<your_port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "IA_PROFILE",
"uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
},
"location": {
"metroCode": "<metro_code>"
}
}
},
"project": {
"projectId": "<project_id>"
},
"order": {
"purchaseOrderNumber": "<purchase_order_number>"
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>"
]
}
]
}'
Exemplo de conexão secundária
curl -X POST 'https://api.equinix.com/fabric/v4/connections' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"type": "IA_VC",
"name": "<your_connection_name>",
"bandwidth": <connection_speed>,
"redundancy": {
"priority": "SECONDARY",
"group": "<primary_connection_uuid>"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "<your_port_uuid>"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": <vlan_id>
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"type": "IA_PROFILE",
"uuid": "32d81829-0bf8-45d5-84e2-7289a553dbb6"
},
"location": {
"metroCode": "<metro_code>"
}
}
},
"project": {
"projectId": "<project_id>"
},
"order": {
"purchaseOrderNumber": "<purchase_order_number>"
},
"notifications": [
{
"type": "ALL",
"emails": [
"<contact_email>"
]
}
]
}'
A resposta contém um uuid que é o ID de conexão do seu serviço de acesso à Internet. Você deve ter esse UUID de conexão para solicitar o serviço de acesso à Internet.
Serviço de encomenda com bloco de IP atribuído pelo fornecedor
Para solicitar seu serviço de acesso à Internet, envie uma POST solicitação para o /internetAccess/v2/services terminal.
Para redundância, se você criou duas conexões para seu serviço, defina type como DUALe forneça ambas as IDS de conexão ao connectionsarray.
Se você criou uma conexão única para seu serviço, defina type como SINGLE e forneça o ID da conexão ao connectionsarray.
No routingProtocolobjeto, especifique:
- Seu
routingProtocol.typedeSTATIC,DIRECTouBGP. - Ao solicitar seu serviço usando blocos IP de propriedade da Equinix (PA), defina o
ipBlock.prefixLengthvalor para o tamanho do bloco IP necessário.
Ao solicitar uma instância de serviço EIA localizada em um de nossos data centers IBX na região APAC, certifique-se de adicionar as addressingPlansinformações e questionsao ipBlockobjeto em caso de bloco IPv4 PA. Consulte a referência do API para obter mais informações.
Roteamento Estático
A documentação sobre o roteamento estático pode ser encontrada aqui.
Exemplos de requisições cURL:
Exemplo de serviço estático único na região da Ásia-Pacífico
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>,
"addressingPlans": [
{
"afterThreeMonths": <number_of_ip_addresses_used_after_three_months>,
"immediate": <number_of_ip_addresses_used_instantly>,
"purpose": "<purpose_of_ip_block>",
"size": <number_of_ip_addresses_requested>
}
],
"questions": [
{
"answer": "YES",
"type": "PRIVATE_SPACE_CONSIDERED"
},
{
"answer": "NO",
"type": "REFUSED_PREVIOUSLY"
},
{
"answer": "NO",
"type": "RETURNING_ADDRESS_SPACE"
}
]
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemplo de serviço estático duplo
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Roteamento direto
A documentação sobre o roteamento direto pode ser encontrada aqui.
Exemplos de requisições cURL:
Exemplo de Serviço Direto Único
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemplo de serviço direto duplo
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Roteamento BGP
Especifique os detalhes da configuração do BGP no routingProtocolobjeto:
- Quais rotas você deseja anunciar para a Internet,
FULL,DEFAULT,FULL_DEFAULTouPARTIALemroutingProtocol.exportPolicy. - Forneça o intervalo de ASN do cliente BITS_16 para ASN de 16 bits ou BITS_32 para ASN de 32 bits em
routingProtocol.customerAsnRange. - Forneça bgpAuthKey em
routingProtocol.bgpAuthKey, se necessário.
A documentação sobre roteamento BGP pode ser encontrada aqui.
Exemplos de requisições cURL:
Exemplo de serviço BGP único
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "My Internet Access Service",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemplo de serviço BGP duplo
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Serviço de pedidos com bloqueio de IP independente do provedor
Ao solicitar seu serviço usando seu próprio bloco IP (PI), especifique-o em customerRoutes.prefix
Roteamento Estático
Exemplos de requisições cURL:
Exemplo de serviço estático único
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemplo de serviço estático duplo
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Roteamento direto
Especifique quais IPs do seu bloco IP podem ser usados para fins de peering no peeringobjeto.
Para o tipo de serviço único, forneça apenas um endereço IP no equinixPeerIpsarray.
Para o tipo de serviço Duplo, forneça dois endereços IP no equinixPeerIpsarray e o endereço IP do VRRP no equinixVRRPIp campo.
Exemplos de requisições cURL:
Exemplo de Serviço Direto Único
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>"
]
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>"
]
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemplo de serviço direto duplo
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "DIRECT",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>",
"<peering_ip_address>"
],
"equinixVRRPIp": "<virtual_router_group_ip_address>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
],
"peerings": [
{
"equinixPeerIps": [
"<peering_ip_address>",
"<peering_ip_address>"
],
"equinixVRRPIp": "<virtual_router_group_ip_address>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Roteamento BGP
Exemplos de requisições cURL:
Exemplo de serviço BGP único
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Exemplo de serviço BGP duplo
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "DUAL",
"connections": [
"<connection_uuid1>", "<connection_uuid2>"
],
"routingProtocol": {
"type": "BGP",
"customerAsnRange": "<asn_range>",
"bgpAuthKey": "<bgp_auth_key>",
"exportPolicy": "<route_advertisement_code>",
"ipv4": {
"customerRoutes": [
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Serviço de encomenda com blocos IP PA e PI
Ao solicitar seu serviço com blocos de IP atribuídos pelo provedor (PA) e independentes do provedor (PI), especifique dois ou mais objetos de rota do cliente com os campos apropriados:
ipBlock.prefixLengthNo caso de bloco IP (PA) fornecido pela Equinix.customerRoutes.prefixNo caso de usar seu próprio bloco IP (PI).
É possível solicitar vários blocos de IP apenas com os protocolos de roteamento estático e BGP.
Exemplos de requisições cURL:
Exemplo de blocos de IP atribuídos e independentes do provedor
curl -X POST 'https://api.equinix.com/internetAccess/v2/services' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"name": "<your_service_name>",
"type": "SINGLE",
"connections": [
"<connection_uuid>"
],
"routingProtocol": {
"type": "STATIC",
"ipv4": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv4_ip_block>
}
},
{
"prefix": "<your_ipv4_ip_block>"
}
]
},
"ipv6": {
"customerRoutes": [
{
"ipBlock": {
"prefixLength": <size_of_ipv6_ip_block>
}
},
{
"prefix": "<your_ipv6_ip_block>"
}
]
}
},
"order": {
"purchaseOrder": {
"number": "<purchase_order_number>"
}
}
}'
Monitorando suas solicitações
Para ver o status da sua solicitação de criação de conexão, envie uma GET solicitação para o fabric/v4/connections/{connectionId} terminal.
Para ver os detalhes do seu serviço de acesso à Internet, use o internetAccess/v2/services/{serviceId} terminal.
Caso ocorra algum problema com o provisionamento da sua instância de serviço de Acesso à Internet, a conexão associada será desprovisionada automaticamente.