MaxCompute:GetLogviewDownloadUrl

Gera o arquivo Logview offline para uma instância do MaxCompute especificada e retorna uma URL de download pré-assinada do Object Storage Service (OSS).

Procedimento

1. Especifique o nome do projeto usando o parâmetro de caminho project e especifique o ID da instância no projeto usando o parâmetro instance.

2. Defina useVpcEndpoint com base no ambiente de download. Se este parâmetro não for especificado ou for definido como false, o endpoint padrão do OSS será usado. Se este parâmetro for definido como true, o endpoint de VPC do OSS configurado no servidor será usado. O cliente de download deve ter acesso de rede ao endpoint selecionado.

3. Obtenha a URL no campo data na resposta de sucesso e faça o download do arquivo dentro do período de validade do link. O link expira 10 minutos após ser gerado. Se o link expirar, chame esta operação novamente para obter um novo link.

Notas sobre o arquivo e o uso

• O arquivo baixado é nomeado como logview_detail_{project}_{instance}.txt. O conteúdo do arquivo são dados do Logview offline no formato JSON codificado em UTF-8. Os dados específicos variam com base no tipo de tarefa da instância e nas informações disponíveis, e não há garantia de que incluam os resultados da execução.

• Cada chamada reconstrói os dados do Logview offline e faz o upload deles. O mesmo caminho de objeto de arquivo é usado para o mesmo projeto e instância, e um upload subsequente substitui o conteúdo anterior.

• Esta operação retorna uma URL de download em caso de sucesso e não retorna diretamente um fluxo de arquivo. Uma resposta de sucesso identifica a solicitação por requestId e retorna o link de download no campo data. Os campos httpCode, errorCode e errorMsg são campos de resposta comuns. Eles não recebem valores quando esta operação é processada com sucesso, mas não há garantia de que sejam omitidos da resposta.

• Se useVpcEndpoint for definido como true e nenhum endpoint de VPC do OSS estiver configurado no servidor, a geração do link falhará e não haverá fallback automático para o endpoint padrão.

• A URL de exemplo no campo data é mascarada e usada apenas para ilustrar o formato. Ela não pode ser usada para downloads reais.

Em caso de sucesso, obtenha o link de download em data. requestId é usado para solucionar problemas da solicitação. O exemplo a seguir mostra apenas os campos que recebem valores em caso de sucesso e não representa a resposta bruta completa. Se os campos comuns retornam null ou são omitidos, isso está sujeito à resposta real.

{
  "requestId": "0be3e0aa16667684362147582e038f",
  "data": "https://example-bucket.oss-cn-hangzhou.aliyuncs.com/logview/offline/logview_detail_odps_project_20260409110419512gx6ofeaj8fb.txt?OSSAccessKeyId=LTAI5tExample****&Expires=1791777900&Signature=example****"
}

Os valores de exemplo na tabela de parâmetros ilustram o formato de cada campo e não devem ser combinados em uma resposta completa para uma única chamada. O valor NO_PERMISSION para errorCode e o valor Forbidden para errorMsg são exemplos de erros de permissão comuns. Eles não pertencem à resposta de sucesso anterior e não indicam que esta operação sempre retorna esses erros. O valor 200 para httpCode é um exemplo de formato para o campo de código de status e não indica que este campo sempre recebe este valor em caso de sucesso.