ドメイン名に関する基本情報を照会します。

使用上の注意

この操作を呼び出して、取り込みドメインまたはストリーミングドメインに関する基本情報を照会できます。

新しく追加したドメイン名を照会する場合は、ApsaraVideo Liveでドメイン名が設定されるまで数分待ちます。

QPSの制限

この操作は、アカウントごとに1秒あたり最大50回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 その結果、あなたのビジネスが影響を受ける可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。 詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 DescribeLiveDomainDetail

実行する操作です。 Set the value to DescribeLiveDomainDetail.

DomainName String 必須 demo.aliyundoc.com

取り込みドメインまたはストリーミングドメイン。

レスポンスパラメーター

パラメーター データ型 例 説明
ドメイン詳細 Struct

ドメイン名に関する情報。

CertName String liveCert ****

証明書の名前。

Cname String learn.developer.aliyundoc.com

ドメイン名に割り当てられているCNAME。 ドメイン名をCNAMEにマップするには、DNSサービスプロバイダーのシステムにCNAMEレコードを追加する必要があります。

注 DNSリゾルバーでCNAMEレコードをキャッシュできる期間を示すために、ドメイン名のCNAMEレコードでtime-to-live (TTL) 値を指定します。 ドメイン名のCNAMEレコードを変更すると、キャッシュの有効期限が切れると新しい設定が有効になります。これには約10分かかります。 詳細については、「CNAME解決」をご参照ください。
説明 String test

ドメイン名の説明。

DomainName String demo.aliyundoc.com

取り込みドメインまたはストリーミングドメイン。

DomainStatus String online

ドメイン名のステータス。 設定可能な値は以下のとおりです。

  • online: ドメイン名が有効です。
  • offline: ドメイン名は無効です。
  • configuring: ドメイン名を設定中です。
GmtCreated String 2018-07-27T06:51:25Z

ドメイン名が追加された時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC 表示です。

GmtModified String 2018-08-07T06:51Z

ドメイン名が最後に変更された時刻。 日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。 時刻は UTC 表示です。

LiveDomainType String liveVideo

ドメイン名のタイプ。 設定可能な値は以下のとおりです。

  • liveVideo: ストリーミングドメイン
  • liveEdge: エッジ取り込みドメイン
リージョン String cn-shanghai

ドメイン名が存在するリージョンのID。

SSLProtocol String on

SSL証明書が有効かどうかを示します。 設定可能な値は以下のとおりです。

  • on: はい
  • off: いいえ
SSLPub String 公開鍵

証明書の公開鍵。

適用範囲 String domestic

アクセラレーションリージョン。 設定可能な値は以下のとおりです。

  • 国内: 中国本土の地域
  • 海外: 中国本土以外の地域
  • global: 中国本土内外の地域
RequestId String 09ABE829-6CD3-4FE0-AFEE-556113E29727

リクエストの ID です。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=DescribeLiveDomainDetail
&DomainNam e=demo.aliyundoc.com
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<DescribeLiveDomainDetailResponse>
  <DomainDetail>
        <Description> テスト </Description>
        <スコープ> 国内 </スコープ>
        <LiveDomainType> ライブビデオ </LiveDomainType>
        <DomainNam e>demo.aliyundoc.com</DomainName>
        <SSLPub> 公開鍵 </SSLPub>
        <GmtModified>2018-08-07T06:51Z</GmtModified>
        <リージョン> cn-shanghai</Region>
        <CertName>liveCert ****</CertName>
        <GmtCreated>2018-07-27T06:51:25Z</GmtCreated>
        <Cnam e>learn.developer.aliyundoc.com</Cname>
        <DomainStatus> オンライン </DomainStatus>
        <SSLProtocol>on</SSLProtocol>
  </DomainDetail>
  <RequestId>09ABE829-6CD3-4FE0-AFEE-556113E29727</RequestId>
</DescribeLiveDomainDetailResponse>

JSON 形式 

{
    "DescribeLiveDomainDetailResponse": {
        "DomainDetail": {
            "Description": "test" 、
            "スコープ": "国内" 、
            "LiveDomainType": "liveVideo" 、
            "DomainName": "demo.aliyundoc.com" 、
            "SSLPub": "パブリックキー" 、
            "GmtModified": "2018-08-07T06:51Z" 、
            "地域": "cn-shanghai" 、
            "CertName": "liveCert ****" 、
            "GmtCreated": "2018-07-27T06:51:25Z" 、
            "Cname": "learn.developer.aliyundoc.com" 、
            "DomainStatus": "online" 、
            "SSLProtocol": "on"
        },
        "RequestId": "09ABE829-6CD3-4FE0-AFEE-556113E29727"
    }
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。