Todos os produtos
Search
Central de documentação

DataWorks:StopInstance

Última atualização: Oct 12, 2026

Encerra uma instância.

Descrição da operação

Mecanismo e precauções para o encerramento de instâncias:

  1. O encerramento da instância é uma operação assíncrona. O envio de uma solicitação de encerramento não significa que a instância pare imediatamente. Consulte continuamente o status da instância após a solicitação para confirmar o resultado do encerramento. Se houver recursos de computação externos envolvidos, verifique o status real do job remoto.

  2. O status da instância do DataWorks pode não ser consistente com o status do job remoto. Para tarefas que dependem de recursos de computação externos, como MaxCompute, EMR e SSH, o DataWorks envia uma solicitação de encerramento para o destino remoto por meio de um cliente. Devido a fatores como exceções de rede e compatibilidade do cliente, a instância do DataWorks pode ser marcada como falha enquanto o job remoto ainda está em execução. Portanto, você não pode determinar que o job remoto foi encerrado baseando-se apenas no status da instância do DataWorks. Verifique a plataforma de computação correspondente e encerre o job manualmente, se necessário, para evitar que o job continue em execução ou consuma recursos adicionais.

  3. Preste atenção especial às tarefas do MaxCompute no grupo de recursos de agendamento compartilhado. O grupo de recursos de agendamento compartilhado do DataWorks será desativado em breve. Devido a limites nas versões dos componentes e na compatibilidade, as instruções de encerramento para algumas tarefas do MaxCompute podem não ter efeito no destino remoto. Nesses casos, acesse o MaxCompute para verificar o status real da instância correspondente. Se ainda estiver em execução, execute a operação kill no MaxCompute e confirme novamente se foi encerrada.

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

InstanceId

integer

Sim

O ID da instância. Você pode chamar ListInstances para consultar o ID da instância.

1234

ProjectEnv

string

Sim

O ambiente do workspace. Valores válidos: PROD (ambiente de produção) e DEV (ambiente de desenvolvimento).

Valores válidos:

  • PROD :

    Ambiente de produção.

  • DEV :

    Ambiente de desenvolvimento.

PROD

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

HttpStatusCode

integer

O código de status HTTP.

200

Data

boolean

Os detalhes do resultado retornado após a instância ser interrompida.

true

ErrorMessage

string

A mensagem de erro.

The connection does not exist.

RequestId

string

O ID da solicitação. Você pode usar este ID para localizar logs e solucionar problemas.

E6F0DBDD-5AD****

ErrorCode

string

O código de erro.

Invalid.Tenant.ConnectionNotExists

Success

boolean

Indica se a chamada foi bem-sucedida.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "HttpStatusCode": 200,
  "Data": true,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "E6F0DBDD-5AD****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true
}

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.