Go to main content

Oracle® ZFS Storage Appliance RESTful API 설명서, 릴리스 OS8.8.x

인쇄 보기 종료

업데이트 날짜: 2021년 8월
 
 

클라우드 서비스 작업

클라우드 서비스 작업을 사용하여 Oracle Cloud Infrastructure 객체 스토리지에서 어플라이언스 스냅샷 백업을 관리할 수 있습니다. Oracle Cloud Infrastructure 객체 스토리지의 대상 및 백업을 나열하고, 대상을 제거하고, 백업을 삭제하고, 백업을 새 어플라이언스 공유로 복원하고, 클라우드 서비스 작업을 취소 또는 다시 시작할 수 있습니다.

백업을 만들려면 스냅샷 백업 만들기 in 스냅샷 백업 작업를 참조하십시오. 백업은 공유 스냅샷의 전체 또는 증분 백업입니다. 스냅샷을 만들려면 스냅샷 및 복제 작업을 참조하십시오.

클라우드 서비스 작업 표에서는 다음 매개변수가 사용됩니다.

format

Oracle Cloud Infrastructure 객체 스토리지에서 백업이 저장된 형식입니다.

format의 값은 zfs 또는 tar입니다. 스냅샷 백업 생성에 대한 format이 지정되지 않은 경우 zfs가 기본값입니다. zfs 형식은 파일 시스템과 LUN 스냅샷을 지원하며, tar 형식은 파일 시스템 스냅샷만 지원합니다. zfstar 형식에 대한 자세한 내용은 Creating a Cloud Backup (CLI) in Oracle ZFS Storage Appliance Administration Guide, Release OS8.8.x를 참조하십시오.

backup-id

Oracle Cloud Infrastructure 객체 스토리지에 저장된 어플라이언스 스냅샷의 복사본에 대한 식별자입니다. 클라우드 백업 나열에서와 같이 백업을 나열할 때 backup-id의 값은 id 등록 정보의 값입니다.

전체 스냅샷 백업의 경우 backup-id의 값은 다음 예에서와 같이 pool_id/snapshot_id입니다.

3e035b7e546e0d02/1cbfdb5ff2259b76

증분 스냅샷 백업의 경우 backup-id의 값은 다음 예에서와 같이 pool_id/child_snapshot_id-parent_snapshot_id입니다.

6913a5703bee98dc/46be95ced54e99d9-667f3eb88fd209e1
target-id

백업이 저장되는 Oracle Cloud Infrastructure 객체 스토리지 위치입니다. 지정된 백업은 여러 대상에 저장할 수 있습니다. 즉, 동일한 backup-id가 다른 target-id 위치에 나타날 수 있습니다.

백업을 나열할 때 target-id의 값은 target 등록 정보의 값입니다.

job-id

실행 중인 작업의 식별자입니다. 작업 나열에서와 같이 작업을 나열할 때 job-id의 값은 id 등록 정보의 값입니다.

표 28  클라우드 서비스 명령
요청
경로 /api/service/v2/services에 추가
설명
GET
/cloud
대상, 백업 및 작업에 대한 등록 정보와 요약 데이터를 나열합니다.
PUT
/cloud
등록 정보를 수정합니다.
POST
/cloud/targets
새 대상을 만듭니다.
GET
/cloud/targets
대상을 나열합니다.
GET
/cloud/targets/target-id
지정된 대상의 등록 정보를 나열합니다.
PUT
/cloud/targets/target-id
지정된 대상의 등록 정보를 수정합니다.
DELETE
/cloud/targets/target-id
서비스에서 지정된 대상을 제거합니다.
GET
/cloud/backups
모든 형식의 완료된 백업을 모두 나열합니다.
GET
/cloud/backups/format/backup-id/target-id
지정된 백업을 나열합니다.
DELETE
/cloud/backups/format/backup-id/target-id
지정된 백업을 삭제합니다(작업 요청을 제출함).
POST
/cloud/backups/format/backup-id/target-id/restore
지정된 백업을 복원합니다(작업 요청을 제출함).
GET
/cloud/jobs
실행 중인 작업 및 최근에 완료된 작업을 나열합니다.
GET
/cloud/jobs/job-id
지정된 작업의 등록 정보를 나열합니다.
PUT
/cloud/jobs/job-id/cancel
지정된 실행 중인 작업을 취소합니다.
PUT
/cloud/jobs/job-id/restart
지정된 중단된 작업을 다시 시작합니다.

