Category: service
Intelligent Cloud Editing (ICE)
Validation
CODEBLOCK0
Pass criteria: command exits 0 and output/aliyun-ice-manage/validate.txt is generated.
Output And Evidence
- - Save API inventory and operation evidence under
output/aliyun-ice-manage/. - Keep region, workflow IDs, job IDs, and request parameters in evidence files.
Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage ICE resources.
Prefer metadata-first API discovery before mutate operations.
Prerequisites
- - Prepare least-privilege RAM AccessKey/STS credentials.
- Confirm target region, input/output OSS locations, and workflow scope before changes.
- Query current state with read-only APIs before invoking processing jobs.
Workflow
1) Confirm target workflow/template and media input/output locations.
2) Discover API names and required parameters via metadata and API Explorer.
3) Validate prerequisite resources using read-only APIs.
4) Submit and monitor processing jobs.
5) Save outputs and evidence under output/aliyun-ice-manage/.
AccessKey Priority
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.
API Discovery
- - Product code: INLINECODE7
- Default API version: INLINECODE8
- Metadata source: INLINECODE9
Minimal Executable Quickstart
CODEBLOCK1
Optional overrides:
CODEBLOCK2
Common Operation Mapping
- - Media info and metadata:
GetMediaInfo, SearchMedia, INLINECODE12 - Workflow/template:
CreateMediaWorkflow, UpdateMediaWorkflow, INLINECODE15 - Job submission:
SubmitMediaProducingJob, SubmitBatchMediaProducingJob, INLINECODE18 - Editing/material:
CreateSourceLocation, AddMedia, INLINECODE21 - Task status/troubleshooting:
GetTaskInfo, ListJobs, INLINECODE24
Output Policy
Write all generated files and execution evidence under:
INLINECODE25
References
- - Source list: INLINECODE26
- Task templates: INLINECODE27
技能名称: aliyun-ice-manage
详细描述:
类别: 服务
智能云剪辑 (ICE)
验证
bash
mkdir -p output/aliyun-ice-manage
python -m pycompile skills/media/ice/aliyun-ice-manage/scripts/listopenapimetaapis.py
echo pycompileok > output/aliyun-ice-manage/validate.txt
通过标准: 命令退出码为0且生成了 output/aliyun-ice-manage/validate.txt。
输出与证据
- - 将API清单和操作证据保存在 output/aliyun-ice-manage/ 目录下。
- 在证据文件中保留区域、工作流ID、任务ID和请求参数。
使用阿里云OpenAPI（RPC）配合官方SDK或OpenAPI Explorer来管理ICE资源。
在执行变更操作前，优先通过元数据发现API。
前置条件
- - 准备最小权限的RAM AccessKey/STS凭证。
- 在变更前确认目标区域、输入/输出OSS位置和工作流范围。
- 在调用处理任务前，使用只读API查询当前状态。
工作流程
1) 确认目标工作流/模板以及媒体输入/输出位置。
2) 通过元数据和API Explorer发现API名称和所需参数。
3) 使用只读API验证前置资源。
4) 提交并监控处理任务。
5) 将输出和证据保存在 output/aliyun-ice-manage/ 目录下。
AccessKey优先级
1) 环境变量: ALICLOUDACCESSKEYID / ALICLOUDACCESSKEYSECRET / ALICLOUDREGIONID。
2) 共享配置文件: ~/.alibabacloud/credentials。
如果区域不明确，在执行写操作前请先询问。
API发现
- - 产品代码: ice
- 默认API版本: 2020-11-09
- 元数据来源: https://api.aliyun.com/meta/v1/products/ice/versions/2020-11-09/api-docs.json
最小可执行快速入门
bash
python skills/media/ice/aliyun-ice-manage/scripts/listopenapimeta_apis.py
可选覆盖参数:
bash
python skills/media/ice/aliyun-ice-manage/scripts/listopenapimeta_apis.py \
--product-code ice \
--version 2020-11-09 \
--output-dir output/aliyun-ice-manage
常见操作映射
- - 媒体信息和元数据: GetMediaInfo, SearchMedia, UpdateMediaMeta
- 工作流/模板: CreateMediaWorkflow, UpdateMediaWorkflow, ListMediaWorkflowExecutions
- 任务提交: SubmitMediaProducingJob, SubmitBatchMediaProducingJob, GetMediaProducingJob
- 剪辑/素材: CreateSourceLocation, AddMedia, GetDefaultMaterial
- 任务状态/故障排查: GetTaskInfo, ListJobs, GetBatchMediaProducingJob
输出策略
将所有生成的文件和执行证据写入:
output/aliyun-ice-manage/
参考资料
- - 来源列表: references/sources.md
- 任务模板: references/templates.md
