@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Azure DevOps
@base https://management.azure.com
@version 2019-07-01-preview
@auth OAuth2
@common_fields {api-version: any # API version to be used with the HTTP request.}
@endpoints 8
@toc providers(2), subscriptions(6)

@group providers
@endpoint GET /providers/Microsoft.DevOps/operations
@desc Lists all the operations supported by Microsoft.DevOps resource provider.
@returns(200) The list of supported operations has been fetched successfully.

@endpoint GET /providers/Microsoft.DevOps/pipelineTemplateDefinitions
@desc Lists all pipeline templates which can be used to configure an Azure Pipeline.
@returns(200) The pipeline template definitions have been fetched successfully.

@endgroup

@group subscriptions
@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOps/pipelines/{pipelineName}
@desc Creates or updates an Azure Pipeline.
@required {subscriptionId: any # Unique identifier of the Azure subscription. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., resourceGroupName: any # Name of the resource group within the Azure subscription., pipelineName: any # The name of the Azure Pipeline resource in ARM., createOperationParameters: map # The request payload to create the Azure Pipeline.}
@returns(200) The Azure Pipeline has been configured successfully.
@returns(202) The request has been accepted for processing and the Azure Pipeline will be configured asynchronously.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOps/pipelines/{pipelineName}
@desc Gets an existing Azure Pipeline.
@required {subscriptionId: any # Unique identifier of the Azure subscription. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., resourceGroupName: any # Name of the resource group within the Azure subscription., pipelineName: any # The name of the Azure Pipeline resource in ARM.}
@returns(200) The Azure Pipeline has been fetched successfully.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOps/pipelines/{pipelineName}
@desc Updates the properties of an Azure Pipeline. Currently, only tags can be updated.
@required {subscriptionId: any # Unique identifier of the Azure subscription. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., resourceGroupName: any # Name of the resource group within the Azure subscription., pipelineName: any # The name of the Azure Pipeline resource., updateOperationParameters: map # The request payload containing the properties to update in the Azure Pipeline.}
@returns(200) The Azure Pipeline has been updated successfully.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOps/pipelines/{pipelineName}
@desc Deletes an Azure Pipeline.
@required {subscriptionId: any # Unique identifier of the Azure subscription. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., resourceGroupName: any # Name of the resource group within the Azure subscription., pipelineName: any # The name of the Azure Pipeline resource.}
@returns(200) The Azure Pipeline has been deleted successfully.
@returns(204) The Azure Pipeline is not found or has been deleted already.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevOps/pipelines
@desc Lists all Azure Pipelines under the specified resource group.
@required {subscriptionId: any # Unique identifier of the Azure subscription. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000)., resourceGroupName: any # Name of the resource group within the Azure subscription.}
@returns(200) The Azure Pipelines have been fetched successfully.

@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.DevOps/pipelines
@desc Lists all Azure Pipelines under the specified subscription.
@required {subscriptionId: any # Unique identifier of the Azure subscription. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).}
@returns(200) The Azure Pipelines have been fetched successfully.

@endgroup

@end