Pular para conteúdo
Documentação da Megaport
Criando uma Port
PDF

Criando uma Porta com a API

Este tópico descreve o processo para criar uma Porta, incluindo como pesquisar locais de Portas, validar a Porta e determinar seu custo, fazer o pedido da Porta, e baixar um LOA. um exemplo em cURL aparece depois do exemplo no Postman.

Antes de começar, obtenha um token de acesso válido. Para mais informações, veja Criando uma Chave API.

Para procurar detalhes de local de Porta na coleção do Postman

  1. Clique em Localizações no menu de navegação à esquerda e clique em Obter Locais.
    Essa solicitação não espera informações em Parameters ou Body.

  2. Clique em Enviar para fazer a solicitação.

    GET {baseUrl}/v2/locations

    Obter locais

    Certifique-se de que a solicitação teve sucesso procurando por Status: 200 OK e mostre a resposta na seção Body no formato Pretty.

    A solicitação retorna centenas de locais de Portas. Você pode pesquisar clicando na lupa e inserindo uma cidade, data center, ou outro parâmetro específico no campo de busca. Este exemplo usa o local Digital Realty, London. 

    {
            "country": "United Kingdom",
            "liveDate": 1467331200000,
            "siteCode": "lon-tc1",
            "networkRegion": "MP1",
            "address": {
                "country": "United Kingdom",
                "city": "London",
                "street": "227 Marsh Wall",
                "postcode": "E14 9SD",
                "suburb": null,
                "state": null
            },
            "campus": "campus_deprecated",
            "latitude": 51.499714,
            "products": {
                "mcr": false,
                "megaport": [
                    1,
                    10,
                    100
                ]
            },
            "market": "UK",
            "metro": "London",
            "name": "Digital Realty LHR20",
            "vRouterAvailable": false,
            "id": 89,
            "dc": {
                "name": "Digital Telx",
                "id": 3
            },
            "status": "Active",
            "longitude": -0.012144,
            "ordering_message": null
        }

Para criar uma Porta, você precisa do valor market e do valor id. Neste exemplo, o market é UK e o ID do data center é 89.

Para testar e validar o pedido da Porta

  1. No Postman, abra a pasta Ports no menu de navegação à esquerda e selecione POST Validate Port Order (v3).

  2. Atualize o Body com o locationId (89), term (número de meses - 1, 12, 24, ou 36), productName (o nome que você quiser dar à sua Porta), portSpeed (1000, 10000, ou 100000 Mbps), e market (UK) e clique em Send. 

[
  {
    "locationId": 89,
    "term": 1,
    "locationUid": null,
    "productName": "API Port",
    "productType": "MEGAPORT",
    "createDate": 1452475039656,
    "portSpeed": 1000,
    "virtual": false,
    "market": "UK"
  }
]

Uma resposta de sucesso passa a validação e tem status de 200 OK. A resposta também incluirá detalhes de preço para o serviço.

{
    "message": "Validação aprovada",
    "terms": "Esses dados estão sujeitos à Política de Uso Aceitável https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "price": {
                "hourlySetup": 0,
                "dailySetup": 0,
                "monthlySetup": 0,
                "hourlyRate": 0,
                "dailyRate": 0,
                "monthlyRate": 500.00,
                "fixedRecurringCharge": 500.00,
                "postPaidBaseRate": "no base rate",
                "longHaulMbpsRate": 0,
                "mbpsRate": 0,
                "currency": "GBP",
                "key": "no key",
                "productType": "MEGAPORT",
                "empty": false
            },
            "serviceName": "API Port",
            "productType": "MEGAPORT",
            "productUid": "f9859fd3-344d-4a33-8cd2-a3b6ebfaaef0",
            "market": "UK",
            "string": "London"
        }
    ]
}

