Use Alibaba Cloud CLI to call ApsaraVideo Live OpenAPI - ApsaraVideo Live

Alibaba Cloud CLI, OpenAPI üzerine inşa edilmiş genel amaçlı bir komut satırı aracıdır. Bu aracı kullanarak ApsaraVideo Live kaynaklarının yönetimini ve bakımını otomatikleştirebilirsiniz. Bu konuda, Alibaba Cloud CLI ile ApsaraVideo Live kullanımına örnek olarak DescribeLiveUserDomains işlemini çağırarak akış alan adlarını nasıl sorgulayacağınız adım adım açıklanmaktadır.

Başlamadan önce

Alibaba Cloud CLI hakkında bilgi edinin. Daha fazla bilgi için bkz. Alibaba Cloud CLI Nedir?

1. Adım: Alibaba Cloud CLI'yı yükleyin

Alibaba Cloud CLI'yı cihazınıza yükleyin. İşletim sisteminize uygun kurulum paketini seçin:

Windows işletim sistemi: Windows
Linux işletim sistemi: Linux
macOS işletim sistemi: macOS

Alternatif olarak, CLI komutlarını yerleşik Alibaba Cloud CLI içeren ve bunu güncel tutan Cloud Shell içinde hata ayıklayabilirsiniz. Daha fazla bilgi için bkz. Cloud Shell Nedir?.

2. Adım: Alibaba Cloud CLI'yı yapılandırın

Önemli

Bir Alibaba Cloud hesabı tüm hizmet API'lerine tam erişime sahiptir; bu durum güvenlik riskleri oluşturur. Bir Resource Access Management (RAM) kimliği oluşturmanızı, en az ayrıcalık ilkesine göre yalnızca gerekli izinleri vermenizi ve ardından API işlemlerini çağırmak için RAM kimliğini kullanmanızı öneririz. ApsaraVideo Live tarafından desteklenen ilkeler hakkında daha fazla bilgi için bkz. ApsaraVideo Live sistem ilkeleri ve ApsaraVideo Live özel ilkeleri.

Alibaba Cloud CLI'yı kullanmadan önce kimlik bilgilerini ve bir bölge kimliğini yapılandırın. Alibaba Cloud CLI çeşitli kimlik bilgisi türlerini destekler. Daha fazla bilgi için bkz. Kimlik bilgisi türleri. Bu örnekte AccessKey çiftleri kullanılmaktadır.

Kimlik bilgilerini yapılandırmak için bir RAM kullanıcısı oluşturun ve bu kullanıcı için bir AccessKey çifti oluşturun. Daha fazla bilgi için bkz. RAM kullanıcısı oluşturma ve AccessKey çifti oluşturma.
Gerekli izinleri RAM kullanıcısına verin. Bu örnekte, AliyunLiveReadOnlyAccess ilkesi RAM kullanıcısına eklenir. Bu ilke, RAM kullanıcısına ApsaraVideo Live üzerinde salt okunur izni verir. Daha fazla bilgi için bkz. RAM kullanıcısına izin verme.
API çağrılarınız için bölge kimliğini edinin. ApsaraVideo Live için kullanılabilen bölgeler hakkında daha fazla bilgi için bkz. Uç noktalar.

Not
Belirli bir bölgede komut çalıştırmak için --region seçeneğini kullanabilirsiniz. Bu seçenek, varsayılan kimlik bilgisi yapılandırmasındaki ve ortam değişkenlerindeki bölgeyi geçersiz kılar. Daha fazla bilgi için bkz. API çağrıları için komut satırı seçenekleri.
RAM kullanıcısının AccessKey çiftini kullanarak AkProfile adlı profilde AccessKey kimlik bilgilerini yapılandırın. Daha fazla bilgi için bkz. Yapılandırma örnekleri.

3. Adım: Bir CLI komutu oluşturun

