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

Observações de uso

As informações básicas atualizáveis por meio desta operação incluem título, descrição e categoria do arquivo de mídia. Esta operação realiza uma atualização completa. Portanto, defina todos os parâmetros, a menos que deseje substituir o valor de um parâmetro específico por NULL.

Limites de QPS

O limite para esta operação é de 100 chamadas por segundo. A ultrapassagem desse limite aciona o throttling, o que pode afetar seus serviços. Recomendamos observar esse limite ao executar a operação. Para mais detalhes, consulte Limites de QPS.

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 o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateMedia	A operação a ser executada. Defina o valor como UpdateMedia.
MediaId	String	Sim	3e1cd21131a94525be55acf65888****	ID do arquivo de mídia cujas informações básicas serão atualizadas. Para obter o ID do arquivo de mídia, faça login no ApsaraVideo Media Processing (MPS) console e escolha Media Management > Media List no painel de navegação à esquerda.
Title	String	Não	hello	Título do arquivo de mídia. Há suporte para vários tipos de caracteres, como letras e dígitos. Se este parâmetro não for especificado, o valor será NULL. O valor é codificado em UTF-8 e pode ter até 128 bytes de comprimento.
Description	String	Não	example description	Descrição do arquivo de mídia. Vários tipos de caracteres são aceitos, incluindo letras e números. Caso você não especifique este parâmetro, o valor assumirá NULL. A codificação é UTF-8, com tamanho máximo de 1.024 bytes.
CoverURL	String	Não	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/test**.jpg	Local de armazenamento da miniatura a ser definida para o arquivo de mídia. Para obter a URL, faça login no MPS console e escolha Workflows > Media Buckets. Alternativamente, acesse o Object Storage Service (OSS) console e clique em My OSS Paths. O comprimento máximo permitido é de 3.200 bytes. A URL segue a RFC 2396, utiliza codificação UTF-8 e aplica percent-encoding aos caracteres reservados.
CateId	Long	Não	1	Identificador da categoria à qual o arquivo de mídia pertence. Deve ser um número inteiro. A ausência deste parâmetro resulta em valor NULL. Valores negativos não são permitidos.
Tags	String	Não	tag1,tag2	Tags a serem adicionadas ao arquivo de mídia. Separe múltiplas tags com vírgulas (,). É possível definir até 16 tags por arquivo de mídia. Cada tag pode ocupar no máximo 32 bytes. Utilize codificação UTF-8 para o valor.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	6A88246F-C91F-42BD-BABE-DB0DF993F960	ID da solicitação.
Media	Object		Informações detalhadas sobre o arquivo de mídia.
CreationTime	String	2016-09-14T08:30:33Z	Data e hora de criação do arquivo de mídia.
CateId	Long	1	Identificador da categoria associada ao arquivo de mídia.
Height	String	1080	Altura do arquivo de mídia.
CensorState	String	Initiated	Status de revisão do vídeo. Valores válidos: Initiated: Arquivo de mídia enviado, mas ainda não revisado. Pass: Arquivo de mídia enviado e aprovado na revisão.
Tags	Array of String	tag1,tag2	Tags atribuídas ao arquivo de mídia.
Bitrate	String	2659.326	Taxa de bits do arquivo de mídia.
MediaId	String	3e1cd21131a94525be55acf65888****	ID do arquivo de mídia.
File	Object		Dados referentes ao arquivo de entrada.
State	String	Normal	Estado atual do arquivo de entrada. Valores válidos: Normal: O arquivo de entrada está íntegro. Deleted: O arquivo de entrada foi removido.
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	Endereço URL do arquivo de entrada.
PublishState	String	Published	Situação de publicação do arquivo de mídia. Valores válidos: Initiated: Estado inicial do arquivo de mídia. UnPublish: Mídia não publicada; a permissão de reprodução do objeto no OSS é Private. Published: Mídia publicada; a permissão de reprodução do objeto no OSS é Default. Deleted: Arquivo de mídia excluído.
Description	String	example description	Texto descritivo do arquivo de mídia.
Width	String	1920	Largura do arquivo de mídia.
Size	String	2647692	Tamanho total do arquivo de mídia.
CoverURL	String	http://example-bucket-**.oss-cn-shanghai.aliyuncs.com/example-**.jpg	Local onde a miniatura da mídia está armazenada.
RunIdList	Array of String	null	IDs das instâncias de execução do workflow de mídia.
Duration	String	7.965000	Duração temporal do arquivo de mídia.
Fps	String	25.0	Taxa de quadros do arquivo de mídia.
Title	String	hello	Nome do título do arquivo de mídia.
Format	String	mov	Formato do contêiner de mídia. Opções disponíveis: mov, mp4, m4a, 3gp, 3g2 e mj2.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMedia
&MediaId=3e1cd21131a94525be55acf65888****
&Title=hello
&Description=example description
&CoverURL=http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/test****.jpg
&CateId=1
&Tags=tag1,tag2
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<UpdateMediaResponse>
    <RequestId>6A88246F-C91F-42BD-BABE-DB0DF993F960</RequestId>
    <Media>
        <CreationTime>2016-09-14T08:30:33Z</CreationTime>
        <CateId>1</CateId>
        <Height>1080</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <Bitrate>2659.326</Bitrate>
        <MediaId>3e1cd21131a94525be55acf65888****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <PublishState>Published</PublishState>
        <Description>example description</Description>
        <Width>1920</Width>
        <Size>2647692</Size>
        <CoverURL>http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg</CoverURL>
        <RunIdList>{"RunId":["47b42486019c4f688bf144c1a6ba****"]}</RunIdList>
        <Duration>7.965000</Duration>
        <Fps>25.0</Fps>
        <Title>hello</Title>
        <Format>mov</Format>
    </Media>
</UpdateMediaResponse>

Formato JSON

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

{
  "RequestId" : "6A88246F-C91F-42BD-BABE-DB0DF993F960",
  "Media" : {
    "CreationTime" : "2016-09-14T08:30:33Z",
    "CateId" : 1,
    "Height" : "1080",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "Bitrate" : "2659.326",
    "MediaId" : "3e1cd21131a94525be55acf65888****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "PublishState" : "Published",
    "Description" : "example description",
    "Width" : "1920",
    "Size" : "2647692",
    "CoverURL" : "http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example-****.jpg",
    "RunIdList" : [ "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}" ],
    "Duration" : "7.965000",
    "Fps" : "25.0",
    "Title" : "hello",
    "Format" : "mov"
  }
}

Códigos de erro

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