本文へスキップ

パッチケーブルの注文

必須条件​

  1. Smart Hands の詳細を取得するには、Smart Hands 権限が必要です。

  2. Authenticate - OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。OAuth APIを呼び出して認証情報を検証および認証する方法については、API Authenticationを参照してください。

  3. Get Smart Hands Types - /v1/orders/smarthands/types エンドポイントに GET リクエストを送信し、すべての Smart Hands 注文タイプを取得します。すでに Smart Hands の注文タイプを知っている場合は、この手順を省略できます。

  4. ロケーション情報の取得 - /v1/orders/smarthands/locations エンドポイントに GET リクエストを送信し、アクセス可能な IBX ロケーションを取得します。ロケーション情報をすでに知っている場合は、この手順を省略できます。

ムーブパッチケーブルのご注文​

エクイニクスのIBX技術者がデバイス間を移動するパッチケーブルを注文するには、/v1/orders/smarthands/moveJumperCableエンドポイントにPOSTリクエストを送信します。

これは Smart Hands の注文権限を持つユーザーのみが行うことができます。

追加情報、添付ファイル、連絡先なしでパッチケーブルを移動するためのcURLの例**

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/moveJumperCable"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
    "ibxLocation": {  
    "ibx": "AM1",  
    "cages": [  
      {  
        "cage": "AM1:0J:00JD11",  
        "accountNumber": "126854"  
      }  
    ]  
  },  
  "serviceDetails": {  
    "quantity": "1",  
    "scopeOfWork": "Move cable from Server01 to Server 09, and ensure cable tag is easily seen at all times. Cable ID is 1-12345-67890. Any available slots or ports."  
  },  
  "schedule": {  
    "scheduleType": "SCHEDULED_MAINTENANCE",  
    "requestedStartDate": "2019-08-30T22:00:49.776Z",  
    "requestedCompletionDate": "2019-08-31T22:00:49.776Z"  
  },  
  "contacts": [  
    {  
      "contactType": "ORDERING",  
      "userName": "johndoe"  
    },  
    {  
      "contactType": "TECHNICAL",  
      "userName": "johndoe",  
      "workPhonePrefToCall": "ANYTIME"  
    },  
    {  
      "contactType": "NOTIFICATION",  
      "userName": "johndoe"  
    }  
  ]  
}'

パッチ・ケーブルを移動するための cURL の例（追加情報、添付ファイル、連絡先付き）：

メモ

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

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/moveJumperCable"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{  
  "ibxLocation": {  
    "ibx": "AM1",  
    "cages": [  
      {  
        "cage": "AM1:0J:00JD11",  
        "accountNumber": "126854"  
      }  
    ]  
  },  
  "serviceDetails": {  
    "quantity": "1",  
    "cableId": "1-12345-67890",  
    "currentDeviceDetails": {  
      "name": "NH-Server-01",  
      "slot": "50",  
      "port": "50"  
    },  
    "newDeviceDetails": {  
      "name": "NH-Server-09",  
      "slot": "Next Available",  
      "port": "Next Available"  
    },  
    "scopeOfWork": "Refer to attachment for cable details.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
      "id": "fcb4a673-6308-456e-8f83-f745501d60ba",  
      "name": "MoveCablesInstructions.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"  
    }  
  ]  
}'

追加情報、添付ファイル、連絡先なしで複数のパッチケーブルを移動するための cURL の例：

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/moveJumperCable"  
-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": "12+",  
    "scopeOfWork": "Move all cables from Server01 to Server 09, and ensure cable tag is easily seen at all times. Any available slots or ports"  
  },  
  "schedule": {  
    "scheduleType": "SCHEDULED_MAINTENANCE",  
    "requestedStartDate": "2019-08-30T22:00:49.776Z",  
    "requestedCompletionDate": "2019-08-31T22:00:49.776Z"  
  },  
  "contacts": [  
    {  
      "contactType": "ORDERING",  
      "userName": "johndoe"  
    },  
    {  
      "contactType": "TECHNICAL",  
      "userName": "johndoe",  
      "workPhonePrefToCall": "ANYTIME"  
    },  
    {  
      "contactType": "NOTIFICATION",  
      "userName": "johndoe"  
    }  
  ]  
}'

複数のパッチ・ケーブルを移動するための cURL の例（追加情報、添付ファイル、および連絡先付き）：

メモ

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

curl -X  
POST "https://api.equinix.com/v1/orders/smarthands/moveJumperCable"  
-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": "12+",  
    "scopeOfWork": "Refer to attachment for cable details.",  
    "needSupportFromASubmarineCableStationEngineer": true  
  },  
  "attachments": [  
    {  
      "id": "fcb4a673-6308-456e-8f83-f745501d60ba",  
      "name": "MoveCablesInstructions.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"  
    }  
  ]  
}'

回答例

{  
  "OrderNumber": "1-457809872838"  
}

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

このページは役に立ちましたか？