JavaScript is required to for searching.
ナビゲーションリンクをスキップ
印刷ビューの終了
Oracle® ZFS Storage Appliance RESTful API ガイド、Release 2013.1.3.0
Oracle Technology Network
ライブラリ
PDF
印刷ビュー
フィードバック
search filter icon
search icon

ドキュメント情報

Oracle ZFS Storage Appliance RESTful API の概要

RESTful API の操作

RESTful API 警告サービス

Analytics サービス

ハードウェアサービス

ログのコマンド

ネットワークのコマンド

RESTful API 問題サービス

RESTful API ロールサービス

RESTful API SAN サービス

サービスコマンド

RESTful API ストレージサービス

ストレージプールの操作

プールの一覧表示

プールの取得

プールの構成

プールへのストレージの追加

プールのスクラブ

プールの構成解除

プロジェクトの操作

プロジェクトの一覧表示

プロジェクトのプロパティーの取得

プロジェクトの作成

プロジェクトの変更

プロジェクトの削除

プロジェクトの使用状況

ファイルシステムの操作

ファイルシステムの一覧表示

ファイルシステムの取得

ファイルシステムの作成

ファイルシステムの変更

ファイルシステムの削除

ファイルシステムの割り当て制限および使用状況

LUN 操作

LUN を一覧表示します

LUN の取得

新しい LUN の作成

LUN の変更

LUN の削除

スナップショットおよびクローンの操作

スナップショットの一覧表示

スナップショットの取得

スナップショットの作成

スナップショットの名前変更

スナップショットのクローン作成

スナップショットのロールバック

スナップショットの削除

スナップショット依存の一覧表示

スキーマ

プロパティーの一覧表示

プロパティーの取得

プロパティーの作成

プロパティーの変更

プロパティーの削除

レプリケーション

レプリケーションサービスの取得

レプリケーションサービスの状態の変更

レプリケーションターゲット

レプリケーションターゲットの一覧表示

レプリケーションターゲットの取得

レプリケーションターゲットの作成

レプリケーションターゲットの削除

レプリケーションアクション

レプリケーションアクションの一覧表示

レプリケーションアクションの取得

レプリケーションアクションの作成

レプリケーションアクションの変更

更新の取り消し

更新の送信

レプリケーションアクションの削除

レプリケーションパッケージ

レプリケーションソースの一覧表示

レプリケーションパッケージの一覧表示

パッケージの変更

パッケージの削除

更新の取り消し

パッケージのクローン作成

パッケージの切断

パッケージの逆方向化

システムコマンド

RESTful API ユーザーサービス

ワークフローコマンド

RESTful クライアント

レプリケーションアクション

レプリケーションアクションは、レプリケーションターゲットにデータをレプリケートするための規則を定義します。次のコマンドは、レプリケーションアクションを管理します。

