Creazione di un MCR VXC con l’API

Questo argomento descrive la procedura API per creare un MCR VXC. Il primo esempio crea una Connessione Ospitata AWS nel mercato statunitense - una delle configurazioni più complesse. I modelli per altri CSP compaiono successivamente nell’argomento.

Per maggiori informazioni, vedere POST Validate MCR VXC Order (v3) nel riferimento API.

Creazione di un VXC tra un MCR e AWS con una Connessione Ospitata

Questo esempio crea una Connessione Ospitata AWS nel mercato statunitense. Le fasi includono come:

• ottenere l’ID del prodotto MCR
• trovare l’ID della località per un mercato statunitense disponibile
• validare e ordinare il VXC
• configurare due percorsi statici
• configurare le connessioni BGPIl Border Gateway Protocol (BGP) è un protocollo di instradamento standardizzato progettato per scambiare informazioni di rotta e raggiungibilità tra sistemi autonomi (AS) su internet.
  – una connessione con i dettagli MEDIl Multi-Exit Discriminator (MED) è un attributo del percorso BGP che può influenzare un vicino BGP a prendere un percorso preferito quando il sistema autonomo pubblicizzato (AS) è lo stesso per i percorsi candidati e ci sono più punti di ingresso per quel AS. Un valore metrico MED più basso è preferito rispetto a un valore più alto.
  e una senza.

Prima di iniziare, ottenere un token di accesso valido. Per maggiori informazioni, vedere Creazione di una chiave API.

Per creare il VXC, abbiamo bisogno del productUid per il MCR.

Per ottenere il productUid per il MCR

1. Ottenere l’elenco dei prodotti.

   GET {baseUrl}/v2/products/
   

2. Dai dettagli del prodotto restituiti, localizzare il valore productUid per il MCR che si desidera connettere.

   Questo esempio utilizza questo valore: fee85cc0-f06f-4ad7-bce7-36aef7dbe0d0

Successivamente, trovare l’ID della località per il mercato statunitense desiderato con supporto per Connessioni Ospitate AWS.

Per trovare il locationId nel mercato statunitense dove sono disponibili le Connessioni Ospitate AWS

1. Ottenere l’elenco per tutte le interfacce che Megaport ha con i Fornitori di Servizi Cloud.

   GET {baseUrl}/v2/dropdowns/partner/megaports
   

   È possibile filtrare i risultati per connectType e vxcPermitted.

   GET {baseUrl}/v2/dropdowns/partner/megaports?connectType=AWSHC&vxcPermitted=true
   

2. Cliccare sulla lente d’ingrandimento e cercare nella risposta un sito compatibile con i criteri di localizzazione.

   Per questo esempio, selezionare “US West (Oregon) (us-west-2) [DZ-RED]” con “locationId”: 57.

{
            "connectType": "AWSHC",
            "productUid": "f274bd09-1796-43af-8837-28fa4fa2a1ab",
            "vxcPermitted": true,
            "companyUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
            "companyName": "AWS",
            "title": "US West (Oregon) (us-west-2) [DZ-RED]",
            "locationId": 57,
            "speed": 10000,
            "rank": 275,
            "lag_id": 5,
            "lag_primary": true,
            "aggregation_id": 106462
        },

Con l’ID MCR e l’ID della posizione AWS, puoi creare un VXC.

Per creare il VXC

1. Crea una richiesta con questo URL:

   POST {baseUrl}/v3/networkdesign/buy
   

   Suggerimento

   Per testare la tua richiesta prima di ordinare, puoi usare: POST {baseUrl}/v3/networkdesign/validate

2. Aggiungi queste intestazioni alla richiesta:

   • Content-Type: application/json
   • Authorization: Bearer {your accessToken}

3. Crea il Body della richiesta con i dettagli di configurazione.

   Questo esempio usa l’ID prodotto MCR, l’ID della posizione AWS per il B-End, crea due route statiche e configura connessioni BGP – una connessione con dettagli MED e una senza. Le sezioni seguenti forniscono dettagli sulle route statiche e sulle connessioni BGP.

[
  {
    "productUid": "fee85cc0-f06f-4ad7-bce7-36aef7dbe0d0",
    "associatedVxcs": [
      {
        "rateLimit": 100,
        "productName": "awshc",
        "term": 12,
        "shutdown": false,
        "promoCode": "promox3mnthfree2",
        "aEnd": {
          "locationId": 320,
          "vlan": 0,
          "partnerConfig": {
            "connectType": "VROUTER",
            "interfaces": [
              {
                "vlan": null,
                "ipMtu": 5000,
                "ipAddresses": [
                  "10.191.0.25/29",
                ],
                "bgpConnections": [
                  {
                    "peerAsn": 62512,
                    "localIpAddress": "10.191.0.25",
                    "peerIpAddress": "10.191.0.26",
                    "password": "cnn6eaeaETSjvjvjvjv",
                    "importWhitelist": null,
                    "importBlacklist": null,
                    "exportWhitelist": null,
                    "exportBlacklist": null,
                    "shutdown": false,
                    "description": "BGP con MED e BFD abilitati",
                    "medIn": 100,
                    "medOut": 100,
                    "bfdEnabled": true
                  },
                  {
                    "peerAsn": 62511,
                    "localIpAddress": "10.191.0.27",
                    "peerIpAddress": "10.191.0.28",
                    "password": "cnn23049asdkfj",
                    "importWhitelist": null,
                    "importBlacklist": null,
                    "exportWhitelist": null,
                    "exportBlacklist": null,
                    "shutdown": false,
                    "description": "BGP senza MED o BFD",
                    "medIn": null,
                    "medOut": null,
                    "bfdEnabled": false
                  }
                ],
                "ipRoutes": [
                  {
                    "prefix": "10.0.0.0/24",
                    "nextHop": "10.191.0.26",
                    "description": "test percorso statico 1"
                  },
                  {
                    "prefix": "10.0.1.9/24",
                    "nextHop": "10.191.0.27",
                    "description": "test percorso statico 2"
                  }
                ],
                "natIpAddresses": []
              }
            ]
          }
        },
        "bEnd": {
          "locationId": 57,
          "ownerUid": "605cb850-dfb4-4a05-a171-8bf17757b3a2",
          "productUid": "d5518ee1-e915-4e3d-a4e1-a2c7e04f2fdd",
          "vlan": 0,
          "partnerConfig": {
            "name": "awshc",
            "ownerAccount": "XXXXXXXXXXXX",
            "connectType": "AWSHC"
          }
        },
        "productType": "VXC",
        "connectType": "AWSHC"
      }
    ]
  }
]

