Home

vngcloud

Documentation for danny.vn/vngcloud, an unofficial Go SDK and command-line tool for GreenNode. This is a personal project under the Apache 2.0 license, not affiliated with GreenNode. GreenNode was called VNG Cloud until its rename; the module keeps the vngcloud name.

SDK

• Getting Started: install, create a client, list resources.
• Authentication: IAM User and service-account login, TOTP, static tokens, and custom credential providers.
• Configuration: regions, projects, and endpoints.
• Errors: APIError, LoginError, and debug logging.
• Services: service overview, SDK method examples, and links to detailed guides.
• Backup: Backup Center backends and policies in hcm-3.
• Billing and Pricing: budgets, cost, balances, and price quotes.
• CDN: published GreenNode CDN IP ranges, vCDN certificate and API key reads, Web Accelerator reads and writes, and traffic analytics.
• Compute: vServer instances, images, and SSH keys, including importing and creating them.
• Container Registry: repositories and users, including writes and secret handling.
• DNS: hosted zones and records, including writes and waits.
• IAM: service account writes, and their self-change and privileged-change guards.
• Load Balancer: load balancers, pools, listeners, and L7 policies, including the price guard, writes, and waits.
• Monitor: vMonitor synthetic checks, and pausing and resuming them.
• Monitor Alerts: notification channels, log projects, and alarms.
• Monitor Log Alarms: creating, updating, and deleting log alarms.
• Storage: vStorage regions, projects, buckets, S3 keys, and bucket settings, including bucket and key writes.
• Storage Workload Access: application identities, bucket grants, private key handoff, rotation, and network prerequisites for vServer and VKS.
• Storage Objects: native SDK and CLI binary object uploads and downloads, one-page listing, HEAD metadata, current-name deletion with --yes, and server-side copy with --replace --yes.
• Storage Object Copy: replacement consent, retained source, metadata limits, and ambiguous-result recovery.
• Storage: Projects: package price discovery, purchase, deletion, and auto-renew state and updates.
• Storage: Bucket Policy: the per-bucket key policy, its template, and the rules.
• Storage: Bucket Settings: bucket versioning and encryption, plus CORS rules.
• Network: security groups and their rules, VPCs, subnets, and Private DNS, including writes and waits.
• Public NAT: inventory, zone and package catalogs, quotes, and guarded create and delete operations; paid writes require IAM-user login in han-1.
• Site-to-site VPN: VPN inventory with sites and tunnels.
• Network Route Tables: route tables and routes.
• Network ACLs: ACLs, rules, and subnet associations.
• Network DHCP Options: DHCP options sets and the set a VPC uses.
• Network Virtual IPs: private virtual IP writes.
• Tagging: reading and writing resource tags.
• VKS: Kubernetes cluster inventory, versions, and quota.
• Security: what is safe by default, and cannot be turned off.
• Limitations: GreenNode server behaviors the SDK works around but cannot fix.

CLI

• CLI: commands, global flags, output, exit codes, and error classes.
• IDs for Create Server: the command or call that finds each ID a server quote or create takes.
• CLI: Billing, CLI: Pricing, CLI: Compute, CLI: IAM, CLI: Network, CLI: DNS, CLI: CDN, CLI: Monitor, CLI: Storage, CLI: VKS, and CLI: Backup: every operation, its flags, and an example.

Source

The Wiki mirrors reviewed documentation in docs/wiki/ in the repository. Submit documentation changes there for review. Changes made only in the Wiki web UI can be overwritten by a later sync.