UpdateMediaInfo - Intelligent Media Services: Central de Documentação do Alibaba Cloud

Atualiza informações sobre um ativo de mídia com base no ID do ativo de mídia no Intelligent Media Services (IMS) ou na URL de entrada do ativo de mídia.

Descrição da operação

Se o parâmetro MediaId for especificado, o parâmetro MediaId será usado preferencialmente para a consulta. Se o parâmetro MediaId for deixado vazio, o parâmetro InputURL deverá ser especificado. O ID da solicitação e o ID do ativo de mídia são retornados. Você não pode modificar a URL de entrada de um ativo de mídia especificando o ID do ativo de mídia.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ice:UpdateMediaInfo

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaId	string	Não	O ID do ativo de mídia. Se este parâmetro for deixado vazio, você deverá especificar a URL de entrada do ativo de mídia, que foi registrada na biblioteca de conteúdo do IMS.	**20b48fb04483915d4f2cd8ac**
InputURL	string	Não	A URL de entrada do ativo de mídia em outro serviço. A URL deve estar vinculada ao ID do ativo de mídia no IMS. A URL não pode ser modificada após o registro. Para um ativo de mídia do Object Storage Service (OSS), a URL pode ter um dos seguintes formatos: 1. http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4 2. oss://example-bucket/example.mp4. Este formato indica que a região na qual o bucket OSS do ativo de mídia reside é a mesma região na qual o OSS está ativado.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
BusinessType	string	Não	O tipo de negócio. Valores válidos: subtitles watermark opening ending general	video
Title	string	Não	O título. O valor pode ter até 128 bytes de comprimento. O valor deve ser codificado em UTF-8.	defaultTitle
Description	string	Não	A descrição do conteúdo. O valor pode ter até 1.024 bytes de comprimento. O valor deve ser codificado em UTF-8.	defaultDescription
Category	string	Não	A categoria. O valor pode ter até 64 bytes de comprimento. O valor deve ser codificado em UTF-8.	defaultCategory
MediaTags	string	Não	As tags. São suportadas até 16 tags. Separe múltiplas tags com vírgulas (,). Cada tag pode ter até 32 bytes de comprimento. O valor deve ser codificado em UTF-8.	updateTags1,updateTags2
CoverURL	string	Não	A URL da miniatura. O valor pode ter até 128 bytes de comprimento. O valor deve ser codificado em UTF-8.	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png
UserData	string	Não	Os dados do usuário. Podem ter até 1.024 bytes de tamanho.	userData
AppendTags	boolean	Não	Especifica se as tags devem ser anexadas. Valor padrão: false. Valores válidos: true: atualiza o parâmetro MediaTags anexando novas tags. false: atualiza o parâmetro MediaTags substituindo as tags existentes por novas tags.	true
CateId	integer	Não	O ID da categoria.	3048
ReferenceId	string	Não	O ID personalizado. O ID pode ter de 6 a 64 caracteres de comprimento e pode conter apenas letras, dígitos, hifens (-) e underscores (_). Certifique-se de que o ID seja único entre os usuários.	123-123

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Schema da resposta.
RequestId	string	O ID da solicitação.	****11-DB8D-4A9A-875B-275798****
MediaId	string	O ID do ativo de mídia no IMS.	**20b48fb04483915d4f2cd8ac**

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaId": "****20b48fb04483915d4f2cd8ac****"
}

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.