Route statiche

Puoi creare più route statiche per interfaccia aggiungendo un array ipRoutes all’array delle interfacce dell’oggetto di configurazione del partner A-End:

"ipRoutes": [
  {
    "prefix": "10.0.0.0/24",
    "nextHop": "10.191.0.26",
    "description": "test percorso statico 1"
  },
  {
    "prefix": "10.0.1.9/24",
    "nextHop": "10.191.0.27",
    "description": "test percorso statico 2"
 }
],

Connessioni BGP

Puoi creare più connessioni BGP per interfaccia aggiungendo un array bgpConnections all’array delle interfacce dell’oggetto di configurazione del partner A-End:

"bgpConnections": [
  {
    "peerAsn": 62512,
    "localIpAddress": "10.191.0.25",
    "peerIpAddress": "10.191.0.26",
    "password": "cnn6eaeaETSjvjvjvjv",
    "importWhitelist": null,
    "importBlacklist": null,
    "exportWhitelist": null,
    "exportBlacklist": null,
    "shutdown": false,
    "description": "BGP con MED e BFD abilitati",
    "medIn": 100,
    "medOut": 100,
    "bfdEnabled": true
  },
  {
    "peerAsn": 62511,
    "localIpAddress": "10.191.0.27",
    "peerIpAddress": "10.191.0.28",
    "password": "cnn23049asdkfj",
    "importWhitelist": null,
    "importBlacklist": null,
    "exportWhitelist": null,
    "exportBlacklist": null,
    "shutdown": false,
    "description": "BGP senza MED o BFD",
    "asPathPrependCount": "3",
    "bfdEnabled": false
  }
],

Bidirectional Forwarding Detection (BFD)

L’oggetto di configurazione bfd si applica a tutte le connessioni BGP sull’interfaccia per cui bfdEnabled = true.

Le impostazioni BFD non sono modificabili. I valori predefiniti configurati quando il BFD è abilitato sono:

• Intervallo di trasmissioneIl tempo minimo in cui il vicino BGP trasmette pacchetti BFD di rilevamento della vitalità al vicino BGP.
  : 300 millisecondi
• Intervallo di ricezioneIl tempo minimo in cui il vicino BGP invia pacchetti di rilevamento della vitalità BFD all’interfaccia.
  : 300 millisecondi
• MoltiplicatoreIl numero minimo di pacchetti BFD che possono essere persi prima che la sessione BGP sia considerata disconnessa.
  : 3

Autoconfigurazione con AWS, Azure e Google

Per Azure, AWS Hosted VIF e Google, Megaport può configurare automaticamente gli indirizzi IP e i dettagli BGP sia sul lato MCR sia sul lato del CSP, garantendo un setup BGP funzionante. Questo riduce anche al minimo il numero di passaggi tra i portali del CSP e di Megaport.

Sebbene l’autoconfigurazione venga gestita per impostazione predefinita dal Portal, è anche possibile utilizzare l’API per avviare l’autoconfigurazione BGP.
La funzionalità viene attivata quando la chiave interfaces in partnerConfig non esiste o è impostata su null.

Per configurare il peering BGP con i CSP

1. Crea una richiesta a questo URL:

   POST {baseUrl}/v3/networkdesign/buy
   

2. Aggiungi queste intestazioni alla richiesta:

   • Content-Type: application/json
   • Authorization: Bearer {your accessToken}

3. Crea il corpo della richiesta con i dettagli della configurazione.

   Sono disponibili diversi template per i CSP più diffusi.

AWS Hosted VIF

{
"productUid": "{{mcrid}}",
"associatedVxcs": [
 {
   "productName": "Test AWS VIF VXC",
   "rateLimit": 100,
   "term": 12,
   "aEnd": {
     "vlan": 0
   },
   "bEnd": {
     "productUid": "{{awsPortUid}}",
     "partnerConfig": {
       "connectType": "AWS",
       "type": "private",
       "ownerAccount": "{{yourAWSAccountNumber}}"
     }
   }
 }
]
}

Google Cloud

{
   "productUid": "{{mcrid}}",
   "associatedVxcs": [
    {
     "productName": "Test Google VXC",
     "rateLimit": 100,
     "term": 12,
     "aEnd": {
       "vlan": 0
     },
     "bEnd": {
       "productUid": "{{googlePortUid}}",
       "partnerConfig": {
         "connectType": "GOOGLE",
         "pairingKey": "{{googlekey}}"
       }
     },
     "productType": "VXC"
    }
   ]
}

Microsoft Azure

Per i dettagli della configurazione Azure, vedere Creazione di un VXC tra un MCR e Microsoft Azure con l’API.