ListContextModels - Simple Log Service: Central de Documentação do Alibaba Cloud

Descrição da operação

Descrição da solicitação

Esta operação consulta os recursos ContextModel na conta atual e os retorna em ordem decrescente de hora de atualização.
Três tipos de filtros são suportados e podem ser combinados (relação AND): filtro aproximado por nome (name), filtro aproximado por nome, nome de exibição ou descrição (keyword) e pesquisa reversa exata por projeto referenciado (projectName).
O parâmetro de paginação page começa em 1. Se page ou size exceder o intervalo válido, o servidor o trunca para o valor limite sem retornar um erro.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

log:ListContextModels

list

*All resources.

*

Nenhuma

Sintaxe da solicitação

GET /context-models HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
page	integer	Não	O número da página. O valor começa em 1.	1
size	integer	Não	O número de recursos ContextModel a serem retornados em cada página. Valores válidos: 1 a 1000.	20
name	string	Não	A palavra-chave usada para filtragem aproximada por nome. Este parâmetro corresponde apenas ao nome e não corresponde à descrição. Pode ser combinado com o parâmetro keyword.	order
keyword	string	Não	A palavra-chave usada para filtragem aproximada. Este parâmetro corresponde ao nome, nome de exibição e descrição.	order
projectName	string	Não	Consulta por relação de referência. Apenas os recursos ContextModel que referenciam o projeto especificado em sources são retornados. Este parâmetro é usado para verificar quais recursos ContextModel referenciam um projeto específico. O valor deve ser o nome completo do projeto e é processado por correspondência exata, sem correspondência aproximada. Por exemplo, se você especificar order-prod, modelos que referenciam apenas order-prod-canary não são retornados. O valor deve ser um nome de projeto válido. Caso contrário, um erro 400 é retornado.	cn-hangzhou-app-logs

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta. Retorna uma lista paginada de resumos de modelos de contexto.
items	array<object>	A lista de resumos de modelos de contexto na página atual, classificada em ordem decrescente de hora de atualização. Se nenhuma correspondência for encontrada ou se o número da página estiver fora dos limites, um array vazio [] é retornado. Os resumos não incluem sources e updatedAt. Para obter informações completas, chame GetContextModel.
	object	As informações de resumo de um único modelo de contexto.
createdAt	string	A hora em que o modelo foi criado. A hora está no formato RFC 3339 UTC, como 2026-07-09T05:33:37Z.	2026-07-09T05:33:37Z
description	string	A descrição do modelo. A descrição pode ter até 1.024 caracteres de comprimento. Se nenhuma descrição for especificada, uma string vazia "" é retornada.	End-to-end coverage from order creation to payment
displayName	string	O nome de exibição. Se nenhum nome de exibição for definido, uma string vazia "" é retornada, e o valor não é preenchido retroativamente com name. Ao exibir o nome, use displayName \|\| name como fallback.	Order analysis model
name	string	O identificador do modelo de contexto. O identificador é exclusivo na mesma conta Alibaba Cloud e não pode ser modificado após a criação. Pode ser passado como um parâmetro de caminho para operações como GetContextModel.	orders
page	integer	O número real da página que entra em vigor. Se o número da página especificado for menor que 1, ele será processado como 1.	1
size	integer	O tamanho real da página que entra em vigor. Se o valor especificado for menor que 1, o valor padrão 20 será usado. Se o valor especificado for maior que 1000, ele será processado como 1000.	20
total	integer	O número total de modelos de contexto que atendem às condições de filtro. Este valor não é afetado pela paginação.	4

Exemplos

Resposta de sucesso

JSON formato

{
  "items": [
    {
      "createdAt": "2026-07-09T05:33:37Z",
      "description": "End-to-end coverage from order creation to payment",
      "displayName": "Order analysis model",
      "name": "orders"
    }
  ],
  "page": 1,
  "size": 20,
  "total": 4
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.