DescribeLiveUserDomains - 查询用户名下所有的直播域名

查询用户名下所有的直播域名。

接口说明

本接口目前支持的直播域名业务类型为播流域名和边缘推流域名。

QPS 限制

本接口的单用户 QPS 限制为 100 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
live:DescribeLiveUserDomainsget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
LiveDomainTypestring

直播域名业务类型。取值:

  • liveVideo:播流域名。
  • liveEdge:边缘推流域名。
说明 如果不设置此参数,则请求参数 DomainName 默认查询用户所有直播推流和播流域名。
liveVideo
PageSizeinteger

分页大小。默认值为 20,最大值为 50

20
PageNumberinteger

当前页码。取值范围:1~100000

1
DomainNamestring

域名模糊匹配过滤。

说明
  • 如果 LiveDomainType(直播域名业务类型)取值为 liveVideo,此参数不传值时,默认查询用户播流域名的相关信息。- 如果 LiveDomainType(直播域名业务类型)取值为 liveEdge,此参数不传值时,默认查询用户推流域名的相关信息。
  • *.aliyundoc.com
    RegionNamestring

    域名所属地域。

    cn-beijing
    DomainSearchTypestring

    域名查询类型。取值:

    • fuzzy_match(默认值):模糊匹配。
    • pre_match:前匹配。
    • suf_match:后匹配。
    • full_match:完全匹配。
    fuzzy_match
    DomainStatusstring

    域名状态。取值:

    • online:运行中(表示域名服务状态正常)。
    • offline:已停止。
    • configuring:配置中。
    online
    Tagarray<object>

    标签列表。

    object

    标签列表。

    Keystring

    标签健。

    TestKey
    Valuestring

    标签值。

    TestValue
    ResourceGroupIdstring

    资源组 ID。

    rg-**kzvyjetyjjm**

    返回参数

    名称类型描述示例值
    object
    Domainsarray<object>

    域名列表。

    PageDataobject

    返回直播域名的状态信息。

    Cnamestring

    直播域名对应的 CNAME 域名。

    learn.developer.aliyundoc.com
    Descriptionstring

    描述信息

    test
    DomainNamestring

    域名名称。

    demo.aliyundoc.com
    GmtCreatedstring

    直播域名创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

    2017-08-29T12:15:36Z
    GmtModifiedstring

    直播域名修改时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

    2017-12-29T12:15:36Z
    LiveDomainStatusstring

    域名状态。取值:

    • online:运行中(表示域名服务状态正常)。
    • offline:已停止。
    • configuring:配置中。
    online
    LiveDomainTypestring

    直播域名业务类型。取值:

    • liveVideo:播流域名。
    • liveEdge:边缘推流域名。
    liveVideo
    RegionNamestring

    域名所属地域。

    cn-beijing
    ResourceGroupIdstring

    资源组 ID。

    rg-**kzvyjetyjjm**
    PageNumberlong

    返回数据的当前页码。

    1
    PageSizelong

    分页大小。

    100
    RequestIdstring

    请求 ID。

    E4EBD2BF-5EB0-4476-8829-9D94E1B15267
    TotalCountlong

    总条数。

    1

    示例

    正常返回示例

    JSON格式

    {
      "Domains": {
        "PageData": [
          {
            "Cname": "learn.developer.aliyundoc.com",
            "Description": "test",
            "DomainName": "demo.aliyundoc.com",
            "GmtCreated": "2017-08-29T12:15:36Z",
            "GmtModified": "2017-12-29T12:15:36Z",
            "LiveDomainStatus": "online",
            "LiveDomainType": "liveVideo",
            "RegionName": "cn-beijing",
            "ResourceGroupId": "rg-**kzvyjetyjjm**"
          }
        ]
      },
      "PageNumber": 1,
      "PageSize": 100,
      "RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B15267",
      "TotalCount": 1
    }

    错误码

    HTTP status code错误码错误信息描述
    400InvalidPageNumber.ValueNotSupportedThe specified value of parameter PageNumber is not supported.指定的PageNumber参数的值不支持。
    400InvalidPageSize.ValueNotSupportedThe specified value of parameter PageSize is not supported.-
    400InvalidDomainStatus.ValueNotSupportedThe specified value of parameter DomainStatus is not supported.-
    400InvalidDomainName.MalformedThe specific value of parameter DomainName is malformed.-
    400InvalidDomainSearchType.ValueNotSupportedThe specified value of parameter DomainSearchType is not supported.-
    400InvalidDomainSearchType.Malformedhe specified value of parameter DomainSearchType is invalid.-
    400InvalidLiveDomainType.ValueNotSupportedThe specified value of parameter LiveDomainType is not supported.-

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2024-09-27OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
    2024-09-25OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情