Otomatiskan pekerjaan MPS dengan memanggil API melalui Alibaba Cloud CLI - ApsaraVideo MPS

Alibaba Cloud CLI adalah alat baris perintah serbaguna yang dikembangkan berdasarkan OpenAPI. Anda dapat menggunakan Alibaba Cloud CLI untuk mengotomatiskan pengelolaan dan pemeliharaan di ApsaraVideo Media Processing. Topik ini menjelaskan cara menggunakan Alibaba Cloud CLI untuk memanggil operasi API dari ApsaraVideo Media Processing.

Sebelum Anda mulai

Pelajari Alibaba Cloud CLI. Untuk informasi lebih lanjut, lihat Apa itu Alibaba Cloud CLI?.

Instal Alibaba Cloud CLI

Anda harus menginstal Alibaba Cloud CLI sebelum menggunakannya. Anda dapat menginstalnya pada sistem operasi Windows, Linux, dan macOS. Pilih paket instalasi sesuai dengan sistem operasi perangkat Anda. Untuk informasi lebih lanjut, lihat topik-topik berikut:

Anda juga dapat menggunakan Cloud Shell yang disediakan oleh Alibaba Cloud untuk men-debug perintah yang ingin Anda jalankan di Alibaba Cloud CLI. Untuk informasi lebih lanjut tentang Cloud Shell, lihat Apa itu Cloud Shell?.

Konfigurasikan Alibaba Cloud CLI

Penting

Akun Alibaba Cloud memiliki izin untuk mengelola dan mengakses operasi API dari semua layanan Alibaba Cloud. Jika Anda menggunakan akun utama untuk memanggil operasi API, risiko keamanan mungkin timbul. Kami merekomendasikan agar Anda memanggil operasi API atau melakukan O&M rutin sebagai Pengguna Resource Access Management (RAM).

Sebelum menggunakan Alibaba Cloud CLI, konfigurasikan informasi seperti kredensial identitas dan ID wilayah. Alibaba Cloud CLI mendukung berbagai jenis kredensial identitas. Untuk informasi lebih lanjut, lihat bagian "Jenis Kredensial" dalam topik Konfigurasikan Profil. Dalam contoh ini, kredensial AccessKey digunakan. Ikuti langkah-langkah berikut untuk menggunakan kredensial AccessKey:

Buat pengguna RAM dan berikan izin yang diperlukan kepada pengguna tersebut. Untuk informasi lebih lanjut, lihat Buat Pengguna RAM dan Berikan Izin kepada Pengguna RAM.
Penting
Dalam contoh ini, kebijakan AliyunMTSFullAccess dilampirkan ke pengguna RAM. Anda juga dapat menggunakan kebijakan kustom. Untuk informasi lebih lanjut, lihat Kebijakan Kustom untuk MPS.
Buat pasangan AccessKey untuk pengguna RAM dan catat ID AccessKey dan Rahasia AccessKey untuk konfigurasi kredensial identitas selanjutnya. Untuk informasi lebih lanjut, lihat Buat Pasangan AccessKey.
Peroleh dan catat ID wilayah yang tersedia untuk konfigurasi kredensial identitas selanjutnya. Alibaba Cloud CLI menggunakan ID wilayah yang ditentukan untuk memulai panggilan API. Untuk informasi lebih lanjut tentang wilayah yang tersedia, lihat Endpoints.
Catatan
Saat menggunakan Alibaba Cloud CLI, Anda dapat menentukan opsi --region untuk menjalankan perintah di wilayah tertentu. Jika Anda menentukan opsi ini, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi profil default dan variabel lingkungan. Untuk informasi lebih lanjut, lihat Opsi Baris Perintah untuk Panggilan API.
Gunakan pasangan AccessKey dari pengguna RAM untuk mengonfigurasi kredensial AccessKey dalam profil bernama AkProfile. Untuk informasi lebih lanjut, lihat bagian "Contoh Konfigurasi" dalam topik Konfigurasikan Profil.

Hasilkan perintah CLI

Pergi ke halaman Debugging MPS.
Di kotak pencarian di sisi kiri halaman Debugging, cari operasi API yang ingin Anda panggil. Di tab Parameters operasi API, tentukan parameter berdasarkan referensi API. Klik tab CLI Example di sebelah kanan untuk melihat perintah sampel yang dihasilkan yang berisi parameter yang ditentukan.
- Klik ikon untuk memulai Cloud Shell dan debug perintah di Cloud Shell.
- Klik ikon untuk menyalin perintah sampel ke clipboard. Lalu, tempelkan perintah sampel ke shell lokal Anda untuk menjalankan perintah tersebut.
  - Perhatikan format parameter saat menempelkan perintah sampel ke shell lokal Anda untuk debugging. Untuk informasi lebih lanjut tentang format parameter Alibaba Cloud CLI, lihat Format Parameter.
  - Secara default, OpenAPI Explorer menambahkan opsi --region ke perintah sampel yang dihasilkan. Saat menjalankan perintah di shell lokal Anda, Alibaba Cloud CLI mengabaikan informasi wilayah dalam konfigurasi profil default dan variabel lingkungan, dan secara prioritas menjalankan perintah di wilayah yang ditentukan. Anda dapat menghapus atau mempertahankan opsi tersebut berdasarkan kebutuhan bisnis Anda.

Panggil operasi API

