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

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers
@desc Lists a collection of authorization servers 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 |}
@returns(200) A Collection of the Authorization Server entities for the specified API Management service instance.

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

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
@desc Gets the details of the authorization server specified by its identifier.
@returns(200) Gets the details of the specified authorization server.

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
@desc Creates new authorization server or updates an existing authorization server.
@required {parameters: any # Create or update parameters.}
@returns(200) Authorization server is already registered.
@returns(201) Authorization server was successfully registered.

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
@desc Updates the details of the authorization server specified by its identifier.
@required {parameters: any # OAuth2 Server settings Update parameters.}
@returns(204) The authorization server settings were successfully updated.

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
@desc Deletes specific authorization server instance.
@returns(200) The authorization server settings were successfully deleted.
@returns(204) The authorization server settings were successfully deleted.

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}/listSecrets
@desc Gets the client secret details of the authorization server.
@returns(200) The response body contains the client secret.

@end
