JavaScript is required to for searching.
탐색 링크 건너뛰기
인쇄 보기 종료
Oracle® ZFS Storage Appliance RESTful API 설명서, 릴리스 2013.1.3.0
Oracle Technology Network
라이브러리
PDF
인쇄 보기
피드백
search filter icon
search icon

문서 정보

Oracle ZFS Storage Appliance RESTful API 시작하기

RESTful API 작업

RESTful API 경보 서비스

Analytics Services

하드웨어 서비스

로그 명령

네트워크 명령

RESTful API 문제 서비스

RESTful API 역할 서비스

RESTful API SAN 서비스

서비스 명령

RESTful API 스토리지 서비스

스토리지 풀 작업

풀 나열

풀 가져오기

풀 구성

풀에 스토리지 추가

풀 스크러빙

풀 구성 해제

프로젝트 작업

프로젝트 나열

프로젝트 등록 정보 가져오기

프로젝트 만들기

프로젝트 수정

프로젝트 삭제

프로젝트 사용량

파일 시스템 작업

파일 시스템 나열

파일 시스템 가져오기

파일 시스템 만들기

파일 시스템 수정

파일 시스템 삭제

파일 시스템 쿼터 및 사용량

LUN 작업

LUNS를 나열합니다.

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