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: Sep 29, 2026

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

    Limitações

    Item

    Description

    Espaço de armazenamento

    • Uma conta do 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 de chave-valor pertence a um namespace.

    Tempo de sincronização

    O Edge KV garante consistência eventual. Os dados geralmente são sincronizados para todos os pontos de presença (POPs) em segundos, com garantia de até 300 segundos.

    Limite de acesso

    Edge Routines só podem acessar dados do Edge KV dentro da mesma conta do Alibaba Cloud. O acesso entre contas não é compatível.

    Usar o Edge KV

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

    image

    Criar um namespace

    Nota

    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.

    3. Clique em OK.

    Gerenciar dados

    Console

    Nota

    O ESA console aceita valores de até 100 KB. Para valores maiores, utilize o API reference.

    Use o ESA console para adicionar, modificar ou excluir 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.

    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, modificar, consultar ou excluir dados do Edge KV.

    Importante

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

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

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

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

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

      API

      Description

      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.