バックアップスイート

[更新: 2026年02月26日]

概要

さくらのクラウドにおけるバックアップ関連の機能を集約するサービスです。

料金

現在はCR版のため、無償で提供します。

対象サービス

専有ストレージ のスナップショット機能 2026年2月時点では、さくらのクラウド内で限定的な機能を対象にしています。順次、対象拡大を検討しています。

利用シーン

日時を指定してバックアップ取得を実行します。一元的に管理できるため、機能ごとのバックアップ設定を個別管理する手間が減ります。

利用方法

APIのみ提供になります。将来的に画面などを予定しています。

用語

バックアッププラン

契約の単位です。

バックアップタイプ

バックアップ後の形式を指定します。現在は、専有ストレージのディスクスナップショットのみの対応しています。 2026年2月時点では、さくらのクラウド内で限定的な機能を対象にしています。順次、対象拡大を検討しています。

バックアップスケジュール

バックアップの日時を指定します。crontabの仕様に準拠します。

バックアップ対象リソース

バックアップ対象になるリソースです。 専有ストレージに収容されているディスクになります。 2026年2月時点では、さくらのクラウド内で限定的な機能を対象にしています。順次、対象拡大を検討しています。

注意事項

さくらのクラウドAPIの利用方法など、一般的な情報については APIドキュメント を参照ください。

APIを実行するためには、APIキーに「作成・削除」のアクセスレベルが必要になります。
詳細は、 アクセスレベルのページ をご覧ください。

API キーの発行

APIキーの発行方法は APIキー をご覧ください。

パラメータ	説明
アクセストークン	APIキーのアクセストークンです。 例：ACCESS_TOKEN と表示しています。
アクセストークンシークレット	APIキーのアクセストークンシークレットです。 例：ACCESS_TOKEN_SECRET と表示しています

利用に必要な権限

バックアップスイートのAPIを叩くために必要 また、以下の権限が付与されている必要があります。

サービスへのアクセス権
・ バックアップスイート管理者
・ バックアップスイート閲覧者
最低限必要な権限はAPIによって異なります。

サービスプリンシパルの発行

バックアップスイートのシステムはお客様が発行したサービスプリンシパルから生成するトークンを利用して、お客様のリソースにアクセスします。 お客様が発行したサービスプリンシパルはバックアッププラン作成時に指定する必要があります。

注釈

機能提供されるバックアッププランのオプション次第で、お客様が発行するサービスプリンシパルに付与すべきIAMロールの権限は異なります。
・現時点では「専有ストレージのスナップショット取得」の機能のみなので、お客様が発行するサービスプリンシパルには "さくらのクラウド" の "作成・削除" の権限が付与されている必要があります。
・対象ディスク情報の取得、対象ディスクに対するスナップショット実行するための権限が必要です。

「専有ストレージのスナップショット取得」の注意事項

• 専有ストレージの利用は、専有ストレージ をご確認ください。

• 専有ストレージは、エクストラーサービスになります。ご利用前に当社にて審査を実施し、審査結果につきましてはご契約者様にメールにてご連絡を行っております。

• 専有ストレージは、現在、東京第2ゾーン(tk1b)のみの提供です。

• バックアッププラン作成時に指定するゾーン情報とバックアップ対象としているリソースが属しているゾーンが一致する必要があります。現在は、東京第2ゾーン(tk1b)固定になります。

バックアッププラン一覧取得

バックアッププランの設定一覧を取得します。

最低限必要な権限: バックアップスイート閲覧者

$ curl -s -X GET \
  -u "$ACCESS_TOKEN:ACCESS_TOKEN_SECRET" \
  https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans

バックアッププラン作成

バックアッププランを作成します。

最低限必要な権限: バックアップスイート管理者

パラメータ	説明	省略時のデフォルト値
Zone	ゾーン情報	必須
ServicePrincipalID	お客様が発行したサービスプリンシパルのリソースID	必須
Type	バックアッププランの種別	必須

$ curl -s -X POST \
  -u "$ACCESS_TOKEN:ACCESS_TOKEN_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
     "BackupPlan": {
       "Zone": "tk1b",
       "ServicePrincipalID": "999800012911",
       "Target": {
         "Type": "dedicated_storage_disk_snapshot"
       }
     }
   }' \
  https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans

バックアッププラン情報取得

バックアッププランの情報を取得します。

最低限必要な権限: バックアップスイート閲覧者

パラメータ	説明	省略時のデフォルト値
バックアッププランID	バックアッププランのIDを指定します。	必須

$ curl -s -X GET \
  -u "$ACCESS_TOKEN:ACCESS_TOKEN_SECRET" \
  https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>

バックアッププラン削除

バックアッププランを削除します。

