네트워크 데이터 링크

언어:

네트워크 데이터 링크 명령은 어플라이언스에 대한 데이터 링크 관리를 제공합니다. 데이터 링크 리소스를 나열, 수정, 생성 및 삭제할 수 있습니다.

표 31 네트워크 데이터 링크 명령

요청	경로 /network/v1	설명
POST	/datalinks	새 네트워크 데이터 링크를 만듭니다.
GET	/datalinks/<`datalink`>	지정된 네트워크 데이터 링크 등록 정보를 가져옵니다.
GET	/datalinks	모든 네트워크 데이터 링크 객체를 나열합니다.
PUT	/datalinks/<`datalink`>	지정된 네트워크 데이터 링크 객체를 수정합니다.
DELETE	/datalinks/<`datalink`>	지정된 데이터 링크 객체를 삭제합니다.

표 32 물리적 장치 데이터 링크 등록 정보

등록 정보	유형	설명
class	String	"device"("immutable")
label	NetworkLabel	레이블
links	ChooseOne	링크 [“igb1”, “igb0”, “ixgbe2”, “ixgbe3”, “igb4”, “igb3”, “ixgbe1”, “igb2”, “igb5”]
jumbo	부울	점보 프레임 사용 ["true", "false"]("deprecated")
mtu	PositiveInteger	최대 전송 단위(MTU)
speed	ChooseOne	링크 속도 [“auto”, “10”, “100”, “1000”, “10000”]
duplex	ChooseOne	링크 이중 [“auto”, “half”, “full”]

표 33 VNIC 장치 데이터 링크 등록 정보

등록 정보	유형	설명
class	String	“vnic” (“immutable”)
label	NetworkLabel	레이블
links	ChooseOne	링크 ["ixgbe0"]
mtu	PositiveInteger	최대 전송 단위(MTU)
id	VLAN	VLAN ID

표 34 VLAN 장치 데이터 링크 등록 정보

등록 정보	유형	설명
class	String	"vlan"("immutable")
label	NetworkLabel	레이블
links	ChooseOne	링크 ["ixgbe0"]
mtu	PositiveInteger	최대 전송 단위(MTU)
id	VLAN	VLAN ID

표 35 통합 기반 장치 데이터 링크 등록 정보

등록 정보	유형	설명
class	String	"aggregation"("immutable")
label	NetworkLabel	레이블
links	ChooseN	링크 [“igb1”, “igb0”, “ixgbe2”, “ixgbe3”, “igb4”, “igb3”, “ixgbe1”, “igb2”, “igb5”]
jumbo	부울	점보 프레임 사용 ["true", "false"]("deprecated")
mtu	PositiveInteger	최대 전송 단위(MTU)
policy	ChooseOne	정책 [“L2”, “L3”, “L4”, “L2+L3”, “L2+L4”, “L3+L4”]
mode	ChooseOne	모드 [“active”, “passive”, “off”]
timer	ChooseOne	타이머 [“short”, “long”]
key	Integer	통합 키("immutable")

표 36 IP 분할 영역 기반 장치 데이터 링크 등록 정보

등록 정보	유형	설명
class	String	"partition"("immutable")
label	NetworkLabel	레이블
links	ChooseOne	링크
pkey	Pkey	분할 영역 키
linkmode	ChooseOne	링크 모드 ["cm", "ud"]

네트워크 데이터 링크 나열

어플라이언스의 구성된 모든 데이터 링크를 나열합니다. 데이터 링크 목록의 각 객체는 데이터 링크 등록 정보와 함께 단일 데이터 링크 리소스에 대한 작업을 가져오는 href를 포함합니다.

요청 예:

GET /api/network/v1/datalinks HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

JSON 데이터 예:

{
    "datalinks": [{
        "href": "/api/network/v1/datalinks/ixgbe0",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe1",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe2",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe3",
        ...
    }]
}

네트워크 데이터 링크 가져오기

GET 메소드는 데이터 링크 객체 목록과 함께 데이터 링크 등록 정보를 포함하는 JSON 객체를 반환합니다.

GET /api/network/v1/datalinks/ixgbe0 HTTP/1.1 Host: zfs-storage.example.com

Accept: application/json

JSON 데이터 예:

{
    "datalink": {
        "class": "device",
        "datalink": "ixgbe0",
        "duplex": "auto",
        "href": "/api/network/v1/datalinks/ixgbe0",
        "jumbo": false,
        "label": "Untitled Datalink",
        "links": [
            "ixgbe0"
        ],
        "mac": "0:21:28:a1:d9:68",
        "mtu": 1500,
        "speed": "auto"
    }
}

네트워크 데이터 링크 만들기

POST 명령은 새 데이터 링크를 만듭니다. 새 데이터 링크를 만들 때 필요한 하나의 추가 등록 정보는 만들 데이터 링크의 클래스를 정의하는 클래스 등록 정보입니다. 데이터 링크 클래스는 데이터 링크를 만드는 동안 정의되고 다음 클래스 유형 중 하나일 수 있습니다.

device - 장치 기반 데이터 링크를 만듭니다.
vnic - VNIC 기반 데이터 링크를 만듭니다.
vlan - VLAN 기반 데이터 링크를 만듭니다.
aggregation - 통합 기반 데이터 링크를 만듭니다.
partition - IB 분할 영역 데이터 링크를 만듭니다.

등록 정보는 "구성 네트 데이터 링크" 메뉴에서 사용할 수 있는 동일한 CLI 등록 정보에 매핑됩니다.

요청 예:

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

{
    "class": "device",
     "jumbo": true,
     "links": ["ixgbe2"],
     "label": "TestDataLink"
}

응답 예:

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

네트워크 데이터 링크 수정

PUT 메소드는 데이터 링크 등록 정보를 수정하는 데 사용됩니다. 데이터 링크 설정에 대한 자세한 내용은 CLI 설명서를 참조하십시오.

요청 예:

PUT /api/network/v1/datalinks/ixgbe2 HTTP/1.1

{"jumbo": true}

응답 예:

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

{
    "datalink": {
        "href": "/api/network/v1/datalinks/ixgbe2",
        "class": "device",
        "label": "MyDataLink",
        "links": ["ixgbe2"],
        "mac": "0:21:28:a1:d9:6a",
        "mtu": 9000,
        "duplex": "auto",
        "jumbo": true,
        "speed": "auto"
    }
}

네트워크 데이터 링크 삭제

이 명령은 시스템에서 데이터 링크를 제거합니다. href 경로를 사용하여 지정된 데이터 링크를 삭제합니다.

요청 예:

DELETE /api/network/v1/datalinks/ixgbe2 HTTP/1.1

응답 예:

HTTP/1.1 204 No Content