ミューテーションは、Blocklet Server上のデータを作成、更新、または削除するために使用されるGraphQL操作です。@blocklet/server-js ライブラリは、これらのミューテーションをラップする便利なメソッドのセットを提供し、アプリケーションから書き込み操作を簡単に行えるようにします。
このセクションでは、利用可能なミューテーションのカテゴリの概要を説明します。パラメータや戻り値の型を含む特定のメソッドの詳細については、個々のサブセクションを参照してください。データを変更せずに取得する必要がある場合は、クエリセクションを参照してください。
すべてのミューテーションメソッドは同様のパターンに従います。つまり、必須のGraphQL入力タイプに対応する input プロパティを持つオブジェクトを受け入れます。
ミューテーションの呼び出し
import BlockletServerClient from '@blocklet/server-js';
const client = new BlockletServerClient();
async function updateNodeName() {
try {
const { info } = await client.updateNodeInfo({
input: {
name: '私の素晴らしいノード',
description: 'これは私の新しく更新されたノードです。'
}
});
console.log('ノードが正常に更新されました:', info.name);
} catch (error) {
console.error('ノード情報の更新に失敗しました:', error);
}
}
updateNodeName();ミューテーションのカテゴリ
ミューテーションは機能ごとにグループ化されており、必要なメソッドをより簡単に見つけることができます。
ノードとBlockletの管理
ノードと個々のBlockletのライフサイクル（インストール、開始、停止、削除）、設定、およびセッティングを管理するためのミューテーション。
ユーザーとアクセスの管理
ユーザー、ロール、権限、アクセスキーを作成、更新、削除するためのメソッド。セッションとパスポートの管理も含まれます。
ネットワーキングとサービス
ルーティングルールの設定、ドメインエイリアスの管理、SSL証明書の発行と更新、Webhookの設定を行うための操作。
データと操作
Blockletバックアップの作成や復元などの運用タスクを実行するためのミューテーション。
公開とプロジェクト
プロジェクトの作成、リリースの下書き、ストアへの接続、Blockletの公開など、公開ワークフロー全体を管理します。
次のステップ
ミューテーションを調べた後、それらが返すデータ構造を理解したいと思うかもしれません。すべてのデータモデルの完全なリファレンスについては、型セクションを確認してください。