最低限必要な権限: バックアップスイート管理者

パラメータ	説明	省略時のデフォルト値
ID	バックアッププランのIDを指定します。	必須

$ curl -s -X DELETE \
  -u "$ACCESS_TOKEN:$ACCESS_TOKEN_SECRET" \
  https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>

バックアップスケジュール一覧取得

バックアップスケジュールの一覧を取得します。

パラメータ	説明	省略時のデフォルト値
バックアッププランID	バックアッププランのIDを指定します。	必須

$ curl -s -X GET \
  -u "$ACCESS_TOKEN:ACCESS_TOKEN_SECRET" \
  https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>/schedules

バックアップスケジュール登録

バックアップのスケジュールを登録します。

最低限必要な権限: バックアップスイート管理者

パラメータ	説明	省略時のデフォルト値
バックアッププランID	バックアッププランのIDを指定します。	必須
Schedule.Type	スケジュール形式	必須
Schedule.Spec.Expression	定期実行設定(crontab式)	必須
Retention.Type	保持形式	必須
Retention.Spec.Count	保持数(世代数)	必須

 $ curl -s -X POST \
-u "$ACCESS_TOKEN:$ACCESS_TOKEN_SECRET" \
-H "Content-Type: application/json" \
-d '{
  "BackupSchedule": {
    "Schedule": {
      "Type": "cron",
      "Spec": {
        "Expression": "0 * * * *"
      }
    },
    "Retention": {
      "Type": "count",
      "Spec": {
        "Count": 4
      }
    }
  }
}' \
https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>/schedules

バックアップスケジュールの情報

バックアップスケジュールの情報を取得します。

最低限必要な権限: バックアップスイート閲覧者

パラメータ	説明	省略時のデフォルト値
バックアップID	バックアッププランのIDを指定します。	必須
スケジュールID	スケジュールのIDを指定します。	必須

$ curl -s -X GET \
  -u "$ACCESS_TOKEN:ACCESS_TOKEN_SECRET" \
  https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>/schedules/<スケジュールID>

バックアップスケジュール更新

バックアップのスケジュールを更新します。

最低限必要な権限: バックアップスイート管理者

パラメータ	説明	省略時のデフォルト値
バックアップID	バックアッププランのIDを指定します。	必須
スケジュールID	スケジュールのIDを指定します。	必須
Schedule.*	スケジュールの設定。
Retention.*	保持設定

 $ curl -X PUT \
-u "$ACCESS_TOKEN:$ACCESS_TOKEN_SECRET" \
-H "Content-Type: application/json" \
-d '{
      "BackupSchedule": {
        "Retention": {
          "Type": "count",
          "Spec": {
            "Count": 2
          }
        }
      }
    }' \
https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>/schedules/<スケジュールID>

バックアップスケジュール削除

バックアップのスケジュールを削除します。

最低限必要な権限: バックアップスイート管理者

パラメータ	説明	省略時のデフォルト値
バックアップID	バックアッププランのIDを指定します。	必須
スケジュールID	スケジュールのIDを指定します。	必須

 $ curl -X DELETE \
-u "$ACCESS_TOKEN:$ACCESS_TOKEN_SECRET" \
https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランID>/schedules/<スケジュールID>

バックアッププランの対象リソース登録

バックアッププランの対象リソースに関する情報を登録します。

最低限必要な権限: バックアップスイート管理者

パラメータ	説明	省略時のデフォルト値
ID	バックアッププランのIDを指定します。	必須
DiskID	対象ディスクのIDを指定します。	必須
Zone	対象ディスクが所属するゾーンを指定します。	必須

 $ curl -s -X PUT \
-u "$ACCESS_TOKEN:$ACCESS_TOKEN_SECRET" \
-H "Content-Type: application/json" \
-d '{
      "BackupSourceResources": [
        {
          "Resource": {
            "Type": "disk",
            "Spec": {
              "DiskID": "113800011905",
              "Zone": "tk1b"
            }
          }
        }
      ]
    }' \
https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランのID>/resources

バックアッププランの対象リソース一覧取得

バックアッププランの対象リソースを一覧で取得します。

最低限必要な権限: バックアップスイート閲覧者

パラメータ	説明	省略時のデフォルト値
バックアップID	バックアッププランのIDを指定します。	必須

$ curl -s -X GET \
-u "$ACCESS_TOKEN:$ACCESS_TOKEN_SECRET" \
https://secure.sakura.ad.jp/cloud/zone/tk1b/api/backup-suite/1.0/backup-plans/<バックアッププランのID>/resources

注意事項

• 実行の設定は管理しますが、実行結果は利用するサービス仕様に準拠します。

• 実行時の制約、バックアップ結果はサービスに依存します。