alicloud-network-cdn

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Category: service

Alibaba Cloud CDN

阿里云CDN

Purpose

用途

Use Alibaba Cloud CDN OpenAPI (RPC) for common operations and integrations including:

accelerated domain lifecycle (create/configure/start-stop/delete)
cache refresh and preload (directory/file/domain)
HTTPS certificate configuration and updates
log and monitoring queries (real-time/offline)

使用阿里云CDN OpenAPI（RPC）完成常见操作和集成，包括：

加速域名生命周期（创建/配置/启停/删除）
缓存刷新和预热（目录/文件/域名）
HTTPS证书配置和更新
日志与监控查询（实时/离线）

Prerequisites

前置要求

least-privilege RAM credentials are ready (STS temporary creds recommended).
domain ownership and acceleration scope policy are confirmed (mainland/global).
before mutating operations, validate current state using read-only APIs.

已准备好最小权限的RAM凭证（推荐使用STS临时凭证）。
已确认域名所有权和加速范围策略（中国大陆/全球）。
执行变更操作前，使用只读API验证当前状态。

Workflow

工作流程

Define target resources: accelerated domains, business type, change window, and rollback criteria.
Run API discovery and confirm target API names, required parameters, and version.
Query current config/state with read-only APIs (
```
Describe*
```
) first.
Execute mutating APIs (
```
Add*
```
/
```
Set*
```
/
```
BatchSet*
```
/
```
Delete*
```
) and record request context.
Validate changes with monitoring/log APIs and save evidence in
```
output/alicloud-network-cdn/
```
.

定义目标资源：加速域名、业务类型、变更窗口和回滚标准。
执行API发现，确认目标API名称、必填参数和版本。
首先使用只读API（
```
Describe*
```
）查询当前配置/状态。
执行变更API（
```
Add*
```
/
```
Set*
```
/
```
BatchSet*
```
/
```
Delete*
```
）并记录请求上下文。
使用监控/日志API验证变更，并将凭证保存到
```
output/alicloud-network-cdn/
```
。

AccessKey Priority

AccessKey优先级

Environment variables:

ALICLOUD_ACCESS_KEY_ID

ALICLOUD_ACCESS_KEY_SECRET

ALICLOUD_REGION_ID

Shared credentials file:
```
~/.alibabacloud/credentials
```

If region/environment is unclear, confirm with user before mutating operations.

环境变量：

ALICLOUD_ACCESS_KEY_ID

ALICLOUD_ACCESS_KEY_SECRET

ALICLOUD_REGION_ID

共享凭证文件：
```
~/.alibabacloud/credentials
```

如果区域/环境不明确，在执行变更操作前请与用户确认。

API Discovery

API发现

Product code:
```
cdn
```
Default API version:
```
2018-05-10
```

Metadata source:

https://api.aliyun.com/meta/v1/products/cdn/versions/2018-05-10/api-docs.json

产品代码：
```
cdn
```
默认API版本：
```
2018-05-10
```

元数据来源：

https://api.aliyun.com/meta/v1/products/cdn/versions/2018-05-10/api-docs.json

Minimal Executable Quickstart

最小可执行快速入门

bash

python skills/network/cdn/alicloud-network-cdn/scripts/list_openapi_meta_apis.py

Optional arguments:

bash

python skills/network/cdn/alicloud-network-cdn/scripts/list_openapi_meta_apis.py \
  --product-code cdn \
  --version 2018-05-10 \
  --output-dir output/alicloud-network-cdn

bash

python skills/network/cdn/alicloud-network-cdn/scripts/list_openapi_meta_apis.py

可选参数：

bash

python skills/network/cdn/alicloud-network-cdn/scripts/list_openapi_meta_apis.py \
  --product-code cdn \
  --version 2018-05-10 \
  --output-dir output/alicloud-network-cdn

Common Operation Map

常见操作映射

Domain management:

AddCdnDomain

、

DescribeUserDomains

、

DescribeCdnDomainDetail

、

DeleteCdnDomain

Cache refresh/preload:
```
RefreshObjectCaches
```
（refresh）、
```
PushObjectCache
```
（preload）

HTTPS certificate:

SetDomainServerCertificate

DescribeDomainCertificateInfo

Logs and monitoring:

DescribeCdnDomainLogs

、

DescribeDomainRealTimeRequestStatData

、

DescribeDomainRealTimeBpsData

域名管理：

AddCdnDomain

、

DescribeUserDomains

、

DescribeCdnDomainDetail

、

DeleteCdnDomain

缓存刷新/预热：
```
RefreshObjectCaches
```
（刷新）、
```
PushObjectCache
```
（预热）

HTTPS证书：

SetDomainServerCertificate

DescribeDomainCertificateInfo

日志与监控：

DescribeCdnDomainLogs

、

DescribeDomainRealTimeRequestStatData

、

DescribeDomainRealTimeBpsData

Output Policy

输出策略

Write generated files and execution evidence to:

output/alicloud-network-cdn/

将生成的文件和执行凭证写入：

output/alicloud-network-cdn/

Validation

验证

bash

mkdir -p output/alicloud-network-cdn
for f in skills/network/cdn/alicloud-network-cdn/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-network-cdn/validate.txt

Pass criteria: command exits 0 and

output/alicloud-network-cdn/validate.txt

is generated.

bash

mkdir -p output/alicloud-network-cdn
for f in skills/network/cdn/alicloud-network-cdn/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-network-cdn/validate.txt

通过标准：命令退出码为0，且成功生成

output/alicloud-network-cdn/validate.txt

文件。

Output And Evidence

输出与凭证

Save artifacts, command outputs, and API response summaries under
```
output/alicloud-network-cdn/
```
.
Include key parameters (region/resource id/time range) in evidence files for reproducibility.

将产物、命令输出和API响应摘要保存到
```
output/alicloud-network-cdn/
```
目录下。
在凭证文件中包含关键参数（区域/资源ID/时间范围）以保证可复现性。

Prerequisites

前置要求

Configure least-privilege Alibaba Cloud credentials before execution.

Prefer environment variables:

ALICLOUD_ACCESS_KEY_ID

ALICLOUD_ACCESS_KEY_SECRET

, optional

ALICLOUD_REGION_ID

If region is unclear, ask the user before running mutating operations.

执行前配置最小权限的阿里云凭证。

优先使用环境变量：

ALICLOUD_ACCESS_KEY_ID

、

ALICLOUD_ACCESS_KEY_SECRET

，可选

ALICLOUD_REGION_ID

。

如果区域不明确，在运行变更操作前询问用户。

References

参考

Source list:
```
references/sources.md
```

来源列表：
```
references/sources.md
```