ListKvs - Edge Security Acceleration: Central de Documentação do Alibaba Cloud

Lista todos os pares de chave-valor em um namespace de armazenamento KV especificado na sua conta.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Namespace	string	Sim	O nome especificado ao chamar CreatevNamespace.	test_namespace
PageSize	integer	Não	O tamanho da página. Valor padrão: 50. Valor máximo: 100.	50
PageNumber	integer	Não	O número da página. O produto de PageNumber e PageSize não pode exceder 50000.	10
Prefix	string	Não	O prefixo usado para filtrar chaves.	prefix-

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	0AEDAF20-4DDF-4165-8750-47FF9C1929C9
PageSize	integer	O número de registros por página.	50
PageNumber	integer	O número total de páginas.	100
TotalCount	integer	O número total de registros.	1024
Keys	array<object>	A lista de pares de chave-valor recuperada nesta iteração.
	object
Name	string	O nome da chave.	Key1
UpdateTime	string	O horário em que a chave foi atualizada pela última vez, no formato ISO 8601 (por exemplo, 2024-01-01T00:00:00+Z).	2021-12-13T07:46:03Z

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0AEDAF20-4DDF-4165-8750-47FF9C1929C9",
  "PageSize": 50,
  "PageNumber": 100,
  "TotalCount": 1024,
  "Keys": [
    {
      "Name": "Key1",
      "UpdateTime": "2021-12-13T07:46:03Z"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidAccount.Malformed	The specified account is invalid.	The account number is not entered correctly, for example, the input is empty.
400	InvalidNameSpace.Malformed	The specified namespace is invalid.	The bucket name is entered incorrectly, such as an empty string.
400	InvalidKey.Malformed	The specified key is invalid.	Key name input error, such as entering an empty string.
400	InvalidKey.ExceedsMaximum	The size of the key cannot exceed 512 bytes.	The length of the requested key is too large.
400	InvalidValue.ExceedsMaximum	The size of the value cannot exceed 2,000,000 bytes.	The value deposited is too large.
403	InvalidKey.ExceedsCapacity	The maximum capacity of a single namespace cannot exceed 1 GB.	The capacity of the storage space exceeds the limit.
403	Unauthorized.InvalidParameters	The specified authentication parameters are invalid.	Authentication parameter input error.
403	Unauthorized.InvalidTime	The specified authentication time is invalid.	The authentication time parameter you entered is invalid. Check the parameter value and try again.
403	Unauthorized.InvalidToken	Token authentication failed.	The token you entered is invalid. Please check and enter the correct token and try again.
404	InvalidAccount.NotFound	The specified account does not exist.	The specified account does not exist.
404	InvalidNameSpace.NotFound	The specified namespace does not exist.
404	InvalidKey.NotFound	The specified key does not exist.	The specified key-value pair does not exist.
406	InvalidNameSpace.Duplicate	The specified namespace already exists.	Specified storage space
406	InvalidNameSpace.QuotaFull	The maximum number of namespaces is exceeded.	The number of storage spaces exceeds the capacity limit.
429	TooManyRequests	Too many requests are submitted.	Submissions are too frequent, please try again later
429	TooQuickRequests	Request for putting or deleting keys are frequently submitted.	The modification or deletion of key-value pairs is too frequent.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.