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

Descrição da operação

Cenários

Solicita um slot de upload para um arquivo de referência a fim de preparar um arquivo para a origem singleTableFile de CreateSemanticJob.

Procedimento

Passe o nome do arquivo, o tipo MIME e o tamanho real para esta operação para obter Data.UploadUrl e Data.FileId.
Execute um upload HTTP PUT com o mesmo Content-Type antes que o UploadUrl expire.
Após a conclusão do upload, use FileId como o único elemento de CreateSemanticJob.ReferenceFileIds.

Considerações de segurança

UploadUrl é uma URL PUT pré-assinada de curta duração. O detentor pode gravar no objeto correspondente. Não registre em log, compartilhe ou persista esta URL.

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
FileName	string	Sim	O nome original do arquivo de referência a ser carregado. Comprimento máximo: 255 caracteres. Quando singleTableFile usa um FileId, apenas arquivos CSV ou XLSX são suportados.	reference.pdf
ContentType	string	Sim	O tipo MIME do objeto a ser carregado. Comprimento máximo: 128 caracteres. Este valor é incluído na assinatura do UploadUrl. Use o mesmo Content-Type ao executar a solicitação PUT.	application/pdf
SizeBytes	integer	Sim	O tamanho do arquivo a ser carregado, em bytes. Este valor é registrado como metadados do anexo. Especifique o tamanho real do arquivo.	1024

Construa os parâmetros da solicitação com base na descrição de cada campo de solicitação.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta padrão para solicitar um slot de upload de anexo. Após a conclusão do upload PUT, Data.FileId pode ser usado como a única referência de arquivo em CreateSemanticJob.ReferenceFileIds.
RequestId	string	O ID da solicitação. Usado para localizar logs e solucionar problemas.	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	Indica se a solicitação foi bem-sucedida.
Data	object	As informações do slot de upload de anexo. Faça o upload PUT do arquivo para Data.UploadUrl antes de Data.ExpiresAt e, em seguida, use Data.FileId para criar uma tarefa semântica de arquivo único.
FileId	string	O identificador exclusivo do anexo. Após concluir o upload PUT para UploadUrl, passe este valor para o parâmetro ReferenceFileIds de CreateSemanticJob.	FID1
UploadUrl	string	A URL temporária de upload PUT do OSS. Válida por 30 minutos. Apenas o objeto especificado pode ser carregado. Use o ContentType da solicitação ao executar a solicitação PUT. Não registre em log nem distribua a URL completa.	https://example.com/temporary-upload-url
ExpiresAt	integer	O horário de expiração do UploadUrl, expresso como um timestamp Unix em milissegundos. Após esse horário, chame UploadSemanticFile novamente para solicitar uma nova URL.	1700001800000

Para o significado dos campos de resposta e suas relações com chamadas subsequentes, consulte a descrição de cada campo.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": {
    "FileId": "FID1",
    "UploadUrl": "https://example.com/temporary-upload-url",
    "ExpiresAt": 1700001800000
  }
}

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.