GetUploadDetails - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação retorna detalhes de upload apenas para arquivos de áudio e vídeo.
Se você usar o console do ApsaraVideo VOD para enviar arquivos de áudio e vídeo, poderá chamar esta operação para consultar informações como a proporção do upload. Se utilizar um SDK de upload, verifique se a versão do upload SDK atende a um dos seguintes requisitos:
- Upload SDK para Java versão 1.4.4 ou posterior.
- Upload SDK para C++ versão 1.0.0 ou posterior.
- Upload SDK para PHP versão 1.0.2 ou posterior.
- Upload SDK para Python versão 1.3.0 ou posterior.
- Upload SDK para JavaScript versão 1.4.0 ou posterior.
- Upload SDK para Android versão 1.5.0 ou posterior.
- Upload SDK para iOS versão 1.5.0 ou posterior.

Limite de QPS

Você pode chamar esta operação até 100 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, o sistema aplicará throttling, o que pode afetar seus serviços. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, consulte Limites de QPS para operações de API no ApsaraVideo VOD.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetUploadDetails	A operação a ser executada. Defina o valor como GetUploadDetails.
MediaIds	String	Sim	61ccbdb06fa83012be4d8083f6**,7d2fbc380b0e08e55f**	O ID do arquivo de mídia, ou seja, o ID do áudio ou vídeo. Você pode especificar até 20 IDs. Separe vários IDs com vírgulas (,). Use um dos métodos a seguir para obter o ID do áudio ou vídeo: Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Media Files > Audio/Video. Na página Video and Audio, visualize o ID do áudio ou vídeo. Use este método se o arquivo de áudio ou vídeo tiver sido enviado pelo console do ApsaraVideo VOD. Verifique o valor do parâmetro VideoId retornado pela operação CreateUploadVideo, chamada para obter uma URL e credencial de upload. Consulte o valor do parâmetro VideoId retornado pela operação SearchMedia, executada para consultar informações da mídia após o envio do arquivo de áudio ou vídeo.
MediaType	String	Não	video	O tipo do arquivo de mídia. Defina o valor como video, que indica arquivos de áudio e vídeo.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	9E290613-04F4-47F4-795D30732077****	O ID da solicitação.
ForbiddenMediaIds	Array of String	7d2fbc380b0e08e55f****	Os IDs dos arquivos de mídia inacessíveis.
NonExistMediaIds	Array of String	dfsg****	Os IDs dos arquivos de mídia inexistentes.
UploadDetails	Array of UploadDetail		Os detalhes do upload.
Status	String	Uploading	O status do vídeo. Para mais informações sobre os valores válidos e a descrição deste parâmetro, consulte a seção "Status: the status of a video" do tópico Basic structures.
CreationTime	String	2019-04-28T09:42:07Z	O momento de criação do trabalho de upload. O horário segue o padrão ISO 8601 no formato yyyy-MM-dd T HH:mm:ss Z e é exibido em UTC.
UploadSource	String	WebSDK	O método usado para enviar o arquivo de mídia.
UploadIP	String	192.168.0.1	O endereço IP do servidor que envia o arquivo de mídia.
DeviceModel	String	Chrome	O modelo do dispositivo.
ModificationTime	String	2019-04-28T09:43:12Z	O momento da última atualização das informações do arquivo de mídia. O horário segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ e é exibido em UTC.
CompletionTime	String	2019-04-28T09:45:07Z	O momento de conclusão do trabalho de upload. O horário segue o padrão ISO 8601 no formato yyyy-MM-dd T HH:mm:ss Z e é exibido em UTC.
MediaId	String	61ccbdb06fa83012be4d8083f6****	O ID do áudio ou vídeo enviado.
UploadSize	Long	346	O tamanho do upload. Unidade: byte.
UploadRatio	Float	0.038	A proporção do upload.
UploadStatus	String	Uploading	O status do trabalho de upload. Para mais informações sobre os valores válidos e a descrição deste parâmetro, consulte a seção "Status: the status of a URL-based upload job" do tópico Basic structures.
Title	String	Upload details of the test file	O título do arquivo de mídia.
FileSize	Long	46	O tamanho do arquivo enviado. Unidade: byte.

Exemplos

Solicitações de exemplo

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=GetUploadDetails
&MediaIds=61ccbdb06fa83012be4d8083f6****,7d2fbc380b0e08e55f****
&MediaType=video
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GetUploadDetailsResponse>
    <RequestId>9E290613-04F4-47F4-795D30732077****</RequestId>
    <ForbiddenMediaIds>7d2fbc380b0e08e55f****</ForbiddenMediaIds>
    <NonExistMediaIds>dfsg****</NonExistMediaIds>
    <UploadDetails>
      <UploadDetail>
        <Status>Uploading</Status>
        <CreationTime>2019-04-28T09:42:07Z</CreationTime>
        <UploadSource>WebSDK</UploadSource>
        <UploadIP>192.168.0.1</UploadIP>
        <DeviceModel>Chrome</DeviceModel>
        <ModificationTime>2019-04-28T09:43:12Z</ModificationTime>
        <CompletionTime>2019-04-28T09:45:07Z</CompletionTime>
        <MediaId>61ccbdb06fa83012be4d8083f6****</MediaId>
        <UploadSize>346</UploadSize>
        <UploadRatio>0.038</UploadRatio>
        <UploadStatus>Uploading</UploadStatus>
        <Title>Upload details of the test file</Title>
        <FileSize>46</FileSize>
      </UploadDetail>
    </UploadDetails>
</GetUploadDetailsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "9E290613-04F4-47F4-795D30732077****",
  "ForbiddenMediaIds" : [ "7d2fbc380b0e08e55f****" ],
  "NonExistMediaIds" : [ "dfsg****" ],
  "UploadDetails" : [ {
    "Status" : "Uploading",
    "CreationTime" : "2019-04-28T09:42:07Z",
    "UploadSource" : "WebSDK",
    "UploadIP" : "192.168.0.1",
    "DeviceModel" : "Chrome",
    "ModificationTime" : "2019-04-28T09:43:12Z",
    "CompletionTime" : "2019-04-28T09:45:07Z",
    "MediaId" : "61ccbdb06fa83012be4d8083f6****",
    "UploadSize" : 346,
    "UploadRatio" : 0.038,
    "UploadStatus" : "Uploading",
    "Title" : "Upload details of the test file",
    "FileSize" : 46
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Erros comuns

A tabela a seguir descreve os erros comuns retornados por esta operação.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
LimitExceeded.MediaIds	The input parameter 'MediaIds' Exceed the limit.	400	Mensagem de erro retornada quando a quantidade de IDs de mídia excede 20.