@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 73
@hint download_for_search
@toc subscriptions(73)

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis
@desc Lists all APIs of the API Management 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 | | description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |, tags: any # Include tags in the response., expandApiVersionSet: any # Include full ApiVersionSet resource in response}
@returns(200) Paged Result response of Apis.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
@desc Gets the entity state (Etag) version of the API specified by its identifier.
@returns(200) Specified API entity exists and current entity state version is present in the ETag header.

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

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
@desc Creates new or updates existing specified API of the API Management service instance.
@required {parameters: any # Create or update parameters.}
@returns(200) API was successfully updated.
@returns(201) API was successfully created.
@returns(202) Request to create or update API was accepted. Location header contains the URL where the status of the long running operation can be checked.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
@desc Updates the specified API of the API Management service instance.
@required {parameters: any # API Update Contract parameters.}
@returns(204) The API was successfully updated.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
@desc Deletes the specified API of the API Management service instance.
@optional {deleteRevisions: any # Delete all revisions of the Api.}
@returns(200) The API was successfully deleted.
@returns(204) The API was successfully deleted.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions
@desc Lists all revisions of an API.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| apiRevision | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) The operation returns a list of revision details.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases
@desc Lists all releases of an API. An API release is created when making an API Revision current. Releases are also used to rollback to previous revisions. Results will be paged and can be constrained by the $top and $skip parameters.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| notes | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) The operation returns a list of API Releases.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
@desc Returns the etag of an API release.
@returns(200) Gets the entity state (Etag) version of the api release as specified by its identifier.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
@desc Returns the details of an API release.
@returns(200) The operation returns the details of an API Release.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
@desc Creates a new Release for the API.
@required {parameters: any # Create parameters.}
@returns(200) Release was successfully updated.
@returns(201) Release was successfully created.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
@desc Updates the details of the release of the API specified by its identifier.
@required {parameters: any # API Release Update parameters.}
@returns(204) Release successfully updated

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
@desc Deletes the specified release in the API.
@returns(200) API release successfully removed
@returns(204) API release successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations
@desc Lists a collection of the operations for the specified API.
@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 | | method | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |, tags: any # Include tags in the response.}
@returns(200) A collection of operation summary entities at the API level.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
@desc Gets the entity state (Etag) version of the API operation specified by its identifier.
@returns(200) Specified API operation entity exists and current entity state version is present in the ETag header.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
@desc Gets the details of the API Operation specified by its identifier.
@returns(200) The response body contains the specified Operation entity.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
@desc Creates a new operation in the API or updates an existing one.
@required {parameters: any # Create parameters.}
@returns(200) Operation was successfully updated.
@returns(201) Operation was successfully created.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
@desc Updates the details of the operation in the API specified by its identifier.
@required {parameters: any # API Operation Update parameters.}
@returns(204) The operation was successfully updated.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
@desc Deletes the specified operation in the API.
@returns(200) API operation successfully removed
@returns(204) API operation successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies
@desc Get the list of policy configuration at the API Operation level.
@returns(200) Api Operations Policy Collection.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
@desc Gets the entity state (Etag) version of the API operation policy specified by its identifier.
@returns(200) Specified API operation policy entity exists and current entity state version is present in the ETag header.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
@desc Get the policy configuration at the API Operation level.
@returns(200) Api Operation Policy information.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
@desc Creates or updates policy configuration for the API Operation level.
@required {parameters: any # The policy contents to apply.}
@returns(200) Api Operation policy configuration of the tenant was successfully updated.
@returns(201) Api Operation policy configuration was successfully created.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
@desc Deletes the policy configuration at the Api Operation.
@returns(200) Policy successfully removed
@returns(204) Policy successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags
@desc Lists all Tags associated with the Operation.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) The operation returns a collection of tags associated with the Operation entity.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/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}/apis/{apiId}/operations/{operationId}/tags/{tagId}
@desc Get tag associated with the Operation.
@returns(200) Gets the details of the tag specified by its identifier.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
@desc Assign tag to the Operation.
@returns(200) Tag is already assigned to the Operation.
@returns(201) Tag was assigned to the Operation.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
@desc Detach the tag from the Operation.
@returns(200) Tag was successfully removed from Operation
@returns(204) Tag successfully removed by previous request or does not exist in Operation

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/products
@desc Lists all Products, which the API is part of.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) The operation returns a collection of products which have the Api entity.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies
@desc Get the policy configuration at the API level.
@returns(200) Apis Policy Collection.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
@desc Gets the entity state (Etag) version of the API policy specified by its identifier.
@returns(200) Specified API Policy entity exists and current entity state version is present in the ETag header.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
@desc Get the policy configuration at the API level.
@returns(200) Api Policy information.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
@desc Creates or updates policy configuration for the API.
@required {parameters: any # The policy contents to apply.}
@returns(200) Api policy configuration of the tenant was successfully updated.
@returns(201) Api policy configuration was successfully created.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
@desc Deletes the policy configuration at the Api.
@returns(200) Successfully deleted the policy configuration at the API level.
@returns(204) Successfully deleted the policy configuration at the API level.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas
@desc Get the schema configuration at the API level.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| contentType | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) Apis Schema Collection.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
@desc Gets the entity state (Etag) version of the schema specified by its identifier.
@returns(200) Specified schema entity exists and current entity state version is present in the ETag header.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
@desc Get the schema configuration at the API level.
@returns(200) Api Schema information.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
@desc Creates or updates schema configuration for the API.
@required {parameters: any # The schema contents to apply.}
@returns(200) Api schema configuration of the tenant was successfully updated.
@returns(201) Api schema configuration was successfully created.
@returns(202) Request to create or update Api schema configuration was accepted. Location header contains the URL where the status of the long running operation can be checked.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
@desc Deletes the schema configuration at the Api.
@optional {force: any # If true removes all references to the schema before deleting it.}
@returns(200) Successfully deleted the schema configuration at the API level.
@returns(204) Successfully deleted the schema configuration at the API level.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics
@desc Lists all diagnostics of an API.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) Paged Result response of diagnostics for an API.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
@desc Gets the entity state (Etag) version of the Diagnostic for an API specified by its identifier.
@returns(200) Operation completed successfully.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
@desc Gets the details of the Diagnostic for an API specified by its identifier.
@returns(200) The response body contains the specified Diagnostic entity.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
@desc Creates a new Diagnostic for an API or updates an existing one.
@required {parameters: any # Create parameters.}
@returns(200) Diagnostic was successfully updated.
@returns(201) Diagnostic was successfully created.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
@desc Updates the details of the Diagnostic for an API specified by its identifier.
@required {parameters: any # Diagnostic Update parameters.}
@returns(204) The Diagnostic was successfully updated.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
@desc Deletes the specified Diagnostic from an API.
@returns(200) Diagnostic successfully removed
@returns(204) Diagnostic successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues
@desc Lists all issues associated with the specified API.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | filter | eq |     |, expandCommentsAttachments: any # Expand the comment attachments.}
@returns(200) Paged Result response of issues for the API.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
@desc Gets the entity state (Etag) version of the Issue for an API specified by its identifier.
@returns(200) Operation completed successfully.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
@desc Gets the details of the Issue for an API specified by its identifier.
@optional {expandCommentsAttachments: any # Expand the comment attachments.}
@returns(200) The response body contains the specified Issue entity.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
@desc Creates a new Issue for an API or updates an existing one.
@required {parameters: any # Create parameters.}
@returns(200) Api issue successfully updated
@returns(201) New api issue successfully added

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
@desc Updates an existing issue for an API.
@required {parameters: any # Update parameters.}
@returns(204) Api issue updated successfully

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
@desc Deletes the specified Issue from an API.
@returns(200) Issue successfully removed
@returns(204) Issue successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments
@desc Lists all comments for the Issue associated with the specified API.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) Paged Result response of issue comments for the API.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
@desc Gets the entity state (Etag) version of the issue Comment for an API specified by its identifier.
@returns(200) Operation completed successfully.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
@desc Gets the details of the issue Comment for an API specified by its identifier.
@returns(200) The response body contains the specified issue Comment entity.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
@desc Creates a new Comment for the Issue in an API or updates an existing one.
@required {parameters: any # Create parameters.}
@returns(200) Api issue comment successfully updated
@returns(201) New api issue comment successfully added

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
@desc Deletes the specified comment from an Issue.
@returns(200) Comment successfully removed
@returns(204) Comment successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments
@desc Lists all attachments for the Issue associated with the specified API.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) Paged Result response of issue attachments for the API.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
@desc Gets the entity state (Etag) version of the issue Attachment for an API specified by its identifier.
@returns(200) Operation completed successfully.

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
@desc Gets the details of the issue Attachment for an API specified by its identifier.
@returns(200) The response body contains the specified issue Attachment entity.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
@desc Creates a new Attachment for the Issue in an API or updates an existing one.
@required {parameters: any # Create parameters.}
@returns(200) Api issue attachment successfully updated
@returns(201) New api issue attachment successfully added

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
@desc Deletes the specified comment from an Issue.
@returns(200) Attachment successfully removed
@returns(204) Attachment successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions
@desc Lists all Tags descriptions in scope of API. Model similar to swagger - tagDescription is defined on API level but tag may be assigned to the Operations
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) The operation returns a collection of tagDescriptions associated with the Api entity.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}
@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}/apis/{apiId}/tagDescriptions/{tagDescriptionId}
@desc Get Tag description in scope of API
@returns(200) Gets the description of the tag specified by its identifier in scope if the Api.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}
@desc Create/Update tag description in scope of the Api.
@required {parameters: any # Create parameters.}
@returns(200) Tag Description was updated for the Api.
@returns(201) Tag Description was created for the Api.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}
@desc Delete tag description for the Api.
@returns(200) Tag description successfully removed
@returns(204) Tag description successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags
@desc Lists all Tags associated with the API.
@optional {$filter: any # |   Field     |     Usage     |     Supported operators     |     Supported functions     ||-------------|-------------|-------------|-------------|| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |}
@returns(200) The operation returns a collection of tags associated with the Api entity.

@endpoint HEAD /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/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}/apis/{apiId}/tags/{tagId}
@desc Get tag associated with the API.
@returns(200) Gets the details of the tag specified by its identifier.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
@desc Assign tag to the Api.
@returns(200) Tag is already assigned to the Api.
@returns(201) Tag was assigned to the Api.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
@desc Detach the tag from the Api.
@returns(200) API/Tag association successfully removed
@returns(204) API/Tag association successfully removed by previous request or does not exist

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operationsByTags
@desc Lists a collection of operations associated with tags.
@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 | | apiName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |, includeNotTaggedOperations: any # Include not tagged Operations.}
@returns(200) Lists a collection of TagResource entities.

@end