Virtual Machine Scale Set Rolling Upgrades - Get Latest

참조

서비스:: Compute

API 버전:: 2024-07-01

최신 가상 머신 확장 집합 롤링 업그레이드의 상태를 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/rollingUpgrades/latest?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	RollingUpgradeStatusInfo	그래
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	사용자 계정 가장

예제

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

샘플 요청

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


/**
 * Samples for VirtualMachineScaleSetRollingUpgrades GetLatest.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void virtualMachineScaleSetRollingUpgradeGetLatestMaximumSetGen(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachineScaleSetRollingUpgrades()
            .getLatestWithResponse("rgcompute", "aaaaaaaaaaaaaaaaaaaaaaaaa", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_scale_set_rolling_upgrade_get_latest_maximum_set_gen.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machine_scale_set_rolling_upgrades.get_latest(
        resource_group_name="rgcompute",
        vm_scale_set_name="aaaaaaaaaaaaaaaaaaaaaaaaa",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen.json
func ExampleVirtualMachineScaleSetRollingUpgradesClient_GetLatest_virtualMachineScaleSetRollingUpgradeGetLatestMaximumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewVirtualMachineScaleSetRollingUpgradesClient().GetLatest(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaaaaaaa", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.RollingUpgradeStatusInfo = armcompute.RollingUpgradeStatusInfo{
	// 	Name: to.Ptr("aaaaaaaaaaaaaaaaaaa"),
	// 	Type: to.Ptr("aaaaaaaaaaaaaaaaaaaaa"),
	// 	ID: to.Ptr("aaaaaaaaaa"),
	// 	Location: to.Ptr("aaaaaa"),
	// 	Tags: map[string]*string{
	// 		"key8533": to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaa"),
	// 	},
	// 	Properties: &armcompute.RollingUpgradeStatusInfoProperties{
	// 		Error: &armcompute.APIError{
	// 			Code: to.Ptr("aaaaaaa"),
	// 			Innererror: &armcompute.InnerError{
	// 				Errordetail: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaa"),
	// 				Exceptiontype: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"),
	// 			},
	// 			Message: to.Ptr("aaaaaaaaa"),
	// 			Target: to.Ptr("aaaaaaa"),
	// 			Details: []*armcompute.APIErrorBase{
	// 				{
	// 					Code: to.Ptr("aaaaaaaaaaaaaaaaaaaaaaaa"),
	// 					Message: to.Ptr("aa"),
	// 					Target: to.Ptr("aaaa"),
	// 			}},
	// 		},
	// 		Policy: &armcompute.RollingUpgradePolicy{
	// 			EnableCrossZoneUpgrade: to.Ptr(true),
	// 			MaxBatchInstancePercent: to.Ptr[int32](49),
	// 			MaxSurge: to.Ptr(true),
	// 			MaxUnhealthyInstancePercent: to.Ptr[int32](81),
	// 			MaxUnhealthyUpgradedInstancePercent: to.Ptr[int32](98),
	// 			PauseTimeBetweenBatches: to.Ptr("aaaaaaaaaaaaaaa"),
	// 			PrioritizeUnhealthyInstances: to.Ptr(true),
	// 			RollbackFailedInstancesOnPolicyBreach: to.Ptr(true),
	// 		},
	// 		Progress: &armcompute.RollingUpgradeProgressInfo{
	// 			FailedInstanceCount: to.Ptr[int32](25),
	// 			InProgressInstanceCount: to.Ptr[int32](20),
	// 			PendingInstanceCount: to.Ptr[int32](27),
	// 			SuccessfulInstanceCount: to.Ptr[int32](6),
	// 		},
	// 		RunningStatus: &armcompute.RollingUpgradeRunningStatus{
	// 			Code: to.Ptr(armcompute.RollingUpgradeStatusCodeRollingForward),
	// 			LastAction: to.Ptr(armcompute.RollingUpgradeActionTypeStart),
	// 			LastActionTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T13:06:23.362Z"); return t}()),
	// 			StartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-11-30T13:06:23.362Z"); return t}()),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets the status of the latest virtual machine scale set rolling upgrade.
 *
 * @summary Gets the status of the latest virtual machine scale set rolling upgrade.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen.json
 */
async function virtualMachineScaleSetRollingUpgradeGetLatestMaximumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const vmScaleSetName = "aaaaaaaaaaaaaaaaaaaaaaaaa";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineScaleSetRollingUpgrades.getLatest(
    resourceGroupName,
    vmScaleSetName,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen.json
// this example is just showing the usage of "VirtualMachineScaleSetRollingUpgrades_GetLatest" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineScaleSetRollingUpgradeResource created on azure
// for more information of creating VirtualMachineScaleSetRollingUpgradeResource, please refer to the document of VirtualMachineScaleSetRollingUpgradeResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string virtualMachineScaleSetName = "aaaaaaaaaaaaaaaaaaaaaaaaa";
ResourceIdentifier virtualMachineScaleSetRollingUpgradeResourceId = VirtualMachineScaleSetRollingUpgradeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualMachineScaleSetName);
VirtualMachineScaleSetRollingUpgradeResource virtualMachineScaleSetRollingUpgrade = client.GetVirtualMachineScaleSetRollingUpgradeResource(virtualMachineScaleSetRollingUpgradeResourceId);

