GetTranscodeTemplateGroup - ApsaraVideo VOD

Mengambil detail kelompok template transkoding berdasarkan ID kelompok tersebut.

Deskripsi operasi

Operasi ini mengembalikan informasi mengenai kelompok template transkoding yang ditentukan beserta konfigurasi seluruh template transkoding dalam kelompok tersebut.

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

Parameter permintaan

Parameter	Type	Required	Description	Example
TranscodeTemplateGroupId	string	Yes	ID kelompok template transkoding.	a591f697c7167*****6ae1502142d0

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	6730AC93-7B12-4B*****7F-49EE1FE8BC49
TranscodeTemplateGroup	object	Informasi tentang kelompok template transkoding.
CreationTime	string	Waktu pembuatan kelompok template transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mm:ssZ dan ditampilkan dalam UTC.	2018-12-12T10:20:51Z
IsDefault	string	Menunjukkan apakah kelompok template tersebut merupakan template default. Nilai yang valid: Default NotDefault	NotDefault
AppId	string	ID aplikasi.	app-****
TranscodeTemplateGroupId	string	ID kelompok template transkoding.	a59b11f697c716*****6ae1502142d0
Name	string	Nama kelompok template transkoding.	test
ModifyTime	string	Waktu terakhir kelompok template transkoding dimodifikasi. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mm:ssZ dan ditampilkan dalam UTC.	2018-12-12T11:20:51Z
Locked	string	Menunjukkan apakah kelompok template transkoding dikunci. Nilai yang valid: Disabled: Kelompok template tidak dikunci. Enabled: Kelompok template dikunci.	Enabled
TranscodeTemplateList	array<object>	Informasi tentang template transkoding.
	object
Type	string	Jenis template transkoding. Nilai yang valid: Normal (default): template transkoding umum. Parameter PackageSetting tidak dapat diatur untuk jenis template ini. VideoPackage: template paket aliran video. Jika jenis template ini digunakan, ApsaraVideo VOD mentranskode video menjadi aliran video dengan bitrate berbeda dan mengemas aliran video tersebut ke dalam satu file. Parameter PackageSetting harus diatur untuk jenis template ini. SubtitlePackage: template paket subtitle. Jika jenis template ini digunakan, ApsaraVideo VOD menambahkan informasi subtitle ke file output yang dihasilkan dari pengemasan aliran video multi-bitrate tanpa transkoding. Anda harus mengatur parameter PackageSetting untuk template paket subtitle dan mengaitkan template paket subtitle dengan template paket aliran video. Satu kelompok template hanya dapat berisi satu template paket subtitle.	Normal
Video	string	Konfigurasi transkoding aliran video. Nilainya berupa string JSON.	{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}
TransConfig	string	Konfigurasi transkoding kondisional. Parameter ini dapat digunakan jika Anda ingin menentukan logika dasar berdasarkan bitrate dan resolusi file sumber sebelum video ditranskode. Nilainya berupa string dalam format JSON.	{"IsCheckReso":"true","IsCheckResoFail":"false","IsCheckVideoBitrate":"false","IsCheckVideoBitrateFail":"false","IsCheckAudioBitrate":"false","IsCheckAudioBitrateFail":"false"}
Rotate	string	Identifier rotasi video. Digunakan untuk mengontrol sudut rotasi gambar. Misalnya, jika Anda mengatur parameter ini ke 180, gambar video akan dibalik terbalik. Nilai yang valid: `[0,360]`.	90
TranscodeTemplateId	string	ID template transkoding.	696d29a11erc057*****a3acc398d02f4
TemplateName	string	Nama template transkoding.	test
EncryptSetting	string	Konfigurasi enkripsi untuk transkoding.	"EncryptType":"Private"
Audio	string	Konfigurasi transkoding aliran audio. Nilainya berupa string JSON.	{\"Codec\":\"AAC\",\"Remove\":\"false\",\"Bitrate\":\"44\",\"Samplerate\":\"32000\",\"Channels\":\"2\",\"Profile\":\"aac_low\"}
TranscodeFileRegular	string	Jalur kustom yang digunakan untuk menyimpan file output.	{MediaId}/transcoce_1
Container	string	Format kontainer yang digunakan untuk mengenkapsulasi aliran audio dan video. Nilainya berupa string JSON.	"Format":"m3u8"
Clip	string	Konfigurasi pemotongan video. Nilainya berupa string JSON. Misalnya, parameter ini dikembalikan jika Anda mengekstrak konten selama 5 detik dari video untuk menghasilkan video baru.	{\"TimeSpan\":{\"Seek\":\"1\",\"Duration\":\"5\"}
Definition	string	Nilai yang valid untuk definisi template transkoding umum: LD: definisi rendah. SD: definisi standar. HD: definisi tinggi. FHD: ultra definisi tinggi. OD: kualitas asli. 2K 4K SQ: kualitas suara standar. HQ: kualitas suara tinggi. Nilai yang valid untuk definisi template transkoding Narrowband HD™ 1.0: LD-NBV1: definisi rendah. SD-NBV1: definisi standar. HD-NBV1: definisi tinggi. FHD-NBV1: ultra definisi tinggi. 2K-NBV1 4K-NBV1 Catatan Anda tidak dapat mengubah definisi template transkoding. Anda tidak dapat memodifikasi parameter sistem, seperti resolusi video, resolusi audio, dan bitrate, pada template transkoding Narrowband HD™ 1.0. Anda hanya dapat membuat template transkoding Narrowband HD™ 1.0 yang mendukung format output FLV, M3U8 (HLS), dan MP4.	SD
PackageSetting	string	Konfigurasi pengemasan. Hanya pengemasan HLS dan pengemasan DASH yang didukung. Nilainya berupa string JSON.	"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }
SubtitleList	string	Konfigurasi subtitle. Nilainya berupa string JSON.	[{"SubtitleUrl":"http://outin-test.oss-cn-shanghai.aliyuncs.com/subtitles/c737fece-14f1-4364-b107-d5f7f8edde0e.ass","CharEncode":"utf-8"}]
MuxConfig	string	Konfigurasi segmen transkoding. Parameter ini harus dikembalikan jika enkripsi HTTP-Live-Streaming (HLS) digunakan. Nilainya berupa string JSON.	"Segment": { "Duration":"6" }
WatermarkIds	array	ID watermark yang terkait.
	string	ID watermark yang terkait.	"USER_DEFAULT_WATERMARK","ddddddddd"
TraceMark	string	Konten jejak watermark.	{ "Enable": true }
CopyrightMark	string	Konten Watermark hak cipta.	{ "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.