パッケージの場所をリクエスト

必須条件

Authenticate - OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API Authenticationを参照してください。
インバウンド貨物の注文番号を取得する - 既にスケジュールされているインバウンド貨物の注文番号を取得するには、/colocations/v2/orders/{orderId}エンドポイントに GET リクエストを送信します。新しいインバウンド貨物をスケジュールするには、/colocation/v2/orders/shipmentエンドポイントに POST リクエストを送信します。インバウンド貨物をスケジュールするには、ユーザーは Shipments 権限を持っている必要があります。すでにインバウンド貨物のオーダー番号を持っている場合は、このステップをスキップすることができます。
Smart Hands の詳細を入手するには、Smart Hands の注文権限が必要です。
Get Smart Hands Types - /v1/orders/smarthands/types エンドポイントに GET リクエストを送信し、すべての Smart Hands 注文タイプを取得します。すでに Smart Hands の注文タイプを知っている場合は、この手順を省略できます。
ロケーション情報の取得 - /v1/orders/smarthands/locations エンドポイントに GET リクエストを送信し、アクセス可能な IBX ロケーションを取得します。ロケーション情報をすでに知っている場合は、この手順を省略できます。

パッケージの場所

IBXで荷物の場所をリクエストするには、/v1/orders/smarthands/locatePackageエンドポイントにPOSTリクエストを送信します。リクエスト本文の serviceDetails オブジェクトにパッケージの詳細とニーズを指定します。技術者の追加情報を含めるには、オプションの attachments オブジェクトを使用します。

メモ

添付ファイル付きの注文を作成する前に、Attachments File エンドポイントを呼び出します。

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/locatePackage"  
-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": {  
    "shipmentOrderNumber": "1-1234567890",  
    "trackingNumber": "All tracking numbers in this shipment order.",  
    "possibleLocation": "Last known location was the loading bay.",  
    "packageDescription": "Multiple DHL boxes.",  
    "scopeOfWork": "Locate and group all boxes together in a fixed location for easy identification and later collection.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
        "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",  
        "name": "AdditionalShipmentWorkDetails.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": "janesmith"  
    }  
  ]  
}'

ボディパラメータの完全なリストと説明については、APIリファレンスを参照してください。

回答例

{  
  "OrderNumber": "1-457809872838"  
}

応答は注文が成功したことを示し、注文番号を返します。

必須条件​

パッケージの場所​

必須条件

パッケージの場所