SAP Database Instances - Stop Instance

Stops the database instance of the SAP system.

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

URI Parameters

Name In Required Type Description
databaseInstanceName
path True

string

Database resource name string modeled as parameter for auto generation to work correctly.

resourceGroupName
path True

string

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

The ID of the target subscription.

api-version
query True

string

The API version to use for this operation.

Request Body

Name Type Description
softStopTimeoutSeconds

integer

This parameter defines how long (in seconds) the soft shutdown waits until the RFC/HTTP clients no longer consider the server for calls with load balancing. Value 0 means that the kernel does not wait, but goes directly into the next shutdown state, i.e. hard stop.

Responses

Name Type Description
200 OK

OperationStatusResult

OK

202 Accepted

Accepted

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

Stop the database instance of the SAP system.

Sample request

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

{
  "softStopTimeoutSeconds": 0
}

Sample response

{
  "id": "/subscriptions/6d875e77-e412-4d7d-9af4-8895278b4443/resourceGroups/test-rg/providers/Microsoft.Workloads/sapVirtualInstances/X00/applicationInstances/db0",
  "name": "db0",
  "status": "Succeeded",
  "startTime": "2022-11-01T03:36:07.000Z",
  "endTime": "2022-11-01T03:38:07.000Z",
  "error": null
}
azure-AsyncOperation: https://eastus2euap.management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Workloads/locations/NORTHEUROPE/operationStatuses/sample-op-status?api-version=2023-04-01

Definitions

Name Description
ErrorAdditionalInfo

The resource management error additional info.

ErrorDetail

The error detail.

ErrorResponse

Error response

OperationStatusResult

The current status of an async operation.

StopRequest

Stop SAP instance(s) request body.

ErrorAdditionalInfo

The resource management error additional info.

Name Type Description
info

object

The additional info.

type

string

The additional info type.

ErrorDetail

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

Error response

Name Type Description
error

ErrorDetail

The error object.

OperationStatusResult

The current status of an async operation.

Name Type Description
endTime

string

The end time of the operation.

error

ErrorDetail

If present, details of the operation error.

id

string

Fully qualified ID for the async operation.

name

string

Name of the async operation.

operations

OperationStatusResult[]

The operations list.

percentComplete

number

Percent of the operation that is complete.

startTime

string

The start time of the operation.

status

string

Operation status.

StopRequest

Stop SAP instance(s) request body.

Name Type Default value Description
softStopTimeoutSeconds

integer

0

This parameter defines how long (in seconds) the soft shutdown waits until the RFC/HTTP clients no longer consider the server for calls with load balancing. Value 0 means that the kernel does not wait, but goes directly into the next shutdown state, i.e. hard stop.