トラブルチケットの作成

トラブルチケットは、サービスの中断または損失が発生した場合に即時対応が必要なリクエストに対してのみ送信してください。その他のリクエストについては、Smart Handsリクエストを送信してください。サービスの損失または中断がエクイニクスに起因する場合は、「エクイニクスが原因」とみなされ、料金は発生しません。ただし、問題がエクイニクスに起因しない場合は、通常のSmart Hands料金が適用されます。

どちらのリクエストを送信するかを決定するには、スマートハンズとトラブルチケットのどちらを作成するかを決定するを参照してください。

問題の特定と資産の参照

トラブル・ティッカーを開くには、適切なトラブル・チケット・コードを特定し、リクエストの本文で提出する関連する資産の参照を決定する必要があります。コードおよびアセット参照をすでに知っている場合は、このステップをスキップすることができます。

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

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

次に、必要なアセット参照用のプライマリおよびセカンダリ参照識別子を取得します。プライマリ ID とセカンダリ ID の値を取得する方法については、How to retrieve assets を参照してください。

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

例えば、あなたが問題のサブカテゴリ 'Experiencing a total power outage' で最もよく表される問題に直面している場合、必要なトラブル・チケット・コードは "0002-0000" です。必要な一次資産参照は "Cage ID" です。また、"キャビネット 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リクエストの例：

チケットには、コード、説明、primaryId、occuedDateTime のパラメータが最低限必要です。技術連絡先と通知先は、特に提供されない場合、デフォルトで注文連絡先（認証されたユーザー）になります。

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リファレンスセクションのTickets (V2)を参照してください。