All Products
Search

This Product

    ApsaraVideo Live:AddLiveDomain

    Document Center

    ApsaraVideo Live:AddLiveDomain

    Last Updated:Jul 20, 2026

    Menambahkan nama domain streaming. Anda hanya dapat menambahkan satu nama domain sekaligus.

    Deskripsi operasi

    • Sebelum menambahkan nama domain streaming, Anda harus mengaktifkan ApsaraVideo Live. Untuk informasi lebih lanjut, lihat Mengaktifkan layanan.

    • Sebelum menambahkan nama domain baru, Anda harus terlebih dahulu memverifikasi kepemilikan domain, lalu memanggil operasi ini untuk menambahkan domain. Anda dapat menggunakan verifikasi resolusi DNS atau verifikasi file. Untuk informasi lebih lanjut, lihat Memverifikasi kepemilikan domain.

    • ApsaraVideo Live memerlukan pengambilan aliran dan streaming. Anda harus menambahkan domain ingest dan domain streaming secara terpisah. Anda hanya dapat mengirimkan satu nama domain sekaligus.

    • Setelah menambahkan nama domain, Anda harus Nama Domain CNAME untuk domain tersebut. Untuk informasi lebih lanjut, lihat Nama Domain CNAME.

    • Setelah menambahkan domain ingest dan domain streaming, Anda harus mengaitkan domain terkait sebelum dapat menggunakan ApsaraVideo Live. Untuk informasi lebih lanjut, lihat Domain terkait.

    Penting Mulai 19 Februari 2019, nama domain yang ditambahkan menggunakan AddLiveDomain tidak mendukung pengambilan di Pusat Siaran Langsung. Nama domain baru yang ditambahkan menggunakan operasi API CDN juga tidak mendukung pengambilan di Pusat Siaran Langsung. Gunakan pengambilan di edge untuk menambahkan domain ingest (panggil AddLiveDomain dengan jenis bisnis diatur ke liveEdge) dan domain streaming (panggil AddLiveDomain dengan jenis bisnis diatur ke liveVideo), lalu kaitkan keduanya (panggil AddLiveDomainMapping). Nama domain yang ditambahkan sebelum 19 Februari 2019 tidak terpengaruh.

    Batas QPS

    Batas QPS per pengguna tunggal untuk operasi ini adalah 30 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttling), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan bijak.

    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

    live:AddLiveDomain

    create

    *Semua sumber daya.

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    LiveDomainType

    string

    Yes

    Jenis nama domain. Nilai valid:

    • liveVideo: domain streaming. Jika Anda mengatur DomainName (nama domain yang akan dihubungkan ke ApsaraVideo Live) sebagai domain streaming, Anda harus mengatur parameter ini ke liveVideo.

    • liveEdge: domain ingest. Jika Anda mengatur DomainName (nama domain yang akan dihubungkan ke ApsaraVideo Live) sebagai domain ingest, Anda harus mengatur parameter ini ke liveEdge.

    Valid values:

    • liveEdge :

      domain ingest.

    • liveGrtnPub :

      domain ingest GRTN.

    • liveGrtnSub :

      domain streaming GRTN.

    • liveVideo :

      domain streaming.

    liveVideo.
    DomainName

    string

    Yes

    Domain ingest atau domain streaming yang akan dihubungkan ke ApsaraVideo Live. Nama domain wildcard didukung dan harus dimulai dengan periode (.).

    example.aliyundoc.com.
    Region

    string

    Yes

    Informasi unit dari nama domain streaming. Nilai valid:

    • cn-beijing: Beijing.

    • cn-shanghai: Shanghai.

    • cn-shenzhen: Shenzhen.

    • cn-qingdao: Qingdao.

    • ap-southeast-1: Singapura.

    • eu-central-1: Jerman.

    • ap-northeast-1: Tokyo.

    • ap-southeast-5: Jakarta.

    Catatan

    Region (informasi unit dari nama domain streaming) dan Scope (wilayah akselerasi) tidak saling membatasi.

    cn-beijing.
    CheckUrl

    string

    No

    URL pemeriksaan kesehatan.

    http://demo.aliyundoc.com/status.html.
    Scope

    string

    No

    Wilayah akselerasi. Parameter ini berlaku untuk pengguna internasional dan pengguna situs China level L3 atau di atasnya. Nilai valid:

    • domestic (default): Daratan Tiongkok.

    • overseas: luar Daratan Tiongkok, termasuk Hong Kong (China), Makau (China), dan Taiwan (China).

    • global: akselerasi global.

    domestic.
    TopLevelDomain

    string

    No

    Nama domain tingkat atas untuk akses.

    learn.aliyundoc.com.
    ResourceGroupId

    string

    No

    ID kelompok sumber daya. Untuk informasi lebih lanjut tentang kelompok sumber daya, lihat Apa itu kelompok sumber daya.

    rg-aekzw******
    Tag

    array<object>

    No

    Daftar tag.

    object

    No

    Daftar tag.

    Key

    string

    No

    Kunci tag.

    TestKey.
    Value

    string

    No

    Nilai tag.

    TestValue.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidDomainName.Malformed Specified DomainName is malformed.
    400 InvalidRegion.Malformed Specified Region is malformed. Wilayah yang ditentukan tidak valid.
    400 InvalidSource.Content.Malformed Specified source content is malformed.
    400 InvalidTypeContent.Mismatch Specified source type does not math the specified source content.
    400 MissingSource.Content Specified source content is mandatory for this action.
    400 MissingSource.Type Specified source type is mandatory for this action.
    400 InvalidSource.Type.Malformed Specified source type is malformed.
    400 InvalidSource.Priority.Malformed Specified source priority is malformed.
    400 InvalidScope.Malformed Specified Scope is malformed.
    400 SourceIp.Exceed The Certificate you provided is malformed!
    400 InvalidCertificate The Certificate you provided is malformed!
    400 InvalidCertificate.TooLong The Certificate you provided is over the max length!
    400 InnerAddDomainDenied Your account haven't bind aoneId, can not add domain.
    400 CheckSourceHealthFailed sources ip or source domain check health failed，please input right source.
    400 ExtensiveAndAllBothExist Extensive domain and the domain begins with 'all.' can not exist at the same time.
    400 CdnTypeNotSupportExtensiveDomain Extensive domain not supported for this cdn type.
    400 ExtensiveAndSpecificDomainConflict Extensive domain and corresponding specific domain are mutually exclusive. Nama domain wildcard bertentangan dengan nama domain eksak yang sesuai.
    400 InvalidDomainNameLevel Domain name suffixed with alicdn.com only support third level.
    400 TopLevelDomain.NotFound TopLevelDomain is not exist.
    400 EntityNotExists.ResourceGroup The resource group does not exist.
    400 InvalidStatus.ResourceGroup It's now allowed to do this operation because of the current status of resource-group.
    400 NotInternationRealIdentity You need to do real name authentication when you use Chinese mainland resources. Anda harus menggunakan identitas terotorisasi yang valid untuk mengakses Sumber daya di daratan Tiongkok.
    400 RecordCheckNotAvailable Please try again later.
    400 IcpBlack The domain is on the ICP blacklist.
    400 IspBlack The domain is on the ISP blacklist.
    400 DomainNotRecordedAliyun The domain not access Ali Cloud for the record please access.
    400 Abs.CheckUrl.Malformed The CheckUrl you provided is malformed!
    400 DomainOwnerVerifyFail Owner verification of the root domain failed.
    400 TopLevelDomain.Mismatch The specified TopLevelDomain does not match webSiteType.
    400 InvalidResourceGroupId.Malformed Specified ResourceGroupId is malformed.
    400 DomainReserved The root domain of your domain is reserved by another account. Nama domain root nama domain ini telah ditambahkan ke akun lain.
    400 ExceedLimit The number of domains has exceeded the limit. Jumlah nama domain yang Anda miliki telah melebihi batas atas.
    400 LockFail Domain has been occupied. Nama domain sedang digunakan. Coba lagi nanti.
    403 AccountException Account exception. Please open ticket to make an appeal.
    403 EntityNotExist.ResourceGroup The resource group does not exist. Kelompok sumber daya tidak ada.
    404 InvalidUser The user's account is invalid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.