compshare-cli 0.1.0__tar.gz

compshare_cli-0.1.0/PKG-INFO

@@ -0,0 +1,283 @@
+Metadata-Version: 2.4
+Name: compshare-cli
+Version: 0.1.0
+Summary: Command-line client for CompShare GPU compute
+Author: CompShare
+License: Apache-2.0
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: rich<15,>=13
+Requires-Dist: typer<1,>=0.12
+Requires-Dist: ucloud-sdk-python3<0.12,>=0.11.103
+Requires-Dist: urllib3<2,>=1.26.18; python_version < "3.10" and platform_system == "Darwin"
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: pytest-cov<8,>=5; extra == "dev"
+Requires-Dist: ruff<1,>=0.6; extra == "dev"
+
+# CompShare CLI
+
+在终端中管理优云智算 GPU 实例、实例镜像、云盘与 US3 挂载。
+
+第一阶段覆盖 `compshare-docs` 中三个公开 API 目录的 51 个 Action：
+
+- GPU 实例：27 个 Action
+- 实例镜像：17 个 Action
+- 磁盘与云存储：7 个 Action
+
+CLI 使用官方 [`ucloud-sdk-python3`](https://github.com/ucloud/ucloud-sdk-python3) 完成鉴权、参数编码、请求传输与重试。调用层使用 SDK 的通用 `invoke` 接口，因为 CompShare 的公开 API 更新可能早于 SDK 的生成式请求模型；这样不会静默丢弃新参数。
+
+## 安装
+
+要求 Python 3.9 或更高版本。
+
+```bash
+python -m pip install .
+compshare --help
+```
+
+开发环境：
+
+```bash
+python -m venv .venv
+.venv/bin/python -m pip install --upgrade pip
+.venv/bin/python -m pip install -e '.[dev]'
+.venv/bin/pytest
+```
+
+## 配置
+
+交互式保存 API 密钥：
+
+```bash
+compshare config --name production
+```
+
+每个凭证 profile 只保存名称、公钥和私钥，不绑定地域、可用区或项目。配置默认保存到 `~/.config/compshare/config.json`，目录权限为 `0700`，文件权限为 `0600`。支持多个凭证 profile：
+
+```bash
+compshare --profile production instance list
+compshare config list
+compshare config use production
+compshare config delete staging
+compshare config path
+```
+
+也可以完全通过环境变量运行：
+
+```bash
+export COMPSHARE_PUBLIC_KEY='...'
+export COMPSHARE_PRIVATE_KEY='...'
+export COMPSHARE_REGION='cn-wlcb'
+export COMPSHARE_ZONE='cn-wlcb-01'
+```
+
+其中公私钥属于凭证；Region 和 Zone 只是请求位置。支持的环境变量还有 `COMPSHARE_PROFILE` 和 `COMPSHARE_CONFIG_FILE`。
+
+## 全局参数
+
+```text
+--profile       选择凭证 profile
+--json          输出适合脚本处理的 JSON
+```
+
+地域和可用区是资源参数，不是全局选项。它们会出现在真正需要位置的子命令后面：
+
+```bash
+compshare instance list --region cn-sh2
+compshare instance create --zone cn-sh2-02
+```
+
+实例和已挂载云盘的生命周期命令会根据资源 ID 自动查找 Region 和 Zone。列表命令未指定 `--region` 时会聚合所有支持地域。
+
+`ProjectId` 不是账户凭证的一部分。定时关机会通过 `GetProjectList` 自动选择默认项目；只有需要覆盖自动选择结果时才传 `--project-id`。
+
+`--json` 和 `--profile` 是全局选项，必须放在子命令前：
+
+```bash
+compshare --json instance list
+compshare --profile production instance list
+```
+
+成功时 JSON 模式直接输出 API 响应；失败时输出 `{"ok":false,"error":"..."}` 并返回非零退出码。实例密码和 FileBrowser 密码保留 API 原值，API 私钥仍会脱敏。
+
+CLI 默认显示中文帮助描述。使用一级命令持久切换语言，配置会写入本地配置文件，但不属于任何凭证 profile：
+
+```bash
+compshare --help
+compshare lang en
+compshare instance create --help
+compshare lang zh
+compshare lang       # 查看当前语言
+```
+
+也可以通过 `COMPSHARE_LANG=en` 覆盖当前终端会话的帮助语言。当前版本不安装 Shell completion，仅提供 `-h/--help`。
+
+## 实例
+
+### 查规格和库存
+
+不带镜像时，`search` 展示合法的 GPU、CPU 和内存组合：
+
+```bash
+compshare instance search
+compshare instance search --gpu 4090 --gpu A100
+```
+
+库存不是机型的固定属性。它还取决于镜像、磁盘、计费方式和 CPU 平台，因此检查真实库存时需要指定镜像：
+
+```bash
+compshare instance search \
+  --gpu 4090 \
+  --image compshareImage-xxxx \
+  --disk 100GiB \
+  --disk-type CLOUD_SSD \
+  --charge Postpay \
+  --available
+```
+
+该命令先调用 `DescribeAvailableCompShareInstanceTypes` 获取合法规格，再按匹配的 GPU 型号调用 `CheckCompShareResourceCapacity`。`--available` 不会用 Describe 接口的状态冒充库存。
+
+### 创建
+
+直接运行不带规格参数的命令会进入交互向导：
+
+```bash
+compshare instance create
+```
+
+向导会依次读取可用区、GPU 机型和镜像；选择计费方式与磁盘后，调用真实库存接口，只展示当前可创建的 GPU、CPU、内存组合。最后查询完整价格并要求确认。镜像来源支持 `platform`、`custom`、`community` 和 `shared`。
+
+也可以预先指定部分选项，让向导只补齐剩余内容：
+
+```bash
+compshare instance create --gpu 3080Ti --image-source platform
+```
+
+自动化场景使用完整参数模式：
+
+```bash
+compshare instance create \
+  --gpu 4090 \
+  --count 1 \
+  --cpu 16 \
+  --memory 64GiB \
+  --image compshareImage-xxxx \
+  --disk 100GiB \
+  --data-disk 200GiB:CLOUD_SSD \
+  --charge Postpay
+```
+
+创建前会依次检查目标组合库存和价格，得到确认后才创建。自动化中可使用 `--yes` 跳过最终确认。`--json` 不会启动交互向导，因此必须同时提供 `--gpu`、`--count`、`--cpu`、`--memory` 和 `--image`。
+
+可以先检查库存、价格和最终请求，但不创建资源：
+
+```bash
+compshare instance create ... --dry-run --json
+```
+
+人类交互终端默认等待创建和生命周期操作进入稳定状态，脚本使用的 JSON 模式默认提交后立即返回。可以用 `--wait`、`--no-wait` 和 `--timeout` 显式控制；创建镜像也支持相同选项。
+
+### 命令概览
+
+```text
+compshare instance search
+compshare instance zones
+compshare instance families
+compshare instance list
+compshare instance show INSTANCE
+compshare instance create
+compshare instance start INSTANCE
+compshare instance stop INSTANCE
+compshare instance reboot INSTANCE
+compshare instance delete INSTANCE
+compshare instance rename INSTANCE NAME
+compshare instance password INSTANCE
+compshare instance reinstall INSTANCE
+compshare instance resize INSTANCE
+compshare instance price
+compshare instance resize-price INSTANCE
+compshare instance billing
+compshare instance refund INSTANCE...
+compshare instance monitor [INSTANCE...]
+compshare instance charge INSTANCE --to Month
+compshare instance network
+compshare instance models
+compshare instance ssh INSTANCE
+compshare instance ports list
+compshare instance ports update INSTANCE
+compshare instance schedule set INSTANCE --at 2h
+compshare instance schedule cancel INSTANCE
+compshare instance software list
+compshare instance software url INSTANCE JupyterLab
+```
+
+`ssh` 会在连接前显示 API 返回的实例密码；使用 `ssh INSTANCE --print` 时会同时输出 SSH 命令和密码。
+
+`resize` 明确区分计算规格调整和磁盘扩容，两者不能放在同一次请求中。执行删除、关机、重启、重装、改配等高影响操作时默认要求确认。
+
+`instance list` 支持 `--name`、`--status`、`--gpu` 和 `--billing` 组合筛选。`instance show` 默认显示重点字段卡片，使用 `--json` 时保留完整 API 响应。旧命令 `upgrade-price` 仍兼容，但帮助中统一使用 `resize-price`。
+
+生产实测中 `monitor` 和 `software url` 对应接口当前不可用，CLI 会在帮助和 API 错误提示中明确标记；命令仍保留，便于服务端恢复后直接使用。
+
+## 镜像
+
+用 `--source` 在不同镜像来源间切换：
+
+```bash
+compshare image list --source platform
+compshare image list --source custom
+compshare image list --source community --query pytorch --tag LLM
+compshare image list --source shared
+compshare image list --source published
+compshare image list --source user --user 12345
+```
+
+完整命令：
+
+```text
+compshare image list
+compshare image show IMAGE
+compshare image create --instance INSTANCE --name NAME
+compshare image progress IMAGE
+compshare image update IMAGE
+compshare image delete IMAGE
+compshare image shares IMAGE
+compshare image share IMAGE ACCOUNT...
+compshare image unshare IMAGE ACCOUNT...
+compshare image publish IMAGE --version v1.0
+compshare image favorite IMAGE
+compshare image unfavorite IMAGE
+compshare image tags
+```
+
+社区镜像列表支持名称、作者、模糊查询、标签、免费/付费、官方/非官方、自启动和排序筛选。封面文件由 CLI 转成 Base64，README 文件按 UTF-8 读取。
+
+创建镜像时可使用 `--wait` 跟踪 `GetCompShareImageCreateProgress`，或继续使用独立的 `image progress` 命令。
+
+## 磁盘与云存储
+
+```text
+compshare storage disk list
+compshare storage disk create --instance INSTANCE --size 100GiB --name DATA
+compshare storage disk attach DISK --instance INSTANCE
+compshare storage disk detach DISK --instance INSTANCE --device /dev/vdb
+compshare storage disk price DISK --instance INSTANCE --size 200GiB
+compshare storage disk resize DISK --size 200GiB
+compshare storage disk delete DISK
+compshare storage us3 attach --instance INSTANCE
+```
+
+`storage us3 attach` 覆盖 CompShare 的 US3 挂载 Action。对象上传、下载、Bucket 管理继续使用独立的 `us3cli`，避免在本 CLI 中复制另一套成熟工具的能力。
+
+云盘删除会对“仍在卸载中”的暂时性错误自动重试；其他已知生产错误会附带可执行的处理建议。
+
+## 开发校验
+
+```bash
+.venv/bin/ruff check src tests
+.venv/bin/ruff format --check src tests
+.venv/bin/pytest
+```
+
+公开 Action 清单维护在 `compshare_cli.actions` 中，测试会校验 27/17/7 的领域数量以及命令实现是否包含全部 51 个 Action。

compshare_cli-0.1.0/README.md

@@ -0,0 +1,266 @@
+# CompShare CLI
+
+在终端中管理优云智算 GPU 实例、实例镜像、云盘与 US3 挂载。
+
+第一阶段覆盖 `compshare-docs` 中三个公开 API 目录的 51 个 Action：
+
+- GPU 实例：27 个 Action
+- 实例镜像：17 个 Action
+- 磁盘与云存储：7 个 Action
+
+CLI 使用官方 [`ucloud-sdk-python3`](https://github.com/ucloud/ucloud-sdk-python3) 完成鉴权、参数编码、请求传输与重试。调用层使用 SDK 的通用 `invoke` 接口，因为 CompShare 的公开 API 更新可能早于 SDK 的生成式请求模型；这样不会静默丢弃新参数。
+
+## 安装
+
+要求 Python 3.9 或更高版本。
+
+```bash
+python -m pip install .
+compshare --help
+```
+
+开发环境：
+
+```bash
+python -m venv .venv
+.venv/bin/python -m pip install --upgrade pip
+.venv/bin/python -m pip install -e '.[dev]'
+.venv/bin/pytest
+```
+
+## 配置
+
+交互式保存 API 密钥：
+
+```bash
+compshare config --name production
+```
+
+每个凭证 profile 只保存名称、公钥和私钥，不绑定地域、可用区或项目。配置默认保存到 `~/.config/compshare/config.json`，目录权限为 `0700`，文件权限为 `0600`。支持多个凭证 profile：
+
+```bash
+compshare --profile production instance list
+compshare config list
+compshare config use production
+compshare config delete staging
+compshare config path
+```
+
+也可以完全通过环境变量运行：
+
+```bash
+export COMPSHARE_PUBLIC_KEY='...'
+export COMPSHARE_PRIVATE_KEY='...'
+export COMPSHARE_REGION='cn-wlcb'
+export COMPSHARE_ZONE='cn-wlcb-01'
+```
+
+其中公私钥属于凭证；Region 和 Zone 只是请求位置。支持的环境变量还有 `COMPSHARE_PROFILE` 和 `COMPSHARE_CONFIG_FILE`。
+
+## 全局参数
+
+```text
+--profile       选择凭证 profile
+--json          输出适合脚本处理的 JSON
+```
+
+地域和可用区是资源参数，不是全局选项。它们会出现在真正需要位置的子命令后面：
+
+```bash
+compshare instance list --region cn-sh2
+compshare instance create --zone cn-sh2-02
+```
+
+实例和已挂载云盘的生命周期命令会根据资源 ID 自动查找 Region 和 Zone。列表命令未指定 `--region` 时会聚合所有支持地域。
+
+`ProjectId` 不是账户凭证的一部分。定时关机会通过 `GetProjectList` 自动选择默认项目；只有需要覆盖自动选择结果时才传 `--project-id`。
+
+`--json` 和 `--profile` 是全局选项，必须放在子命令前：
+
+```bash
+compshare --json instance list
+compshare --profile production instance list
+```
+
+成功时 JSON 模式直接输出 API 响应；失败时输出 `{"ok":false,"error":"..."}` 并返回非零退出码。实例密码和 FileBrowser 密码保留 API 原值，API 私钥仍会脱敏。
+
+CLI 默认显示中文帮助描述。使用一级命令持久切换语言，配置会写入本地配置文件，但不属于任何凭证 profile：
+
+```bash
+compshare --help
+compshare lang en
+compshare instance create --help
+compshare lang zh
+compshare lang       # 查看当前语言
+```
+
+也可以通过 `COMPSHARE_LANG=en` 覆盖当前终端会话的帮助语言。当前版本不安装 Shell completion，仅提供 `-h/--help`。
+
+## 实例
+
+### 查规格和库存
+
+不带镜像时，`search` 展示合法的 GPU、CPU 和内存组合：
+
+```bash
+compshare instance search
+compshare instance search --gpu 4090 --gpu A100
+```
+
+库存不是机型的固定属性。它还取决于镜像、磁盘、计费方式和 CPU 平台，因此检查真实库存时需要指定镜像：
+
+```bash
+compshare instance search \
+  --gpu 4090 \
+  --image compshareImage-xxxx \
+  --disk 100GiB \
+  --disk-type CLOUD_SSD \
+  --charge Postpay \
+  --available
+```
+
+该命令先调用 `DescribeAvailableCompShareInstanceTypes` 获取合法规格，再按匹配的 GPU 型号调用 `CheckCompShareResourceCapacity`。`--available` 不会用 Describe 接口的状态冒充库存。
+
+### 创建
+
+直接运行不带规格参数的命令会进入交互向导：
+
+```bash
+compshare instance create
+```
+
+向导会依次读取可用区、GPU 机型和镜像；选择计费方式与磁盘后，调用真实库存接口，只展示当前可创建的 GPU、CPU、内存组合。最后查询完整价格并要求确认。镜像来源支持 `platform`、`custom`、`community` 和 `shared`。
+
+也可以预先指定部分选项，让向导只补齐剩余内容：
+
+```bash
+compshare instance create --gpu 3080Ti --image-source platform
+```
+
+自动化场景使用完整参数模式：
+
+```bash
+compshare instance create \
+  --gpu 4090 \
+  --count 1 \
+  --cpu 16 \
+  --memory 64GiB \
+  --image compshareImage-xxxx \
+  --disk 100GiB \
+  --data-disk 200GiB:CLOUD_SSD \
+  --charge Postpay
+```
+
+创建前会依次检查目标组合库存和价格，得到确认后才创建。自动化中可使用 `--yes` 跳过最终确认。`--json` 不会启动交互向导，因此必须同时提供 `--gpu`、`--count`、`--cpu`、`--memory` 和 `--image`。
+
+可以先检查库存、价格和最终请求，但不创建资源：
+
+```bash
+compshare instance create ... --dry-run --json
+```
+
+人类交互终端默认等待创建和生命周期操作进入稳定状态，脚本使用的 JSON 模式默认提交后立即返回。可以用 `--wait`、`--no-wait` 和 `--timeout` 显式控制；创建镜像也支持相同选项。
+
+### 命令概览
+
+```text
+compshare instance search
+compshare instance zones
+compshare instance families
+compshare instance list
+compshare instance show INSTANCE
+compshare instance create
+compshare instance start INSTANCE
+compshare instance stop INSTANCE
+compshare instance reboot INSTANCE
+compshare instance delete INSTANCE
+compshare instance rename INSTANCE NAME
+compshare instance password INSTANCE
+compshare instance reinstall INSTANCE
+compshare instance resize INSTANCE
+compshare instance price
+compshare instance resize-price INSTANCE
+compshare instance billing
+compshare instance refund INSTANCE...
+compshare instance monitor [INSTANCE...]
+compshare instance charge INSTANCE --to Month
+compshare instance network
+compshare instance models
+compshare instance ssh INSTANCE
+compshare instance ports list
+compshare instance ports update INSTANCE
+compshare instance schedule set INSTANCE --at 2h
+compshare instance schedule cancel INSTANCE
+compshare instance software list
+compshare instance software url INSTANCE JupyterLab
+```
+
+`ssh` 会在连接前显示 API 返回的实例密码；使用 `ssh INSTANCE --print` 时会同时输出 SSH 命令和密码。
+
+`resize` 明确区分计算规格调整和磁盘扩容，两者不能放在同一次请求中。执行删除、关机、重启、重装、改配等高影响操作时默认要求确认。
+
+`instance list` 支持 `--name`、`--status`、`--gpu` 和 `--billing` 组合筛选。`instance show` 默认显示重点字段卡片，使用 `--json` 时保留完整 API 响应。旧命令 `upgrade-price` 仍兼容，但帮助中统一使用 `resize-price`。
+
+生产实测中 `monitor` 和 `software url` 对应接口当前不可用，CLI 会在帮助和 API 错误提示中明确标记；命令仍保留，便于服务端恢复后直接使用。
+
+## 镜像
+
+用 `--source` 在不同镜像来源间切换：
+
+```bash
+compshare image list --source platform
+compshare image list --source custom
+compshare image list --source community --query pytorch --tag LLM
+compshare image list --source shared
+compshare image list --source published
+compshare image list --source user --user 12345
+```
+
+完整命令：
+
+```text
+compshare image list
+compshare image show IMAGE
+compshare image create --instance INSTANCE --name NAME
+compshare image progress IMAGE
+compshare image update IMAGE
+compshare image delete IMAGE
+compshare image shares IMAGE
+compshare image share IMAGE ACCOUNT...
+compshare image unshare IMAGE ACCOUNT...
+compshare image publish IMAGE --version v1.0
+compshare image favorite IMAGE
+compshare image unfavorite IMAGE
+compshare image tags
+```
+
+社区镜像列表支持名称、作者、模糊查询、标签、免费/付费、官方/非官方、自启动和排序筛选。封面文件由 CLI 转成 Base64，README 文件按 UTF-8 读取。
+
+创建镜像时可使用 `--wait` 跟踪 `GetCompShareImageCreateProgress`，或继续使用独立的 `image progress` 命令。
+
+## 磁盘与云存储
+
+```text
+compshare storage disk list
+compshare storage disk create --instance INSTANCE --size 100GiB --name DATA
+compshare storage disk attach DISK --instance INSTANCE
+compshare storage disk detach DISK --instance INSTANCE --device /dev/vdb
+compshare storage disk price DISK --instance INSTANCE --size 200GiB
+compshare storage disk resize DISK --size 200GiB
+compshare storage disk delete DISK
+compshare storage us3 attach --instance INSTANCE
+```
+
+`storage us3 attach` 覆盖 CompShare 的 US3 挂载 Action。对象上传、下载、Bucket 管理继续使用独立的 `us3cli`，避免在本 CLI 中复制另一套成熟工具的能力。
+
+云盘删除会对“仍在卸载中”的暂时性错误自动重试；其他已知生产错误会附带可执行的处理建议。
+
+## 开发校验
+
+```bash
+.venv/bin/ruff check src tests
+.venv/bin/ruff format --check src tests
+.venv/bin/pytest
+```
+
+公开 Action 清单维护在 `compshare_cli.actions` 中，测试会校验 27/17/7 的领域数量以及命令实现是否包含全部 51 个 Action。

compshare_cli-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "compshare-cli"
+version = "0.1.0"
+description = "Command-line client for CompShare GPU compute"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Apache-2.0" }
+authors = [
+  { name = "CompShare" },
+]
+dependencies = [
+  "rich>=13,<15",
+  "typer>=0.12,<1",
+  "ucloud-sdk-python3>=0.11.103,<0.12",
+  "urllib3>=1.26.18,<2; python_version < '3.10' and platform_system == 'Darwin'",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8,<10",
+  "pytest-cov>=5,<8",
+  "ruff>=0.6,<1",
+]
+
+[project.scripts]
+compshare = "compshare_cli.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B"]
+ignore = ["B008"]

compshare_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

compshare_cli-0.1.0/src/compshare_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CompShare command-line client."""
+
+__version__ = "0.1.0"

compshare_cli-0.1.0/src/compshare_cli/__main__.py

@@ -0,0 +1,4 @@
+from compshare_cli.cli import main
+
+if __name__ == "__main__":
+    main()

compshare_cli-0.1.0/src/compshare_cli/actions.py

@@ -0,0 +1,71 @@
+"""Public CompShare API actions covered by the first CLI release."""
+
+INSTANCE_ACTIONS = frozenset(
+    {
+        "CheckCompShareNetOptimizer",
+        "CheckCompShareResourceCapacity",
+        "CreateCompShareInstance",
+        "DeleteCompShareStopScheduler",
+        "DescribeAvailableCompShareInstanceTypes",
+        "DescribeCompShareInstance",
+        "DescribeCompShareMachineTypeFamilies",
+        "DescribeCompShareSoftwarePort",
+        "DescribeCompShareSupportZone",
+        "DescribeModelRepositoryModels",
+        "GetCompShareInstanceMonitor",
+        "GetCompShareInstancePrice",
+        "GetCompShareInstanceUpgradePrice",
+        "GetCompShareInstanceUserPrice",
+        "GetCompShareRefundPrice",
+        "GetSoftwareURL",
+        "ModifyCompShareInstanceName",
+        "RebootCompShareInstance",
+        "ReinstallCompShareInstance",
+        "ResetCompShareInstancePassword",
+        "ResizeCompShareInstance",
+        "StartCompShareInstance",
+        "StopCompShareInstance",
+        "SwitchChargeType",
+        "TerminateCompShareInstance",
+        "UpdateCompShareInstancePorts",
+        "UpdateCompShareStopScheduler",
+    }
+)
+
+IMAGE_ACTIONS = frozenset(
+    {
+        "AddFavoriteImage",
+        "CreateCompShareCustomImage",
+        "DescribeCommunityImages",
+        "DescribeCompShareCustomImages",
+        "DescribeCompShareImages",
+        "DescribeCompShareImageShareAccounts",
+        "DescribeCompShareImageTags",
+        "DescribeCompShareSharingImages",
+        "DescribeSelfCommunityImages",
+        "DescribeUserCommunityImages",
+        "GetCompShareImageCreateProgress",
+        "ModifyCompShareImageShareAccount",
+        "PublishCompShareImage",
+        "RemoveFavoriteImage",
+        "TerminateCompShareCustomImage",
+        "UpdateCompShareImage",
+    }
+)
+
+STORAGE_ACTIONS = frozenset(
+    {
+        "AttachCompshareDisk",
+        "AttachUS3",
+        "CreateAndAttachCompshareDisk",
+        "DeleteCompshareDisk",
+        "DetachCompshareDisk",
+        "GetCompShareAttachedDiskUpgradePrice",
+        "ResizeCompShareDisk",
+    }
+)
+
+PUBLIC_ACTIONS = INSTANCE_ACTIONS | IMAGE_ACTIONS | STORAGE_ACTIONS
+
+# Documented publicly but unavailable in the production API (RetCode 161).
+UNAVAILABLE_ACTIONS = frozenset({"DescribeFavoriteImages"})