機械翻訳について
  1. Oracle Cloud Infrastructure Compute ClassicのREST API
  2. タスク
  3. バックアップ構成

すべてのバックアップ構成に関する詳細の取得

get

/backupservice/v1/configuration

このエンドポイントはOracle Cloud Machineでは使用できません。

現在のユーザーがアクセスする権限を持つすべてのバックアップ構成オブジェクトの詳細を取得します。

必要なロール: このタスクを実行するには、Compute_MonitorまたはCompute_Operationsのロールが必要です。 このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

この操作のリクエスト・パラメータはありません。

トップに戻る

レスポンス

サポートされるメディア・タイプ

200レスポンス

操作が成功しました。
本文 ()
ルート・スキーマ : schema
型: array
ソースの表示
ネストされたスキーマ: BackupConfiguration
型: object
ソースの表示
  • 保持するバックアップの数
  • このバックアップ構成の説明
  • デフォルト値: false
    trueの場合、バックアップは間隔に基づいて自動的に生成されます。
  • Interval
    2種類の間隔があります。 各間隔には独自のJSON形式があります。 「Interval」フィールドは次のいずれかのようになります。

    • "interval":{"Hourly":{"hourlyInterval":2}}
    • {"DailyWeekly":{"daysOfWeek":["MONDAY"],"timeOfDay":"03:15","userTimeZone":"America/Los_Angeles"}}

    曜日はすべて大文字の曜日(MONDAY、TUESDAYなど)です。 ユーザー・タイムゾーンは任意のIANAユーザー・タイムゾーンです。 ユーザー・タイムゾーンの例については、IANAタイムゾーンのリストを参照してください。

  • パターン: (^/$|^(/[\w@\.-]+)+$)
    オブジェクトのマルチパート名。 オブジェクト名には、英数字、ハイフン(-)、アンダースコア(_)、@およびピリオドのみを含めることができます。 オブジェクト名は大文字と小文字が区別されます。
  • 次のバックアップ実行がスケジュールされている時間
  • パターン: (^/$|^(/[\w@\.-]+)+$)
    このモデルに対するアクションはこのユーザーとして実行されます。
  • 他のクラウド・リソースをタグ付けするために使用されたID
  • Uniform Resource Identifier
  • バックアップするストレージ・ボリュームの完全なURI。
ネストされたスキーマ: Interval
型: object
2種類の間隔があります。 各間隔には独自のJSON形式があります。 「Interval」フィールドは次のいずれかのようになります。

  • "interval":{"Hourly":{"hourlyInterval":2}}
  • {"DailyWeekly":{"daysOfWeek":["MONDAY"],"timeOfDay":"03:15","userTimeZone":"America/Los_Angeles"}}

曜日はすべて大文字の曜日(MONDAY、TUESDAYなど)です。 ユーザー・タイムゾーンは任意のIANAユーザー・タイムゾーンです。 ユーザー・タイムゾーンの例については、IANAタイムゾーンのリストを参照してください。

いずれかに一致
ソースの表示

401レスポンス

権限がありません。

500レスポンス

このリクエストの処理中にサーバーでエラーが発生しました。
トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、/コンテナ内の表示する権限のあるすべてのバックアップ構成の詳細を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを単一の行で入力します。 この例では読みやすくするために改行が使用されています。 

curl -X GET 
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Accept: application/oracle-compute-v3+json"
     https://api-z999.compute.us0.oraclecloud.com/backupservice/v1/configuration/

  • COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。 認証クッキーの取得および変数への格納の詳細は、認証を参照してください。

  • api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。 この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。 サイトのRESTエンドポイントURLを確認するための詳細は、「リクエストの送信」を参照してください。

レスポンス本文の例

次の例では、JSON形式のレスポンス本文を示します。

[
  {
    "uri": "https://api-z999.compute.us0.oraclecloud.com:443/backupservice/v1/configuration/Compute-acme/jack.jones@example.com/backupConfigVol1",
    "runAsUser": "/Compute-acme/jack.jones@example.com",
    "name": "/Compute-acme/jack.jones@example.com/backupConfigVol1",
    "enabled": true,
    "backupRetentionCount": 2,
    "nextScheduledRun": "2016-10-25T21:25:12.898Z",
    "interval": {
      "Hourly": {
        "hourlyInterval": 12
      }
    },
    "volumeUri": "/storage/volume/Compute-acme/jack.jones@example.com/vol1",
    "description": null,
    "tagId": "63ed3bec-5da2-42d2-9f6a-6440a5c91567"
  },
  {
    "uri": "https://api-z999.compute.us0.oraclecloud.com:443/backupservice/v1/configuration/Compute-acme/jack.jones@example.com/backupConfigWeeklyVol2",
    "runAsUser": "/Compute-acme/jack.jones@example.com",
    "name": "/Compute-acme/jack.jones@example.com/backupConfigWeeklyVol2",
    "enabled": false,
    "backupRetentionCount": 2,
    "nextScheduledRun": "2016-09-28T04:00:00Z",
    "interval": {
      "DailyWeekly": {
        "daysOfWeek": [
          "WEDNESDAY",
          "FRIDAY"
        ],
        "timeOfDay": "04:00",
        "userTimeZone": "GMT"
      }
    },
    "volumeUri": "/storage/volume/Compute-acme/jack.jones@example.com/vol1",
    "description": null,
    "tagId": "4b47cfac-ab33-44fa-a8ae-2dc3f333a44b"
  }
]
トップに戻る