变更是用于在 Blocklet Server 上创建、更新或删除数据的 GraphQL 操作。@blocklet/server-js 库提供了一组方便的方法来包装这些变更,使您可以轻松地从应用程序执行写入操作。
本节概述了可用的变更类别。有关具体方法(包括参数和返回类型)的详细信息,请参阅各个子章节。如果您需要获取数据而不进行修改,请参阅 查询 部分。
所有变更方法都遵循相似的模式:它们接受一个包含 input 属性的对象,该属性对应于所需的 GraphQL 输入类型。
调用变更
import BlockletServerClient from '@blocklet/server-js';
const client = new BlockletServerClient();
async function updateNodeName() {
try {
const { info } = await client.updateNodeInfo({
input: {
name: 'My Awesome Node',
description: 'This is my newly updated node.'
}
});
console.log('节点更新成功:', info.name);
} catch (error) {
console.error('更新节点信息失败:', error);
}
}
updateNodeName();变更类别
变更按功能分组,以帮助您更轻松地找到所需的方法。
节点与 Blocklet 管理
用于管理节点和单个 Blocklet 的生命周期(安装、启动、停止、删除)、配置和设置的变更。
用户与访问管理
用于创建、更新和删除用户、角色、权限和访问密钥的方法。还包括会话和通行证管理。
网络与服务
用于配置路由规则、管理域名别名、颁发和更新 SSL 证书以及设置 Webhook 的操作。
数据与运营
用于执行创建和恢复 Blocklet 备份等运营任务的变更。
发布与项目
管理整个发布工作流程,包括创建项目、起草版本、连接到商店以及发布 Blocklet。
后续步骤
在探索了变更之后,您可能希望了解它们返回的数据结构。请查看 类型 部分,以获取所有数据模型的完整参考。