Sintaksis

Di Alibaba Cloud CLI, gunakan sintaksis berikut untuk menjalankan perintah. Untuk informasi lebih lanjut, lihat bagian "Sintaksis" dalam topik Hasilkan dan Jalankan Perintah CLI.

aliyun <command> <subcommand> [opsi dan parameter]

Opsi perintah

Saat menggunakan Alibaba Cloud CLI, Anda dapat menentukan opsi perintah untuk mengubah perilaku default perintah atau mengimplementasikan fitur tambahan perintah. Opsi perintah umum:

--profile <profileName>: Gunakan opsi --profile dan parameter profileName untuk menentukan profil. Setelah menentukan profil yang valid, Alibaba Cloud CLI mengabaikan konfigurasi profil default dan variabel lingkungan, serta menggunakan profil yang Anda tentukan untuk menjalankan perintah.
--help: Gunakan opsi --help untuk mendapatkan informasi bantuan tentang perintah. Untuk informasi lebih lanjut, lihat Gunakan Perintah Help.

Untuk informasi lebih lanjut, lihat Opsi Baris Perintah untuk Panggilan API.

Contoh

Contoh 1: Gunakan opsi --help untuk mendapatkan daftar operasi API ApsaraVideo Media Processing yang didukung oleh Alibaba Cloud CLI. Anda juga dapat melihat operasi API yang dapat dipanggil di Daftar Operasi Berdasarkan Fungsi.

Jalankan perintah berikut:
```
aliyun mts --help
```
Lihat keluaran perintah.

Contoh 2: Gunakan Alibaba Cloud CLI untuk memanggil operasi QueryMediaInfoJobList dari ApsaraVideo Media Processing untuk menanyakan pekerjaan informasi media. Untuk informasi lebih lanjut tentang operasi QueryMediaInfoJobList, lihat QueryMediaInfoJobList.

Jalankan perintah berikut:

aliyun mts QueryMediaInfoJobList --region cn-hangzhou --MediaInfoJobIds '23ca1d184c0e4341e5b665e2a12****'

Lihat keluaran perintah.

{
  "NonExistMediaInfoJobIds": {
    "String": [
      "11ce1d184c0e4341e5b665e2a12****"
    ]
  },
  "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
  "MediaInfoJobList": {
    "MediaInfoJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "State": "Success",
        "JobId": "23ca1d184c0e4341e5b665e2a12****",
        "UserData": "testid-001",
        "Code": "InvalidParameter.JsonObjectFormatInvalid",
        "Message": "Parameter "*" tidak sesuai dengan spesifikasi JSON Object",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
          "Object": "example.mp4",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "Parameter \\\"Input\\\" tidak sesuai dengan spesifikasi JSON Object",
          "ErrorCode": "InvalidParameter.JsonObjectFormatInvalid"
        },
        "Properties": {
          "Width": "1280",
          "Height": "720",
          "Duration": "17.226000",
          "Fps": "25",
          "Bitrate": "1630.045",
          "FileFormat": "QuickTime/MOV",
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "1080",
                  "CodecTagString": "[0][0][0][0]",
                  "NetworkCost": {
                    "PreloadTime": "8",
                    "AvgBitrate": "300.34",
                    "CostBandwidth": "10"
                  },
                  "Width": "1920",
                  "Index": "1",
                  "Timebase": "1/1000",
                  "AvgFPS": "23.976025",
                  "PixFmt": "yuv420p",
                  "Lang": "eng",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "100",
                  "Rotate": "180",
                  "Bitrate": "30541090",
                  "HasBFrames": "0",
                  "Profile": "High",
                  "StartTime": "0.042000",
                  "Dar": "16:9",
                  "CodecName": "h264",
                  "Duration": "100",
                  "Fps": "25",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1001/48000",
                  "Level": "41",
                  "ColorRange": "700",
                  "ColorTransfer": "R255 G83 B170",
                  "ColorPrimaries": "700"
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "5.1(side)",
                  "Lang": "eng",
                  "Samplerate": "48000",
                  "CodecLongName": "DCA (DTS Coherent Acoustics)",
                  "Channels": "2",
                  "NumFrames": "123",
                  "Bitrate": "1536000",
                  "CodecTagString": "[0][0][0][0]",
                  "StartTime": "0.042000",
                  "CodecName": "acc",
                  "Duration": "123",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1/48000"
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "3",
                  "StartTime": "0.000000",
                  "CodecName": "ass",
                  "Lang": "eng",
                  "CodecLongName": "ASS (Advanced SSA) subtitle",
                  "Duration": "1370.116000",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "0/1",
                  "CodecTagString": "[0][0][0][0]"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.042000",
            "NumPrograms": "2",
            "Size": "3509895",
            "NumStreams": "1",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "17.226000",
            "Bitrate": "1630.045",
            "FormatName": "mov"
          },
          "FileSize": "3509895"
        }
      }
    ]
  }
}

Catatan

Jika terjadi kesalahan setelah Anda memanggil operasi API dari ApsaraVideo Media Processing, Anda harus memeriksa apakah parameter permintaan dan nilainya valid berdasarkan kode kesalahan yang dikembalikan.

Anda juga dapat melakukan diagnosis mandiri berdasarkan ID permintaan yang dikembalikan atau informasi kesalahan SDK di halaman Diagnosis Masalah OpenAPI.