工具:list_changelogs
列出指定应用中的更改日志。
以下示例演示了如何使用 curl 调用 list_changelogs MCP 工具。
| Curl 请求 |
|---|
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_changelogs", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
输入架构
AgentService.ListChangelogs 的请求消息。
ListChangelogsRequest
| JSON 表示法 |
|---|
{ "parent": string, "pageSize": integer, "pageToken": string, "filter": string, "orderBy": string } |
| 字段 | |
|---|---|
parent |
必需。要列出相应应用的更改日志的应用的资源名称。 |
pageSize |
可选。请求的页面大小。 服务器返回的项可能要比请求的少。如果未指定,服务器将选择合适的默认值。 |
pageToken |
可选。从上一次列表 |
filter |
可选。列出更改日志时要应用的过滤条件。如需了解详情,请参阅 https://google.aip.dev/160。 过滤字符串可用于按 示例:* |
orderBy |
可选。要排序的字段。仅支持“name”和“create_time”。如需了解详情,请参阅 https://google.aip.dev/132#ordering。 |
输出架构
AgentService.ListChangelogs 的响应消息。
ListChangelogsResponse
| JSON 表示法 |
|---|
{
"changelogs": [
{
object ( |
| 字段 | |
|---|---|
changelogs[] |
更改日志列表。 |
nextPageToken |
可作为 |
更新日志
| JSON 表示法 |
|---|
{ "name": string, "author": string, "displayName": string, "description": string, "resource": string, "resourceType": string, "action": string, "originalResource": { object }, "newResource": { object }, "dependentResources": [ { object } ], "createTime": string, "sequenceNumber": string } |
| 字段 | |
|---|---|
name |
标识符。更改日志的唯一标识符。格式: |
author |
仅限输出。更改作者的电子邮件地址。 |
displayName |
仅限输出。相应变更的显示名称。它通常应该是已更改资源的显示名称。 |
description |
仅限输出。更改的说明,通常会捕获资源中已更改的字段。 |
resource |
仅限输出。已更改的资源。 |
resourceType |
仅限输出。已更改的资源类型。 |
action |
仅限输出。对资源执行的操作。 |
originalResource |
仅限输出。更改前的原始资源。 |
newResource |
仅限输出。更改后的新资源。 |
dependentResources[] |
仅限输出。已更改的相关资源。 |
createTime |
仅限输出。做出更改的时间。 采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例: |
sequenceNumber |
仅限输出。变更日志的单调递增的序列号。 |
结构体
| JSON 表示法 |
|---|
{ "fields": { string: value, ... } } |
| 字段 | |
|---|---|
fields |
无序的动态类型值映射。 包含一系列 |
FieldsEntry
| JSON 表示法 |
|---|
{ "key": string, "value": value } |
| 字段 | |
|---|---|
key |
|
value |
|
值
| JSON 表示法 |
|---|
{ // Union field |
| 字段 | |
|---|---|
联合字段 kind。值的类型。kind 只能是下列其中一项: |
|
nullValue |
表示 null 值。 |
numberValue |
表示双精度值。 |
stringValue |
表示字符串值。 |
boolValue |
表示布尔值。 |
structValue |
表示结构化值。 |
listValue |
表示重复的 |
ListValue
| JSON 表示法 |
|---|
{ "values": [ value ] } |
| 字段 | |
|---|---|
values[] |
动态类型值的重复字段。 |
时间戳
| JSON 表示法 |
|---|
{ "seconds": string, "nanos": integer } |
| 字段 | |
|---|---|
seconds |
表示世界协调时间 (UTC) 的秒数(从 Unix 纪元 1970-01-01T00:00:00Z 开始算起)。必须介于 -62135596800 到 253402300799 之间(含边界值),对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。 |
nanos |
秒数的非负小数部分(以纳秒为单位)。此字段是时长的纳秒部分,而不是秒的替代项。对于含小数部分的负秒数,仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间(含边界值)。 |
工具注释
破坏性提示:❌ | 等幂性提示:✅ | 只读提示:✅ | 开放世界提示:❌