다음을 통해 공유


Virtual Machine Scale Sets - Get OS Upgrade History

VM 확장 집합 인스턴스의 OS 업그레이드 목록을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/osUpgradeHistory?api-version=2024-07-01

URI 매개 변수

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

string

리소스 그룹의 이름입니다.

subscriptionId
path True

string

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

vmScaleSetName
path True

string

VM 확장 집합의 이름입니다.

api-version
query True

string

클라이언트 API 버전입니다.

응답

Name 형식 Description
200 OK

VirtualMachineScaleSetListOSUpgradeHistory

그래

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 사용자 계정 가장

예제

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen
VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

VirtualMachineScaleSet_GetOSUpgradeHistory_MaximumSet_Gen

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaa/osUpgradeHistory?api-version=2024-07-01

샘플 응답

{
  "value": [
    {
      "properties": {
        "runningStatus": {
          "code": "RollingForward",
          "startTime": "2021-11-30T13:05:40.442Z",
          "endTime": "2021-11-30T13:05:40.443Z"
        },
        "progress": {
          "successfulInstanceCount": 6,
          "failedInstanceCount": 25,
          "inProgressInstanceCount": 20,
          "pendingInstanceCount": 27
        },
        "error": {
          "details": [
            {
              "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
              "target": "aaaa",
              "message": "aa"
            }
          ],
          "innererror": {
            "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
            "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
          },
          "code": "aaaaaaa",
          "target": "aaaaaaa",
          "message": "aaaaaaaaa"
        },
        "startedBy": "Unknown",
        "targetImageReference": {
          "sku": "2016-Datacenter",
          "publisher": "MicrosoftWindowsServer",
          "version": "latest",
          "offer": "WindowsServer",
          "exactVersion": "aaaaaaa",
          "sharedGalleryImageId": "aaaaaa",
          "id": "aaaaaaaaaaaaaaaaaaa"
        },
        "rollbackInfo": {
          "successfullyRolledbackInstanceCount": 12,
          "failedRolledbackInstanceCount": 2,
          "rollbackError": {
            "details": [
              {
                "code": "aaaaaaaaaaaaaaaaaaaaaaaa",
                "target": "aaaa",
                "message": "aa"
              }
            ],
            "innererror": {
              "exceptiontype": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
              "errordetail": "aaaaaaaaaaaaaaaaaaaaaaaa"
            },
            "code": "aaaaaaa",
            "target": "aaaaaaa",
            "message": "aaaaaaaaa"
          }
        }
      },
      "type": "aaaaaaaaaaaaaaaaaaa",
      "location": "aaaaaaaaaaaaa"
    }
  ],
  "nextLink": "aaaaaaaaa"
}

VirtualMachineScaleSet_GetOSUpgradeHistory_MinimumSet_Gen

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/osUpgradeHistory?api-version=2024-07-01

샘플 응답

{
  "value": [
    {}
  ]
}

정의

Name Description
ApiError

API 오류입니다.

ApiErrorBase

API 오류 기준입니다.

CloudError

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

ImageReference

사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다. 참고: 이미지 참조 게시자 및 제품은 확장 집합을 만들 때만 설정할 수 있습니다.

InnerError

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

RollbackStatusInfo

OS 업그레이드 작업 후 실패한 VM 인스턴스의 롤백에 대한 정보입니다.

RollingUpgradeProgressInfo

각 업그레이드 상태의 가상 머신 인스턴스 수에 대한 정보입니다.

UpgradeOperationHistoricalStatusInfo

Virtual Machine Scale Set OS 업그레이드 기록 작업 응답입니다.

UpgradeOperationHistoricalStatusInfoProperties

Virtual Machine Scale Set의 각 OS 업그레이드에 대해 설명합니다.

UpgradeOperationHistoryStatus

전체 업그레이드의 현재 실행 상태에 대한 정보입니다.

UpgradeOperationInvoker

업그레이드 작업의 호출자

UpgradeState

업그레이드의 현재 상태를 나타내는 코드입니다.

VirtualMachineScaleSetListOSUpgradeHistory

Virtual Machine Scale Set OS 업그레이드 기록 작업 응답 목록입니다.

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 오류입니다.

ImageReference

사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다. 참고: 이미지 참조 게시자 및 제품은 확장 집합을 만들 때만 설정할 수 있습니다.

Name 형식 Description
communityGalleryImageId

string

vm 배포에 대한 커뮤니티 갤러리 이미지 고유 ID를 지정했습니다. 커뮤니티 갤러리 이미지 GET 호출에서 가져올 수 있습니다.

exactVersion

string

