@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api ApiManagementClient
@base https://management.azure.com
@version 2019-12-01-preview
@auth OAuth2
@endpoints 6
@toc subscriptions(6)

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags
@desc Lists a collection of tags defined within a service instance.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |, scope: any # Scope like 'apis', 'products' or 'apis/{apiId}}
@returns(200) Lists a collection of Tag entities.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
@desc Gets the entity state version of the tag specified by its identifier.
@returns(200) Empty response body, ETag header entity state version.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
@desc Gets the details of the tag specified by its identifier.
@returns(200) The response body contains the specified Tag entity.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
@desc Creates a tag.
@required {parameters: any # Create parameters.}
@returns(200) Tag already exists.
@returns(201) Tag was created successfully.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
@desc Updates the details of the tag specified by its identifier.
@required {parameters: any # Update parameters.}
@returns(204) The tag details were successfully updated.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
@desc Deletes specific tag of the API Management service instance.
@returns(200) Tag successfully removed
@returns(204) Tag successfully removed by previous request or does not exist

@end