pp-digitalocean
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseDigitalocean — Printing Press CLI
DigitalOcean — Printing Press CLI
Prerequisites: Install the CLI
前提条件:安装CLI
This skill drives the binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
digitalocean-pp-cli- Install via the Printing Press installer:
bash
npx -y @mvanhorn/printing-press install digitalocean --cli-only - Verify:
digitalocean-pp-cli --version - Ensure (or
$GOPATH/bin) is on$HOME/go/bin.$PATH
If the install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
npxbash
go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-cli@latestIf reports "command not found" after install, the install step did not put the binary on . Do not proceed with skill commands until verification succeeds.
--version$PATH本工具基于二进制文件运行。在调用本工具的任何命令前,必须确认CLI已安装。若未安装,请按以下步骤操作:
digitalocean-pp-cli- 通过Printing Press安装器安装:
bash
npx -y @mvanhorn/printing-press install digitalocean --cli-only - 验证安装:
digitalocean-pp-cli --version - 确保(或
$GOPATH/bin)已添加至$HOME/go/bin环境变量。$PATH
如果安装失败(如无Node环境、离线等),可改用Go直接安装(要求Go 1.26.3或更高版本):
npxbash
go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-cli@latest若安装后执行提示“command not found”,说明安装程序未将二进制文件加入。请在验证成功前不要执行本工具的命令。
--version$PATHUnique Capabilities
独特功能
These capabilities aren't available in any other tool for this API.
这些功能是其他同类型API工具所不具备的。
Local state that compounds
可累积的本地状态
-
— Sync DigitalOcean resources into a local SQLite store for offline inspection and repeatable agent workflows.
workflow archiveGives agents a durable local inventory before planning cloud changes.bashdigitalocean-pp-cli workflow archive --full --json -
— Search synced DigitalOcean data locally, with live/local source selection for agent-friendly retrieval.
searchLets agents locate relevant resources before choosing a narrower command.bashdigitalocean-pp-cli search "production" --data-source local --json --limit 20
-
— 将DigitalOcean资源同步到本地SQLite存储,支持离线查看和可重复的Agent工作流。
workflow archive让Agent在规划云资源变更前拥有持久化的本地资源清单。bashdigitalocean-pp-cli workflow archive --full --json -
— 在本地搜索已同步的DigitalOcean数据,支持实时/本地数据源选择,便于Agent检索。
search让Agent在选择更具体的命令前定位到相关资源。bashdigitalocean-pp-cli search "production" --data-source local --json --limit 20
Operational summaries
运行摘要
-
— Summarize locally synced resource data with count and group-by operations.
analyticsTurns resource listings into operational summaries an agent can reason about.bashdigitalocean-pp-cli analytics --type droplets --group-by region --json -
— Poll selected resources and emit change events as NDJSON for shell and agent pipelines.
tailProvides a safe one-shot or continuous change feed without bespoke scripts.bashdigitalocean-pp-cli tail --resource droplets --interval 30s --json
-
— 通过计数和分组操作汇总本地同步的资源数据。
analytics将资源列表转换为Agent可分析的运行摘要。bashdigitalocean-pp-cli analytics --type droplets --group-by region --json -
— 轮询指定资源并以NDJSON格式输出变更事件,用于Shell和Agent流水线。
tail无需定制脚本即可提供一次性或持续的变更反馈。bashdigitalocean-pp-cli tail --resource droplets --interval 30s --json
Command Reference
命令参考
1-clicks — Manage 1 clicks
- — Create
digitalocean-pp-cli 1-clicks create - — List
digitalocean-pp-cli 1-clicks list
account — Provides information about your current account.
- — Create
digitalocean-pp-cli account create - — Delete
digitalocean-pp-cli account delete - — Get
digitalocean-pp-cli account get - — List
digitalocean-pp-cli account list - — List keys
digitalocean-pp-cli account list-keys - — Update
digitalocean-pp-cli account update
actions — Actions are records of events that have occurred on the resources in your account.
These can be things like rebooting a Droplet, or transferring an image to a new region.
An action object is created every time one of these actions is initiated. The action
object contains information about the current status of the action, start and complete
timestamps, and the associated resource type and ID.
Every action that creates an action object is available through this endpoint. Completed
actions are not removed from this list and are always available for querying.
Note: You can pass the following HTTP header with the request to have the API return
the stanza instead of the stanza:
reserved_ipsfloating_ips-
Accept: application/vnd.digitalocean.reserveip+json -
— Get
digitalocean-pp-cli actions get -
— List
digitalocean-pp-cli actions list
add-ons — Add-ons are third-party applications that can be added to your DigitalOcean account.
They are available through the DigitalOcean Marketplace.
Add-ons can be used to enhance the functionality of your existing resources or to provide
additional services.
The Add-Ons API allows you to manage these resources, including creating, listing, and retrieving
details about specific add-on resources.
- — Create
digitalocean-pp-cli add-ons create - — Delete
digitalocean-pp-cli add-ons delete - — Get
digitalocean-pp-cli add-ons get - — Get addons
digitalocean-pp-cli add-ons get-addons - — List
digitalocean-pp-cli add-ons list - — List addons
digitalocean-pp-cli add-ons list-addons - — Update
digitalocean-pp-cli add-ons update - — Update addons
digitalocean-pp-cli add-ons update-addons
apps — App Platform is a Platform-as-a-Service (PaaS) offering from DigitalOcean that allows
developers to publish code directly to DigitalOcean servers without worrying about the
underlying infrastructure.
Most API operations are centered around a few core object types. Following are the
definitions of these types. These definitions will be omitted from the operation-specific
documentation.
For documentation on app specifications ( objects), please refer to the
product documentation).
AppSpec- — Create
digitalocean-pp-cli apps create - — Create metrics
digitalocean-pp-cli apps create-metrics - — Create propose
digitalocean-pp-cli apps create-propose - — Delete
digitalocean-pp-cli apps delete - — Get
digitalocean-pp-cli apps get - — Get tiers
digitalocean-pp-cli apps get-tiers - — List
digitalocean-pp-cli apps list - — List regions
digitalocean-pp-cli apps list-regions - — List tiers
digitalocean-pp-cli apps list-tiers - — Update
digitalocean-pp-cli apps update
async-invoke — Manage async invoke
- — Create
digitalocean-pp-cli async-invoke
batches — Manage batches
- — Create
digitalocean-pp-cli batches create - — Create files
digitalocean-pp-cli batches create-files - — Get
digitalocean-pp-cli batches get - — List
digitalocean-pp-cli batches list
billing — The billing endpoints allow you to retrieve your account balance, invoices,
billing history, and insights.
Balance: By sending requests to the endpoint, you can
retrieve the balance information for the requested customer account.
/v2/customers/my/balanceInvoices: Invoices
are generated on the first of each month for every DigitalOcean
customer. An invoice preview is generated daily, which can be accessed
with the keyword in place of . To interact with
invoices, you will generally send requests to the invoices endpoint at
.
preview$INVOICE_UUID/v2/customers/my/invoicesBilling History: Billing history is a record of billing events for your account.
For example, entries may include events like payments made, invoices
issued, or credits granted. To interact with invoices, you
will generally send requests to the invoices endpoint at
.
/v2/customers/my/billing_historyBilling Insights: Day-over-day changes in billing resource usage based on nightly invoice items,
including total amount, region, SKU, and description for a specified date range.
It is important to note that the daily resource usage may not reflect month-end billing totals when totaled for
a given month as nightly invoice items do not necessarily encompass all invoicing factors for the entire month.
where account_urn is the URN of the customer
account, can be a team (do:team:uuid) or an organization (do:teamgroup:uuid). The date range specified by
start_date and end_date must be in YYYY-MM-DD format.
v2/billing/{account_urn}/insights/{start_date}/{end_date}byoip-prefixes — Bring your own IP (BYOIP) lets you provision your own IPv4 network prefixes
to your account, then assign those IPs to your DigitalOcean resources.
BYOIP supports the following features:
- IPv4 addresses
- Network sizes of anywhere from (256 addresses) to
/24(16,384 addresses)/18 - Same API and management interface as our existing reserved IPs feature
- Assignable to Droplets only
- — Create
digitalocean-pp-cli byoip-prefixes create - — Delete
digitalocean-pp-cli byoip-prefixes delete - — Get
digitalocean-pp-cli byoip-prefixes get - — List
digitalocean-pp-cli byoip-prefixes list - — Update
digitalocean-pp-cli byoip-prefixes update
cdn — Manage cdn
- — Create
digitalocean-pp-cli cdn create - — Delete
digitalocean-pp-cli cdn delete - — Delete endpoints
digitalocean-pp-cli cdn delete-endpoints - — Get
digitalocean-pp-cli cdn get - — List
digitalocean-pp-cli cdn list - — Update
digitalocean-pp-cli cdn update
certificates — In order to perform SSL termination on load balancers, DigitalOcean offers
two types of SSL certificate management:
-
Custom: User-generated certificates may be uploaded to DigitalOcean where they will be placed in a fully encrypted and isolated storage system.
-
Let's Encrypt: Certificates may be automatically generated by DigitalOcean utilizing an integration with Let's Encrypt, the free and open certificate authority. These certificates will also be automatically renewed as required.
- — Create
digitalocean-pp-cli certificates create - — Delete
digitalocean-pp-cli certificates delete - — Get
digitalocean-pp-cli certificates get - — List
digitalocean-pp-cli certificates list
chat — Manage chat
- — Create
digitalocean-pp-cli chat create - — Create completions
digitalocean-pp-cli chat create-completions
customers — Manage customers
- — Get
digitalocean-pp-cli customers get - — Get my
digitalocean-pp-cli customers get-my - — Get my 2
digitalocean-pp-cli customers get-my-2 - — Get my 3
digitalocean-pp-cli customers get-my-3 - — List
digitalocean-pp-cli customers list - — List my
digitalocean-pp-cli customers list-my - — List my 2
digitalocean-pp-cli customers list-my-2
databases — DigitalOcean's managed database service
simplifies the creation and management of highly available database clusters. Currently, it
offers support for PostgreSQL,
Caching,
Valkey,
MySQL,
MongoDB, and
OpenSearch.
By sending requests to the endpoint, you can list, create, or delete
database clusters as well as scale the size of a cluster, add or remove read-only replicas,
and manage other configuration details.
/v2/databasesDatabase clusters may be deployed in a multi-node, high-availability configuration.
If your machine type is above the basic nodes, your node plan is above the smallest option,
or you are running MongoDB, you may additionally include up to two standby nodes in your cluster.
The size of individual nodes in a database cluster is represented by a human-readable slug,
which is used in some of the following requests. Each slug denotes the node's identifier,
CPU count, and amount of RAM, in that order.
For a list of currently available database slugs and options, use the endpoint or use the
command.
/v2/databases/optionsdoctl databases options- — Create
digitalocean-pp-cli databases create - — Delete
digitalocean-pp-cli databases delete - — Get
digitalocean-pp-cli databases get - — List
digitalocean-pp-cli databases list - — List metrics
digitalocean-pp-cli databases list-metrics - — List options
digitalocean-pp-cli databases list-options - — Update
digitalocean-pp-cli databases update
dedicated-inferences — Dedicated Inference
delivers scalable production-grade LLM hosting on DigitalOcean. Create, list, get, update,
and delete Dedicated Inference instances; manage accelerators, CA certificate, sizes,
GPU model config, and access tokens.
- — Create
digitalocean-pp-cli dedicated-inferences create - — Delete
digitalocean-pp-cli dedicated-inferences delete - — Get
digitalocean-pp-cli dedicated-inferences get - — List
digitalocean-pp-cli dedicated-inferences list - — List dedicatedinferences
digitalocean-pp-cli dedicated-inferences list-dedicatedinferences - — List dedicatedinferences 2
digitalocean-pp-cli dedicated-inferences list-dedicatedinferences-2 - — Update
digitalocean-pp-cli dedicated-inferences update
domains — Domain resources are domain names that you have purchased from a domain
name registrar that you are managing through the
DigitalOcean DNS interface.
This resource establishes top-level control over each domain. Actions that
affect individual domain records should be taken on the
Domain Records resource.
- — Create
digitalocean-pp-cli domains create - — Delete
digitalocean-pp-cli domains delete - — Get
digitalocean-pp-cli domains get - — List
digitalocean-pp-cli domains list
droplets — A Droplet is a DigitalOcean
virtual machine. By sending requests to the Droplet endpoint, you can
list, create, or delete Droplets.
Some of the attributes will have an object value. The and
objects will all contain the standard attributes of their associated
types. Find more information about each of these objects in their
respective sections.
regionimage- — Create
digitalocean-pp-cli droplets create - — Create actions
digitalocean-pp-cli droplets create-actions - — Create autoscale
digitalocean-pp-cli droplets create-autoscale - — Delete
digitalocean-pp-cli droplets delete - — Delete autoscale
digitalocean-pp-cli droplets delete-autoscale - — Delete autoscale 2
digitalocean-pp-cli droplets delete-autoscale-2 - — Delete dropletid
digitalocean-pp-cli droplets delete-dropletid - — Get
digitalocean-pp-cli droplets get - — Get autoscale
digitalocean-pp-cli droplets get-autoscale - — Get autoscale 2
digitalocean-pp-cli droplets get-autoscale-2 - — Get autoscale 3
digitalocean-pp-cli droplets get-autoscale-3 - — List
digitalocean-pp-cli droplets list - — List autoscale
digitalocean-pp-cli droplets list-autoscale - — List backups
digitalocean-pp-cli droplets list-backups - — List backups 2
digitalocean-pp-cli droplets list-backups-2 - — Update
digitalocean-pp-cli droplets update
embeddings — Text embedding vectors via on the
Serverless Inference base URL
(bearer model access key).
POST /v1/embeddingshttps://inference.do-ai.run- — Create
digitalocean-pp-cli embeddings
firewalls — DigitalOcean Cloud Firewalls
provide the ability to restrict network access to and from a Droplet
allowing you to define which ports will accept inbound or outbound
connections. By sending requests to the endpoint, you can
list, create, or delete firewalls as well as modify access rules.
/v2/firewalls- — Create
digitalocean-pp-cli firewalls create - — Delete
digitalocean-pp-cli firewalls delete - — Get
digitalocean-pp-cli firewalls get - — List
digitalocean-pp-cli firewalls list - — Update
digitalocean-pp-cli firewalls update
floating-ips — As of 16 June 2022, we have renamed the Floating IP product to Reserved IPs.
The Reserved IP product's endpoints function the exact same way as Floating IPs.
The only difference is the name change throughout the URLs and fields.
For example, the field is now the field.
The Floating IP endpoints will remain active until fall 2023 before being
permanently deprecated.
floating_ipsreserved_ipsWith the exception of the Projects API,
we will reflect this change as an additional field in the responses across the API
where the field is used. For example, the Droplet metadata response
will contain the field in addition to the field.
Floating IPs retrieved using the Projects API will retain the original name.
floating_ipreserved_ipsfloating_ipsDigitalOcean Floating IPs
are publicly-accessible static IP addresses that can be mapped to one of
your Droplets. They can be used to create highly available setups or other
configurations requiring movable addresses.
Floating IPs are bound to a specific region.
- — Create
digitalocean-pp-cli floating-ips create - — Delete
digitalocean-pp-cli floating-ips delete - — Get
digitalocean-pp-cli floating-ips get - — List
digitalocean-pp-cli floating-ips list
functions — Serverless functions are blocks of code that run on demand without the need to manage any infrastructure.
You can develop functions on your local machine and then deploy them to a namespace using , the official DigitalOcean CLI tool.
doctlThe Serverless Functions API currently only supports creating and managing namespaces.
- — Create
digitalocean-pp-cli functions create - — Create namespaces
digitalocean-pp-cli functions create-namespaces - — Create namespaces 2
digitalocean-pp-cli functions create-namespaces-2 - — Delete
digitalocean-pp-cli functions delete - — Delete namespaces
digitalocean-pp-cli functions delete-namespaces - — Delete namespaces 2
digitalocean-pp-cli functions delete-namespaces-2 - — Get
digitalocean-pp-cli functions get - — Get namespaces
digitalocean-pp-cli functions get-namespaces - — Get namespaces 2
digitalocean-pp-cli functions get-namespaces-2 - — Get namespaces 3
digitalocean-pp-cli functions get-namespaces-3 - — List
digitalocean-pp-cli functions list - — Update
digitalocean-pp-cli functions update - — Update namespaces
digitalocean-pp-cli functions update-namespaces
gen-ai — Manage gen ai
- — Create
digitalocean-pp-cli gen-ai create - — Create genai
digitalocean-pp-cli gen-ai create-genai - — Create genai 10
digitalocean-pp-cli gen-ai create-genai-10 - — Create genai 11
digitalocean-pp-cli gen-ai create-genai-11 - — Create genai 12
digitalocean-pp-cli gen-ai create-genai-12 - — Create genai 13
digitalocean-pp-cli gen-ai create-genai-13 - — Create genai 14
digitalocean-pp-cli gen-ai create-genai-14 - — Create genai 15
digitalocean-pp-cli gen-ai create-genai-15 - — Create genai 16
digitalocean-pp-cli gen-ai create-genai-16 - — Create genai 17
digitalocean-pp-cli gen-ai create-genai-17 - — Create genai 18
digitalocean-pp-cli gen-ai create-genai-18 - — Create genai 19
digitalocean-pp-cli gen-ai create-genai-19 - — Create genai 2
digitalocean-pp-cli gen-ai create-genai-2 - — Create genai 20
digitalocean-pp-cli gen-ai create-genai-20 - — Create genai 21
digitalocean-pp-cli gen-ai create-genai-21 - — Create genai 22
digitalocean-pp-cli gen-ai create-genai-22 - — Create genai 23
digitalocean-pp-cli gen-ai create-genai-23 - — Create genai 24
digitalocean-pp-cli gen-ai create-genai-24 - — Create genai 3
digitalocean-pp-cli gen-ai create-genai-3 - — Create genai 4
digitalocean-pp-cli gen-ai create-genai-4 - — Create genai 5
digitalocean-pp-cli gen-ai create-genai-5 - — Create genai 6
digitalocean-pp-cli gen-ai create-genai-6 - — Create genai 7
digitalocean-pp-cli gen-ai create-genai-7 - — Create genai 8
digitalocean-pp-cli gen-ai create-genai-8 - — Create genai 9
digitalocean-pp-cli gen-ai create-genai-9 - — Delete
digitalocean-pp-cli gen-ai delete - — Delete genai
digitalocean-pp-cli gen-ai delete-genai - — Delete genai 10
digitalocean-pp-cli gen-ai delete-genai-10 - — Delete genai 11
digitalocean-pp-cli gen-ai delete-genai-11 - — Delete genai 12
digitalocean-pp-cli gen-ai delete-genai-12 - — Delete genai 13
digitalocean-pp-cli gen-ai delete-genai-13 - — Delete genai 2
digitalocean-pp-cli gen-ai delete-genai-2 - — Delete genai 3
digitalocean-pp-cli gen-ai delete-genai-3 - — Delete genai 4
digitalocean-pp-cli gen-ai delete-genai-4 - — Delete genai 5
digitalocean-pp-cli gen-ai delete-genai-5 - — Delete genai 6
digitalocean-pp-cli gen-ai delete-genai-6 - — Delete genai 7
digitalocean-pp-cli gen-ai delete-genai-7 - — Delete genai 8
digitalocean-pp-cli gen-ai delete-genai-8 - — Delete genai 9
digitalocean-pp-cli gen-ai delete-genai-9 - — Get
digitalocean-pp-cli gen-ai get - — Get genai
digitalocean-pp-cli gen-ai get-genai - — Get genai 10
digitalocean-pp-cli gen-ai get-genai-10 - — Get genai 11
digitalocean-pp-cli gen-ai get-genai-11 - — Get genai 12
digitalocean-pp-cli gen-ai get-genai-12 - — Get genai 13
digitalocean-pp-cli gen-ai get-genai-13 - — Get genai 14
digitalocean-pp-cli gen-ai get-genai-14 - — Get genai 15
digitalocean-pp-cli gen-ai get-genai-15 - — Get genai 16
digitalocean-pp-cli gen-ai get-genai-16 - — Get genai 17
digitalocean-pp-cli gen-ai get-genai-17 - — Get genai 18
digitalocean-pp-cli gen-ai get-genai-18 - — Get genai 19
digitalocean-pp-cli gen-ai get-genai-19 - — Get genai 2
digitalocean-pp-cli gen-ai get-genai-2 - — Get genai 20
digitalocean-pp-cli gen-ai get-genai-20 - — Get genai 21
digitalocean-pp-cli gen-ai get-genai-21 - — Get genai 22
digitalocean-pp-cli gen-ai get-genai-22 - — Get genai 23
digitalocean-pp-cli gen-ai get-genai-23 - — Get genai 24
digitalocean-pp-cli gen-ai get-genai-24 - — Get genai 25
digitalocean-pp-cli gen-ai get-genai-25 - — Get genai 26
digitalocean-pp-cli gen-ai get-genai-26 - — Get genai 3
digitalocean-pp-cli gen-ai get-genai-3 - — Get genai 4
digitalocean-pp-cli gen-ai get-genai-4 - — Get genai 5
digitalocean-pp-cli gen-ai get-genai-5 - — Get genai 6
digitalocean-pp-cli gen-ai get-genai-6 - — Get genai 7
digitalocean-pp-cli gen-ai get-genai-7 - — Get genai 8
digitalocean-pp-cli gen-ai get-genai-8 - — Get genai 9
digitalocean-pp-cli gen-ai get-genai-9 - — List
digitalocean-pp-cli gen-ai list - — List genai
digitalocean-pp-cli gen-ai list-genai - — List genai 10
digitalocean-pp-cli gen-ai list-genai-10 - — List genai 11
digitalocean-pp-cli gen-ai list-genai-11 - — List genai 12
digitalocean-pp-cli gen-ai list-genai-12 - — List genai 13
digitalocean-pp-cli gen-ai list-genai-13 - — List genai 14
digitalocean-pp-cli gen-ai list-genai-14 - — List genai 15
digitalocean-pp-cli gen-ai list-genai-15 - — List genai 16
digitalocean-pp-cli gen-ai list-genai-16 - — List genai 17
digitalocean-pp-cli gen-ai list-genai-17 - — List genai 2
digitalocean-pp-cli gen-ai list-genai-2 - — List genai 3
digitalocean-pp-cli gen-ai list-genai-3 - — List genai 4
digitalocean-pp-cli gen-ai list-genai-4 - — List genai 5
digitalocean-pp-cli gen-ai list-genai-5 - — List genai 6
digitalocean-pp-cli gen-ai list-genai-6 - — List genai 7
digitalocean-pp-cli gen-ai list-genai-7 - — List genai 8
digitalocean-pp-cli gen-ai list-genai-8 - — List genai 9
digitalocean-pp-cli gen-ai list-genai-9 - — Update
digitalocean-pp-cli gen-ai update - — Update genai
digitalocean-pp-cli gen-ai update-genai - — Update genai 10
digitalocean-pp-cli gen-ai update-genai-10 - — Update genai 11
digitalocean-pp-cli gen-ai update-genai-11 - — Update genai 12
digitalocean-pp-cli gen-ai update-genai-12 - — Update genai 13
digitalocean-pp-cli gen-ai update-genai-13 - — Update genai 14
digitalocean-pp-cli gen-ai update-genai-14 - — Update genai 15
digitalocean-pp-cli gen-ai update-genai-15 - — Update genai 2
digitalocean-pp-cli gen-ai update-genai-2 - — Update genai 3
digitalocean-pp-cli gen-ai update-genai-3 - — Update genai 4
digitalocean-pp-cli gen-ai update-genai-4 - — Update genai 5
digitalocean-pp-cli gen-ai update-genai-5 - — Update genai 6
digitalocean-pp-cli gen-ai update-genai-6 - — Update genai 7
digitalocean-pp-cli gen-ai update-genai-7 - — Update genai 8
digitalocean-pp-cli gen-ai update-genai-8 - — Update genai 9
digitalocean-pp-cli gen-ai update-genai-9
images — A DigitalOcean image can be
used to create a Droplet and may come in a number of flavors. Currently,
there are five types of images: snapshots, backups, applications,
distributions, and custom images.
-
Snapshots provide a full copy of an existing Droplet instance taken on demand.
-
Backups are similar to snapshots but are created automatically at regular intervals when enabled for a Droplet.
-
Custom images are Linux-based virtual machine images (raw, qcow2, vhdx, vdi, and vmdk formats are supported) that you may upload for use on DigitalOcean.
-
Distributions are the public Linux distributions that are available to be used as a base to create Droplets.
-
Applications, or 1-Click Apps, are distributions pre-configured with additional software.
To interact with images, you will generally send requests to the images
endpoint at /v2/images.
- — Create
digitalocean-pp-cli images create - — Create generations
digitalocean-pp-cli images create-generations - — Delete
digitalocean-pp-cli images delete - — Get
digitalocean-pp-cli images get - — List
digitalocean-pp-cli images list - — Update
digitalocean-pp-cli images update
kubernetes — DigitalOcean Kubernetes
allows you to quickly deploy scalable and secure Kubernetes clusters. By
sending requests to the endpoint, you can list,
create, or delete clusters as well as scale node pools up and down,
recycle individual nodes, and retrieve the kubeconfig file for use with
a cluster.
/v2/kubernetes/clusters- — Create
digitalocean-pp-cli kubernetes create - — Create clusters
digitalocean-pp-cli kubernetes create-clusters - — Create clusters 2
digitalocean-pp-cli kubernetes create-clusters-2 - — Create clusters 3
digitalocean-pp-cli kubernetes create-clusters-3 - — Create clusters 4
digitalocean-pp-cli kubernetes create-clusters-4 - — Create registries
digitalocean-pp-cli kubernetes create-registries - — Create registry
digitalocean-pp-cli kubernetes create-registry - — Delete
digitalocean-pp-cli kubernetes delete - — Delete clusters
digitalocean-pp-cli kubernetes delete-clusters - — Delete clusters 2
digitalocean-pp-cli kubernetes delete-clusters-2 - — Delete clusters 3
digitalocean-pp-cli kubernetes delete-clusters-3 - — Delete clusters 4
digitalocean-pp-cli kubernetes delete-clusters-4 - — Delete clusters 5
digitalocean-pp-cli kubernetes delete-clusters-5 - — Delete registry
digitalocean-pp-cli kubernetes delete-registry - — Get
digitalocean-pp-cli kubernetes get - — Get clusters
digitalocean-pp-cli kubernetes get-clusters - — Get clusters 2
digitalocean-pp-cli kubernetes get-clusters-2 - — Get clusters 3
digitalocean-pp-cli kubernetes get-clusters-3 - — Get clusters 4
digitalocean-pp-cli kubernetes get-clusters-4 - — Get clusters 5
digitalocean-pp-cli kubernetes get-clusters-5 - — Get clusters 6
digitalocean-pp-cli kubernetes get-clusters-6 - — Get clusters 7
digitalocean-pp-cli kubernetes get-clusters-7 - — Get clusters 8
digitalocean-pp-cli kubernetes get-clusters-8 - — Get clusters 9
digitalocean-pp-cli kubernetes get-clusters-9 - — List
digitalocean-pp-cli kubernetes list - — List options
digitalocean-pp-cli kubernetes list-options - — Update
digitalocean-pp-cli kubernetes update - — Update clusters
digitalocean-pp-cli kubernetes update-clusters
load-balancers — DigitalOcean Load Balancers
provide a way to distribute traffic across multiple Droplets. By sending
requests to the endpoint, you can list, create, or
delete load balancers as well as add or remove Droplets, forwarding rules,
and other configuration details.
/v2/load_balancers- — Create
digitalocean-pp-cli load-balancers create - — Delete
digitalocean-pp-cli load-balancers delete - — Get
digitalocean-pp-cli load-balancers get - — List
digitalocean-pp-cli load-balancers list - — Update
digitalocean-pp-cli load-balancers update
messages — Manage messages
- — Create
digitalocean-pp-cli messages
models — Manage models
- — List
digitalocean-pp-cli models
monitoring — The DigitalOcean Monitoring API makes it possible to programmatically retrieve metrics as well as configure alert
policies based on these metrics. The Monitoring API can help you gain insight into how your apps are performing
and consuming resources.
- — Create
digitalocean-pp-cli monitoring create - — Create sinks
digitalocean-pp-cli monitoring create-sinks - — Create sinks 2
digitalocean-pp-cli monitoring create-sinks-2 - — Create sinks 3
digitalocean-pp-cli monitoring create-sinks-3 - — Delete
digitalocean-pp-cli monitoring delete - — Delete sinks
digitalocean-pp-cli monitoring delete-sinks - — Delete sinks 2
digitalocean-pp-cli monitoring delete-sinks-2 - — Get
digitalocean-pp-cli monitoring get - — Get sinks
digitalocean-pp-cli monitoring get-sinks - — Get sinks 2
digitalocean-pp-cli monitoring get-sinks-2 - — List
digitalocean-pp-cli monitoring list - — List metrics
digitalocean-pp-cli monitoring list-metrics - — List metrics 10
digitalocean-pp-cli monitoring list-metrics-10 - — List metrics 11
digitalocean-pp-cli monitoring list-metrics-11 - — List metrics 12
digitalocean-pp-cli monitoring list-metrics-12 - — List metrics 13
digitalocean-pp-cli monitoring list-metrics-13 - — List metrics 14
digitalocean-pp-cli monitoring list-metrics-14 - — List metrics 15
digitalocean-pp-cli monitoring list-metrics-15 - — List metrics 16
digitalocean-pp-cli monitoring list-metrics-16 - — List metrics 17
digitalocean-pp-cli monitoring list-metrics-17 - — List metrics 18
digitalocean-pp-cli monitoring list-metrics-18 - — List metrics 19
digitalocean-pp-cli monitoring list-metrics-19 - — List metrics 2
digitalocean-pp-cli monitoring list-metrics-2 - — List metrics 20
digitalocean-pp-cli monitoring list-metrics-20 - — List metrics 21
digitalocean-pp-cli monitoring list-metrics-21 - — List metrics 22
digitalocean-pp-cli monitoring list-metrics-22 - — List metrics 23
digitalocean-pp-cli monitoring list-metrics-23 - — List metrics 24
digitalocean-pp-cli monitoring list-metrics-24 - — List metrics 25
digitalocean-pp-cli monitoring list-metrics-25 - — List metrics 26
digitalocean-pp-cli monitoring list-metrics-26 - — List metrics 27
digitalocean-pp-cli monitoring list-metrics-27 - — List metrics 28
digitalocean-pp-cli monitoring list-metrics-28 - — List metrics 29
digitalocean-pp-cli monitoring list-metrics-29 - — List metrics 3
digitalocean-pp-cli monitoring list-metrics-3 - — List metrics 30
digitalocean-pp-cli monitoring list-metrics-30 - — List metrics 31
digitalocean-pp-cli monitoring list-metrics-31 - — List metrics 32
digitalocean-pp-cli monitoring list-metrics-32 - — List metrics 33
digitalocean-pp-cli monitoring list-metrics-33 - — List metrics 34
digitalocean-pp-cli monitoring list-metrics-34 - — List metrics 35
digitalocean-pp-cli monitoring list-metrics-35 - — List metrics 36
digitalocean-pp-cli monitoring list-metrics-36 - — List metrics 37
digitalocean-pp-cli monitoring list-metrics-37 - — List metrics 38
digitalocean-pp-cli monitoring list-metrics-38 - — List metrics 39
digitalocean-pp-cli monitoring list-metrics-39 - — List metrics 4
digitalocean-pp-cli monitoring list-metrics-4 - — List metrics 40
digitalocean-pp-cli monitoring list-metrics-40 - — List metrics 41
digitalocean-pp-cli monitoring list-metrics-41 - — List metrics 42
digitalocean-pp-cli monitoring list-metrics-42 - — List metrics 43
digitalocean-pp-cli monitoring list-metrics-43 - — List metrics 44
digitalocean-pp-cli monitoring list-metrics-44 - — List metrics 45
digitalocean-pp-cli monitoring list-metrics-45 - — List metrics 46
digitalocean-pp-cli monitoring list-metrics-46 - — List metrics 47
digitalocean-pp-cli monitoring list-metrics-47 - — List metrics 48
digitalocean-pp-cli monitoring list-metrics-48 - — List metrics 49
digitalocean-pp-cli monitoring list-metrics-49 - — List metrics 5
digitalocean-pp-cli monitoring list-metrics-5 - — List metrics 50
digitalocean-pp-cli monitoring list-metrics-50 - — List metrics 51
digitalocean-pp-cli monitoring list-metrics-51 - — List metrics 52
digitalocean-pp-cli monitoring list-metrics-52 - — List metrics 53
digitalocean-pp-cli monitoring list-metrics-53 - — List metrics 54
digitalocean-pp-cli monitoring list-metrics-54 - — List metrics 55
digitalocean-pp-cli monitoring list-metrics-55 - — List metrics 56
digitalocean-pp-cli monitoring list-metrics-56 - — List metrics 57
digitalocean-pp-cli monitoring list-metrics-57 - — List metrics 58
digitalocean-pp-cli monitoring list-metrics-58 - — List metrics 6
digitalocean-pp-cli monitoring list-metrics-6 - — List metrics 7
digitalocean-pp-cli monitoring list-metrics-7 - — List metrics 8
digitalocean-pp-cli monitoring list-metrics-8 - — List metrics 9
digitalocean-pp-cli monitoring list-metrics-9 - — List sinks
digitalocean-pp-cli monitoring list-sinks - — List sinks 2
digitalocean-pp-cli monitoring list-sinks-2 - — Update
digitalocean-pp-cli monitoring update
nfs — NFS lets you create fully managed, POSIX-compliant network file storage that delivers secure,
high-performance shared storage right inside your VPC. This enables seamless data sharing across Droplets in a VPC.
- — Create
digitalocean-pp-cli nfs create - — Delete
digitalocean-pp-cli nfs delete - — Delete snapshots
digitalocean-pp-cli nfs delete-snapshots - — Get
digitalocean-pp-cli nfs get - — Get snapshots
digitalocean-pp-cli nfs get-snapshots - — List
digitalocean-pp-cli nfs list - — List snapshots
digitalocean-pp-cli nfs list-snapshots
partner-network-connect — Partner Network Connect lets you establish high-bandwidth, low-latency
network connections directly between DigitalOcean VPC networks and other
public cloud providers or on-premises datacenters.
- — Create
digitalocean-pp-cli partner-network-connect create - — Create partnernetworkconnect
digitalocean-pp-cli partner-network-connect create-partnernetworkconnect - — Delete
digitalocean-pp-cli partner-network-connect delete - — Get
digitalocean-pp-cli partner-network-connect get - — Get partnernetworkconnect
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect - — Get partnernetworkconnect 2
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect-2 - — Get partnernetworkconnect 3
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect-3 - — List
digitalocean-pp-cli partner-network-connect list - — Update
digitalocean-pp-cli partner-network-connect update
projects — Projects allow you to organize your resources into groups that fit the way
you work. You can group resources (like Droplets, Spaces, load balancers,
domains, and floating IPs) in ways that align with the applications
you host on DigitalOcean.
- — Create
digitalocean-pp-cli projects create - — Create default
digitalocean-pp-cli projects create-default - — Delete
digitalocean-pp-cli projects delete - — Get
digitalocean-pp-cli projects get - — List
digitalocean-pp-cli projects list - — List default
digitalocean-pp-cli projects list-default - — List default 2
digitalocean-pp-cli projects list-default-2 - — Update
digitalocean-pp-cli projects update - — Update default
digitalocean-pp-cli projects update-default - — Update projectid
digitalocean-pp-cli projects update-projectid - — Update projectid 2
digitalocean-pp-cli projects update-projectid-2
regions — Provides information about DigitalOcean data center regions.
- — List
digitalocean-pp-cli regions
registries — Manage registries
- — Create
digitalocean-pp-cli registries create - — Create subscription
digitalocean-pp-cli registries create-subscription - — Create validatename
digitalocean-pp-cli registries create-validatename - — Delete
digitalocean-pp-cli registries delete - — Get
digitalocean-pp-cli registries get - — List
digitalocean-pp-cli registries list - — List options
digitalocean-pp-cli registries list-options - — List subscription
digitalocean-pp-cli registries list-subscription
registry — Manage registry
- — Create
digitalocean-pp-cli registry create - — Create subscription
digitalocean-pp-cli registry create-subscription - — Create validatename
digitalocean-pp-cli registry create-validatename - — Delete
digitalocean-pp-cli registry delete - — List
digitalocean-pp-cli registry list - — List dockercredentials
digitalocean-pp-cli registry list-dockercredentials - — List options
digitalocean-pp-cli registry list-options - — List subscription
digitalocean-pp-cli registry list-subscription
reports — Manage reports
- — List
digitalocean-pp-cli reports
reserved-ips — As of 16 June 2022, we have renamed the Floating IP
product to Reserved IPs. The Reserved IP product's endpoints function the exact
same way as Floating IPs. The only difference is the name change throughout the
URLs and fields. For example, the field is now the field.
The Floating IP endpoints will remain active until fall 2023 before being
permanently deprecated.
floating_ipsreserved_ipsWith the exception of the Projects API,
we will reflect this change as an additional field in the responses across the API
where the field is used. For example, the Droplet metadata response
will contain the field in addition to the field.
Floating IPs retrieved using the Projects API will retain the original name.
floating_ipreserved_ipsfloating_ipsDigitalOcean Reserved IPs are publicly-accessible static IP addresses that can be
mapped to one of your Droplets. They can be used to create highly available
setups or other configurations requiring movable addresses.
Reserved IPs are bound to a specific region.
- — Create
digitalocean-pp-cli reserved-ips create - — Delete
digitalocean-pp-cli reserved-ips delete - — Get
digitalocean-pp-cli reserved-ips get - — List
digitalocean-pp-cli reserved-ips list
reserved-ipv6 — DigitalOcean Reserved IPv6s are publicly-accessible static IP addresses that can be
mapped to one of your Droplets. They can be used to create highly available
setups or other configurations requiring movable addresses.
Reserved IPv6s are bound to a specific region.
- — Create
digitalocean-pp-cli reserved-ipv6 create - — Delete
digitalocean-pp-cli reserved-ipv6 delete - — Get
digitalocean-pp-cli reserved-ipv6 get - — List
digitalocean-pp-cli reserved-ipv6 list
responses — Manage responses
- — Create
digitalocean-pp-cli responses
security — Security CSPM endpoints for scans, scan findings, and settings.
- — Create
digitalocean-pp-cli security create - — Create scans
digitalocean-pp-cli security create-scans - — Create settings
digitalocean-pp-cli security create-settings - — Delete
digitalocean-pp-cli security delete - — Get
digitalocean-pp-cli security get - — Get scans
digitalocean-pp-cli security get-scans - — List
digitalocean-pp-cli security list - — List scans
digitalocean-pp-cli security list-scans - — List settings
digitalocean-pp-cli security list-settings - — Update
digitalocean-pp-cli security update
sizes — The sizes objects represent different packages of hardware resources that
can be used for Droplets. When a Droplet is created, a size must be
selected so that the correct resources can be allocated.
Each size represents a plan that bundles together specific sets of
resources. This includes the amount of RAM, the number of virtual CPUs,
disk space, and transfer. The size object also includes the pricing
details and the regions that the size is available in.
- — List
digitalocean-pp-cli sizes
snapshots — Snapshots are saved
instances of a Droplet or a block storage volume, which is reflected in
the attribute. In order to avoid problems with compressing
filesystems, each defines a attribute which is the minimum
size of the Droplet or volume disk when creating a new resource from the
saved snapshot.
resource_typemin_disk_sizeTo interact with snapshots, you will generally send requests to the
snapshots endpoint at .
/v2/snapshots- — Delete
digitalocean-pp-cli snapshots delete - — Get
digitalocean-pp-cli snapshots get - — List
digitalocean-pp-cli snapshots list
spaces — Manage spaces
- — Create
digitalocean-pp-cli spaces create - — Delete
digitalocean-pp-cli spaces delete - — Get
digitalocean-pp-cli spaces get - — List
digitalocean-pp-cli spaces list - — Update
digitalocean-pp-cli spaces update - — Update keys
digitalocean-pp-cli spaces update-keys
tags — A tag is a label that can be applied to a resource (currently Droplets,
Images, Volumes, Volume Snapshots, and Database clusters) in order to
better organize or facilitate the lookups and actions on it.
Tags have two attributes: a user defined attribute and an embedded
attribute with information about resources that have been tagged.
nameresources- — Create
digitalocean-pp-cli tags create - — Delete
digitalocean-pp-cli tags delete - — Get
digitalocean-pp-cli tags get - — List
digitalocean-pp-cli tags list
upload-url — Manage upload url
- — Update
digitalocean-pp-cli upload-url
uptime — DigitalOcean Uptime Checks provide the ability to monitor your endpoints from around the world, and alert you when they're slow, unavailable, or SSL certificates are expiring.
To interact with Uptime, you will generally send requests to the Uptime endpoint at .
/v2/uptime/- — Create
digitalocean-pp-cli uptime create - — Create checks
digitalocean-pp-cli uptime create-checks - — Delete
digitalocean-pp-cli uptime delete - — Delete checks
digitalocean-pp-cli uptime delete-checks - — Get
digitalocean-pp-cli uptime get - — Get checks
digitalocean-pp-cli uptime get-checks - — Get checks 2
digitalocean-pp-cli uptime get-checks-2 - — Get checks 3
digitalocean-pp-cli uptime get-checks-3 - — List
digitalocean-pp-cli uptime list - — Update
digitalocean-pp-cli uptime update - — Update checks
digitalocean-pp-cli uptime update-checks
volumes — Manage volumes
- — Create
digitalocean-pp-cli volumes create - — Create actions
digitalocean-pp-cli volumes create-actions - — Delete
digitalocean-pp-cli volumes delete - — Delete snapshots
digitalocean-pp-cli volumes delete-snapshots - — Delete volumeid
digitalocean-pp-cli volumes delete-volumeid - — Get
digitalocean-pp-cli volumes get - — Get snapshots
digitalocean-pp-cli volumes get-snapshots - — List
digitalocean-pp-cli volumes list
vpc-nat-gateways — VPC NAT Gateways
allow resources in a private VPC to access the public internet without
exposing them to incoming traffic.
By sending requests to the endpoint, you can create,
configure, list, and delete VPC NAT Gateways as well as retrieve information
about the resources assigned to them.
/v2/vpc_nat_gateways- — Create
digitalocean-pp-cli vpc-nat-gateways create - — Delete
digitalocean-pp-cli vpc-nat-gateways delete - — Get
digitalocean-pp-cli vpc-nat-gateways get - — List
digitalocean-pp-cli vpc-nat-gateways list - — Update
digitalocean-pp-cli vpc-nat-gateways update
vpc-peerings — VPC Peerings
join two VPC networks with a secure, private connection. This allows
resources in those networks to connect to each other's private IP addresses
as if they were in the same network.
- — Create
digitalocean-pp-cli vpc-peerings create - — Delete
digitalocean-pp-cli vpc-peerings delete - — Get
digitalocean-pp-cli vpc-peerings get - — List
digitalocean-pp-cli vpc-peerings list - — Update
digitalocean-pp-cli vpc-peerings update
vpcs — VPCs (virtual private clouds)
allow you to create virtual networks containing resources that can
communicate with each other in full isolation using private IP addresses.
By sending requests to the endpoint, you can create, configure,
list, and delete custom VPCs as well as retrieve information about the
resources assigned to them.
/v2/vpcs- — Create
digitalocean-pp-cli vpcs create - — Delete
digitalocean-pp-cli vpcs delete - — Get
digitalocean-pp-cli vpcs get - — List
digitalocean-pp-cli vpcs list - — Update
digitalocean-pp-cli vpcs update - — Update vpcid
digitalocean-pp-cli vpcs update-vpcid
1-clicks — 管理一键应用
- — 创建
digitalocean-pp-cli 1-clicks create - — 列出
digitalocean-pp-cli 1-clicks list
account — 提供当前账户信息
- — 创建
digitalocean-pp-cli account create - — 删除
digitalocean-pp-cli account delete - — 获取
digitalocean-pp-cli account get - — 列出
digitalocean-pp-cli account list - — 列出密钥
digitalocean-pp-cli account list-keys - — 更新
digitalocean-pp-cli account update
actions — 操作记录账户内资源发生的事件,例如重启Droplet、将镜像转移到新区域等。
每次发起此类操作时都会创建一个操作对象,包含操作的当前状态、开始和结束时间戳,以及关联的资源类型和ID。
所有创建操作对象的操作都可通过该端点访问,已完成的操作不会从列表中移除,始终可查询。
注意:请求时可添加以下HTTP头,使API返回字段而非字段:
reserved_ipsfloating_ips-
Accept: application/vnd.digitalocean.reserveip+json -
— 获取
digitalocean-pp-cli actions get -
— 列出
digitalocean-pp-cli actions list
add-ons — 附加组件是可添加到DigitalOcean账户的第三方应用,可通过DigitalOcean Marketplace获取。
附加组件可增强现有资源的功能或提供额外服务。
附加组件API允许您管理这些资源,包括创建、列出和获取特定附加组件的详情。
- — 创建
digitalocean-pp-cli add-ons create - — 删除
digitalocean-pp-cli add-ons delete - — 获取
digitalocean-pp-cli add-ons get - — 获取附加组件
digitalocean-pp-cli add-ons get-addons - — 列出
digitalocean-pp-cli add-ons list - — 列出附加组件
digitalocean-pp-cli add-ons list-addons - — 更新
digitalocean-pp-cli add-ons update - — 更新附加组件
digitalocean-pp-cli add-ons update-addons
apps — App Platform是DigitalOcean的平台即服务(PaaS)产品,允许开发者直接将代码发布到DigitalOcean服务器,无需关注底层基础设施。
大多数API操作围绕几个核心对象类型展开,以下是这些类型的定义,后续操作文档中会省略这些定义。
关于应用规格(对象)的文档,请参考产品文档。
AppSpec- — 创建
digitalocean-pp-cli apps create - — 创建指标
digitalocean-pp-cli apps create-metrics - — 创建建议
digitalocean-pp-cli apps create-propose - — 删除
digitalocean-pp-cli apps delete - — 获取
digitalocean-pp-cli apps get - — 获取套餐
digitalocean-pp-cli apps get-tiers - — 列出
digitalocean-pp-cli apps list - — 列出区域
digitalocean-pp-cli apps list-regions - — 列出套餐
digitalocean-pp-cli apps list-tiers - — 更新
digitalocean-pp-cli apps update
async-invoke — 管理异步调用
- — 创建
digitalocean-pp-cli async-invoke
batches — 管理批量操作
- — 创建
digitalocean-pp-cli batches create - — 创建文件
digitalocean-pp-cli batches create-files - — 获取
digitalocean-pp-cli batches get - — 列出
digitalocean-pp-cli batches list
billing — 计费端点允许您检索账户余额、发票、计费历史和洞察信息。
余额:向端点发送请求,可获取指定客户账户的余额信息。
发票:发票每月1日为所有DigitalOcean客户生成。每日会生成发票预览,可将请求中的替换为关键字访问。通常向发票端点发送请求来操作发票。
计费历史:计费历史记录账户的计费事件,例如付款、发票开具、信用额度发放等。通常向端点发送请求来操作计费历史。
计费洞察:基于夜间发票项目的计费资源使用量日变化,包括指定日期范围内的总金额、区域、SKU和描述。需要注意的是,当月每日资源使用量的总和可能无法反映月末计费总额,因为夜间发票项目不一定涵盖整月的所有计费因素。
端点为,其中是客户账户的URN,可以是团队(do:team:uuid)或组织(do:teamgroup:uuid)。和指定的日期范围必须为YYYY-MM-DD格式。
/v2/customers/my/balance$INVOICE_UUIDpreview/v2/customers/my/invoices/v2/customers/my/billing_historyv2/billing/{account_urn}/insights/{start_date}/{end_date}account_urnstart_dateend_datebyoip-prefixes — 自带IP(BYOIP)允许您将自己的IPv4网络前缀添加到账户,然后将这些IP分配给DigitalOcean资源。
BYOIP支持以下功能:
- IPv4地址
- 网络大小范围从(256个地址)到
/24(16384个地址)/18 - 与现有预留IP功能相同的API和管理界面
- 仅可分配给Droplet
- — 创建
digitalocean-pp-cli byoip-prefixes create - — 删除
digitalocean-pp-cli byoip-prefixes delete - — 获取
digitalocean-pp-cli byoip-prefixes get - — 列出
digitalocean-pp-cli byoip-prefixes list - — 更新
digitalocean-pp-cli byoip-prefixes update
cdn — 管理CDN
- — 创建
digitalocean-pp-cli cdn create - — 删除
digitalocean-pp-cli cdn delete - — 删除端点
digitalocean-pp-cli cdn delete-endpoints - — 获取
digitalocean-pp-cli cdn get - — 列出
digitalocean-pp-cli cdn list - — 更新
digitalocean-pp-cli cdn update
certificates — 为了在负载均衡器上执行SSL终止,DigitalOcean提供两种SSL证书管理方式:
-
自定义证书:用户生成的证书可上传到DigitalOcean,存储在完全加密和隔离的系统中。
-
Let's Encrypt证书:DigitalOcean可通过与Let's Encrypt(免费开源证书颁发机构)的集成自动生成证书,这些证书也会自动续期。
- — 创建
digitalocean-pp-cli certificates create - — 删除
digitalocean-pp-cli certificates delete - — 获取
digitalocean-pp-cli certificates get - — 列出
digitalocean-pp-cli certificates list
chat — 管理聊天功能
- — 创建
digitalocean-pp-cli chat create - — 创建补全
digitalocean-pp-cli chat create-completions
customers — 管理客户
- — 获取
digitalocean-pp-cli customers get - — 获取我的账户
digitalocean-pp-cli customers get-my - — 获取我的账户2
digitalocean-pp-cli customers get-my-2 - — 获取我的账户3
digitalocean-pp-cli customers get-my-3 - — 列出
digitalocean-pp-cli customers list - — 列出我的账户
digitalocean-pp-cli customers list-my - — 列出我的账户2
digitalocean-pp-cli customers list-my-2
databases — DigitalOcean的托管数据库服务简化了高可用数据库集群的创建和管理。目前支持PostgreSQL、缓存(Redis)、Valkey、MySQL、MongoDB和OpenSearch。
向端点发送请求,可列出、创建或删除数据库集群,还可调整集群规模、添加或移除只读副本以及管理其他配置细节。
数据库集群可部署为多节点高可用配置。如果您的机器类型高于基础节点、节点套餐高于最小选项,或者运行MongoDB,还可在集群中添加最多两个备用节点。
数据库集群中单个节点的大小由人类可读的slug表示,部分请求会用到该slug。每个slug依次表示节点的标识符、CPU数量和RAM容量。
如需查看当前可用的数据库slug和选项,可使用端点或命令。
/v2/databases/v2/databases/optionsdoctl databases options- — 创建
digitalocean-pp-cli databases create - — 删除
digitalocean-pp-cli databases delete - — 获取
digitalocean-pp-cli databases get - — 列出
digitalocean-pp-cli databases list - — 列出指标
digitalocean-pp-cli databases list-metrics - — 列出选项
digitalocean-pp-cli databases list-options - — 更新
digitalocean-pp-cli databases update
dedicated-inferences — 专属推理服务在DigitalOcean上提供可扩展的生产级LLM托管服务。支持创建、列出、获取、更新和删除专属推理实例;管理加速器、CA证书、实例规格、GPU模型配置和访问令牌。
- — 创建
digitalocean-pp-cli dedicated-inferences create - — 删除
digitalocean-pp-cli dedicated-inferences delete - — 获取
digitalocean-pp-cli dedicated-inferences get - — 列出
digitalocean-pp-cli dedicated-inferences list - — 列出专属推理实例
digitalocean-pp-cli dedicated-inferences list-dedicatedinferences - — 列出专属推理实例2
digitalocean-pp-cli dedicated-inferences list-dedicatedinferences-2 - — 更新
digitalocean-pp-cli dedicated-inferences update
domains — 域名资源是您从域名注册商购买并通过DigitalOcean DNS界面管理的域名。
该资源用于对每个域名进行顶层控制,影响单个域名记录的操作应在域名记录资源上执行。
- — 创建
digitalocean-pp-cli domains create - — 删除
digitalocean-pp-cli domains delete - — 获取
digitalocean-pp-cli domains get - — 列出
digitalocean-pp-cli domains list
droplets — Droplet是DigitalOcean的虚拟机。向Droplet端点发送请求,可列出、创建或删除Droplet。
部分属性的值为对象,和对象包含其关联类型的标准属性,可在各自章节中了解更多信息。
regionimage- — 创建
digitalocean-pp-cli droplets create - — 创建操作
digitalocean-pp-cli droplets create-actions - — 创建自动扩缩容
digitalocean-pp-cli droplets create-autoscale - — 删除
digitalocean-pp-cli droplets delete - — 删除自动扩缩容
digitalocean-pp-cli droplets delete-autoscale - — 删除自动扩缩容2
digitalocean-pp-cli droplets delete-autoscale-2 - — 删除指定ID的Droplet
digitalocean-pp-cli droplets delete-dropletid - — 获取
digitalocean-pp-cli droplets get - — 获取自动扩缩容信息
digitalocean-pp-cli droplets get-autoscale - — 获取自动扩缩容信息2
digitalocean-pp-cli droplets get-autoscale-2 - — 获取自动扩缩容信息3
digitalocean-pp-cli droplets get-autoscale-3 - — 列出
digitalocean-pp-cli droplets list - — 列出自动扩缩容信息
digitalocean-pp-cli droplets list-autoscale - — 列出备份
digitalocean-pp-cli droplets list-backups - — 列出备份2
digitalocean-pp-cli droplets list-backups-2 - — 更新
digitalocean-pp-cli droplets update
- — 创建
digitalocean-pp-cli embeddings
firewalls — DigitalOcean云防火墙可限制Droplet的网络访问,允许您定义哪些端口接受入站或出站连接。向端点发送请求,可列出、创建或删除防火墙,以及修改访问规则。
/v2/firewalls- — 创建
digitalocean-pp-cli firewalls create - — 删除
digitalocean-pp-cli firewalls delete - — 获取
digitalocean-pp-cli firewalls get - — 列出
digitalocean-pp-cli firewalls list - — 更新
digitalocean-pp-cli firewalls update
floating-ips — 自2022年6月16日起,我们已将Floating IP产品更名为预留IP(Reserved IPs)。预留IP产品的端点功能与Floating IP完全相同,唯一区别是URL和字段中的名称变更,例如字段现在变为字段。Floating IP端点将在2023年秋季前保持可用,之后将永久弃用。
除项目API外,我们会在API响应中添加额外字段以反映此变更,例如Droplet元数据响应将同时包含和字段。通过项目API检索到的Floating IP将保留原名称。
DigitalOcean Floating IP是可映射到您的Droplet的公共静态IP地址,可用于创建高可用设置或其他需要可移动地址的配置。
Floating IP绑定到特定区域。
floating_ipsreserved_ipsreserved_ipsfloating_ips- — 创建
digitalocean-pp-cli floating-ips create - — 删除
digitalocean-pp-cli floating-ips delete - — 获取
digitalocean-pp-cli floating-ips get - — 列出
digitalocean-pp-cli floating-ips list
functions — 无服务器函数是按需运行的代码块,无需管理基础设施。您可在本地开发函数,然后使用官方DigitalOcean CLI工具将其部署到命名空间。
无服务器函数API目前仅支持创建和管理命名空间。
doctl- — 创建
digitalocean-pp-cli functions create - — 创建命名空间
digitalocean-pp-cli functions create-namespaces - — 创建命名空间2
digitalocean-pp-cli functions create-namespaces-2 - — 删除
digitalocean-pp-cli functions delete - — 删除命名空间
digitalocean-pp-cli functions delete-namespaces - — 删除命名空间2
digitalocean-pp-cli functions delete-namespaces-2 - — 获取
digitalocean-pp-cli functions get - — 获取命名空间
digitalocean-pp-cli functions get-namespaces - — 获取命名空间2
digitalocean-pp-cli functions get-namespaces-2 - — 获取命名空间3
digitalocean-pp-cli functions get-namespaces-3 - — 列出
digitalocean-pp-cli functions list - — 更新
digitalocean-pp-cli functions update - — 更新命名空间
digitalocean-pp-cli functions update-namespaces
gen-ai — 管理生成式AI
- — 创建
digitalocean-pp-cli gen-ai create - — 创建生成式AI实例
digitalocean-pp-cli gen-ai create-genai - — 创建生成式AI实例10
digitalocean-pp-cli gen-ai create-genai-10 - — 创建生成式AI实例11
digitalocean-pp-cli gen-ai create-genai-11 - — 创建生成式AI实例12
digitalocean-pp-cli gen-ai create-genai-12 - — 创建生成式AI实例13
digitalocean-pp-cli gen-ai create-genai-13 - — 创建生成式AI实例14
digitalocean-pp-cli gen-ai create-genai-14 - — 创建生成式AI实例15
digitalocean-pp-cli gen-ai create-genai-15 - — 创建生成式AI实例16
digitalocean-pp-cli gen-ai create-genai-16 - — 创建生成式AI实例17
digitalocean-pp-cli gen-ai create-genai-17 - — 创建生成式AI实例18
digitalocean-pp-cli gen-ai create-genai-18 - — 创建生成式AI实例19
digitalocean-pp-cli gen-ai create-genai-19 - — 创建生成式AI实例2
digitalocean-pp-cli gen-ai create-genai-2 - — 创建生成式AI实例20
digitalocean-pp-cli gen-ai create-genai-20 - — 创建生成式AI实例21
digitalocean-pp-cli gen-ai create-genai-21 - — 创建生成式AI实例22
digitalocean-pp-cli gen-ai create-genai-22 - — 创建生成式AI实例23
digitalocean-pp-cli gen-ai create-genai-23 - — 创建生成式AI实例24
digitalocean-pp-cli gen-ai create-genai-24 - — 创建生成式AI实例3
digitalocean-pp-cli gen-ai create-genai-3 - — 创建生成式AI实例4
digitalocean-pp-cli gen-ai create-genai-4 - — 创建生成式AI实例5
digitalocean-pp-cli gen-ai create-genai-5 - — 创建生成式AI实例6
digitalocean-pp-cli gen-ai create-genai-6 - — 创建生成式AI实例7
digitalocean-pp-cli gen-ai create-genai-7 - — 创建生成式AI实例8
digitalocean-pp-cli gen-ai create-genai-8 - — 创建生成式AI实例9
digitalocean-pp-cli gen-ai create-genai-9 - — 删除
digitalocean-pp-cli gen-ai delete - — 删除生成式AI实例
digitalocean-pp-cli gen-ai delete-genai - — 删除生成式AI实例10
digitalocean-pp-cli gen-ai delete-genai-10 - — 删除生成式AI实例11
digitalocean-pp-cli gen-ai delete-genai-11 - — 删除生成式AI实例12
digitalocean-pp-cli gen-ai delete-genai-12 - — 删除生成式AI实例13
digitalocean-pp-cli gen-ai delete-genai-13 - — 删除生成式AI实例2
digitalocean-pp-cli gen-ai delete-genai-2 - — 删除生成式AI实例3
digitalocean-pp-cli gen-ai delete-genai-3 - — 删除生成式AI实例4
digitalocean-pp-cli gen-ai delete-genai-4 - — 删除生成式AI实例5
digitalocean-pp-cli gen-ai delete-genai-5 - — 删除生成式AI实例6
digitalocean-pp-cli gen-ai delete-genai-6 - — 删除生成式AI实例7
digitalocean-pp-cli gen-ai delete-genai-7 - — 删除生成式AI实例8
digitalocean-pp-cli gen-ai delete-genai-8 - — 删除生成式AI实例9
digitalocean-pp-cli gen-ai delete-genai-9 - — 获取
digitalocean-pp-cli gen-ai get - — 获取生成式AI实例
digitalocean-pp-cli gen-ai get-genai - — 获取生成式AI实例10
digitalocean-pp-cli gen-ai get-genai-10 - — 获取生成式AI实例11
digitalocean-pp-cli gen-ai get-genai-11 - — 获取生成式AI实例12
digitalocean-pp-cli gen-ai get-genai-12 - — 获取生成式AI实例13
digitalocean-pp-cli gen-ai get-genai-13 - — 获取生成式AI实例14
digitalocean-pp-cli gen-ai get-genai-14 - — 获取生成式AI实例15
digitalocean-pp-cli gen-ai get-genai-15 - — 获取生成式AI实例16
digitalocean-pp-cli gen-ai get-genai-16 - — 获取生成式AI实例17
digitalocean-pp-cli gen-ai get-genai-17 - — 获取生成式AI实例18
digitalocean-pp-cli gen-ai get-genai-18 - — 获取生成式AI实例19
digitalocean-pp-cli gen-ai get-genai-19 - — 获取生成式AI实例2
digitalocean-pp-cli gen-ai get-genai-2 - — 获取生成式AI实例20
digitalocean-pp-cli gen-ai get-genai-20 - — 获取生成式AI实例21
digitalocean-pp-cli gen-ai get-genai-21 - — 获取生成式AI实例22
digitalocean-pp-cli gen-ai get-genai-22 - — 获取生成式AI实例23
digitalocean-pp-cli gen-ai get-genai-23 - — 获取生成式AI实例24
digitalocean-pp-cli gen-ai get-genai-24 - — 获取生成式AI实例25
digitalocean-pp-cli gen-ai get-genai-25 - — 获取生成式AI实例26
digitalocean-pp-cli gen-ai get-genai-26 - — 获取生成式AI实例3
digitalocean-pp-cli gen-ai get-genai-3 - — 获取生成式AI实例4
digitalocean-pp-cli gen-ai get-genai-4 - — 获取生成式AI实例5
digitalocean-pp-cli gen-ai get-genai-5 - — 获取生成式AI实例6
digitalocean-pp-cli gen-ai get-genai-6 - — 获取生成式AI实例7
digitalocean-pp-cli gen-ai get-genai-7 - — 获取生成式AI实例8
digitalocean-pp-cli gen-ai get-genai-8 - — 获取生成式AI实例9
digitalocean-pp-cli gen-ai get-genai-9 - — 列出
digitalocean-pp-cli gen-ai list - — 列出生成式AI实例
digitalocean-pp-cli gen-ai list-genai - — 列出生成式AI实例10
digitalocean-pp-cli gen-ai list-genai-10 - — 列出生成式AI实例11
digitalocean-pp-cli gen-ai list-genai-11 - — 列出生成式AI实例12
digitalocean-pp-cli gen-ai list-genai-12 - — 列出生成式AI实例13
digitalocean-pp-cli gen-ai list-genai-13 - — 列出生成式AI实例14
digitalocean-pp-cli gen-ai list-genai-14 - — 列出生成式AI实例15
digitalocean-pp-cli gen-ai list-genai-15 - — 列出生成式AI实例16
digitalocean-pp-cli gen-ai list-genai-16 - — 列出生成式AI实例17
digitalocean-pp-cli gen-ai list-genai-17 - — 列出生成式AI实例2
digitalocean-pp-cli gen-ai list-genai-2 - — 列出生成式AI实例3
digitalocean-pp-cli gen-ai list-genai-3 - — 列出生成式AI实例4
digitalocean-pp-cli gen-ai list-genai-4 - — 列出生成式AI实例5
digitalocean-pp-cli gen-ai list-genai-5 - — 列出生成式AI实例6
digitalocean-pp-cli gen-ai list-genai-6 - — 列出生成式AI实例7
digitalocean-pp-cli gen-ai list-genai-7 - — 列出生成式AI实例8
digitalocean-pp-cli gen-ai list-genai-8 - — 列出生成式AI实例9
digitalocean-pp-cli gen-ai list-genai-9 - — 更新
digitalocean-pp-cli gen-ai update - — 更新生成式AI实例
digitalocean-pp-cli gen-ai update-genai - — 更新生成式AI实例10
digitalocean-pp-cli gen-ai update-genai-10 - — 更新生成式AI实例11
digitalocean-pp-cli gen-ai update-genai-11 - — 更新生成式AI实例12
digitalocean-pp-cli gen-ai update-genai-12 - — 更新生成式AI实例13
digitalocean-pp-cli gen-ai update-genai-13 - — 更新生成式AI实例14
digitalocean-pp-cli gen-ai update-genai-14 - — 更新生成式AI实例15
digitalocean-pp-cli gen-ai update-genai-15 - — 更新生成式AI实例2
digitalocean-pp-cli gen-ai update-genai-2 - — 更新生成式AI实例3
digitalocean-pp-cli gen-ai update-genai-3 - — 更新生成式AI实例4
digitalocean-pp-cli gen-ai update-genai-4 - — 更新生成式AI实例5
digitalocean-pp-cli gen-ai update-genai-5 - — 更新生成式AI实例6
digitalocean-pp-cli gen-ai update-genai-6 - — 更新生成式AI实例7
digitalocean-pp-cli gen-ai update-genai-7 - — 更新生成式AI实例8
digitalocean-pp-cli gen-ai update-genai-8 - — 更新生成式AI实例9
digitalocean-pp-cli gen-ai update-genai-9
images — DigitalOcean的镜像可用于创建Droplet,有多种类型。目前有五种镜像类型:快照、备份、应用、发行版和自定义镜像。
-
快照是按需创建的现有Droplet实例的完整副本。
-
备份与快照类似,但启用后会定期自动创建。
-
自定义镜像是基于Linux的虚拟机镜像(支持raw、qcow2、vhdx、vdi和vmdk格式),您可上传到DigitalOcean使用。
-
发行版是可作为基础创建Droplet的公共Linux发行版。
-
应用(或一键应用)是预配置了额外软件的发行版。
通常向镜像端点发送请求来操作镜像。
/v2/images- — 创建
digitalocean-pp-cli images create - — 创建生成版本
digitalocean-pp-cli images create-generations - — 删除
digitalocean-pp-cli images delete - — 获取
digitalocean-pp-cli images get - — 列出
digitalocean-pp-cli images list - — 更新
digitalocean-pp-cli images update
kubernetes — DigitalOcean Kubernetes允许您快速部署可扩展且安全的Kubernetes集群。向端点发送请求,可列出、创建或删除集群,还可调整节点池规模、回收单个节点以及检索kubeconfig文件用于集群操作。
/v2/kubernetes/clusters- — 创建
digitalocean-pp-cli kubernetes create - — 创建集群
digitalocean-pp-cli kubernetes create-clusters - — 创建集群2
digitalocean-pp-cli kubernetes create-clusters-2 - — 创建集群3
digitalocean-pp-cli kubernetes create-clusters-3 - — 创建集群4
digitalocean-pp-cli kubernetes create-clusters-4 - — 创建容器注册表
digitalocean-pp-cli kubernetes create-registries - — 创建容器注册表
digitalocean-pp-cli kubernetes create-registry - — 删除
digitalocean-pp-cli kubernetes delete - — 删除集群
digitalocean-pp-cli kubernetes delete-clusters - — 删除集群2
digitalocean-pp-cli kubernetes delete-clusters-2 - — 删除集群3
digitalocean-pp-cli kubernetes delete-clusters-3 - — 删除集群4
digitalocean-pp-cli kubernetes delete-clusters-4 - — 删除集群5
digitalocean-pp-cli kubernetes delete-clusters-5 - — 删除容器注册表
digitalocean-pp-cli kubernetes delete-registry - — 获取
digitalocean-pp-cli kubernetes get - — 获取集群
digitalocean-pp-cli kubernetes get-clusters - — 获取集群2
digitalocean-pp-cli kubernetes get-clusters-2 - — 获取集群3
digitalocean-pp-cli kubernetes get-clusters-3 - — 获取集群4
digitalocean-pp-cli kubernetes get-clusters-4 - — 获取集群5
digitalocean-pp-cli kubernetes get-clusters-5 - — 获取集群6
digitalocean-pp-cli kubernetes get-clusters-6 - — 获取集群7
digitalocean-pp-cli kubernetes get-clusters-7 - — 获取集群8
digitalocean-pp-cli kubernetes get-clusters-8 - — 获取集群9
digitalocean-pp-cli kubernetes get-clusters-9 - — 列出
digitalocean-pp-cli kubernetes list - — 列出选项
digitalocean-pp-cli kubernetes list-options - — 更新
digitalocean-pp-cli kubernetes update - — 更新集群
digitalocean-pp-cli kubernetes update-clusters
load-balancers — DigitalOcean负载均衡器可将流量分发到多个Droplet。向端点发送请求,可列出、创建或删除负载均衡器,以及添加或移除Droplet、转发规则和其他配置细节。
/v2/load_balancers- — 创建
digitalocean-pp-cli load-balancers create - — 删除
digitalocean-pp-cli load-balancers delete - — 获取
digitalocean-pp-cli load-balancers get - — 列出
digitalocean-pp-cli load-balancers list - — 更新
digitalocean-pp-cli load-balancers update
messages — 管理消息
- — 创建
digitalocean-pp-cli messages
models — 管理模型
- — 列出
digitalocean-pp-cli models
monitoring — DigitalOcean监控API允许您以编程方式检索指标,并基于这些指标配置警报策略。监控API可帮助您了解应用的性能和资源消耗情况。
- — 创建
digitalocean-pp-cli monitoring create - — 创建接收器
digitalocean-pp-cli monitoring create-sinks - — 创建接收器2
digitalocean-pp-cli monitoring create-sinks-2 - — 创建接收器3
digitalocean-pp-cli monitoring create-sinks-3 - — 删除
digitalocean-pp-cli monitoring delete - — 删除接收器
digitalocean-pp-cli monitoring delete-sinks - — 删除接收器2
digitalocean-pp-cli monitoring delete-sinks-2 - — 获取
digitalocean-pp-cli monitoring get - — 获取接收器
digitalocean-pp-cli monitoring get-sinks - — 获取接收器2
digitalocean-pp-cli monitoring get-sinks-2 - — 列出
digitalocean-pp-cli monitoring list - — 列出指标
digitalocean-pp-cli monitoring list-metrics - — 列出指标10
digitalocean-pp-cli monitoring list-metrics-10 - — 列出指标11
digitalocean-pp-cli monitoring list-metrics-11 - — 列出指标12
digitalocean-pp-cli monitoring list-metrics-12 - — 列出指标13
digitalocean-pp-cli monitoring list-metrics-13 - — 列出指标14
digitalocean-pp-cli monitoring list-metrics-14 - — 列出指标15
digitalocean-pp-cli monitoring list-metrics-15 - — 列出指标16
digitalocean-pp-cli monitoring list-metrics-16 - — 列出指标17
digitalocean-pp-cli monitoring list-metrics-17 - — 列出指标18
digitalocean-pp-cli monitoring list-metrics-18 - — 列出指标19
digitalocean-pp-cli monitoring list-metrics-19 - — 列出指标2
digitalocean-pp-cli monitoring list-metrics-2 - — 列出指标20
digitalocean-pp-cli monitoring list-metrics-20 - — 列出指标21
digitalocean-pp-cli monitoring list-metrics-21 - — 列出指标22
digitalocean-pp-cli monitoring list-metrics-22 - — 列出指标23
digitalocean-pp-cli monitoring list-metrics-23 - — 列出指标24
digitalocean-pp-cli monitoring list-metrics-24 - — 列出指标25
digitalocean-pp-cli monitoring list-metrics-25 - — 列出指标26
digitalocean-pp-cli monitoring list-metrics-26 - — 列出指标27
digitalocean-pp-cli monitoring list-metrics-27 - — 列出指标28
digitalocean-pp-cli monitoring list-metrics-28 - — 列出指标29
digitalocean-pp-cli monitoring list-metrics-29 - — 列出指标3
digitalocean-pp-cli monitoring list-metrics-3 - — 列出指标30
digitalocean-pp-cli monitoring list-metrics-30 - — 列出指标31
digitalocean-pp-cli monitoring list-metrics-31 - — 列出指标32
digitalocean-pp-cli monitoring list-metrics-32 - — 列出指标33
digitalocean-pp-cli monitoring list-metrics-33 - — 列出指标34
digitalocean-pp-cli monitoring list-metrics-34 - — 列出指标35
digitalocean-pp-cli monitoring list-metrics-35 - — 列出指标36
digitalocean-pp-cli monitoring list-metrics-36 - — 列出指标37
digitalocean-pp-cli monitoring list-metrics-37 - — 列出指标38
digitalocean-pp-cli monitoring list-metrics-38 - — 列出指标39
digitalocean-pp-cli monitoring list-metrics-39 - — 列出指标4
digitalocean-pp-cli monitoring list-metrics-4 - — 列出指标40
digitalocean-pp-cli monitoring list-metrics-40 - — 列出指标41
digitalocean-pp-cli monitoring list-metrics-41 - — 列出指标42
digitalocean-pp-cli monitoring list-metrics-42 - — 列出指标43
digitalocean-pp-cli monitoring list-metrics-43 - — 列出指标44
digitalocean-pp-cli monitoring list-metrics-44 - — 列出指标45
digitalocean-pp-cli monitoring list-metrics-45 - — 列出指标46
digitalocean-pp-cli monitoring list-metrics-46 - — 列出指标47
digitalocean-pp-cli monitoring list-metrics-47 - — 列出指标48
digitalocean-pp-cli monitoring list-metrics-48 - — 列出指标49
digitalocean-pp-cli monitoring list-metrics-49 - — 列出指标5
digitalocean-pp-cli monitoring list-metrics-5 - — 列出指标50
digitalocean-pp-cli monitoring list-metrics-50 - — 列出指标51
digitalocean-pp-cli monitoring list-metrics-51 - — 列出指标52
digitalocean-pp-cli monitoring list-metrics-52 - — 列出指标53
digitalocean-pp-cli monitoring list-metrics-53 - — 列出指标54
digitalocean-pp-cli monitoring list-metrics-54 - — 列出指标55
digitalocean-pp-cli monitoring list-metrics-55 - — 列出指标56
digitalocean-pp-cli monitoring list-metrics-56 - — 列出指标57
digitalocean-pp-cli monitoring list-metrics-57 - — 列出指标58
digitalocean-pp-cli monitoring list-metrics-58 - — 列出指标6
digitalocean-pp-cli monitoring list-metrics-6 - — 列出指标7
digitalocean-pp-cli monitoring list-metrics-7 - — 列出指标8
digitalocean-pp-cli monitoring list-metrics-8 - — 列出指标9
digitalocean-pp-cli monitoring list-metrics-9 - — 列出接收器
digitalocean-pp-cli monitoring list-sinks - — 列出接收器2
digitalocean-pp-cli monitoring list-sinks-2 - — 更新
digitalocean-pp-cli monitoring update
nfs — NFS允许您创建完全托管、符合POSIX标准的网络文件存储,在VPC内提供安全、高性能的共享存储,实现VPC内Droplet之间的无缝数据共享。
- — 创建
digitalocean-pp-cli nfs create - — 删除
digitalocean-pp-cli nfs delete - — 删除快照
digitalocean-pp-cli nfs delete-snapshots - — 获取
digitalocean-pp-cli nfs get - — 获取快照
digitalocean-pp-cli nfs get-snapshots - — 列出
digitalocean-pp-cli nfs list - — 列出快照
digitalocean-pp-cli nfs list-snapshots
partner-network-connect — 合作伙伴网络连接允许您在DigitalOcean VPC网络与其他公有云提供商或本地数据中心之间建立高带宽、低延迟的网络连接。
- — 创建
digitalocean-pp-cli partner-network-connect create - — 创建合作伙伴网络连接
digitalocean-pp-cli partner-network-connect create-partnernetworkconnect - — 删除
digitalocean-pp-cli partner-network-connect delete - — 获取
digitalocean-pp-cli partner-network-connect get - — 获取合作伙伴网络连接
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect - — 获取合作伙伴网络连接2
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect-2 - — 获取合作伙伴网络连接3
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect-3 - — 列出
digitalocean-pp-cli partner-network-connect list - — 更新
digitalocean-pp-cli partner-network-connect update
projects — 项目允许您将资源分组以适配您的工作方式。您可将资源(如Droplet、Spaces、负载均衡器、域名和浮动IP)按托管在DigitalOcean上的应用进行分组。
- — 创建
digitalocean-pp-cli projects create - — 创建默认项目
digitalocean-pp-cli projects create-default - — 删除
digitalocean-pp-cli projects delete - — 获取
digitalocean-pp-cli projects get - — 列出
digitalocean-pp-cli projects list - — 列出默认项目
digitalocean-pp-cli projects list-default - — 列出默认项目2
digitalocean-pp-cli projects list-default-2 - — 更新
digitalocean-pp-cli projects update - — 更新默认项目
digitalocean-pp-cli projects update-default - — 更新指定ID的项目
digitalocean-pp-cli projects update-projectid - — 更新指定ID的项目2
digitalocean-pp-cli projects update-projectid-2
regions — 提供DigitalOcean数据中心区域信息
- — 列出
digitalocean-pp-cli regions
registries — 管理容器注册表
- — 创建
digitalocean-pp-cli registries create - — 创建订阅
digitalocean-pp-cli registries create-subscription - — 验证名称
digitalocean-pp-cli registries create-validatename - — 删除
digitalocean-pp-cli registries delete - — 获取
digitalocean-pp-cli registries get - — 列出
digitalocean-pp-cli registries list - — 列出选项
digitalocean-pp-cli registries list-options - — 列出订阅
digitalocean-pp-cli registries list-subscription
registry — 管理容器注册表
- — 创建
digitalocean-pp-cli registry create - — 创建订阅
digitalocean-pp-cli registry create-subscription - — 验证名称
digitalocean-pp-cli registry create-validatename - — 删除
digitalocean-pp-cli registry delete - — 列出
digitalocean-pp-cli registry list - — 列出Docker凭证
digitalocean-pp-cli registry list-dockercredentials - — 列出选项
digitalocean-pp-cli registry list-options - — 列出订阅
digitalocean-pp-cli registry list-subscription
reports — 管理报告
- — 列出
digitalocean-pp-cli reports
reserved-ips — 自2022年6月16日起,我们已将Floating IP产品更名为预留IP(Reserved IPs)。预留IP产品的端点功能与Floating IP完全相同,唯一区别是URL和字段中的名称变更,例如字段现在变为字段。Floating IP端点将在2023年秋季前保持可用,之后将永久弃用。
floating_ipsreserved_ips除项目API外,我们会在API响应中添加额外字段以反映此变更,例如Droplet元数据响应将同时包含和字段。通过项目API检索到的Floating IP将保留原名称。
reserved_ipsfloating_ipsDigitalOcean预留IP是可映射到您的Droplet的公共静态IP地址,可用于创建高可用设置或其他需要可移动地址的配置。
预留IP绑定到特定区域。
- — 创建
digitalocean-pp-cli reserved-ips create - — 删除
digitalocean-pp-cli reserved-ips delete - — 获取
digitalocean-pp-cli reserved-ips get - — 列出
digitalocean-pp-cli reserved-ips list
reserved-ipv6 — DigitalOcean预留IPv6是可映射到您的Droplet的公共静态IP地址,可用于创建高可用设置或其他需要可移动地址的配置。
预留IPv6绑定到特定区域。
- — 创建
digitalocean-pp-cli reserved-ipv6 create - — 删除
digitalocean-pp-cli reserved-ipv6 delete - — 获取
digitalocean-pp-cli reserved-ipv6 get - — 列出
digitalocean-pp-cli reserved-ipv6 list
responses — 管理响应
- — 创建
digitalocean-pp-cli responses
security — 安全CSPM端点,用于扫描、扫描结果和设置管理。
- — 创建
digitalocean-pp-cli security create - — 创建扫描
digitalocean-pp-cli security create-scans - — 创建设置
digitalocean-pp-cli security create-settings - — 删除
digitalocean-pp-cli security delete - — 获取
digitalocean-pp-cli security get - — 获取扫描结果
digitalocean-pp-cli security get-scans - — 列出
digitalocean-pp-cli security list - — 列出扫描结果
digitalocean-pp-cli security list-scans - — 列出设置
digitalocean-pp-cli security list-settings - — 更新
digitalocean-pp-cli security update
sizes — 规格对象代表可用于Droplet的不同硬件资源套餐。创建Droplet时必须选择规格,以便分配正确的资源。
每个规格代表一个捆绑了特定资源集的方案,包括RAM容量、虚拟CPU数量、磁盘空间和流量。规格对象还包含定价详情和该规格可用的区域。
- — 列出
digitalocean-pp-cli sizes
snapshots — 快照是Droplet或块存储卷的保存实例,属性会反映这一点。为避免文件系统压缩问题,每个快照定义了属性,即从保存的快照创建新资源时Droplet或卷磁盘的最小大小。
resource_typemin_disk_size通常向快照端点发送请求来操作快照。
/v2/snapshots- — 删除
digitalocean-pp-cli snapshots delete - — 获取
digitalocean-pp-cli snapshots get - — 列出
digitalocean-pp-cli snapshots list
spaces — 管理Spaces存储
- — 创建
digitalocean-pp-cli spaces create - — 删除
digitalocean-pp-cli spaces delete - — 获取
digitalocean-pp-cli spaces get - — 列出
digitalocean-pp-cli spaces list - — 更新
digitalocean-pp-cli spaces update - — 更新密钥
digitalocean-pp-cli spaces update-keys
tags — 标签是可应用于资源(目前支持Droplet、镜像、卷、卷快照和数据库集群)的标签,用于更好地组织资源或便于查找和操作。
标签有两个属性:用户定义的属性和包含已标记资源信息的嵌入式属性。
nameresources- — 创建
digitalocean-pp-cli tags create - — 删除
digitalocean-pp-cli tags delete - — 获取
digitalocean-pp-cli tags get - — 列出
digitalocean-pp-cli tags list
upload-url — 管理上传URL
- — 更新
digitalocean-pp-cli upload-url
uptime — DigitalOcean正常运行时间检查允许您从全球各地监控端点,并在端点缓慢、不可用或SSL证书即将过期时发出警报。
通常向正常运行时间端点发送请求来操作正常运行时间检查。
/v2/uptime/- — 创建
digitalocean-pp-cli uptime create - — 创建检查
digitalocean-pp-cli uptime create-checks - — 删除
digitalocean-pp-cli uptime delete - — 删除检查
digitalocean-pp-cli uptime delete-checks - — 获取
digitalocean-pp-cli uptime get - — 获取检查
digitalocean-pp-cli uptime get-checks - — 获取检查2
digitalocean-pp-cli uptime get-checks-2 - — 获取检查3
digitalocean-pp-cli uptime get-checks-3 - — 列出
digitalocean-pp-cli uptime list - — 更新
digitalocean-pp-cli uptime update - — 更新检查
digitalocean-pp-cli uptime update-checks
volumes — 管理块存储卷
- — 创建
digitalocean-pp-cli volumes create - — 创建操作
digitalocean-pp-cli volumes create-actions - — 删除
digitalocean-pp-cli volumes delete - — 删除快照
digitalocean-pp-cli volumes delete-snapshots - — 删除指定ID的卷
digitalocean-pp-cli volumes delete-volumeid - — 获取
digitalocean-pp-cli volumes get - — 获取快照
digitalocean-pp-cli volumes get-snapshots - — 列出
digitalocean-pp-cli volumes list
vpc-nat-gateways — VPC NAT网关允许私有VPC内的资源访问公共互联网,同时不会暴露于入站流量。
向端点发送请求,可创建、配置、列出和删除VPC NAT网关,以及检索分配给它们的资源信息。
/v2/vpc_nat_gateways- — 创建
digitalocean-pp-cli vpc-nat-gateways create - — 删除
digitalocean-pp-cli vpc-nat-gateways delete - — 获取
digitalocean-pp-cli vpc-nat-gateways get - — 列出
digitalocean-pp-cli vpc-nat-gateways list - — 更新
digitalocean-pp-cli vpc-nat-gateways update
vpc-peerings — VPC对等连接通过安全的私有连接连接两个VPC网络,允许这些网络中的资源通过私有IP地址相互连接,就像在同一网络中一样。
- — 创建
digitalocean-pp-cli vpc-peerings create - — 删除
digitalocean-pp-cli vpc-peerings delete - — 获取
digitalocean-pp-cli vpc-peerings get - — 列出
digitalocean-pp-cli vpc-peerings list - — 更新
digitalocean-pp-cli vpc-peerings update
vpcs — VPC(虚拟私有云)允许您创建包含资源的虚拟网络,这些资源可使用私有IP地址完全隔离地相互通信。
向端点发送请求,可创建、配置、列出和删除自定义VPC,以及检索分配给它们的资源信息。
/v2/vpcs- — 创建
digitalocean-pp-cli vpcs create - — 删除
digitalocean-pp-cli vpcs delete - — 获取
digitalocean-pp-cli vpcs get - — 列出
digitalocean-pp-cli vpcs list - — 更新
digitalocean-pp-cli vpcs update - — 更新指定ID的VPC
digitalocean-pp-cli vpcs update-vpcid
Finding the right command
查找合适的命令
When you know what you want to do but not which command does it, ask the CLI directly:
bash
digitalocean-pp-cli which "<capability in your own words>"which02--help当您知道要执行的操作但不知道对应的命令时,可直接询问CLI:
bash
digitalocean-pp-cli which "<用您自己的语言描述功能>"which02--helpAuth Setup
认证设置
Store your access token:
bash
digitalocean-pp-cli auth set-token YOUR_TOKEN_HEREOr set as an environment variable.
DIGITALOCEAN_BEARER_AUTHRun to verify setup.
digitalocean-pp-cli doctor存储您的访问令牌:
bash
digitalocean-pp-cli auth set-token YOUR_TOKEN_HERE或者将设置为环境变量。
DIGITALOCEAN_BEARER_AUTH运行验证设置是否正确。
digitalocean-pp-cli doctorAgent Mode
Agent模式
Add to any command. Expands to: .
--agent--json --compact --no-input --no-color --yes-
Pipeable — JSON on stdout, errors on stderr
-
Filterable —keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
--selectbashdigitalocean-pp-cli 1-clicks list --agent --select id,name,status -
Previewable —shows the request without sending
--dry-run -
Offline-friendly — sync/search commands can use the local SQLite store when available
-
Non-interactive — never prompts, every input is a flag
-
Explicit retries — useonly when an already-existing create should count as success, and
--idempotentonly when a missing delete target should count as success--ignore-missing
在任何命令后添加参数,等效于:。
--agent--json --compact --no-input --no-color --yes-
可管道化 — 标准输出为JSON,错误输出到标准错误
-
可过滤 —参数保留字段子集,点路径可深入嵌套结构;数组会遍历每个元素。对于冗长的API,这是缩小上下文范围的关键:
--selectbashdigitalocean-pp-cli 1-clicks list --agent --select id,name,status -
可预览 —参数显示请求但不发送
--dry-run -
离线友好 — 同步/搜索命令在本地SQLite存储可用时可使用该存储
-
非交互式 — 从不提示,所有输入均为标志参数
-
显式重试 — 仅当已存在的创建操作应视为成功时使用;仅当缺失的删除目标应视为成功时使用
--idempotent--ignore-missing
Response envelope
响应信封
Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}Parse for data and to know whether it's live or local. A human-readable summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
.results.meta.sourceN results (live)从本地存储或API读取数据的命令会将输出包装在来源信封中:
json
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}解析获取数据,表示数据是实时的还是本地的。仅当标准输出为终端时,才会向标准错误打印人类可读的摘要;管道/Agent消费者会在标准输出获取纯JSON。
.results.meta.sourceN results (live)Agent Feedback
Agent反馈
When you (or the agent) notice something off about this CLI, record it:
digitalocean-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
digitalocean-pp-cli feedback --stdin < notes.txt
digitalocean-pp-cli feedback list --json --limit 10Entries are stored locally at . They are never POSTed unless is set AND either is passed or . Default behavior is local-only.
~/.digitalocean-pp-cli/feedback.jsonlDIGITALOCEAN_FEEDBACK_ENDPOINT--sendDIGITALOCEAN_FEEDBACK_AUTO_SEND=trueWrite what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您(或Agent)发现该CLI存在问题时,可记录反馈:
digitalocean-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
digitalocean-pp-cli feedback --stdin < notes.txt
digitalocean-pp-cli feedback list --json --limit 10反馈条目存储在本地文件中,除非设置了且传递了参数或设置了,否则不会发送。默认行为是仅本地存储。
~/.digitalocean-pp-cli/feedback.jsonlDIGITALOCEAN_FEEDBACK_ENDPOINT--sendDIGITALOCEAN_FEEDBACK_AUTO_SEND=true请记录让您感到意外的内容,而非编写错误报告。简短、具体、单行描述:这部分内容会不断累积。
Output Delivery
输出交付
Every command accepts . The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
--deliver <sink>| Sink | Effect |
|---|---|
| Default; write to stdout only |
| Atomically write output to |
| POST the output body to the URL ( |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都接受参数,输出会发送到指定的接收器,同时(或替代)输出到标准输出,以便Agent无需手动管道即可路由命令结果。支持三种接收器:
--deliver <sink>| 接收器 | 效果 |
|---|---|
| 默认;仅输出到标准输出 |
| 原子性地将输出写入 |
| 将输出体POST到指定URL(当使用 |
未知的协议会被拒绝,并返回结构化错误说明支持的接收器集合。Webhook失败会返回非零退出码,并在标准错误中记录URL和HTTP状态码。
Named Profiles
命名配置文件
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
digitalocean-pp-cli profile save briefing --json
digitalocean-pp-cli --profile briefing 1-clicks list
digitalocean-pp-cli profile list --json
digitalocean-pp-cli profile show briefing
digitalocean-pp-cli profile delete briefing --yesExplicit flags always win over profile values; profile values win over defaults. lists all available profiles under so introspecting agents discover them at runtime.
agent-contextavailable_profiles配置文件是一组保存的标志值,可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时,可使用此功能(即HeyGen的“Beacon”模式)。
digitalocean-pp-cli profile save briefing --json
digitalocean-pp-cli --profile briefing 1-clicks list
digitalocean-pp-cli profile list --json
digitalocean-pp-cli profile show briefing
digitalocean-pp-cli profile delete briefing --yes显式标志始终优先于配置文件值;配置文件值优先于默认值。命令会在下列出所有可用配置文件,以便自省Agent在运行时发现它们。
agent-contextavailable_profilesExit Codes
退出码
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
| 代码 | 含义 |
|---|---|
| 0 | 成功 |
| 2 | 使用错误(参数错误) |
| 3 | 资源未找到 |
| 4 | 需要认证 |
| 5 | API错误(上游问题) |
| 7 | 速率限制(等待并重试) |
| 10 | 配置错误 |
Argument Parsing
参数解析
Parse :
$ARGUMENTS- Empty, , or
help→ show--helpoutputdigitalocean-pp-cli --help - Starts with → ends with
install→ MCP installation; otherwise → see Prerequisites abovemcp - Anything else → Direct Use (execute as CLI command with )
--agent
解析:
$ARGUMENTS- 为空、或
help→ 显示--help输出digitalocean-pp-cli --help - 以开头 → 以
install结尾 → 安装MCP;否则 → 参见顶部的前提条件mcp - 其他情况 → 直接使用(以标志执行CLI命令)
--agent
MCP Server Installation
MCP服务器安装
- Install the MCP server:
bash
go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-mcp@latest - Register with Claude Code:
bash
claude mcp add digitalocean-pp-mcp -- digitalocean-pp-mcp - Verify:
claude mcp list
- 安装MCP服务器:
bash
go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-mcp@latest - 注册到Claude Code:
bash
claude mcp add digitalocean-pp-mcp -- digitalocean-pp-mcp - 验证:
claude mcp list
Direct Use
直接使用
- Check if installed: If not found, offer to install (see Prerequisites at the top of this skill).
which digitalocean-pp-cli - Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the flag:
--agentbashdigitalocean-pp-cli <command> [subcommand] [args] --agent - If ambiguous, drill into subcommand help: .
digitalocean-pp-cli <command> --help
- 检查是否已安装:若未找到,提供安装选项(参见顶部的前提条件)。
which digitalocean-pp-cli - 将用户查询与上述独特功能和命令参考中最匹配的命令进行匹配。
- 使用标志执行命令:
--agentbashdigitalocean-pp-cli <command> [subcommand] [args] --agent - 若存在歧义,查看子命令帮助:。
digitalocean-pp-cli <command> --help