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

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:UpdateContextModel

update

*ContextModel

acs:log:{#regionId}:{#accountId}:contextmodel/{#name}

Nenhuma

Sintaxe da solicitação

PUT /context-models/{name} HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
name	string	Não	O identificador do modelo de contexto a ser atualizado. Este valor é obtido do caminho da solicitação /context-models/{name} e deve ser o nome de um modelo existente na conta atual. Apenas letras maiúsculas e minúsculas, dígitos, sublinhados (_) e hifens (-) são suportados. Se o modelo não existir, um erro 404 será retornado. O identificador do modelo em si não pode ser modificado.	orders

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	O corpo da solicitação. Um objeto JSON que contém os campos a serem atualizados. Todos os campos são opcionais. Se um campo não for passado, o valor original será mantido. Se uma string vazia for passada explicitamente, o campo será limpo.
description	string	Não	A descrição do modelo. Se este campo não for passado, o valor original será mantido.	End-to-end coverage from order creation to payment
displayName	string	Não	O nome de exibição. O comprimento máximo é de 256 caracteres e caracteres chineses são suportados. Se este campo não for passado, o valor original será mantido. Se uma string vazia for passada explicitamente, o campo será limpo.	Order analysis model
sources	object	Não	As fontes referenciadas. As chaves são nomes de projetos, portanto, o mesmo projeto não aparece repetidamente. Os valores são arrays de nomes de Logstores selecionados no projeto. A estrutura é exatamente a mesma usada durante a criação: `[""]` indica todos os Logstores no projeto. Caso contrário, é uma lista de nomes exatos de Logstores. Arrays vazios `[]`, a mistura de `[""]` com nomes específicos e nomes contendo `` são todos rejeitados com um erro 400. Se este campo não for passado, o valor original será mantido, pois esta operação é uma atualização parcial e modifica apenas os campos passados. Ao contrário da criação, passar um objeto vazio `{}` é rejeitado com um erro 400. Para desvincular todas as fontes, exclua o modelo e recrie-o. Tempo de efetivação: Após um projeto ou Logstore ser adicionado, o conteúdo geralmente é atualizado em alguns segundos. Após um projeto ou Logstore ser removido*, os elementos sincronizados anteriormente são mantidos por um período de tempo e limpos pela sincronização periódica automática. Durante esse período, eles ainda podem ser consultados.	{"cn-hangzhou-app-logs": ["*"], "cn-hangzhou-order-logs": ["accesslog", "errorlog"]}
	array	Não	A lista de nomes de Logstores a serem selecionados no projeto. Deve ser um array não vazio. `["*"]` indica todos os Logstores no projeto e não pode ser misturado com nomes específicos de Logstores.
	string	Não	O nome do Logstore no projeto. O Logstore deve existir e seu projeto pai deve pertencer à conta atual. Curingas e correspondência de prefixo não são suportados. Nomes contendo um asterisco (*) são rejeitados.	order-log

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O corpo da resposta. Retorna as informações atualizadas do modelo de contexto.
description	string	A descrição atualizada do modelo. O comprimento máximo é de 1.024 caracteres. Se o campo de descrição não for passado nesta solicitação, o valor original será retornado. Se o campo for limpo, uma string vazia "" será retornada.	End-to-end coverage from order creation to payment
displayName	string	O nome de exibição atualizado. Se o campo displayName não for passado nesta solicitação, o valor original será retornado. Se o campo não estiver definido, uma string vazia "" será retornada.	Order analysis model
name	string	O identificador do modelo de contexto, que é o mesmo nome no caminho da solicitação. O identificador é exclusivo na mesma conta Alibaba Cloud e não pode ser modificado após a criação.	orders
sources	object	As fontes atualizadas referenciadas pelo modelo. A estrutura é a mesma da solicitação. Se o campo sources não for passado nesta solicitação, o valor original será retornado. Se nenhuma fonte for referenciada, um objeto vazio `{}` será retornado.	{"cn-hangzhou-app-logs": ["*"], "cn-hangzhou-order-logs": ["accesslog", "errorlog"]}
	array	A lista de nomes de Logstores selecionados no projeto, que é um array de strings. `["*"]` indica todos os Logstores no projeto e não pode ser misturado com nomes específicos de Logstores.
	string	O nome do Logstore selecionado no projeto. Um valor de "*" indica todos os Logstores no projeto.	order-log
updatedAt	string	A hora em que o modelo foi atualizado pela última vez. A hora está no formato UTC RFC 3339, como 2026-07-09T05:33:37Z. Este campo é atualizado após o nome de exibição, a descrição ou as fontes serem modificados.	2026-07-09T05:33:37Z

Exemplos

Resposta de sucesso

JSON formato

{
  "description": "End-to-end coverage from order creation to payment",
  "displayName": "Order analysis model",
  "name": "orders",
  "sources": {
    "key": [
      "order-log"
    ]
  },
  "updatedAt": "2026-07-09T05:33:37Z"
}

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.