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

네트워크 인터페이스

표 24  네트워크 인터페이스 명령

요청 경로 /api/network/v{1|2}에 추가 설명 POST /interfaces 새 네트워크 인터페이스를 만듭니다. GET /interfaces/interface 지정된 네트워크 인터페이스 등록 정보를 가져옵니다. GET /interfaces 모든 네트워크 인터페이스 객체를 나열합니다. PUT /interfaces/interface 지정된 네트워크 인터페이스 객체를 수정합니다. DELETE /interfaces/interface 지정된 인터페이스 객체를 삭제합니다.

표 25  네트워크 인터페이스 등록 정보

등록 정보 설명 admin 이 인터페이스에 대한 관리가 허용되는지 여부를 나타내는 플래그 class 클래스 유형("ip", "ipmp")(만든 후 변경할 수 없음) curaddrs 현재 IP 주소(변경할 수 없음) enable 이 인터페이스를 사용으로 설정할지 여부를 나타내는 플래그 label 인터페이스에 대한 사용자 레이블 links 이 인터페이스에 대한 네트워크 링크 선택 state 인터페이스의 상태(변경할 수 없음) v4addrs IPv4 주소 v6dhcp IPv4 DHCP 플래그 v6addrs IPv6 주소 v6dhcp IPv6 DHCP 플래그

네트워크 인터페이스 나열

이 명령은 구성된 모든 네트워크 인터페이스를 나열합니다.

요청 예:

GET /api/network/v1/interfaces HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

결과 예:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 369

{
    "interfaces": {[
        "href": "/api/network/v1/interfaces/ixgbe0",
        "v4addrs": ["ipaddr-1"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["ipaddr-2"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["ipaddr-3"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["ipaddr-4"]
        ...
    }]
}

네트워크 인터페이스 가져오기

이 명령은 지정된 네트워크 인터페이스에 대한 등록 정보의 전체 목록을 가져옵니다.

요청 예:

GET /api/network/v1/interfaces/ixgbe0 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

결과 예:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 292

{
    "interface": {
        "admin": true,
        "class": "ip",
        "curaddrs": ["ipaddr-1"],
        "enable": true,
        "href": "/api/network/v1/interfaces/ixgbe0",
        "interface": "ixgbe0",
        "label": "Untitled Interface",
        "links": ["ixgbe0"],
        "state": "up",
        "v4addrs": ["ipaddr-1"],
        "v4dhcp": false,
        "v6addrs": [],
        "v6dhcp": false
    }
}

네트워크 인터페이스 만들기

이 명령은 새 네트워크 인터페이스를 만듭니다.

요청 예:

POST /api/network/v1/interfaces HTTP/1.1
Host: zfs-storage.example.com:215
X-Auth-User: root
X-Auth-Key: password
Content-Type: application/json
Content-Length: 78

{
    "class": "ip",
    "links": ["ixgbe3"],
    "v4addrs":"192.0.2.0/24"
}

결과 예:

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Location: /api/network/v1/interfaces/ixgbe3

네트워크 인터페이스 수정

이 명령은 기존 네트워크 인터페이스를 수정합니다.

요청 예:

PUT /api/network/v1/interfaces/ixgbe3 HTTP/1.1

{
    "v4addrs": ["192.0.2.0/24"],
    "interface": "Demo Rest"
}

결과 예:

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

{
    "admin": true,
    "class": "ip",
    "curaddrs": ["192.0.2.0/24"],
    "enable": true,
    "href": "/api/network/v1/interfaces/ixgbe3",
    "interface": "ixgbe3",
    "label": "Demo Rest",
    "links": ["ixgbe3"],
    "state": "failed",
    "v4addrs": ["192.0.2.0/24"]
    "v4dhcp": false,
    "v6addrs": [],
    "v6dhcp": false
}

네트워크 인터페이스 삭제

이 명령은 기존 네트워크 인터페이스를 삭제합니다.

요청 예:

DELETE /api/network/v1/interfaces/ixgbe3 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215

결과 예:

HTTP/1.1 204 No Content