alicloud-network-esa

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Category: service

分类：服务

Edge Security Acceleration (ESA)

边缘安全加速（ESA）

Validation

验证

bash

mkdir -p output/alicloud-network-esa
python -m py_compile skills/network/esa/alicloud-network-esa/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-network-esa/validate.txt

Pass criteria: command exits 0 and

output/alicloud-network-esa/validate.txt

is generated.

bash

mkdir -p output/alicloud-network-esa
python -m py_compile skills/network/esa/alicloud-network-esa/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-network-esa/validate.txt

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

output/alicloud-network-esa/validate.txt

文件。

Output And Evidence

输出与证据

Save API inventory and operation evidence under
```
output/alicloud-network-esa/
```
.
Keep command parameters and region scope in evidence files.

Use Alibaba Cloud OpenAPI (RPC) with official SDKs or OpenAPI Explorer to manage ESA resources. Prefer metadata-first API discovery before executing mutate operations.

将API清单和操作证据保存到
```
output/alicloud-network-esa/
```
目录下。
在证据文件中保留命令参数和地域范围。

使用阿里云OpenAPI（RPC）及官方SDK或OpenAPI Explorer管理ESA资源。在执行变更操作前，优先通过元数据发现API。

Prerequisites

前置条件

Prepare least-privilege RAM AccessKey/STS credentials.
Confirm target region and site scope before change operations.
Use read-only
```
List*
```
/
```
Describe*
```
APIs first, then execute create/update/delete APIs.

准备最小权限的RAM AccessKey/STS凭证。
在执行变更操作前，确认目标地域和站点范围。
先执行只读的
```
List*
```
/
```
Describe*
```
APIs，再执行创建/更新/删除类API。

Workflow

工作流程

Confirm target site/domain/resource identifiers and desired operation.
Discover API names and required parameters via metadata and API Explorer.
Execute read-only validation (
```
Describe*
```
/
```
List*
```
).
Execute mutate operations (
```
Create*
```
/
```
Update*
```
/
```
Delete*
```
) with rollback plan.
Save outputs and request context under
```
output/alicloud-network-esa/
```
.

确认目标站点/域名/资源标识符及所需执行的操作。
通过元数据和API Explorer发现API名称及必填参数。
执行只读验证操作（
```
Describe*
```
/
```
List*
```
）。
执行变更操作（
```
Create*
```
/
```
Update*
```
/
```
Delete*
```
），并制定回滚方案。
将输出结果和请求上下文保存到
```
output/alicloud-network-esa/
```
目录下。

AccessKey Priority

AccessKey优先级

Environment variables:

ALICLOUD_ACCESS_KEY_ID

ALICLOUD_ACCESS_KEY_SECRET

ALICLOUD_REGION_ID

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

If region is ambiguous, ask user before executing write operations.

环境变量：

ALICLOUD_ACCESS_KEY_ID

ALICLOUD_ACCESS_KEY_SECRET

ALICLOUD_REGION_ID

。

共享配置文件：
```
~/.alibabacloud/credentials
```
。

若地域信息不明确，在执行写入操作前需询问用户。

API Discovery

API发现

Product code:
```
ESA
```
Default API version:
```
2024-09-10
```

Metadata source:

https://api.aliyun.com/meta/v1/products/ESA/versions/2024-09-10/api-docs.json

产品代码：
```
ESA
```
默认API版本：
```
2024-09-10
```

元数据来源：

https://api.aliyun.com/meta/v1/products/ESA/versions/2024-09-10/api-docs.json

Minimal Executable Quickstart

最小可执行快速入门

bash

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

Optional overrides:

bash

python skills/network/esa/alicloud-network-esa/scripts/list_openapi_meta_apis.py \
  --product-code ESA \
  --version 2024-09-10 \
  --output-dir output/alicloud-network-esa

bash

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

可选覆盖参数：

bash

python skills/network/esa/alicloud-network-esa/scripts/list_openapi_meta_apis.py \
  --product-code ESA \
  --version 2024-09-10 \
  --output-dir output/alicloud-network-esa

Common Operation Mapping

常见操作映射

Site lifecycle:

CreateSite

DeleteSite

DescribeSites

GetSite

DNS/record:

CreateRecord

UpdateRecord

DeleteRecord

DescribeRecords

Origin and routing:

CreateOriginPool

CreateOriginRule

CreateRedirectRule

CreateRewriteUrlRule

Cache/compression:
```
CreateCacheRule
```
,
```
CreateCompressionRule
```

Security:

CreateWafRule

CreateWafRuleset

BatchCreateWafRules

Delivery/logging:

CreateSiteDeliveryTask

DescribeSiteDeliveryTasks

站点生命周期：

CreateSite

DeleteSite

DescribeSites

GetSite

DNS/记录：

CreateRecord

UpdateRecord

DeleteRecord

DescribeRecords

源站与路由：

CreateOriginPool

CreateOriginRule

CreateRedirectRule

CreateRewriteUrlRule

缓存/压缩：
```
CreateCacheRule
```
,
```
CreateCompressionRule
```

安全：

CreateWafRule

CreateWafRuleset

BatchCreateWafRules

交付/日志：

CreateSiteDeliveryTask

DescribeSiteDeliveryTasks

Output Policy

输出策略

Write all generated files and execution evidence under:

output/alicloud-network-esa/

将所有生成的文件和执行证据写入以下目录：

output/alicloud-network-esa/

References

参考资料

Source list:
```
references/sources.md
```
API quick map:
```
references/api_quick_map.md
```

源列表：
```
references/sources.md
```
API快速映射：
```
references/api_quick_map.md
```