すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListLiveChannel

    ドキュメントセンター

    Object Storage Service:ListLiveChannel

    最終更新日:Sep 24, 2026

    バケット内の LiveChannel を一覧表示します。プレフィックスによるフィルタリングや、marker と max-keys を使用したページネーションが可能です。

    リクエスト構文

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

    リクエスト要素

    要素

    タイプ

    必須

    説明

    marker

    String

    不要

    一覧表示を開始する LiveChannel の名前を指定します。この値以降の LiveChannel がアルファベット順で返されます。

    max-keys

    String

    不要

    返す LiveChannel の最大数を指定します。

    有効な値：1～1000

    デフォルト値：100

    prefix

    String

    不要

    返される LiveChannel 名に含めるプレフィックスを指定します。指定した場合、レスポンスにはプレフィックスが含まれます。

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

    レスポンス要素

    要素

    タイプ

    説明

    ListLiveChannelResult

    コンテナ

    ListLiveChannel のレスポンスのコンテナです。

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

    親ノード：なし

    Prefix

    String

    返される LiveChannel 名に含まれるプレフィックスです。

    子ノード：なし

    親ノード：ListLiveChannelResult

    Marker

    String

    一覧表示が開始された LiveChannel の名前です。

    子ノード：なし

    親ノード：ListLiveChannelResult

    MaxKeys

    String

    レスポンス内の LiveChannel の最大数です。

    子ノード：なし

    親ノード：ListLiveChannelResult

    IsTruncated

    String

    結果が切り捨てられたかどうかを示します。

    • true：結果は切り捨てられています。

    • false：すべての結果が返されています。

    子ノード：なし

    親ノード：ListLiveChannelResult

    NextMarker

    String

    すべての結果が返されていない場合、この値は次のリクエストの marker を示します。

    子ノード：なし

    親ノード：ListLiveChannelResult

    LiveChannel

    コンテナ

    返された各 LiveChannel のコンテナです。

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

    親ノード：ListLiveChannelResult

    Name

    String

    LiveChannel の名前です。

    子ノード：なし

    親ノード：LiveChannel

    Description

    String

    LiveChannel の説明です。

    子ノード：なし

    親ノード：LiveChannel

    Status

    列挙文字列

    LiveChannel のステータスです。

    子ノード：なし

    親ノード：LiveChannel

    有効な値：

    • disabled：LiveChannel は無効です。

    • enabled：LiveChannel は有効です。

    LastModified

    String

    LiveChannel 設定の最終更新日時です。

    フォーマット：ISO 8601。

    子ノード：なし

    親ノード：LiveChannel

    PublishUrls

    コンテナ

    LiveChannel のストリームインジェスト URL のコンテナです。

    子ノード：Url

    親ノード：LiveChannel

    Url

    String

    LiveChannel のストリームインジェスト URL です。

    子ノード：なし

    親ノード：PublishUrls

    PlayUrls

    コンテナ

    LiveChannel のストリーム再生 URL のコンテナです。

    子ノード：Url

    親ノード：LiveChannel

    Url

    String

    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>