pp-digitalocean

Name: pp-digitalocean
Author: mvanhorn

github.com/mvanhornクラウド・DevOps2.1k66 回インストール今日更新

リポジトリ

pp-digitalocean について

pp-digitaloceanは、DigitalOceanのリソース管理をAgentから行うPrinting Pressのコマンドラインスキルです。リソース操作に加え、ローカル保存、検索、分析、変更フィードを備えています。

主な機能

01リソースをSQLiteにローカル保存
02同期済みデータとライブデータを検索
03条件別にリソースデータを集計
04変更をNDJSON形式で配信
05DigitalOceanアカウントのリソース管理

活用シーン

01クラウド変更前にオフライン一覧を作成
02キーワードに一致するリソースを検索
03リージョン別にDropletを集計
04リソースの変更を継続的に監視

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-digitalocean

インストール後、Claude Code で/pp-digitaloceanを入力して読み込まれたか確認します。

詳細

Digitalocean — Printing Press CLI

前提条件：CLI をインストールする

このスキルは digitalocean-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールしてください。

Printing Press インストーラーを使ってインストールします。macOS/Linux では既定で $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。
```
npx -y @mvanhorn/printing-press-library install digitalocean --cli-only
```
確認します：digitalocean-pp-cli --version
表示されたインストール先のディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-cli@latest

インストール後に --version が「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認に成功するまで、スキルのコマンドを実行しないでください。

独自の機能

これらの機能は、この API のほかのツールでは利用できません。

蓄積されるローカル状態

workflow archive — DigitalOcean のリソースをローカルの SQLite ストアに同期し、オフラインでの確認や再現可能なエージェントのワークフローに利用できます。

クラウドの変更を計画する前に、エージェントが永続的なローカルインベントリを作成できます。
```
digitalocean-pp-cli workflow archive --full --json
```
search — 同期済みの DigitalOcean データをローカルで検索します。エージェントが使いやすいデータ取得のために、ライブ／ローカルの検索元を選択できます。

より対象を絞ったコマンドを選ぶ前に、エージェントが関連するリソースを見つけられます。
```
digitalocean-pp-cli search "production" --data-source local --json --limit 20
```

運用サマリー

analytics — ローカルに同期されたリソースデータを、件数やグループ化の操作で要約します。

リソース一覧を、エージェントが判断に活用できる運用サマリーに変換します。
```
digitalocean-pp-cli analytics --type droplets --group-by region --json
```
tail — 選択したリソースをポーリングし、変更イベントを NDJSON 形式でシェルやエージェントのパイプラインに出力します。

専用スクリプトを作成することなく、安全な単発または継続的な変更フィードを提供します。
```
digitalocean-pp-cli tail --resource droplets --interval 30s --json
```

コマンドリファレンス

1-clicks — 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 は floating_ips スタンザの代わりに reserved_ips スタンザを返します。

Accept: application/vnd.digitalocean.reserveip+json
digitalocean-pp-cli actions get — 取得
digitalocean-pp-cli actions list — 一覧表示

add-ons — アドオンは、DigitalOcean アカウントに追加できるサードパーティ製アプリケーションです。 DigitalOcean Marketplace から利用できます。アドオンを使うと、既存のリソースの機能を強化したり、追加サービスを利用したりできます。

