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

인쇄 보기 종료

업데이트 날짜: 2016년 9월
 
 

네트워크 인터페이스

표 39  네트워크 인터페이스 명령
요청
경로 /api/network/v1
설명
POST
/interfaces
새 네트워크 인터페이스를 만듭니다.
GET
/interfaces/<interface>
지정된 네트워크 인터페이스 등록 정보를 가져옵니다.
GET
/interfaces
모든 네트워크 인터페이스 객체를 나열합니다.
PUT
/interfaces/<interface>
지정된 네트워크 인터페이스 객체를 수정합니다.
DELETE
/interfaces/<interface>
지정된 인터페이스 객체를 삭제합니다.
표 40  네트워크 인터페이스 등록 정보
이름
설명
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 abcd1234MWE=
Host: zfssa.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": ["10.80.231.58/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["10.80.231.59/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["10.80.231.60/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["10.80.231.61/24"]
        ...
    }]
}

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

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

요청 예:

GET /api/network/v1/interfaces/ixgbe0 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215
Accept: application/json

응답 예:

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

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

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

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

요청 예:

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

{
    "class": "ip",
    "links": ["ixgbe3"],
    "v4addrs":"192.168.1.9/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.168.1.99/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.168.1.9/24"],
    "enable": true,
    "href": "/api/network/v1/interfaces/ixgbe3",
    "interface": "ixgbe3",
    "label": "Demo Rest",
    "links": ["ixgbe3"],
    "state": "failed",
    "v4addrs": ["192.168.1.99/24"]
    "v4dhcp": false,
    "v6addrs": [],
    "v6dhcp": false
}

네트워크 인터페이스 삭제

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


주 -  인터페이스가 삭제되면 이와 연관된 모든 경로도 제거됩니다.

요청 예:

DELETE /api/network/v1/interfaces/ixgbe3 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215

결과 예:

HTTP/1.1 204 No Content