네트워크 경로

네트워크 경로를 관리합니다.

표 7-11  네트워크 경로 관리

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

표 7-12  네트워크 경로 등록 정보

이름 설명 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 abcd1234MWE=
Host: zfssa.example.com:215
Accept: application/json

결과 예:

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

{
    "routes": [{
        "destination": "0.0.0.0",
        "family": "IPv4",
        "gateway": "10.80.231.1",
        "href": "/api/network/v1/routing/route-000",
        "interface": "ixgbe0",
        "mask": 0,
        "route": "route-000",
        "type": "static"
    }, {
        "destination": "10.80.231.0",
        "family": "IPv4",
        "gateway": "10.80.231.58",
        "href": "/api/network/v1/routes/route-001",
        "interface": "ixgbe0",
        "mask": 24,
        "route": "route-001",
        "type": "system"
    }]
}

경로 가져오기

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

요청 예:

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

{
    "route": {
        "destination": "10.80.231.0",
        "family": "IPv4",
        "gateway": "10.80.231.58",
        "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 abcd1234MWE=
Host: zfssa.example.com:215
Content-Type: application/json
Content-Length: 164

{
    "family": "IPv4",
    "destination": "0.0.0.0",
    "mask": "0",
    "gateway": "10.11.12.1",
    "interface": "ixgbe0"
}

결과 예:

HTTP/1.1 201 Created

경로 삭제

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

요청 예:

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

결과 예:

HTTP/1.1 204 No Content