클라우드 서비스 사용

클라우드 서비스를 사용으로 설정하려면 다음 예에서와 같이 statusenable로 설정합니다.

요청 예:

PUT /api/service/v2/services/cloud HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
Content-Type: application/json
Content-Length: 22

{ "<status>": "enable" }

클라우드 서비스 로그 파일 보기

다음 요청을 사용하여 클라우드 서비스에 대한 로그 파일을 볼 수 있습니다.

GET /api/log/v1/logs/appliance-kit-cloud:default HTTP/1.1

클라우드 서비스 등록 정보 나열

요청 예:

GET /api/service/v2/services/cloud HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

HTTP/1.1 200 OK
Date: Wed, 24 Jul 2019 20:30:59 GMT
Content-Length: 843
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8

{
  "service": {
    "href": "/api/service/v2/services/cloud",
    "<status>": "online",
    "tls_version": [
      "TLSv1.1",
      "TLSv1.2"
    ],
    "ciphers": [
      "ECDHE-RSA-AES128-GCM-SHA256",
      "ECDHE-RSA-AES256-GCM-SHA384",
      "DHE-RSA-AES128-GCM-SHA256",
      "DHE-RSA-AES256-GCM-SHA384",
      "AES128-SHA",
      "AES256-SHA",
      "DES-CBC3-SHA"
    ],
    "targets": {
      "href": "/api/service/v2/services/cloud/targets",
      "entries": 2
    },
    "backups": {
      "href": "/api/service/v2/services/cloud/backups",
      "entries": 2548
    },
    "jobs": {
      "href": "/api/service/v2/services/cloud/jobs",
      "entries": 0
    }
  }
}

클라우드 서비스 등록 정보 수정

요청 예:

PUT /api/service/v2/services/cloud HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
Content-Type: application/json
Content-Length: 48

{
    "tls_version": [
        "TLSv1.0","TLSv1.1","TLSv1.2"
    ]
}

대상 나열

다음 예에서는 모든 대상을 나열합니다.

요청 예:

GET /api/service/v2/services/cloud/targets HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

HTTP/1.1 200 OK
Date: Wed, 24 Jul 2019 21:06:18 GMT
Content-Length: 1086
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8

{
    "targets": [{
        "bucket": "pl-test",
        "href": "/api/service/v2/services/cloud/targets/target-id1",
        "id": "target-id1",
        "key": true,
        "location": "https://objectstorage.us-ashburn-1.oraclecloud.com",
        "name": "oci-ashburn",
        "online": true,
        "proxy_host": "",
        "proxy_on": false,
        "proxy_password": false,
        "proxy_user": "",
        "tenancy": "ocid1.tenancy.oc1..tenancy-id",
        "user": "ocid1.user.oc1..user-id"
    },{
        "bucket": "pl-test2",
        "href": "/api/service/v2/services/cloud/targets/target-id2",
        "id": "target-id2",
        "key": true,
        "location": "https://objectstorage.us-phoenix-1.oraclecloud.com",
        "name": "oci-phoenix",
        "online": true,
        "proxy_host": "www-proxy.example.com:80",
        "proxy_on": true,
        "proxy_password": false,
        "proxy_user": "",
        "tenancy": "ocid1.tenancy.oc1..tenancy-id",
        "user": "ocid1.user.oc1..user-id"
    }]
}

다음 예에서는 지정된 대상을 나열합니다.

GET /api/service/v2/services/cloud/targets/target-id HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

대상 만들기

클라우드 대상을 만들려면 다음 매개변수가 필요합니다.

매개변수
설명
key
user-id에 대한 Oracle Cloud Infrastructure 계정 사용자 키
tenancy-id
Oracle Cloud Infrastructure 계정 테넌시 이름 OCID
user-id
Oracle Cloud Infrastructure 계정 사용자 이름 OCID

다음 예에서는 대상을 만듭니다.

요청 예:

POST /api/service/v2/services/cloud/targets HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=