OpenAPI Explorer'da DescribeLiveUserDomains hata ayıklama sayfasına gidin.
Parameters sekmesinde parametreleri yapılandırın. Ardından, oluşturulan örnek CLI komutunu görüntülemek için CLI Example sekmesini tıklayın.
CLI komutunu kopyalayın veya Cloud Shell içinde CLI komutunda hata ayıklayın.
- simgesini tıklayarak Cloud Shell öğesini başlatın ve Cloud Shell içinde CLI komutunda hata ayıklayın.
- CLI komutunu panoya kopyalamak için simgesini tıklayın. Ayrıca CLI komutunu yerel kabuğunuza yapıştırıp komutu çalıştırabilirsiniz.
Not
CLI komutunu yerel kabuğunuza yapıştırdığınızda parametre formatlarının gereksinimlerle eşleştiğinden emin olun. Daha fazla bilgi için bkz. Parametre formatları.

OpenAPI Explorer, varsayılan olarak oluşturulan CLI komutuna --region seçeneğini ekler. Bu seçenek, varsayılan kimlik bilgisi yapılandırmasındaki ve ortam değişkenlerindeki bölgeyi geçersiz kılar. Varsayılan bölgeyi kullanmak istiyorsanız bu seçeneği kaldırabilirsiniz.

4. Adım: ApsaraVideo Live API işlemlerini çağırın

Örnek 1: Alibaba Cloud CLI kullanarak ApsaraVideo Live tarafından desteklenen API işlemlerini sorgulayın

ApsaraVideo Live tarafından desteklenen tüm API işlemlerini listelemek için --help seçeneğini çalıştırın. Desteklenen API işlemlerini İşlevlere göre işlem listesi içinde de görüntüleyebilirsiniz.

Aşağıdaki komutu çalıştırın:
```
aliyun live --help
```

Komut çıktısını görüntüleyin.

Product: live (ApsaraVideo Live)
Version: 2016-11-01
Available Api List:
    AddCasterComponent            Adds a component to a caster.
    AddCasterEpisode              Adds an episode to a caster.
    AddCasterEpisodeGroup         Adds an episode group.
    AddCasterEpisodeGroupContent  Adds content to an episode group.
    AddCasterLayout               Adds a layout to a caster.
    AddCasterProgram              Adds a program to a caster.
    AddCasterVideoResource        Adds a video resource. The number of video resources is limited by the caster inputs.
    AddCustomLiveStreamTranscode  Adds a custom transcoding configuration.
    AddLiveAIProduceRules
    AddLiveAISubtitle
    AddLiveAppRecordConfig        Configures application-based recording and saves the output to OSS.
    AddLiveAppSnapshotConfig      Configures snapshot capturing. The configuration takes effect after you restart streaming.
    AddLiveAudioAuditConfig       Adds a configuration for audio moderation.
    AddLiveAudioAuditNotifyConfig Adds a callback configuration for audio moderation.
    AddLiveCenterTransfer         Adds a stream relay configuration in Live Center.
    AddLiveDetectNotifyConfig     Adds a callback URL for content moderation.
    AddLiveDomain                 Adds a domain name. You can add only one domain name at a time.
    AddLiveDomainMapping          Adds a mapping between a streaming domain and an ingest domain.
    AddLiveDomainPlayMapping      Adds a mapping between a primary streaming domain and a secondary streaming domain.

Örnek 2: Hesaptaki tüm ApsaraVideo Live alan adlarını sorgulayın

Hesabınızdaki tüm akış alan adlarını sorgulamak için ApsaraVideo Live öğesinin DescribeUserDomains işlemini çağırın.

Aşağıdaki komutu çalıştırın:

aliyun live DescribeLiveUserDomains --LiveDomainType liveVideo

Komut çıktısını görüntüleyin.

{
  "Domains": {
    "PageData": [
      {
        "Cname": "learn.developer.aliyundoc.com",
        "Description": "test",
        "DomainName": "demo.aliyundoc.com",
        "GmtCreated": "2017-08-29T12:15:36Z",
        "GmtModified": "2017-12-29T12:15:36Z",
        "LiveDomainStatus": "online",
        "LiveDomainType": "liveVideo",
        "RegionName": "cn-beijing",
        "ResourceGroupId": ""
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 100,
  "RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B15267",
  "TotalCount": 1
}

Not

ApsaraVideo Live API işlemini çağırırken bir hata döndürülürse girdi parametrelerini ve değerlerini hata koduna göre doğrulayın.

Ayrıca yanıt veya SDK hata mesajından RequestId öğesini kopyalayabilir ve kendi kendine hizmet tanılama için OpenAPI Tanılama Platformunu kullanabilirsiniz.