すべてのプロダクト
Search
ドキュメントセンター

DataWorks:ListMcpServers

最終更新日:Jun 11, 2026

MCPサーバーのページネーション付きリストを取得します。

操作説明

リクエスト

この操作は、アカウント内のすべてのMCPサーバーのページネーション付きリストを取得します。検索キーワードおよび可視性レベルでリストをフィルタリングし、結果の最大数と次ページトークンを指定してページネーションを制御できます。

  • Q: 任意。MCPサーバー名のあいまい検索に使用する検索キーワード。

  • Visibility: 任意。結果をフィルタリングするための可視性レベル。

  • MaxResults: 任意。1ページあたりに返される結果の最大数。デフォルトでは制限は適用されません。

  • NextToken: 任意。前のレスポンスからの次ページトークン。次のページの結果を取得するためにこのパラメータを使用します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

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"
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。