すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::ICE::UploadMedia

最終更新日:Mar 17, 2025

ALIYUN::ICE::UploadMedia は、メディアアセットのアップロードアドレスと認証情報を照会するために使用されます。

構文

{
  "Type": "ALIYUN::ICE::UploadMedia",
  "Properties": {
    "AppId": String,
    "EntityId": String,
    "FileInfo": Map,
    "MediaMetaData": Map,
    "PostProcessConfig": Map,
    "UserData": Map,
    "UploadTargetConfig": Map
  }
}

プロパティ

プロパティ

必須

編集可能

説明

制約

AppId

String

いいえ

いいえ

アプリケーションの ID。

なし。

EntityId

String

いいえ

いいえ

エンティティの ID。

なし。

FileInfo

Map

いいえ

いいえ

ファイルに関する情報。

このプロパティには、次のフィールドが含まれます。

  • Type: 必須。ファイルの種類。有効な値: video、image、audio、text、other。

  • Name: 必須。拡張子を含まないファイル名。

  • Size: オプション。ファイルサイズ。

  • Ext: 必須。ファイル名の拡張子。

MediaMetaData

Map

いいえ

いいえ

アップロードするメディアアセットのメタデータ。

このプロパティには、次のフィールドが含まれます。

Title: 必須。タイトル。

  • タイトルは最大 128 文字です。

  • UTF-8 でエンコードする必要があります。

Description: オプション。説明。

  • 説明は最大 1,024 文字です。

  • UTF-8 でエンコードする必要があります。

CateId: オプション。カテゴリの ID。

Tags: オプション。タグ。

BusinessType: 必須。ビジネスの種類。

  • Type が video に設定されている場合の有効な値: opening と ending。

  • Type が image に設定されている場合の有効な値: default と cover。

  • Type が text に設定されている場合の有効な値: subtitles と font。

  • Type が material に設定されている場合の有効な値: watermark。

  • Type が general に設定されている場合の有効な値: CoverURL。 CoverURL はオプションです。

DynamicMetaData: 文字列データ型の動的メタデータ。

PostProcessConfig

Map

いいえ

いいえ

アップロード後の処理構成。

なし。

UserData

Map

いいえ

いいえ

カスタム構成。

なし。

UploadTargetConfig

Map

いいえ

いいえ

保存先のストレージの場所。

このプロパティには、次のフィールドが含まれます。

  • StorageType: ストレージの種類。値を oss に設定します。

  • StorageLocation: ストレージの場所。値は ApsaraVideo VOD (VOD) のアドレスである必要があります。Object Storage Service (OSS) のアドレスを指定することはできません。

戻り値

Fn::GetAtt

  • FileURL: ファイルの OSS アドレス。

  • MediaURL: メディアアセットのアドレス。

  • UploadAddress: アップロードアドレス。

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

  • UploadAuth: アップロード認証情報。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  EntityId:
    Type: String
    Description:
      ja: エンティティ ID。CreateEntity オペレーションを呼び出してエンティティを作成し、動的メタデータ構造を指定できます。
    Required: false
  AppId:
    Type: String
    Description:
      ja: 'アプリケーション ID。デフォルト値: app-1000000。'
    Required: false
  FileInfo:
    Type: Json
    Description:
      ja: |-
        ファイル情報。JSON 形式で、次のフィールドが含まれます。
        Type: 必須。ファイルの種類。有効な値: video、image、audio、text、other。
        Name: 必須。拡張子を含まないファイル名。
        Size: オプション。ファイルサイズ。
        Ext: 必須。ファイル名拡張子。
    Required: false
  UserData:
    Type: Json
    Description:
      ja: ユーザーデータ。値は JSON 文字列である必要があります。メッセージコールバックなどの設定を構成できます。
    Required: false
  UploadTargetConfig:
    Type: Json
    Description:
      ja: |-
        保存先のストレージの場所。
        StorageType を oss に設定します。
        StorageLocation を ApsaraVideo VOD のアドレスに設定します。このフィールドを OSS URL に設定することはできません。
    Required: false
  MediaMetaData:
    Type: Json
    Description:
      ja: |-
        メディアアセットのメタデータ。JSON 文字列で、次のフィールドが含まれます。
        Title: 必須。
        値は最大 128 文字です。
        値は UTF-8 でエンコードする必要があります。
        Description: オプション。
        値は最大 1,024 文字です。
        値は UTF-8 でエンコードする必要があります。
        CateId: オプション。
        Tags: オプション。
        BusinessType: 必須。有効な値:
        Type が video の場合は opening または ending
        Type が image の場合は default または cover
        Type が text の場合は subtitles または font
        Type が material の場合は watermark
        general CoverURL: オプション。
        DynamicMetaData: 値は文字列です。
    Required: false
  PostProcessConfig:
    Type: Json
    Description:
      ja: 'Type = video || audio アップロード後の処理操作があります。ProcessType 値: Workflow。'
    Required: false