// invoke the operation
VirtualMachineScaleSetRollingUpgradeResource result = await virtualMachineScaleSetRollingUpgrade.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
VirtualMachineScaleSetRollingUpgradeData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "properties": {
    "policy": {
      "maxBatchInstancePercent": 49,
      "maxUnhealthyInstancePercent": 81,
      "maxUnhealthyUpgradedInstancePercent": 98,
      "pauseTimeBetweenBatches": "aaaaaaaaaaaaaaa",
      "enableCrossZoneUpgrade": true,
      "prioritizeUnhealthyInstances": true,
      "rollbackFailedInstancesOnPolicyBreach": true,
      "maxSurge": true
    },
    "runningStatus": {
      "code": "RollingForward",
      "startTime": "2021-11-30T13:06:23.362Z",
      "lastAction": "Start",
      "lastActionTime": "2021-11-30T13:06:23.362Z"
    },
    "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"
    }
  },
  "id": "aaaaaaaaaa",
  "name": "aaaaaaaaaaaaaaaaaaa",
  "type": "aaaaaaaaaaaaaaaaaaaaa",
  "location": "aaaaaa",
  "tags": {
    "key8533": "aaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

샘플 요청

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


/**
 * Samples for VirtualMachineScaleSetRollingUpgrades GetLatest.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void virtualMachineScaleSetRollingUpgradeGetLatestMinimumSetGen(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachineScaleSetRollingUpgrades()
            .getLatestWithResponse("rgcompute", "aaaaaaaaaaaaaaaaa", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_scale_set_rolling_upgrade_get_latest_minimum_set_gen.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machine_scale_set_rolling_upgrades.get_latest(
        resource_group_name="rgcompute",
        vm_scale_set_name="aaaaaaaaaaaaaaaaa",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen.json
func ExampleVirtualMachineScaleSetRollingUpgradesClient_GetLatest_virtualMachineScaleSetRollingUpgradeGetLatestMinimumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewVirtualMachineScaleSetRollingUpgradesClient().GetLatest(ctx, "rgcompute", "aaaaaaaaaaaaaaaaa", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.RollingUpgradeStatusInfo = armcompute.RollingUpgradeStatusInfo{
	// 	ID: to.Ptr("aaaaaaaaaa"),
	// 	Location: to.Ptr("aaaaaa"),
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets the status of the latest virtual machine scale set rolling upgrade.
 *
 * @summary Gets the status of the latest virtual machine scale set rolling upgrade.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen.json
 */
async function virtualMachineScaleSetRollingUpgradeGetLatestMinimumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const vmScaleSetName = "aaaaaaaaaaaaaaaaa";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachineScaleSetRollingUpgrades.getLatest(
    resourceGroupName,
    vmScaleSetName,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen.json
// this example is just showing the usage of "VirtualMachineScaleSetRollingUpgrades_GetLatest" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineScaleSetRollingUpgradeResource created on azure
// for more information of creating VirtualMachineScaleSetRollingUpgradeResource, please refer to the document of VirtualMachineScaleSetRollingUpgradeResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string virtualMachineScaleSetName = "aaaaaaaaaaaaaaaaa";
ResourceIdentifier virtualMachineScaleSetRollingUpgradeResourceId = VirtualMachineScaleSetRollingUpgradeResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualMachineScaleSetName);
VirtualMachineScaleSetRollingUpgradeResource virtualMachineScaleSetRollingUpgrade = client.GetVirtualMachineScaleSetRollingUpgradeResource(virtualMachineScaleSetRollingUpgradeResourceId);

// invoke the operation
VirtualMachineScaleSetRollingUpgradeResource result = await virtualMachineScaleSetRollingUpgrade.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
VirtualMachineScaleSetRollingUpgradeData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "location": "aaaaaa",
  "id": "aaaaaaaaaa"
}

정의

Name	Description
ApiError	API 오류입니다.
ApiErrorBase	API 오류 기준입니다.
CloudError	Compute 서비스의 오류 응답입니다.
InnerError	내부 오류 세부 정보입니다.
RollingUpgradeActionType	롤링 업그레이드에서 수행된 마지막 작업입니다.
RollingUpgradePolicy	롤링 업그레이드를 수행하는 동안 사용되는 구성 매개 변수입니다.
RollingUpgradeProgressInfo	각 업그레이드 상태의 가상 머신 인스턴스 수에 대한 정보입니다.
RollingUpgradeRunningStatus	전체 업그레이드의 현재 실행 상태에 대한 정보입니다.
RollingUpgradeStatusCode	업그레이드의 현재 상태를 나타내는 코드입니다.
RollingUpgradeStatusInfo	최신 가상 머신 확장 집합 롤링 업그레이드의 상태입니다.

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	예외 형식입니다.

RollingUpgradeActionType

롤링 업그레이드에서 수행된 마지막 작업입니다.

Name	형식	Description
Cancel	string
Start	string

