AgentSkillsCN

agentuity-cli-cloud-sandbox-snapshot-create

从沙盒中创建快照。需要身份验证。适用于 Agentuity 云平台运维。

SKILL.md
--- frontmatter
name: agentuity-cli-cloud-sandbox-snapshot-create
description: Create a snapshot from a sandbox. Requires authentication. Use for Agentuity cloud platform operations
version: "0.1.24"
license: Apache-2.0
allowed-tools: "Bash(agentuity:*)"
argument-hint: "<sandboxId>"
metadata:
  command: "agentuity cloud sandbox snapshot create"
  tags: "slow requires-auth"

Cloud Sandbox Snapshot Create

Create a snapshot from a sandbox

Prerequisites

  • Authenticated with agentuity auth login
  • Organization context required (--org-id or default org)

Usage

bash
agentuity cloud sandbox snapshot create <sandboxId> [options]

Arguments

ArgumentTypeRequiredDescription
<sandboxId>stringYes-

Options

OptionTypeRequiredDefaultDescription
--namestringYes-Display name for the snapshot (letters, numbers, underscores, dashes only)
--descriptionstringYes-Description of the snapshot
--tagstringYes-Tag for the snapshot (defaults to "latest")
--publicbooleanNofalseMake the snapshot publicly accessible

Examples

Create a snapshot from a sandbox:

bash
bunx @agentuity/cli cloud sandbox snapshot create sbx_abc123

Create a tagged snapshot:

bash
bunx @agentuity/cli cloud sandbox snapshot create sbx_abc123 --tag latest

Create a named snapshot with description:

bash
bunx @agentuity/cli cloud sandbox snapshot create sbx_abc123 --name "My Snapshot" --description "Initial setup"

Create a public snapshot:

bash
bunx @agentuity/cli cloud sandbox snapshot create sbx_abc123 --public

Output

Returns JSON object:

json
{
  "snapshotId": "string",
  "name": "string",
  "description": "unknown",
  "tag": "unknown",
  "sizeBytes": "number",
  "fileCount": "number",
  "createdAt": "string"
}
FieldTypeDescription
snapshotIdstringSnapshot ID
namestringSnapshot display name
descriptionunknownSnapshot description
tagunknownSnapshot tag (defaults to "latest")
sizeBytesnumberSnapshot size in bytes
fileCountnumberNumber of files in snapshot
createdAtstringSnapshot creation timestamp