Todos os produtos
Search

Este produto

    Edge Security Acceleration:Get started with Edge KV

    Central de documentação

    Edge Security Acceleration:Get started with Edge KV

    Última atualização: Jun 29, 2026

    Conheça os fundamentos do Edge KV: crie um namespace, leia e grave dados de chave-valor e integre-o à API do Edge Routine.

    Limitações

    Item

    Descrição

    Espaço de armazenamento

    • Uma conta Alibaba Cloud pode ter até 10 GB de espaço de armazenamento.

    • Um único namespace pode ter até 1 GB de espaço de armazenamento.

    Chave-valor

    • Cada chave pode ter até 512 bytes e aceita apenas letras, números, - e _. Caracteres especiais, como espaços ou pontos de interrogação, não são permitidos.

    • Valor: máximo de 1,8 MB.

      Nota

      Cada par chave-valor pertence a um namespace.

    Tempo de sincronização

    O Edge KV garante consistência eventual. A sincronização dos dados para todos os pontos de presença (POPs) geralmente ocorre em segundos, com limite máximo garantido de 300 segundos.

    Limite de acesso

    Os Edge Routines só podem acessar dados do Edge KV na mesma conta Alibaba Cloud. Não há suporte para acesso entre contas.

    Uso do Edge KV

    Após habilitar o Edge KV, gerencie os dados pelo console do ESA (Edge Security Acceleration) ou pela API do Edge Routine.

    image

    Crie um namespace

    Nota

    Os namespaces são isolados. É possível criar até 10 namespaces.

    1. Faça login no ESA console e, no painel de navegação à esquerda, escolha Edge Computing and AI > KV Storage.

    2. Clique em Create Namespace, insira o Namespace Name e a Description.

      Nota

      O Namespace Name corresponde ao parâmetro namespace na API integrada do Edge Routine.

      Create a namespace

    3. Clique em OK.

    Gerencie dados

    Console

    Nota

    O console do ESA aceita valores de até 100 KB. Para valores maiores, use a API do Edge Routine.

    Use o console do ESA para adicionar, modifique ou exclua dados do Edge KV.

    1. Faça login no ESA console e, no painel de navegação à esquerda, escolha Edge Computing and AI > KV Storage.

    2. Na lista de namespaces, localize o namespace desejado e clique em Manage na coluna Actions.

    3. Clique em Add Key-Value Pair, insira a Key e o Value.8

    4. Clique em OK.

    5. (Opcional) Após adicionar os dados, clique em Modify, View ou Delete para gerenciá-los.

    API

    Use a API integrada do Edge Routine para adicionar, modifique, consultar ou exclua dados do Edge KV.

    Importante

    • Crie um namespace no console do ESA antes de usar a API. Consulte a API do Edge KV.

    1. Chame o Constructor e passe o parâmetro de namespace para criar um objeto chave-valor.

      O Namespace Name é o nome do namespace criado no console, conforme exibido na lista de namespaces.

      const edgeKv = new EdgeKV({ namespace: "ns"});

    2. Após criar o objeto chave-valor, chame estas APIs integradas.

      API

      Descrição

      get

      Lê dados de um namespace.

      put

      Grava ou atualiza dados de chave-valor em um namespace.

      delete

      Exclui uma chave e seu valor de um namespace.