네트워크 경로

언어:

해당 명령은 네트워크 경로를 관리합니다.

표 26 네트워크 경로 관리

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

표 27 네트워크 경로 등록 정보 관리

등록 정보	설명
`type`	"system" 또는 "static"과 같은 경로의 유형(변경할 수 없음)
`family`	주소 그룹(IPv4 또는 IPv6)
`destination`	경로 대상 주소
`gateway`	게이트웨이 주소
`interface`	네트워크 데이터 링크 인터페이스

각 경로에 대한 href 경로는 CLI에 설정된 경로 ID를 사용하지만 이러한 값은 경로가 수정될 때 변경될 수 있습니다. API는 경로 내 고유한 등록 정보를 사용하여 단일 경로를 선택합니다. 구문은 routes/route-###과 비교하여 routes/name=value입니다.

경로 나열

어플라이언스에서 만든 모든 네트워크 경로를 나열합니다.

요청 예:

GET /api/network/v1/routes 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: 192

{
    "routes": [{
        "destination": "ipaddr-0",
        "family": "IPv4",
        "gateway": "ipaddr-1",
        "href": "/api/network/v1/routing/route-000",
        "interface": "ixgbe0",
        "mask": 0,
        "route": "route-000",
        "type": "static"
    }, {
        "destination": "ipaddr-2",
        "family": "IPv4",
        "gateway": "ipaddr-3",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }]
}

경로 가져오기

단일 경로에 대한 등록 정보를 가져옵니다.

요청 예:

GET /api/network/v1/routes/destination=ipaddr-1 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: 192

{
    "route": {
        "destination": "ipaddr-1",
        "family": "IPv4",
        "gateway": "ipaddr-2",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }
}

경로 추가

새 네트워크 경로를 만듭니다. 경로 href 값은 다른 경로가 시스템에 추가된 경우 변경될 수 있습니다. 반환된 등록 정보가 입력 등록 정보와 동일하므로 만들 때 경로 정보가 반환되지 않습니다. 성공한 만들기는 HTTP 상태 204(Created)를 반환합니다.

정적 경로를 만드는 요청의 예:

POST /api/network/v1/routes HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 164

{
    "family": "IPv4",
    "destination": "ipaddr-0",
    "mask": "0",
    "gateway": "ipaddr-1",
    "interface": "ixgbe0"
}

결과 예:

HTTP/1.1 201 Created

경로 삭제

기존 네트워크 경로를 삭제합니다.

요청 예:

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

결과 예:

HTTP/1.1 204 No Content