meo-site-instances

用途

本技能用于管理 MEO（Multi-site Enterprise Operations，多站点企业运营）订阅下的站点实例。站点实例是指运行在特定环境中的具体站点，每个实例拥有自己的域名、数据库和保护模式状态。适用于需要检查站点状态、管理域名、操作数据库与备份、控制保护模式，以及安排删除或恢复站点实例的场景。

主要能力

查看站点实例详情：返回状态、域名、保护模式、数据库连接和部署信息。
列出环境中的站点实例。
保护模式管理：启用、禁用或从父环境继承保护模式。保护模式可阻止对站点实例的破坏性操作（擦除、删除）。
域名管理：列出域名、查看特定域名详情、检查域名配置状态。
数据库：获取数据库连接详情。
数据库备份：列出可用备份、查看备份详情、创建备份、恢复备份。
跨环境复制：从其他环境复制文件或数据库。
取消或删除：将站点从环境解除关联（含宽限期）、计划删除、在宽限期内恢复。
擦除站点实例：将数据库和文件重置为干净状态。

使用方式

所有命令均使用 acli api:v3:* 前缀，且需要同时提供 <siteId> 和 <environmentId> 作为独立参数。可通过 acli list api:v3:site-instances 查看当前所有命令，通过 acli api:v3:site-instances:find --help 获取帮助。

常用命令示例：

获取站点实例详情：

acli api:v3:site-instances:find <siteId> <environmentId>

列出环境中的站点实例：

acli api:v3:environments:list-site-instances <environmentId>

保护模式：

acli api:v3:site-instances:enable-protection-mode <siteId> <environmentId>
acli api:v3:site-instances:disable-protection-mode <siteId> <environmentId>
acli api:v3:site-instances:inherit-protection-mode <siteId> <environmentId>

域名：

acli api:v3:site-instances:list-domains <siteId> <environmentId>
acli api:v3:site-instances:find-domain <siteId> <environmentId> <domainName>
acli api:v3:site-instances:find-domain-status <siteId> <environmentId> <domainName>

数据库与备份：

acli api:v3:site-instances:find-database <siteId> <environmentId>
acli api:v3:site-instances:find-database-connection <siteId> <environmentId>
acli api:v3:site-instances:list-database-backups <siteId> <environmentId>
acli api:v3:site-instances:find-database-backup <siteId> <environmentId> <backupId>
acli api:v3:site-instances:create-database-backup <siteId> <environmentId>
acli api:v3:site-instances:restore-database-backup <siteId> <environmentId> <backupId>

跨环境复制：

acli api:v3:site-instances:copy-files <siteId> <environmentId> <source_environment_id>
acli api:v3:site-instances:copy-database <siteId> <environmentId> <source_environment_id>

取消、删除与恢复：

acli api:v3:site-instances:cancel <siteId> <environmentId>
acli api:v3:site-instances:schedule-delete <siteId> <environmentId>
acli api:v3:site-instances:recover <siteId> <environmentId>

擦除站点实例：

acli api:v3:site-instances:wipe <siteId> <environmentId>

典型工作流

从生产环境刷新预发布站点：

acli api:v3:site-instances:copy-database <siteId> <stagingEnvId> <prodEnvId>
acli api:v3:site-instances:copy-files <siteId> <stagingEnvId> <prodEnvId>

在风险操作前创建备份：

acli api:v3:site-instances:create-database-backup <siteId> <environmentId>
acli api:v3:site-instances:list-database-backups <siteId> <environmentId>
acli api:v3:site-instances:restore-database-backup <siteId> <environmentId> <backupId>

为维护锁定站点实例：

acli api:v3:site-instances:enable-protection-mode <siteId> <environmentId>
# ... 执行维护 ...
acli api:v3:site-instances:disable-protection-mode <siteId> <environmentId>

适用场景

需要检查特定环境中站点实例的状态与配置。
需要管理站点实例的域名及其配置状态。
需要获取数据库连接信息或执行备份与恢复。
需要从其他环境复制文件或数据库以刷新环境。
需要在维护期间锁定站点实例，防止破坏性操作。
需要安排删除站点实例并在宽限期内恢复。

限制与注意事项

本技能仅适用于 MEO 订阅。
恢复备份会覆盖当前数据库，且不可撤销，执行前需与用户确认。
复制文件或数据库会覆盖当前文件或数据库，执行前需与用户确认。
计划删除后需在宽限期内使用 recover 命令取消。
擦除站点实例为破坏性操作，需明确批准；会重置数据库和文件，所有内容与配置将丢失且不可撤销，执行前需与用户确认。
所有命令均需同时提供 <siteId> 和 <environmentId> 两个参数。

技能介绍

用途