トラブルチケットの作成

トラブルチケットは、サービスの中断または損失があった場合に即時の応答を必要とする要求に対してのみ送信されるべきである。それ以外のすべてのリクエストについては、Smart Handsリクエストを送信する。喪失または中断がエクイニクスに起因する場合、それは “エクイニクス側の原因”とみなされ、料金は発生しません。ただし、問題の原因がEquinixでない場合は、通常のSmart Hands料金が適用される。

送信するリクエストを決定するには、「Smart Handsまたはトラブルチケットのどちらを作成するかを決定する」を参照してください。

問題の特定と資産の参照

トラブルティッカーを開くには、適切なトラブルチケットコードを特定し、 リクエスト本文で送信する関連資産参照を決定する必要がある。コードとアセットの参照がすでにわかっている場合は、この手順をスキップしてもよい。

トラブルチケットの注文権限に対応するインストールベースの閲覧権限が必要です。

リクエストボディのパラメータには、トラブルチケットコードが渡される。code

次に、必要な資産参照のプライマリおよびセカンダリ参照識別子を取得する。プライマリおよびセカンダリID値の取得方法については、アセットの取得方法を参照。

これらの値は、リクエストの本文内のパラメータとsecondaryIdパラメータに渡される。primaryId

たとえば、問題のサブカテゴリ「停電が発生している」で最もよく表される問題に直面している場合、必要なトラブルチケットコードは。"0002-0000"必要なプライマリアセット参照は、"Cage ID"また、セカンダリ資産参照を渡すこともできる。これは、"Cabinet ID"

連絡先情報の取得

このシップメントの技術担当者および通知担当者として含めるユーザー名を指定する。これらの値はリクエスト本体の配列内のパラメータにcontacts渡すことができる。registeredUsers

この注文に関する唯一の技術連絡先および通知先である場合は、このステップを省略できます。

トラブルチケットの提出

POST /v2/ticketsView the API Reference
Method	POST
URL or End Point	/v2/tickets
Headers	Authorization, Content-Type
Query Parameters	Not applicable
Body Parameters	code, description, primaryId, occurredDateTime, secondaryId, customerReferenceId, attachments [{id, name}], contacts [ContactRequestRegisteredUser {registeredUsers [string], type} | ContactRequestNonRegisteredUser {firstName, lastName, type, details [{type, value}]}], details {callFromCage, availability, timezone (TIME_ZONE_LIST -> string), submarineEngineerRequired}

このメソッドは、トラブルチケットの注文権限を持つ認証されたユーザーのために、トラブルチケットの要求を作成します。

トラブル解決を迅速にするため、可能な限り多くの情報をプロバイダに提供すること。

cURLリクエストの例：

チケットには最小限、code, description, primaryId, occurredDateTimeというパラメータが必要である。 技術連絡先および通知連絡先は、特に指定されていない場合、デフォルトで注文連絡先（認証済みユーザー）に設定される。

curl -X  
POST "https://api.equinix.com/v2/tickets"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{    
   "code": "0002-0000",    
  "description": "The power seems to be unstable since Smart Hands cable installation from 2 days ago. Please check.",    
  "primaryId": "AM1:01:000111",    
  "occurredDateTime": "2020-08-01T03:00:24.311Z"    
}'

cURLリクエストの例：

このシナリオは、カスタマーポータルのユーザーである特定の技術担当者が含まれている点を除いて、前のシナリオと似ている。発注担当者は、デフォルトの通知担当者である。

curl -X  
POST "https://api.equinix.com/v2/tickets"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{    
   "code": "0002-0000",    
  "description": "The power seems to be unstable since Smart Hands cable installation from 2 days ago. Please check.",    
  "primaryId": "AM1:01:000111",    
  "occurredDateTime": "2020-08-01T03:00:24.311Z",    
  "contacts": [    
    {    
      "registeredUsers": [    
        "janesmith123"    
      ],    
      "type": "TECHNICAL"    
    }    
  ]    
}'

cURLリクエストの例：

このチケットには、未登録の技術連絡先、追加の通知先、追加の資産および顧客参照、添付ファイル、詳細が含まれています。

メモ

添付ファイル付きのオーダーを作成する前に、エンドポイントを呼び出す。Attachments File

curl -X  
POST "https://api.equinix.com/v2/tickets"  
-H "content-type: application/json"  
-H "authorization: Bearer <token>"  
-d '{    
   "code": "0002-0000",    
  "description": "The power seems to be unstable since Smart Hands cable installation from 2 days ago. Please check.",    
  "primaryId": "AM1:01:000111",    
  "occurredDateTime": "2020-08-01T03:00:24.311Z",    
  "secondaryId": "AM1:01:000111:0101",    
  "customerReferenceId": "EQX-TT-20200801",    
  "attachments": [    
    {    
      "id": "fcb2k8763-2947-456e-8d68-f28753d60ba",    
      "name": "AdditionalDetailsAttachment.docx"    
    }    
  ],    
  "contacts": [    
    {    
      "registeredUsers": [    
        "janesmith123",    
        "jimsnow1"    
      ],    
      "type": "NOTIFICATION"    
    },    
    {    
      "firstName": "John",  
  
      "lastName": "Doe",    
      "type": "TECHNICAL",    
      "details": [    
        {    
          "type": "PHONE",    
          "value": "+1-987-654-3210"    
        },    
        {    
          "type": "MOBILE",    
          "value": "+1-987-123-4567"    
        },    
        {    
          "type": "EMAIL",    
          "value": "johndoe@acmecorp.com"    
        }    
      ]    
    }    
  ],    
  "details": {    
    "callFromCage": true,    
    "availability": "WORK_HOURS",    
    "timezone": "America/Detroit",    
    "submarineEngineerRequired": true    
  }    
}'

本文パラメータと説明の完全なリストは、APIリファレンスを参照のこと。

HTTPコード201が返され、レスポンスヘッダーが返されると、トラブルチケットが正常に作成される。レスポンスボディがない。

このチケットの取得、更新、メモの追加、キャンセルを行う場合は、APIリファレンスのチケット(V2)を参照。