6.214. StorageDomainVm
이름 | 요약 |
---|---|
| |
| 내보내기 스토리지 도메인에서 가상 머신을 가져옵니다. |
| |
| 내보내기 스토리지 도메인에서 가상 머신을 삭제합니다. |
6.214.1. GET가져오기
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 따라야 할 내부 링크를 나타냅니다. | |
| 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
매개변수를 포함합니다. 예를 들어 식별자가 123
및 456
인 템플릿의 디스크를 가져오려면 다음 요청 본문을 보냅니다.
<action> <cluster> <name>mycluster</name> </cluster> <vm> <name>myvm</name> </vm> <disks> <disk id="123"/> <disk id="456"/> </disks> </action>
클러스터 ID 또는 이름을 지정하지 않고 엔터티를 등록하면 엔터티 OVF의 클러스터 이름이 사용됩니다(등록 요청에 클러스터 매핑도 포함되지 않는 경우).
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 비동기적으로 가져오기를 수행해야 하는지 여부를 나타냅니다.Indicates if the import should be performed asynchronously. | |
| in | 가져온 가상 머신의 식별자를 다시 생성해야 하는지 여부를 나타냅니다. | |
| in | ||
| in | 가져온 가상 머신의 스냅샷을 축소해야 하므로 스냅샷이 없는 가상 머신이 생성됩니다. | |
| in | ||
| in | ||
| in |
6.214.2.1. clone
가져온 가상 머신의 식별자를 다시 생성해야 하는지 여부를 나타냅니다.
기본적으로 가상 머신을 가져올 때 식별자는 보존됩니다. 즉, 식별자가 고유해야 하므로 동일한 가상 머신을 여러 번 가져올 수 없습니다. 기본값이 false
이므로 동일한 머신을 여러 번 가져올 수 있도록 하려면 이 매개변수를 true
로 설정합니다.
6.214.2.2. collapse_snapshots
가져온 가상 머신의 스냅샷을 축소해야 하므로 스냅샷이 없는 가상 머신이 생성됩니다.
이 매개변수는 선택 사항이며 기본값을 명시적으로 지정하지 않은 경우 기본값은 false
입니다.
6.214.3. POST등록
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 가상 머신이 일부 디스크에만 등록할 수 있는지 여부를 나타냅니다. | |
| in | 등록을 비동기적으로 수행해야 하는지 여부를 나타냅니다. | |
| in | ||
| in | ||
| in | 엔진에 의해 가져오기 프로세스 중에 문제가 있는 MAC 주소를 다시 할당해야 하는지 여부를 나타냅니다. | |
| in | 이 매개변수는 가상 시스템을 등록하는 방법을 설명합니다. | |
| in | ||
| 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
이름 | 유형 | 방향 | 요약 |
---|---|---|---|
| in | 제거가 비동기적으로 수행되어야 하는지 여부를 나타냅니다. |