Gunakan GetTranscodeTemplateGroup untuk mengkueri detail grup template transcoding - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Mengkueri detail konfigurasi transkoding berdasarkan ID kelompok template transkoding.

Deskripsi operasi

Mengambil informasi tentang satu kelompok template, termasuk informasi konfigurasi semua 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

*全部资源

*

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	Data kelompok template transkoding.
CreationTime	string	Waktu pembuatan kelompok template. Waktu menggunakan format yyyy-MM-ddTHH:mm:ssZ (UTC).	2018-12-12T10:20:51Z
IsDefault	string	Apakah kelompok template adalah default. Nilai valid: Default: Kelompok template adalah default. NotDefault: Kelompok template bukan default.	NotDefault.
AppId	string	ID aplikasi.	app-****
TranscodeTemplateGroupId	string	ID kelompok template transkoding.	a59b11f697c716*****6ae1502142d0
Name	string	Nama kelompok template.	test.
ModifyTime	string	Waktu terakhir modifikasi kelompok template. Waktu menggunakan format yyyy-MM-ddTHH:mm:ssZ (UTC).	2018-12-12T11:20:51Z
Locked	string	Apakah kelompok template terkunci. Nilai valid: Disabled: Tidak terkunci. Enabled: Terkunci.	Enabled.
TranscodeTemplateList	array<object>	Daftar konfigurasi template transkoding.
	object
Type	string	Tipe template transcoding. Nilai yang valid: Normal (default): template transcoding umum. Parameter PackageSetting tidak dapat ditetapkan untuk tipe template ini. VideoPackage: template paket aliran video. Jika tipe template ini digunakan, ApsaraVideo VOD melakukan transcoding video menjadi aliran video dalam berbagai bitrate dan mengemas aliran video tersebut dalam satu file. Parameter PackageSetting harus ditetapkan untuk tipe template ini. SubtitlePackage: template paket subtitle. Jika tipe template ini digunakan, ApsaraVideo VOD menambahkan informasi subtitle ke file output yang dihasilkan dari pengemasan aliran video multi-bitrate dari video terkait tanpa melakukan transcoding. Anda harus menetapkan parameter PackageSetting untuk template paket subtitle dan mengaitkan template paket subtitle dengan template paket aliran video. Sebuah grup template hanya dapat berisi satu template paket subtitle.	Normal
Video	string	Konfigurasi transcoding aliran video. Nilainya adalah string JSON.	{"Codec":"H.264","Bitrate":"900","Width":"960","Remove":"false","Fps":"30"}
TransConfig	string	Konfigurasi transcoding bersyarat. Parameter ini dapat digunakan jika Anda ingin menentukan logika dasar berdasarkan bitrate dan resolusi file sumber sebelum video di-transcode. Nilainya adalah string berformat 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 menetapkan parameter ini ke 180, gambar video akan terbalik. Nilai yang valid: `[0,360]`.	90
TranscodeTemplateId	string	ID template transcoding.	696d29a11erc057*****a3acc398d02f4
TemplateName	string	Nama template transcoding.	test
EncryptSetting	string	Konfigurasi enkripsi untuk transcoding.	"EncryptType":"Private"
Audio	string	Konfigurasi transcoding aliran audio. Nilainya adalah 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 adalah string JSON.	"Format":"m3u8"
Clip	string	Konfigurasi pemotongan (clipping) video. Nilainya adalah string JSON. Misalnya, parameter ini dikembalikan jika Anda mengekstrak konten 5 detik dari sebuah video untuk menghasilkan video baru.	{"TimeSpan":{"Seek":"1","Duration":"5"}
Definition	string	Nilai yang valid untuk definisi template transcoding umum: LD: definisi rendah (low definition). SD: definisi standar (standard definition). HD: definisi tinggi (high definition). FHD: definisi ultra tinggi (ultra high definition). OD: kualitas asli (original quality). 2K 4K SQ: kualitas suara standar (standard sound quality). HQ: kualitas suara tinggi (high sound quality). Nilai yang valid untuk definisi template transcoding Narrowband HD™ 1.0: LD-NBV1: definisi rendah. SD-NBV1: definisi standar. HD-NBV1: definisi tinggi. FHD-NBV1: definisi ultra tinggi. 2K-NBV1 4K-NBV1 Catatan Anda tidak dapat mengubah definisi template transcoding. Anda tidak dapat memodifikasi parameter sistem, seperti resolusi video, resolusi audio, dan bitrate, dari template transcoding Narrowband HD™ 1.0. Anda hanya dapat membuat template transcoding Narrowband HD™ 1.0 yang mendukung format output FLV, M3U8 (HLS), dan MP4.	SD
PackageSetting	string	Konfigurasi packaging. Hanya packaging HLS dan packaging DASH yang didukung. Nilainya adalah string JSON.	"PackageType":"HLSPackage","PackageConfig":{ "BandWidth":"900000" }
SubtitleList	string	Konfigurasi subtitle. Nilainya adalah 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 transcoding. Parameter ini harus dikembalikan jika enkripsi HTTP-Live-Streaming (HLS) digunakan. Nilainya adalah string JSON.	"Segment": { "Duration":"6" }
WatermarkIds	array	ID watermark yang terkait.
	string	ID watermark yang terkait.	"USER_DEFAULT_WATERMARK","ddddddddd"
TraceMark	string	Konten dari watermark pelacakan (tracing watermark).	{ "Enable": true }
CopyrightMark	string	Konten dari watermark hak cipta (copyright watermark).	{ "Content": "Test copyright watermark text" }

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\"Content\": \"Test copyright watermark text\"\n}"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.