UpdateCrawler - DataWorks: Central de Documentação do Alibaba Cloud

Atualiza o grupo de recursos, o escopo de coleta, o agendamento e as configurações de extensão de um rastreador de metadados especificado.

Descrição da operação

Cenários

Atualiza parcialmente o grupo de recursos, o escopo de coleta, o agendamento, a descrição de metadados por IA ou as configurações de extensão de um rastreador de metadados especificado.

Fluxo de trabalho recomendado

Chame GetCrawler para consultar as configurações atuais.
Chame GetCrawlerTypeCapabilities para verificar as capacidades de configuração suportadas pelo tipo de rastreador.
Chame esta operação apenas com os campos que você deseja atualizar.

Requisitos de edição

É necessária a Edição Básica do DataWorks ou uma edição mais avançada.

Precauções

Pelo menos um campo atualizável deve ser fornecido. Os campos não fornecidos permanecem inalterados.

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.

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Id	integer	Sim	O ID do rastreador de metadados. Você pode chamar ListCrawlers para consultar os IDs dos rastreadores.	1234
ResourceGroupId	string	Não	O ID do grupo de recursos Serverless 2.0 usado para executar a tarefa de coleta. Se este parâmetro é suportado e se é obrigatório depende das capacidades retornadas por GetCrawlerTypeCapabilities. Se este parâmetro não for especificado, o valor existente permanece inalterado.	Serverless_res_group_1234567890123456_1234567890
Scope	object	Não	A configuração do escopo de coleta. Se este parâmetro for especificado, o escopo de coleta será atualizado. Se este parâmetro não for especificado, o valor existente permanece inalterado.
Unit	string	Sim	A granularidade do escopo de coleta. Os valores válidos são determinados pelos SupportedScopeUnits retornados por GetCrawlerTypeCapabilities.	DATABASE
Items	array	Não	A lista de nomes de bancos de dados. Este parâmetro é suportado apenas quando Unit está definido como DATABASE. São permitidas no máximo 1.000 entradas. Os nomes não podem estar vazios nem duplicados.
	string	Não	Um único nome de banco de dados. O nome pode ter até 256 caracteres.	example_database
ExcludeRegex	string	Não	A expressão regular usada para excluir objetos do escopo de coleta. Este parâmetro é suportado apenas quando SupportExcludeRegex retornado por GetCrawlerTypeCapabilities está definido como true.	^tmp_.*
ScheduleConfig	object	Não	A configuração de agendamento. Se este parâmetro for especificado, o método de agendamento será atualizado. Se este parâmetro não for especificado, o valor existente permanece inalterado.
Type	string	Sim	O tipo de agendamento. MANUAL indica execução manual. NORMAL indica agendamento periódico. As fontes de dados no ambiente de desenvolvimento suportam apenas MANUAL. A disponibilidade de NORMAL depende do valor SupportSchedule retornado por GetCrawlerTypeCapabilities.	NORMAL
CronExpress	string	Não	A expressão cron de seis campos para agendamento periódico. Este parâmetro é obrigatório quando Type está definido como NORMAL. O campo de segundos deve ser 0 e a frequência de agendamento não pode exceder uma vez por hora.	0 0 2 ? * *
EnableAiComment	boolean	Não	Especifica se a descrição de metadados por IA deve ser ativada. Este parâmetro é suportado apenas quando SupportAiComment retornado por GetCrawlerTypeCapabilities está definido como true. Se este parâmetro não for especificado, o valor existente permanece inalterado.
Options	object	Não	As configurações de extensão para o tipo de rastreador. Apenas os itens de configuração especificados são atualizados. Os itens de configuração não especificados permanecem inalterados. As chaves e valores suportados são determinados pelos SupportedOptionKeys retornados por GetCrawlerTypeCapabilities.
	string	Não	O valor de um único item de configuração de extensão do rastreador. Os itens de configuração suportados, tipos de valor e intervalos de valor são determinados pelos SupportedOptionKeys retornados por GetCrawlerTypeCapabilities.	v1

Pelo menos um dos seguintes parâmetros deve ser fornecido: ResourceGroupId, Scope, ScheduleConfig, EnableAiComment ou Options. Os campos não fornecidos permanecem inalterados.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação. Você pode usar este ID para localizar logs e solucionar problemas.	9252F32F-D855-549E-8898-61CF5A733050
Success	boolean	Indica se a solicitação foi bem-sucedida.
Id	integer	O ID do rastreador de metadados atualizado.	1234

Id é o ID do rastreador de metadados atualizado.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "9252F32F-D855-549E-8898-61CF5A733050",
  "Success": false,
  "Id": 1234
}

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.