GET /api/hosts
모든 호스트 목록 나열

GET /api/hostgroups/:hostgroup_id/hosts
호스트 그룹 별 모든 호스트 나열

GET /api/locations/:location_id/hosts
위치별 호스트 나열

GET /api/organizations/:organization_id/hosts
조직 별 호스트 나열

GET /api/environments/:environment_id/hosts
환경 별 호스트 나열

Params

Param Name Description
hostgroup_id
Optional

호스트 그룹 ID


Value:

Must be String

location_id
Optional

위치 ID


Value:

Must be String

organization_id
Optional

조직 ID


Value:

Must be String

environment_id
Optional

환경 ID


Value:

Must be String

search
Optional

필터 결과


Value:

Must be String

order
Optional

결과 정렬


Value:

Must be String

page
Optional

페이지네이션 결과


Value:

Must be String

per_page
Optional

요청 당 항목 수


Value:

Must be String


GET /api/hosts/:id
호스트 표시

Params

Param Name Description
id
Required

Value:

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


POST /api/hosts
호스트 생성

Params

Param Name Description
host
Required

Value:

Must be a Hash

host[name]
Required

Value:

Must be String

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

DHCP 프록시를 갖는 서브넷을 사용할 필요가 없습니다


Value:

Must be String

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

관리 호스트가 베어 메탈일 경우 필요하지만 가상 머신일 경우 필요하지 않습니다


Value:

Must be String

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be a number.

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be a number.

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

Value:

Must be a number.

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

Value:

Must be a number.

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

Value:

Must be an array of any type

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

이미지 기반의 프로비저닝이 아니고 호스트가 관리되어 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

호스트가 관리되고 있으며 사용자 정의 파티션이 정의되고 있지 않은 경우에 필요합니다


Value:

Must be a number.

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be a number.

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

nil은 호스트가 베어 메탈임을 의미합니다


Value:

Must be a number.

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

호스트가 관리되고 있으며 값이 호스트 그룹이나 설정의 기본값 암호에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

Value:

Must be a number.

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

Value:

Must be a number.

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

Value:

Must be a number.

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

호스트의 소유자 유형


Value:

Must be one of: User, Usergroup.

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

Value:

Must be a number.

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

Value:

Must be a number.

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

Host's parameters (array or indexed hash)


Value:

Must be an Array of nested elements

host[host_parameters_attributes][name]
Required

Name of the parameter


Value:

Must be String

host[host_parameters_attributes][value]
Required

Parameter value


Value:

Must be String

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

Value:

Must be 'true' or 'false'

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

Value:

Must be 'true' or 'false'

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

The method used to provision the host. Possible provision_methods may be build (네트워크 기반 ), image (이미지 기반 )


Value:

Must be String

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

호스트를 관리할 지 또는 관리하지 않을지에 대한 True/False 플래그입니다. 알림: 이 값은 여러 매개 변수가 필요할 지 또는 필요하지 않을 지에 대한 여부를 결정합니다


Value:

Must be 'true' or 'false'

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

오케스트레이션 작업 상태를 추적하기 위한 UUID, GET /api/orchestration/:UUID/tasks


Value:

Must be String

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

호스트에 대한 추가 정보


Value:

Must be String

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

Value:

Must be String

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

Value:

Must be a number.

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

Host's network interfaces.


Value:

Must be an Array of nested elements

