AddLiveDomain - - Alibaba Cloud ドキュメントセンター

使用上の注意

ドメイン名を追加する前に、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回呼び出すことができます。この制限を超えるリクエストは削除され、サービスが中断されます。この操作を呼び出す際は、この制限にご注意ください。詳細については、「QPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。利便性を考慮して、この操作は OpenAPI Explorer で呼び出すことが推奨されます。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	必須	AddLiveDomain	実行する操作です。値をAddLiveDomainに設定します。
LiveDomainType	String	必須	liveVideo	ドメイン名のタイプ。有効な値： liveVideo: ストリーミングドメイン。この値は、DomainNameパラメーターをストリーミングドメインに設定する場合に必要です。 liveEdge: 取り込みドメイン。この値は、DomainNameパラメーターを取り込みドメインに設定する場合に必要です。
DomainName	String	必須	example.aliyundoc.com	ApsaraVideo Liveに追加する取り込みドメインまたはストリーミングドメイン。ピリオド (.) で始まるワイルドカードドメイン名がサポートされています。
リージョン	String	必須	cn-beijing	ドメイン名が存在するリージョン。有効な値： cn-beijing: 中国 (北京) cn-shanghai: 中国 (上海) cn-shenzhen: 中国 (深セン) cn-qingdao: 中国 (チンタオ) ap-southeast-1シンガポール eu-central-1ドイツ (フランクフルト) ap-northeast-1日本 (東京) ap-southeast-5インドネシア (ジャカルタ) 説明 RegionパラメーターとScopeパラメーターの設定が競合しないようにしてください。
CheckUrl	String	任意	http://demo.aliyundoc.com/status.html	ドメイン名のヘルスステータスを確認するために使用されるURL。
スコープ	String	任意	domestic	アクセラレーションリージョン。このパラメーターは、中国本土のレベル3以上のユーザーおよび中国本土以外のすべてのユーザーに適用できます。有効な値：国内 (デフォルト): 中国本土海外: 中国本土外グローバル: 中国本土内外
TopLevelDomain	String	任意	learn.aliyundoc.com	トップレベルドメイン名。

レスポンスパラメーター

パラメーター	タイプ	例	説明
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	リクエスト ID。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=AddLiveDomain
&DomainNam e=example.aliyundoc.com
&LiveDomainType=liveVideo
&リージョン=cn-beijing
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<AddLiveDomainResponse>
<RequestId>15C66C7B-671A-4297-9187-2C4477247A74</RequestId>
</AddLiveDomainResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "AddLiveDomainResponse" : {
    "RequestId" : "15C66C7B-671A-4297-9187-2C4477247A74"
  }
}

エラーコード

HTTPステータスコード	エラーコード	エラーメッセージ	説明
400	NotInternationRealIdentity	中国本土のリソースを使用する場合は、実名認証を行う必要があります。	中国本土からのリソースへのアクセス権限を取得する必要があります。
400	ドメイン予約済み	ドメインのルートドメインは別のアカウントで予約されています。	ルートドメインが他のアカウントに追加されます。

エラーコードの一覧については、「サービスエラーコード」をご参照ください。