Virtual Machine Scale Set VMs - Reimage
VM 확장 집합의 특정 가상 머신을 이미지로 다시 설치(운영 체제 업그레이드)합니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/reimage?api-version=2025-04-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
instance
|
path | True |
string |
가상 머신의 인스턴스 ID입니다. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다. |
subscription
|
path | True |
string minLength: 1 |
대상 구독의 ID입니다. |
vm
|
path | True |
string |
VM 확장 집합의 이름입니다. |
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 형식 | Description |
---|---|---|
exactVersion |
string |
OS 디스크를 이미지로 다시 설치해야 하는 버전을 10진수로 지정합니다. 정확한 버전이 제공되지 않으면 OS 디스크가 기존 버전의 OS 디스크로 이미지로 다시 설치됩니다. |
forceUpdateOSDiskForEphemeral |
boolean |
가상 머신 확장 집합 VM에 대한 임시 OS 디스크를 강제로 업데이트하는 매개 변수 |
osProfile |
임시 OS 디스크를 다시 이미지화하는 데 필요한 정보를 지정합니다. |
|
tempDisk |
boolean |
임시 디스크를 이미지로 다시 설치할지 여부를 지정합니다. 기본값: false 참고: 이 임시 디스크 이미지 재설치 매개 변수는 임시 OS 디스크가 있는 VM/VMSS에서만 지원됩니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
요청이 성공했습니다. |
|
202 Accepted |
자원 작업이 허용되었습니다. 헤더
|
|
Other Status Codes |
예기치 않은 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Virtual |
Virtual |
VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
샘플 요청
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaa/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2025-04-01
{
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
샘플 응답
___location: https://foo.com/operationstatus
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen
샘플 요청
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaa/virtualMachines/aaaaaaaaaaaaa/reimage?api-version=2025-04-01
샘플 응답
___location: https://foo.com/operationstatus
정의
Name | Description |
---|---|
Api |
API 오류. |
Api |
API 오류 기반. |
Cloud |
컴퓨팅 서비스의 오류 응답입니다. |
Inner |
내부 오류 세부 정보입니다. |
OSProfile |
비임시 가상 머신을 다시 이미징하기 위한 추가 매개 변수입니다. |
Virtual |
가상 머신 확장 집합 VM 이미지 다시 설치 매개 변수에 대해 설명합니다. |
ApiError
API 오류.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
details |
Api 오류 세부 정보 |
|
innererror |
Api 내부 오류 |
|
message |
string |
오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
ApiErrorBase
API 오류 기반.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
message |
string |
오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
CloudError
컴퓨팅 서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
API 오류. |
InnerError
내부 오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
errordetail |
string |
내부 오류 메시지 또는 예외 덤프입니다. |
exceptiontype |
string |
예외 유형입니다. |
OSProfileProvisioningData
비임시 가상 머신을 다시 이미징하기 위한 추가 매개 변수입니다.
Name | 형식 | Description |
---|---|---|
adminPassword |
string (password) |
관리자 계정의 암호를 지정합니다. |
customData |
string |
사용자 지정 데이터의 base-64로 인코딩된 문자열을 지정합니다. base-64로 인코딩된 문자열은 Virtual Machine에 파일로 저장된 이진 배열로 디코딩됩니다. 이진 배열의 최대 길이는 65535바이트입니다. 참고: customData 속성에 비밀이나 암호를 전달하지 마세요. VM을 만든 후에는 이 속성을 업데이트할 수 없습니다. customData 속성은 파일로 저장될 VM에 전달되며, 자세한 내용은 Azure VM의 사용자 지정 데이터를 참조하세요. Linux VM에 cloud-init를 사용하는 경우 만드는 동안 cloud-init를 사용하여 Linux VM 사용자 지정을 참조하세요. |
VirtualMachineScaleSetVMReimageParameters
가상 머신 확장 집합 VM 이미지 다시 설치 매개 변수에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
exactVersion |
string |
OS 디스크를 이미지로 다시 설치해야 하는 버전을 10진수로 지정합니다. 정확한 버전이 제공되지 않으면 OS 디스크가 기존 버전의 OS 디스크로 이미지로 다시 설치됩니다. |
forceUpdateOSDiskForEphemeral |
boolean |
가상 머신 확장 집합 VM에 대한 임시 OS 디스크를 강제로 업데이트하는 매개 변수 |
osProfile |
임시 OS 디스크를 다시 이미지화하는 데 필요한 정보를 지정합니다. |
|
tempDisk |
boolean |
임시 디스크를 이미지로 다시 설치할지 여부를 지정합니다. 기본값: false 참고: 이 임시 디스크 이미지 재설치 매개 변수는 임시 OS 디스크가 있는 VM/VMSS에서만 지원됩니다. |