すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:AddLiveDomain

    ドキュメントセンター

    ApsaraVideo Live:AddLiveDomain

    最終更新日:Jul 20, 2026

    ライブストリーミングドメイン名を追加します。一度に追加できるドメイン名は 1 つだけです。

    操作説明

    • ライブストリーミングドメイン名を追加する前に、ApsaraVideo Live を有効化する必要があります。詳細については、「サービスの有効化」をご参照ください。

    • 新しいドメイン名を追加する前に、まずドメイン名の所有権を確認し、その後この操作を呼び出してドメイン名を追加する必要があります。DNS 解像度確認またはファイル確認を使用できます。詳細については、「ドメイン名の所有権の確認」をご参照ください。

    • ApsaraVideo Live では、アップストリーミングとストリームの両方が必要です。アップストリーミングドメインとストリーミングドメインを個別に追加する必要があります。一度にコミットできるドメイン名は 1 つだけです。

    • ドメイン名を追加した後、そのドメイン名の CNAME ドメイン名解決を設定する必要があります。詳細については、「CNAME ドメイン名解決の設定」をご参照ください。

    • アップストリーミングドメインとストリーミングドメインを追加した後、ApsaraVideo Live を使用する前に関連ドメインを関連付ける必要があります。詳細については、「関連ドメイン」をご参照ください。

    重要 2019 年 2 月 19 日以降、AddLiveDomain を使用して追加されたドメイン名では、ライブセンターアップストリーミングがサポートされなくなりました。CDN API 操作を使用して追加された新しいドメイン名でも、ライブセンターアップストリーミングはサポートされません。エッジノードアップストリーミングを使用して、アップストリーミングドメイン（ビジネスタイプを liveEdge にセットして AddLiveDomain を呼び出す）とストリーミングドメイン（ビジネスタイプを liveVideo にセットして AddLiveDomain を呼び出す）を追加し、それらを関連付けてください（ AddLiveDomainMapping を呼び出す）。2019 年 2 月 19 日より前に追加されたドメイン名は影響を受けません。

    QPS 制限

    この操作の単一ユーザー QPS 制限は、毎秒 30 回の呼び出しです。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響が出る可能性があります。この操作は適切に呼び出してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    live:AddLiveDomain

    create

    *All resources.

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    LiveDomainType

    string

    必須

    ドメイン名のタイプ。有効な値:

    • liveVideo: ストリーミングドメイン。DomainName（ApsaraVideo Live に接続するドメイン名）をストリーミングドメインにセットする場合、このパラメーターを liveVideo に設定する必要があります。

    • liveEdge: エッジノードアップストリーミングドメイン。DomainName（ApsaraVideo Live に接続するドメイン名）をアップストリーミングドメインにセットする場合、このパラメーターを liveEdge に設定する必要があります。

    列挙値:

    • liveEdge :

      エッジノードアップストリーミングドメイン。

    • liveGrtnPub :

      GRTN アップストリーミングドメイン。

    • liveGrtnSub :

      GRTN ストリーミングドメイン。

    • liveVideo :

      ストリーミングドメイン。

    liveVideo。
    DomainName

    string

    必須

    ApsaraVideo Live に接続するアップストリーミングドメインまたはストリーミングドメイン。ワイルドカードドメイン名がサポートされており、ピリオド (.) で始まる必要があります。

    example.aliyundoc.com。
    Region

    string

    必須

    ライブストリーミングドメイン名のユニット情報。有効な値:

    • cn-beijing: 北京。

    • cn-shanghai: 上海。

    • cn-shenzhen: 深セン。

    • cn-qingdao: 青島。

    • ap-southeast-1: シンガポール。

    • eu-central-1: ドイツ。

    • ap-northeast-1: 東京。

    • ap-southeast-5: ジャカルタ。

    説明

    Region（ライブストリーミングドメイン名のユニット情報）と Scope（加速リージョン）は互いに制限しません。

    cn-beijing。
    CheckUrl

    string

    任意

    ヘルスチェック URL。

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

    string

    任意

    加速リージョン。このパラメーターは、国際サイトのユーザーおよび中国サイトの L3 以上のユーザーに対して効果が適用されます。有効な値:

    • domestic（デフォルト）: 中国本土。

    • overseas: 中国本土以外（香港（中国）、マカオ（中国）、台湾（中国）を含む）。

    • global: グローバル加速。

    domestic。
    TopLevelDomain

    string

    任意

    アクセス用のトップレベルドメイン名。

    learn.aliyundoc.com。
    ResourceGroupId

    string

    任意

    リソースグループの ID。リソースグループの詳細については、「リソースグループとは」をご参照ください。

    rg-aekzw******
    Tag

    array<object>

    任意

    タグのリスト。

    object

    任意

    タグのリスト。

    Key

    string

    任意

    タグキー。

    TestKey。
    Value

    string

    任意

    タグ値。

    TestValue。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidDomainName.Malformed Specified DomainName is malformed.
    400 InvalidRegion.Malformed Specified Region is malformed. 指定されたリージョンが無効です。
    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. ワイルドカードドメイン名が対応する完全一致ドメイン名と競合しています。
    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. 中国本土のリソースにアクセスするには、有効な認証済み ID を使用する必要があります。
    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. このドメイン名のルートドメインは、別のアカウントに既に追加されています。
    400 ExceedLimit The number of domains has exceeded the limit. 所有するドメイン名の数が上限を超えています。
    400 LockFail Domain has been occupied. ドメイン名は現在使用中です。後で再試行してください。
    403 AccountException Account exception. Please open ticket to make an appeal.
    403 EntityNotExist.ResourceGroup The resource group does not exist. リソースグループが存在しません。
    404 InvalidUser The user's account is invalid.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。