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

言語:

次の表に、使用可能なレプリケーションターゲットのコマンドを示します。

表 96 レプリケーションターゲットコマンド

リクエスト	パス /api/storage/v1	説明
POST	/replication/targets	新しいレプリケーションターゲットを作成します
GET	/replication/targets/<`target`>	指定されたレプリケーションターゲットプロパティーを取得します
GET	/replication/targets	すべてのレプリケーションターゲットオブジェクトを一覧表示します
PUT	/replication/targets/<`target`>	指定されたレプリケーションターゲットオブジェクトを変更します
DELETE	/replication/targets/<`target`>	指定されたターゲットオブジェクトを破棄します

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

システム上の使用可能なレプリケーションターゲットをすべて一覧表示します。

リクエストの例:

GET /api/storage/v1/replication/targets HTTP/1.1
Host: zfssa-storage.example.com:215
Authorization: Basic ab6rt4psMWE=
Accept: application/json

レスポンスの例:

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

{ 
        "targets": [{     
            "address": "10.133.64.44:216", 
            "label": "chum", 
            "hostname": "10.133.64.44", 
            "asn": "9d7a7543-ca83-68f5-a8fc-f818f65e1cfc", 
            "actions": 0, 
            "target": "target-000", 
            "href": "/api/storage/v1/replication/targets/chum" 
        }, { 
            "address": "10.153.34.165:216", 
            "label": "oakmeal-7320-165", 
            "hostname": "10.153.34.165", 
            "asn": "16a4c82c-26c1-4a50-e317-ac53181f2e86", 
            "actions": 0, 
            "target": "target-001", 
            "href": "/api/storage/v1/replication/targets/oakmeal-7320-165" 
        }] 
}

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

このコマンドは、単一のレプリケーションターゲットの詳細を表示します。ターゲットはそのホスト名によってアクセスされます。

リクエストの例:

GET /api/storage/v1/replication/targets/chum HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: zfs-storage.example.com:215
Accept: application/json

レスポンスの例:

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

{ 
        "target": { 
            "href": "/api/storage/v1/replication/targets/chum", 
            "address": "10.133.64.44:216", 
            "label": "chum", 
            "hostname": "10.133.64.44", 
            "asn": "9d7a7543-ca83-68f5-a8fc-f818f65e1cfc", 
            "actions": 0 
        } 
}

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

リモートレプリケーション用に新しいレプリケーションターゲットを作成します。

リクエストの例:

POST /api/replication/v1/targets HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: example.zfssa.com:215
Accept: application/json
Content-Type: application/json
Content-Length: 54

{"hostname":"example", “root_password”:”letmein”, “label”:”east”}

レスポンスの例:

HTTP/1.1 201 Created
Content-Length: 135
Content-Type: application/json
Location: /service/v1/services/replication/targets/target-000
X-Zfssa-Replication-Api: 1.0

{
    "target": {
        "actions": 0,
        "address": "123.45.78.9:216",
        "asn": "fa5bf303-0dcb-e20d-ac92-cd129ccd2c81",
        "hostname": "example",
        "href": "/service/v1/services/replication/targets/target-000",
        "label": "east"
    }
}

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

このコマンドは、既存のレプリケーションターゲットを削除します。

リクエストの例:

DELETE /service/v1/services/replication/targets/target-000 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