すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListLiveChannel

    ドキュメントセンター

    Object Storage Service:ListLiveChannel

    最終更新日:Jun 03, 2025

    指定された LiveChannel をリストします。

    リクエスト構文

    GET /?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

    リクエスト要素

    要素

    タイプ

    必須

    説明

    marker

    文字列

    いいえ

    リスト操作を開始する LiveChannel の名前。 名前が marker パラメーターの値よりもアルファベット順で後の LiveChannel が返されます。

    max-keys

    文字列

    いいえ

    操作で返される LiveChannel の最大数。

    有効な値: 1 ～ 1000

    デフォルト値: 100

    prefix

    文字列

    いいえ

    返される LiveChannel の名前に含まれる必要があるプレフィックス。 リクエストでプレフィックスを指定すると、指定したプレフィックスがレスポンスに含まれます。

    ListLiveChannel リクエストに含まれる Host や Date などの共通リクエストヘッダーの詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンス要素

    要素

    タイプ

    説明

    ListLiveChannelResult

    コンテナー

    ListLiveChannel リクエストの結果を格納するコンテナー。

    子ノード: Prefix、Marker、MaxKeys、IsTruncated、NextMarker、LiveChannel

    親ノード: なし

    Prefix

    文字列

    返された LiveChannel の名前に含まれるプレフィックス。

    子ノード: なし

    親ノード: ListLiveChannelResult

    Marker

    文字列

    ListLiveChannel 操作を開始する LiveChannel の名前。

    子ノード: なし

    親ノード: ListLiveChannelResult

    MaxKeys

    文字列

    レスポンスで返される LiveChannel の最大数。

    子ノード: なし

    親ノード: ListLiveChannelResult

    IsTruncated

    文字列

    すべての結果が返されたかどうかを示します。

    • true: すべての結果が返されます。

    • false: すべての結果が返されるわけではありません。

    子ノード: なし

    親ノード: ListLiveChannelResult

    NextMarker

    文字列

    すべての結果が返されない場合、NextMarker パラメーターがレスポンスに含まれ、次のリクエストの Marker 値を示します。

    子ノード: なし

    親ノード: ListLiveChannelResult

    LiveChannel

    コンテナー

    返された各 LiveChannel に関する情報を格納するコンテナー。

    子ノード: Name、Description、Status、LastModified、PublishUrls、PlayUrls

    親ノード: ListLiveChannelResult

    Name

    文字列

    LiveChannel の名前。

    子ノード: なし

    親ノード: LiveChannel

    Description

    文字列

    LiveChannel の説明。

    子ノード: なし

    親ノード: LiveChannel

    Status

    列挙型文字列

    LiveChannel のステータス。

    子ノード: なし

    親ノード: LiveChannel

    有効な値:

    • disabled: LiveChannel は無効になっています。

    • enabled: LiveChannel は有効になっています。

    LastModified

    文字列

    LiveChannel 構成が最後に変更された時刻。

    標準: ISO 8601

    子ノード: なし

    親ノード: LiveChannel

    PublishUrls

    コンテナー

    LiveChannel にストリームをアップストリーミングするために使用される URL を格納するコンテナー。

    子ノード: Url

    親ノード: LiveChannel

    Url

    文字列

    LiveChannel にストリームをアップストリーミングするために使用される URL。

    子ノード: なし

    親ノード: PublishUrls

    PlayUrls

    コンテナー

    LiveChannel にアップストリーミングされたストリームを再生するために使用される URL を格納するコンテナー。

    子ノード: Url

    親ノード: LiveChannel

    Url

    文字列

    LiveChannel にアップストリーミングされたストリームを再生するために使用される URL。

    子ノード: なし

    親ノード: PlayUrls

    ListLiveChannel リクエストへのレスポンスに含まれる ETag や x-oss-request-id などの共通レスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。

    例

    リクエストの例

    GET /?live&max-keys=1 HTTP/1.1
Date: Thu, 25 Aug 2016 07:50:09 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    レスポンスの例

    HTTP/1.1 200
content-length: 656
server: AliyunOSS
connection: close
x-oss-request-id: 57BEA331B92475920B00****
date: Thu, 25 Aug 2016 07:50:09 GMT
content-type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<ListLiveChannelResult>
  <Prefix></Prefix>
  <Marker></Marker>
  <MaxKeys>1</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextMarker>channel-0</NextMarker>
  <LiveChannel>
    <Name>channel-0</Name>
    <Description></Description>
    <Status>disabled</Status>
    <LastModified>2016-07-30T01:54:21.000Z</LastModified>
    <PublishUrls>
      <Url>rtmp://test-bucket.oss-cn-hangzhou.aliyuncs.com/live/channel-0</Url>
    </PublishUrls>
    <PlayUrls>
      <Url>http://test-bucket.oss-cn-hangzhou.aliyuncs.com/channel-0/playlist.m3u8</Url>
    </PlayUrls>
  </LiveChannel>
</ListLiveChannelResult>