6.214. StorageDomainVm


표 6.652. 메서드 요약
이름요약

get

 

import

내보내기 스토리지 도메인에서 가상 머신을 가져옵니다.

register

 

제거

내보내기 스토리지 도메인에서 가상 머신을 삭제합니다.

6.214.1. GET가져오기

표 6.653. 매개변수 요약
이름유형방향요약

팔로우

문자열

in

따라야 할 내부 링크를 나타냅니다.

vm

Vm

Out

 

6.214.1.1. 팔로우

따라야 할 내부 링크를 나타냅니다. 이러한 링크에서 참조하는 오브젝트는 현재 요청의 일부로 가져옵니다. 자세한 내용은 여기를 참조하십시오.

6.214.2. POST가져오기

내보내기 스토리지 도메인에서 가상 머신을 가져옵니다.

예를 들어 다음과 같은 요청을 보냅니다.For example, send a request like this:

POST /ovirt-engine/api/storagedomains/123/vms/456/import

다음과 같이 요청 본문이 있는 경우:

<action>
  <storage_domain>
    <name>mydata</name>
  </storage_domain>
  <cluster>
    <name>mycluster</name>
  </cluster>
</action>

가상 머신을 새 엔터티로 가져오려면 clone 매개 변수를 추가합니다.

<action>
  <storage_domain>
    <name>mydata</name>
  </storage_domain>
  <cluster>
    <name>mycluster</name>
  </cluster>
  <clone>true</clone>
  <vm>
    <name>myvm</name>
  </vm>
</action>

가져올 디스크를 선택하려면 선택적 disks 매개변수를 포함합니다. 예를 들어 식별자가 123456 인 템플릿의 디스크를 가져오려면 다음 요청 본문을 보냅니다.

<action>
  <cluster>
    <name>mycluster</name>
  </cluster>
  <vm>
    <name>myvm</name>
  </vm>
  <disks>
    <disk id="123"/>
    <disk id="456"/>
  </disks>
</action>

클러스터 ID 또는 이름을 지정하지 않고 엔터티를 등록하면 엔터티 OVF의 클러스터 이름이 사용됩니다(등록 요청에 클러스터 매핑도 포함되지 않는 경우).

표 6.654. 매개변수 요약
이름유형방향요약

async

부울

in

비동기적으로 가져오기를 수행해야 하는지 여부를 나타냅니다.Indicates if the import should be performed asynchronously.

clone

부울

in

가져온 가상 머신의 식별자를 다시 생성해야 하는지 여부를 나타냅니다.

cluster

Cluster

in

 

collapse_snapshots

부울

in

가져온 가상 머신의 스냅샷을 축소해야 하므로 스냅샷이 없는 가상 머신이 생성됩니다.

exclusive

부울

in

 

storage_domain

StorageDomain

in

 

vm

Vm

in

 

6.214.2.1. clone

가져온 가상 머신의 식별자를 다시 생성해야 하는지 여부를 나타냅니다.

기본적으로 가상 머신을 가져올 때 식별자는 보존됩니다. 즉, 식별자가 고유해야 하므로 동일한 가상 머신을 여러 번 가져올 수 없습니다. 기본값이 false 이므로 동일한 머신을 여러 번 가져올 수 있도록 하려면 이 매개변수를 true 로 설정합니다.

6.214.2.2. collapse_snapshots

가져온 가상 머신의 스냅샷을 축소해야 하므로 스냅샷이 없는 가상 머신이 생성됩니다.

이 매개변수는 선택 사항이며 기본값을 명시적으로 지정하지 않은 경우 기본값은 false 입니다.

6.214.3. POST등록

표 6.655. 매개변수 요약
이름유형방향요약

allow_partial_import

부울

in

가상 머신이 일부 디스크에만 등록할 수 있는지 여부를 나타냅니다.

async

부울

in

등록을 비동기적으로 수행해야 하는지 여부를 나타냅니다.

clone

부울

in

 

cluster

Cluster

in

 

reassign_bad_macs

부울

in

엔진에 의해 가져오기 프로세스 중에 문제가 있는 MAC 주소를 다시 할당해야 하는지 여부를 나타냅니다.

registration_configuration

RegistrationConfiguration

in

이 매개변수는 가상 시스템을 등록하는 방법을 설명합니다.

vm

Vm

in

 

vnic_profile_mappings

VnicProfileMapping[]

in

가져오기\register 프로세스 중에 적용할 가상 NIC 프로파일의 매핑 규칙을 설명하는 더 이상 사용되지 않는 속성입니다.

6.214.3.1. allow_partial_import

가상 머신이 일부 디스크에만 등록할 수 있는지 여부를 나타냅니다.

이 플래그가 true 이면 이미지를 찾을 수 없는 경우 검증 프로세스에서 엔진이 실패하지 않습니다. 대신, 누락된 디스크 없이 가상 시스템을 등록할 수 있습니다. 이는 주로 일부 스토리지 도메인을 사용할 수 없는 경우 가상 시스템을 등록하는 동안 사용됩니다. 기본값은 false입니다.

6.214.3.2. reassign_bad_macs

엔진에 의해 가져오기 프로세스 중에 문제가 있는 MAC 주소를 다시 할당해야 하는지 여부를 나타냅니다.

다음 중 하나에 해당하는 경우 MAC 주소는 문제가 있는 것으로 간주됩니다.

  • 대상 환경의 가상 머신에 이미 할당된 MAC 주소와 충돌합니다.
  • 이는 대상 MAC 주소 풀의 범위 밖에 없습니다.

6.214.3.3. registration_configuration

이 매개변수는 가상 시스템을 등록하는 방법을 설명합니다.

이 매개변수는 선택 사항입니다. 매개 변수를 지정하지 않으면 가상 머신이 생성된 원래 환경에 있는 것과 동일한 구성으로 등록됩니다.

6.214.3.4. vnic_profile_mappings

가져오기\register 프로세스 중에 적용할 가상 NIC 프로파일의 매핑 규칙을 설명하는 더 이상 사용되지 않는 속성입니다.

주의

이 속성은 엔진의 버전 4.2.1부터 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 보존됩니다. 이는 향후 삭제될 예정입니다. vnic_profile_mappings 를 지정하려면 RegistrationConfiguration 유형 내에 vnic_profile_mappings 속성을 사용합니다.

6.214.4. DELETE제거

내보내기 스토리지 도메인에서 가상 머신을 삭제합니다.

예를 들어 스토리지 도메인( 123 )에서 가상 머신(4656)을 삭제하려면 다음과 같은 요청을 보냅니다.

DELETE /ovirt-engine/api/storagedomains/123/vms/456
표 6.656. 매개변수 요약
이름유형방향요약

async

부울

in

제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다.

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.