---
title: レコード数でビジネスオブジェクトを取得する
slug: neurons-for-itsm/admin-user-help/jpn/latest/WSqTnY0ObtnUEAH24TBV7
createdAt: 2026-10-29T01:28:25.195Z
---

表示するレコードの定義数に基づいてビジネス オブジェクト レコードを取得します。 たとえば、50 件のレコードを取得するように定義できます。

:::hint{type="info"}
デフォルトでは、アプリケーションは 25 件のレコードを取得しますが、取得するように定義できるレコードの最大数は 100 です。
:::

**ベース URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}?$top=\{number of records to display}

:::hint{type="info"}
ビジネス オブジェクト名の末尾に「s」が付いていることを確認します。
:::

:::ExpandableHeading
## レコード数によるビジネス オブジェクトの取得 - 例

定義された数のインシデント レコードを取得する例を次に示します。

| メールアドレス                                 | https\://\{tenant url}/api/odata/businessobject/Incidents?$top=40                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>         | 得る                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ヘッダー名                                   | 認証: JTW トークン/セッション キー/REST API キー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <font color="#ffffff">ステータスコード</font>   | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <font color="#ffffff">レスポンスペイロード</font> | クリックするとレスポンスペイロードが表示されます<br />表示される応答はサンプルのみであり、取得するように定義されたレコードの正確な数は表示されず、すべてのフィールドも表示されません。<br />\{<br />"@odata.context": "https\://ism-mastertest-tenant2.ivanticlouddev.com/api/odata/$metadata#incidents",<br />"@odata.count": 572,<br />"価値"： \[<br />\{<br />"ActualCategory\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",<br />"ActualCategory": "Missing Item",<br />"CreatedBy": "JClerk",<br />"CreatedDateTime": "2011-07-24T23:42:48Z",<br />"Email": "KDavidson\@saasitdemo.com",<br />},<br />\{<br />"ActualCategory\_Valid": null,<br />"ActualCategory": null,<br />"CreatedBy": "Email Listener",<br />"CreatedDateTime": "2019-07-05T09:25:41Z",<br />"Email": "Sai.Sagar\@ivanti.com",<br />},<br />\{<br />"ActualCategory\_Valid": "B30A0BC3F3174B22B328D742C24B59C4",<br />"ActualCategory": "Account Lockout",<br />"CreatedBy": "Admin",<br />"CreatedDateTime": "2011-09-20T08:42:00Z",<br />"Email": "mhendrics\@saasitdemo.com",<br />},<br />\{<br />"ActualCategory\_Valid": "4A550AD1778746FCBA65A19A630AC2C9",<br />"ActualCategory": "Printer Failure",<br />"CreatedBy": "Admin",<br />"CreatedDateTime": "2011-03-25T20:42:37Z",<br />"Email": "sharon.lowe\@saasitdemo.com",<br />},<br />\{<br />"ActualCategory\_Valid": "B30A0BC3F3174B22B328D742C24B59C4",<br />"ActualCategory": "Account Lockout",<br />"CreatedBy": "Admin",<br />"CreatedDateTime": "2011-05-10T04:42:00Z",<br />"Email": "BLevitt\@saasitdemo.com",<br />}, |
:::

:::hint{type="info"}
レスポンス ペイロードに表示されるデータはサンプル データのみであり、レスポンスの完全なリストは含まれず、サンプルとしていくつかだけが表示されます。
:::

## 失敗した応答

:::ExpandableHeading
## 空の上限値

シナリオ: Top 値を指定せずにレコードを取得しようとしています。

`https://{tenant url}/api/odata/businessobject/Incidents?$top=`

ヘッダー名:

**認証: セッションキー**

| コード                                             | ISM\_5000                                                                                    |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------- |
| 説明                                              | 無効なリクエスト                                                                                     |
| メッセージ                                           | \{<br />"code": "ISM\_5000",<br />「説明」: 「内部サーバーエラー」、<br />"メッセージ"： ""、<br />"ヘルプ"： ""<br />} |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **500**                                                                                      |
:::

:::ExpandableHeading
## 100件以上のレコードを照会する

シナリオ: 100 件を超えるレコードを取得しようとしています。

`https://{tenant url}/api/odata/businessobject/Incidents?$top=120`

ヘッダー名:

**認証: セッションキー**

| コード                                             | ISM\_5000                                     |
| ----------------------------------------------- | --------------------------------------------- |
| 説明                                              | 無効なリクエスト                                      |
| メッセージ                                           | \[<br />「100 件を超えるレコードをクエリすることはできません。」<br />] |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **500**                                       |
:::
