Retorna a URL de download de artefatos pelo nome do job e um ID de execução opcional após a conclusão de uma execução. Se JobRunId não for especificado, os resultados da execução mais recente do job serão retornados.
Descrição da operação
Cenários
Obtém URLs de download temporárias para arquivos de resultado de uma execução de job semântico enviada, como artefatos YAML de modelo semântico. Esta operação retorna URLs de download e não retorna diretamente o conteúdo do arquivo.
Procedimento
Use o nome do job
JobNamepara localizar o job.Para recuperar artefatos de uma execução específica, especifique o
JobRunIdda resposta deRunSemanticJob.Data.JobRunIdouListSemanticJobRuns. Se você não especificar este parâmetro, os artefatos da execução mais recente serão retornados.Baixe os arquivos correspondentes de
Data.Results[].DownloadUrl.
Antes de começar
A URL de download é uma credencial temporária. Use-a apenas brevemente no lado do cliente. Não a escreva em logs nem a armazene para uso de longo prazo.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| JobName |
string |
Sim |
O nome do job. Você pode obter esse valor de Data.Name na resposta de CreateSemanticJob, Name na resposta de ListSemanticJobs ou JobName na resposta de ListSemanticJobRuns. |
semantic-job-demo |
| JobRunId |
string |
Não |
O ID de execução opcional. Se você especificar o JobRunId da resposta de RunSemanticJob (Data.JobRunId) ou da resposta de ListSemanticJobRuns, apenas os artefatos da execução especificada serão retornados. Se você não especificar este parâmetro, os artefatos da execução mais recente do job serão retornados. |
01H00000000000000000000000 |
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 obtenção de URLs de download de artefatos de execução. Cada item em Data.Results corresponde a um arquivo de resultado. |
||
| RequestId |
string |
O ID da solicitação. Você pode usar este ID para localizar logs e solucionar problemas. |
676271D6-53B4-57BE-89FA-72F7AE1418DF |
| Success |
boolean |
Indica se a solicitação foi bem-sucedida. |
|
| Data |
object |
A coleção de arquivos de resultado para a execução de job especificada. Vários itens são retornados se uma única execução gerar múltiplos arquivos. |
|
| Results |
array<object> |
A lista de arquivos de resultado. Cada item contém o nome do job associado, o ID de execução e uma URL de download de curta duração. |
|
|
object |
Um arquivo de resultado gerado por uma execução de job semântico. |
||
| JobName |
string |
O nome do nó ao qual o artefato pertence. Este valor é igual ao valor JobName na solicitação. |
semantic-job-demo |
| JobRunId |
string |
O ID de execução ao qual o artefato pertence. Você pode comparar este valor com o valor Data.JobRunId da resposta de RunSemanticJob ou o valor JobRunId de ListSemanticJobRuns. |
01H00000000000000000000000 |
| DownloadUrl |
string |
A URL de download pré-assinada temporária do arquivo de resultado. Baixe o arquivo usando uma solicitação HTTP GET o mais rápido possível. Não registre em log, compartilhe ou trate a URL completa como um endereço de longo prazo. |
https://example.com/temporary-download-url |
Para o significado de cada campo de resposta e sua relação com chamadas subsequentes, consulte as descrições dos campos.
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
"Success": false,
"Data": {
"Results": [
{
"JobName": "semantic-job-demo",
"JobRunId": "01H00000000000000000000000",
"DownloadUrl": "https://example.com/temporary-download-url"
}
]
}
}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.