Todos os produtos
Search
Central de documentação

:UpdateMediaCategory

Última atualização: Jun 27, 2026

Atualiza a categoria de um arquivo de mídia.

Observações de uso

Esta operação atualiza apenas a categoria de um arquivo de mídia. Para atualizar todas as informações do arquivo, consulte UpdateMedia.

Limites de QPS

Você pode chamar esta operação até 100 vezes por segundo. Se o número de chamadas por segundo exceder o limite, o throttling será acionado e seus serviços poderão ser afetados. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, 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 UpdateMediaCategory

A operação a ser executada. Defina o valor como UpdateMediaCategory.

MediaId String Sim 3e1cd21131a94525be55acf65888****

O ID do arquivo de mídia cuja categoria você deseja atualizar.

Nota Para obter o ID de um arquivo de mídia, chame a operação AddMedia. Como alternativa, execute as seguintes etapas no console do ApsaraVideo Media Processing (MPS): no painel de navegação à esquerda, escolha Media Management > Media List. Localize o vídeo desejado e clique em Gerencie. O ID do vídeo aparece na aba Basics.
CateId Long Não 1

O ID da categoria. O valor não pode ser negativo.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

E3931857-E3D3-4D6E-9C7B-D2C09441BD01

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMediaCategory
&MediaId=3e1cd21131a94525be55acf65888****
&CateId=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<UpdateMediaCategoryResponse>
    <RequestId>E3931857-E3D3-4D6E-9C7B-D2C09441BD01</RequestId>
</UpdateMediaCategoryResponse>

Formato JSON

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

{
  "RequestId" : "E3931857-E3D3-4D6E-9C7B-D2C09441BD01"
}

Códigos de erro

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