Back to Details

alicloud-media-live

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Category: service
分类：service

ApsaraVideo Live

ApsaraVideo Live

Validation

验证

bash
mkdir -p output/alicloud-media-live
python -m py_compile skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-media-live/validate.txt
Pass criteria: command exits 0 and 
output/alicloud-media-live/validate.txt
is generated.
bash
mkdir -p output/alicloud-media-live
python -m py_compile skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-media-live/validate.txt
通过标准：命令退出码为0，且成功生成
output/alicloud-media-live/validate.txt
文件。

Output And Evidence

输出与凭证

  • Save API inventory and operation evidence under 
    output/alicloud-media-live/
    .
  • Keep region, domain, app/stream, and request parameters in evidence files.
Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage Live resources. Prefer metadata-first API discovery before mutate operations.
  • 将API清单和操作凭证保存到
    output/alicloud-media-live/
    目录下。
  • 凭证文件中需保留地域、域名、应用/流以及请求参数信息。
使用阿里云OpenAPI（RPC）搭配官方SDK或OpenAPI Explorer来管理直播资源。 执行变更操作前优先采用元数据优先的API发现机制。

Prerequisites

前置要求

  • Prepare least-privilege RAM AccessKey/STS credentials.
  • Confirm target region and live domain scope before changes.
  • Query current state with read-only APIs (
    Describe*
    / 
    List*
    ) before 
    Add*
    / 
    Set*
    / 
    Delete*
    .
  • 准备最小权限的RAM AccessKey/STS凭证。
  • 变更前确认目标地域和直播域名范围。
  • 执行
    Add*
    /
    Set*
    /
    Delete*
    等操作前，先通过只读API（
    Describe*
    /
    List*
    ）查询当前状态。

Workflow

工作流

  1. Confirm target live domain, app name/stream name, and desired operation.
  2. Discover API names and required parameters via metadata and API Explorer.
  3. Execute read-only validation calls.
  4. Apply change operations with rollback plan.
  5. Save results and context under 
    output/alicloud-media-live/
    .
  1. 确认目标直播域名、应用名称/流名称以及所需执行的操作。
  2. 通过元数据和API Explorer查询API名称和所需参数。
  3. 执行只读验证调用。
  4. 执行变更操作并准备回滚方案。
  5. 将结果和上下文信息保存到
    output/alicloud-media-live/
    目录下。

AccessKey Priority

AccessKey优先级

  1. Environment variables: 
    ALICLOUD_ACCESS_KEY_ID
    / 
    ALICLOUD_ACCESS_KEY_SECRET
    / 
    ALICLOUD_REGION_ID
    .
  2. Shared config file: 
    ~/.alibabacloud/credentials
    .
If region is ambiguous, ask before write operations.
  1. 环境变量：
    ALICLOUD_ACCESS_KEY_ID
    / 
    ALICLOUD_ACCESS_KEY_SECRET
    / 
    ALICLOUD_REGION_ID
    。
  2. 共享配置文件：
    ~/.alibabacloud/credentials
    。
如果地域信息不明确，执行写入操作前需询问确认。

API Discovery

API发现

  • Product code: 
    live
  • Default API version: 
    2016-11-01
  • Metadata source: 
    https://api.aliyun.com/meta/v1/products/live/versions/2016-11-01/api-docs.json
  • 产品代码：
    live
  • 默认API版本：
    2016-11-01
  • 元数据来源：
    https://api.aliyun.com/meta/v1/products/live/versions/2016-11-01/api-docs.json

Minimal Executable Quickstart

最小可执行快速开始

bash
python skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py
Optional overrides:
bash
python skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py \
  --product-code live \
  --version 2016-11-01 \
  --output-dir output/alicloud-media-live
bash
python skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py
可选覆盖参数：
bash
python skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py \
  --product-code live \
  --version 2016-11-01 \
  --output-dir output/alicloud-media-live

Common Operation Mapping

常用操作映射

  • Domain management: 
    AddLiveDomain
    , 
    DeleteLiveDomain
    , 
    DescribeLiveDomains
  • Stream ingest/play auth: 
    AddLiveDomainMapping
    , 
    SetLiveDomainStagingConfig
  • Record/transcode/template: 
    AddLiveRecordTemplate
    , 
    AddLiveTranscodeTemplate
    , 
    DescribeLiveRecordConfig
  • Monitor and metrics: 
    DescribeLiveStreamOnlineList
    , 
    DescribeLiveDomainBpsData
    , 
    DescribeLiveDomainTrafficData
  • Stream control: 
    ForbidLiveStream
    , 
    ResumeLiveStream
    , 
    AddLiveAppRecordConfig
  • 域名管理：
    AddLiveDomain
    , 
    DeleteLiveDomain
    , 
    DescribeLiveDomains
  • 流推流/播放鉴权：
    AddLiveDomainMapping
    , 
    SetLiveDomainStagingConfig
  • 录制/转码/模板：
    AddLiveRecordTemplate
    , 
    AddLiveTranscodeTemplate
    , 
    DescribeLiveRecordConfig
  • 监控与指标：
    DescribeLiveStreamOnlineList
    , 
    DescribeLiveDomainBpsData
    , 
    DescribeLiveDomainTrafficData
  • 流控制：
    ForbidLiveStream
    , 
    ResumeLiveStream
    , 
    AddLiveAppRecordConfig

Output Policy

输出规则

Write all generated files and execution evidence under: 
output/alicloud-media-live/
所有生成的文件和执行凭证都写入以下目录： 
output/alicloud-media-live/

References

参考

  • Source list: 
    references/sources.md
  • 来源列表：
    references/sources.md