다음을 통해 공유


Virtual Machines - Capture

VM의 가상 하드 디스크를 복사하여 VM을 캡처하고 유사한 VM을 만드는 데 사용할 수 있는 템플릿을 출력합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/capture?api-version=2024-03-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

리소스 그룹의 이름.

subscriptionId
path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

vmName
path True

string

가상 머신의 이름입니다.

api-version
query True

string

클라이언트 API 버전.

요청 본문

Name 형식 Description
parameters

VirtualMachineCaptureParameters

Virtual Machine 캡처 작업에 제공된 매개 변수입니다.

응답

Name 형식 Description
200 OK

VirtualMachineCaptureResult

정상

202 Accepted

수락됨

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

VirtualMachine_Capture_MaximumSet_Gen
VirtualMachine_Capture_MinimumSet_Gen

VirtualMachine_Capture_MaximumSet_Gen

샘플 요청

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/capture?api-version=2024-03-01

{
  "vhdPrefix": "aaaaaaaaa",
  "destinationContainerName": "aaaaaaa",
  "overwriteVhds": true
}

샘플 응답

{
  "$schema": "aaaaa",
  "contentVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "parameters": {},
  "resources": [
    {}
  ],
  "id": "aaaaaaaaaaaaaaaaaaaaaaaa"
}
location: https://foo.com/operationstatus

VirtualMachine_Capture_MinimumSet_Gen

샘플 요청

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaa/capture?api-version=2024-03-01

{
  "vhdPrefix": "aaaaaaaaa",
  "destinationContainerName": "aaaaaaa",
  "overwriteVhds": true
}

샘플 응답

{}
location: https://foo.com/operationstatus

정의

Name Description
ApiError

API 오류입니다.

ApiErrorBase

API 오류 기준입니다.

CloudError

Compute 서비스의 오류 응답입니다.

InnerError

내부 오류 세부 정보입니다.

VirtualMachineCaptureParameters

Virtual Machine 캡처 작업에 제공된 매개 변수입니다.

VirtualMachineCaptureResult

가상 머신 캡처 작업의 출력입니다.

ApiError

API 오류입니다.

Name 형식 Description
code

string

오류 코드입니다.

details

ApiErrorBase[]

API 오류 세부 정보

innererror

InnerError

API 내부 오류

message

string

오류 메시지입니다.

target

string

특정 오류의 대상입니다.

ApiErrorBase

API 오류 기준입니다.

Name 형식 Description
code

string

오류 코드입니다.

message

string

오류 메시지입니다.

target

string

특정 오류의 대상입니다.

CloudError

Compute 서비스의 오류 응답입니다.

Name 형식 Description
error

ApiError

API 오류입니다.

InnerError

내부 오류 세부 정보입니다.

Name 형식 Description
errordetail

string

내부 오류 메시지 또는 예외 덤프입니다.

exceptiontype

string

예외 형식입니다.

VirtualMachineCaptureParameters

Virtual Machine 캡처 작업에 제공된 매개 변수입니다.

Name 형식 Description
destinationContainerName

string

대상 컨테이너 이름입니다.

overwriteVhds

boolean

충돌 시 대상 가상 하드 디스크를 덮어쓸지 여부를 지정합니다.

vhdPrefix

string

캡처된 가상 하드 디스크의 이름 접두사입니다.

VirtualMachineCaptureResult

가상 머신 캡처 작업의 출력입니다.

Name 형식 Description
$schema

string

캡처된 가상 머신의 스키마

contentVersion

string

콘텐츠의 버전

id

string

리소스 ID

parameters

object

캡처된 가상 머신의 매개 변수

resources

object[]

캡처된 가상 머신의 리소스 항목 목록