表 12-35  レプリケーションアクションコマンド
リクエスト
/api/storage/v1
説明
GET
/replication/actions
すべてのレプリケーションアクションオブジェクトを一覧表示します
GET
/replication/actions/<ra_id>
指定されたレプリケーションアクションプロパティーを取得します
POST
/replication/actions
新しいレプリケーションアクションを作成します
PUT
/replication/actions/<ra_id>
指定されたレプリケーションアクションオブジェクトを変更します
DELETE
/replication/actions/<ra_id>
指定されたレプリケーションアクションオブジェクトを削除します
PUT
/replication/actions/<ra_id> /sendupdate
選択したレプリケーションアクションを開始します
PUT
/replication/actions/<ra_id> /cancelupdate
選択したレプリケーションアクションを停止します
GET
/replication/actions/<ra_id> /schedules
すべてのレプリケーションアクションスケジュールオブジェクトを一覧表示します
GET
/replication/actions/<ra_id> /schedules/<ra_schedule>
指定されたレプリケーションアクションスケジュールプロパティーを取得します
POST
/replication/actions/<ra_id> /schedules
新しいレプリケーションアクションスケジュールを作成します
PUT
/replication/actions/<ra_id> /schedules/<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを変更します
DELETE
/replication/actions/<ra_id> /schedules/<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを削除します
GET
/pools/<pool>/projects /<project>/replication/actions
すべてのレプリケーションアクションオブジェクトを一覧表示します
GET
/pools/<pool>/projects /<project>/replication/actions /<ra_id>
指定されたレプリケーションアクションプロパティーを取得します
POST
/pools/<pool>/projects /<project>/replication/actions
新しいレプリケーションアクションを作成します
PUT
/pools/<pool>/projects /<project>/replication/actions /<ra_id>
指定されたレプリケーションアクションオブジェクトを変更します
DELETE
/pools/<pool>/projects /<project>/replication/actions /<ra_id>
指定されたレプリケーションアクションオブジェクトを削除します
PUT
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/sendupdate
選択したレプリケーションアクションを開始します
PUT
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/cancelupdate
選択したレプリケーションアクションを停止します
GET
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules
すべてのレプリケーションアクションスケジュールオブジェクトを一覧表示します
GET
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule>
指定されたレプリケーションアクションスケジュールプロパティーを取得します
POST
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules
新しいレプリケーションアクションスケジュールを作成します
PUT
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを変更します
DELETE
/pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを削除します
GET
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions
すべてのレプリケーションアクションオブジェクトを一覧表示します
GET
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>
指定されたレプリケーションアクションプロパティーを取得します
POST
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions
新しいレプリケーションアクションを作成します
PUT
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>
指定されたレプリケーションアクションオブジェクトを変更します
DELETE
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>
指定されたレプリケーションアクションオブジェクトを削除します
GET
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication
ファイルシステムのレプリケーションアクション設定を取得します
PUT
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication
ファイルシステムのレプリケーションアクション設定を変更します
PUT
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/sendupdate
選択したレプリケーションアクションを開始します
PUT
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/cancelupdate
選択したレプリケーションアクションを停止します
GET
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules
すべてのレプリケーションアクションスケジュールオブジェクトを一覧表示します
GET
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule>
指定されたレプリケーションアクションスケジュールプロパティーを取得します
POST
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules
新しいレプリケーションアクションスケジュールを作成します
PUT
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを変更します
DELETE
/pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを削除します
GET
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions
すべてのレプリケーションアクションオブジェクトを一覧表示します
GET
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id>
指定されたレプリケーションアクションプロパティーを取得します
POST
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions
新しいレプリケーションアクションを作成します
PUT
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id>
指定されたレプリケーションアクションオブジェクトを変更します
DELETE
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id>
指定されたレプリケーションアクションオブジェクトを削除します
GET
/pools/<pool>/projects /<project>/luns/<lun> /replication
LUN のレプリケーションアクション設定を取得します
PUT
/pools/<pool>/projects /<project>/luns/<lun> /replication
LUN のレプリケーションアクション設定を変更します
PUT
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /sendupdate
選択したレプリケーションアクションを開始します
PUT
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /cancelupdate
選択したレプリケーションアクションを停止します
GET
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules
すべてのレプリケーションアクションスケジュールオブジェクトを一覧表示します
GET
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule>
指定されたレプリケーションアクションスケジュールプロパティーを取得します
POST
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules
新しいレプリケーションアクションスケジュールを作成します
PUT
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを変更します
DELETE
/pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule>
指定されたレプリケーションアクションスケジュールオブジェクトを削除します

レプリケーションアクションの一覧表示

すべての使用可能なレプリケーションアクションのリストを取得します。

リクエストの例:

GET /api/storage/v1/replication/actions HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Accept: application/json

レスポンスの例:

HTTP/1.1 200 OK
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 529

{
    "actions": [{
        "href": ""
        ...
    }, {
        "href": "",
        ...
    }]
}

レプリケーションアクションの取得

レプリケーションアクションステータスの取得コマンドは、ID で指定された単一のレプリケーションアクションのステータスを返します。

リクエストの例:

GET /api/storage/v1/replication/actions/1438ed7f-aad3-c631-d869-9e85cd7f15b4 HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Accept: application/json

レスポンスの例:

HTTP/1.1 200 OK
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 529

