すべてのプロダクト
Search
ドキュメントセンター

Edge Security Acceleration:Edge KV の概要

最終更新日:Jun 23, 2025

このトピックでは、エッジストレージが提供するコア機能の基本操作について説明します。 簡略化された手順、コード例、および重要な考慮事項を提供することにより、名前空間の作成、データの読み取りと書き込み、および API の統合を迅速に行う方法を説明します。

始める前に

エッジストレージを使用する前に、以下の点に注意してください。

  • ストレージ容量

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

    • 1 つのネームスペースにつき、最大 1 GB のストレージ容量を使用できます。

  • キーと値

    • キーの長さは最大 512 バイトで、使用できる文字は英字、数字、ハイフン(-)、およびアンダースコア(_)のみです。 スペース、スラッシュ(/)、疑問符(?)などの特殊文字は使用できません。

    • 値のサイズは最大 1.8 MB です。

      説明

      各キーと値のペアは、ネームスペースに属しています。

  • 同期時間

    データの整合性を確保するために、データは世界中の配信拠点(POP)に 20 秒以内に同期されます。ただし、まれに 300 秒かかる場合があります。

  • アクセス制限

    エッジルーチンは、同じ Alibaba Cloud アカウントに属するエッジストレージ データのみを読み書きできます。 たとえば、アカウント A の エッジルーチンは、アカウント B の エッジストレージデータを読み書きできません。

エッジストレージの使用

エッジストレージをアクティブ化すると、Edge Security Acceleration (ESA) コンソールで、または エッジルーチン の組み込み API 操作を実行することで、エッジストレージを使用できます。

image

ネームスペースの作成

説明

ネームスペースは互いに分離されています。 最大 10 個のネームスペースを作成できます。

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

  2. 表示されたページで、[ネームスペースを作成] をクリックします。 表示されるダイアログで、画面の指示に従って [スペース名] パラメーターと [説明] パラメーターを指定します。

    説明

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

    创建存储空间

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

エッジストレージ データの管理

ESA コンソールを使用した エッジストレージ データの管理

説明

ESA コンソールでは、最大 100 KB の値を追加できます。 より大きなサイズの値を追加するには、Edge Routine の API 操作を呼び出します。

ESA コンソールで、エッジストレージデータを追加、変更、または削除できます。

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

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

  3. [Key-Value ペアを追加] をクリックし、画面の指示に従って キー パラメーターと パラメーターを指定します。8

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

  5. オプション。 データを追加した後、変更表示、または 削除 をクリックしてデータを管理します。

API 操作を実行してエッジストレージデータを管理する

エッジルーチンの組み込み API 操作を実行して、エッジストレージ データを追加、変更、クエリ、または削除できます。

重要
  • API 操作を実行してデータを管理する前に、ESA コンソールでネームスペースが作成されていることを確認してください。

  • API 操作の詳細については、「Edge KV API 操作」をご参照ください。

  1. コンストラクター 操作を実行して、namespace パラメーターを渡し、キーと値のオブジェクトを作成します。

    namespace パラメーターの値は、ESA コンソールで作成したネームスペースの名前です。 ネームスペースは、ネームスペースリストで確認できます。

    const edgeKv = new EdgeKV({ namespace: "ns"}); // 名前空間 "ns" を使用して EdgeKV オブジェクトを作成
  2. キーと値のオブジェクトを作成した後、以下の組み込み API 操作を実行して、関連機能を実装します。

    • get

      ネームスペースからデータを読み取ります。

    • delete

      ネームスペースから特定のキーとその値を削除します。