All Products
Search
Document Center

ApsaraVideo VOD:GetTranscodeTemplateGroup

Last Updated:Jun 10, 2026

Mengkueri detail grup template transcoding berdasarkan ID grup template.

Deskripsi operasi

Operasi ini mengembalikan informasi tentang grup template transcoding yang ditentukan dan konfigurasi dari semua template transcoding di dalam grup.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vod:GetTranscodeTemplateGroup

get

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

TranscodeTemplateGroupId

string

Yes

ID grup template transcoding.

a591f697c7167*****6ae1502142d0

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

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

TranscodeTemplateGroup

object

Informasi tentang grup template transcoding.

CreationTime

string

Waktu saat grup template transcoding dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mm:ssZ. Waktu ditampilkan dalam UTC.

2018-12-12T10:20:51Z

IsDefault

string

Menunjukkan apakah grup template ini adalah grup default. Nilai yang valid:

  • Default

  • NotDefault

NotDefault

AppId

string

ID aplikasi.

app-****

TranscodeTemplateGroupId

string

ID grup template transcoding.

a59b11f697c716*****6ae1502142d0

Name

string

Nama grup template transcoding.

test

ModifyTime

string

Waktu saat grup template transcoding terakhir diubah. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mm:ssZ. Waktu ditampilkan dalam UTC.

2018-12-12T11:20:51Z

Locked

string

Menunjukkan apakah grup template transcoding terkunci. Nilai yang valid:

  • Disabled: Grup template tidak terkunci.

  • Enabled: Grup template terkunci.

Enabled

TranscodeTemplateList

array<object>

Informasi tentang template transcoding.

object

Type

string

The type of the transcoding template. Valid values:

  • Normal (default): a common transcoding template. The PackageSetting parameter cannot be set for this type of template.

  • VideoPackage: a video stream package template. If this type of template is used, ApsaraVideo VOD transcodes a video into video streams in different bitrates and packages these video streams with a file. The PackageSetting parameter must be set for this type of template.

  • SubtitlePackage: a subtitle package template. If this type of template is used, ApsaraVideo VOD adds the subtitle information to the output file generated by packaging the multi-bitrate video streams of the corresponding video without transcoding. You must set the PackageSetting parameter for a subtitle package template and associate the subtitle package template with a video stream package template. A template group can contain only one subtitle package template.

Normal

Video

string

The transcoding configurations of the video stream. The value is a JSON string.

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

TransConfig

string

The conditional transcoding configurations. This parameter can be used if you want to determine the basic logic based on the bitrate and resolution of the source file before the video is transcoded. The value is a JSON-formatted string.

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

Rotate

string

The video rotation identifier. It is used to control the image rotation angle. For example, if you set this parameter to 180, the video image is turned upside down. Valid values: [0,360].

90

TranscodeTemplateId

string

The transcoding template ID.

696d29a11erc057*****a3acc398d02f4

TemplateName

string

The name of the transcoding template.

test

EncryptSetting

string

The encryption configuration for transcoding.

"EncryptType":"Private"

Audio

string

The transcoding configurations of the audio stream. The value is a JSON string.

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

TranscodeFileRegular

string

The custom path used to store the output files.

{MediaId}/transcoce_1

Container

string

The format of the container used to encapsulate audio and video streams. The value is a JSON string.

"Format":"m3u8"

Clip

string

The clipping configurations of the video. The value is a JSON string. For example, this parameter is returned if you extract 5 seconds of content from a video to generate a new video.

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

Definition

string

Valid values for the definition of a common transcoding template:

  • LD: low definition.

  • SD: standard definition.

  • HD: high definition.

  • FHD: ultra high definition.

  • OD: original quality.

  • 2K

  • 4K

  • SQ: standard sound quality.

  • HQ: high sound quality.

Valid values for the definition of a Narrowband HD™ 1.0 transcoding template:

  • LD-NBV1: low definition.

  • SD-NBV1: standard definition.

  • HD-NBV1: high definition.

  • FHD-NBV1: ultra high definition.

  • 2K-NBV1

  • 4K-NBV1

Catatan
  • You cannot change the definition of a transcoding template.

  • You cannot modify the system parameters, such as the video resolution, audio resolution, and bitrate, of Narrowband HD™ 1.0 transcoding templates.

  • You can create only Narrowband HD™ 1.0 transcoding templates that support the FLV, M3U8 (HLS), and MP4 output formats.

SD

PackageSetting

string

The packaging configuration. Only HLS packaging and DASH packaging are supported. The value is a JSON string.

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

SubtitleList

string

The subtitle configurations. The value is a JSON string.

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

MuxConfig

string

The transcoding segment configurations. This parameter must be returned if HTTP-Live-Streaming (HLS) encryption is used. The value is a JSON string.

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

WatermarkIds

array

The IDs of the associated watermarks.

string

The ID of the associated watermark.

"USER_DEFAULT_WATERMARK","ddddddddd"

TraceMark

string

The content of the tracing watermark.

{ "Enable": true }

CopyrightMark

string

The content of the copyright watermark.

{ "Content": "test" }

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.