SAP Virtual Instances - Update

Service:: Workloads

API Version:: 2023-04-01

Updates a Virtual Instance for SAP solutions resource

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Workloads/sapVirtualInstances/{sapVirtualInstanceName}?api-version=2023-04-01

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
sapVirtualInstanceName	path	True	string	The name of the Virtual Instances for SAP solutions resource
subscriptionId	path	True	string minLength: 1	The ID of the target subscription.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Body

Name	Type	Description
identity	UserAssignedServiceIdentity	A pre-created user assigned identity with appropriate roles assigned. To learn more on identity and roles required, visit the ACSS how-to-guide.
tags	object	Gets or sets the Resource tags.

Responses

Name	Type	Description
200 OK	SAPVirtualInstance	Describes the Virtual Instance for SAP solutions resource which is successfully updated.
Other Status Codes	ErrorResponse	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

SAPVirtualInstances_Update

Sample request

PATCH https://management.azure.com/subscriptions/8e17e36c-42e9-4cd5-a078-7b44883414e0/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00?api-version=2023-04-01

{
  "tags": {
    "key1": "svi1"
  },
  "identity": {
    "type": "None"
  }
}


import com.azure.resourcemanager.workloads.models.ManagedServiceIdentityType;
import com.azure.resourcemanager.workloads.models.SapVirtualInstance;
import com.azure.resourcemanager.workloads.models.UserAssignedServiceIdentity;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for SapVirtualInstances Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/workloads/resource-manager/Microsoft.Workloads/stable/2023-04-01/examples/sapvirtualinstances/
     * SAPVirtualInstances_Update.json
     */
    /**
     * Sample code: SAPVirtualInstances_Update.
     * 
     * @param manager Entry point to WorkloadsManager.
     */
    public static void sAPVirtualInstancesUpdate(com.azure.resourcemanager.workloads.WorkloadsManager manager) {
        SapVirtualInstance resource = manager.sapVirtualInstances()
            .getByResourceGroupWithResponse("test-rg", "X00", com.azure.core.util.Context.NONE).getValue();
        resource.update().withTags(mapOf("key1", "fakeTokenPlaceholder"))
            .withIdentity(new UserAssignedServiceIdentity().withType(ManagedServiceIdentityType.NONE)).apply();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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.workloads import WorkloadsMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-workloads
# USAGE
    python sap_virtual_instances_update.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 = WorkloadsMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="8e17e36c-42e9-4cd5-a078-7b44883414e0",
    )

    response = client.sap_virtual_instances.update(
        resource_group_name="test-rg",
        sap_virtual_instance_name="X00",
    )
    print(response)