{
    "action": {
        "average_throughput": 0.0,
        "bytes_sent": 0.0,
        "collection": "local",
        "continuous": false,
        "enabled": true,
        "estimated_size": 0.0,
        "estimated_time_left": 0.0,
        "href": "/api/storage/v1/replication/actions",
        "id": "8373d331-de60-e590-90e8-9ad69fcb4aec",
        "include_snaps": true,
        "last_sync": "20130916T21:36:50",
        "last_try": "20130916T21:36:50",
        "max_bandwidth": 0,
        "pool": "gold",
        "project": "blah1",
        "share": "fs1",
        "state": "sending",
        "target": "38094753-6c90-49ed-aa92-995a296d432a",
        "use_ssl": true
    }
}

レプリケーションアクションの作成

新しいレプリケーションアクションを作成します。

プロパティーの作成:

Initial values:
                   target = (unset)
                     pool = (unset)
                  enabled = true
               continuous = false
            include_snaps = true
            max_bandwidth = unlimited
               bytes_sent = 0
           estimated_size = 0
      estimated_time_left = 0
       average_throughput = 0
                  use_ssl = true

リクエストの例:

POST /api/storage/v1/replication/actions HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json
Content-Length: 121
Accept: application/json

{
    "pool": "gold",
    "project": "blue1",
    "share": "fs1",
    "target_pool": "pool1",
    "target": "38094753-6c90-49ed-aa92-995a296d432a"
}

レスポンスの例:

HTTP/1.1 201 Created
Content-Length: 506
Content-Type: application/json
Location: /api/storage/v1/replication/action/8373d331-de60-e590-90e8-9ad69fcb4aec
X-Zfssa-Replication-Api: 1.0

{
    "action": {
        "project": "blue1",
        "target": "38094753-6c90-49ed-aa92-995a296d432a",
        "bytes_sent": 0.0,
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "collection": "local",
        "estimated_size": 0.0,
        "state": "idle",
        "href": "/api/storage/v1/replication/pools/gold/projects/blah1/shares/fs1/
                  actions/8373d331-de60-e590-90e8-9ad69fcb4aec",
        "average_throughput": 0.0,
        "use_ssl": true,
        "estimated_time_left": 0.0,
        "share": "fs1",
        "id": "8373d331-de60-e590-90e8-9ad69fcb4aec",
        "pool": "gold",
        "include_snaps": true
    }
}

レプリケーションアクションの変更

既存のレプリケーションアクションを変更します。

リクエストの例:

PUT /api/storage/v1/replication/actions/c141d88d-ffd2-6730-d489-b71905f340cc HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json

{"use_ssl": false}

レスポンスの例:

HTTP/1.1 202 Accepted
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 620

{
    "action": {
        "target_id": "407642ae-91b5-681c-de5e-afcd5cbf2974",
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "dedup": false,
        "use_ssl": false,
        "id": "c141d88d-ffd2-6730-d489-b71905f340cc",
        "include_snaps": true
    }
}

更新の取り消し

進行中のレプリケーション更新を取り消します。

リクエストの例:

PUT /api/storage/v1/replication/actions/c141d88d-ffd2-6730-d489-b71905f340cc/cancelupdate HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

レスポンスの例:

HTTP/1.1 202 Accepted
X-Zfssa-Replication-Api: 1.0

更新の送信

レプリケーション更新を可能なかぎりすぐに開始するようにスケジュールします。

リクエストの例:

PUT /api/storage/v1/replication/actions/c141d88d-ffd2-6730-d489-b71905f340cc/sendupdate HTTP/1.1
Authorization: Basic ab6rt4psMWE=

レスポンスの例:

HTTP/1.1 202 Accepted
X-Zfssa-Replication-Api: 1.0

レプリケーションアクションの削除

既存のレプリケーションアクションを削除します。

リクエストの例:

DELETE /api/storage/v1/replication/actions/e7e688b1-ff07-474f-d5cd-cac08293506e
       HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

削除に成功すると、HTTP ステータス 204 (No Content) が返されます。

レスポンスの例:

HTTP/1.1 204 No-Content
X-Zfssa-Replication-Api: 1.0