すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:AddLiveDomain

    ドキュメントセンター

    ApsaraVideo Live:AddLiveDomain

    最終更新日:Jan 27, 2026

    ApsaraVideo Live にドメイン名を追加します。この操作では、一度に 1 つのドメイン名のみ追加できます。

    操作説明

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

    • ApsaraVideo Live は、追加する新しいドメイン名の所有権を検証します。検証に合格すると、ドメイン名は ApsaraVideo Live に追加されます。ApsaraVideo Live では、DNS レコードまたは検証ファイルを使用してドメイン名の所有権を検証できます。詳細については、「ドメイン名の所有権の検証」をご参照ください。

    • ApsaraVideo Live を使用してストリームのアップストリーミングと再生を行うには、アップストリーミングドメインとストリーミングドメインを追加する必要があります。一度に追加できるドメイン名は 1 つだけです。

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

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

    説明

    2019 年 2 月 19 日以降、AddLiveDomain 操作を呼び出して追加されたドメイン名は、ライブセンターアップストリーミングをサポートしません。Alibaba Cloud CDN を使用して追加されたドメイン名も、ライブセンターアップストリーミングをサポートしません。AddLiveDomain 操作を呼び出す際、`LiveDomainType` パラメーターを `liveEdge` に設定してエッジノードアップストリーミングを使用するアップストリーミングドメインを追加するか、`LiveDomainType` パラメーターを `liveVideo` に設定してストリーミングドメインを追加することができます。ストリーミングドメインとアップストリーミングドメインの関連付けは、AddLiveDomainMapping 操作を呼び出すことで行えます。2019 年 2 月 19 日より前に追加され、ライブセンターアップストリーミングが設定されていたドメイン名は影響を受けません。

    QPS 制限

    この操作は、アカウントごとに 1 秒あたり最大 30 回呼び出すことができます。この制限を超えたリクエストは破棄され、サービス中断が発生します。この操作を呼び出す際は、この制限に注意することを推奨します。

    今すぐお試しください

    この 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 Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    LiveDomainType

    string

    必須

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

    • liveVideo：ストリーミングドメイン。`DomainName` パラメーターをストリーミングドメインに設定する場合に必要です。

    • liveEdge：アップストリーミングドメイン。`DomainName` パラメーターをアップストリーミングドメインに設定する場合に必要です。

    liveVideo
    DomainName

    string

    必須

    追加するアップストリーミングドメインまたはストリーミングドメイン。ピリオド (.) で始まるワイルドカードドメイン名をサポートしています。

    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

    任意

    エッジグループ。このパラメーターは、中国本土のレベル 3 以上のユーザーおよび中国本土以外のユーザーに適用されます。有効な値：

    • 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.
    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.

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

    変更履歴

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