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

Observações de uso

Para substituir um arquivo de origem de vídeo ou áudio, obtenha o URL de upload do arquivo de origem chamando esta operação. Em seguida, você pode fazer upload de um novo arquivo de origem sem alterar o ID do vídeo ou áudio. No entanto, a substituição do arquivo pode acionar automaticamente jobs de transcodificação e snapshot se esses jobs estiverem configurados. Para mais informações, consulte URLs e credenciais de upload.

Limite de QPS

Você pode chamar esta operação até 120 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, o throttling será acionado. Com isso, seus negócios podem ser afetados. Recomendamos que você observe o limite ao chamar esta operação. Para mais informações, consulte Limites de QPS nas operações de API no ApsaraVideo VOD.

Depuração

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

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

RefreshUploadVideo

A operação que você deseja executar. Defina o valor como RefreshUploadVideo.

VideoId

String

Sim

c6a23a870c8c4ffcd40cbd381333****

O ID do arquivo de áudio ou vídeo. Use um dos seguintes métodos para obter o ID:

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 arquivo de áudio ou vídeo.
Visualize o valor do parâmetro VideoId retornado pela operação CreateUploadVideo que você chamou para fazer upload do arquivo de áudio ou vídeo.
Visualize o valor do parâmetro VideoId retornado pela operação SearchMedia que você chamou para consultar o ID do arquivo de áudio ou vídeo após fazer o upload.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	25818875-5F78-4A43-7DF6-D7393642****	O ID da solicitação.
UploadAddress	String	eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****	O URL de upload. Nota O URL de upload retornado por esta operação é codificado em Base64. Antes de usar um SDK ou uma operação de API para fazer upload de um ativo de mídia com base no URL de upload, você deve decodificar o URL usando o algoritmo Base64. Você só precisa analisar o URL de upload se usar os SDKs nativos do Object Storage Service (OSS) ou a API OSS para uploads.
VideoId	String	c6a23a870c8c4ffcd40cbd381333****	O ID do arquivo de áudio ou vídeo.
UploadAuth	String	FJU3p3TZ0NUIyeW****	A credencial de upload. Nota A credencial de upload retornada por esta operação é codificada em Base64. Antes de usar um SDK ou uma operação de API para fazer upload de um ativo de mídia com base na credencial de upload, você deve decodificar a credencial usando o algoritmo Base64. Você só precisa analisar a credencial de upload se usar os SDKs nativos do OSS ou a API OSS para uploads.

Exemplos

Exemplos de solicitações

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=RefreshUploadVideo
&VideoId=c6a23a870c8c4ffcd40cbd381333****
&<Common request parameters>

Exemplos de respostas com êxito

XML formato

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

<RefreshUploadVideoResponse>
    <RequestId>25818875-5F78-4A43-7DF6-D7393642****</RequestId>
    <UploadAddress>eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****</UploadAddress>
    <VideoId>c6a23a870c8c4ffcd40cbd381333****</VideoId>
    <UploadAuth>FJU3p3TZ0NUIyeW****</UploadAuth>
</RefreshUploadVideoResponse>

JSON formato

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

{
  "RequestId" : "25818875-5F78-4A43-7DF6-D7393642****",
  "UploadAddress" : "eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****",
  "VideoId" : "c6a23a870c8c4ffcd40cbd381333****",
  "UploadAuth" : "FJU3p3TZ0NUIyeW****"
}

Códigos de erro

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

Erros comuns

A tabela a seguir descreve os erros comuns que esta operação pode retornar.

Código de erro	Mensagem de erro	Código de status HTTP	Descrição
InvalidVideo.Damaged	The video has been Damaged.	400	A mensagem de erro retornada porque ocorreu um erro durante a criação do vídeo ou o vídeo foi danificado.
InvalidVideo.NotFound	The video not exist.	404	A mensagem de erro retornada porque o vídeo não existe.

Exemplos de SDK

Recomendamos que você use um SDK de servidor para chamar esta operação. Para mais informações sobre o código de exemplo usado para chamar esta operação em várias linguagens, consulte os seguintes tópicos: