ALIYUN::ICE::MediaInfo リソースタイプ概要 - Resource Orchestration Service

ALIYUN::ICE::MediaInfo は、Intelligent Media Services (IMS) にメディアアセットを登録するために使用されます。

構文

{
  "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
  }
}

プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
InputURL	String	はい	いいえ	別のサービスにあるメディアアセットの URL。	URL は、IMS 内のメディアアセットの ID に関連付けられています。メディアアセットが登録されると、URL は変更できません。次のタイプの URL がサポートされています。 Object Storage Service (OSS) URL。2 つの形式がサポートされています。 ApsaraVideo VOD (VOD) メディアアセットの URL。
BusinessType	String	いいえ	いいえ	メディアアセットのビジネスタイプ。	有効な値: subtitles watermark opening ending general
CateId	Integer	いいえ	はい	カテゴリの ID。	なし。
CoverURL	String	いいえ	はい	サムネイル URL。	URL は最大 128 バイトです。 URL は UTF-8 でエンコードする必要があります。
Description	String	いいえ	はい	メディアアセットの説明。	説明は最大 1,024 バイトです。説明は UTF-8 でエンコードする必要があります。
MediaType	String	いいえ	いいえ	メディアアセットのタイプ。	有効な値: image video audio text
MediaTags	List	いいえ	はい	タグ。	最大 16 個のタグを追加できます。複数のタグはコンマ (,) で区切ります。各タグは最大 32 バイトです。タグは UTF-8 でエンコードする必要があります。
Overwrite	Boolean	いいえ	いいえ	InputURL で指定された URL を使用して登録されているメディアアセットを上書きするかどうかを指定します。	true: URL を使用してメディアアセットが登録されている場合、メディアアセットは削除され、新しいメディアアセットが登録されます。 false (デフォルト): URL を使用してメディアアセットが登録されている場合、新しいメディアアセットは登録されません。URL を使用して複数のメディアアセットを登録することはできません。
RegisterConfig	String	いいえ	いいえ	登録構成。	デフォルトでは、メディアアセットのスプライトシートが生成されます。 NeedSprite を false に設定して、自動スプライトシート生成を無効にすることができます。デフォルトでは、メディアアセットのスナップショットが生成されます。 NeedSnapshot を false に設定して、自動スナップショット生成を無効にすることができます。
ReferenceId	String	いいえ	はい	カスタム ID。	ID は 6 ～ 64 文字で、文字、数字、ハイフン (-)、およびアンダースコア (_) のみを含めることができます。ID はアカウント内で一意である必要があります。
SmartTagTemplateId	String	いいえ	いいえ	スマートタギングテンプレートの ID。	有効な値: S00000101-300080: コンテンツ認識のための自然言語処理 (NLP) をサポートするシステムテンプレート。 S00000103-000001: コンテンツ認識のための NLP とすべてのタギング機能をサポートするシステムテンプレート。詳細については、「メディアアセットのコンテンツを分析する」をご参照ください。 S00000103-000002: コンテンツ認識のための NLP はサポートしていませんが、すべてのタギング機能をサポートするシステムテンプレート。詳細については、「メディアアセットのコンテンツを分析する」をご参照ください。
Title	String	いいえ	はい	タイトル。	このプロパティを指定しない場合、システムは現在の日付に基づいてタイトルを生成します。タイトルは最大 128 バイトです。タイトルは UTF-8 でエンコードする必要があります。
UserData	Map	いいえ	はい	ユーザーデータ。	カスタムコールバック URL を構成できます。詳細については、「完了した編集ジョブのコールバック設定を構成する」をご参照ください。ユーザーデータは最大 1,024 バイトです。ユーザーデータは UTF-8 でエンコードする必要があります。ユーザーデータは JSON 形式である必要があります。
WorkflowId	String	いいえ	いいえ	ワークフローの ID。	なし。

戻り値

Fn::GetAtt

MediaId: IMS メディアアセットの ID。

例

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  InputURL:
    Type: String
    Description:
      ja: |-
        別のサービスにあるメディアアセットの URL。URL は IMS 内のメディアアセットの ID に関連付けられています。登録後は URL を変更できません。次のタイプの URL がサポートされています。
        次のいずれかの形式の OSS URL:
        http(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
        oss://example-bucket/example.mp4: この形式では、メディアアセットが存在する OSS バケットのリージョンは、IMS がアクティブ化されているリージョンと同じであるとデフォルトでみなされます。
        ApsaraVideo VOD メディアアセットの URL
        vod://***20b48fb04483915d4f2cd8ac****
    Required: true
Resources:
  MediaInfo:
    Type: ALIYUN::ICE::MediaInfo
    Properties:
      InputURL:
        Ref: InputURL
Outputs:
  MediaId:
    Description: IMS 内のメディアアセットの ID。
    Value:
      Fn::GetAtt:
        - MediaInfo
        - MediaId

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InputURL": {
      "Type": "String",
      "Description": {
        "ja": "別のサービスにあるメディアアセットの URL。URL は IMS 内のメディアアセットの ID に関連付けられています。登録後は URL を変更できません。次のタイプの URL がサポートされています。\n次のいずれかの形式の OSS URL:\nhttp(s)://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4\noss://example-bucket/example.mp4: この形式では、メディアアセットが存在する OSS バケットのリージョンは、IMS がアクティブ化されているリージョンと同じであるとデフォルトでみなされます。\nApsaraVideo VOD メディアアセットの URL\nvod://***20b48fb04483915d4f2cd8ac****"
      },
      "Required": true
    }
  },
  "Resources": {
    "MediaInfo": {
      "Type": "ALIYUN::ICE::MediaInfo",
      "Properties": {
        "InputURL": {
          "Ref": "InputURL"
        }
      }
    }
  },
  "Outputs": {
    "MediaId": {
      "Description": "IMS 内のメディアアセットの ID。",
      "Value": {
        "Fn::GetAtt": [
          "MediaInfo",
          "MediaId"
        ]
      }
    }
  }
}