---
title: "Create or update DMS (classic) Instance"
method: PUT
path: "/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}"
tags: ["Service resource", "Standard operation", "PUT"]
---

# Create or update DMS (classic) Instance

`PUT /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.DataMigration/services/{serviceName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

The services resource is the top-level resource that represents the Azure Database Migration Service (classic). The PUT method creates a new service or updates an existing one. When a service is updated, existing child resources (i.e. tasks) are unaffected. Services currently support a single kind, "vm", which refers to a VM-based service, although other kinds may be added in the future. This method can change the kind, SKU, and network of the service, but if tasks are currently running (i.e. the service is busy), this will fail with 400 Bad Request ("ServiceIsBusy"). The provider will reply when successful with 200 OK or 201 Created. Long-running operations use the provisioningState property.

## Path parameters

- `groupName` string, required
- `serviceName` string, required

## Parameters

- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` (unresolved $ref)
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/SubscriptionIdParameter` (unresolved $ref)

## Request body

- DataMigrationService (unresolved $ref)

## Response `200`

Resource 'DataMigrationService' update operation succeeded

- DataMigrationService (unresolved $ref)

## Other responses

- `201`: Resource 'DataMigrationService' create operation succeeded
- `202`: Resource operation accepted.
- `default`: An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/azure-database-migration-service-classic-resource-provider.md) - [All operations](https://skmtc.dev/azure/apis/azure-database-migration-service-classic-resource-provider/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/azure-database-migration-service-classic-resource-provider/revisions/a034b56d69ce?raw)