Para encomendar a Porta validada

  1. Com uma solicitação de Porta validada e após ter revisado as informações de custo, copie o Body de POST Validate Port Order (v3) e cole-o no Body de POST Buy Port (v3).

    Importante

    Se você fizer esse chamado no api.megaport.com, sua conta será cobrada pelo serviço. Alternativamente, você pode provisionar contra a API de teste (staging) sem cobrança, como nesses exemplos.

  2. Envie a solicitação.
    Uma resposta de sucesso inclui um technicalServiceUid, que é o mesmo do productId e do productUid.
    No nosso exemplo, esse valor é a49cf3f1-20a1-4390-93aa-5005bdafe3d7.

{
    "message": "MEGAPORT [a49cf3f1-20a1-4390-93aa-5005bdafe3d7] criar. ",
    "terms": "Esses dados estão sujeitos à Política de Uso Aceitável. https://www.megaport.com/legal/acceptable-use-policy",
    "data": [
        {
            "serviceName": "API Port",
            "name": "API Port",
            "secondaryName": null,
            "technicalServiceId": 68124,
            "technicalServiceUid": "a49cf3f1-20a1-4390-93aa-5005bdafe3d7",
            "requestedDate": 1588862976322,
            "configuredDate": null,
            "currentEstimatedDelivery": null,
            "companyName": "Megaport Lab",
            "companyId": 2278,
            "aggregationId": null,
            "lagPrimary": false,
            "billingContactName": null,
            "billingContactId": null,
            "adminContactName": null,
            "adminContactId": null,
            "technicalContactName": null,
            "technicalContactId": null,
            "salesName": null,
            "salesId": null,
            "billableId": 56333,
            "billableUsageAlgorithm": "NOT_POST_PAID",
            "productType": "MEGAPORT",
            "provisioningStatus": "DEPLOYABLE",
            "inAdvanceBillingStatus": "NOT_ACTIVATED",
            "provisioningItems": [],
            "tags": [],
            "vxcDistanceBand": null,
            "intercapPath": null,
            "marketplaceVisibility": true,
            "vxcPermitted": true,
            "vxcAutoApproval": false,
            "createDate": 1588862976322,
            "terminationDate": null,
            "contractStartDate": 1588860000000,
            "contractTermMonths": 1,
            "rateType": "MONTHLY",
            "trialAgreement": false,
            "payerCompanyId": null,
            "nonPayerCompanyId": null,
            "minimumSpeed": null,
            "maximumSpeed": null,
            "rateLimit": 10000,
            "errorMessage": null,
            "market": "UK",
            "accountManager": null,
            "promptUid": null,
            "components": [],
            "attributes": [],
            "aLocation": null,
            "bLocation": null,
            "aLocationId": null,
            "bLocationId": null,
            "attributeTags": {},  
            "createdBy":  "a51cc1c6-95a0-48c7-a5a0-e49d77a6c536",
            "buyoutPort": false,
            "virtual": false,
            "locked": false,
            "adminLocked": false
        }
    ]
}

A nova Porta agora aparecerá no seu ambiente de trabalho, seja no portal.megaport.com ou no portal-staging.megaport.com.

Nova Porta de API

Dica

Para ver todas as opções das solicitações usadas nesse exemplo, veja https://dev.megaport.com.

Baixar a Carta de Autorização (LOA)

Após criar sua Porta, você poderá baixar a Carta de Autorização (Letter of Authorization, ou LOA).

Aviso

Antes de que você possa baixar a LOA, O Status de Provisionamento da Porta deve ser igual Configured.

Para baixar a LOA

  1. No Postman, expanda Ports no menu de navegação à esquerda e selecione GET Regenerar LOA para o Serviço Megaport.

  2. No commando GET, substitua o productID com o valor criado durante a criação da Porta.

  3. Envie a solicitação.

    Com uma resposta 200 OK de sucesso, esta mensagem aparece na seção Body: 

    Esta resposta não pôde ser visualizada.
 Baixe a resposta para abri-la com um aplicativo apropriado.

    Essa mensagem aparece porque a LOA é um documento PDF e deve ser baixado. Para baixar, clique em Salvar resposta no Postman e salve o PDF em um local conveniente.