Go to main content
Oracle® ZFS Storage Appliance RESTful API 설명서, 릴리스 OS8.6.x

인쇄 보기 종료

업데이트 날짜: 2016년 9월
 
 

복제 작업

복제 작업은 데이터를 복제 대상에 복제하는 규칙을 정의합니다. 다음 명령은 복제 작업을 관리합니다.

표 97  복제 작업 명령
요청
/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",
        "compression": true,
        "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_clone_origin_as_data": false,
        "include_snaps": true,
        "last_sync": "20130916T21:36:50",
        "last_try": "20130916T21:36:50",
        "max_bandwidth": 0,
        "pool": "gold",
        "project": "blah1",
        "retain_user_snaps_on_target": false,
        "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
                 compression = true
 retain_user_snaps_on_target = false
include_clone_origin_as_data = false

요청 예:

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,
        "compression": true,
        "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,
        "retain_user_snaps_on_target": false,
        "share": "fs1",
        "id": "8373d331-de60-e590-90e8-9ad69fcb4aec",
        "pool": "gold",
        "include_clone_origin_as_data": false,
        "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",
        "compression": true,
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "dedup": false,
        "retain_user_snaps_on_target": false,
        "use_ssl": false,
        "id": "c141d88d-ffd2-6730-d489-b71905f340cc",
        "include_clone_origin_as_data": false,
        "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