MCPサーバーのページネーション付きリストを取得します。
操作説明
リクエスト
この操作は、アカウント内のすべてのMCPサーバーのページネーション付きリストを取得します。検索キーワードおよび可視性レベルでリストをフィルタリングし、結果の最大数と次ページトークンを指定してページネーションを制御できます。
-
Q: 任意。MCPサーバー名のあいまい検索に使用する検索キーワード。
-
Visibility: 任意。結果をフィルタリングするための可視性レベル。
-
MaxResults: 任意。1ページあたりに返される結果の最大数。デフォルトでは制限は適用されません。
-
NextToken: 任意。前のレスポンスからの次ページトークン。次のページの結果を取得するためにこのパラメータを使用します。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Q |
string |
任意 |
MCPサーバー名のあいまい検索に使用する検索キーワード。 |
mcp |
| Visibility |
array |
任意 |
結果をフィルタリングするための可視性レベル。 |
- |
|
string |
任意 |
可視性レベル。有効な値: TENANT (アカウント内で表示)、PROJECT (指定されたプロジェクトに対して表示)、USER (指定されたユーザーに対して表示)。 |
TENANT |
|
| MaxResults |
integer |
任意 |
1ページあたりに返される結果の最大数。 |
20 |
| NextToken |
string |
任意 |
前のレスポンスからの次ページトークン。次のページの結果を取得するためにこのトークンを使用します。最初のリクエストではこのパラメータを空のままにしてください。 |
12345 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスオブジェクト。 |
||
| RequestId |
string |
リクエストID。 |
824F80BA-1778-5D8A-BAFF-668A4D9C4CC7 |
| PagingInfo |
object |
ページング情報。 |
|
| TotalCount |
integer |
フィルタ条件に一致するエントリの総数。 |
100 |
| McpServers |
array<object> |
MCPサーバーオブジェクトのリスト。 |
|
|
array<object> |
|
||
| CreatorId |
string |
805298765622151 |
|
| ModifierId |
string |
123456 |
|
| Name |
string |
my-mcp-server |
|
| Config |
object |
||
| Url |
string |
https://example.com/mcp/sse |
|
| Transport |
string |
SSE |
|
| CustomHeaders |
object |
{} |
|
| Visibility |
string |
TENANT |
|
| GmtCreateTime |
string |
1780555634000 |
|
| GmtModifiedTime |
string |
1780555634000 |
|
| MaxResults |
integer |
現在のページで返される結果の最大数。 |
100 |
| NextToken |
string |
次ページの結果のトークン。null 値はすべての結果が返されたことを示します。 |
2 |
例
成功レスポンス
JSONJSON
{
"RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
"PagingInfo": {
"TotalCount": 100,
"McpServers": [
{
"CreatorId": "805298765622151",
"ModifierId": "123456",
"Name": "my-mcp-server",
"Config": {
"Url": "https://example.com/mcp/sse",
"Transport": "SSE",
"CustomHeaders": {}
},
"Visibility": "TENANT",
"GmtCreateTime": "1780555634000",
"GmtModifiedTime": "1780555634000"
}
],
"MaxResults": 100,
"NextToken": "2"
}
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。