Service Runners - Get

Get service runner.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/servicerunners/{name}?api-version=2018-09-15

URI Parameters

Name In Required Type Description
labName
path True

string

The name of the lab.

name
path True

string

The name of the service runner.

resourceGroupName
path True

string

The name of the resource group.

subscriptionId
path True

string

The subscription ID.

api-version
query True

string

Client API version.

Responses

Name Type Description
200 OK

ServiceRunner

OK

Other Status Codes

CloudError

BadRequest

Security

azure_auth

OAuth2 Implicit Grant

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

Scopes

Name Description
user_impersonation Access Microsoft Azure

Examples

ServiceRunners_Get

Sample Request

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{devtestlabName}/servicerunners/{servicerunnerName}?api-version=2018-09-15

Sample Response

{
  "identity": {
    "type": "{identityType}",
    "principalId": "{identityPrincipalId}",
    "tenantId": "{identityTenantId}",
    "clientSecretUrl": "{identityClientSecretUrl}"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/serviceRunners/{serviceRunnerName}",
  "name": "{serviceRunnerName}",
  "type": "Microsoft.DevTestLab/labs/serviceRunners",
  "location": "{location}",
  "tags": {
    "tagName1": "tagValue1"
  }
}

Definitions

Name Description
CloudError

Error from a REST request.

CloudErrorBody

Body of an error from a REST request.

IdentityProperties

Properties of a managed identity

ManagedIdentityType

Managed identity.

ServiceRunner

A container for a managed identity to execute DevTest lab services.

CloudError

Error from a REST request.

Name Type Description
error

CloudErrorBody

The cloud error that occurred

CloudErrorBody

Body of an error from a REST request.

Name Type Description
code

string

The error code.

details

CloudErrorBody[]

Inner errors.

message

string

The error message.

target

string

The error target.

IdentityProperties

Properties of a managed identity

Name Type Description
clientSecretUrl

string

The client secret URL of the identity.

principalId

string

The principal id of resource identity.

tenantId

string

The tenant identifier of resource.

type

ManagedIdentityType

Managed identity.

ManagedIdentityType

Managed identity.

Name Type Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ServiceRunner

A container for a managed identity to execute DevTest lab services.

Name Type Description
id

string

The identifier of the resource.

identity

IdentityProperties

The identity of the resource.

location

string

The location of the resource.

name

string

The name of the resource.

tags

object

The tags of the resource.

type

string

The type of the resource.