# トラブルチケットの作成 トラブルチケットは、サービスの中断または喪失が発生した場合に即時に対応する必要があるリクエストに対してのみ送信してください。他のすべてのリクエストについては、Smart Handsリクエストを送信してください。喪失または中断がエクイニクスに起因する場合、それは “エクイニクス側の原因”とみなされ、料金は発生しません。ただし、問題がEquinixに起因していない場合は、通常のSmart Hands料金が適用されます。 どのリクエストを送信するかを決定するには、「[Smart Handsまたはトラブルチケットを作成するかを決定する](https://docs.equinix.com/ja/smart-hands/sh-which-ticket.md)」を参照してください。 ![](https://docs.equinix.com/ja/assets/images/TroubleTicket-v2-4da756f0a4ab13b4da746eceefca894d.png) ## 問題の特定と資産の参照[​](#問題の特定と資産の参照 "への直接リンク問題の特定と資産の参照") トラブルティッカーを開くには、適切なトラブルチケットコードを特定し、 リクエスト本文で送信する関連アセット参照を決定する必要があります。コードとアセットの参照がすでにわかっている場合は、この手順をスキップしてもかまいません。 トラブルチケットの注文権限に対応するインストールベースの閲覧権限が必要です。 トラブルチケットコードは、リクエスト本文のパラメータに渡されます。`code` 次に、必要なアセット参照のプライマリおよびセカンダリ参照識別子を取得します。プライマリIDとセカンダリIDの値を取得する方法については、「[アセットの取得方法」を](https://docs.equinix.com/ja/api-catalog/assetsv1/assets/searchassets.md)参照してください。 これらの値は、リクエストの本文のパラメータと`secondaryId`パラメータに渡されます。`primaryId` たとえば、問題のサブカテゴリ「全面的な停電が発生している」に最もよく表れる問題に直面している場合、必要なトラブルチケットコードはです。`"0002-0000"`必要なプライマリアセット参照番号はです。`"Cage ID"`セカンダリアセット参照()を渡すこともできます。`"Cabinet ID"` ## 連絡先情報の取得[​](#連絡先情報の取得 "への直接リンク連絡先情報の取得") この荷物の技術担当者および通知担当者として含めるユーザー名を指定してください。これらの値はリクエスト本文の配列内のパラメータに`contacts`渡すことができる。`registeredUsers` この注文に関する唯一の技術連絡先および通知先である場合は、このステップを省略できます。 ## トラブルチケットの提出[​](#トラブルチケットの提出 "への直接リンクトラブルチケットの提出") | `POST /v2/tickets`[View the API Reference](https://docs.equinix.com/ja/api-catalog/ticketsv2.md#tag/Tickets/operation/Create%20a%20Ticket) | | | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | | | 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、occurredDateTimeのパラメータを入力する必要があります。 技術担当者および通知担当者は、特に指定されていない場合、デフォルトで発注担当者(認証済みユーザー)になります。 ``` curl -X POST "https://api.equinix.com/v2/tickets" -H "content-type: application/json" -H "authorization: Bearer " -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 " -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`](https://docs.equinix.com/ja/api-catalog/attachmentsv1/attachments/createattachment.md) ``` curl -X POST "https://api.equinix.com/v2/tickets" -H "content-type: application/json" -H "authorization: Bearer " -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リファレンスを](https://docs.equinix.com/ja/api-catalog/ticketsv2/tickets/create%20a%20ticket.md)参照してください。 201のHTTPコードが返され、応答ヘッダーが返されると、トラブルチケットが正常に作成されます。応答本文はありません。 このチケットの取得、更新、メモの追加、キャンセルを希望する場合は、APIリファレンスセクションの[チケット(V2)を参照してください。](https://docs.equinix.com/ja/api-catalog/ticketsv2/tickets.md)