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

:GetTranscodeTemplateGroup

最終更新日:Dec 15, 2025

テンプレートグループ ID に基づいて、トランスコーディングテンプレートグループの詳細を照会します。

操作説明

この操作は、指定されたトランスコーディングテンプレートグループに関する情報と、グループ内のすべてのトランスコーディングテンプレートの構成を返します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vod:GetTranscodeTemplateGroup

get

*All Resource

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

TranscodeTemplateGroupId

string

必須

トランスコーディングテンプレートグループの ID。

a591f697c7167*****6ae1502142d0

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID。

6730AC93-7B12-4B*****7F-49EE1FE8BC49

TranscodeTemplateGroup

object

トランスコーディングテンプレートグループに関する情報。

CreationTime

string

トランスコーディングテンプレートグループが作成された時刻。時刻は、yyyy-MM-ddThh:mm:ssZ 形式の ISO 8601 標準に準拠しています。時刻は UTC で表示されます。

2018-12-12T10:20:51Z

IsDefault

string

テンプレートグループがデフォルトであるかどうかを示します。有効な値:

  • Default

  • NotDefault

NotDefault

AppId

string

アプリケーションの ID。

app-****

TranscodeTemplateGroupId

string

トランスコーディングテンプレートグループの ID。

a59b11f697c716*****6ae1502142d0

Name

string

トランスコーディングテンプレートグループの名前。

test

ModifyTime

string

トランスコーディングテンプレートグループが最後に変更された時刻。時刻は、yyyy-MM-ddThh:mm:ssZ 形式の ISO 8601 標準に準拠しています。時刻は UTC で表示されます。

2018-12-12T11:20:51Z

Locked

string

トランスコーディングテンプレートグループがロックされているかどうかを示します。有効な値:

  • Disabled:テンプレートグループはロックされていません。

  • Enabled:テンプレートグループはロックされています。

Enabled

TranscodeTemplateList

array<object>

トランスコーディングテンプレートに関する情報。

object

Type

string

トランスコーディングテンプレートのタイプ。有効な値:

  • Normal (デフォルト):通常のトランスコーディングテンプレートです。このタイプのテンプレートでは、PackageSetting パラメーターを設定できません。

  • VideoPackage:ビデオストリームパッケージテンプレートです。このタイプのテンプレートを使用する場合、ApsaraVideo VOD はビデオを異なるビットレートのビデオストリームにトランスコードし、これらのビデオストリームをファイルでパッケージ化します。このタイプのテンプレートでは、PackageSetting パラメーターを設定する必要があります。

  • SubtitlePackage:字幕パッケージテンプレートです。このタイプのテンプレートを使用する場合、ApsaraVideo VOD は、対応するビデオのマルチビットレートビデオストリームをパッケージ化して生成された出力ファイルに、トランスコーディングなしで字幕情報を追加します。字幕パッケージテンプレートには PackageSetting パラメーターを設定し、その字幕パッケージテンプレートをビデオストリームパッケージテンプレートに関連付ける必要があります。テンプレートグループには、字幕パッケージテンプレートを 1 つだけ含めることができます。

Normal

Video

string

ビデオストリームのトランスコーディング設定。値は JSON 文字列です。

{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}

TransConfig

string

条件付きトランスコーディングの設定。このパラメーターは、ビデオがトランスコードされる前に、ソースファイルのビットレートと解像度に基づいて基本的なロジックを決定する場合に使用できます。値は JSON 形式の文字列です。

{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}

Rotate

string

ビデオの回転識別子。画像の回転角度を制御するために使用されます。たとえば、このパラメーターを 180 に設定すると、ビデオ画像が上下逆になります。有効な値:[0,360]

90

TranscodeTemplateId

string

トランスコーディングテンプレート ID。

696d29a11erc057*****a3acc398d02f4

TemplateName

string

トランスコーディングテンプレートの名前。

test

EncryptSetting

string

トランスコーディングの暗号化設定。

"EncryptType":"Private"

Audio

string

オーディオストリームのトランスコーディング設定。値は JSON 文字列です。

{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}

TranscodeFileRegular

string

出力ファイルを保存するために使用されるカスタムパス。

{MediaId}/transcoce_1

Container

string

オーディオストリームとビデオストリームをカプセル化するために使用されるコンテナーのフォーマット。値は JSON 文字列です。

"Format":"m3u8"

Clip

string

ビデオのクリップ設定。値は JSON 文字列です。たとえば、ビデオから 5 秒間のコンテンツを抽出して新しいビデオを生成する場合、このパラメーターが返されます。