host[interfaces_attributes][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

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

인터페이스의 IP 주소


Value:

Must be String

host[interfaces_attributes][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.

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

Interface's DNS name


Value:

Must be String

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

인터페이스의 Foreman 서브넷 ID


Value:

Must be Fixnum

host[interfaces_attributes][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

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

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


Value:

Must be String

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

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


Value:

Must be 'true' or 'false'

host[interfaces_attributes][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'

host[interfaces_attributes][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'

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

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


Value:

Must be String

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

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


Value:

Must be String

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

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


Value:

Must be one of: IPMI.

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

별칭 또는 VLAN 장치


Value:

Must be 'true' or 'false'

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

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


Value:

Must be String

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

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


Value:

Must be String

host[interfaces_attributes][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.

host[interfaces_attributes][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

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

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


Value:

Must be String

host[interfaces_attributes][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

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

Additional compute resource specific attributes.


Value:

Must be Hash


PUT /api/hosts/:id
호스트 업데이트

Params

Param Name Description
id
Required

Value:

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

host
Required

Value:

Must be a Hash

host[name]
Optional

Value:

Must be String

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

DHCP 프록시를 갖는 서브넷을 사용할 필요가 없습니다


Value:

Must be String

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

관리 호스트가 베어 메탈일 경우 필요하지만 가상 머신일 경우 필요하지 않습니다


Value:

Must be String

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be a number.

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be a number.

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

Value:

Must be a number.

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

Value:

Must be a number.

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

Value:

Must be an array of any type

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

이미지 기반의 프로비저닝이 아니고 호스트가 관리되어 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

호스트가 관리되고 있으며 사용자 정의 파티션이 정의되고 있지 않은 경우에 필요합니다


Value:

Must be a number.

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

호스트가 관리되고 있으며 값이 호스트 그룹에서 상속되지 않은 경우에 필요합니다


Value:

Must be a number.

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

nil은 호스트가 베어 메탈임을 의미합니다


Value:

Must be a number.

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

호스트가 관리되고 있으며 값이 호스트 그룹이나 설정의 기본값 암호에서 상속되지 않은 경우에 필요합니다


Value:

Must be String

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

Value:

Must be a number.

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

Value:

Must be a number.

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

Value:

Must be a number.

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

호스트의 소유자 유형


Value:

Must be one of: User, Usergroup.

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

Value:

Must be a number.

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

Value:

Must be a number.

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

Host's parameters (array or indexed hash)


Value:

Must be an Array of nested elements

host[host_parameters_attributes][name]
Optional

Name of the parameter


Value:

Must be String

host[host_parameters_attributes][value]
Optional

Parameter value


Value:

Must be String

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

Value:

Must be 'true' or 'false'

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

Value:

Must be 'true' or 'false'

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

The method used to provision the host. Possible provision_methods may be build (네트워크 기반 ), image (이미지 기반 )


Value:

Must be String

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

호스트를 관리할 지 또는 관리하지 않을지에 대한 True/False 플래그입니다. 알림: 이 값은 여러 매개 변수가 필요할 지 또는 필요하지 않을 지에 대한 여부를 결정합니다


Value:

Must be 'true' or 'false'

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

오케스트레이션 작업 상태를 추적하기 위한 UUID, GET /api/orchestration/:UUID/tasks


Value:

Must be String

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

호스트에 대한 추가 정보


Value:

Must be String

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

Value:

Must be String

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

Value:

Must be a number.

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

Host's network interfaces.


Value:

Must be an Array of nested elements

host[interfaces_attributes][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

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

인터페이스의 IP 주소


Value:

Must be String

host[interfaces_attributes][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.

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

Interface's DNS name


Value:

Must be String

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

인터페이스의 Foreman 서브넷 ID


Value:

Must be Fixnum

host[interfaces_attributes][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

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

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


Value:

Must be String

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

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


Value:

Must be 'true' or 'false'

host[interfaces_attributes][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'

host[interfaces_attributes][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'

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

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


Value:

Must be String

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

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


Value:

Must be String

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

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


Value:

Must be one of: IPMI.

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

별칭 또는 VLAN 장치


Value:

Must be 'true' or 'false'

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

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


Value:

Must be String

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

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


Value:

Must be String

host[interfaces_attributes][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.

host[interfaces_attributes][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

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

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


Value:

Must be String

host[interfaces_attributes][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

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

Additional compute resource specific attributes.


Value:

Must be Hash


DELETE /api/hosts/:id
호스트 삭제

Params

Param Name Description
id
Required

Value:

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


GET /api/hosts/:id/status
Get configuration status of host

Return value may either be one of the following:

  • missing

  • failed

  • pending

  • changed

  • unchanged

  • unreported

Params

Param Name Description
id
Required

Value:

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


GET /api/hosts/:id/status/:type
호스트 상태 가져오기

Returns string representing a host status of a given type

Params

Param Name Description
id
Required

Value:

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

type
Required

status type, can be one of

  • global

  • configuration

  • build


Value:

Must be one of: HostStatus::Global, configuration, build.


GET /api/hosts/:id/vm_compute_attributes
Get vm attributes of host

Return the host's compute attributes that can be used to create a clone of this VM

Params

Param Name Description
id
Required

Value:

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


PUT /api/hosts/:id/puppetrun
호스트에서 Puppet 에이전트 실행을 강제합니다

Params

Param Name Description
id
Required

Value:

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


PUT /api/hosts/:id/disassociate
VM에서 호스트 연결 해제

Params

Param Name Description
id
Required

Value:

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


PUT /api/hosts/:id/power
호스트에서 전원 작업을 실행합니다

Params

Param Name Description
id
Required

Value:

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

power_action
Required

전원 동작, 유효한 동작은 (on/start), (off/stop), (soft/reboot), (cycle/reset), (state/status)입니다.


Value:

Must be String


PUT /api/hosts/:id/boot
지정된 장치에서 호스트 부팅

Params

Param Name Description
id
Required

Value:

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

device
Required

부팅 장치, 유효한 장치는 디스크, CDROM, PXE, BIOS입니다


Value:

Must be String


POST /api/hosts/facts
호스트의 팩트를 업로드하고 필요한 경우 호스트를 생성합니다

Params

Param Name Description
name
Required

호스트의 호스트 이름


Value:

Must be String

facts
Required

호스트의 팩트가 포함된 해시


Value:

Must be Hash

certname
Optional

옵션: 호스트의 인증서 이름


Value:

Must be String

type
Optional

옵션: 생성할 호스트의 STI 유형


Value:

Must be String


PUT /api/hosts/:id/rebuild_config
Rebuild orchestration config

Params

Param Name Description
id
Required

Value:

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


GET /api/hosts/:id/template/:kind
Preview rendered provisioning template content

Params

Param Name Description
id
Required

Value:

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

kind
Required

Template kinds, available values:


Value:

Must be String