APIを使用したMCRの作成
このトピックでは、MCRを作成するためのAPI手順を説明し、MCRのロケーションを調べる方法や、注文を検証して完了させる方法についても説明します。
始める前に、有効なアクセストークンを取得してください。詳細については、APIキーの作成を参照してください。
PostmanコレクションでMCRのロケーション詳細を調べる方法
-
左側のナビゲーションでLocationsフォルダーを展開し、GET Locations (v3)をクリックします。
このリクエストは、パラメーターまたはボディ情報を必要としていません。 -
Sendをクリックして、GETリクエストを行います。
GET {baseUrl}/v3/locations
リクエストが成功したことを確認するには、Status: 200 OKを確認し、レスポンスをPretty形式でボディセクションに表示します。
リクエストにより、数百のMegaportロケーションが返されます。
-
虫眼鏡をクリックして、
diversityZonesオブジェクト内でmcrSpeedMbpsを含むサイトを検索し、USマーケット内にあることを確認します。特定のロケーションにMCRをプロビジョニングするには、ポート速度が
diversityZonesオブジェクトに利用可能である必要があります。そのロケーションにMCRの利用可能な速度とダイバーシティゾーンがあることを確認してください。
{
"id": 60,
"name": "CoreSite LA1",
"address": {
"street": "624 South Grand Avenue",
"suburb": null,
"city": "Los Angeles",
"state": "CA",
"postcode": "90017",
"country": "USA"
},
"dataCentre": {
"id": 18,
"name": "CoreSite"
},
"metro": "Los Angeles",
"market": "US",
"status": "Active",
"longitude": -118.25554,
"latitude": 34.04791,
"orderingMessage": null,
"diversityZones": {
"red": {
"mcrSpeedMbps": [
2500,
5000,
10000,
1000
],
"megaportSpeedMbps": [
1000,
10000,
100000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
},
"blue": {
"mcrSpeedMbps": [
5000,
1000,
2500,
10000
],
"megaportSpeedMbps": [
1000,
100000,
10000
],
"mveMaxCpuCoreCount": null,
"mveAvailable": true
}
},
"productAddOns": {
"crossConnect": {
"available": true,
"type": "STANDARD"
}
}
}
MCR を作成するには、id 値が必要です。この例では、ロケーションIDは60です。
MCR の注文をテストおよび検証するには
-
Postmanで、左側ナビゲーションの Megaport Cloud Router (MCR) を展開し、Validate MCR Order (v3) を選択します。
-
Bodyを更新し、
locationId（60）、productName（任意のMCR名）、term（最低コミット期間：1、12、24、または36か月）、およびportSpeed（1000、2500、5000、または10000 Mbps）を設定してSendをクリックします。
ASN値は、Megaport のデフォルトASN（133937）を使用しない場合のみ必要です。
ダイバーシティゾーンを追加します。diversityZonesに表示されるロケーション結果を確認して、MCR ロケーションで利用可能なダイバーシティゾーンを確認してください。
ダイバーシティゾーンが明示的に選択されていない場合、MCR 作成時に自動的に割り当てられます。POST {baseUrl}/v3/networkdesign/validate
[
{
"locationId":60,
"term": 12,
"promoCode": "promox3mnthfree2",
"productName":"Test MCR",
"productType":"MCR2",
"portSpeed":2500,
"config": {
"mcrAsn": 133937,
"diversityZone":"blue"
}
}
]
成功したレスポンスは検証を通過し、200 OK ステータスを返します。レスポンスにはサービスの価格詳細も含まれます。
{
"message": "Validation passed",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"price": {
"hourlySetup": 0,
"dailySetup": 0,
"monthlySetup": 0,
"hourlyRate": 0,
"dailyRate": 0,
"monthlyRate": 1440.00,
"fixedRecurringCharge": 0,
"postPaidBaseRate": "no base rate",
"longHaulMbpsRate": 0,
"mbpsRate": 6.000000000000000,
"currency": "USD",
"key": "no key",
"productType": "MCR2",
"empty": false
},
"serviceName": "API Test MCR",
"productType": "MCR2",
"productUid": "78aebd6b-7601-4331-82bc-dcd07f9f21a6",
"string": "Los Angeles"
}
]
}
検証済みの MCR を注文するには
-
検証済みの MCR リクエストと確認済みの料金情報を用意し、POST Validate MCR Order (v3) から Body をコピーして、POST Buy MCR (v3) の Body に貼り付けます。
重要
api.megaport.com でこの呼び出しを行うと、お客様のアカウントにサービス料金が課金されます。代わりに、これらの例のように、料金が発生しないステージング（テスト）環境の API を使用することもできます。
-
リクエストを送信します。
以下の出力は成功したレスポンスを示しています。
{
"message": "MCR2 [426fa830-4b66-41ad-95a1-197d55e074b1] created.",
"terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy",
"data": [
{
"serviceName": "Test MCR",
"name": "Test MCR",
"secondaryName": null,
"technicalServiceId": 187964,
"technicalServiceUid": "426fa830-4b66-41ad-95a1-197d55e074b1",
"requestedDate": 1707800936928,
"configuredDate": null,
"currentEstimatedDelivery": null,
"companyName": "Megaport Lab",
"companyId": 1153,
"billingContactName": null,
"billingContactId": null,
"adminContactName": null,
"adminContactId": null,
"technicalContactName": null,
"technicalContactId": null,
"salesName": null,
"salesId": null,
"billableId": 179527,
"billableUsageAlgorithm": null,
"productType": "MCR2",
"provisioningStatus": "DEPLOYABLE",
"failedReason": null,
"inAdvanceBillingStatus": null,
"provisioningItems": [],
"tags": [],
"vxcDistanceBand": null,
"intercapPath": null,
"marketplaceVisibility": false,
"vxcPermitted": true,
"vxcAutoApproval": false,
"createDate": 1707800936928,
"terminationDate": null,
"contractStartDate": null,
"contractTermMonths": 12,
"rateType": "MONTHLY",
"trialAgreement": false,
"payerCompanyId": null,
"nonPayerCompanyId": null,
"minimumSpeed": null,
"maximumSpeed": null,
"rateLimit": 2500,
"errorMessage": null,
"lagId": null,
"aggregationId": null,
"lagPrimary": null,
"market": "USA",
"accountManager": null,
"promptUid": null,
"components": [],
"attributes": [],
"aLocation": "lax-cs1",
"bLocation": null,
"aMetro": "Los Angeles",
"aCountry": "USA",
"aLocationId": 60,
"bLocationId": null,
"bMetro": null,
"bCountry": null,
"attributeTags": {},
"createdBy": "f39b8983-256e-4643-adec-9f0b5da09ab7",
"buyoutPort": false,
"virtual": true,
"locked": false,
"adminLocked": false,
"bgpShutdownDefault": false,
"originDomain": null
}
]
}
新しいMCRは、portal.megaport.comまたはportal-staging.megaport.comの作業環境に表示されます.
ヒント
この例で使用されているリクエストのすべてのオプションを参照するには、https://dev.megaport.comを参照してください。
次のステップは、このMCRにVXCを作成することです。
詳細については以下を参照してください：