工具:reschedule_maintenance
重新安排 Memorystore for Valkey 執行個體的維護時間。
以下範例示範如何使用 curl 叫用 reschedule_maintenance MCP 工具。
| Curl 要求 |
|---|
curl --location 'https://memorystore.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "reschedule_maintenance", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
輸入內容的結構定義
要求重新排定執行個體維護時間。
RescheduleMaintenanceRequest
| JSON 表示法 |
|---|
{
"name": string,
"rescheduleType": enum ( |
| 欄位 | |
|---|---|
name |
這是必要旗標,要重新安排維護時間的執行個體名稱: |
rescheduleType |
這是必要旗標,如果重新安排類型為 SPECIFIC_TIME,則必須設定 schedule_time。 |
scheduleTime |
選用。如果 reschedule_type=SPECIFIC_TIME,則為維護作業應重新排定的時間戳記,採用 RFC 3339 格式。範例: 使用 RFC 3339,產生的輸出內容一律會經過 Z 正規化,並使用 0、3、6 或 9 個小數位數,也接受「Z」以外的偏移量。範例: |
時間戳記
| JSON 表示法 |
|---|
{ "seconds": string, "nanos": integer } |
| 欄位 | |
|---|---|
seconds |
代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含),對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。 |
nanos |
以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分,並非秒數的替代值。如果秒數值為負數,且包含小數,奈秒值仍須為非負數,且會向前計時。必須介於 0 至 999,999,999 之間 (含)。 |
輸出內容的結構定義
這個資源表示屬於網路 API 呼叫結果的長時間執行作業。
作業
| JSON 表示法 |
|---|
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // Union field |
| 欄位 | |
|---|---|
name |
伺服器指派的名稱,而且只有在當初傳回這個名稱的服務中是不重複項目。如果您使用預設的 HTTP 對應,則 |
metadata |
與作業相關聯的服務專屬中繼資料,通常包含進度資訊和常用中繼資料 (例如建立時間)。部分服務可能不會提供這類中繼資料。凡是會傳回長時間執行作業的方法,都應記錄中繼資料類型 (如有)。 包含任意類型欄位的物件。額外的 |
done |
如果值為 |
聯集欄位 result。這是作業的執行結果,可能為 error,或是有效的 response。如果 done == false,系統不會將結果設定為 error 或 response。如果 done == true,系統只能將結果設定為 error 或 response。部分服務可能不會提供結果。result 只能是下列其中一個設定: |
|
error |
作業失敗或取消時顯示的錯誤結果。 |
response |
作業執行成功時的一般回應。如果原始方法在執行成功時沒有傳回資料 (例如 包含任意類型欄位的物件。額外的 |
不限
| JSON 表示法 |
|---|
{ "typeUrl": string, "value": string } |
| 欄位 | |
|---|---|
typeUrl |
以 URI 參照識別序列化 Protobuf 訊息的類型,該參照由以斜線結尾的前置字串和完整合格的類型名稱組成。 範例:type.googleapis.com/google.protobuf.StringValue 這個字串至少須包含一個 前置字元是任意的,Protobuf 實作項目應會直接去除最後一個 所有型別網址字串都必須是合法的 URI 參照,且參照內容只能包含英數字元、百分比編碼逸出字元,以及下列字元集中的字元 (不含外側的反引號): 在 |
value |
保存 type_url 所描述類型的 Protobuf 序列化。 Base64 編碼字串。 |
狀態
| JSON 表示法 |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| 欄位 | |
|---|---|
code |
狀態碼,應為 |
message |
向開發人員顯示的錯誤訊息,應以英文呈現。所有面向使用者的錯誤訊息都應經過本地化,並透過 |
details[] |
包含錯誤詳細資料的訊息清單。這是供 API 使用的一組常用訊息類型。 包含任意類型欄位的物件。額外的 |
工具註解
破壞性提示:❌ | 等冪提示:❌ | 唯讀提示:❌ | 開放世界提示:❌