ケーブルの追加注文
必須条件
-
Smart Hands の詳細を入手するには、
Smart Handsの注文権限が必要です。 -
Authenticate - OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API Authenticationを参照してください。
-
Get Smart Hands Types -
/v1/orders/smarthands/typesエンドポイントにGETリクエストを送信し、すべての Smart Hands 注文タイプを取得します。すでに Smart Hands の注文タイプを知っている場合は、この手順を省略できます。 -
ロケーション情報の取得 -
/v1/orders/smarthands/locationsエンドポイントにGETリクエストを送信し、アクセス可能な IBX ロケーションを取得します。ロケーション情報をすでに知っている場合は、この手順を省略できます。
ケーブルのご注文 - 単一タイプのケーブル
ケーブルを注文するには、POST v1/orders/smarthands/cableRequest エンドポイントを送信します。リクエストの本文に注文の詳細を指定します。技術者の追加情報を含めるには、オプションの attachments オブジェクトを使用します。
添付ファイル付きの注文を作成する前に、Attachments File エンドポイントを呼び出します。
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/cableRequest"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"quantity": "10",
"mediaType": "Multi-mode 62.5mic",
"connectorType": "RJ45",
"length": "25cm",
"scopeOfWork": "Refer to attachment.",
"needSupportFromASubmarineCableStationEngineer": true
},
"attachments": [
{
"id": "fcb4a673-6308-456e-8f83-f745501d60ba",
"name": "additionalattachment.docx"
}
],
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"customerReferenceNumber": "EQX-PO2019-08-001",
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED",
"attachment": {
"id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",
"name": "PurchaseOrderExemptionForm123.docx"
}
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"name": "Jane Smith",
"email": "janesmith@corporation.com",
"workPhoneCountryCode": "+44",
"workPhone": "0148211111",
"workPhonePrefToCall": "MY_BUSINESS_HOURS",
"workPhoneTimeZone": "Europe/London",
"mobilePhoneCountryCode": "+44",
"mobilePhone": "0123456789",
"mobilePhonePrefToCall": "MY_BUSINESS_HOURS",
"mobilePhoneTimeZone": "Europe/London"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
},
{
"contactType": "NOTIFICATION",
"userName": "jillsnow"
}
]
}'
ケーブルのご注文 - 各種ケーブル
ケーブルを注文するには、POST v1/orders/smarthands/cableRequest エンドポイントを送信します。リクエストの本文に注文の詳細を指定します。複数のケーブルタイプを注文するには、ケーブルタイプの serviceDetails.scopeOfWork パラメータを使用するか、オプションの attachments オブジェクトを使用して、技術者のケーブルタイプと詳細を含めます。
添付ファイル付きの注文を作成する前に、Attachments File エンドポイントを呼び出します。
curl -X
POST "https://api.equinix.com/v1/orders/smarthands/cableRequest"
-H "content-type: application/json"
-H "authorization: Bearer <token>"
-d '{
"ibxLocation": {
"ibx": "AM1",
"cages": [
{
"cage": "AM1:0J:00JD11",
"cabinets": [
"AM1:0J:00JD11:0001"
],
"accountNumber": "126854"
}
]
},
"serviceDetails": {
"quantity": ">10",
"scopeOfWork": "Refer to attachment.",
"needSupportFromASubmarineCableStationEngineer": true
},
"attachments": [
{
"id": "fcb4a673-6308-456e-8f83-f745501d60ba",
"name": "additionalattachment.docx"
}
],
"schedule": {
"scheduleType": "SCHEDULED_MAINTENANCE",
"requestedStartDate": "2019-08-30T22:00:49.776Z",
"requestedCompletionDate": "2019-08-31T22:00:49.776Z"
},
"customerReferenceNumber": "EQX-PO2019-08-001",
"purchaseOrder": {
"purchaseOrderType": "EXEMPTED",
"attachment": {
"id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",
"name": "PurchaseOrderExemptionForm123.docx"
}
},
"contacts": [
{
"contactType": "ORDERING",
"userName": "johndoe"
},
{
"contactType": "TECHNICAL",
"name": "Jane Smith",
"email": "janesmith@corporation.com",
"workPhoneCountryCode": "+44",
"workPhone": "0148211111",
"workPhonePrefToCall": "MY_BUSINESS_HOURS",
"workPhoneTimeZone": "Europe/London",
"mobilePhoneCountryCode": "+44",
"mobilePhone": "0123456789",
"mobilePhonePrefToCall": "MY_BUSINESS_HOURS",
"mobilePhoneTimeZone": "Europe/London"
},
{
"contactType": "NOTIFICATION",
"userName": "johndoe"
},
{
"contactType": "NOTIFICATION",
"userName": "jillsnow"
}
]
}'
ボディパラメータの完全なリストと説明については、API Reference を参照してください。
回答例
{
"OrderNumber": "1-457809872838"
}
応答は注文が成功したことを示し、注文番号を返します。