가상 머신을 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 버전인 10진수로 지정합니다. 이 읽기 전용 필드는 'version' 필드에 지정된 값이 'latest'인 경우에만 'version'와 다릅니다.

id

string

리소스 ID

offer

string

가상 머신을 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 제안을 지정합니다.

publisher

string

이미지 게시자입니다.

sharedGalleryImageId

string

vm 배포에 대한 공유 갤러리 이미지 고유 ID를 지정했습니다. 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.

sku

string

이미지 SKU입니다.

version

string

가상 머신을 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 버전을 지정합니다. 허용되는 형식은 Major.Minor.Build 또는 'latest'입니다. 주, 부 및 빌드는 소수 자릿수입니다. 배포 시 사용할 수 있는 최신 버전의 이미지를 사용하도록 '최신'을 지정합니다. '최신'을 사용하더라도 새 버전을 사용할 수 있는 경우에도 배포 시간 후에 VM 이미지가 자동으로 업데이트되지 않습니다. 갤러리 이미지 배포에는 'version' 필드를 사용하지 마세요. 갤러리 이미지는 항상 배포에 'id' 필드를 사용해야 합니다. '최신' 버전의 갤러리 이미지를 사용하려면 버전 입력 없이 'id' 필드에 '/subscriptions/{subscriptionId}/resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}'을 설정하기만 하면 됩니다.

InnerError

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

Name 형식 Description
errordetail

string

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

exceptiontype

string

예외 형식입니다.

RollbackStatusInfo

OS 업그레이드 작업 후 실패한 VM 인스턴스의 롤백에 대한 정보입니다.

Name 형식 Description
failedRolledbackInstanceCount

integer

롤백에 실패한 인스턴스 수입니다.

rollbackError

ApiError

OS 롤백에 실패한 경우 오류 세부 정보입니다.

successfullyRolledbackInstanceCount

integer

성공적으로 롤백된 인스턴스 수입니다.

RollingUpgradeProgressInfo

각 업그레이드 상태의 가상 머신 인스턴스 수에 대한 정보입니다.

Name 형식 Description
failedInstanceCount

integer

성공적으로 업그레이드하지 못한 인스턴스 수입니다.

inProgressInstanceCount

integer

현재 업그레이드 중인 인스턴스 수입니다.

pendingInstanceCount

integer

아직 업그레이드를 시작하지 않은 인스턴스 수입니다.

successfulInstanceCount

integer

성공적으로 업그레이드된 인스턴스 수입니다.

UpgradeOperationHistoricalStatusInfo

Virtual Machine Scale Set OS 업그레이드 기록 작업 응답입니다.

Name 형식 Description
location

string

리소스 위치

properties

UpgradeOperationHistoricalStatusInfoProperties

업그레이드 작업의 속성에 대한 정보입니다.

type

string

리소스 종류

UpgradeOperationHistoricalStatusInfoProperties

Virtual Machine Scale Set의 각 OS 업그레이드에 대해 설명합니다.

Name 형식 Description
error

ApiError

이 업그레이드에 대한 오류 세부 정보가 있는 경우

progress

RollingUpgradeProgressInfo

각 상태의 VM 수입니다.

rollbackInfo

RollbackStatusInfo

수행된 경우 OS 롤백에 대한 정보

runningStatus

UpgradeOperationHistoryStatus

업그레이드 작업의 전체 상태에 대한 정보입니다.

startedBy

UpgradeOperationInvoker

업그레이드 작업의 호출자

targetImageReference

ImageReference

이미지 참조 세부 정보

UpgradeOperationHistoryStatus

전체 업그레이드의 현재 실행 상태에 대한 정보입니다.

Name 형식 Description
code

UpgradeState

업그레이드의 현재 상태를 나타내는 코드입니다.

endTime

string

업그레이드 종료 시간입니다.

startTime

string

업그레이드 시작 시간입니다.

UpgradeOperationInvoker

업그레이드 작업의 호출자

Name 형식 Description
Platform

string

Unknown

string

User

string

UpgradeState

업그레이드의 현재 상태를 나타내는 코드입니다.

Name 형식 Description
Cancelled

string

Completed

string

Faulted

string

RollingForward

string

VirtualMachineScaleSetListOSUpgradeHistory

Virtual Machine Scale Set OS 업그레이드 기록 작업 응답 목록입니다.

Name 형식 Description
nextLink

string

OS 업그레이드 기록의 다음 페이지를 가져올 URI입니다. ListNext()를 호출하여 업그레이드 기록의 다음 페이지를 가져옵니다.

value

UpgradeOperationHistoricalStatusInfo[]

가상 머신 확장 집합에서 수행되는 OS 업그레이드 목록입니다.