{
    "name": "oci4",
    "location": "https://objectstorage.us-phoenix-1.oraclecloud.com",
    "user": "ocid1.user.oc1..user-id",
    "bucket": "test-bucket3",
    "tenancy": "ocid1.tenancy.oc1..tenancy-id",
    "key": "key",
    "proxy_on": false,
    "readlimit": -1,
    "writelimit": -1
}

결과 예:

HTTP/1.1 201 Created
Date: Wed, 24 Jul 2019 21:14:39 GMT
Content-Length: 568
X-Zfssa-Service-Api: 2.0
Location: /api/service/v2/services/cloud/targets/target-id
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8

{
    "target": {
        "bucket": "test-bucket3",
        "href": "/api/service/v2/services/cloud/targets/target-id",
        "id": "target-id",
        "key": true,
        "location": "https://objectstorage.us-phoenix-1.oraclecloud.com",
        "name": "oci4",
        "proxy_on": false,
        "readlimit": -1,
        "state": "offline",
        "tenancy": "ocid1.tenancy.oc1..tenancy-id",
        "user": "ocid1.user.oc1..user-id",
        "writelimit": -1
    }
}

대상 수정

다음 표에서는 클라우드 대상에 대해 수정 가능한 등록 정보를 보여줍니다.

등록 정보
설명
name
각 어플라이언스에서 고유해야 할 이 클라우드 대상의 이름입니다.
proxy_on
true인 경우 인터넷과의 시스템 통신에 프록시를 사용합니다.
proxy_on의 값이 true인 경우 proxy_host에 대한 값을 제공해야 합니다.
proxy_host
프록시 호스트 이름 및 포트 번호입니다.
proxy_password
선택사항입니다. 프록시 암호입니다.
proxy_user
선택사항입니다. 프록시 사용자 이름입니다.
readlimit
선택사항입니다. 클라우드 대상에서 데이터를 읽을 초당 최대 바이트 속도입니다. 클라우드 백업이 클라우드에서 복원될 때 이 값이 사용됩니다. 예를 들어, 값이 4194304인 경우 클라우드 대상에서 읽기 속도가 초당 4MB로 제한됩니다. 값이 -1이면 I/O가 제한되지 않습니다.
writelimit
선택사항입니다. 클라우드 대상에 데이터를 쓸 초당 최대 바이트 속도입니다. 클라우드 스냅샷이 클라우드 대상으로 업로드될 때 이 값이 사용됩니다. 예를 들어, 값이 5242880인 경우 클라우드 대상에 쓰기 속도가 초당 5MB로 제한됩니다. 값이 -1이면 I/O가 제한되지 않습니다.

요청 예:

