UpdateMediaStorageClass - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Descrição da operação

Esta operação é assíncrona. Você pode chamar esta operação para modificar as classes de armazenamento de ativos de mídia. Após a classe de armazenamento ser modificada, uma notificação de callback é enviada.
Se a classe de armazenamento do ativo de mídia for Archive ou Cold Archive e você chamar esta operação para modificar a classe de armazenamento do ativo de mídia, o ativo de mídia será automaticamente restaurado antes que a classe de armazenamento seja modificada. Você não precisa chamar a operação RestoreMedia para restaurar o ativo de mídia. Você deve especificar a prioridade de restauração para objetos Cold Archive. Configuração padrão: RestoreTier=Standard.
Ativos de mídia cujas classes de armazenamento estão sendo modificadas não podem ser usados ou processados.
Objetos não Standard possuem durações mínimas de armazenamento. Se um objeto for armazenado por menos que a duração mínima de armazenamento, a classe de armazenamento do objeto não poderá ser alterada. O conteúdo a seguir descreve as durações mínimas de armazenamento para objetos em diferentes classes de armazenamento: IA ou armazenamento IA para arquivos de origem: 30 dias, Archive ou armazenamento Archive para arquivos de origem: 60 dias, Cold Archive ou Cold Archive para arquivos de origem: 180 dias.

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

vod:UpdateMediaStorageClass

update

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
MediaIds	string	Sim	O ID do ativo de mídia. Você pode especificar no máximo 20 IDs. Separe múltiplos IDs com vírgulas (,). Você pode usar um dos seguintes métodos para obter o ID: Faça logon no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Arquivos de Mídia > Áudio/Vídeo. Na página Vídeo e Áudio, você pode visualizar o ID do ativo de mídia. Este método é aplicável a arquivos que são carregados usando o console do ApsaraVideo VOD. Obtenha o valor do parâmetro VideoId da resposta da operação CreateUploadVideo que você chama para carregar ativos de mídia. Obtenha o valor do parâmetro VideoId da resposta da operação SearchMedia que você chama para consultar o ID de mídia após o ativo de mídia ser carregado.	d56c2ac0cee271ed80004710b5ba****
Scope	string	Não	O escopo da modificação. Valores válidos: All: modifica as classes de armazenamento de todos os recursos, incluindo os arquivos de origem e streams transcodificados. SourceFile: modifica as classes de armazenamento apenas dos arquivos de origem. A classe de armazenamento dos outros recursos é Standard.	All
StorageClass	string	Sim	A classe de armazenamento. Valores válidos: Standard IA Archive ColdArchive	Archive
RestoreTier	string	Não	A prioridade de restauração. Este parâmetro é obrigatório apenas quando você restaura um ativo de mídia Cold Archive. Valores válidos: Expedited Standard Bulk	Standard
AllowUpdateWithoutTimeLimit	boolean	Não	Especifica se a classe de armazenamento de um ativo de mídia armazenado por menos que a duração mínima de armazenamento deve ser alterada. Valores válidos: true false Nota Se você alterar forçadamente a classe de armazenamento de um ativo de mídia armazenado por menos que a duração mínima de armazenamento, taxas adicionais de recuperação de dados serão cobradas.	false

Você pode especificar a duração do estado restaurado e a prioridade de restauração de um objeto Cold Archive. A duração do estado restaurado varia de 1 a 365 dias. O tempo necessário para a restauração do objeto varia com base na prioridade de restauração:

Expedited: O objeto é restaurado em uma hora.
Standard: O objeto é restaurado em duas a cinco horas.
Bulk: O objeto é restaurado em cinco a doze horas.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	30FA0B7C-3A81-5449-93CD-ACA149E6****
Status	string	O status da tarefa. Valores válidos: Processing Failed	Processing
IgnoredList	object
MediaId	array	Os IDs dos ativos de mídia que não puderam ser obtidos.
	string	O ID do ativo de mídia que não pôde ser obtido.	['19e231ee6e3e417fbf2e92ec2680****']
ForbiddenList	object
MediaForbiddenReasonDTO	array<object>	Os IDs dos ativos de mídia que não puderam ser processados.
	object	As informações sobre o ativo de mídia que não pôde ser processado.
MediaId	string	The ID of the media asset.	19e231ee6e3e417fbf2e92ec2680****
Reason	string	The reason for the failure.	TargetStorageClassInconsistent

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "30FA0B7C-3A81-5449-93CD-ACA149E6****",
  "Status": "Processing",
  "IgnoredList": {
    "MediaId": [
      "['19e231ee6e3e417fbf2e92ec2680****']"
    ]
  },
  "ForbiddenList": {
    "MediaForbiddenReasonDTO": [
      {
        "MediaId": "19e231ee6e3e417fbf2e92ec2680****",
        "Reason": "TargetStorageClassInconsistent"
      }
    ]
  }
}

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.