GET /api/hosts/:host_id/interfaces
호스트의 모든 인터페이스 목록 나열

GET /api/domains/:domain_id/interfaces
도메인의 모든 인터페이스 목록 나열

GET /api/subnets/:subnet_id/interfaces
서브넷의 모든 인터페이스 목록 나열

Params

Param Name Description
host_id
Required

ID 또는 호스트 이름


Value:

Must be String

domain_id
Optional

ID 또는 도메인 이름


Value:

Must be String

subnet_id
Optional

ID 또는 서브넷 이름


Value:

Must be String

page
Optional

페이지네이션 결과


Value:

Must be String

per_page
Optional

요청 당 항목 수


Value:

Must be String


GET /api/hosts/:host_id/interfaces/:id
호스트의 인터페이스 표시

Params

Param Name Description
host_id
Required

ID 또는 호스트 이름


Value:

Must be String

id
Required

ID 또는 인터페이스 이름


Value:

Must be String


POST /api/hosts/:host_id/interfaces
호스트에 인터페이스 생성

Params

Param Name Description
host_id
Required

ID 또는 호스트 이름


Value:

Must be String

interface
Required

인터페이스 정보


Value:

Must be a Hash

interface[mac]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

MAC address of interface. Required for managed interfaces on bare metal.


Value:

Must be String

interface[ip]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스의 IP 주소


Value:

Must be String

interface[type]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Interface type, e.g. bmc. Default is interface


Value:

Must be one of: interface, bmc, bond, bridge.

interface[name]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Interface's DNS name


Value:

Must be String

interface[subnet_id]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스의 Foreman 서브넷 ID


Value:

Must be Fixnum

interface[domain_id]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Foreman domain ID of interface. Required for primary interfaces on managed hosts.


Value:

Must be Fixnum

interface[identifier]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

장치 식별자. 예: eth0 또는 eth1.1


Value:

Must be String

interface[managed]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

이 인터페이스는 DHCP 및 DNS 스마트 프록시를 통해 관리하고 프로비저닝 동안 설정해야 합니까?


Value:

Must be 'true' or 'false'

interface[primary]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Should this interface be used for constructing the FQDN of the host? Each managed hosts needs to have one primary interface.


Value:

Must be 'true' or 'false'

interface[provision]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Should this interface be used for TFTP of PXELinux (or SSH for image-based hosts)? Each managed hosts needs to have one provision interface.


Value:

Must be 'true' or 'false'

interface[username]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

BMC 인터페이스만 해당합니다.


Value:

Must be String

interface[password]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

BMC 인터페이스만 해당합니다.


Value:

Must be String

interface[provider]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스 공급자 (예: IPMI). BMC 인터페이스의 경우에만 사용할 수 있습니다.


Value:

Must be one of: IPMI.

interface[virtual]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

별칭 또는 VLAN 장치


Value:

Must be 'true' or 'false'

interface[tag]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

VLAN 태그입니다. 이 속성은 서브넷 VLAN ID 보다 우선합니다. 가상 인터페이스의 경우에만 사용됩니다.


Value:

Must be String

interface[attached_to]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

이 인터페이스가 속한 인터페이스의 ID (예: eth1) 가상 인터페이스의 경우에만 사용할 수 있습니다.


Value:

Must be String

interface[mode]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스의 본드 모드 (예: balance-rr). 본드 인터페이스에만 사용됩니다.


Value:

Must be one of: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb.

interface[attached_devices]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Identifiers of attached interfaces, e.g. `['eth1', 'eth2']`. For bond interfaces those are the slaves. Only for bond and bridges interfaces.


Value:

Must be an array of any type

interface[bond_options]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

공백으로 구분된 옵션 (예: miimon=100). 본드 인터페이스의 경우에만 사용합니다.


Value:

Must be String

interface[compute_attributes]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Additional compute resource specific attributes for the interface.


Value:

Must be Hash


PUT /api/hosts/:host_id/interfaces/:id
호스트 인터페이스 업데이트

Params

Param Name Description
host_id
Required

ID 또는 호스트 이름


Value:

Must be String

id
Required

인터페이스 ID


Value:

Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, underscore(_), hypen(-) with no leading or trailing space.

interface
Required

인터페이스 정보


Value:

Must be a Hash

interface[mac]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

MAC address of interface. Required for managed interfaces on bare metal.


Value:

Must be String

interface[ip]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스의 IP 주소


Value:

Must be String

interface[type]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Interface type, e.g. bmc. Default is interface


Value:

Must be one of: interface, bmc, bond, bridge.

interface[name]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Interface's DNS name


Value:

Must be String

interface[subnet_id]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스의 Foreman 서브넷 ID


Value:

Must be Fixnum

interface[domain_id]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Foreman domain ID of interface. Required for primary interfaces on managed hosts.


Value:

Must be Fixnum

interface[identifier]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

장치 식별자. 예: eth0 또는 eth1.1


Value:

Must be String

interface[managed]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

이 인터페이스는 DHCP 및 DNS 스마트 프록시를 통해 관리하고 프로비저닝 동안 설정해야 합니까?


Value:

Must be 'true' or 'false'

interface[primary]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Should this interface be used for constructing the FQDN of the host? Each managed hosts needs to have one primary interface.


Value:

Must be 'true' or 'false'

interface[provision]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Should this interface be used for TFTP of PXELinux (or SSH for image-based hosts)? Each managed hosts needs to have one provision interface.


Value:

Must be 'true' or 'false'

interface[username]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

BMC 인터페이스만 해당합니다.


Value:

Must be String

interface[password]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

BMC 인터페이스만 해당합니다.


Value:

Must be String

interface[provider]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스 공급자 (예: IPMI). BMC 인터페이스의 경우에만 사용할 수 있습니다.


Value:

Must be one of: IPMI.

interface[virtual]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

별칭 또는 VLAN 장치


Value:

Must be 'true' or 'false'

interface[tag]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

VLAN 태그입니다. 이 속성은 서브넷 VLAN ID 보다 우선합니다. 가상 인터페이스의 경우에만 사용됩니다.


Value:

Must be String

interface[attached_to]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

이 인터페이스가 속한 인터페이스의 ID (예: eth1) 가상 인터페이스의 경우에만 사용할 수 있습니다.


Value:

Must be String

interface[mode]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

인터페이스의 본드 모드 (예: balance-rr). 본드 인터페이스에만 사용됩니다.


Value:

Must be one of: balance-rr, active-backup, balance-xor, broadcast, 802.3ad, balance-tlb, balance-alb.

interface[attached_devices]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Identifiers of attached interfaces, e.g. `['eth1', 'eth2']`. For bond interfaces those are the slaves. Only for bond and bridges interfaces.


Value:

Must be an array of any type

interface[bond_options]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

공백으로 구분된 옵션 (예: miimon=100). 본드 인터페이스의 경우에만 사용합니다.


Value:

Must be String

interface[compute_attributes]
Optional , <span class="translation_missing" title="translation missing: ko.apipie.nil_allowed">Nil Allowed</span>

Additional compute resource specific attributes for the interface.


Value:

Must be Hash


DELETE /api/hosts/:host_id/interfaces/:id
호스트 인터페이스 삭제

Params

Param Name Description
host_id
Required

ID 또는 호스트 이름


Value:

Must be String

id
Required

인터페이스 ID


Value:

Must be String