Edge KV の開始方法

更新日時
Copy as MD

Edge KV の基本として、名前空間の作成、キーと値のデータの読み書き、Edge Routine API との統合について学習します。

制限事項

項目

説明

ストレージ容量

  • 1 つの Alibaba Cloud アカウントで、最大 10 GB のストレージ容量を使用できます。

  • 1 つの名前空間で、最大 1 GB のストレージ容量を使用できます。

キーと値

  • 各キーは最大 512 バイトで、使用できる文字は英字、数字、-_ のみです。スペースやクエスチョンマークなどの特殊文字は使用できません。

  • 値:最大 1.8 MB。

    説明

    各キーと値のペアは、いずれかの名前空間に属します。

同期時間

Edge KV は結果整合性を保証します。データは通常、数秒以内にすべての POP (Point of Presence) に同期され、300 秒以内の同期が保証されています。

アクセス制限

Edge Routine は、同一の Alibaba Cloud アカウント内の Edge KV データにのみアクセスできます。クロスアカウントアクセスはサポートしていません。

Edge KV の使用

Edge KV を有効化した後、ESA (Edge Security Acceleration) コンソールまたは Edge Routine API を使用してデータを管理します。

image

名前空間の作成

説明

名前空間は互いに分離されています。最大 10 個の名前空間を作成できます。

  1. ESA コンソールにサインインします。左側のナビゲーションペインで、エッジコンピューティング > エッジストレージを選択します。

  2. ネームスペースを作成をクリックし、スペース名説明を入力します。

    説明

    スペース名 は、Edge Routine 組み込み API の namespace パラメーターに対応します。

    Create a namespace

  3. OK をクリックします。

データの管理

コンソール

説明

ESA コンソールでは、最大 100 KB の値までサポートしています。より大きい値については、Edge Routine API を使用してください。

ESA コンソールを使用して、Edge KV データを追加、変更、または削除できます。

  1. ESA コンソールにサインインします。左側のナビゲーションペインで、エッジコンピューティング > エッジストレージを選択します。

  2. 名前空間リストで目的の名前空間を見つけ、操作 列の 管理 をクリックします。

  3. Key-Value ペアを追加 をクリックし、キー を入力します。8

  4. OK をクリックします。

  5. (任意) データを追加した後、変更表示、または削除 をクリックして管理します。

API

Edge Routine の組み込み API を使用して、Edge KV データを追加、変更、クエリ、または削除できます。

重要
  • API を使用する前に、ESA コンソールで名前空間を作成してください。詳細については、Edge KV API をご参照ください。

  1. コンストラクターを呼び出し、namespace パラメーターを渡してキーバリューオブジェクトを作成します。

    スペース名 は、コンソールで作成した名前空間名であり、名前空間リストに表示されます。

    const edgeKv = new EdgeKV({ namespace: "ns"});
  2. キーバリューオブジェクトを作成した後、次の組み込み API を呼び出します。

    API

    説明

    get

    名前空間からデータを読み取ります。

    put

    名前空間にキーと値のデータを書き込むか、更新します。

    delete

    名前空間からキーとその値を削除します。