Artifact Sources - List

List artifact sources in a given lab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources?api-version=2018-09-15
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources?$expand={$expand}&$filter={$filter}&$top={$top}&$orderby={$orderby}&api-version=2018-09-15

URI Parameters

Name In Required Type Description
labName
path True

string

The name of the lab.

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.

$expand
query

string

Specify the $expand query. Example: 'properties($select=displayName)'

$filter
query

string

The filter to apply to the operation. Example: '$filter=contains(name,'myName')

$orderby
query

string

The ordering expression for the results, using OData notation. Example: '$orderby=name desc'

$top
query

integer

int32

The maximum number of resources to return from the operation. Example: '$top=10'

Responses

Name Type Description
200 OK

ArtifactSourceList

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

ArtifactSources_List

Sample request

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

Sample response

{
  "value": [
    {
      "properties": {
        "displayName": "{displayName}",
        "uri": "{artifactSourceUri}",
        "sourceType": "{VsoGit|GitHub|StorageAccount}",
        "folderPath": "{folderPath}",
        "armTemplateFolderPath": "{armTemplateFolderPath}",
        "branchRef": "{branchRef}",
        "securityToken": "{securityToken}",
        "status": "{Enabled|Disabled}",
        "createdDate": "2020-12-16T16:53:02.4830866-07:00",
        "provisioningState": "Succeeded",
        "uniqueIdentifier": "{uniqueIdentifier}"
      },
      "id": "/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/artifactsources/{artifactSourceName}",
      "name": "{artifactSourceName}",
      "type": "Microsoft.DevTestLab/labs/artifactsources",
      "location": "{location}",
      "tags": {
        "tagName1": "tagValue1"
      }
    }
  ]
}

Definitions

Name Description
ArtifactSource

Properties of an artifact source.

ArtifactSourceList

The response of a list operation.

CloudError

Error from a REST request.

CloudErrorBody

Body of an error from a REST request.

EnableStatus

The status of the schedule (i.e. Enabled, Disabled)

SourceControlType

The artifact source's type.

ArtifactSource

Properties of an artifact source.

Name Type Description
id

string

The identifier of the resource.

location

string

The location of the resource.

name

string

The name of the resource.

properties.armTemplateFolderPath

string

The folder containing Azure Resource Manager templates.

properties.branchRef

string

The artifact source's branch reference.

properties.createdDate

string

The artifact source's creation date.

properties.displayName

string

The artifact source's display name.

properties.folderPath

string

The folder containing artifacts.

properties.provisioningState

string

The provisioning status of the resource.

properties.securityToken

string

The security token to authenticate to the artifact source.

properties.sourceType

SourceControlType

The artifact source's type.

properties.status

EnableStatus

Indicates if the artifact source is enabled (values: Enabled, Disabled).

properties.uniqueIdentifier

string

The unique immutable identifier of a resource (Guid).

properties.uri

string

The artifact source's URI.

tags

object

The tags of the resource.

type

string

The type of the resource.

ArtifactSourceList

The response of a list operation.

Name Type Description
nextLink

string

Link for next set of results.

value

ArtifactSource[]

Results of the list operation.

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.

EnableStatus

The status of the schedule (i.e. Enabled, Disabled)

Name Type Description
Disabled

string

Enabled

string

SourceControlType

The artifact source's type.

Name Type Description
GitHub

string

StorageAccount

string

VsoGit

string