エージェント登録情報のリストを照会します。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストの冪等性を確保します。異なるリクエスト間で一意性を保証するため、クライアント側でパラメーター値を生成してください。ClientToken は ASCII 文字のみをサポートし、長さは 64 文字以下である必要があります。 |
eyJhbGciOiJIUzI1NiIsInR5cC.... |
| PageSize |
integer |
必須 |
ページングクエリのページサイズ。 |
2 |
| PageNumber |
integer |
必須 |
現在のページ番号。開始値は 1 です。デフォルト値: 1。 |
1 |
| AgentId |
string |
任意 |
エージェント ID。実名認証後に CNNIC によって一元的に割り当てられます。AgentID は、エージェントと認証済みの登録者を紐付ける一意の識別子として機能します。 |
liuq@azt400 |
| AgentDisplayName |
string |
任意 |
エージェントの表示名。 |
TestAgent |
| AgentHost |
string |
任意 |
エージェントのホストアドレス。 |
www.example.com |
| AgentVersion |
string |
任意 |
エージェントのバージョン。 |
1.0.0 |
| Status |
string |
任意 |
エージェントのステータス。 |
Active |
| MaxResults |
integer |
任意 |
このリクエストで返すレコードの最大値。 |
100 |
| NextToken |
string |
任意 |
次のクエリのトークン。 |
4698691 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンススキーマ。 |
||
| RequestId |
string |
一意のリクエスト ID。 |
536E9CAD-DB30-4647-AC87-AA5CC38C5382 |
| PageNumber |
integer |
現在のページ番号。開始値は 1 です。デフォルト値: 1。 |
1 |
| PageSize |
integer |
ページングクエリの設定項目における 1 ページあたりのエントリ数。最大値: 100。デフォルト値: 20。 |
20 |
| TotalPages |
integer |
ページの総数。 |
2 |
| TotalItems |
integer |
レコードの総数。 |
11 |
| AgentRegisterInfos |
object |
||
| AgentRegisterInfo |
array<object> |
エージェント情報。 |
|
|
array<object> |
|||
| AgentRegisterInfoId |
string |
エージェント登録 ID。この ID は Alibaba Cloud ATS プラットフォームによって自動的に生成され、プラットフォーム内でグローバルに一意です。 |
2074753647748672512 |
| AgentId |
string |
エージェント ID。実名認証後に CNNIC によって一元的に割り当てられます。AgentID は、エージェントと認証済みの登録者を紐付ける一意の識別子として機能します。 |
ag-6c6392b1d226d6e60f7020ce |
| AgentDisplayName |
string |
エージェントの表示名。 |
TestAgent |
| AgentHost |
string |
エージェントがサービスを提供するエンドポイントのドメイン名。 |
example.com |
| AgentVersion |
string |
エージェントのバージョン。 |
1.0.0 |
| Status |
string |
エージェントのステータス。 |
Active |
| AtiName |
string |
ATI 名。ATI 信頼システムにおけるグローバルに一意な識別子です。例: ati://v1.0.0.www.example.com
|
ati://v1.0.0.www.example.com |
| CreateTimestamp |
string |
作成時間 (タイムスタンプ)。 |
1585808273000 |
| UpdateTimestamp |
string |
インスタンス構成が最後に変更済みとなった時間 (タイムスタンプ)。 |
1729590859000 |
| Endpoints |
object |
||
| Endpoint |
array<object> |
アクセスポート。有効な値:
|
|
|
object |
アクセスポート。有効な値:
|
||
| Protocol |
string |
エージェントのエンドポイントが準拠する通信プロトコル標準を指定します。これにより、呼び出し元がエージェントとどのようにやり取りするかが決定されます。プロトコルの説明: MCP: Model Context Protocol。Anthropic が導入したエージェントツール呼び出しプロトコル。 A2A: Agent-to-Agent Protocol。Google が導入したクロスエージェント通信プロトコル。 OpenAPI: 標準的な RESTful API 仕様 (Swagger/OpenAPI)。 目的: 他のエージェントやクライアントがこのプロトコル ID を確認することで、エージェントの呼び出しにどのメソッドを使用すべきかを判断できます。たとえば、MCP プロトコルでは MCP SDK を使用し、A2A では A2A SDK を使用し、OpenAPI では標準的な HTTP リクエストを使用します。 |
mcp |
| TrustLevel |
string |
||
| NextToken |
string |
次のクエリのトークン。 |
4698691 |
| MaxResults |
integer |
このリクエストで返すレコードの最大値。 |
500 |
| AccessDeniedDetail |
object |
アクセス拒否の詳細。このフィールドは RAM 認証が失敗した場合にのみ返されます。 |
|
| AuthAction |
string |
試行された未承認の操作。 |
CreateUser |
| AuthPrincipalDisplayName |
string |
権限付与プリンシパルの表示名。 |
2015555733387XXXX |
| AuthPrincipalOwnerId |
string |
権限付与プリンシパルのオーナー ID。 |
1046973331XXXX |
| AuthPrincipalType |
string |
ID タイプ。 |
SubUser |
| EncodedDiagnosticMessage |
string |
暗号化された完全な診断メッセージ。 |
AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ== |
| NoPermissionType |
string |
認証失敗の理由。有効な値:
|
ImplicitDeny |
| PolicyType |
string |
ポリシータイプ。 |
DlpSend |
例
成功レスポンス
JSONJSON
{
"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
"PageNumber": 1,
"PageSize": 20,
"TotalPages": 2,
"TotalItems": 11,
"AgentRegisterInfos": {
"AgentRegisterInfo": [
{
"AgentRegisterInfoId": "2074753647748672512",
"AgentId": "ag-6c6392b1d226d6e60f7020ce",
"AgentDisplayName": "测试Agent",
"AgentHost": "example.com",
"AgentVersion": "1.0.0",
"Status": "活跃",
"AtiName": "ati://v1.0.0.www.example.com",
"CreateTimestamp": "1585808273000",
"UpdateTimestamp": "1729590859000",
"Endpoints": {
"Endpoint": [
{
"Protocol": "mcp"
}
]
},
"TrustLevel": ""
}
]
},
"NextToken": "4698691",
"MaxResults": 500,
"AccessDeniedDetail": {
"AuthAction": "CreateUser",
"AuthPrincipalDisplayName": "2015555733387XXXX",
"AuthPrincipalOwnerId": "1046973331XXXX",
"AuthPrincipalType": "SubUser",
"EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
"NoPermissionType": "ImplicitDeny",
"PolicyType": "DlpSend"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。