Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ICE::MediaInfo

Última atualização: Jun 27, 2026

O recurso ALIYUN::ICE::MediaInfo registra um ativo de mídia no Intelligent Media Services (IMS).

Sintaxe

{
  "Type": "ALIYUN::ICE::MediaInfo",
  "Properties": {
    "InputURL": String,
    "BusinessType": String,
    "CateId": Integer,
    "CoverURL": String,
    "Description": String,
    "MediaType": String,
    "MediaTags": List,
    "Overwrite": Boolean,
    "RegisterConfig": String,
    "ReferenceId": String,
    "SmartTagTemplateId": String,
    "Title": String,
    "UserData": Map,
    "WorkflowId": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

InputURL

String

Sim

Não

URL do ativo de mídia em outro serviço.

Associa-se ao ID do ativo de mídia no IMS e não pode ser modificada após o registro. Tipos de URL suportados:

  • URL do OSS em dois formatos.

  • URL de ativo de mídia do ApsaraVideo VOD.

BusinessType

String

Não

Não

Tipo de negócio do ativo de mídia.

Valores válidos:

  • subtitles

  • watermark

  • opening

  • ending

  • general

CateId

Integer

Não

Sim

ID da categoria.

Nenhuma.

CoverURL

String

Não

Sim

URL da miniatura.

  • Comprimento máximo: 128 bytes.

  • Codificação UTF-8 obrigatória.

Description

String

Não

Sim

Descrição do ativo de mídia.

  • Comprimento máximo: 1.024 bytes.

  • Codificação UTF-8 obrigatória.

MediaType

String

Não

Não

Tipo do ativo de mídia.

Valores válidos:

  • image

  • video

  • audio

  • text

MediaTags

List

Não

Sim

Tags.

  • Máximo de 16 tags.

  • Separe as tags com vírgulas (,).

  • Comprimento máximo por tag: 32 bytes.

  • Codificação UTF-8 obrigatória.

Overwrite

Boolean

Não

Não

Define se deve sobrescrever um ativo de mídia já registrado com a InputURL.

  • true: exclui o ativo de mídia existente registrado com a URL e registra um novo.

  • false (padrão): não registra um novo ativo de mídia se já existir um para a URL. Cada URL pode registrar apenas um ativo de mídia.

RegisterConfig

String

Não

Não

Configuração de registro.

Sprite sheets são geradas por padrão. Defina NeedSprite como false para desativar.

Snapshots são gerados por padrão. Defina NeedSnapshot como false para desativar.

ReferenceId

String

Não

Sim

ID personalizado.

De 6 a 64 caracteres. Aceita letras, dígitos, hifens (-) e sublinhados (_). Deve ser único na conta.

SmartTagTemplateId

String

Não

Não

ID do modelo de marcação inteligente.

Valores válidos:

  • S00000101-300080: modelo do sistema com reconhecimento de conteúdo baseado em NLP.

  • S00000103-000001: modelo do sistema com reconhecimento de conteúdo baseado em NLP e todos os recursos de marcação. Analisar o conteúdo de ativos de mídia.

  • S00000103-000002: modelo do sistema sem reconhecimento de conteúdo baseado em NLP, mas com todos os recursos de marcação. Analisar o conteúdo de ativos de mídia.

Title

String

Não

Sim

Título.

Padrão: gerado automaticamente com base na data atual.

  • Comprimento máximo: 128 bytes.

  • Codificação UTF-8 obrigatória.

UserData

Map

Não

Sim

Dados do usuário.

Suporta uma URL de callback personalizada. Configure definições de callback para trabalhos de edição concluídos.

  • Comprimento máximo: 1.024 bytes.

  • Codificação UTF-8 obrigatória.

  • Formato JSON obrigatório.

WorkflowId

String

Não

Não

ID do fluxo de trabalho.

Nenhuma.

Valores de retorno

Fn::GetAtt

MediaId: o ID do ativo de mídia no IMS.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InputURL:
    Type: String
    Description:
      en: |-
        The URL of the media asset in another service. The URL is associated with the ID of the media asset in IMS. The URL cannot be modified once registered. The following types of URLs are supported:
        OSS URL in one of the following formats:
        http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
        oss://example-bucket/example.mp4: In this format, it is considered by default that the region of the OSS bucket in which the media asset resides is the same as the region in which IMS is activated.
        URL of an ApsaraVideo VOD media asset
        vod://***20b48fb04483915d4f2cd8ac****
    Required: true
Resources:
  MediaInfo:
    Type: ALIYUN::ICE::MediaInfo
    Properties:
      InputURL:
        Ref: InputURL
Outputs:
  MediaId:
    Description: The ID of the media asset in IMS.
    Value:
      Fn::GetAtt:
        - MediaInfo
        - MediaId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InputURL": {
      "Type": "String",
      "Description": {
        "en": "The URL of the media asset in another service. The URL is associated with the ID of the media asset in IMS. The URL cannot be modified once registered. The following types of URLs are supported:\nOSS URL in one of the following formats:\nhttp(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4\noss://example-bucket/example.mp4: In this format, it is considered by default that the region of the OSS bucket in which the media asset resides is the same as the region in which IMS is activated.\nURL of an ApsaraVideo VOD media asset\nvod://***20b48fb04483915d4f2cd8ac****"
      },
      "Required": true
    }
  },
  "Resources": {
    "MediaInfo": {
      "Type": "ALIYUN::ICE::MediaInfo",
      "Properties": {
        "InputURL": {
          "Ref": "InputURL"
        }
      }
    }
  },
  "Outputs": {
    "MediaId": {
      "Description": "The ID of the media asset in IMS.",
      "Value": {
        "Fn::GetAtt": [
          "MediaInfo",
          "MediaId"
        ]
      }
    }
  }
}