# 資産の回収 アセット(V1) APIは、指定された条件に基づいてインストールされたアセットを検索し、特定のアセットの詳細を取得する権限を持つユーザーを許可します。`View Install Base` ## 前提条件[​](#前提条件 "への直接リンク前提条件") 認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 ## 資産と資産データの検索[​](#資産と資産データの検索 "への直接リンク資産と資産データの検索") アセット情報を検索するには、エンドポイントにリクエストを[`/assets/search`](https://docs.equinix.com/ja/api-catalog/assetsv1/assets/searchassets.md)送信します。`POST`リクエストの本文で検索条件を指定します。必要に応じて、クエリパラメータで検索動作を指定します。 ![アセット情報を取得する2つのステップ](https://docs.equinix.com/ja/assets/images/RetrieveAssets-fd524b8af1185d6cf2410420cc0f3e04.png) | `POST /v1/assets/search`[View the API Reference](https://docs.equinix.com/ja/api-catalog/assetsv1.md#tag/Assets/operation/Search%20permissible%20assets) | | | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | | | | Method | `POST` | | URL or End Point | `/v1/assets/search` | | Headers | Not applicable | | Query Parameters | `sorts, source, q, exactMatch` | | Body Parameters | Not applicable | サンプルcURLリクエスト: このリクエストは、IBXロケーション、DA1、ケージ、DA1でのパッチパネルの検索が完了したことを示しています。インストールされたパッチパネルは、 までの`2019/07/17`日付内に完了しました。`2003/07/17`検索結果はシリアル番号の昇順でソートされ、`101`インデックスから開始するように選択され、1`0`ページあたり100件に制限されたアセット番号のみを持つパッチパネルに対してフィルタリングされました。 ``` curl -X POST "https://api.equinix.com/v1/assets/search?sorts=SERIAL_NUMBER&source=ASSET_NUMBER&q=101&exactMatch=false&offset=0&limit=100" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "filter": {         "ibxs": [             "DA1"         ],         "cages": [             "DA1:01:009800"         ],         "productTypes": [             "PATCH_PANEL"         ],         "dateRange": {             "fromDate": "2003-07-17T03:31:20.455Z",             "toDate": "2019-07-17T03:31:20.455Z"         }     } ``` 回答例 ``` {     "data": [       {         "assetNumber": "10139297",         "serialNumber": "PP:0210:73281",         "orderNumber": 1-126273059,         "productName": "PATCH_PANEL",         "ibx": "DA1",         "cage": "DA1:01:009800",         "productDescription": "Patch Panel",         "accountNumber": "987",         "relatedAccountNumber": null,         "accountName": "JOHN-DOE-CORP",         "installationDate": "2009-05-14T00:00:00Z",         "customerReferenceNumber": DAY-98278,         "billingAgreementNumber": CAB-93678,         "status": "ACTIVE",         "additionalDetails": {             "cabinetNumber": "DA1:01:009800:0210",             "customerOrCarrierCircuitID": null,             "finalzSideSystemName": null,             "productBundle": null,             "patchPanelNumber": "PP:0210:73281"       }     },     {         "assetNumber": "10147789",         "serialNumber": "VP:0101:74679",         "orderNumber": null,         "productName": "PATCH_PANEL",         "ibx": "DA1",         "cage": "DA1:R1:V000170-1-294",         "productDescription": "Patch Panel",         "accountNumber": "987",         "relatedAccountNumber": null,         "accountName": "JOHN-DOE-CORP",         "installationDate": "2009-07-09T00:00:00Z",         "customerReferenceNumber": null,         "billingAgreementNumber": null,         "status": "ACTIVE",         "additionalDetails": {             "cabinetNumber": "DA1:R1:V000170-1-294:V1801",             "customerOrCarrierCircuitID": null,             "finalzSideSystemName": null,             "productBundle": null,             "patchPanelNumber": "VP:0101:74679"         }       }     ],     "page": {         "limit": 100,         "offset": 0,         "total": 2,         "sorts": [         "SERIAL_NUMBER"        ]     },     "_links": {         "next": {            "href": "/assets/search?q=101&exactMatch=false&offset=0&limit=100&source=ASSET_NUMBER&sorts=SERIAL_NUMBER"         },         "previous": {            "href": "/assets/search?q=101&exactMatch=false&offset=0&limit=100&source=ASSET_NUMBER&sorts=SERIAL_NUMBER"         },         "self": {            "href": "/assets/search?q=101&exactMatch=false&offset=0&limit=100&source=ASSET_NUMBER&sorts=SERIAL_NUMBER"         }     } } ``` 応答パラメータの完全なリストについては、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/assetsv1.md)参照してください。 ## 資産取得[​](#資産取得 "への直接リンク資産取得") 特定のアセットの詳細をすべて取得するには、エンドポイントにリクエストを[`/assets/{assetId}`](https://docs.equinix.com/ja/api-catalog/assetsv1/assets/getassetbyid.md)送信します。`GET`リクエストのパスのIDでアセットを指定します。 ``` curl -X GET "https://api.equinix.com/v1/assets/{asset_id}" -H "content-type: application/json" -H "authorization: Bearer " ``` 回答例 ``` {     "assetNumber": "9980813",     "serialNumber": "1011585-M",     "orderNumber": "1-198255055853",     "productName": "CROSS_CONNECT",     "ibx": "DC4",     "cage": "DC4:01:043325",     "productDescription": "Network Cable Connection",     "accountNumber": "888",     "accountName": "JOHN-DOE-CORPORATION",     "installationDate": "2008-08-28T00:00:00Z",     "customerReferenceNumber": "",     "status": "Active",     "productDetails": [         {             "key": "ACCOUNT_NAME",             "value": "JOHN-DOE-CORPORATION",             "tag": "HEADER"         },         {             "key": "CUSTOMER",             "value": "JOHN-DOE-CORPORATION",             "tag": "A_SIDE_INFORMATION"         },         {             "key": "ASSET_NUMBER",             "value": "9980813",             "tag": "OTHER_DETAILS"         },         {             "key": "IFC_PANEL",             "value": "No",             "tag": "Z_SIDE_INFORMATION"         }     ] } ``` 応答パラメータの完全なリストについては、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/assetsv1.md)参照してください。