# x-ms-original-file: specification/workloads/resource-manager/Microsoft.Workloads/stable/2023-04-01/examples/sapvirtualinstances/SAPVirtualInstances_Update.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 armworkloads_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/workloads/armworkloads"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/1e7b408f3323e7f5424745718fe62c7a043a2337/specification/workloads/resource-manager/Microsoft.Workloads/stable/2023-04-01/examples/sapvirtualinstances/SAPVirtualInstances_Update.json
func ExampleSAPVirtualInstancesClient_Update() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armworkloads.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewSAPVirtualInstancesClient().Update(ctx, "test-rg", "X00", armworkloads.UpdateSAPVirtualInstanceRequest{
		Identity: &armworkloads.UserAssignedServiceIdentity{
			Type: to.Ptr(armworkloads.ManagedServiceIdentityTypeNone),
		},
		Tags: map[string]*string{
			"key1": to.Ptr("svi1"),
		},
	}, 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.SAPVirtualInstance = armworkloads.SAPVirtualInstance{
	// 	Name: to.Ptr("X00"),
	// 	Type: to.Ptr("Microsoft.Workloads/sapVirtualInstances"),
	// 	ID: to.Ptr("/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00"),
	// 	SystemData: &armworkloads.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-08-19T15:10:46.196Z"); return t}()),
	// 		CreatedBy: to.Ptr("user@xyz.com"),
	// 		CreatedByType: to.Ptr(armworkloads.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-08-19T15:10:46.196Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("user@xyz.com"),
	// 		LastModifiedByType: to.Ptr(armworkloads.CreatedByTypeUser),
	// 	},
	// 	Location: to.Ptr("westcentralus"),
	// 	Tags: map[string]*string{
	// 		"key1": to.Ptr("svi1"),
	// 	},
	// 	Identity: &armworkloads.UserAssignedServiceIdentity{
	// 		Type: to.Ptr(armworkloads.ManagedServiceIdentityTypeNone),
	// 	},
	// 	Properties: &armworkloads.SAPVirtualInstanceProperties{
	// 		Configuration: &armworkloads.DeploymentConfiguration{
	// 			ConfigurationType: to.Ptr(armworkloads.SAPConfigurationTypeDeployment),
	// 		},
	// 		Environment: to.Ptr(armworkloads.SAPEnvironmentTypeProd),
	// 		Health: to.Ptr(armworkloads.SAPHealthStateUnknown),
	// 		ManagedResourceGroupConfiguration: &armworkloads.ManagedRGConfiguration{
	// 			Name: to.Ptr("mrg-x00-6d875e77-e412-4d7d-9af4-8895278b4443"),
	// 		},
	// 		ProvisioningState: to.Ptr(armworkloads.SapVirtualInstanceProvisioningStateSucceeded),
	// 		SapProduct: to.Ptr(armworkloads.SAPProductTypeS4HANA),
	// 		State: to.Ptr(armworkloads.SAPVirtualInstanceStateInfrastructureDeploymentPending),
	// 		Status: to.Ptr(armworkloads.SAPVirtualInstanceStatusStarting),
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to Updates a Virtual Instance for SAP solutions resource
 *
 * @summary Updates a Virtual Instance for SAP solutions resource
 * x-ms-original-file: specification/workloads/resource-manager/Microsoft.Workloads/stable/2023-04-01/examples/sapvirtualinstances/SAPVirtualInstances_Update.json
 */
async function sapVirtualInstancesUpdate() {
  const subscriptionId =
    process.env["WORKLOADS_SUBSCRIPTION_ID"] || "8e17e36c-42e9-4cd5-a078-7b44883414e0";
  const resourceGroupName = process.env["WORKLOADS_RESOURCE_GROUP"] || "test-rg";
  const sapVirtualInstanceName = "X00";
  const body = {
    identity: { type: "None" },
    tags: { key1: "svi1" },
  };
  const options = { body };
  const credential = new DefaultAzureCredential();
  const client = new WorkloadsClient(credential, subscriptionId);
  const result = await client.sAPVirtualInstances.update(
    resourceGroupName,
    sapVirtualInstanceName,
    options
  );
  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

Sample response

Status code:: 200

{
  "id": "/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00",
  "name": "X00",
  "type": "Microsoft.Workloads/sapVirtualInstances",
  "tags": {
    "key1": "svi1"
  },
  "location": "westcentralus",
  "systemData": {
    "createdBy": "user@xyz.com",
    "createdByType": "User",
    "createdAt": "2021-08-19T15:10:46.196Z",
    "lastModifiedBy": "user@xyz.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2021-08-19T15:10:46.196Z"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "environment": "Prod",
    "sapProduct": "S4HANA",
    "configuration": {
      "configurationType": "Deployment"
    },
    "status": "Starting",
    "health": "Unknown",
    "state": "InfrastructureDeploymentPending",
    "managedResourceGroupConfiguration": {
      "name": "mrg-x00-6d875e77-e412-4d7d-9af4-8895278b4443"
    },
    "provisioningState": "Succeeded"
  }
}

Definitions

Name	Description
ApplicationServerConfiguration	Gets or sets the application server configuration.
ApplicationServerFullResourceNames	The full resource names object for application layer resources. The number of entries in this list should be equal to the number VMs to be created for application layer.
CentralServerConfiguration	Gets or sets the central server configuration.
CentralServerFullResourceNames	The full resource names object for central server layer resources.
CreateAndMountFileShareConfiguration	Gets or sets the file share configuration where the transport directory fileshare is created and mounted as a part of the create infra flow. Please pre-create the resource group you intend to place the transport directory in. The storage account and fileshare will be auto-created by the ACSS and doesn’t need to pre-created.
createdByType	The type of identity that created the resource.
DatabaseConfiguration	Gets or sets the database configuration.
DatabaseServerFullResourceNames	The full resource names object for database layer resources. The number of entries in this list should be equal to the number VMs to be created for database layer.
DeployerVmPackages	Defines the url and storage account ID where deployer VM packages are uploaded
DeploymentConfiguration	Deployment Configuration.
DeploymentWithOSConfiguration	Deployment along with OS Configuration.
DiscoveryConfiguration	Discovery Details.
DiskConfiguration	The Disk Configuration Details.
DiskSku	The type of disk sku. For example, Standard_LRS, Standard_ZRS, Premium_LRS, Premium_ZRS.
DiskSkuName	Defines the disk sku name.
DiskVolumeConfiguration	The disk configuration required for the selected volume.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDefinition	Error definition.
ErrorDetail	The error detail.
ErrorResponse	Error response
ExternalInstallationSoftwareConfiguration	The SAP Software configuration Input when the software is installed externally outside the service.
HighAvailabilityConfiguration	Gets or sets the high availability configuration.
HighAvailabilitySoftwareConfiguration	Gets or sets the HA software configuration.
ImageReference	Specifies information about the image to use. You can specify information about platform images, marketplace images, or virtual machine images. This element is required when you want to use a platform image, marketplace image, or virtual machine image, but is not used in other creation operations. NOTE: Image reference publisher and offer can only be set when you create the scale set.
LinuxConfiguration	Specifies the Linux operating system settings on the virtual machine. For a list of supported Linux distributions, see Linux on Azure-Endorsed Distributions.
LoadBalancerResourceNames	The resource names object for load balancer and related resources.
ManagedRGConfiguration	Managed resource group configuration
ManagedServiceIdentityType	Type of managed service identity (only None, UserAssigned types are allowed).
MountFileShareConfiguration	Gets or sets the file share configuration where the transport directory fileshare already exists, and user wishes to mount the fileshare as a part of the create infra flow.
NamingPatternType	The pattern type to be used for resource naming.
NetworkConfiguration	Defines the network configuration type for SAP system infrastructure that is being deployed
NetworkInterfaceResourceNames	The resource names object for network interface and related resources.
OSProfile	Specifies the operating system settings for the virtual machine. Some of the settings cannot be changed once VM is provisioned.
OsSapConfiguration	Defines the OS and SAP Configurations for Deployment
SAPDatabaseType	Defines the supported SAP Database types.
SAPDeploymentType	The deployment type. Eg: SingleServer/ThreeTier
SAPEnvironmentType	Defines the environment type - Production/Non Production.
SAPHealthState	Defines the health of SAP Instances.
SAPHighAvailabilityType	The high availability type.
SAPInstallWithoutOSConfigSoftwareConfiguration	The SAP Software configuration Input when the software is to be installed by service without OS Configurations
SAPProductType	Defines the SAP Product type.
SAPSoftwareInstallationType	The SAP software installation Type.
SAPVirtualInstance	Define the Virtual Instance for SAP solutions resource.
SAPVirtualInstanceError	An error response from the Virtual Instance for SAP Workload service.
SapVirtualInstanceProvisioningState	Defines the provisioning states.
SAPVirtualInstanceState	Defines the Virtual Instance for SAP state.
SAPVirtualInstanceStatus	Defines the SAP Instance status.
ServiceInitiatedSoftwareConfiguration	The SAP Software configuration Input when the software is to be installed by service.
sharedStorageResourceNames	The resource names object for shared storage.
SingleServerConfiguration	Gets or sets the single server configuration. For prerequisites for creating the infrastructure, please see here
SingleServerFullResourceNames	The resource name object where the specified values will be full resource names of the corresponding resources in a single server SAP system.
SkipFileShareConfiguration	Gets or sets the file share configuration for scenarios where transport directory fileshare is not created or required.
SshConfiguration	SSH configuration for Linux based VMs running on Azure
SshKeyPair	The SSH Key-pair used to authenticate with the VM. The key needs to be at least 2048-bit and in ssh-rsa format. For creating ssh keys, see Create SSH keys on Linux and Mac for Linux VMs in Azure.
SshPublicKey	Contains information about SSH certificate public key and the path on the Linux VM where the public key is placed.
StorageConfiguration	Gets or sets the storage configuration.
systemData	Metadata pertaining to creation and last modification of the resource.
ThreeTierConfiguration	Gets or sets the three tier SAP configuration. For prerequisites for creating the infrastructure, please see here
ThreeTierFullResourceNames	The resource name object where the specified values will be full resource names of the corresponding resources in a three tier SAP system.
UpdateSAPVirtualInstanceRequest	Defines the request body for updating Virtual Instance for SAP.
UserAssignedIdentity	User assigned identity properties
UserAssignedServiceIdentity	A pre-created user assigned identity with appropriate roles assigned. To learn more on identity and roles required, visit the ACSS how-to-guide.
VirtualMachineConfiguration	Defines the virtual machine configuration.
VirtualMachineResourceNames	The resource names object for virtual machine and related resources.
WindowsConfiguration	Specifies Windows operating system settings on the virtual machine.

ApplicationServerConfiguration

Object

Gets or sets the application server configuration.

Name	Type	Description
instanceCount	integer (int64)	The number of app server instances.
subnetId	string	The subnet id.
virtualMachineConfiguration	VirtualMachineConfiguration	Gets or sets the virtual machine configuration.

ApplicationServerFullResourceNames

Object

The full resource names object for application layer resources. The number of entries in this list should be equal to the number VMs to be created for application layer.

Name	Type	Description
availabilitySetName	string	The full name for availability set. In case name is not provided, it will be defaulted to {SID}-App-AvSet.
virtualMachines	VirtualMachineResourceNames[]	The list of virtual machine naming details.

CentralServerConfiguration

Object

Gets or sets the central server configuration.

Name	Type	Description
instanceCount	integer (int64)	The number of central server VMs.
subnetId	string	The subnet id.
virtualMachineConfiguration	VirtualMachineConfiguration	Gets or sets the virtual machine configuration.

CentralServerFullResourceNames

Object

The full resource names object for central server layer resources.

Name	Type	Description
availabilitySetName	string	The full name for availability set. In case name is not provided, it will be defaulted to {SID}-ASCS-AvSet.
loadBalancer	LoadBalancerResourceNames	The resource names object for load balancer and related resources.
virtualMachines	VirtualMachineResourceNames[]	The list of names for all ASCS virtual machines to be deployed. The number of entries in this list should be equal to the number VMs to be created for ASCS layer. At maximum, there can be two virtual machines at this layer: ASCS and ERS.

CreateAndMountFileShareConfiguration

Object

Gets or sets the file share configuration where the transport directory fileshare is created and mounted as a part of the create infra flow. Please pre-create the resource group you intend to place the transport directory in. The storage account and fileshare will be auto-created by the ACSS and doesn’t need to pre-created.

Name	Type	Description
configurationType	string: CreateAndMount	The type of file share config.
resourceGroup	string	The name of transport file share resource group. This should be pre created by the customer. The app rg is used in case of missing input.
storageAccountName	string	The name of file share storage account name . A custom name is used in case of missing input.

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

DatabaseConfiguration

Object

Gets or sets the database configuration.

Name	Type	Description
databaseType	SAPDatabaseType	The database type.
diskConfiguration	DiskConfiguration	Gets or sets the disk configuration.
instanceCount	integer (int64)	The number of database VMs.
subnetId	string	The subnet id.
virtualMachineConfiguration	VirtualMachineConfiguration	Gets or sets the virtual machine configuration.

DatabaseServerFullResourceNames

Object

The full resource names object for database layer resources. The number of entries in this list should be equal to the number VMs to be created for database layer.

Name	Type	Description
availabilitySetName	string	The full name for availability set. In case name is not provided, it will be defaulted to {SID}-DB-AvSet.
loadBalancer	LoadBalancerResourceNames	The resource names object for load balancer and related resources.
virtualMachines	VirtualMachineResourceNames[]	The list of virtual machine naming details.

DeployerVmPackages

Object

Defines the url and storage account ID where deployer VM packages are uploaded

Name	Type	Description
storageAccountId	string	The deployer VM packages storage account id
url	string	The URL to the deployer VM packages file.

DeploymentConfiguration

Object

Deployment Configuration.

Name	Type	Description
appLocation	string	The geo-location where the SAP system is to be created.
configurationType	string: Deployment	The configuration Type.
infrastructureConfiguration	InfrastructureConfiguration: SingleServerConfiguration ThreeTierConfiguration	The infrastructure configuration.
softwareConfiguration	SoftwareConfiguration: ExternalInstallationSoftwareConfiguration SAPInstallWithoutOSConfigSoftwareConfiguration ServiceInitiatedSoftwareConfiguration	The software configuration.

DeploymentWithOSConfiguration

Object

Deployment along with OS Configuration.

Name	Type	Description
appLocation	string	The geo-location where the SAP system is to be created.
configurationType	string: DeploymentWithOSConfig	The configuration Type.
infrastructureConfiguration	InfrastructureConfiguration: SingleServerConfiguration ThreeTierConfiguration	The infrastructure configuration.
osSapConfiguration	OsSapConfiguration	The OS and SAP configuration.
softwareConfiguration	SoftwareConfiguration: ExternalInstallationSoftwareConfiguration SAPInstallWithoutOSConfigSoftwareConfiguration ServiceInitiatedSoftwareConfiguration	The software configuration.

DiscoveryConfiguration

Object

Discovery Details.

Name	Type	Description
appLocation	string	The geo-location where the SAP system exists.
centralServerVmId	string	The virtual machine ID of the Central Server.
configurationType	string: Discovery	The configuration Type.
managedRgStorageAccountName	string minLength: 3 maxLength: 24	The custom storage account name for the storage account created by the service in the managed resource group created as part of VIS deployment. Refer to the storage account naming rules here. If not provided, the service will create the storage account with a random name.

DiskConfiguration

Object

The Disk Configuration Details.

Name	Type	Description
diskVolumeConfigurations	<string, DiskVolumeConfiguration>	The disk configuration for the db volume. For HANA, Required volumes are: ['hana/data', 'hana/log', hana/shared', 'usr/sap', 'os'], Optional volume : ['backup'].

DiskSku

Object

The type of disk sku. For example, Standard_LRS, Standard_ZRS, Premium_LRS, Premium_ZRS.

Name	Type	Description
name	DiskSkuName	Defines the disk sku name.

DiskSkuName

Enumeration

Defines the disk sku name.

Value	Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

DiskVolumeConfiguration

Object

The disk configuration required for the selected volume.

Name	Type	Description
count	integer (int64)	The total number of disks required for the concerned volume.
sizeGB	integer (int64)	The disk size in GB.
sku	DiskSku	The disk SKU details.

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDefinition

Object

Error definition.

Name	Type	Description
code	string	Service specific error code which serves as the substatus for the HTTP error code.
details	ErrorDefinition[]	Internal error details.
message	string	Description of the error.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

ExternalInstallationSoftwareConfiguration

Object

The SAP Software configuration Input when the software is installed externally outside the service.

Name	Type	Description
centralServerVmId	string	The resource ID of the virtual machine containing the central server instance.
softwareInstallationType	string: External	The SAP software installation Type.

HighAvailabilityConfiguration

Object

Gets or sets the high availability configuration.

Name	Type	Description
highAvailabilityType	SAPHighAvailabilityType	The high availability type.

HighAvailabilitySoftwareConfiguration

Object

Gets or sets the HA software configuration.

Name	Type	Description
fencingClientId	string	The fencing client id.
fencingClientPassword	string	The fencing client id secret/password. The secret should never expire. This will be used pacemaker to start/stop the cluster VMs.

ImageReference

Object

Specifies information about the image to use. You can specify information about platform images, marketplace images, or virtual machine images. This element is required when you want to use a platform image, marketplace image, or virtual machine image, but is not used in other creation operations. NOTE: Image reference publisher and offer can only be set when you create the scale set.

Name	Type	Description
offer	string	Specifies the offer of the platform image or marketplace image used to create the virtual machine.
publisher	string	The image publisher.
sku	string	The image SKU.
version	string	Specifies the version of the platform image or marketplace image used to create the virtual machine. The allowed formats are Major.Minor.Build or 'latest'. Major, Minor, and Build are decimal numbers. Specify 'latest' to use the latest version of an image available at deploy time. Even if you use 'latest', the VM image will not automatically update after deploy time even if a new version becomes available.

LinuxConfiguration

Object

Specifies the Linux operating system settings on the virtual machine.

For a list of supported Linux distributions, see Linux on Azure-Endorsed Distributions.

Name	Type	Description
disablePasswordAuthentication	boolean	Specifies whether password authentication should be disabled.
osType	string: Linux	The OS Type
ssh	SshConfiguration	Specifies the ssh key configuration for a Linux OS. (This property is deprecated, please use 'sshKeyPair' instead)
sshKeyPair	SshKeyPair	The SSH Key-pair used to authenticate with the VM's.

LoadBalancerResourceNames

Object

The resource names object for load balancer and related resources.

Name	Type	Description
backendPoolNames	string[]	The list of backend pool names. Currently, ACSS deploys only one backend pool and hence, size of this list should be 1
frontendIpConfigurationNames	string[]	The list of frontend IP configuration names. If provided as input, size of this list should be 2 for cs layer and should be 1 for database layer.
healthProbeNames	string[]	The list of health probe names. If provided as input, size of this list should be 2 for cs layer and should be 1 for database layer.
loadBalancerName	string	The full resource name for load balancer. If this value is not provided, load balancer will be name as {ASCS/DB}-loadBalancer.

ManagedRGConfiguration

Object

Managed resource group configuration

Name	Type	Description
name	string	Managed resource group name

ManagedServiceIdentityType

Enumeration

Type of managed service identity (only None, UserAssigned types are allowed).

Value	Description
None
UserAssigned

MountFileShareConfiguration

Object

Gets or sets the file share configuration where the transport directory fileshare already exists, and user wishes to mount the fileshare as a part of the create infra flow.

Name	Type	Description
configurationType	string: Mount	The type of file share config.
id	string	The fileshare resource ID
privateEndpointId	string	The private endpoint resource ID

NamingPatternType

Enumeration

The pattern type to be used for resource naming.

Value	Description
FullResourceName

NetworkConfiguration

Object

Defines the network configuration type for SAP system infrastructure that is being deployed

Name	Type	Default value	Description
isSecondaryIpEnabled	boolean	False	Specifies whether a secondary IP address should be added to the network interface on all VMs of the SAP system being deployed

NetworkInterfaceResourceNames

Object

The resource names object for network interface and related resources.

Name	Type	Description
networkInterfaceName	string	The full name for network interface. If name is not provided, service uses a default name based on the deployment type. For SingleServer, default name is {SID}-Nic. In case of HA-AvZone systems, default name will be {SID}-{App/ASCS/DB}-Zone{A/B}-Nic with an incrementor at the end in case of more than 1 instance per layer. For distributed and HA-AvSet systems, default name will be {SID}-{App/ASCS/DB}-Nic with an incrementor at the end in case of more than 1 instance per layer.

OSProfile

Object

Specifies the operating system settings for the virtual machine. Some of the settings cannot be changed once VM is provisioned.

Name	Type	Description
adminPassword	string	Specifies the password of the administrator account. Minimum-length (Windows): 8 characters Minimum-length (Linux): 6 characters Max-length (Windows): 123 characters Max-length (Linux): 72 characters Complexity requirements: 3 out of 4 conditions below need to be fulfilled Has lower characters Has upper characters Has a digit Has a special character (Regex match [\W_]) Disallowed values: "abc@123", "P@$$w0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" For resetting the password, see How to reset the Remote Desktop service or its login password in a Windows VM For resetting root password, see Manage users, SSH, and check or repair disks on Azure Linux VMs using the VMAccess Extension
adminUsername	string	Specifies the name of the administrator account. This property cannot be updated after the VM is created. Windows-only restriction: Cannot end in "." Disallowed values: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". Minimum-length (Linux): 1 character Max-length (Linux): 64 characters Max-length (Windows): 20 characters.
osConfiguration	OSConfiguration: LinuxConfiguration WindowsConfiguration	Specifies Windows operating system settings on the virtual machine.

OsSapConfiguration

Object

Defines the OS and SAP Configurations for Deployment

Name	Type	Description
deployerVmPackages	DeployerVmPackages	The url and storage account ID where deployer VM packages are uploaded
sapFqdn	string	The FQDN to set for the SAP system

SAPDatabaseType

Enumeration

Defines the supported SAP Database types.

Value	Description
HANA
DB2

SAPDeploymentType

Enumeration

The deployment type. Eg: SingleServer/ThreeTier

Value	Description
SingleServer
ThreeTier

SAPEnvironmentType

Enumeration

Defines the environment type - Production/Non Production.

Value	Description
NonProd
Prod

SAPHealthState

Enumeration

Defines the health of SAP Instances.

Value	Description
Unknown
Healthy
Unhealthy
Degraded

SAPHighAvailabilityType

Enumeration

The high availability type.

Value	Description
AvailabilitySet
AvailabilityZone

SAPInstallWithoutOSConfigSoftwareConfiguration

Object

The SAP Software configuration Input when the software is to be installed by service without OS Configurations

Name	Type	Description
bomUrl	string	The URL to the SAP Build of Materials(BOM) file.
highAvailabilitySoftwareConfiguration	HighAvailabilitySoftwareConfiguration	Gets or sets the HA software configuration.
sapBitsStorageAccountId	string	The SAP bits storage account id.
softwareInstallationType	string: SAPInstallWithoutOSConfig	The SAP software installation Type.
softwareVersion	string	The software version to install.

SAPProductType

Enumeration

Defines the SAP Product type.

Value	Description
ECC
S4HANA
Other

SAPSoftwareInstallationType

Enumeration

The SAP software installation Type.

Value	Description
ServiceInitiated
SAPInstallWithoutOSConfig
External

SAPVirtualInstance

Object

Define the Virtual Instance for SAP solutions resource.

Name	Type	Description
id	string	Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	UserAssignedServiceIdentity	A pre-created user assigned identity with appropriate roles assigned. To learn more on identity and roles required, visit the ACSS how-to-guide.
location	string	The geo-location where the resource lives
name	string	The name of the resource
properties.configuration	SAPConfiguration: DeploymentConfiguration DeploymentWithOSConfiguration DiscoveryConfiguration	Defines if the SAP system is being created using Azure Center for SAP solutions (ACSS) or if an existing SAP system is being registered with ACSS
properties.environment	SAPEnvironmentType	Defines the environment type - Production/Non Production.
properties.errors	SAPVirtualInstanceError	Indicates any errors on the Virtual Instance for SAP solutions resource.
properties.health	SAPHealthState	Defines the health of SAP Instances.
properties.managedResourceGroupConfiguration	ManagedRGConfiguration	Managed resource group configuration
properties.provisioningState	SapVirtualInstanceProvisioningState	Defines the provisioning states.
properties.sapProduct	SAPProductType	Defines the SAP Product type.
properties.state	SAPVirtualInstanceState	Defines the Virtual Instance for SAP state.
properties.status	SAPVirtualInstanceStatus	Defines the SAP Instance status.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	Resource tags.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

SAPVirtualInstanceError

Object

An error response from the Virtual Instance for SAP Workload service.

Name	Type	Description
properties	ErrorDefinition	The Virtual Instance for SAP error body.

SapVirtualInstanceProvisioningState

Enumeration

Defines the provisioning states.

Value	Description
Succeeded
Updating
Creating
Failed
Deleting

SAPVirtualInstanceState

Enumeration

Defines the Virtual Instance for SAP state.

Value	Description
InfrastructureDeploymentPending
InfrastructureDeploymentInProgress
InfrastructureDeploymentFailed
SoftwareInstallationPending
SoftwareInstallationInProgress
SoftwareInstallationFailed
SoftwareDetectionInProgress
SoftwareDetectionFailed
DiscoveryPending
DiscoveryInProgress
DiscoveryFailed
RegistrationComplete

SAPVirtualInstanceStatus

Enumeration

Defines the SAP Instance status.

Value	Description
Starting
Running
Stopping
Offline
PartiallyRunning
Unavailable
SoftShutdown

ServiceInitiatedSoftwareConfiguration

Object

The SAP Software configuration Input when the software is to be installed by service.

Name	Type	Description
bomUrl	string	The URL to the SAP Build of Materials(BOM) file.
highAvailabilitySoftwareConfiguration	HighAvailabilitySoftwareConfiguration	Gets or sets the HA software configuration.
sapBitsStorageAccountId	string	The SAP bits storage account id.
sapFqdn	string	The FQDN to set for the SAP system during install.
softwareInstallationType	string: ServiceInitiated	The SAP software installation Type.
softwareVersion	string	The software version to install.
sshPrivateKey	string	The SSH private key.

sharedStorageResourceNames

Object

The resource names object for shared storage.

Name	Type	Description
sharedStorageAccountName	string	The full name of the shared storage account. If it is not provided, it will be defaulted to {SID}nfs{guid of 15 chars}.
sharedStorageAccountPrivateEndPointName	string	The full name of private end point for the shared storage account. If it is not provided, it will be defaulted to {storageAccountName}_pe

SingleServerConfiguration

Object

Gets or sets the single server configuration. For prerequisites for creating the infrastructure, please see here

Name	Type	Description
appResourceGroup	string	The application resource group where SAP system resources will be deployed.
customResourceNames	SingleServerCustomResourceNames: SingleServerFullResourceNames	The set of custom names to be used for underlying azure resources that are part of the SAP system.
databaseType	SAPDatabaseType	The database type.
dbDiskConfiguration	DiskConfiguration	Gets or sets the disk configuration.
deploymentType	string: SingleServer	The type of SAP deployment, single server or Three tier.
networkConfiguration	NetworkConfiguration	Network configuration for the server
subnetId	string	The subnet id.
virtualMachineConfiguration	VirtualMachineConfiguration	Gets or sets the virtual machine configuration.

SingleServerFullResourceNames

Object

The resource name object where the specified values will be full resource names of the corresponding resources in a single server SAP system.

Name	Type	Description
namingPatternType	string: FullResourceName	The pattern type to be used for resource naming.
virtualMachine	VirtualMachineResourceNames	The resource names object for virtual machine and related resources.

SkipFileShareConfiguration

Object

Gets or sets the file share configuration for scenarios where transport directory fileshare is not created or required.

Name	Type	Description
configurationType	string: Skip	The type of file share config.

SshConfiguration

Object

SSH configuration for Linux based VMs running on Azure

Name	Type	Description
publicKeys	SshPublicKey[]	The list of SSH public keys used to authenticate with linux based VMs.

SshKeyPair

Object

The SSH Key-pair used to authenticate with the VM. The key needs to be at least 2048-bit and in ssh-rsa format.

For creating ssh keys, see Create SSH keys on Linux and Mac for Linux VMs in Azure.

Name	Type	Description
privateKey	string	SSH private key.
publicKey	string	SSH public key

SshPublicKey

Object

Contains information about SSH certificate public key and the path on the Linux VM where the public key is placed.

Name	Type	Description
keyData	string	SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. For creating ssh keys, see Create SSH keys on Linux and Mac for Linux VMs in Azure.

StorageConfiguration

Object

Gets or sets the storage configuration.

Name	Type	Description
transportFileShareConfiguration	FileShareConfiguration: CreateAndMountFileShareConfiguration MountFileShareConfiguration SkipFileShareConfiguration	The properties of the transport directory attached to the VIS. The default for transportFileShareConfiguration is the createAndMount flow if storage configuration is missing.

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

ThreeTierConfiguration

Object

Gets or sets the three tier SAP configuration. For prerequisites for creating the infrastructure, please see here

Name	Type	Description
appResourceGroup	string	The application resource group where SAP system resources will be deployed.
applicationServer	ApplicationServerConfiguration	The application server configuration.
centralServer	CentralServerConfiguration	The central server configuration.
customResourceNames	ThreeTierCustomResourceNames: ThreeTierFullResourceNames	The set of custom names to be used for underlying azure resources that are part of the SAP system.
databaseServer	DatabaseConfiguration	The database configuration.
deploymentType	string: ThreeTier	The type of SAP deployment, single server or Three tier.
highAvailabilityConfig	HighAvailabilityConfiguration	The high availability configuration.
networkConfiguration	NetworkConfiguration	Network configuration common to all servers
storageConfiguration	StorageConfiguration	The storage configuration.

ThreeTierFullResourceNames

Object

The resource name object where the specified values will be full resource names of the corresponding resources in a three tier SAP system.

Name	Type	Description
applicationServer	ApplicationServerFullResourceNames	The full resource names object for application layer resources. The number of entries in this list should be equal to the number VMs to be created for application layer.
centralServer	CentralServerFullResourceNames	The full resource names object for central server layer resources.
databaseServer	DatabaseServerFullResourceNames	The full resource names object for database layer resources. The number of entries in this list should be equal to the number VMs to be created for database layer.
namingPatternType	string: FullResourceName	The pattern type to be used for resource naming.
sharedStorage	sharedStorageResourceNames	The resource names object for shared storage.

UpdateSAPVirtualInstanceRequest

Object

Defines the request body for updating Virtual Instance for SAP.

Name	Type	Description
identity	UserAssignedServiceIdentity	A pre-created user assigned identity with appropriate roles assigned. To learn more on identity and roles required, visit the ACSS how-to-guide.
tags	object	Gets or sets the Resource tags.

UserAssignedIdentity

Object

User assigned identity properties

Name	Type	Description
clientId	string (uuid)	The client ID of the assigned identity.
principalId	string (uuid)	The principal ID of the assigned identity.

UserAssignedServiceIdentity

Object

A pre-created user assigned identity with appropriate roles assigned. To learn more on identity and roles required, visit the ACSS how-to-guide.

Name	Type	Description
type	ManagedServiceIdentityType	Type of manage identity
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identities User assigned identities dictionary

VirtualMachineConfiguration

Object

Defines the virtual machine configuration.

Name	Type	Description
imageReference	ImageReference	The image reference.
osProfile	OSProfile	The OS profile.
vmSize	string	The virtual machine size.

VirtualMachineResourceNames

Object

The resource names object for virtual machine and related resources.

Name	Type	Description
dataDiskNames	object	The full resource names for virtual machine data disks. This is a dictionary containing list of names of data disks per volume. Currently supported volumes for database layer are ['hana/data', 'hana/log', hana/shared', 'usr/sap', 'os', 'backup']. For application and cs layers, only 'default' volume is supported
hostName	string	The full name for virtual-machine's host (computer name). Currently, ACSS only supports host names which are less than or equal to 13 characters long. If this value is not provided, vmName will be used as host name.
networkInterfaces	NetworkInterfaceResourceNames[]	The list of network interface name objects for the selected virtual machine. Currently, only one network interface is supported per virtual machine.
osDiskName	string	The full name for OS disk attached to the VM. If this value is not provided, it will be named by ARM as per its default naming standards (prefixed with vm name). There is only one OS disk attached per Virtual Machine.
vmName	string	The full name for virtual machine. The length of this field can be upto 64 characters. If name is not provided, service uses a default name based on the deployment type. For SingleServer, default name is {SID}vm. In case of HA-AvZone systems, default name will be {SID}{app/ascs/db}z{a/b}vm with an incrementor at the end in case of more than 1 vm per layer. For distributed and HA-AvSet systems, default name will be {SID}{app/ascs/db}vm with an incrementor at the end in case of more than 1 vm per layer.

WindowsConfiguration

Object

Specifies Windows operating system settings on the virtual machine.

Name	Type	Description
osType	string: Windows	The OS Type

Share via

SAP Virtual Instances - Update

URI Parameters

Request Body

Responses

Security

azure_auth

Scopes

Examples

SAPVirtualInstances_Update

Sample request

Sample response

Definitions

ApplicationServerConfiguration

ApplicationServerFullResourceNames

CentralServerConfiguration

CentralServerFullResourceNames

CreateAndMountFileShareConfiguration

createdByType

DatabaseConfiguration

DatabaseServerFullResourceNames

DeployerVmPackages

DeploymentConfiguration

DeploymentWithOSConfiguration

DiscoveryConfiguration

DiskConfiguration

DiskSku

DiskSkuName

DiskVolumeConfiguration

ErrorAdditionalInfo

ErrorDefinition

ErrorDetail

ErrorResponse

ExternalInstallationSoftwareConfiguration

HighAvailabilityConfiguration

HighAvailabilitySoftwareConfiguration

ImageReference

LinuxConfiguration

LoadBalancerResourceNames

ManagedRGConfiguration

ManagedServiceIdentityType

MountFileShareConfiguration

NamingPatternType

NetworkConfiguration

NetworkInterfaceResourceNames

OSProfile

OsSapConfiguration

SAPDatabaseType

SAPDeploymentType

SAPEnvironmentType

SAPHealthState

SAPHighAvailabilityType

SAPInstallWithoutOSConfigSoftwareConfiguration

SAPProductType

SAPSoftwareInstallationType

SAPVirtualInstance

SAPVirtualInstanceError

SapVirtualInstanceProvisioningState

SAPVirtualInstanceState

SAPVirtualInstanceStatus

ServiceInitiatedSoftwareConfiguration

sharedStorageResourceNames

SingleServerConfiguration

SingleServerFullResourceNames

SkipFileShareConfiguration

SshConfiguration

SshKeyPair

SshPublicKey

StorageConfiguration

systemData

ThreeTierConfiguration

ThreeTierFullResourceNames

UpdateSAPVirtualInstanceRequest

UserAssignedIdentity

UserAssignedServiceIdentity

VirtualMachineConfiguration

VirtualMachineResourceNames

WindowsConfiguration