RollingUpgradePolicy

롤링 업그레이드를 수행하는 동안 사용되는 구성 매개 변수입니다.

Name	형식	Description
enableCrossZoneUpgrade	boolean	업그레이드 일괄 처리를 생성할 때 VMSS가 AZ 경계를 무시하도록 허용합니다. 업데이트 도메인 및 maxBatchInstancePercent를 고려하여 일괄 처리 크기를 확인합니다.
maxBatchInstancePercent	integer	롤링 업그레이드를 통해 동시에 업그레이드될 총 가상 머신 인스턴스의 최대 백분율입니다. 이는 이전 또는 이후 일괄 처리의 최대 비정상 인스턴스이므로 더 높은 안정성을 보장하기 위해 일괄 처리의 인스턴스 비율이 감소할 수 있습니다. 이 매개 변수의 기본값은 20%.
maxSurge	boolean	기존 가상 머신을 업데이트하는 대신 확장 집합을 업그레이드하는 새 가상 머신을 만듭니다. 각 일괄 처리에 대해 새 가상 머신이 만들어지면 기존 가상 머신이 삭제됩니다.
maxUnhealthyInstancePercent	integer	업그레이드의 결과로 또는 롤링 업그레이드가 중단되기 전에 가상 머신 상태 검사에서 비정상 상태로 발견되어 동시에 비정상 상태가 될 수 있는 확장 집합의 총 가상 머신 인스턴스의 최대 비율입니다. 이 제약 조건은 일괄 처리를 시작하기 전에 확인됩니다. 이 매개 변수의 기본값은 20%.
maxUnhealthyUpgradedInstancePercent	integer	비정상 상태인 것으로 확인될 수 있는 업그레이드된 가상 머신 인스턴스의 최대 비율입니다. 이 검사는 각 일괄 처리가 업그레이드된 후에 수행됩니다. 이 비율을 초과하면 롤링 업데이트가 중단됩니다. 이 매개 변수의 기본값은 20%.
pauseTimeBetweenBatches	string	모든 가상 머신에 대한 업데이트를 한 일괄 처리로 완료하고 다음 일괄 처리를 시작하는 것 사이의 대기 시간입니다. 기간은 ISO 8601 형식으로 지정해야 합니다. 기본값은 0초(PT0S)입니다.
prioritizeUnhealthyInstances	boolean	확장 집합의 모든 비정상 인스턴스를 정상 인스턴스로 업그레이드합니다.
rollbackFailedInstancesOnPolicyBreach	boolean	롤링 업그레이드 정책을 위반하는 경우 인스턴스를 이전 모델로 롤백하지 못했습니다.

RollingUpgradeProgressInfo

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

Name	형식	Description
failedInstanceCount	integer	성공적으로 업그레이드하지 못한 인스턴스 수입니다.
inProgressInstanceCount	integer	현재 업그레이드 중인 인스턴스 수입니다.
pendingInstanceCount	integer	아직 업그레이드를 시작하지 않은 인스턴스 수입니다.
successfulInstanceCount	integer	성공적으로 업그레이드된 인스턴스 수입니다.

RollingUpgradeRunningStatus

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

Name	형식	Description
code	RollingUpgradeStatusCode	업그레이드의 현재 상태를 나타내는 코드입니다.
lastAction	RollingUpgradeActionType	롤링 업그레이드에서 수행된 마지막 작업입니다.
lastActionTime	string	업그레이드의 마지막 작업 시간입니다.
startTime	string	업그레이드 시작 시간입니다.

RollingUpgradeStatusCode

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

Name	형식	Description
Cancelled	string
Completed	string
Faulted	string
RollingForward	string

RollingUpgradeStatusInfo

최신 가상 머신 확장 집합 롤링 업그레이드의 상태입니다.

Name	형식	Description
id	string	리소스 ID
location	string	리소스 위치
name	string	리소스 이름
properties.error	ApiError	이 업그레이드에 대한 오류 세부 정보가 있는 경우
properties.policy	RollingUpgradePolicy	이 업그레이드에 적용된 롤링 업그레이드 정책입니다.
properties.progress	RollingUpgradeProgressInfo	각 업그레이드 상태의 가상 머신 인스턴스 수에 대한 정보입니다.
properties.runningStatus	RollingUpgradeRunningStatus	전체 업그레이드의 현재 실행 상태에 대한 정보입니다.
tags	object	리소스 태그
type	string	리소스 종류

다음을 통해 공유

Virtual Machine Scale Set Rolling Upgrades - Get Latest

URI 매개 변수

응답

보안

azure_auth

범위

예제

VirtualMachineScaleSetRollingUpgrade_GetLatest_MaximumSet_Gen

샘플 요청

샘플 응답

VirtualMachineScaleSetRollingUpgrade_GetLatest_MinimumSet_Gen

샘플 요청

샘플 응답

정의

ApiError

ApiErrorBase

CloudError

InnerError

RollingUpgradeActionType

RollingUpgradePolicy

RollingUpgradeProgressInfo

RollingUpgradeRunningStatus

RollingUpgradeStatusCode

RollingUpgradeStatusInfo

추가 리소스