Add-Ons 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 が提供する Platform-as-a-Service (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 — 請求エンドポイントを使用すると、アカウントの残高、請求書、請求履歴、インサイトを取得できます。

残高: /v2/customers/my/balance エンドポイントにリクエストを送信することで、対象の顧客アカウントの残高情報を取得できます。

請求書: 請求書は、DigitalOcean のすべての顧客に対して毎月 1 日に生成されます。請求書のプレビューは毎日生成され、$INVOICE_UUID の代わりに preview キーワードを使用してアクセスできます。請求書を操作するには、通常 /v2/customers/my/invoices の請求書エンドポイントにリクエストを送信します。

請求履歴: 請求履歴は、アカウントの請求イベントの記録です。たとえば、エントリには支払いの実行、請求書の発行、クレジットの付与などのイベントが含まれる場合があります。請求書を操作するには、通常 /v2/customers/my/billing_history の請求書エンドポイントにリクエストを送信します。

請求インサイト: 夜間の請求項目に基づく、請求リソース使用量の前日比の変化です。指定した日付範囲の合計金額、リージョン、SKU、説明が含まれます。夜間の請求項目は 1 か月全体のすべての請求要因を必ずしも網羅しているわけではないため、特定の月の日次のリソース使用量を合計しても、月末の請求総額を反映しない場合があることに注意することが重要です。 v2/billing/{account_urn}/insights/{start_date}/{end_date} ここで account_urn は顧客アカウントの URN であり、チーム (do:team:uuid) または組織 (do:teamgroup:uuid) を指定できます。start_date と end_date で指定する日付範囲は YYYY-MM-DD 形式である必要があります。

byoip-prefixes — Bring your own IP (BYOIP) を使用すると、独自の IPv4 ネットワークプレフィックスをアカウントにプロビジョニングし、それらの IP を DigitalOcean のリソースに割り当てることができます。 BYOIP は以下の機能をサポートしています:

IPv4 アドレス
/24 (256 アドレス) から /18 (16,384 アドレス) までの任意のネットワークサイズ
既存の予約 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 証明書管理を 2 種類提供しています。

カスタム：ユーザーが生成した証明書を DigitalOcean にアップロードできます。証明書は、完全に暗号化され隔離されたストレージシステムに保存されます。
Let's Encrypt：無料のオープンな認証局である Let's Encrypt との統合を利用して、 DigitalOcean が証明書を自動的に生成できます。これらの証明書も、必要に応じて自動的に更新されます。

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 — 自分の情報を取得
digitalocean-pp-cli customers get-my-2 — 自分の情報を取得 2
digitalocean-pp-cli customers get-my-3 — 自分の情報を取得 3
digitalocean-pp-cli customers list — 一覧表示
digitalocean-pp-cli customers list-my — 自分の情報を一覧表示
digitalocean-pp-cli customers list-my-2 — 自分の情報を一覧表示 2

databases — DigitalOcean のマネージドデータベースサービスは、可用性の高いデータベースクラスターの作成と管理を簡素化します。現在、 PostgreSQL、キャッシュ、 Valkey、 MySQL、 MongoDB、および OpenSearchに対応しています。

/v2/databases エンドポイントにリクエストを送信すると、データベースクラスターの一覧表示、作成、削除に加え、クラスターのサイズ変更、読み取り専用レプリカの追加や削除、その他の設定詳細の管理を行えます。

データベースクラスターは、マルチノードの高可用性構成でデプロイできます。マシンタイプがベーシックノードより上位の場合、ノードプランが最小のオプションより上位の場合、または MongoDB を実行している場合は、クラスターに最大 2 台のスタンバイノードを追加できます。

データベースクラスター内の個々のノードのサイズは、人が読みやすいスラッグで表され、以下の一部のリクエストで使用されます。各スラッグは、ノードの識別子、CPU 数、RAM 容量の順に示します。

現在利用可能なデータベースのスラッグとオプションの一覧を確認するには、/v2/databases/options エンドポイントを使用するか、 doctl 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 — Dedicated Inference は、DigitalOcean 上でスケーラブルな本番環境向け LLM ホスティングを提供します。Dedicated Inference インスタンスの作成、一覧表示、取得、更新、削除を行い、アクセラレーター、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 — dedicatedinferences を一覧表示
digitalocean-pp-cli dedicated-inferences list-dedicatedinferences-2 — dedicatedinferences 2 を一覧表示
digitalocean-pp-cli dedicated-inferences update — 更新

domains — ドメインリソースは、ドメイン名レジストラーから購入し、 DigitalOcean DNS interface を通じて管理しているドメイン名です。

このリソースでは、各ドメインをトップレベルで管理できます。個々のドメインレコードに影響する操作は、 Domain Records リソースで行ってください。

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 の一覧表示、作成、削除を行えます。

属性の一部はオブジェクト値を持ちます。region オブジェクトと image オブジェクトには、それぞれ対応する型の標準属性が含まれます。これらの各オブジェクトの詳細については、それぞれのセクションを参照してください。

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 — オートスケールを削除
digitalocean-pp-cli droplets delete-autoscale-2 — オートスケール 2 を削除
digitalocean-pp-cli droplets delete-dropletid — dropletid を削除
digitalocean-pp-cli droplets get — 取得
digitalocean-pp-cli droplets get-autoscale — オートスケールを取得
digitalocean-pp-cli droplets get-autoscale-2 — オートスケール 2 を取得
digitalocean-pp-cli droplets get-autoscale-3 — オートスケール 3 を取得
digitalocean-pp-cli droplets list — 一覧表示
digitalocean-pp-cli droplets list-autoscale — オートスケールを一覧表示
digitalocean-pp-cli droplets list-backups — バックアップを一覧表示
digitalocean-pp-cli droplets list-backups-2 — バックアップ 2 を一覧表示
digitalocean-pp-cli droplets update — 更新

embeddings — Serverless Inference のベース URL https://inference.do-ai.run に対する POST /v1/embeddings によるテキスト埋め込みベクトル（ベアラーモデルアクセストークン）。

digitalocean-pp-cli embeddings — 作成

firewalls — DigitalOcean Cloud Firewalls を使用すると、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 製品の名称をReserved IPに変更しました。 Reserved IP 製品のエンドポイントは、Floating IP とまったく同じように機能します。異なるのは、URL とフィールド全体で名称が変更された点のみです。たとえば、floating_ips フィールドは reserved_ips フィールドになりました。 Floating IP のエンドポイントは、2023年秋に完全に廃止されるまで引き続き利用できます。

Projects APIを除き、API 全体で floating_ip フィールドが使われているレスポンスに、この変更を追加フィールドとして反映します。たとえば、Droplet メタデータのレスポンスには、floating_ips フィールドに加えて reserved_ips フィールドが含まれます。 Projects API を使用して取得した Floating IP は、従来の名称のままです。

DigitalOcean Floating IPは、Droplet のいずれかに割り当てられる、パブリックアクセス可能な静的 IP アドレスです。高可用性の構成や、移動可能なアドレスを必要とするその他の構成に使用できます。

Floating IP は特定のリージョンに紐付けられます。

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 — サーバーレス関数は、インフラストラクチャを管理せずに、必要に応じて実行できるコードブロックです。ローカルマシンで関数を開発し、doctl（DigitalOcean 公式 CLI ツール）を使ってネームスペースにデプロイできます。

Serverless Functions API では、現在、ネームスペースの作成と管理のみをサポートしています。

digitalocean-pp-cli functions create — 作成
digitalocean-pp-cli functions create-namespaces — ネームスペースを作成
digitalocean-pp-cli functions create-namespaces-2 — ネームスペースを作成 2
digitalocean-pp-cli functions delete — 削除
digitalocean-pp-cli functions delete-namespaces — ネームスペースを削除
digitalocean-pp-cli functions delete-namespaces-2 — ネームスペースを削除 2
digitalocean-pp-cli functions get — 取得
digitalocean-pp-cli functions get-namespaces — ネームスペースを取得
digitalocean-pp-cli functions get-namespaces-2 — ネームスペースを取得 2
digitalocean-pp-cli functions get-namespaces-3 — ネームスペースを取得 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 — Create
digitalocean-pp-cli gen-ai create-genai — Create genai
digitalocean-pp-cli gen-ai create-genai-10 — Create genai 10
digitalocean-pp-cli gen-ai create-genai-11 — Create genai 11
digitalocean-pp-cli gen-ai create-genai-12 — Create genai 12
digitalocean-pp-cli gen-ai create-genai-13 — Create genai 13
digitalocean-pp-cli gen-ai create-genai-14 — Create genai 14
digitalocean-pp-cli gen-ai create-genai-15 — Create genai 15
digitalocean-pp-cli gen-ai create-genai-16 — Create genai 16
digitalocean-pp-cli gen-ai create-genai-17 — Create genai 17
digitalocean-pp-cli gen-ai create-genai-18 — Create genai 18
digitalocean-pp-cli gen-ai create-genai-19 — Create genai 19
digitalocean-pp-cli gen-ai create-genai-2 — Create genai 2
digitalocean-pp-cli gen-ai create-genai-20 — Create genai 20
digitalocean-pp-cli gen-ai create-genai-21 — Create genai 21
digitalocean-pp-cli gen-ai create-genai-22 — Create genai 22
digitalocean-pp-cli gen-ai create-genai-23 — Create genai 23
digitalocean-pp-cli gen-ai create-genai-24 — Create genai 24
digitalocean-pp-cli gen-ai create-genai-3 — Create genai 3
digitalocean-pp-cli gen-ai create-genai-4 — Create genai 4
digitalocean-pp-cli gen-ai create-genai-5 — Create genai 5
digitalocean-pp-cli gen-ai create-genai-6 — Create genai 6
digitalocean-pp-cli gen-ai create-genai-7 — Create genai 7
digitalocean-pp-cli gen-ai create-genai-8 — Create genai 8
digitalocean-pp-cli gen-ai create-genai-9 — Create genai 9
digitalocean-pp-cli gen-ai delete — Delete
digitalocean-pp-cli gen-ai delete-genai — Delete genai
digitalocean-pp-cli gen-ai delete-genai-10 — Delete genai 10
digitalocean-pp-cli gen-ai delete-genai-11 — Delete genai 11
digitalocean-pp-cli gen-ai delete-genai-12 — Delete genai 12
digitalocean-pp-cli gen-ai delete-genai-13 — Delete genai 13
digitalocean-pp-cli gen-ai delete-genai-2 — Delete genai 2
digitalocean-pp-cli gen-ai delete-genai-3 — Delete genai 3
digitalocean-pp-cli gen-ai delete-genai-4 — Delete genai 4
digitalocean-pp-cli gen-ai delete-genai-5 — Delete genai 5
digitalocean-pp-cli gen-ai delete-genai-6 — Delete genai 6
digitalocean-pp-cli gen-ai delete-genai-7 — Delete genai 7
digitalocean-pp-cli gen-ai delete-genai-8 — Delete genai 8
digitalocean-pp-cli gen-ai delete-genai-9 — Delete genai 9
digitalocean-pp-cli gen-ai get — Get
digitalocean-pp-cli gen-ai get-genai — Get genai
digitalocean-pp-cli gen-ai get-genai-10 — Get genai 10
digitalocean-pp-cli gen-ai get-genai-11 — Get genai 11
digitalocean-pp-cli gen-ai get-genai-12 — Get genai 12
digitalocean-pp-cli gen-ai get-genai-13 — Get genai 13
digitalocean-pp-cli gen-ai get-genai-14 — Get genai 14
digitalocean-pp-cli gen-ai get-genai-15 — Get genai 15
digitalocean-pp-cli gen-ai get-genai-16 — Get genai 16
digitalocean-pp-cli gen-ai get-genai-17 — Get genai 17
digitalocean-pp-cli gen-ai get-genai-18 — Get genai 18
digitalocean-pp-cli gen-ai get-genai-19 — Get genai 19
digitalocean-pp-cli gen-ai get-genai-2 — Get genai 2
digitalocean-pp-cli gen-ai get-genai-20 — Get genai 20
digitalocean-pp-cli gen-ai get-genai-21 — Get genai 21
digitalocean-pp-cli gen-ai get-genai-22 — Get genai 22
digitalocean-pp-cli gen-ai get-genai-23 — Get genai 23
digitalocean-pp-cli gen-ai get-genai-24 — Get genai 24
digitalocean-pp-cli gen-ai get-genai-25 — Get genai 25
digitalocean-pp-cli gen-ai get-genai-26 — Get genai 26
digitalocean-pp-cli gen-ai get-genai-3 — Get genai 3
digitalocean-pp-cli gen-ai get-genai-4 — Get genai 4
digitalocean-pp-cli gen-ai get-genai-5 — Get genai 5
digitalocean-pp-cli gen-ai get-genai-6 — Get genai 6
digitalocean-pp-cli gen-ai get-genai-7 — Get genai 7
digitalocean-pp-cli gen-ai get-genai-8 — Get genai 8
digitalocean-pp-cli gen-ai get-genai-9 — Get genai 9
digitalocean-pp-cli gen-ai list — List
digitalocean-pp-cli gen-ai list-genai — List genai
digitalocean-pp-cli gen-ai list-genai-10 — List genai 10
digitalocean-pp-cli gen-ai list-genai-11 — List genai 11
digitalocean-pp-cli gen-ai list-genai-12 — List genai 12
digitalocean-pp-cli gen-ai list-genai-13 — List genai 13
digitalocean-pp-cli gen-ai list-genai-14 — List genai 14
digitalocean-pp-cli gen-ai list-genai-15 — List genai 15
digitalocean-pp-cli gen-ai list-genai-16 — List genai 16
digitalocean-pp-cli gen-ai list-genai-17 — List genai 17
digitalocean-pp-cli gen-ai list-genai-2 — List genai 2
digitalocean-pp-cli gen-ai list-genai-3 — List genai 3
digitalocean-pp-cli gen-ai list-genai-4 — List genai 4
digitalocean-pp-cli gen-ai list-genai-5 — List genai 5
digitalocean-pp-cli gen-ai list-genai-6 — List genai 6
digitalocean-pp-cli gen-ai list-genai-7 — List genai 7
digitalocean-pp-cli gen-ai list-genai-8 — List genai 8
digitalocean-pp-cli gen-ai list-genai-9 — List genai 9
digitalocean-pp-cli gen-ai update — Update
digitalocean-pp-cli gen-ai update-genai — Update genai
digitalocean-pp-cli gen-ai update-genai-10 — Update genai 10
digitalocean-pp-cli gen-ai update-genai-11 — Update genai 11
digitalocean-pp-cli gen-ai update-genai-12 — Update genai 12
digitalocean-pp-cli gen-ai update-genai-13 — Update genai 13
digitalocean-pp-cli gen-ai update-genai-14 — Update genai 14
digitalocean-pp-cli gen-ai update-genai-15 — Update genai 15
digitalocean-pp-cli gen-ai update-genai-2 — Update genai 2
digitalocean-pp-cli gen-ai update-genai-3 — Update genai 3
digitalocean-pp-cli gen-ai update-genai-4 — Update genai 4
digitalocean-pp-cli gen-ai update-genai-5 — Update genai 5
digitalocean-pp-cli gen-ai update-genai-6 — Update genai 6
digitalocean-pp-cli gen-ai update-genai-7 — Update genai 7
digitalocean-pp-cli gen-ai update-genai-8 — Update genai 8
digitalocean-pp-cli gen-ai update-genai-9 — Update genai 9

イメージ — DigitalOcean のイメージを使用して Droplet を作成できます。イメージにはさまざまな種類があります。現在、イメージにはスナップショット、バックアップ、アプリケーション、ディストリビューション、カスタムイメージの 5 種類があります。

スナップショットは、既存の Droplet インスタンスの完全なコピーをオンデマンドで作成したものです。
バックアップはスナップショットと似ていますが、Droplet で有効にすると、定期的に自動作成されます。
カスタムイメージは、DigitalOcean にアップロードして使用できる Linux ベースの仮想マシンイメージです（raw、qcow2、vhdx、vdi、vmdk 形式に対応しています）。
ディストリビューションは、Droplet の作成時にベースとして使用できる公開 Linux ディストリビューションです。
アプリケーション、または1-Click Appsは、追加ソフトウェアが事前に設定されたディストリビューションです。

イメージを操作するには、通常、/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 クラスターをすばやくデプロイできます。/v2/kubernetes/clusters エンドポイントにリクエストを送信すると、クラスターの一覧表示、作成、削除のほか、ノードプールのスケールアップとスケールダウン、個々のノードの再作成、クラスターで使用する kubeconfig ファイルの取得ができます。

digitalocean-pp-cli kubernetes create — 作成
digitalocean-pp-cli kubernetes create-clusters — クラスターを作成
digitalocean-pp-cli kubernetes create-clusters-2 — クラスターを作成 2
digitalocean-pp-cli kubernetes create-clusters-3 — クラスターを作成 3
digitalocean-pp-cli kubernetes create-clusters-4 — クラスターを作成 4
digitalocean-pp-cli kubernetes create-registries — レジストリを作成
digitalocean-pp-cli kubernetes create-registry — レジストリを作成
digitalocean-pp-cli kubernetes delete — 削除
digitalocean-pp-cli kubernetes delete-clusters — クラスターを削除
digitalocean-pp-cli kubernetes delete-clusters-2 — クラスターを削除 2
digitalocean-pp-cli kubernetes delete-clusters-3 — クラスターを削除 3
digitalocean-pp-cli kubernetes delete-clusters-4 — クラスターを削除 4
digitalocean-pp-cli kubernetes delete-clusters-5 — クラスターを削除 5
digitalocean-pp-cli kubernetes delete-registry — レジストリを削除
digitalocean-pp-cli kubernetes get — 取得
digitalocean-pp-cli kubernetes get-clusters — クラスターを取得
digitalocean-pp-cli kubernetes get-clusters-2 — クラスターを取得 2
digitalocean-pp-cli kubernetes get-clusters-3 — クラスターを取得 3
digitalocean-pp-cli kubernetes get-clusters-4 — クラスターを取得 4
digitalocean-pp-cli kubernetes get-clusters-5 — クラスターを取得 5
digitalocean-pp-cli kubernetes get-clusters-6 — クラスターを取得 6
digitalocean-pp-cli kubernetes get-clusters-7 — クラスターを取得 7
digitalocean-pp-cli kubernetes get-clusters-8 — クラスターを取得 8
digitalocean-pp-cli kubernetes get-clusters-9 — クラスターを取得 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 Load Balancers は、複数の Droplet にトラフィックを分散する方法を提供します。/v2/load_balancers エンドポイントにリクエストを送信すると、ロードバランサーの一覧表示、作成、削除に加え、Droplet や転送ルール、その他の設定の追加や削除を行えます。
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 Monitoring API を使用すると、メトリクスをプログラムから取得できるほか、これらのメトリクスに基づいてアラートポリシーを設定できます。Monitoring API は、アプリのパフォーマンスやリソースの消費状況を把握するのに役立ちます。

digitalocean-pp-cli monitoring create — Create
digitalocean-pp-cli monitoring create-sinks — Create sinks
digitalocean-pp-cli monitoring create-sinks-2 — Create sinks 2
digitalocean-pp-cli monitoring create-sinks-3 — Create sinks 3
digitalocean-pp-cli monitoring delete — Delete
digitalocean-pp-cli monitoring delete-sinks — Delete sinks
digitalocean-pp-cli monitoring delete-sinks-2 — Delete sinks 2
digitalocean-pp-cli monitoring get — Get
digitalocean-pp-cli monitoring get-sinks — Get sinks
digitalocean-pp-cli monitoring get-sinks-2 — Get sinks 2
digitalocean-pp-cli monitoring list — List
digitalocean-pp-cli monitoring list-metrics — List metrics
digitalocean-pp-cli monitoring list-metrics-10 — List metrics 10
digitalocean-pp-cli monitoring list-metrics-11 — List metrics 11
digitalocean-pp-cli monitoring list-metrics-12 — List metrics 12
digitalocean-pp-cli monitoring list-metrics-13 — List metrics 13
digitalocean-pp-cli monitoring list-metrics-14 — List metrics 14
digitalocean-pp-cli monitoring list-metrics-15 — List metrics 15
digitalocean-pp-cli monitoring list-metrics-16 — List metrics 16
digitalocean-pp-cli monitoring list-metrics-17 — List metrics 17
digitalocean-pp-cli monitoring list-metrics-18 — List metrics 18
digitalocean-pp-cli monitoring list-metrics-19 — List metrics 19
digitalocean-pp-cli monitoring list-metrics-2 — List metrics 2
digitalocean-pp-cli monitoring list-metrics-20 — List metrics 20
digitalocean-pp-cli monitoring list-metrics-21 — List metrics 21
digitalocean-pp-cli monitoring list-metrics-22 — List metrics 22
digitalocean-pp-cli monitoring list-metrics-23 — List metrics 23
digitalocean-pp-cli monitoring list-metrics-24 — List metrics 24
digitalocean-pp-cli monitoring list-metrics-25 — List metrics 25
digitalocean-pp-cli monitoring list-metrics-26 — List metrics 26
digitalocean-pp-cli monitoring list-metrics-27 — List metrics 27
digitalocean-pp-cli monitoring list-metrics-28 — List metrics 28
digitalocean-pp-cli monitoring list-metrics-29 — List metrics 29
digitalocean-pp-cli monitoring list-metrics-3 — List metrics 3
digitalocean-pp-cli monitoring list-metrics-30 — List metrics 30
digitalocean-pp-cli monitoring list-metrics-31 — List metrics 31
digitalocean-pp-cli monitoring list-metrics-32 — List metrics 32
digitalocean-pp-cli monitoring list-metrics-33 — List metrics 33
digitalocean-pp-cli monitoring list-metrics-34 — List metrics 34
digitalocean-pp-cli monitoring list-metrics-35 — List metrics 35
digitalocean-pp-cli monitoring list-metrics-36 — List metrics 36
digitalocean-pp-cli monitoring list-metrics-37 — List metrics 37
digitalocean-pp-cli monitoring list-metrics-38 — List metrics 38
digitalocean-pp-cli monitoring list-metrics-39 — List metrics 39
digitalocean-pp-cli monitoring list-metrics-4 — List metrics 4
digitalocean-pp-cli monitoring list-metrics-40 — List metrics 40
digitalocean-pp-cli monitoring list-metrics-41 — List metrics 41
digitalocean-pp-cli monitoring list-metrics-42 — List metrics 42
digitalocean-pp-cli monitoring list-metrics-43 — List metrics 43
digitalocean-pp-cli monitoring list-metrics-44 — List metrics 44
digitalocean-pp-cli monitoring list-metrics-45 — List metrics 45
digitalocean-pp-cli monitoring list-metrics-46 — List metrics 46
digitalocean-pp-cli monitoring list-metrics-47 — List metrics 47
digitalocean-pp-cli monitoring list-metrics-48 — List metrics 48
digitalocean-pp-cli monitoring list-metrics-49 — List metrics 49
digitalocean-pp-cli monitoring list-metrics-5 — List metrics 5
digitalocean-pp-cli monitoring list-metrics-50 — List metrics 50
digitalocean-pp-cli monitoring list-metrics-51 — List metrics 51
digitalocean-pp-cli monitoring list-metrics-52 — List metrics 52
digitalocean-pp-cli monitoring list-metrics-53 — List metrics 53
digitalocean-pp-cli monitoring list-metrics-54 — List metrics 54
digitalocean-pp-cli monitoring list-metrics-55 — List metrics 55
digitalocean-pp-cli monitoring list-metrics-56 — List metrics 56
digitalocean-pp-cli monitoring list-metrics-57 — List metrics 57
digitalocean-pp-cli monitoring list-metrics-58 — List metrics 58
digitalocean-pp-cli monitoring list-metrics-6 — List metrics 6
digitalocean-pp-cli monitoring list-metrics-7 — List metrics 7
digitalocean-pp-cli monitoring list-metrics-8 — List metrics 8
digitalocean-pp-cli monitoring list-metrics-9 — List metrics 9
digitalocean-pp-cli monitoring list-sinks — List sinks
digitalocean-pp-cli monitoring list-sinks-2 — List sinks 2
digitalocean-pp-cli monitoring update — 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 — Partner Network Connect を使用すると、DigitalOcean の VPC ネットワークと他のパブリッククラウドプロバイダーまたはオンプレミスのデータセンターとの間に、高帯域幅、低レイテンシのネットワーク接続を直接確立できます。

digitalocean-pp-cli partner-network-connect create — 作成
digitalocean-pp-cli partner-network-connect create-partnernetworkconnect — partnernetworkconnect を作成
digitalocean-pp-cli partner-network-connect delete — 削除
digitalocean-pp-cli partner-network-connect get — 取得
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect — partnernetworkconnect を取得
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect-2 — partnernetworkconnect 2 を取得
digitalocean-pp-cli partner-network-connect get-partnernetworkconnect-3 — partnernetworkconnect 3 を取得
digitalocean-pp-cli partner-network-connect list — 一覧表示
digitalocean-pp-cli partner-network-connect update — 更新

projects — プロジェクトを使うと、作業方法に合ったグループにリソースを整理できます。DigitalOcean でホストするアプリケーションに合わせて、リソース（Droplet、Spaces、ロードバランサー、ドメイン、フローティング IP など）をグループ化できます。

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 — デフォルトを一覧表示
digitalocean-pp-cli projects list-default-2 — デフォルト 2 を一覧表示
digitalocean-pp-cli projects update — 更新
digitalocean-pp-cli projects update-default — デフォルトを更新
digitalocean-pp-cli projects update-projectid — projectid を更新
digitalocean-pp-cli projects update-projectid-2 — 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 — 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 — validatename を作成
digitalocean-pp-cli registry delete — 削除
digitalocean-pp-cli registry list — 一覧表示
digitalocean-pp-cli registry list-dockercredentials — 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 製品の名称を Reserved IPs に変更しました。Reserved IP 製品のエンドポイントは、Floating IP とまったく同じように機能します。違いは、URL とフィールド全体で名称が変わったことだけです。たとえば、floating_ips フィールドは reserved_ips フィールドになりました。 Floating IP エンドポイントは、2023年秋まで有効で、その後、完全に非推奨となります。

Projects APIを除き、 API 全体で floating_ip フィールドが使用されているレスポンスに、追加フィールドとしてこの変更を反映します。たとえば、Droplet のメタデータレスポンスには、floating_ips フィールドに加えて reserved_ips フィールドが含まれます。 Projects API で取得した Floating IP は、元の名称のままです。

DigitalOcean Reserved IP は、いずれかの Droplet に割り当てられる、一般にアクセス可能な静的 IP アドレスです。高可用性構成や、アドレスを移動できる必要があるその他の構成を作成するために使用できます。

Reserved 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 Reserved IPv6 は、いずれかの Droplet に割り当てられる、一般にアクセス可能な静的 IP アドレスです。高可用性構成や、アドレスを移動できる必要があるその他の構成を作成するために使用できます。

Reserved 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 — スキャン、スキャン結果、設定用の 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 — sizes オブジェクトは、Droplet に使用できるハードウェアリソースのさまざまなパッケージを表します。 Droplet を作成する際は、適切なリソースを割り当てるためにサイズを選択する必要があります。

各サイズは、特定のリソースを組み合わせたプランを表します。これには、RAM の容量、仮想 CPU の数、ディスク容量、転送量が含まれます。 size オブジェクトには、料金の詳細と、そのサイズを利用できるリージョンも含まれます。

digitalocean-pp-cli sizes — 一覧表示

snapshots — Snapshotsは、Droplet またはブロックストレージボリュームの保存済みインスタンスです。これは resource_type 属性に反映されます。ファイルシステムの圧縮に関する問題を避けるため、それぞれに min_disk_size 属性が定義されています。これは、保存済みスナップショットから新しいリソースを作成する際の Droplet またはボリュームのディスクの最小サイズです。

スナップショットを操作するには、通常、/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、イメージ、ボリューム、ボリュームスナップショット、データベースクラスター）に適用できるラベルであり、リソースの整理や検索・操作を容易にするために使用します。

タグには 2 つの属性があります。ユーザーが定義する name 属性と、タグ付けされたリソースに関する情報を持つ埋め込みの resources 属性です。

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 Uptime Checks は、世界中からエンドポイントを監視し、応答が遅い場合、利用できない場合、または SSL 証明書が期限切れになる場合にアラートを通知する機能を提供します。 Uptime を操作するには、通常 /v2/uptime/ の 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 — チェックの取得
digitalocean-pp-cli uptime get-checks-2 — チェックの取得 2
digitalocean-pp-cli uptime get-checks-3 — チェックの取得 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 — スナップショットの削除
digitalocean-pp-cli volumes delete-volumeid — volumeid の削除
digitalocean-pp-cli volumes get — 取得
digitalocean-pp-cli volumes get-snapshots — スナップショットの取得
digitalocean-pp-cli volumes list — 一覧表示

vpc-nat-gateways — VPC NAT ゲートウェイを使用すると、プライベート VPC 内のリソースが、受信トラフィックに晒されることなくパブリックインターネットにアクセスできるようになります。

/v2/vpc_nat_gateways エンドポイントにリクエストを送信することで、VPC NAT ゲートウェイの作成、設定、一覧表示、削除、およびそれらに割り当てられたリソースに関する情報の取得ができます。

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 ピアリングは、2 つの 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 アドレスを使用して完全に分離された状態で相互に通信できるリソースを含む仮想ネットワークを作成できます。

/v2/vpcs エンドポイントにリクエストを送信することで、カスタム VPC の作成、設定、一覧表示、削除、およびそれらに割り当てられたリソースに関する情報の取得ができます。

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 — 更新
digitalocean-pp-cli vpcs update-vpcid — vpcid の更新

適切なコマンドを見つける

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

digitalocean-pp-cli which "<capability in your own words>"

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も一致するコマンドに解決します。終了コード 0 は少なくとも 1 件の一致があることを示し、終了コード 2 は確度の高い一致がないことを示します。その場合は --help にフォールバックするか、より絞り込んだ問い合わせを使用してください。

認証の設定

アクセストークンを保存します。

digitalocean-pp-cli auth set-token YOUR_TOKEN_HERE

または、環境変数として DIGITALOCEAN_BEARER_AUTH を設定します。

digitalocean-pp-cli doctor を実行して設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

パイプ可能 — stdout に JSON を出力し、エラーは stderr に出力します
フィルタ可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストした構造をたどり、配列では各要素を走査します。冗長な API のコンテキストを小さく保つために重要です。
```
digitalocean-pp-cli 1-clicks list --agent --select id,name,status
```
プレビュー可能 — --dry-run で、リクエストを送信せずに内容を表示します
オフライン対応 — sync/search コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます
非対話型 — プロンプトは表示せず、すべての入力をフラグで指定します
明示的な再試行 — すでに存在する対象の作成を成功として扱う場合にのみ --idempotent を使用し、対象が存在しない削除を成功として扱う場合にのみ --ignore-missing を使用してください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をプロベナンスエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人間が読みやすい N results (live) の概要は、stdout がターミナルの場合にのみ stderr に出力されます。パイプやエージェントで利用する場合は、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この 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.jsonl に保存されます。DIGITALOCEAN_FEEDBACK_ENDPOINT が設定されており、さらに --send が渡されるか DIGITALOCEAN_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカルのみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記述します。それが積み重なっていく要素です。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて、または stdout の代わりに、指定したシンクに送られます。これにより、エージェントは手動でパイプ処理せずにコマンド結果を振り分けられます。サポートされているシンクは 3 種類です。

シンク	効果
`stdout`	デフォルト。stdout のみに書き込みます
`file:<path>`	出力を `<path>` にアトミックに書き込みます（tmp + rename）
`webhook:<url>`	出力本文を URL に POST します（`--compact` の場合は `application/json` または `application/x-ndjson`）

未対応のスキームは、サポート対象を示す構造化エラーとともに拒否されます。Webhook の失敗時は 0 以外の終了コードを返し、stderr に URL と HTTP ステータスを記録します。

名前付きプロファイル

プロファイルは、呼び出しごとに再利用できるフラグ値の保存セットです。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用します。これは 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-context は available_profiles にすべての利用可能なプロファイルを一覧表示するため、情報を調べるエージェントは実行時にそれらを検出できます。

終了コード

コード	意味
0	成功
2	使用法エラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

空、help、または --help → digitalocean-pp-cli --help の出力を表示します
install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照します
その他 → 直接使用（CLI コマンドとして --agent を付けて実行します）

MCP サーバーのインストール

MCP サーバーをインストールします。

go install github.com/mvanhorn/printing-press-library/library/cloud/digitalocean/cmd/digitalocean-pp-mcp@latest

Claude Code に登録します。

claude mcp add digitalocean-pp-mcp -- digitalocean-pp-mcp

確認します：claude mcp list

直接使用

インストール済みか確認します：which digitalocean-pp-cli 見つからない場合は、インストールを案内します（このスキルの冒頭にある前提条件を参照してください）。
ユーザーのクエリに最適なコマンドを、上記の独自の機能とコマンドリファレンスから選びます。

--agent フラグを付けて実行します。

digitalocean-pp-cli <command> [subcommand] [args] --agent

曖昧な場合は、サブコマンドのヘルプを確認します：digitalocean-pp-cli <command> --help。

Markdown 対応

ログインしてコメント

基本情報

作者: mvanhorn
リポジトリ: mvanhorn/printing-press-library
カテゴリ: クラウド・DevOps
インストール数: 66
GitHub スター: 2,088

問題を報告