Resources:
  UploadMedia:
    Type: ALIYUN::ICE::UploadMedia
    Properties:
      EntityId:
        Ref: EntityId
      AppId:
        Ref: AppId
      FileInfo:
        Ref: FileInfo
      UserData:
        Ref: UserData
      UploadTargetConfig:
        Ref: UploadTargetConfig
      MediaMetaData:
        Ref: MediaMetaData
      PostProcessConfig:
        Ref: PostProcessConfig
Outputs:
  FileURL:
    Description: ファイルの OSS URL。URL には、認証に使用される情報は含まれていません。
    Value:
      Fn::GetAtt:
        - UploadMedia
        - FileURL
  MediaURL:
    Description: |-
      メディアアセットの URL。
      注: Alibaba Cloud CDN (CDN) のドメイン名が指定されている場合は、CDN URL が返されます。それ以外の場合は、OSS URL が返されます。ブラウザから URL にアクセスしたときに HTTP ステータスコード 403 が返された場合は、ApsaraVideo VOD の URL 認証機能が有効になっています。この問題を解決するには、URL 認証を無効にするか、認証署名を生成します。
    Value:
      Fn::GetAtt:
        - UploadMedia
        - MediaURL
  UploadAddress:
    Description: |-
      アップロード URL。
      注: 返されるアップロード URL は Base64 エンコードされた URL です。SDK を使用するか、API オペレーションを呼び出してメディアファイルをアップロードする前に、Base64 エンコードされたアップロード URL をデコードする必要があります。OSS SDK を使用するか、OSS API オペレーションを呼び出してメディアファイルをアップロードする場合にのみ、UploadAddress を解析する必要があります。
    Value:
      Fn::GetAtt:
        - UploadMedia
        - UploadAddress
  MediaId:
    Description: メディアアセットの ID。
    Value:
      Fn::GetAtt:
        - UploadMedia
        - MediaId
  UploadAuth:
    Description: |-
      アップロード認証情報。
      注: 返されるアップロード認証情報は Base64 エンコードされた値です。SDK を使用するか、API オペレーションを呼び出してメディアファイルをアップロードする前に、Base64 エンコードされたアップロード URL をデコードする必要があります。OSS SDK を使用するか、OSS API オペレーションを呼び出してメディアファイルをアップロードする場合にのみ、UploadAuth を解析する必要があります。
    Value:
      Fn::GetAtt:
        - UploadMedia
        - UploadAuth
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "EntityId": {
      "Type": "String",
      "Description": {
        "ja": "エンティティ ID。CreateEntity オペレーションを呼び出してエンティティを作成し、動的メタデータ構造を指定できます。"
      },
      "Required": false
    },
    "AppId": {
      "Type": "String",
      "Description": {
        "ja": "アプリケーション ID。デフォルト値: app-1000000。"
      },
      "Required": false
    },
    "FileInfo": {
      "Type": "Json",
      "Description": {
        "ja": "ファイル情報。JSON 形式で、次のフィールドが含まれます。\nType: 必須。ファイルの種類。有効な値: video、image、audio、text、other。\nName: 必須。拡張子を含まないファイル名。\nSize: オプション。ファイルサイズ。\nExt: 必須。ファイル名拡張子。"
      },
      "Required": false
    },
    "UserData": {
      "Type": "Json",
      "Description": {
        "ja": "ユーザーデータ。値は JSON 文字列である必要があります。メッセージコールバックなどの設定を構成できます。"
      },
      "Required": false
    },
    "UploadTargetConfig": {
      "Type": "Json",
      "Description": {
        "ja": "保存先のストレージの場所。\nStorageType を oss に設定します。\nStorageLocation を ApsaraVideo VOD のアドレスに設定します。このフィールドを OSS URL に設定することはできません。"
      },
      "Required": false
    },
    "MediaMetaData": {
      "Type": "Json",
      "Description": {
        "ja": "メディアアセットのメタデータ。JSON 文字列で、次のフィールドが含まれます。\nTitle: 必須。\n値は最大 128 文字です。\n値は UTF-8 でエンコードする必要があります。\nDescription: オプション。\n値は最大 1,024 文字です。\n値は UTF-8 でエンコードする必要があります。\nCateId: オプション。\nTags: オプション。\nBusinessType: 必須。有効な値:\nType が video の場合は opening または ending\nType が image の場合は default または cover\nType が text の場合は subtitles または font\nType が material の場合は watermark\ngeneral CoverURL: オプション。\nDynamicMetaData: 値は文字列です。"
      },
      "Required": false
    },
    "PostProcessConfig": {
      "Type": "Json",
      "Description": {
        "ja": "Type = video || audio アップロード後の処理操作があります。ProcessType 値: Workflow。"
      },
      "Required": false
    }
  },
  "Resources": {
    "UploadMedia": {
      "Type": "ALIYUN::ICE::UploadMedia",
      "Properties": {
        "EntityId": {
          "Ref": "EntityId"
        },
        "AppId": {
          "Ref": "AppId"
        },
        "FileInfo": {
          "Ref": "FileInfo"
        },
        "UserData": {
          "Ref": "UserData"
        },
        "UploadTargetConfig": {
          "Ref": "UploadTargetConfig"
        },
        "MediaMetaData": {
          "Ref": "MediaMetaData"
        },
        "PostProcessConfig": {
          "Ref": "PostProcessConfig"
        }
      }
    }
  },
  "Outputs": {
    "FileURL": {
      "Description": "ファイルの OSS URL。URL には、認証に使用される情報は含まれていません。",
      "Value": {
        "Fn::GetAtt": [
          "UploadMedia",
          "FileURL"
        ]
      }
    },
    "MediaURL": {
      "Description": "メディアアセットの URL。\n注: Alibaba Cloud CDN (CDN) のドメイン名が指定されている場合は、CDN URL が返されます。それ以外の場合は、OSS URL が返されます。ブラウザから URL にアクセスしたときに HTTP ステータスコード 403 が返された場合は、ApsaraVideo VOD の URL 認証機能が有効になっています。この問題を解決するには、URL 認証を無効にするか、認証署名を生成します。",
      "Value": {
        "Fn::GetAtt": [
          "UploadMedia",
          "MediaURL"
        ]
      }
    },
    "UploadAddress": {
      "Description": "アップロード URL。\n注: 返されるアップロード URL は Base64 エンコードされた URL です。SDK を使用するか、API オペレーションを呼び出してメディアファイルをアップロードする前に、Base64 エンコードされたアップロード URL をデコードする必要があります。OSS SDK を使用するか、OSS API オペレーションを呼び出してメディアファイルをアップロードする場合にのみ、UploadAddress を解析する必要があります。",
      "Value": {
        "Fn::GetAtt": [
          "UploadMedia",
          "UploadAddress"
        ]
      }
    },
    "MediaId": {
      "Description": "メディアアセットの ID。",
      "Value": {
        "Fn::GetAtt": [
          "UploadMedia",
          "MediaId"
        ]
      }
    },
    "UploadAuth": {
      "Description": "アップロード認証情報。\n注: 返されるアップロード認証情報は Base64 エンコードされた値です。SDK を使用するか、API オペレーションを呼び出してメディアファイルをアップロードする前に、Base64 エンコードされたアップロード URL をデコードする必要があります。OSS SDK を使用するか、OSS API オペレーションを呼び出してメディアファイルをアップロードする場合にのみ、UploadAuth を解析する必要があります。",
      "Value": {
        "Fn::GetAtt": [
          "UploadMedia",
          "UploadAuth"
        ]
      }
    }
  }
}