PUT /api/service/v2/services/cloud/targets/target-id HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
User-Agent: curl/7.54.0
Accept: */*
Content-Type: application/json
Content-Length: 19
{
    "proxy_on": true,
    "proxy_host": "www-proxy.example.com:80",
    "readlimit": 4194304,
    "writelimit": 5242880
}

대상 삭제

대상을 삭제하기 전에 다음을 확인합니다.

  • 이 대상에 대한 백업이 진행 중인지 여부. 작업 나열을 참조하십시오.

  • 이 대상에 백업이 있는지 여부. 클라우드 백업 나열에서와 같이 target 필터를 사용하여 이 대상에 저장된 백업을 나열합니다.

다음 예에서는 지정된 클라우드 대상을 서비스에서 제거합니다.

요청 예:

DELETE /api/service/v2/services/cloud/targets/target-id HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

HTTP/1.1 204 No Content
Date: Wed, 24 Jul 2019 21:20:27 GMT
X-Content-Type-Options: nosniff
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8

클라우드 백업 나열

다음 질의를 사용하여 모든 형식의 완료된 백업을 모두 나열할 수 있습니다(최신 백업이 먼저 나열됨). 진행 중인 백업에 대한 정보를 가져오려면 작업 나열을 참조하십시오.

요청 예:

GET /api/service/v2/services/cloud/backups HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

이 예에서 나열된 첫번째 백업은 나열된 두번째 백업의 자식입니다. 첫번째 백업의 parent 값은 두번째 백업(app-data-fullsnap)의 dataset 값과 동일하며, 두번째 백업의 parent 값은 널입니다. 자식 백업은 부모와 동일한 format이 됩니다. 이 예에서는 자식 백업과 부모 백업이 tar 형식입니다.

HTTP/1.1 200 OK
Date: Wed, 22 Jan 2020 21:22:40 GMT
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked

{
    "backups": [{
        "target": "target-id2",
        "parent": "app-data-fullsnap",
        "started": "2020-01-06T20:03:32Z",
        "completed": "2020-01-06T20:04:36Z",
        "id": "backup-id2",
        "source": "cloudsnap0",
        "href": "/api/service/v2/services/cloud/backups/tar/backup-id2/target-id2",
        "tier": "standard",
        "dataset": "p1/local/default/app-data@app-data-incsnap",
        "format": "tar",
        "size": 3224982536.0
    },{
        "target": "target-id1",
        "parent": "",
        "started": "2020-01-06T20:01:16Z",
        "completed": "2020-01-06T20:01:17Z",
        "id": "backup-id1",
        "source": "cloudsnap0",
        "href": "/api/service/v2/services/cloud/backups/tar/backup-id1/target-id1",
        "tier": "standard",
        "dataset": "p1/local/default/app-data@app-data-fullsnap",
        "format": "tar",
        "size": 2149988056.0
    }]
}

다음 요청을 사용하여 지정된 백업을 나열할 수 있습니다.

GET /api/service/v2/services/cloud/backups/format/backup-id/target-id HTTP/1.1

클라우드 백업 질의 매개변수 나열

클라우드 백업 목록을 필터링할 수 있도록 다음과 같은 질의 매개변수가 지원됩니다. 모든 매개변수를 동일한 질의에서 사용할 수 있습니다. 표 뒤에 나오는 예에서와 같이 질의 매개변수 사이에 AND 연산(&)을 사용합니다.

표 29  클라우드 백업 나열을 위한 질의 매개변수
등록 정보
설명
start
start의 값은 다음 중 하나입니다.
  • 백업 인덱스입니다. 이 인덱스의 값은 0부터 entries 등록 정보(클라우드 서비스 등록 정보 나열에 표시되는 요청의 backups 절에 있음)의 값보다 1 작은 수까지입니다.

    지정된 인덱스로 선택된 백업 및 지정된 백업이 만들어진 후 만들어진 가장 오래된 백업을 나열합니다.

  • %Y-%m-%dT%H:%M:%SZ 형식의 시간입니다. 이는 startedcompleted 등록 정보의 값에 사용되는 동일한 형식입니다. 이 시간은 현재 시간까지의 모든 실시간일 수 있습니다. 예를 들어, 2019-09-00T00:00:00Z는 실시간이 아닙니다.

    지정된 시간 또는 그 이후에 만들어진 가장 오래된 백업을 나열합니다.

end
end의 값은 %Y-%m-%dT%H:%M:%SZ 형식의 시간입니다. 이는 startedcompleted 등록 정보의 값에 사용되는 동일한 형식입니다. 이 시간은 현재 시간까지의 모든 실시간일 수 있습니다. 예를 들어, 2019-09-00T00:00:00Z는 실시간이 아닙니다.
지정된 시간 또는 그 이전에 만들어진 최신 백업을 나열합니다.
limit
지정된 수 이하의 백업을 나열합니다. limit 매개변수에는 기본값이 없습니다.
target
target 등록 정보의 값입니다. 해당 대상의 최신 백업을 나열합니다.
source
source 등록 정보의 값입니다. 해당 소스의 최신 백업을 나열합니다.
dataset
@ 앞에 있는 dataset 등록 정보의 값입니다. 예를 들어, 데이터 세트 p1/local/default/app-data@app-data-incsnap의 경우 p1/local/default/app-data 또는 app-data를 지정합니다.
지정된 데이터 세트의 최신 백업을 나열합니다.

주 -  데이터 세트 백업에 대한 요청은 이름에 요청된 데이터 세트 이름이 포함된 모든 데이터 세트의 모든 백업을 나열합니다. 예를 들어, p1/local/default/app-data@app-data-incsnap의 백업에 대한 요청은 이름이 app-data-incsnap, app-data-incsnap-1myproj-app-data-incsnap인 데이터 세트의 백업도 반환합니다.

format
format 등록 정보의 값(zfs 또는 tar)입니다. 지정된 백업 형식의 최신 백업을 나열합니다.

다음 예에서는 인덱스 번호가 2000인 백업부터 시작하여 가장 오래된 백업을 나열합니다. 클라우드 서비스 등록 정보 목록의 backups 절에서 entries 등록 정보의 값이 2865인 경우 다음 예에서는 865개 백업(백업 2000부터 백업 2864까지)을 보여줍니다.

GET /api/service/v2/services/cloud/backups?start=2000

다음 예에서는 인덱스 번호가 2000인 백업만 나열합니다.

GET /api/service/v2/services/cloud/backups?start=2000&limit=1

다음 예에서는 지정된 시간 또는 그 이후에 만들어진 가장 오래된 500개의 백업을 나열합니다.

GET /api/service/v2/services/cloud/backups?start=2019-07-12T00:00:00Z&limit=500

다음 예에서는 지정된 시간 또는 그 이전에 만들어진 최신 500개의 백업을 나열합니다.

GET /api/service/v2/services/cloud/backups?end=2019-07-12T00:00:00Z&limit=500

다음 예에서는 지정된 start 시간 또는 그 이후부터 지정된 end 시간 전까지 만들어진 모든 백업을 나열합니다.

GET /api/service/v2/services/cloud/backups?start=2019-07-11T00:00:00Z&end=2019-07-12T00:00:00Z

다음 예에서는 tar 백업 형식으로 이름에 app-data가 포함된 모든 데이터 세트의 최신 백업을 나열합니다.

GET /api/service/v2/services/cloud/backups?dataset=app-data&format=tar

다음 예에서는 target-id 대상의 이름에 app-data가 있는 모든 데이터 세트의 최신 백업을 나열합니다.

GET /api/service/v2/services/cloud/backups?dataset=app-data&target=target-id

다음 예에서는 소스가 cloudsnap0target-id 대상의 이름에 app-data가 있는 모든 데이터 세트의 최신 백업을 나열합니다.

GET /api/service/v2/services/cloud/backups?dataset=app-data&target=target-id&source=cloudsnap0

클라우드 백업 삭제

클라우드 백업을 삭제하기 전에 다음을 확인합니다.

  • 이 백업의 복원이 진행 중인지 여부. 작업 나열을 참조하십시오.

  • 이 백업에 자식 항목이 있는지 여부. 자식 항목 백업이 있는 백업은 삭제할 수 없습니다. 이 백업의 자식 항목은 삭제할 백업의 dataset 값과 동일한 parent 값을 가집니다. 클라우드 백업 나열을 참조하십시오.

다음 예에서는 지정된 대상의 지정된 백업을 Oracle Cloud Infrastructure 객체 스토리지에서 삭제하려는 작업 요청을 제출합니다. 어플라이언스는 어플라이언스가 액세스할 수 있는 모든 대상의 모든 백업에서 작동할 수 있습니다. 해당 백업이 다른 어플라이언스에서 만들어진 경우에도 마찬가지입니다.

어플라이언스에서 공유 스냅샷 백업을 삭제하는 방법을 보여주는 스냅샷 백업 삭제와 이 작업을 비교합니다.

요청 예:

DELETE /api/service/v2/services/cloud/backups/format/backup-id/target-id HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

{
    "action": "job-id"
}

클라우드 백업 삭제의 진행 상황을 보려면 작업 나열을 사용하여 위 job-id의 작업을 확인합니다.

클라우드 백업 복원

클라우드 백업은 클라우드 대상에 대한 액세스 권한이 있는 모든 어플라이언스에 새로 복제된 공유로 복원할 수 있습니다.

다음 예에서는 지정된 백업을 복원하려는 작업 요청을 제출합니다. 백업을 복원할 풀 및 프로젝트를 지정하고 새 공유에 대한 이름을 지정합니다. 복원의 진행 상황을 보려면 작업 나열을 사용하여 반환된 job-id의 작업을 확인합니다.

대상에 대해 readlimit 등록 정보가 설정된 경우 대상에서 읽는 초당 바이트가 readlimit 이하입니다. 대상 만들기를 참조하십시오.

요청 예:

POST /api/service/v2/services/cloud/backups/format/backup-id/target-id/restore HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
Content-Length: 55

{
    "pool":"p1",
    "project":"default",
    "share": "restore6"
}

결과 예:

{
    "action": "job-id"
}

작업 나열

다음 예에서는 실행 중인 모든 작업 및 최근 완료된 작업을 나열합니다(최신 작업이 먼저 나열됨).

요청 예:

GET /api/service/v2/services/cloud/jobs HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

이 예에서는 두 백업 작업이 동일한 대상에 다른 두 백업을 저장하고 있습니다.

HTTP/1.1 200 OK
Date: Wed, 22 Jan 2020 21:37:52 GMT
Content-Length: 983
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8

{
    "jobs": [{
        "href": "/api/service/v2/services/cloud/jobs/job-id2",
        "op": "backup",
        "target": "target-id",
        "targetName": "oci-ashburn",
        "created": "2020-02-06T16:52:42Z",
        "updated": "2020-02-06T16:52:48Z",
        "id": "job-id2",
        "status": "in-progress",
        "rate": 10002432,
        "transferred": 80019456,
        "estimated_size": 43088792088,
        "dataset": "p1/local/default/f-1",
        "backup": "backup-id2",
        "snapshot": "snap3",
        "format": "tar",
        "details": "uploading backup to zfs/backups/tar/backup-id2/000000001"
    },{
        "href": "/api/service/v2/services/cloud/jobs/job-id1",
        "op": "backup",
        "target": "target-id",
        "targetName": "oci-ashburn",
        "created": "2020-02-06T16:52:28Z",
        "updated": "2020-02-06T16:52:48Z",
        "id": "job-id1",
        "status": "in-progress",
        "rate": 1942,
        "transferred": 3884,
        "estimated_size": 0,
        "dataset": "p1/local/default/f-1",
        "backup": "backup-id1",
        "snapshot": "snap2",
        "format": "zfs",
        "details": "uploading backup to zfs/backups/zfs/backup-id1/000000001"
    }]
}

다음 예에서는 지정된 작업을 나열합니다.

GET /api/service/v2/services/cloud/jobs/job-id2 HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

클라우드 백업 작업 질의 매개변수 나열

클라우드 백업 작업 목록 필터링에는 startlimit 질의 매개변수가 지원됩니다.

  • start 매개변수의 값은 작업 인덱스입니다. 이 인덱스의 값은 0부터 entries 등록 정보(클라우드 서비스 등록 정보 나열에 표시되는 요청의 jobs 절에 있음)의 값보다 1 작은 수까지입니다.

  • limit 매개변수의 값은 나열할 최대 작업 수입니다.

두 매개변수를 동일한 질의에서 사용할 수 있습니다. 다음 예에서와 같이 질의 매개변수 사이에 AND 연산(&)을 사용합니다.

다음 예에서는 실행 중인 100개의 최신 작업 및 최근 완료된 작업을 나열합니다(최신 작업이 먼저 나열됨).

GET /api/service/v2/services/cloud/jobs?limit=100

다음 예에서는 실행 중인 가장 오래된 작업 또는 최근에 완료된 작업만 나열합니다.

GET /api/service/v2/services/cloud/jobs?start=0&limit=1

다음 예에서는 실행 중인 모든 작업 및 작업 인덱스 번호가 4보다 크거나 같은 최근에 완료된 작업을 나열합니다(최신 작업이 먼저 나열됨).

GET /api/service/v2/services/cloud/jobs?start=4

작업 취소 또는 다시 시작

다음 예에서는 지정된 클라우드 서비스 작업을 취소합니다.

요청 예:

PUT /api/service/v2/services/cloud/jobs/job-id/cancel HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

결과 예:

HTTP/1.1 202 Accepted
Date: Wed, 24 Jul 2019 21:50:29 GMT
Content-Length: 0
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8

다음 예에서는 지정된 클라우드 서비스 작업을 다시 시작합니다.

요청 예:

PUT /api/service/v2/services/cloud/jobs/job-id/restart HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
User-Agent: curl/7.54.0
Accept: */*

결과 예:

HTTP/1.1 202 Accepted
Date: Wed, 24 Jul 2019 21:51:08 GMT
Content-Length: 0
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8