{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}

Definition

string

通常のトランスコーディングテンプレートの解像度の有効な値:

  • LD:低画質。

  • SD:標準画質。

  • HD:高画質。

  • FHD:超高画質。

  • OD:オリジナル画質。

  • 2K

  • 4K

  • SQ:標準音質。

  • HQ:高音質。

狭帯域 HD™ 1.0 トランスコーディングテンプレートの解像度の有効な値:

  • LD-NBV1:低画質。

  • SD-NBV1:標準画質。

  • HD-NBV1:高画質。

  • FHD-NBV1:超高画質。

  • 2K-NBV1

  • 4K-NBV1

説明
  • トランスコーディングテンプレートの解像度は変更できません。

  • 狭帯域 HD™ 1.0 トランスコーディングテンプレートのビデオ解像度、オーディオ解像度、ビットレートなどのシステムパラメーターは変更できません。

  • FLV、M3U8 (HLS)、MP4 の出力フォーマットをサポートする狭帯域 HD™ 1.0 トランスコーディングテンプレートのみを作成できます。

SD

PackageSetting

string

パッケージング設定。HLS パッケージングと DASH パッケージングのみがサポートされています。値は JSON 文字列です。

"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }

SubtitleList

string

字幕設定。値は JSON 文字列です。

[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]

MuxConfig

string

トランスコーディングセグメント設定。HLS (HTTP-Live-Streaming) 暗号化が使用されている場合、このパラメーターを返す必要があります。値は JSON 文字列です。

"Segment": { "Duration":"6" }

WatermarkIds

array

関連付けられたウォーターマークの ID。

string

関連付けられたウォーターマークの ID。

"USER_DEFAULT_WATERMARK","ddddddddd"

TraceMark

string

トレースウォーターマークのコンテンツ。

{ "Enable": true }

CopyrightMark

string

著作権ウォーターマークのコンテンツ。

{ "Content": "test" }

成功レスポンス

JSONJSON

{
  "RequestId": "6730AC93-7B12-4B*****7F-49EE1FE8BC49",
  "TranscodeTemplateGroup": {
    "CreationTime": "2018-12-12T10:20:51Z",
    "IsDefault": "NotDefault",
    "AppId": "app-****",
    "TranscodeTemplateGroupId": "a59b11f697c716*****6ae1502142d0",
    "Name": "test",
    "ModifyTime": "2018-12-12T11:20:51Z",
    "Locked": "Enabled",
    "TranscodeTemplateList": [
      {
        "Type": "Normal",
        "Video": "{\"Codec\":\"H.264\",\"Bitrate\":\"900\",\"Width\":\"960\",\"Remove\":\"false\",\"Fps\":\"30\"}",
        "TransConfig": "{\"IsCheckReso\":\"true\",\"IsCheckResoFail\":\"false\",\"IsCheckVideoBitrate\":\"false\",\"IsCheckVideoBitrateFail\":\"false\",\"IsCheckAudioBitrate\":\"false\",\"IsCheckAudioBitrateFail\":\"false\"}",
        "Rotate": "90",
        "TranscodeTemplateId": "696d29a11erc057*****a3acc398d02f4",
        "TemplateName": "test",
        "EncryptSetting": "\"EncryptType\":\"Private\"",
        "Audio": "{\\\"Codec\\\":\\\"AAC\\\",\\\"Remove\\\":\\\"false\\\",\\\"Bitrate\\\":\\\"44\\\",\\\"Samplerate\\\":\\\"32000\\\",\\\"Channels\\\":\\\"2\\\",\\\"Profile\\\":\\\"aac_low\\\"}",
        "TranscodeFileRegular": "{MediaId}/transcoce_1",
        "Container": "\"Format\":\"m3u8\"",
        "Clip": "{\\\"TimeSpan\\\":{\\\"Seek\\\":\\\"1\\\",\\\"Duration\\\":\\\"5\\\"}",
        "Definition": "SD",
        "PackageSetting": "\"PackageType\":\"HLSPackage\",\"PackageConfig\":{   \"BandWidth\":\"900000\"  }",
        "SubtitleList": "[{\"SubtitleUrl\":\"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass\",\"CharEncode\":\"utf-8\"}]",
        "MuxConfig": "\"Segment\": { \"Duration\":\"6\" }",
        "WatermarkIds": [
          "\"USER_DEFAULT_WATERMARK\",\"ddddddddd\""
        ],
        "TraceMark": "{\n\t\"Enable\": true\n}",
        "CopyrightMark": "{\n\t\"Content\": \"test\"\n}"
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。