Microsoft.ApiManagement (stable:2017-03-01)

2025/10/30 • 268 new, 268 deleted methods

Policy_ListByService (new)
Description :  Lists all the Global Policy definitions of the Api Management service.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
scope:
{
Description: Policy scope. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Policy_Get (new)
Description :  Get the Global policy definition of the Api Management service.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Policy_CreateOrUpdate (new)
Description :  Creates or updates the global policy configuration of the Api Management service.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Policy_Delete (new)
Description :  Deletes the global policy configuration of the Api Management Service.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the policy to be deleted. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
PolicySnippets_ListByService (new)
Description :  Lists all policy snippets.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policySnippets
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
scope:
{
Description: Policy scope. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Policy snippet value. ,
Required: False ,
}
[
{
name:
{
Description: Snippet name. ,
Required: False ,
}
string ,
content:
{
Description: Snippet content. ,
Required: False ,
}
string ,
toolTip:
{
Description: Snippet toolTip. ,
Required: False ,
}
string ,
scope:
{
Description: Binary OR value of the Snippet scope. ,
Required: False ,
}
integer ,
}
,
]
,
}
Regions_ListByService (new)
Description :  Lists all azure regions in which the service exists.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/regions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Lists of Regions. ,
Required: False ,
}
[
{
name:
{
Description: Region name. ,
Required: False ,
}
string ,
isMasterRegion:
{
Description: whether Region is the master region. ,
Required: False ,
}
boolean ,
isDeleted:
{
Description: whether Region is deleted. ,
Required: False ,
}
boolean ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Api_ListByService (new)
Description :  Lists all APIs of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
expandApiVersionSet:
{
Description: Include full ApiVersionSet resource in response ,
Required: False ,
}
boolean ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_Get (new)
Description :  Gets the details of the API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: API details. ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_CreateOrUpdate (new)
Description :  Creates new or updates existing specified API of the API Management service instance.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Api entity create of update properties. ,
Required: False ,
}
{
contentValue:
{
Description: Content value when Importing an API. ,
Required: False ,
}
string ,
contentFormat:
{
Description: Format of the Content in which the API is getting imported. ,
Enum:
{
wadl-xml: The contents are inline and Content type is a WADL document. ,
wadl-link-json: The WADL document is hosted on a publicly accessible internet address. ,
swagger-json: The contents are inline and Content Type is a OpenApi 2.0 Document. ,
swagger-link-json: The Open Api 2.0 document is hosted on a publicly accessible internet address. ,
wsdl: The contents are inline and the document is a WSDL/Soap document. ,
wsdl-link: The WSDL document is hosted on a publicly accessible internet address. ,
}
,
Required: False ,
}
enum ,
wsdlSelector:
{
Description: Criteria to limit import of WSDL to a subset of the document. ,
Required: False ,
}
{
wsdlServiceName:
{
Description: Name of service to import from WSDL ,
Required: False ,
}
string ,
wsdlEndpointName:
{
Description: Name of endpoint(port) to import from WSDL ,
Required: False ,
}
string ,
}
,
}
,
}
,
If-Match:
{
Description: ETag of the Api Entity. For Create Api Etag should not be specified. For Update Etag should match the existing Entity or it can be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: API details. ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: API details. ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_Update (new)
Description :  Updates the specified API of the API Management service instance.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
parameters:
{
Description: API Update Contract parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API entity that can be updated. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: False ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
If-Match:
{
Description: ETag of the API entity. ETag should match the current entity state in the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_Delete (new)
Description :  Deletes the specified API of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the API Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRevisions_List (new)
Description :  Lists all revisions of an API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions
{
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| |apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith| ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Api Revision Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API Revision. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Revision number of API. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API Revision was created. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API Revision were updated. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
description:
{
Description: Description of the API Revision. ,
Required: False ,
}
string ,
privateUrl:
{
Description: Gateway URL for accessing the non-current API Revision. ,
Required: False ,
}
string ,
isOnline:
{
Description: Indicates if API revision is the current api revision. ,
Required: False ,
}
boolean ,
isCurrent:
{
Description: Indicates if API revision is accessible via the gateway. ,
Required: False ,
}
boolean ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_List (new)
Description :  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.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases
{
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | |notes|ge le eq ne gt lt|substringof contains startswith endswith| ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Get (new)
Description :  Returns the details of an API release.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{}

⚐ Response (200)

{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Create (new)
Description :  Creates a new Release for the API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Update (new)
Description :  Updates the details of the release of the API specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{
parameters:
{
Description: API Release Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Delete (new)
Description :  Deletes the specified release in the API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{
If-Match:
{
Description: ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_ListByApi (new)
Description :  Lists a collection of the operations for the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | name | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the API operation specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_Get (new)
Description :  Gets the details of the API Operation specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Api Operation details. ,
}
{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_CreateOrUpdate (new)
Description :  Creates a new operation in the API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_Update (new)
Description :  Updates the details of the operation in the API specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: API Operation Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API Operation entity that can be updated. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the API Operation Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_Delete (new)
Description :  Deletes the specified operation in the API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the API Operation Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_ListByOperation (new)
Description :  Get the list of policy configuration at the API Operation level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the API operation policy specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_Get (new)
Description :  Get the policy configuration at the API Operation level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_CreateOrUpdate (new)
Description :  Creates or updates policy configuration for the API Operation level.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Api Operation policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_Delete (new)
Description :  Deletes the policy configuration at the Api Operation.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api Operation Policy to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiProduct_ListByApis (new)
Description :  Lists all Products, which the API is part of.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/products
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_ListByApi (new)
Description :  Get the policy configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: The response of the list policy operation. ,
}
{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the API policy specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_Get (new)
Description :  Get the policy configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_CreateOrUpdate (new)
Description :  Creates or updates policy configuration for the API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Api Policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_Delete (new)
Description :  Deletes the policy configuration at the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_ListByApi (new)
Description :  Get the schema configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: The response of the list schema operation. ,
}
{
value:
{
Description: Api Schema Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the schema specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_Get (new)
Description :  Get the schema configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Schema Contract details. ,
}
{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_CreateOrUpdate (new)
Description :  Creates or updates schema configuration for the API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: The schema contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Api Schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_Delete (new)
Description :  Deletes the schema configuration at the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_ListByTags (new)
Description :  Lists a collection of apis associated with tags.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apisByTags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | aid | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | isCurrent | eq | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagResource entity contract properties. ,
Required: False ,
}
{
tag:
{
Description: Tag associated with the resource. ,
Required: False ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
operation:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Operation entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Operation name. ,
Required: False ,
}
string ,
apiName:
{
Description: Api Name. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Api Revision. ,
Required: False ,
}
string ,
apiVersion:
{
Description: Api Version. ,
Required: False ,
}
string ,
description:
{
Description: Operation Description. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
product:
{
Description: Product associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
ApiDiagnostic_ListByService (new)
Description :  Lists all diagnostics of an API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Head (new)
Description :  Gets the entity state (Etag) version of the Diagnostic for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Get (new)
Description :  Gets the details of the Diagnostic for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Diagnostic details. ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_CreateOrUpdate (new)
Description :  Creates a new Diagnostic for an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Update (new)
Description :  Updates the details of the Diagnostic for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Diagnostic Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Delete (new)
Description :  Deletes the specified Diagnostic from an API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_ListByService (new)
Description :  Lists all loggers associated with the specified Diagnostic of an API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | type | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Logger values. ,
Required: False ,
}
[
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_CheckEntityExists (new)
Description :  Checks that logger entity specified by identifier is associated with the diagnostics entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_CreateOrUpdate (new)
Description :  Attaches a logger to a diagnostic for an API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_Delete (new)
Description :  Deletes the specified Logger from Diagnostic for an API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssues_ListByService (new)
Description :  Lists all issues associated with the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | state | eq | | | userId | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Issue values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_Head (new)
Description :  Gets the entity state (Etag) version of the Issue for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_Get (new)
Description :  Gets the details of the Issue for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Issue Contract details. ,
}
{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_CreateOrUpdate (new)
Description :  Creates a new Issue for an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_Delete (new)
Description :  Deletes the specified Issue from an API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComments_ListByService (new)
Description :  Lists all comments for the Issue associated with the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Issue Comment values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssuComment_Head (new)
Description :  Gets the entity state (Etag) version of the issue Comment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComment_Get (new)
Description :  Gets the details of the issue Comment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Issue Comment Contract details. ,
}
{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComment_CreateOrUpdate (new)
Description :  Creates a new Comment for the Issue in an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComment_Delete (new)
Description :  Deletes the specified comment from an Issue.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachments_ListByService (new)
Description :  Lists all comments for the Issue associated with the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Issue Attachment values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssuAttachment_Head (new)
Description :  Gets the entity state (Etag) version of the issue Attachment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachment_Get (new)
Description :  Gets the details of the issue Attachment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Issue Attachment Contract details. ,
}
{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachment_CreateOrUpdate (new)
Description :  Creates a new Attachment for the Issue in an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachment_Delete (new)
Description :  Deletes the specified comment from an Issue.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_ListByService (new)
Description :  Lists a collection of authorization servers defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
AuthorizationServer_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the authorizationServer specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_Get (new)
Description :  Gets the details of the authorization server specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: External OAuth authorization server settings. ,
}
{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_CreateOrUpdate (new)
Description :  Creates new authorization server or updates an existing authorization server.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_Update (new)
Description :  Updates the details of the authorization server specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
parameters:
{
Description: OAuth2 Server settings Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the External OAuth authorization server update Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: False ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: False ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: False ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: False ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the authorization server to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_Delete (new)
Description :  Deletes specific authorization server instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the authentication server to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_ListByService (new)
Description :  Lists a collection of backends in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | host | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Backend values. ,
Required: False ,
}
[
{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the backend specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Get (new)
Description :  Gets the details of the backend specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Backend details. ,
}
{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_CreateOrUpdate (new)
Description :  Creates or Updates a backend.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Update (new)
Description :  Updates an existing backend.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Backend entity update contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: False ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the backend to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Delete (new)
Description :  Deletes the specified backend.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the backend to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Reconnect (new)
Description :  Notifies the APIM proxy to create a new connection to the backend after the specified timeout. If no timeout was specified, timeout of 2 minutes is used.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}/reconnect
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Reconnect request parameters. ,
Required: False ,
}
{
properties:
{
Description: Reconnect request properties. ,
Required: False ,
}
{
after:
{
Description: Duration in ISO8601 format after which reconnect will be initiated. ,
Format: duration ,
Required: False ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_ListByService (new)
Description :  Lists a collection of all certificates in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |----------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | subject | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | thumbprint | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | expirationDate | ge, le, eq, ne, gt, lt | N/A | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the certificate specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_Get (new)
Description :  Gets the details of the certificate specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Certificate details. ,
}
{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_CreateOrUpdate (new)
Description :  Creates or updates the certificate being used for authentication with the backend.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Certificate create or update properties details. ,
Required: False ,
}
{
data:
{
Description: Base 64 encoded certificate using the application/x-pkcs12 representation. ,
Required: True ,
}
string ,
password:
{
Description: Password for the Certificate ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the certificate to update. A value of "*" can be used for If-Match to unconditionally apply the operation.. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_Delete (new)
Description :  Deletes specific certificate.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the certificate to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiManagementOperations_List (new)
Description :  Lists all of the available REST API operations of the Microsoft.ApiManagement provider.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.ApiManagement/operations
{
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of operations supported by the resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{operation} ,
Required: False ,
}
string ,
display:
{
Description: The object that describes the operation. ,
Required: False ,
}
{
provider:
{
Description: Friendly name of the resource provider ,
Required: False ,
}
string ,
operation:
{
Description: Operation type: read, write, delete, listKeys/action, etc. ,
Required: False ,
}
string ,
resource:
{
Description: Resource type on which the operation is performed. ,
Required: False ,
}
string ,
description:
{
Description: Friendly name of the operation ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The operation origin. ,
Required: False ,
}
string ,
properties:
{
Description: The operation properties. ,
Required: False ,
}
object ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results if there are any. ,
Required: False ,
}
string ,
}
ApiManagementService_Restore (new)
Description :  Restores a backup of an API Management service created using the ApiManagementService_Backup operation on the current service. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/restore
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Restore API Management service from backup operation. ,
Required: True ,
}
{
storageAccount:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) name. ,
Required: True ,
}
string ,
accessKey:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) access key. ,
Required: True ,
}
string ,
containerName:
{
Description: Azure Cloud Storage blob container name used to place/retrieve the backup. ,
Required: True ,
}
string ,
backupName:
{
Description: The name of the backup file to create. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{}
ApiManagementService_Backup (new)
Description :  Creates a backup of the API Management service to the given Azure Storage Account. This is long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the ApiManagementService_Backup operation. ,
Required: True ,
}
{
storageAccount:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) name. ,
Required: True ,
}
string ,
accessKey:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) access key. ,
Required: True ,
}
string ,
containerName:
{
Description: Azure Cloud Storage blob container name used to place/retrieve the backup. ,
Required: True ,
}
string ,
backupName:
{
Description: The name of the backup file to create. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{}
ApiManagementService_CreateOrUpdate (new)
Description :  Creates or updates an API Management service. This is long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate API Management service operation. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
ApiManagementService_Update (new)
Description :  Updates an existing API Management service.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate API Management service operation. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API Management service. ,
Required: False ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: False ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: False ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: False ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{}
ApiManagementService_Get (new)
Description :  Gets an API Management service resource description.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
ApiManagementService_Delete (new)
Description :  Deletes an existing API Management service.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}
ApiManagementService_ListByResourceGroup (new)
Description :  List all API Management services within a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the List API Management services operation. ,
Required: True ,
}
[
{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: Link to the next set of results. Not empty if Value contains incomplete list of API Management services. ,
Required: False ,
}
string ,
}
ApiManagementService_List (new)
Description :  Lists all API Management services within an Azure subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/service
{
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the List API Management services operation. ,
Required: True ,
}
[
{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: Link to the next set of results. Not empty if Value contains incomplete list of API Management services. ,
Required: False ,
}
string ,
}
ApiManagementService_GetSsoToken (new)
Description :  Gets the Single-Sign-On token for the API Management Service which is valid for 5 Minutes.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/getssotoken
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
redirectUri:
{
Description: Redirect URL to the Publisher Portal containing the SSO token. ,
Required: False ,
}
string ,
}
ApiManagementService_CheckNameAvailability (new)
Description :  Checks availability and correctness of a name for an API Management service.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/checkNameAvailability
{
parameters:
{
Description: Parameters supplied to the CheckNameAvailability operation. ,
Required: True ,
}
{
name:
{
Description: The name to check for availability. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: True if the name is available and can be used to create a new API Management service; otherwise false. ,
Required: False ,
}
boolean ,
message:
{
Description: If reason == invalid, provide the user with the reason why the given name is invalid, and provide the resource naming requirements so that the user can select a valid name. If reason == AlreadyExists, explain that is already in use, and direct them to select a different name. ,
Required: False ,
}
string ,
reason:
{
Description: Invalid indicates the name provided does not match the resource provider’s naming requirements (incorrect length, unsupported characters, etc.) AlreadyExists indicates that the name is already in use and is therefore unavailable. ,
Enum:
{
Valid: No description available. ,
Invalid: No description available. ,
AlreadyExists: No description available. ,
}
,
Required: False ,
}
enum ,
}
ApiManagementService_ApplyNetworkConfigurationUpdates (new)
Description :  Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated network settings.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Apply Network Configuration operation. If the parameters are empty, all the regions in which the Api Management service is deployed will be updated sequentially without incurring downtime in the region. ,
Required: False ,
}
{
location:
{
Description: Location of the Api Management service to update for a multi-region service. For a service deployed in a single region, this parameter is not required. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
ApiManagementService_UploadCertificate (new)
Description :  Upload Custom Domain SSL certificate for an API Management service. This operation will be deprecated in future releases.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/uploadcertificate
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Upload SSL certificate for an API Management service operation. ,
Required: True ,
}
{
type:
{
Description: Hostname type. ,
Enum:
{
Proxy: No description available. ,
Portal: No description available. ,
Management: No description available. ,
Scm: No description available. ,
}
,
Required: True ,
}
enum ,
certificate:
{
Description: Base64 Encoded certificate. ,
Required: True ,
}
string ,
certificate_password:
{
Description: Certificate password. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
expiry:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
subject:
{
Description: Subject of the certificate. ,
Required: True ,
}
string ,
}
ApiManagementService_UpdateHostname (new)
Description :  Creates, updates, or deletes the custom hostnames for an API Management service. The custom hostname can be applied to the Proxy and Portal endpoint. This is a long running operation and could take several minutes to complete. This operation will be deprecated in the next version update.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/updatehostname
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the UpdateHostname operation. ,
Required: True ,
}
{
update:
{
Description: Hostnames to create or update. ,
Required: False ,
}
[
{
type:
{
Description: Hostname type. ,
Enum:
{
Proxy: No description available. ,
Portal: No description available. ,
Management: No description available. ,
Scm: No description available. ,
}
,
Required: True ,
}
enum ,
hostname:
{
Description: Hostname to configure. ,
Required: True ,
}
string ,
certificate:
{
Description: Certificate information. ,
Required: True ,
}
{
expiry:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
subject:
{
Description: Subject of the certificate. ,
Required: True ,
}
string ,
}
,
}
,
]
,
delete:
{
Description: Hostnames types to delete. ,
Required: False ,
}
[
string ,
]
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
Diagnostic_ListByService (new)
Description :  Lists all diagnostics of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Head (new)
Description :  Gets the entity state (Etag) version of the Diagnostic specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Get (new)
Description :  Gets the details of the Diagnostic specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Diagnostic details. ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_CreateOrUpdate (new)
Description :  Creates a new Diagnostic or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Update (new)
Description :  Updates the details of the Diagnostic specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Diagnostic Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Delete (new)
Description :  Deletes the specified Diagnostic.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_ListByService (new)
Description :  Lists all loggers associated with the specified Diagnostic of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | type | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Logger values. ,
Required: False ,
}
[
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_CheckEntityExists (new)
Description :  Checks that logger entity specified by identifier is associated with the diagnostics entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_CreateOrUpdate (new)
Description :  Attaches a logger to a diagnostic.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_Delete (new)
Description :  Deletes the specified Logger from Diagnostic.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_ListByService (new)
Description :  Lists a collection of properties defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
EmailTemplate_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the email template specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_Get (new)
Description :  Gets the details of the email template specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Email Template details. ,
}
{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_CreateOrUpdate (new)
Description :  Updates an Email Template.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Email Template update parameters. ,
Required: True ,
}
{
properties:
{
Description: Email Template Update contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: False ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: False ,
}
string ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_Update (new)
Description :  Updates the specific Email Template.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Email Template Update contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: False ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: False ,
}
string ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_Delete (new)
Description :  Reset the Email Template to default template provided by the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Email Template to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_ListByService (new)
Description :  Lists a collection of groups defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | type | eq, ne | N/A | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Group_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the group specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_Get (new)
Description :  Gets the details of the group specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Contract details. ,
}
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_CreateOrUpdate (new)
Description :  Creates or Updates a group.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create Group operation. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. ,
Required: False ,
}
string ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: Identifier of the external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_Update (new)
Description :  Updates the details of the group specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Group entity update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: False ,
}
string ,
description:
{
Description: Group description. ,
Required: False ,
}
string ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: Identifier of the external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Group Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_Delete (new)
Description :  Deletes specific group of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Group Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_List (new)
Description :  Lists a collection of the members of the group, specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |------------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | firstName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | lastName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | email | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | N/A | | registrationDate | ge, le, eq, ne, gt, lt | N/A | | note | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_CheckEntityExists (new)
Description :  Checks that user entity specified by identifier is associated with the group entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_Create (new)
Description :  Adds a user to the specified group.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_Delete (new)
Description :  Remove existing user from existing group.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_ListByService (new)
Description :  Lists a collection of Identity Provider configured in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Identity Provider configuration values. ,
Required: False ,
}
[
{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the identityProvider specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_Get (new)
Description :  Gets the configuration details of the identity Provider configured in specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Identity Provider details. ,
}
{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_CreateOrUpdate (new)
Description :  Creates or Updates the IdentityProvider configuration.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_Update (new)
Description :  Updates an existing IdentityProvider configuration.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Identity Provider update properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: False ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the identity provider configuration to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_Delete (new)
Description :  Deletes the specified identity provider configuration.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the backend to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_ListByService (new)
Description :  Lists a collection of loggers in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | type | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Logger values. ,
Required: False ,
}
[
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the logger specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_Get (new)
Description :  Gets the details of the logger specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Logger details. ,
}
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_CreateOrUpdate (new)
Description :  Creates or Updates a logger.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_Update (new)
Description :  Updates an existing logger.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Logger entity update contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: Logger credentials. ,
Required: False ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the logger to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_Delete (new)
Description :  Deletes the specified logger.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the logger to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NetworkStatus_ListByService (new)
Description :  Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/networkstatus
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
dnsServers:
{
Description: Gets the list of DNS servers IPV4 addresses. ,
Required: True ,
}
[
string ,
]
,
connectivityStatus:
{
Description: Gets the list of Connectivity Status to the Resources on which the service depends upon. ,
Required: True ,
}
[
{
name:
{
Description: The hostname of the resource which the service depends on. This can be the database, storage or any other azure resource on which the service depends upon. ,
Required: True ,
}
string ,
status:
{
Description: Resource Connectivity Status Type identifier. ,
Enum:
{
initializing: No description available. ,
success: No description available. ,
failure: No description available. ,
}
,
Required: True ,
}
enum ,
error:
{
Description: Error details of the connectivity to the resource. ,
Required: False ,
}
string ,
lastUpdated:
{
Description: The date when the resource connectivity status was last updated. This status should be updated every 15 minutes. If this status has not been updated, then it means that the service has lost network connectivity to the resource, from inside the Virtual Network.The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
lastStatusChange:
{
Description: The date when the resource connectivity status last Changed from success to failure or vice-versa. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NetworkStatus_ListByLocation (new)
Description :  Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/locations/{locationName}/networkstatus
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
locationName:
{
Description: Location in which the API Management service is deployed. This is one of the Azure Regions like West US, East US, South Central US. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
dnsServers:
{
Description: Gets the list of DNS servers IPV4 addresses. ,
Required: True ,
}
[
string ,
]
,
connectivityStatus:
{
Description: Gets the list of Connectivity Status to the Resources on which the service depends upon. ,
Required: True ,
}
[
{
name:
{
Description: The hostname of the resource which the service depends on. This can be the database, storage or any other azure resource on which the service depends upon. ,
Required: True ,
}
string ,
status:
{
Description: Resource Connectivity Status Type identifier. ,
Enum:
{
initializing: No description available. ,
success: No description available. ,
failure: No description available. ,
}
,
Required: True ,
}
enum ,
error:
{
Description: Error details of the connectivity to the resource. ,
Required: False ,
}
string ,
lastUpdated:
{
Description: The date when the resource connectivity status was last updated. This status should be updated every 15 minutes. If this status has not been updated, then it means that the service has lost network connectivity to the resource, from inside the Virtual Network.The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
lastStatusChange:
{
Description: The date when the resource connectivity status last Changed from success to failure or vice-versa. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Notification_ListByService (new)
Description :  Lists a collection of properties defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Notification entity contract properties. ,
Required: False ,
}
{
title:
{
Description: Title of the Notification. ,
Required: True ,
}
string ,
description:
{
Description: Description of the Notification. ,
Required: False ,
}
string ,
recipients:
{
Description: Recipient Parameter values. ,
Required: False ,
}
{
emails:
{
Description: List of Emails subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
users:
{
Description: List of Users subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Notification_Get (new)
Description :  Gets the details of the Notification specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Notification entity contract properties. ,
Required: False ,
}
{
title:
{
Description: Title of the Notification. ,
Required: True ,
}
string ,
description:
{
Description: Description of the Notification. ,
Required: False ,
}
string ,
recipients:
{
Description: Recipient Parameter values. ,
Required: False ,
}
{
emails:
{
Description: List of Emails subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
users:
{
Description: List of Users subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Notification_CreateOrUpdate (new)
Description :  Updates an Notification.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Notification entity contract properties. ,
Required: False ,
}
{
title:
{
Description: Title of the Notification. ,
Required: True ,
}
string ,
description:
{
Description: Description of the Notification. ,
Required: False ,
}
string ,
recipients:
{
Description: Recipient Parameter values. ,
Required: False ,
}
{
emails:
{
Description: List of Emails subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
users:
{
Description: List of Users subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_ListByNotification (new)
Description :  Gets the list of the Notification Recipient User subscribed to the notification.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Recipient User entity contract properties. ,
Required: False ,
}
{
userId:
{
Description: API Management UserId subscribed to notification. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_Get (new)
Description :  Determine if the Notification Recipient User is subscribed to the notification.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_CreateOrUpdate (new)
Description :  Adds the API Management User to the list of Recipients for the Notification.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Recipient User entity contract properties. ,
Required: False ,
}
{
userId:
{
Description: API Management UserId subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Recipient User entity contract properties. ,
Required: False ,
}
{
userId:
{
Description: API Management UserId subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_Delete (new)
Description :  Removes the API Management user from the list of Notification.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_ListByNotification (new)
Description :  Gets the list of the Notification Recipient Emails subscribed to a notification.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Recipient Email contract properties. ,
Required: False ,
}
{
email:
{
Description: User Email subscribed to notification. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_Get (new)
Description :  Determine if Notification Recipient Email subscribed to the notification.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
email:
{
Description: Email identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_CreateOrUpdate (new)
Description :  Adds the Email address to the list of Recipients for the Notification.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
email:
{
Description: Email identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Recipient Email contract properties. ,
Required: False ,
}
{
email:
{
Description: User Email subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Recipient Email contract properties. ,
Required: False ,
}
{
email:
{
Description: User Email subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_Delete (new)
Description :  Removes the email from the list of Notification.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
email:
{
Description: Email identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_ListByService (new)
Description :  Lists all OpenID Connect Providers.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
OpenIdConnectProvider_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the openIdConnectProvider specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_Get (new)
Description :  Gets specific OpenID Connect Provider.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: OpenId Connect Provider details. ,
}
{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_CreateOrUpdate (new)
Description :  Creates or updates the OpenID Connect Provider.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_Update (new)
Description :  Updates the specific OpenID Connect Provider.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: OpenId Connect Provider Update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: False ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: False ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: False ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the OpenID Connect Provider to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_Delete (new)
Description :  Deletes specific OpenID Connect Provider of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the OpenID Connect Provider to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignInSettings_Head (new)
Description :  Gets the entity state (Etag) version of the SignInSettings.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignInSettings_Get (new)
Description :  Get Sign-In settings.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Sign-In settings for the Developer Portal. ,
}
{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}
,
}
SignInSettings_Update (new)
Description :  Update Sign-In settings.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Update Sign-In settings. ,
Required: True ,
}
{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignInSettings_CreateOrUpdate (new)
Description :  Create or Update Sign-In settings.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignUpSettings_Head (new)
Description :  Gets the entity state (Etag) version of the SignUpSettings.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignUpSettings_Get (new)
Description :  Get Sign-Up settings.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Sign-Up settings for a developer portal. ,
}
{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
}
SignUpSettings_Update (new)
Description :  Update Sign-Up settings.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Update Sign-Up settings. ,
Required: True ,
}
{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignUpSettings_CreateOrUpdate (new)
Description :  Create or Update Sign-Up settings.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DelegationSettings_Head (new)
Description :  Gets the entity state (Etag) version of the DelegationSettings.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DelegationSettings_Get (new)
Description :  Get Delegation settings.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Delegation settings for a developer portal. ,
}
{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
}
DelegationSettings_Update (new)
Description :  Update Delegation settings.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Update Delegation settings. ,
Required: True ,
}
{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DelegationSettings_CreateOrUpdate (new)
Description :  Create or Update Delegation settings.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_ListByService (new)
Description :  Lists a collection of products in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | terms | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
expandGroups:
{
Description: When set to true, the response contains an array of groups that have visibility to the product. The default is false. ,
Required: False ,
}
boolean ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the product specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_Get (new)
Description :  Gets the details of the product specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Product details. ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_CreateOrUpdate (new)
Description :  Creates or Updates a product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_Update (new)
Description :  Update product.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Product entity Update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Product Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_Delete (new)
Description :  Delete product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
deleteSubscriptions:
{
Description: Delete existing subscriptions to the product or not. ,
Required: False ,
}
boolean ,
If-Match:
{
Description: ETag of the Product Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_ListByProduct (new)
Description :  Lists a collection of the APIs associated with a product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_CheckEntityExists (new)
Description :  Checks that API entity specified by identifier is associated with the Product entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_CreateOrUpdate (new)
Description :  Adds an API to the specified product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_Delete (new)
Description :  Deletes the specified API from the specified product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_ListByProduct (new)
Description :  Lists the collection of developer groups associated with the specified product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | type | eq, ne | N/A | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_CheckEntityExists (new)
Description :  Checks that Group entity specified by identifier is associated with the Product entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_CreateOrUpdate (new)
Description :  Adds the association between the specified developer group with the specified product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_Delete (new)
Description :  Deletes the association between the specified group and product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductSubscriptions_List (new)
Description :  Lists the collection of subscriptions to the specified product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/subscriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |--------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | stateComment | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | productId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_ListByProduct (new)
Description :  Get the policy configuration at the Product level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: The response of the list policy operation. ,
}
{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_Get (new)
Description :  Get the policy configuration at the Product level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_CreateOrUpdate (new)
Description :  Creates or updates policy configuration for the Product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_Delete (new)
Description :  Deletes the policy configuration at the Product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the product policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_ListByService (new)
Description :  Lists a collection of properties defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|-------------------------------------------------------| | tags | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith, any, all | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Property_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the property specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_Get (new)
Description :  Gets the details of the property specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Property details. ,
}
{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_CreateOrUpdate (new)
Description :  Creates or updates a property.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_Update (new)
Description :  Updates the specific property.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Property entity Update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: False ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_Delete (new)
Description :  Deletes specific property from the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the property to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByCounterKeys_ListByService (new)
Description :  Lists a collection of current quota counter periods associated with the counter-key configured in the policy on the specified service instance. The api does not support paging yet.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Quota counter values. ,
Required: False ,
}
[
{
counterKey:
{
Description: The Key value of the Counter. Must not be empty. ,
Required: True ,
}
string ,
periodKey:
{
Description: Identifier of the Period for which the counter was collected. Must not be empty. ,
Required: True ,
}
string ,
periodStartTime:
{
Description: The date of the start of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
periodEndTime:
{
Description: The date of the end of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
Value:
{
Description: Quota Value Properties ,
Required: False ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByCounterKeys_Update (new)
Description :  Updates all the quota counter values specified with the existing quota counter key to a value in the specified service instance. This should be used for reset of the quota counter values.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
parameters:
{
Description: The value of the quota counter to be applied to all quota counter periods. ,
Required: True ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByPeriodKeys_Get (new)
Description :  Gets the value of the quota counter associated with the counter-key in the policy for the specific period in service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}/{quotaPeriodKey}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
quotaPeriodKey:
{
Description: Quota period key identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
counterKey:
{
Description: The Key value of the Counter. Must not be empty. ,
Required: True ,
}
string ,
periodKey:
{
Description: Identifier of the Period for which the counter was collected. Must not be empty. ,
Required: True ,
}
string ,
periodStartTime:
{
Description: The date of the start of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
periodEndTime:
{
Description: The date of the end of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
Value:
{
Description: Quota Value Properties ,
Required: False ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByPeriodKeys_Update (new)
Description :  Updates an existing quota counter value in the specified service instance.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}/{quotaPeriodKey}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
quotaPeriodKey:
{
Description: Quota period key identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: The value of the Quota counter to be applied on the specified period. ,
Required: True ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Reports_ListByApi (new)
Description :  Lists report records by API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byApi
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByUser (new)
Description :  Lists report records by User.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byUser
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByOperation (new)
Description :  Lists report records by API Operations.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byOperation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByProduct (new)
Description :  Lists report records by Product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byProduct
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByGeo (new)
Description :  Lists report records by geography.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byGeo
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListBySubscription (new)
Description :  Lists report records by subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/bySubscription
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByTime (new)
Description :  Lists report records by Time.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byTime
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
interval:
{
Description: By time interval. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds)) ,
Format: duration ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByRequest (new)
Description :  Lists report records by Request.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byRequest
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
method:
{
Description: The HTTP method associated with this request.. ,
Required: False ,
}
string ,
url:
{
Description: The full URL associated with this request. ,
Required: False ,
}
string ,
ipAddress:
{
Description: The client IP address associated with this request. ,
Required: False ,
}
string ,
backendResponseCode:
{
Description: The HTTP status code received by the gateway as a result of forwarding this request to the backend. ,
Required: False ,
}
string ,
responseCode:
{
Description: The HTTP status code returned by the gateway. ,
Format: int32 ,
Required: False ,
}
integer ,
responseSize:
{
Description: The size of the response returned by the gateway. ,
Format: int32 ,
Required: False ,
}
integer ,
timestamp:
{
Description: The date and time when this request was received by the gateway in ISO 8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
cache:
{
Description: Specifies if response cache was involved in generating the response. If the value is none, the cache was not used. If the value is hit, cached response was returned. If the value is miss, the cache was used but lookup resulted in a miss and request was fulfilled by the backend. ,
Required: False ,
}
string ,
apiTime:
{
Description: The total time it took to process this request. ,
Format: double ,
Required: False ,
}
number ,
serviceTime:
{
Description: he time it took to forward this request to the backend and get the response back. ,
Format: double ,
Required: False ,
}
number ,
apiRegion:
{
Description: Azure region where the gateway that processed this request is located. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
requestId:
{
Description: Request Identifier. ,
Required: False ,
}
string ,
requestSize:
{
Description: The size of this request.. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
}
Subscription_List (new)
Description :  Lists all subscriptions of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |--------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | stateComment | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | productId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the apimanagement subscription specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_Get (new)
Description :  Gets the specified Subscription entity.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Subscription details. ,
}
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_CreateOrUpdate (new)
Description :  Creates or updates the subscription of specified user to the specified product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: User (user id path) for whom subscription is being created in form /users/{uid} ,
Required: True ,
}
string ,
productId:
{
Description: Product (product id path) for which subscription is being created in form /products/{productId} ,
Required: True ,
}
string ,
displayName:
{
Description: Subscription name. ,
Required: True ,
}
string ,
primaryKey:
{
Description: Primary subscription key. If not specified during request key will be generated automatically. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary subscription key. If not specified during request key will be generated automatically. ,
Required: False ,
}
string ,
state:
{
Description: Initial subscription state. If no value is specified, subscription is created with Submitted state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_Update (new)
Description :  Updates the details of a subscription specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Subscription Update contract properties. ,
Required: False ,
}
{
userId:
{
Description: User identifier path: /users/{uid} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path: /products/{productId} ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
displayName:
{
Description: Subscription name. ,
Required: False ,
}
string ,
primaryKey:
{
Description: Primary subscription key. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary subscription key. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: False ,
}
enum ,
stateComment:
{
Description: Comments describing subscription state change by the administrator. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Subscription Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_Delete (new)
Description :  Deletes the specified subscription.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Subscription Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_RegeneratePrimaryKey (new)
Description :  Regenerates primary key of existing subscription of the API Management service instance.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/regeneratePrimaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_RegenerateSecondaryKey (new)
Description :  Regenerates secondary key of existing subscription of the API Management service instance.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/regenerateSecondaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagResource_ListByService (new)
Description :  Lists a collection of resources associated with tags.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tagResources
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | aid | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | terms | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | isCurrent | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagResource entity contract properties. ,
Required: False ,
}
{
tag:
{
Description: Tag associated with the resource. ,
Required: False ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
operation:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Operation entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Operation name. ,
Required: False ,
}
string ,
apiName:
{
Description: Api Name. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Api Revision. ,
Required: False ,
}
string ,
apiVersion:
{
Description: Api Version. ,
Required: False ,
}
string ,
description:
{
Description: Operation Description. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
product:
{
Description: Product associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Tag_ListByService (new)
Description :  Lists a collection of tags defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Tag_GetEntityState (new)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_Get (new)
Description :  Gets the details of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_CreateOrUpdate (new)
Description :  Creates a tag.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create Tag operation. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_Update (new)
Description :  Updates the details of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create Tag operation. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Tag Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_Delete (new)
Description :  Deletes specific tag of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Tag Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_ListByApi (new)
Description :  Lists all Tags associated with the API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetEntityStateByApi (new)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetByApi (new)
Description :  Get tag associated with the API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_AssignToApi (new)
Description :  Assign tag to the Api.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_DetachFromApi (new)
Description :  Detach the tag from the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_ListByApi (new)
Description :  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
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_GetEntityState (new)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_Get (new)
Description :  Get tag associated with the API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Contract details. ,
}
{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_CreateOrUpdate (new)
Description :  Create/Update tag description in scope of the Api.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create TagDescription operation. ,
Required: False ,
}
{
description:
{
Description: Description of the Tag. ,
Required: False ,
}
string ,
externalDocsUrl:
{
Description: Absolute URL of external resources describing the tag. ,
Required: False ,
}
string ,
externalDocsDescription:
{
Description: Description of the external resources describing the tag. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_Delete (new)
Description :  Delete tag description for the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_ListByOperation (new)
Description :  Lists all Tags associated with the Operation.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetEntityStateByOperation (new)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetByOperation (new)
Description :  Get tag associated with the Operation.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_AssignToOperation (new)
Description :  Assign tag to the Operation.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_DetachFromOperation (new)
Description :  Detach the tag from the Operation.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Operation_ListByTags (new)
Description :  Lists a collection of operations associated with tags.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operationsByTags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagResource entity contract properties. ,
Required: False ,
}
{
tag:
{
Description: Tag associated with the resource. ,
Required: False ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
operation:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Operation entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Operation name. ,
Required: False ,
}
string ,
apiName:
{
Description: Api Name. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Api Revision. ,
Required: False ,
}
string ,
apiVersion:
{
Description: Api Version. ,
Required: False ,
}
string ,
description:
{
Description: Operation Description. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
product:
{
Description: Product associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Tag_ListByProduct (new)
Description :  Lists all Tags associated with the Product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetEntityStateByProduct (new)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetByProduct (new)
Description :  Get tag associated with the Product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_AssignToProduct (new)
Description :  Assign tag to the Product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_DetachFromProduct (new)
Description :  Detach the tag from the Product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccess_Get (new)
Description :  Get tenant access information details.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tenant access information contract of the API Management service. ,
}
{
id:
{
Description: Identifier. ,
Required: False ,
}
string ,
primaryKey:
{
Description: Primary access key. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary access key. ,
Required: False ,
}
string ,
enabled:
{
Description: Tenant access information of the API Management service. ,
Required: False ,
}
boolean ,
}
,
}
TenantAccess_Update (new)
Description :  Update tenant access information details.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to retrieve the Tenant Access Information. ,
Required: True ,
}
{
enabled:
{
Description: Tenant access information of the API Management service. ,
Required: False ,
}
boolean ,
}
,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccess_RegeneratePrimaryKey (new)
Description :  Regenerate primary access key.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/regeneratePrimaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccess_RegenerateSecondaryKey (new)
Description :  Regenerate secondary access key.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/regenerateSecondaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccessGit_Get (new)
Description :  Gets the Git access configuration for the tenant.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tenant access information contract of the API Management service. ,
}
{
id:
{
Description: Identifier. ,
Required: False ,
}
string ,
primaryKey:
{
Description: Primary access key. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary access key. ,
Required: False ,
}
string ,
enabled:
{
Description: Tenant access information of the API Management service. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccessGit_RegeneratePrimaryKey (new)
Description :  Regenerate primary access key for GIT.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/regeneratePrimaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccessGit_RegenerateSecondaryKey (new)
Description :  Regenerate secondary access key for GIT.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/regenerateSecondaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_Deploy (new)
Description :  This operation applies changes from the specified Git branch to the configuration database. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/deploy
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Deploy Configuration parameters. ,
Required: True ,
}
{
branch:
{
Description: The name of the Git branch from which the configuration is to be deployed to the configuration database. ,
Required: True ,
}
string ,
force:
{
Description: The value enforcing deleting subscriptions to products that are deleted in this update. ,
Required: False ,
}
boolean ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
id:
{
Description: Operation result identifier. ,
Required: False ,
}
string ,
status:
{
Description: Status of an async operation. ,
Enum:
{
Started: No description available. ,
InProgress: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
started:
{
Description: Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updated:
{
Description: Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
resultInfo:
{
Description: Optional result info. ,
Required: False ,
}
string ,
error:
{
Description: Error Body Contract ,
Required: False ,
}
{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
,
actionLog:
{
Description: This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation. ,
Required: False ,
}
[
{
objectType:
{
Description: The type of entity contract. ,
Required: False ,
}
string ,
action:
{
Description: Action like create/update/delete. ,
Required: False ,
}
string ,
objectKey:
{
Description: Identifier of the entity being created/updated/deleted. ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_Save (new)
Description :  This operation creates a commit with the current configuration snapshot to the specified branch in the repository. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/save
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Save Configuration parameters. ,
Required: True ,
}
{
branch:
{
Description: The name of the Git branch in which to commit the current configuration snapshot. ,
Required: True ,
}
string ,
force:
{
Description: The value if true, the current configuration database is committed to the Git repository, even if the Git repository has newer changes that would be overwritten. ,
Required: False ,
}
boolean ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
id:
{
Description: Operation result identifier. ,
Required: False ,
}
string ,
status:
{
Description: Status of an async operation. ,
Enum:
{
Started: No description available. ,
InProgress: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
started:
{
Description: Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updated:
{
Description: Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
resultInfo:
{
Description: Optional result info. ,
Required: False ,
}
string ,
error:
{
Description: Error Body Contract ,
Required: False ,
}
{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
,
actionLog:
{
Description: This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation. ,
Required: False ,
}
[
{
objectType:
{
Description: The type of entity contract. ,
Required: False ,
}
string ,
action:
{
Description: Action like create/update/delete. ,
Required: False ,
}
string ,
objectKey:
{
Description: Identifier of the entity being created/updated/deleted. ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_Validate (new)
Description :  This operation validates the changes in the specified Git branch. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/validate
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Validate Configuration parameters. ,
Required: True ,
}
{
branch:
{
Description: The name of the Git branch from which the configuration is to be deployed to the configuration database. ,
Required: True ,
}
string ,
force:
{
Description: The value enforcing deleting subscriptions to products that are deleted in this update. ,
Required: False ,
}
boolean ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
id:
{
Description: Operation result identifier. ,
Required: False ,
}
string ,
status:
{
Description: Status of an async operation. ,
Enum:
{
Started: No description available. ,
InProgress: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
started:
{
Description: Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updated:
{
Description: Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
resultInfo:
{
Description: Optional result info. ,
Required: False ,
}
string ,
error:
{
Description: Error Body Contract ,
Required: False ,
}
{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
,
actionLog:
{
Description: This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation. ,
Required: False ,
}
[
{
objectType:
{
Description: The type of entity contract. ,
Required: False ,
}
string ,
action:
{
Description: Action like create/update/delete. ,
Required: False ,
}
string ,
objectKey:
{
Description: Identifier of the entity being created/updated/deleted. ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_GetSyncState (new)
Description :  Gets the status of the most recent synchronization between the configuration database and the Git repository.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/syncState
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
branch:
{
Description: The name of Git branch. ,
Required: False ,
}
string ,
commitId:
{
Description: The latest commit Id. ,
Required: False ,
}
string ,
isExport:
{
Description: value indicating if last sync was save (true) or deploy (false) operation. ,
Required: False ,
}
boolean ,
isSynced:
{
Description: value indicating if last synchronization was later than the configuration change. ,
Required: False ,
}
boolean ,
isGitEnabled:
{
Description: value indicating whether Git configuration access is enabled. ,
Required: False ,
}
boolean ,
syncDate:
{
Description: The date of the latest synchronization. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
configurationChangeDate:
{
Description: The date of the latest configuration change. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
}
User_ListByService (new)
Description :  Lists a collection of registered users in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |------------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | firstName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | lastName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | email | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | N/A | | registrationDate | ge, le, eq, ne, gt, lt | N/A | | note | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the user specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_Get (new)
Description :  Gets the details of the user specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: User details. ,
}
{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_CreateOrUpdate (new)
Description :  Creates or Updates a user.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: User entity create contract properties. ,
Required: False ,
}
{
email:
{
Description: Email address. Must not be empty and must be unique within the service instance. ,
Required: True ,
}
string ,
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
password:
{
Description: User Password. If no value is provided, a default password is generated. ,
Required: False ,
}
string ,
confirmation:
{
Description: Determines the type of confirmation e-mail that will be sent to the newly created user. ,
Enum:
{
signup: Send an e-mail to the user confirming they have successfully signed up. ,
invite: Send an e-mail inviting the user to sign-up and complete registration. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_Update (new)
Description :  Updates the details of the user specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: User entity update contract properties. ,
Required: False ,
}
{
email:
{
Description: Email address. Must not be empty and must be unique within the service instance. ,
Required: False ,
}
string ,
password:
{
Description: User Password. ,
Required: False ,
}
string ,
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the user to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_Delete (new)
Description :  Deletes specific user.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
deleteSubscriptions:
{
Description: Whether to delete user's subscription or not. ,
Required: False ,
}
boolean ,
If-Match:
{
Description: The entity state (Etag) version of the user to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_GenerateSsoUrl (new)
Description :  Retrieves a redirection URL containing an authentication token for signing a given user into the developer portal.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/generateSsoUrl
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Redirect Url containing the SSO URL value. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
UserGroup_List (new)
Description :  Lists all user groups.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/groups
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
UserSubscription_List (new)
Description :  Lists the collection of subscriptions of the specified user.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/subscriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |--------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | stateComment | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | productId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
UserIdentities_List (new)
Description :  Lists all user identities.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/identities
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: User Identity values. ,
Required: False ,
}
[
{
provider:
{
Description: Identity provider name. ,
Required: False ,
}
string ,
id:
{
Description: Identifier value within provider. ,
Required: False ,
}
string ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_GetSharedAccessToken (new)
Description :  Gets the Shared Access Authorization Token for the User.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/token
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create Authorization Token parameters. ,
Required: True ,
}
{
keyType:
{
Description: The Key to be used to generate token for user. ,
Enum:
{
primary: No description available. ,
secondary: No description available. ,
}
,
Required: True ,
}
enum ,
expiry:
{
Description: The Expiry time of the Token. Maximum token expiry time is set to 30 days. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Shared Access Authorization token for the User. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_ListByService (new)
Description :  Lists a collection of API Version Sets in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets
{
$filter:
{
Description: | Field | Supported operators | Supported functions | |------------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | firstName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | lastName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | email | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | N/A | | registrationDate | ge, le, eq, ne, gt, lt | N/A | | note | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_GetEntityTag (new)
Description :  Gets the entity state (Etag) version of the Api Version Set specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_Get (new)
Description :  Gets the details of the Api Version Set specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Api Version Set Contract details. ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_CreateOrUpdate (new)
Description :  Creates or Updates a Api Version Set.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the user to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_Update (new)
Description :  Updates the details of the Api VersionSet specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Parameters to update or create an Api Version Set Contract. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: False ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the user to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_Delete (new)
Description :  Deletes specific Api Version Set.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{
If-Match:
{
Description: The entity state (Etag) version of the Api Version Set to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Policy_ListByService (removed)
Description :  Lists all the Global Policy definitions of the Api Management service.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
scope:
{
Description: Policy scope. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Policy_Get (removed)
Description :  Get the Global policy definition of the Api Management service.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Policy_CreateOrUpdate (removed)
Description :  Creates or updates the global policy configuration of the Api Management service.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Policy_Delete (removed)
Description :  Deletes the global policy configuration of the Api Management Service.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the policy to be deleted. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
PolicySnippets_ListByService (removed)
Description :  Lists all policy snippets.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/policySnippets
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
scope:
{
Description: Policy scope. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Policy snippet value. ,
Required: False ,
}
[
{
name:
{
Description: Snippet name. ,
Required: False ,
}
string ,
content:
{
Description: Snippet content. ,
Required: False ,
}
string ,
toolTip:
{
Description: Snippet toolTip. ,
Required: False ,
}
string ,
scope:
{
Description: Binary OR value of the Snippet scope. ,
Required: False ,
}
integer ,
}
,
]
,
}
Regions_ListByService (removed)
Description :  Lists all azure regions in which the service exists.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/regions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Lists of Regions. ,
Required: False ,
}
[
{
name:
{
Description: Region name. ,
Required: False ,
}
string ,
isMasterRegion:
{
Description: whether Region is the master region. ,
Required: False ,
}
boolean ,
isDeleted:
{
Description: whether Region is deleted. ,
Required: False ,
}
boolean ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Api_ListByService (removed)
Description :  Lists all APIs of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
expandApiVersionSet:
{
Description: Include full ApiVersionSet resource in response ,
Required: False ,
}
boolean ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_Get (removed)
Description :  Gets the details of the API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: API details. ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_CreateOrUpdate (removed)
Description :  Creates new or updates existing specified API of the API Management service instance.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Api entity create of update properties. ,
Required: False ,
}
{
contentValue:
{
Description: Content value when Importing an API. ,
Required: False ,
}
string ,
contentFormat:
{
Description: Format of the Content in which the API is getting imported. ,
Enum:
{
wadl-xml: The contents are inline and Content type is a WADL document. ,
wadl-link-json: The WADL document is hosted on a publicly accessible internet address. ,
swagger-json: The contents are inline and Content Type is a OpenApi 2.0 Document. ,
swagger-link-json: The Open Api 2.0 document is hosted on a publicly accessible internet address. ,
wsdl: The contents are inline and the document is a WSDL/Soap document. ,
wsdl-link: The WSDL document is hosted on a publicly accessible internet address. ,
}
,
Required: False ,
}
enum ,
wsdlSelector:
{
Description: Criteria to limit import of WSDL to a subset of the document. ,
Required: False ,
}
{
wsdlServiceName:
{
Description: Name of service to import from WSDL ,
Required: False ,
}
string ,
wsdlEndpointName:
{
Description: Name of endpoint(port) to import from WSDL ,
Required: False ,
}
string ,
}
,
}
,
}
,
If-Match:
{
Description: ETag of the Api Entity. For Create Api Etag should not be specified. For Update Etag should match the existing Entity or it can be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: API details. ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: API details. ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_Update (removed)
Description :  Updates the specified API of the API Management service instance.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
parameters:
{
Description: API Update Contract parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API entity that can be updated. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: False ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
If-Match:
{
Description: ETag of the API entity. ETag should match the current entity state in the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_Delete (removed)
Description :  Deletes the specified API of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the API Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRevisions_List (removed)
Description :  Lists all revisions of an API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions
{
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| |apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith| ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Api Revision Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API Revision. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Revision number of API. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API Revision was created. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API Revision were updated. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
description:
{
Description: Description of the API Revision. ,
Required: False ,
}
string ,
privateUrl:
{
Description: Gateway URL for accessing the non-current API Revision. ,
Required: False ,
}
string ,
isOnline:
{
Description: Indicates if API revision is the current api revision. ,
Required: False ,
}
boolean ,
isCurrent:
{
Description: Indicates if API revision is accessible via the gateway. ,
Required: False ,
}
boolean ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_List (removed)
Description :  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.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases
{
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | |notes|ge le eq ne gt lt|substringof contains startswith endswith| ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Get (removed)
Description :  Returns the details of an API release.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{}

⚐ Response (200)

{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Create (removed)
Description :  Creates a new Release for the API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Update (removed)
Description :  Updates the details of the release of the API specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{
parameters:
{
Description: API Release Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Api Release Contract. ,
Required: False ,
}
{
apiId:
{
Description: Identifier of the API the release belongs to. ,
Required: False ,
}
string ,
createdDateTime:
{
Description: The time the API was released. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updatedDateTime:
{
Description: The time the API release was updated. ,
Format: date-time ,
Required: False ,
}
string ,
notes:
{
Description: Release Notes ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiRelease_Delete (removed)
Description :  Deletes the specified release in the API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/releases/{releaseId}
{
If-Match:
{
Description: ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_ListByApi (removed)
Description :  Lists a collection of the operations for the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | name | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the API operation specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_Get (removed)
Description :  Gets the details of the API Operation specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Api Operation details. ,
}
{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_CreateOrUpdate (removed)
Description :  Creates a new operation in the API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Operation Contract. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: True ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: True ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_Update (removed)
Description :  Updates the details of the operation in the API specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: API Operation Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API Operation entity that can be updated. ,
Required: False ,
}
{
displayName:
{
Description: Operation Name. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the API Operation Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperation_Delete (removed)
Description :  Deletes the specified operation in the API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the API Operation Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_ListByOperation (removed)
Description :  Get the list of policy configuration at the API Operation level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the API operation policy specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_Get (removed)
Description :  Get the policy configuration at the API Operation level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_CreateOrUpdate (removed)
Description :  Creates or updates policy configuration for the API Operation level.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Api Operation policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiOperationPolicy_Delete (removed)
Description :  Deletes the policy configuration at the Api Operation.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api Operation Policy to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiProduct_ListByApis (removed)
Description :  Lists all Products, which the API is part of.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/products
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_ListByApi (removed)
Description :  Get the policy configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: The response of the list policy operation. ,
}
{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the API policy specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_Get (removed)
Description :  Get the policy configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_CreateOrUpdate (removed)
Description :  Creates or updates policy configuration for the API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Api Policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiPolicy_Delete (removed)
Description :  Deletes the policy configuration at the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_ListByApi (removed)
Description :  Get the schema configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: The response of the list schema operation. ,
}
{
value:
{
Description: Api Schema Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the schema specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_Get (removed)
Description :  Get the schema configuration at the API level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Schema Contract details. ,
}
{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_CreateOrUpdate (removed)
Description :  Creates or updates schema configuration for the API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: The schema contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Api Schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Schema. ,
Required: False ,
}
{
contentType:
{
Description: Must be a valid a media type used in a Content-Type header as defined in the RFC 2616. Media type of the schema document (e.g. application/json, application/xml). ,
Required: True ,
}
string ,
document:
{
Description: Properties of the Schema Document. ,
Required: False ,
}
{
value:
{
Description: Json escaped string defining the document representing the Schema. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiSchema_Delete (removed)
Description :  Deletes the schema configuration at the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/schemas/{schemaId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
schemaId:
{
Description: Schema identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Api_ListByTags (removed)
Description :  Lists a collection of apis associated with tags.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apisByTags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | aid | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | isCurrent | eq | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagResource entity contract properties. ,
Required: False ,
}
{
tag:
{
Description: Tag associated with the resource. ,
Required: False ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
operation:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Operation entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Operation name. ,
Required: False ,
}
string ,
apiName:
{
Description: Api Name. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Api Revision. ,
Required: False ,
}
string ,
apiVersion:
{
Description: Api Version. ,
Required: False ,
}
string ,
description:
{
Description: Operation Description. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
product:
{
Description: Product associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
ApiDiagnostic_ListByService (removed)
Description :  Lists all diagnostics of an API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Head (removed)
Description :  Gets the entity state (Etag) version of the Diagnostic for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Get (removed)
Description :  Gets the details of the Diagnostic for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Diagnostic details. ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_CreateOrUpdate (removed)
Description :  Creates a new Diagnostic for an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Update (removed)
Description :  Updates the details of the Diagnostic for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Diagnostic Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnostic_Delete (removed)
Description :  Deletes the specified Diagnostic from an API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_ListByService (removed)
Description :  Lists all loggers associated with the specified Diagnostic of an API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | type | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Logger values. ,
Required: False ,
}
[
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_CheckEntityExists (removed)
Description :  Checks that logger entity specified by identifier is associated with the diagnostics entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_CreateOrUpdate (removed)
Description :  Attaches a logger to a diagnostic for an API.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiDiagnosticLogger_Delete (removed)
Description :  Deletes the specified Logger from Diagnostic for an API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssues_ListByService (removed)
Description :  Lists all issues associated with the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | state | eq | | | userId | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Issue values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_Head (removed)
Description :  Gets the entity state (Etag) version of the Issue for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_Get (removed)
Description :  Gets the details of the Issue for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Issue Contract details. ,
}
{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_CreateOrUpdate (removed)
Description :  Creates a new Issue for an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Issue. ,
Required: False ,
}
{
title:
{
Description: The issue title. ,
Required: True ,
}
string ,
description:
{
Description: Text describing the issue. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the issue was created. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: Status of the issue. ,
Enum:
{
proposed: The issue is proposed. ,
open: The issue is opened. ,
removed: The issue was removed. ,
resolved: The issue is now resolved. ,
closed: The issue was closed. ,
}
,
Required: False ,
}
enum ,
userId:
{
Description: A resource identifier for the user created the issue. ,
Required: True ,
}
string ,
apiId:
{
Description: A resource identifier for the API the issue was created for. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssue_Delete (removed)
Description :  Deletes the specified Issue from an API.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComments_ListByService (removed)
Description :  Lists all comments for the Issue associated with the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Issue Comment values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssuComment_Head (removed)
Description :  Gets the entity state (Etag) version of the issue Comment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComment_Get (removed)
Description :  Gets the details of the issue Comment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Issue Comment Contract details. ,
}
{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComment_CreateOrUpdate (removed)
Description :  Creates a new Comment for the Issue in an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Issue Comment. ,
Required: False ,
}
{
text:
{
Description: Comment text. ,
Required: True ,
}
string ,
createdDate:
{
Description: Date and time when the comment was created. ,
Format: date-time ,
Required: False ,
}
string ,
userId:
{
Description: A resource identifier for the user who left the comment. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueComment_Delete (removed)
Description :  Deletes the specified comment from an Issue.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/comments/{commentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
commentId:
{
Description: Comment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachments_ListByService (removed)
Description :  Lists all comments for the Issue associated with the specified API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Issue Attachment values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssuAttachment_Head (removed)
Description :  Gets the entity state (Etag) version of the issue Attachment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachment_Get (removed)
Description :  Gets the details of the issue Attachment for an API specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Issue Attachment Contract details. ,
}
{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachment_CreateOrUpdate (removed)
Description :  Creates a new Attachment for the Issue in an API or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Issue Attachment. ,
Required: False ,
}
{
title:
{
Description: Filename by which the binary data will be saved. ,
Required: True ,
}
string ,
contentFormat:
{
Description: Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property. ,
Required: True ,
}
string ,
content:
{
Description: An HTTP link or Base64-encoded binary data. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiIssueAttachment_Delete (removed)
Description :  Deletes the specified comment from an Issue.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
issueId:
{
Description: Issue identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
attachmentId:
{
Description: Attachment identifier within an Issue. Must be unique in the current Issue. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Issue Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_ListByService (removed)
Description :  Lists a collection of authorization servers defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
AuthorizationServer_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the authorizationServer specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_Get (removed)
Description :  Gets the details of the authorization server specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: External OAuth authorization server settings. ,
}
{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_CreateOrUpdate (removed)
Description :  Creates new authorization server or updates an existing authorization server.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the External OAuth authorization server Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: True ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: True ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: True ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: True ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_Update (removed)
Description :  Updates the details of the authorization server specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
parameters:
{
Description: OAuth2 Server settings Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of the External OAuth authorization server update Contract. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly authorization server name. ,
Required: False ,
}
string ,
clientRegistrationEndpoint:
{
Description: Optional reference to a page where client or app registration for this authorization server is performed. Contains absolute URL to entity being referenced. ,
Required: False ,
}
string ,
authorizationEndpoint:
{
Description: OAuth authorization endpoint. See http://tools.ietf.org/html/rfc6749#section-3.2. ,
Required: False ,
}
string ,
grantTypes:
{
Description: Form of an authorization grant, which the client uses to request the access token. ,
Required: False ,
}
[
string ,
]
,
clientId:
{
Description: Client or app id registered with this authorization server. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the authorization server to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
AuthorizationServer_Delete (removed)
Description :  Deletes specific authorization server instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/authorizationServers/{authsid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
authsid:
{
Description: Identifier of the authorization server. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the authentication server to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_ListByService (removed)
Description :  Lists a collection of backends in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | host | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Backend values. ,
Required: False ,
}
[
{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the backend specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Get (removed)
Description :  Gets the details of the backend specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Backend details. ,
}
{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_CreateOrUpdate (removed)
Description :  Creates or Updates a backend.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Backend entity contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: True ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Update (removed)
Description :  Updates an existing backend.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Backend entity update contract properties. ,
Required: False ,
}
{
url:
{
Description: Runtime Url of the Backend. ,
Required: False ,
}
string ,
protocol:
{
Description: Backend communication protocol. ,
Enum:
{
http: The Backend is a RESTful service. ,
soap: The Backend is a SOAP service. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the backend to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Delete (removed)
Description :  Deletes the specified backend.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the backend to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Backend_Reconnect (removed)
Description :  Notifies the APIM proxy to create a new connection to the backend after the specified timeout. If no timeout was specified, timeout of 2 minutes is used.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backends/{backendid}/reconnect
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
backendid:
{
Description: Identifier of the Backend entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Reconnect request parameters. ,
Required: False ,
}
{
properties:
{
Description: Reconnect request properties. ,
Required: False ,
}
{
after:
{
Description: Duration in ISO8601 format after which reconnect will be initiated. ,
Format: duration ,
Required: False ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_ListByService (removed)
Description :  Lists a collection of all certificates in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |----------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | subject | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | thumbprint | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | expirationDate | ge, le, eq, ne, gt, lt | N/A | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the certificate specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_Get (removed)
Description :  Gets the details of the certificate specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Certificate details. ,
}
{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_CreateOrUpdate (removed)
Description :  Creates or updates the certificate being used for authentication with the backend.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Certificate create or update properties details. ,
Required: False ,
}
{
data:
{
Description: Base 64 encoded certificate using the application/x-pkcs12 representation. ,
Required: True ,
}
string ,
password:
{
Description: Password for the Certificate ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the certificate to update. A value of "*" can be used for If-Match to unconditionally apply the operation.. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Certificate properties details. ,
Required: False ,
}
{
subject:
{
Description: Subject attribute of the certificate. ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
expirationDate:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Certificate_Delete (removed)
Description :  Deletes specific certificate.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
certificateId:
{
Description: Identifier of the certificate entity. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the certificate to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiManagementOperations_List (removed)
Description :  Lists all of the available REST API operations of the Microsoft.ApiManagement provider.
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.ApiManagement/operations
{
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of operations supported by the resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{operation} ,
Required: False ,
}
string ,
display:
{
Description: The object that describes the operation. ,
Required: False ,
}
{
provider:
{
Description: Friendly name of the resource provider ,
Required: False ,
}
string ,
operation:
{
Description: Operation type: read, write, delete, listKeys/action, etc. ,
Required: False ,
}
string ,
resource:
{
Description: Resource type on which the operation is performed. ,
Required: False ,
}
string ,
description:
{
Description: Friendly name of the operation ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The operation origin. ,
Required: False ,
}
string ,
properties:
{
Description: The operation properties. ,
Required: False ,
}
object ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results if there are any. ,
Required: False ,
}
string ,
}
ApiManagementService_Restore (removed)
Description :  Restores a backup of an API Management service created using the ApiManagementService_Backup operation on the current service. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/restore
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Restore API Management service from backup operation. ,
Required: True ,
}
{
storageAccount:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) name. ,
Required: True ,
}
string ,
accessKey:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) access key. ,
Required: True ,
}
string ,
containerName:
{
Description: Azure Cloud Storage blob container name used to place/retrieve the backup. ,
Required: True ,
}
string ,
backupName:
{
Description: The name of the backup file to create. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{}
ApiManagementService_Backup (removed)
Description :  Creates a backup of the API Management service to the given Azure Storage Account. This is long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/backup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the ApiManagementService_Backup operation. ,
Required: True ,
}
{
storageAccount:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) name. ,
Required: True ,
}
string ,
accessKey:
{
Description: Azure Cloud Storage account (used to place/retrieve the backup) access key. ,
Required: True ,
}
string ,
containerName:
{
Description: Azure Cloud Storage blob container name used to place/retrieve the backup. ,
Required: True ,
}
string ,
backupName:
{
Description: The name of the backup file to create. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{}
ApiManagementService_CreateOrUpdate (removed)
Description :  Creates or updates an API Management service. This is long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate API Management service operation. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
ApiManagementService_Update (removed)
Description :  Updates an existing API Management service.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the CreateOrUpdate API Management service operation. ,
Required: True ,
}
{
properties:
{
Description: Properties of the API Management service. ,
Required: False ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: False ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: False ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: False ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{}
ApiManagementService_Get (removed)
Description :  Gets an API Management service resource description.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
ApiManagementService_Delete (removed)
Description :  Deletes an existing API Management service.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}
ApiManagementService_ListByResourceGroup (removed)
Description :  List all API Management services within a resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the List API Management services operation. ,
Required: True ,
}
[
{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: Link to the next set of results. Not empty if Value contains incomplete list of API Management services. ,
Required: False ,
}
string ,
}
ApiManagementService_List (removed)
Description :  Lists all API Management services within an Azure subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/service
{
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Result of the List API Management services operation. ,
Required: True ,
}
[
{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: Link to the next set of results. Not empty if Value contains incomplete list of API Management services. ,
Required: False ,
}
string ,
}
ApiManagementService_GetSsoToken (removed)
Description :  Gets the Single-Sign-On token for the API Management Service which is valid for 5 Minutes.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/getssotoken
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
redirectUri:
{
Description: Redirect URL to the Publisher Portal containing the SSO token. ,
Required: False ,
}
string ,
}
ApiManagementService_CheckNameAvailability (removed)
Description :  Checks availability and correctness of a name for an API Management service.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.ApiManagement/checkNameAvailability
{
parameters:
{
Description: Parameters supplied to the CheckNameAvailability operation. ,
Required: True ,
}
{
name:
{
Description: The name to check for availability. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: True if the name is available and can be used to create a new API Management service; otherwise false. ,
Required: False ,
}
boolean ,
message:
{
Description: If reason == invalid, provide the user with the reason why the given name is invalid, and provide the resource naming requirements so that the user can select a valid name. If reason == AlreadyExists, explain that is already in use, and direct them to select a different name. ,
Required: False ,
}
string ,
reason:
{
Description: Invalid indicates the name provided does not match the resource provider’s naming requirements (incorrect length, unsupported characters, etc.) AlreadyExists indicates that the name is already in use and is therefore unavailable. ,
Enum:
{
Valid: No description available. ,
Invalid: No description available. ,
AlreadyExists: No description available. ,
}
,
Required: False ,
}
enum ,
}
ApiManagementService_ApplyNetworkConfigurationUpdates (removed)
Description :  Updates the Microsoft.ApiManagement resource running in the Virtual network to pick the updated network settings.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/applynetworkconfigurationupdates
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Apply Network Configuration operation. If the parameters are empty, all the regions in which the Api Management service is deployed will be updated sequentially without incurring downtime in the region. ,
Required: False ,
}
{
location:
{
Description: Location of the Api Management service to update for a multi-region service. For a service deployed in a single region, this parameter is not required. ,
Required: False ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
ApiManagementService_UploadCertificate (removed)
Description :  Upload Custom Domain SSL certificate for an API Management service. This operation will be deprecated in future releases.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/uploadcertificate
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the Upload SSL certificate for an API Management service operation. ,
Required: True ,
}
{
type:
{
Description: Hostname type. ,
Enum:
{
Proxy: No description available. ,
Portal: No description available. ,
Management: No description available. ,
Scm: No description available. ,
}
,
Required: True ,
}
enum ,
certificate:
{
Description: Base64 Encoded certificate. ,
Required: True ,
}
string ,
certificate_password:
{
Description: Certificate password. ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
expiry:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
subject:
{
Description: Subject of the certificate. ,
Required: True ,
}
string ,
}
ApiManagementService_UpdateHostname (removed)
Description :  Creates, updates, or deletes the custom hostnames for an API Management service. The custom hostname can be applied to the Proxy and Portal endpoint. This is a long running operation and could take several minutes to complete. This operation will be deprecated in the next version update.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/updatehostname
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to the UpdateHostname operation. ,
Required: True ,
}
{
update:
{
Description: Hostnames to create or update. ,
Required: False ,
}
[
{
type:
{
Description: Hostname type. ,
Enum:
{
Proxy: No description available. ,
Portal: No description available. ,
Management: No description available. ,
Scm: No description available. ,
}
,
Required: True ,
}
enum ,
hostname:
{
Description: Hostname to configure. ,
Required: True ,
}
string ,
certificate:
{
Description: Certificate information. ,
Required: True ,
}
{
expiry:
{
Description: Expiration date of the certificate. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
thumbprint:
{
Description: Thumbprint of the certificate. ,
Required: True ,
}
string ,
subject:
{
Description: Subject of the certificate. ,
Required: True ,
}
string ,
}
,
}
,
]
,
delete:
{
Description: Hostnames types to delete. ,
Required: False ,
}
[
string ,
]
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
properties:
{
Description: Properties of the API Management service. ,
Required: True ,
}
{
publisherEmail:
{
Description: Publisher email. ,
Required: True ,
}
string ,
publisherName:
{
Description: Publisher name. ,
Required: True ,
}
string ,
}
,
sku:
{
Description: SKU properties of the API Management service. ,
Required: True ,
}
{
name:
{
Description: Name of the Sku. ,
Enum:
{
Developer: Developer SKU of Api Management. ,
Standard: Standard SKU of Api Management. ,
Premium: Premium SKU of Api Management. ,
Basic: Basic SKU of Api Management. ,
}
,
Required: True ,
}
enum ,
capacity:
{
Description: Capacity of the SKU (number of deployed units of the SKU). The default value is 1. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
identity:
{
Description: Managed service identity of the Api Management service. ,
Required: False ,
}
{
type:
{
Description: The identity type. Currently the only supported type is 'SystemAssigned'. ,
Enum:
{
SystemAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
principalId:
{
Description: The principal id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The client tenant id of the identity. ,
Format: uuid ,
Required: False ,
}
string ,
}
,
location:
{
Description: Resource location. ,
Required: True ,
}
string ,
etag:
{
Description: ETag of the resource. ,
Required: False ,
}
string ,
}
Diagnostic_ListByService (removed)
Description :  Lists all diagnostics of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Head (removed)
Description :  Gets the entity state (Etag) version of the Diagnostic specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Get (removed)
Description :  Gets the details of the Diagnostic specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Diagnostic details. ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_CreateOrUpdate (removed)
Description :  Creates a new Diagnostic or updates an existing one.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Update (removed)
Description :  Updates the details of the Diagnostic specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Diagnostic Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Diagnostic entity contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Indicates whether a diagnostic should receive data or not. ,
Required: True ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Diagnostic_Delete (removed)
Description :  Deletes the specified Diagnostic.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Diagnostic Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_ListByService (removed)
Description :  Lists all loggers associated with the specified Diagnostic of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, startswith, endswith | | type | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Logger values. ,
Required: False ,
}
[
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_CheckEntityExists (removed)
Description :  Checks that logger entity specified by identifier is associated with the diagnostics entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_CreateOrUpdate (removed)
Description :  Attaches a logger to a diagnostic.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DiagnosticLogger_Delete (removed)
Description :  Deletes the specified Logger from Diagnostic.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics/{diagnosticId}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
diagnosticId:
{
Description: Diagnostic identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_ListByService (removed)
Description :  Lists a collection of properties defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
EmailTemplate_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the email template specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_Get (removed)
Description :  Gets the details of the email template specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Email Template details. ,
}
{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_CreateOrUpdate (removed)
Description :  Updates an Email Template.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Email Template update parameters. ,
Required: True ,
}
{
properties:
{
Description: Email Template Update contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: False ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: False ,
}
string ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Email Template entity contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: True ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: True ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
isDefault:
{
Description: Whether the template is the default template provided by Api Management or has been edited. ,
Required: False ,
}
boolean ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_Update (removed)
Description :  Updates the specific Email Template.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Email Template Update contract properties. ,
Required: False ,
}
{
subject:
{
Description: Subject of the Template. ,
Required: False ,
}
string ,
title:
{
Description: Title of the Template. ,
Required: False ,
}
string ,
description:
{
Description: Description of the Email Template. ,
Required: False ,
}
string ,
body:
{
Description: Email Template Body. This should be a valid XDocument ,
Required: False ,
}
string ,
parameters:
{
Description: Email Template Parameter values. ,
Required: False ,
}
[
{
name:
{
Description: Template parameter name. ,
Required: False ,
}
string ,
title:
{
Description: Template parameter title. ,
Required: False ,
}
string ,
description:
{
Description: Template parameter description. ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
EmailTemplate_Delete (removed)
Description :  Reset the Email Template to default template provided by the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/templates/{templateName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
templateName:
{
Description: Email Template Name Identifier. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Email Template to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_ListByService (removed)
Description :  Lists a collection of groups defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | type | eq, ne | N/A | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Group_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the group specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_Get (removed)
Description :  Gets the details of the group specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Contract details. ,
}
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_CreateOrUpdate (removed)
Description :  Creates or Updates a group.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create Group operation. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. ,
Required: False ,
}
string ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: Identifier of the external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_Update (removed)
Description :  Updates the details of the group specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Group entity update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: False ,
}
string ,
description:
{
Description: Group description. ,
Required: False ,
}
string ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: Identifier of the external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Group Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Group_Delete (removed)
Description :  Deletes specific group of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Group Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_List (removed)
Description :  Lists a collection of the members of the group, specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |------------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | firstName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | lastName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | email | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | N/A | | registrationDate | ge, le, eq, ne, gt, lt | N/A | | note | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_CheckEntityExists (removed)
Description :  Checks that user entity specified by identifier is associated with the group entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_Create (removed)
Description :  Adds a user to the specified group.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
GroupUser_Delete (removed)
Description :  Remove existing user from existing group.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_ListByService (removed)
Description :  Lists a collection of Identity Provider configured in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Identity Provider configuration values. ,
Required: False ,
}
[
{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the identityProvider specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_Get (removed)
Description :  Gets the configuration details of the identity Provider configured in specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Identity Provider details. ,
}
{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_CreateOrUpdate (removed)
Description :  Creates or Updates the IdentityProvider configuration.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Identity Provider contract properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_Update (removed)
Description :  Updates an existing IdentityProvider configuration.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Identity Provider update properties. ,
Required: False ,
}
{
clientId:
{
Description: Client Id of the Application in the external Identity Provider. It is App ID for Facebook login, Client ID for Google login, App ID for Microsoft. ,
Required: False ,
}
string ,
clientSecret:
{
Description: Client secret of the Application in external Identity Provider, used to authenticate login request. For example, it is App Secret for Facebook login, API Key for Google login, Public Key for Microsoft. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the identity provider configuration to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
IdentityProvider_Delete (removed)
Description :  Deletes the specified identity provider configuration.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/identityProviders/{identityProviderName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
identityProviderName:
{
Description: Identity Provider Type identifier. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the backend to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_ListByService (removed)
Description :  Lists a collection of loggers in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | type | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Logger values. ,
Required: False ,
}
[
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the logger specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_Get (removed)
Description :  Gets the details of the logger specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Logger details. ,
}
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_CreateOrUpdate (removed)
Description :  Creates or Updates a logger.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Logger entity contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: True ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: The name and SendRule connection string of the event hub for azureEventHub logger. Instrumentation key for applicationInsights logger. ,
Required: True ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
sampling:
{
Description: Sampling settings for an ApplicationInsights logger. ,
Required: False ,
}
{
properties:
{
Description: Sampling settings entity contract properties. ,
Required: False ,
}
{
samplingType:
{
Description: Sampling type. ,
Enum:
{
fixed: Fixed-rate sampling. ,
adaptive: Sampling with a dynamically adjustable rate. ,
}
,
Required: False ,
}
enum ,
percentage:
{
Description: Rate of sampling for fixed-rate sampling. ,
Format: double ,
Required: False ,
}
number ,
maxTelemetryItemsPerSecond:
{
Description: Target rate of telemetry items per second. ,
Format: int32 ,
Required: False ,
}
integer ,
evaluationInterval:
{
Description: Rate re-evaluation interval in ISO8601 format. ,
Format: duration ,
Required: False ,
}
string ,
percentageDecreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to lower the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
percentageIncreaseTimeout:
{
Description: Duration in ISO8601 format after which it's allowed to increase the sampling rate. ,
Format: duration ,
Required: False ,
}
string ,
minPercentage:
{
Description: Minimum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
maxPercentage:
{
Description: Maximum allowed rate of sampling. ,
Format: double ,
Required: False ,
}
number ,
movingAverageRatio:
{
Description: Moving average ration assigned to most recent value. ,
Format: double ,
Required: False ,
}
number ,
initialPercentage:
{
Description: Initial sampling rate. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_Update (removed)
Description :  Updates an existing logger.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Logger entity update contract properties. ,
Required: False ,
}
{
loggerType:
{
Description: Logger type. ,
Enum:
{
azureEventHub: Azure Event Hub as log destination. ,
applicationInsights: Azure Application Insights as log destination. ,
}
,
Required: False ,
}
enum ,
description:
{
Description: Logger description. ,
Required: False ,
}
string ,
credentials:
{
Description: Logger credentials. ,
Required: False ,
}
object ,
isBuffered:
{
Description: Whether records are buffered in the logger before publishing. Default is assumed to be true. ,
Required: False ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the logger to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Logger_Delete (removed)
Description :  Deletes the specified logger.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/loggers/{loggerid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
loggerid:
{
Description: Logger identifier. Must be unique in the API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the logger to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NetworkStatus_ListByService (removed)
Description :  Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/networkstatus
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
dnsServers:
{
Description: Gets the list of DNS servers IPV4 addresses. ,
Required: True ,
}
[
string ,
]
,
connectivityStatus:
{
Description: Gets the list of Connectivity Status to the Resources on which the service depends upon. ,
Required: True ,
}
[
{
name:
{
Description: The hostname of the resource which the service depends on. This can be the database, storage or any other azure resource on which the service depends upon. ,
Required: True ,
}
string ,
status:
{
Description: Resource Connectivity Status Type identifier. ,
Enum:
{
initializing: No description available. ,
success: No description available. ,
failure: No description available. ,
}
,
Required: True ,
}
enum ,
error:
{
Description: Error details of the connectivity to the resource. ,
Required: False ,
}
string ,
lastUpdated:
{
Description: The date when the resource connectivity status was last updated. This status should be updated every 15 minutes. If this status has not been updated, then it means that the service has lost network connectivity to the resource, from inside the Virtual Network.The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
lastStatusChange:
{
Description: The date when the resource connectivity status last Changed from success to failure or vice-versa. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NetworkStatus_ListByLocation (removed)
Description :  Gets the Connectivity Status to the external resources on which the Api Management service depends from inside the Cloud Service. This also returns the DNS Servers as visible to the CloudService.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/locations/{locationName}/networkstatus
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
locationName:
{
Description: Location in which the API Management service is deployed. This is one of the Azure Regions like West US, East US, South Central US. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
dnsServers:
{
Description: Gets the list of DNS servers IPV4 addresses. ,
Required: True ,
}
[
string ,
]
,
connectivityStatus:
{
Description: Gets the list of Connectivity Status to the Resources on which the service depends upon. ,
Required: True ,
}
[
{
name:
{
Description: The hostname of the resource which the service depends on. This can be the database, storage or any other azure resource on which the service depends upon. ,
Required: True ,
}
string ,
status:
{
Description: Resource Connectivity Status Type identifier. ,
Enum:
{
initializing: No description available. ,
success: No description available. ,
failure: No description available. ,
}
,
Required: True ,
}
enum ,
error:
{
Description: Error details of the connectivity to the resource. ,
Required: False ,
}
string ,
lastUpdated:
{
Description: The date when the resource connectivity status was last updated. This status should be updated every 15 minutes. If this status has not been updated, then it means that the service has lost network connectivity to the resource, from inside the Virtual Network.The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
lastStatusChange:
{
Description: The date when the resource connectivity status last Changed from success to failure or vice-versa. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Notification_ListByService (removed)
Description :  Lists a collection of properties defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Notification entity contract properties. ,
Required: False ,
}
{
title:
{
Description: Title of the Notification. ,
Required: True ,
}
string ,
description:
{
Description: Description of the Notification. ,
Required: False ,
}
string ,
recipients:
{
Description: Recipient Parameter values. ,
Required: False ,
}
{
emails:
{
Description: List of Emails subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
users:
{
Description: List of Users subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Notification_Get (removed)
Description :  Gets the details of the Notification specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Notification entity contract properties. ,
Required: False ,
}
{
title:
{
Description: Title of the Notification. ,
Required: True ,
}
string ,
description:
{
Description: Description of the Notification. ,
Required: False ,
}
string ,
recipients:
{
Description: Recipient Parameter values. ,
Required: False ,
}
{
emails:
{
Description: List of Emails subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
users:
{
Description: List of Users subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Notification_CreateOrUpdate (removed)
Description :  Updates an Notification.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Notification entity contract properties. ,
Required: False ,
}
{
title:
{
Description: Title of the Notification. ,
Required: True ,
}
string ,
description:
{
Description: Description of the Notification. ,
Required: False ,
}
string ,
recipients:
{
Description: Recipient Parameter values. ,
Required: False ,
}
{
emails:
{
Description: List of Emails subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
users:
{
Description: List of Users subscribed for the notification. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_ListByNotification (removed)
Description :  Gets the list of the Notification Recipient User subscribed to the notification.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Recipient User entity contract properties. ,
Required: False ,
}
{
userId:
{
Description: API Management UserId subscribed to notification. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_Get (removed)
Description :  Determine if the Notification Recipient User is subscribed to the notification.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_CreateOrUpdate (removed)
Description :  Adds the API Management User to the list of Recipients for the Notification.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Recipient User entity contract properties. ,
Required: False ,
}
{
userId:
{
Description: API Management UserId subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Recipient User entity contract properties. ,
Required: False ,
}
{
userId:
{
Description: API Management UserId subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientUser_Delete (removed)
Description :  Removes the API Management user from the list of Notification.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_ListByNotification (removed)
Description :  Gets the list of the Notification Recipient Emails subscribed to a notification.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Recipient Email contract properties. ,
Required: False ,
}
{
email:
{
Description: User Email subscribed to notification. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_Get (removed)
Description :  Determine if Notification Recipient Email subscribed to the notification.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
email:
{
Description: Email identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_CreateOrUpdate (removed)
Description :  Adds the Email address to the list of Recipients for the Notification.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
email:
{
Description: Email identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Recipient Email contract properties. ,
Required: False ,
}
{
email:
{
Description: User Email subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Recipient Email contract properties. ,
Required: False ,
}
{
email:
{
Description: User Email subscribed to notification. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
NotificationRecipientEmail_Delete (removed)
Description :  Removes the email from the list of Notification.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
notificationName:
{
Description: Notification Name Identifier. ,
Required: True ,
}
string ,
email:
{
Description: Email identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_ListByService (removed)
Description :  Lists all OpenID Connect Providers.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
OpenIdConnectProvider_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the openIdConnectProvider specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_Get (removed)
Description :  Gets specific OpenID Connect Provider.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: OpenId Connect Provider details. ,
}
{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_CreateOrUpdate (removed)
Description :  Creates or updates the OpenID Connect Provider.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: OpenId Connect Provider contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: True ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: True ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: True ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_Update (removed)
Description :  Updates the specific OpenID Connect Provider.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: OpenId Connect Provider Update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: User-friendly OpenID Connect Provider name. ,
Required: False ,
}
string ,
description:
{
Description: User-friendly description of OpenID Connect Provider. ,
Required: False ,
}
string ,
metadataEndpoint:
{
Description: Metadata endpoint URI. ,
Required: False ,
}
string ,
clientId:
{
Description: Client ID of developer console which is the client application. ,
Required: False ,
}
string ,
clientSecret:
{
Description: Client Secret of developer console which is the client application. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the OpenID Connect Provider to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
OpenIdConnectProvider_Delete (removed)
Description :  Deletes specific OpenID Connect Provider of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/openidConnectProviders/{opid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
opid:
{
Description: Identifier of the OpenID Connect Provider. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the OpenID Connect Provider to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignInSettings_Head (removed)
Description :  Gets the entity state (Etag) version of the SignInSettings.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignInSettings_Get (removed)
Description :  Get Sign-In settings.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Sign-In settings for the Developer Portal. ,
}
{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}
,
}
SignInSettings_Update (removed)
Description :  Update Sign-In settings.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Update Sign-In settings. ,
Required: True ,
}
{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignInSettings_CreateOrUpdate (removed)
Description :  Create or Update Sign-In settings.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signin
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
properties:
{
Description: Sign-in settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Redirect Anonymous users to the Sign-In page. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignUpSettings_Head (removed)
Description :  Gets the entity state (Etag) version of the SignUpSettings.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignUpSettings_Get (removed)
Description :  Get Sign-Up settings.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Sign-Up settings for a developer portal. ,
}
{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
}
SignUpSettings_Update (removed)
Description :  Update Sign-Up settings.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Update Sign-Up settings. ,
Required: True ,
}
{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
SignUpSettings_CreateOrUpdate (removed)
Description :  Create or Update Sign-Up settings.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/signup
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
properties:
{
Description: Sign-up settings contract properties. ,
Required: False ,
}
{
enabled:
{
Description: Allow users to sign up on a developer portal. ,
Required: False ,
}
boolean ,
termsOfService:
{
Description: Terms of service contract properties. ,
Required: False ,
}
{
text:
{
Description: A terms of service text. ,
Required: False ,
}
string ,
enabled:
{
Description: Display terms of service during a sign-up process. ,
Required: False ,
}
boolean ,
consentRequired:
{
Description: Ask user for consent. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DelegationSettings_Head (removed)
Description :  Gets the entity state (Etag) version of the DelegationSettings.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DelegationSettings_Get (removed)
Description :  Get Delegation settings.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Delegation settings for a developer portal. ,
}
{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
}
DelegationSettings_Update (removed)
Description :  Update Delegation settings.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Update Delegation settings. ,
Required: True ,
}
{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
DelegationSettings_CreateOrUpdate (removed)
Description :  Create or Update Delegation settings.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/portalsettings/delegation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{
properties:
{
Description: Delegation settings contract properties. ,
Required: False ,
}
{
url:
{
Description: A delegation Url. ,
Required: False ,
}
string ,
validationKey:
{
Description: A base64-encoded validation key to validate, that a request is coming from Azure API Management. ,
Required: False ,
}
string ,
subscriptions:
{
Description: Subscriptions delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for subscriptions. ,
Required: False ,
}
boolean ,
}
,
userRegistration:
{
Description: User registration delegation settings. ,
Required: False ,
}
{
enabled:
{
Description: Enable or disable delegation for user registration. ,
Required: False ,
}
boolean ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_ListByService (removed)
Description :  Lists a collection of products in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | terms | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
expandGroups:
{
Description: When set to true, the response contains an array of groups that have visibility to the product. The default is false. ,
Required: False ,
}
boolean ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the product specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_Get (removed)
Description :  Gets the details of the product specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Product details. ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_CreateOrUpdate (removed)
Description :  Creates or Updates a product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_Update (removed)
Description :  Update product.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Product entity Update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Product Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Product_Delete (removed)
Description :  Delete product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
deleteSubscriptions:
{
Description: Delete existing subscriptions to the product or not. ,
Required: False ,
}
boolean ,
If-Match:
{
Description: ETag of the Product Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_ListByProduct (removed)
Description :  Lists a collection of the APIs associated with a product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_CheckEntityExists (removed)
Description :  Checks that API entity specified by identifier is associated with the Product entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_CreateOrUpdate (removed)
Description :  Adds an API to the specified product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductApi_Delete (removed)
Description :  Deletes the specified API from the specified product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/apis/{apiId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_ListByProduct (removed)
Description :  Lists the collection of developer groups associated with the specified product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | type | eq, ne | N/A | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_CheckEntityExists (removed)
Description :  Checks that Group entity specified by identifier is associated with the Product entity.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_CreateOrUpdate (removed)
Description :  Adds the association between the specified developer group with the specified product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductGroup_Delete (removed)
Description :  Deletes the association between the specified group and product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/groups/{groupId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
groupId:
{
Description: Group identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductSubscriptions_List (removed)
Description :  Lists the collection of subscriptions to the specified product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/subscriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |--------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | stateComment | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | productId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_ListByProduct (removed)
Description :  Get the policy configuration at the Product level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: The response of the list policy operation. ,
}
{
value:
{
Description: Policy Contract value. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_Get (removed)
Description :  Get the policy configuration at the Product level.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Policy Contract details. ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_CreateOrUpdate (removed)
Description :  Creates or updates policy configuration for the Product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
parameters:
{
Description: The policy contents to apply. ,
Required: True ,
}
{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the Policy. ,
Required: False ,
}
{
policyContent:
{
Description: Json escaped Xml Encoded contents of the Policy. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ProductPolicy_Delete (removed)
Description :  Deletes the policy configuration at the Product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/policies/{policyId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
policyId:
{
Description: The identifier of the Policy. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the product policy to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_ListByService (removed)
Description :  Lists a collection of properties defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------|------------------------|-------------------------------------------------------| | tags | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith, any, all | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Property_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the property specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_Get (removed)
Description :  Gets the details of the property specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Property details. ,
}
{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_CreateOrUpdate (removed)
Description :  Creates or updates a property.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Property entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: True ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_Update (removed)
Description :  Updates the specific property.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Property entity Update contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Unique name of Property. It may contain only letters, digits, period, dash, and underscore characters. ,
Required: False ,
}
string ,
value:
{
Description: Value of the property. Can contain policy expressions. It may not be empty or consist only of whitespace. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Property_Delete (removed)
Description :  Deletes specific property from the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/properties/{propId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
propId:
{
Description: Identifier of the property. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the property to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByCounterKeys_ListByService (removed)
Description :  Lists a collection of current quota counter periods associated with the counter-key configured in the policy on the specified service instance. The api does not support paging yet.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Quota counter values. ,
Required: False ,
}
[
{
counterKey:
{
Description: The Key value of the Counter. Must not be empty. ,
Required: True ,
}
string ,
periodKey:
{
Description: Identifier of the Period for which the counter was collected. Must not be empty. ,
Required: True ,
}
string ,
periodStartTime:
{
Description: The date of the start of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
periodEndTime:
{
Description: The date of the end of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
Value:
{
Description: Quota Value Properties ,
Required: False ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByCounterKeys_Update (removed)
Description :  Updates all the quota counter values specified with the existing quota counter key to a value in the specified service instance. This should be used for reset of the quota counter values.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
parameters:
{
Description: The value of the quota counter to be applied to all quota counter periods. ,
Required: True ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByPeriodKeys_Get (removed)
Description :  Gets the value of the quota counter associated with the counter-key in the policy for the specific period in service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}/{quotaPeriodKey}
{
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
quotaPeriodKey:
{
Description: Quota period key identifier. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
counterKey:
{
Description: The Key value of the Counter. Must not be empty. ,
Required: True ,
}
string ,
periodKey:
{
Description: Identifier of the Period for which the counter was collected. Must not be empty. ,
Required: True ,
}
string ,
periodStartTime:
{
Description: The date of the start of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
periodEndTime:
{
Description: The date of the end of Counter Period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
Value:
{
Description: Quota Value Properties ,
Required: False ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
QuotaByPeriodKeys_Update (removed)
Description :  Updates an existing quota counter value in the specified service instance.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/quotas/{quotaCounterKey}/{quotaPeriodKey}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
quotaCounterKey:
{
Description: Quota counter key identifier.This is the result of expression defined in counter-key attribute of the quota-by-key policy.For Example, if you specify counter-key="boo" in the policy, then it’s accessible by "boo" counter key. But if it’s defined as counter-key="@("b"+"a")" then it will be accessible by "ba" key ,
Required: True ,
}
string ,
quotaPeriodKey:
{
Description: Quota period key identifier. ,
Required: True ,
}
string ,
parameters:
{
Description: The value of the Quota counter to be applied on the specified period. ,
Required: True ,
}
{
callsCount:
{
Description: Number of times Counter was called. ,
Format: int32 ,
Required: False ,
}
integer ,
kbTransferred:
{
Description: Data Transferred in KiloBytes. ,
Format: double ,
Required: False ,
}
number ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Reports_ListByApi (removed)
Description :  Lists report records by API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byApi
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByUser (removed)
Description :  Lists report records by User.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byUser
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByOperation (removed)
Description :  Lists report records by API Operations.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byOperation
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByProduct (removed)
Description :  Lists report records by Product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byProduct
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByGeo (removed)
Description :  Lists report records by geography.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byGeo
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListBySubscription (removed)
Description :  Lists report records by subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/bySubscription
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByTime (removed)
Description :  Lists report records by Time.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byTime
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
interval:
{
Description: By time interval. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations).This code can be used to convert TimeSpan to a valid interval string: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds)) ,
Format: duration ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
name:
{
Description: Name depending on report endpoint specifies product, API, operation or developer name. ,
Required: False ,
}
string ,
timestamp:
{
Description: Start of aggregation period. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
interval:
{
Description: Length of aggregation period. Interval must be multiple of 15 minutes and may not be zero. The value should be in ISO 8601 format (http://en.wikipedia.org/wiki/ISO_8601#Durations). ,
Required: False ,
}
string ,
country:
{
Description: Country to which this record data is related. ,
Required: False ,
}
string ,
region:
{
Description: Country region to which this record data is related. ,
Required: False ,
}
string ,
zip:
{
Description: Zip code to which this record data is related. ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
apiRegion:
{
Description: API region identifier. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
callCountSuccess:
{
Description: Number of successful calls. This includes calls returning HttpStatusCode <= 301 and HttpStatusCode.NotModified and HttpStatusCode.TemporaryRedirect ,
Format: int32 ,
Required: False ,
}
integer ,
callCountBlocked:
{
Description: Number of calls blocked due to invalid credentials. This includes calls returning HttpStatusCode.Unauthorized and HttpStatusCode.Forbidden and HttpStatusCode.TooManyRequests ,
Format: int32 ,
Required: False ,
}
integer ,
callCountFailed:
{
Description: Number of calls failed due to proxy or backend errors. This includes calls returning HttpStatusCode.BadRequest(400) and any Code between HttpStatusCode.InternalServerError (500) and 600 ,
Format: int32 ,
Required: False ,
}
integer ,
callCountOther:
{
Description: Number of other calls. ,
Format: int32 ,
Required: False ,
}
integer ,
callCountTotal:
{
Description: Total number of calls. ,
Format: int32 ,
Required: False ,
}
integer ,
bandwidth:
{
Description: Bandwidth consumed. ,
Format: int64 ,
Required: False ,
}
integer ,
cacheHitCount:
{
Description: Number of times when content was served from cache policy. ,
Format: int32 ,
Required: False ,
}
integer ,
cacheMissCount:
{
Description: Number of times content was fetched from backend. ,
Format: int32 ,
Required: False ,
}
integer ,
apiTimeAvg:
{
Description: Average time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMin:
{
Description: Minimum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
apiTimeMax:
{
Description: Maximum time it took to process request. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeAvg:
{
Description: Average time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMin:
{
Description: Minimum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
serviceTimeMax:
{
Description: Maximum time it took to process request on backend. ,
Format: double ,
Required: False ,
}
number ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Reports_ListByRequest (removed)
Description :  Lists report records by Request.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byRequest
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: The filter to apply on the operation. ,
Required: True ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
apiId:
{
Description: API identifier path. /apis/{apiId} ,
Required: False ,
}
string ,
operationId:
{
Description: Operation identifier path. /apis/{apiId}/operations/{operationId} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path. /products/{productId} ,
Required: False ,
}
string ,
userId:
{
Description: User identifier path. /users/{userId} ,
Required: False ,
}
string ,
method:
{
Description: The HTTP method associated with this request.. ,
Required: False ,
}
string ,
url:
{
Description: The full URL associated with this request. ,
Required: False ,
}
string ,
ipAddress:
{
Description: The client IP address associated with this request. ,
Required: False ,
}
string ,
backendResponseCode:
{
Description: The HTTP status code received by the gateway as a result of forwarding this request to the backend. ,
Required: False ,
}
string ,
responseCode:
{
Description: The HTTP status code returned by the gateway. ,
Format: int32 ,
Required: False ,
}
integer ,
responseSize:
{
Description: The size of the response returned by the gateway. ,
Format: int32 ,
Required: False ,
}
integer ,
timestamp:
{
Description: The date and time when this request was received by the gateway in ISO 8601 format. ,
Format: date-time ,
Required: False ,
}
string ,
cache:
{
Description: Specifies if response cache was involved in generating the response. If the value is none, the cache was not used. If the value is hit, cached response was returned. If the value is miss, the cache was used but lookup resulted in a miss and request was fulfilled by the backend. ,
Required: False ,
}
string ,
apiTime:
{
Description: The total time it took to process this request. ,
Format: double ,
Required: False ,
}
number ,
serviceTime:
{
Description: he time it took to forward this request to the backend and get the response back. ,
Format: double ,
Required: False ,
}
number ,
apiRegion:
{
Description: Azure region where the gateway that processed this request is located. ,
Required: False ,
}
string ,
subscriptionId:
{
Description: Subscription identifier path. /subscriptions/{subscriptionId} ,
Required: False ,
}
string ,
requestId:
{
Description: Request Identifier. ,
Required: False ,
}
string ,
requestSize:
{
Description: The size of this request.. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
}
Subscription_List (removed)
Description :  Lists all subscriptions of the API Management service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |--------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | stateComment | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | productId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the apimanagement subscription specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_Get (removed)
Description :  Gets the specified Subscription entity.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Subscription details. ,
}
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_CreateOrUpdate (removed)
Description :  Creates or updates the subscription of specified user to the specified product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: User (user id path) for whom subscription is being created in form /users/{uid} ,
Required: True ,
}
string ,
productId:
{
Description: Product (product id path) for which subscription is being created in form /products/{productId} ,
Required: True ,
}
string ,
displayName:
{
Description: Subscription name. ,
Required: True ,
}
string ,
primaryKey:
{
Description: Primary subscription key. If not specified during request key will be generated automatically. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary subscription key. If not specified during request key will be generated automatically. ,
Required: False ,
}
string ,
state:
{
Description: Initial subscription state. If no value is specified, subscription is created with Submitted state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_Update (removed)
Description :  Updates the details of a subscription specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Subscription Update contract properties. ,
Required: False ,
}
{
userId:
{
Description: User identifier path: /users/{uid} ,
Required: False ,
}
string ,
productId:
{
Description: Product identifier path: /products/{productId} ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
displayName:
{
Description: Subscription name. ,
Required: False ,
}
string ,
primaryKey:
{
Description: Primary subscription key. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary subscription key. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: False ,
}
enum ,
stateComment:
{
Description: Comments describing subscription state change by the administrator. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Subscription Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_Delete (removed)
Description :  Deletes the specified subscription.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Subscription Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_RegeneratePrimaryKey (removed)
Description :  Regenerates primary key of existing subscription of the API Management service instance.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/regeneratePrimaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Subscription_RegenerateSecondaryKey (removed)
Description :  Regenerates secondary key of existing subscription of the API Management service instance.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/subscriptions/{sid}/regenerateSecondaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
sid:
{
Description: Subscription entity Identifier. The entity represents the association between a user and a product in API Management. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagResource_ListByService (removed)
Description :  Lists a collection of resources associated with tags.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tagResources
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | aid | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiRevision | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | path | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | serviceUrl | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | terms | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | isCurrent | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagResource entity contract properties. ,
Required: False ,
}
{
tag:
{
Description: Tag associated with the resource. ,
Required: False ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
operation:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Operation entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Operation name. ,
Required: False ,
}
string ,
apiName:
{
Description: Api Name. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Api Revision. ,
Required: False ,
}
string ,
apiVersion:
{
Description: Api Version. ,
Required: False ,
}
string ,
description:
{
Description: Operation Description. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
product:
{
Description: Product associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Tag_ListByService (removed)
Description :  Lists a collection of tags defined within a service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Tag_GetEntityState (removed)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_Get (removed)
Description :  Gets the details of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_CreateOrUpdate (removed)
Description :  Creates a tag.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create Tag operation. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_Update (removed)
Description :  Updates the details of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create Tag operation. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
If-Match:
{
Description: ETag of the Tag Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_Delete (removed)
Description :  Deletes specific tag of the API Management service instance.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: ETag of the Tag Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_ListByApi (removed)
Description :  Lists all Tags associated with the API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetEntityStateByApi (removed)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetByApi (removed)
Description :  Get tag associated with the API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_AssignToApi (removed)
Description :  Assign tag to the Api.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_DetachFromApi (removed)
Description :  Detach the tag from the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_ListByApi (removed)
Description :  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
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_GetEntityState (removed)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_Get (removed)
Description :  Get tag associated with the API.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Contract details. ,
}
{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_CreateOrUpdate (removed)
Description :  Create/Update tag description in scope of the Api.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties supplied to Create TagDescription operation. ,
Required: False ,
}
{
description:
{
Description: Description of the Tag. ,
Required: False ,
}
string ,
externalDocsUrl:
{
Description: Absolute URL of external resources describing the tag. ,
Required: False ,
}
string ,
externalDocsDescription:
{
Description: Description of the external resources describing the tag. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: TagDescription entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TagDescription_Delete (removed)
Description :  Delete tag description for the Api.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_ListByOperation (removed)
Description :  Lists all Tags associated with the Operation.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetEntityStateByOperation (removed)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetByOperation (removed)
Description :  Get tag associated with the Operation.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_AssignToOperation (removed)
Description :  Assign tag to the Operation.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_DetachFromOperation (removed)
Description :  Detach the tag from the Operation.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operations/{operationId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
operationId:
{
Description: Operation identifier within an API. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Operation_ListByTags (removed)
Description :  Lists a collection of operations associated with tags.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/operationsByTags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
apiId:
{
Description: API identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | apiName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | method | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | urlTemplate | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: TagResource entity contract properties. ,
Required: False ,
}
{
tag:
{
Description: Tag associated with the resource. ,
Required: False ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
api:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Api entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: API name. ,
Required: False ,
}
string ,
serviceUrl:
{
Description: Absolute URL of the backend service implementing this API. ,
Required: False ,
}
string ,
path:
{
Description: Relative URL uniquely identifying this API and all of its resource paths within the API Management service instance. It is appended to the API endpoint base URL specified during the service instance creation to form a public URL for this API. ,
Required: True ,
}
string ,
protocols:
{
Description: Describes on which protocols the operations in this API can be invoked. ,
Required: False ,
}
[
string ,
]
,
apiVersionSet:
{
Description: Api Version Set Contract details. ,
Required: False ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}
,
operation:
{
Description: Api associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Operation entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Operation name. ,
Required: False ,
}
string ,
apiName:
{
Description: Api Name. ,
Required: False ,
}
string ,
apiRevision:
{
Description: Api Revision. ,
Required: False ,
}
string ,
apiVersion:
{
Description: Api Version. ,
Required: False ,
}
string ,
description:
{
Description: Operation Description. ,
Required: False ,
}
string ,
method:
{
Description: A Valid HTTP Operation Method. Typical Http Methods like GET, PUT, POST but not limited by only them. ,
Required: False ,
}
string ,
urlTemplate:
{
Description: Relative URL template identifying the target resource for this operation. May include parameters. Example: /customers/{cid}/orders/{oid}/?date={date} ,
Required: False ,
}
string ,
}
,
}
,
product:
{
Description: Product associated with the tag. ,
Required: False ,
}
{
properties:
{
Description: Product entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Product name. ,
Required: True ,
}
string ,
}
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}
Tag_ListByProduct (removed)
Description :  Lists all Tags associated with the Product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetEntityStateByProduct (removed)
Description :  Gets the entity state version of the tag specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_GetByProduct (removed)
Description :  Get tag associated with the Product.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tag Contract details. ,
}
{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_AssignToProduct (removed)
Description :  Assign tag to the Product.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Tag to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Tag entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Tag name. ,
Required: True ,
}
string ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
Tag_DetachFromProduct (removed)
Description :  Detach the tag from the Product.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/products/{productId}/tags/{tagId}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
productId:
{
Description: Product identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
tagId:
{
Description: Tag identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the Api schema to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccess_Get (removed)
Description :  Get tenant access information details.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tenant access information contract of the API Management service. ,
}
{
id:
{
Description: Identifier. ,
Required: False ,
}
string ,
primaryKey:
{
Description: Primary access key. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary access key. ,
Required: False ,
}
string ,
enabled:
{
Description: Tenant access information of the API Management service. ,
Required: False ,
}
boolean ,
}
,
}
TenantAccess_Update (removed)
Description :  Update tenant access information details.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Parameters supplied to retrieve the Tenant Access Information. ,
Required: True ,
}
{
enabled:
{
Description: Tenant access information of the API Management service. ,
Required: False ,
}
boolean ,
}
,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
If-Match:
{
Description: The entity state (Etag) version of the property to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccess_RegeneratePrimaryKey (removed)
Description :  Regenerate primary access key.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/regeneratePrimaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccess_RegenerateSecondaryKey (removed)
Description :  Regenerate secondary access key.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/regenerateSecondaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccessGit_Get (removed)
Description :  Gets the Git access configuration for the tenant.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Tenant access information contract of the API Management service. ,
}
{
id:
{
Description: Identifier. ,
Required: False ,
}
string ,
primaryKey:
{
Description: Primary access key. ,
Required: False ,
}
string ,
secondaryKey:
{
Description: Secondary access key. ,
Required: False ,
}
string ,
enabled:
{
Description: Tenant access information of the API Management service. ,
Required: False ,
}
boolean ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccessGit_RegeneratePrimaryKey (removed)
Description :  Regenerate primary access key for GIT.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/regeneratePrimaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantAccessGit_RegenerateSecondaryKey (removed)
Description :  Regenerate secondary access key for GIT.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{accessName}/git/regenerateSecondaryKey
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
accessName:
{
Description: The identifier of the Access configuration. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_Deploy (removed)
Description :  This operation applies changes from the specified Git branch to the configuration database. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/deploy
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Deploy Configuration parameters. ,
Required: True ,
}
{
branch:
{
Description: The name of the Git branch from which the configuration is to be deployed to the configuration database. ,
Required: True ,
}
string ,
force:
{
Description: The value enforcing deleting subscriptions to products that are deleted in this update. ,
Required: False ,
}
boolean ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
id:
{
Description: Operation result identifier. ,
Required: False ,
}
string ,
status:
{
Description: Status of an async operation. ,
Enum:
{
Started: No description available. ,
InProgress: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
started:
{
Description: Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updated:
{
Description: Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
resultInfo:
{
Description: Optional result info. ,
Required: False ,
}
string ,
error:
{
Description: Error Body Contract ,
Required: False ,
}
{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
,
actionLog:
{
Description: This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation. ,
Required: False ,
}
[
{
objectType:
{
Description: The type of entity contract. ,
Required: False ,
}
string ,
action:
{
Description: Action like create/update/delete. ,
Required: False ,
}
string ,
objectKey:
{
Description: Identifier of the entity being created/updated/deleted. ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_Save (removed)
Description :  This operation creates a commit with the current configuration snapshot to the specified branch in the repository. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/save
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Save Configuration parameters. ,
Required: True ,
}
{
branch:
{
Description: The name of the Git branch in which to commit the current configuration snapshot. ,
Required: True ,
}
string ,
force:
{
Description: The value if true, the current configuration database is committed to the Git repository, even if the Git repository has newer changes that would be overwritten. ,
Required: False ,
}
boolean ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
id:
{
Description: Operation result identifier. ,
Required: False ,
}
string ,
status:
{
Description: Status of an async operation. ,
Enum:
{
Started: No description available. ,
InProgress: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
started:
{
Description: Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updated:
{
Description: Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
resultInfo:
{
Description: Optional result info. ,
Required: False ,
}
string ,
error:
{
Description: Error Body Contract ,
Required: False ,
}
{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
,
actionLog:
{
Description: This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation. ,
Required: False ,
}
[
{
objectType:
{
Description: The type of entity contract. ,
Required: False ,
}
string ,
action:
{
Description: Action like create/update/delete. ,
Required: False ,
}
string ,
objectKey:
{
Description: Identifier of the entity being created/updated/deleted. ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_Validate (removed)
Description :  This operation validates the changes in the specified Git branch. This is a long running operation and could take several minutes to complete.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/validate
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
parameters:
{
Description: Validate Configuration parameters. ,
Required: True ,
}
{
branch:
{
Description: The name of the Git branch from which the configuration is to be deployed to the configuration database. ,
Required: True ,
}
string ,
force:
{
Description: The value enforcing deleting subscriptions to products that are deleted in this update. ,
Required: False ,
}
boolean ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{}

⚐ Response (200)

{
id:
{
Description: Operation result identifier. ,
Required: False ,
}
string ,
status:
{
Description: Status of an async operation. ,
Enum:
{
Started: No description available. ,
InProgress: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
started:
{
Description: Start time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
updated:
{
Description: Last update time of an async operation. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
resultInfo:
{
Description: Optional result info. ,
Required: False ,
}
string ,
error:
{
Description: Error Body Contract ,
Required: False ,
}
{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
,
actionLog:
{
Description: This property if only provided as part of the TenantConfiguration_Validate operation. It contains the log the entities which will be updated/created/deleted as part of the TenantConfiguration_Deploy operation. ,
Required: False ,
}
[
{
objectType:
{
Description: The type of entity contract. ,
Required: False ,
}
string ,
action:
{
Description: Action like create/update/delete. ,
Required: False ,
}
string ,
objectKey:
{
Description: Identifier of the entity being created/updated/deleted. ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
TenantConfiguration_GetSyncState (removed)
Description :  Gets the status of the most recent synchronization between the configuration database and the Git repository.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/tenant/{configurationName}/syncState
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
configurationName:
{
Description: The identifier of the Git Configuration Operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
branch:
{
Description: The name of Git branch. ,
Required: False ,
}
string ,
commitId:
{
Description: The latest commit Id. ,
Required: False ,
}
string ,
isExport:
{
Description: value indicating if last sync was save (true) or deploy (false) operation. ,
Required: False ,
}
boolean ,
isSynced:
{
Description: value indicating if last synchronization was later than the configuration change. ,
Required: False ,
}
boolean ,
isGitEnabled:
{
Description: value indicating whether Git configuration access is enabled. ,
Required: False ,
}
boolean ,
syncDate:
{
Description: The date of the latest synchronization. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
configurationChangeDate:
{
Description: The date of the latest configuration change. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
}
User_ListByService (removed)
Description :  Lists a collection of registered users in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |------------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | firstName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | lastName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | email | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | N/A | | registrationDate | ge, le, eq, ne, gt, lt | N/A | | note | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the user specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_Get (removed)
Description :  Gets the details of the user specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: User details. ,
}
{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_CreateOrUpdate (removed)
Description :  Creates or Updates a user.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: User entity create contract properties. ,
Required: False ,
}
{
email:
{
Description: Email address. Must not be empty and must be unique within the service instance. ,
Required: True ,
}
string ,
firstName:
{
Description: First name. ,
Required: True ,
}
string ,
lastName:
{
Description: Last name. ,
Required: True ,
}
string ,
password:
{
Description: User Password. If no value is provided, a default password is generated. ,
Required: False ,
}
string ,
confirmation:
{
Description: Determines the type of confirmation e-mail that will be sent to the newly created user. ,
Enum:
{
signup: Send an e-mail to the user confirming they have successfully signed up. ,
invite: Send an e-mail inviting the user to sign-up and complete registration. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: User entity contract properties. ,
Required: False ,
}
{
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
email:
{
Description: Email address. ,
Required: False ,
}
string ,
registrationDate:
{
Description: Date of user registration. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Description: Collection of groups user is part of. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_Update (removed)
Description :  Updates the details of the user specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: User entity update contract properties. ,
Required: False ,
}
{
email:
{
Description: Email address. Must not be empty and must be unique within the service instance. ,
Required: False ,
}
string ,
password:
{
Description: User Password. ,
Required: False ,
}
string ,
firstName:
{
Description: First name. ,
Required: False ,
}
string ,
lastName:
{
Description: Last name. ,
Required: False ,
}
string ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the user to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_Delete (removed)
Description :  Deletes specific user.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
deleteSubscriptions:
{
Description: Whether to delete user's subscription or not. ,
Required: False ,
}
boolean ,
If-Match:
{
Description: The entity state (Etag) version of the user to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_GenerateSsoUrl (removed)
Description :  Retrieves a redirection URL containing an authentication token for signing a given user into the developer portal.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/generateSsoUrl
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Redirect Url containing the SSO URL value. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
UserGroup_List (removed)
Description :  Lists all user groups.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/groups
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |-------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | description | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Group entity contract properties. ,
Required: False ,
}
{
displayName:
{
Description: Group name. ,
Required: True ,
}
string ,
description:
{
Description: Group description. Can contain HTML formatting tags. ,
Required: False ,
}
string ,
builtIn:
{
Description: true if the group is one of the three system groups (Administrators, Developers, or Guests); otherwise false. ,
Required: False ,
}
boolean ,
type:
{
Description: Group type. ,
Enum:
{
custom: No description available. ,
system: No description available. ,
external: No description available. ,
}
,
Required: False ,
}
enum ,
externalId:
{
Description: For external groups, this property contains the id of the group from the external identity provider, e.g. for Azure Active Directory aad://.onmicrosoft.com/groups/; otherwise the value is null. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
UserSubscription_List (removed)
Description :  Lists the collection of subscriptions of the specified user.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/subscriptions
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
$filter:
{
Description: | Field | Supported operators | Supported functions | |--------------|------------------------|---------------------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | name | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | stateComment | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | userId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | productId | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Subscription contract properties. ,
Required: False ,
}
{
userId:
{
Description: The user resource identifier of the subscription owner. The value is a valid relative URL in the format of /users/{uid} where {uid} is a user identifier. ,
Required: True ,
}
string ,
productId:
{
Description: The product resource identifier of the subscribed product. The value is a valid relative URL in the format of /products/{productId} where {productId} is a product identifier. ,
Required: True ,
}
string ,
displayName:
{
Description: The name of the subscription, or null if the subscription has no name. ,
Required: False ,
}
string ,
state:
{
Description: Subscription state. Possible states are * active – the subscription is active, * suspended – the subscription is blocked, and the subscriber cannot call any APIs of the product, * submitted – the subscription request has been made by the developer, but has not yet been approved or rejected, * rejected – the subscription request has been denied by an administrator, * cancelled – the subscription has been cancelled by the developer or administrator, * expired – the subscription reached its expiration date and was deactivated. ,
Enum:
{
suspended: No description available. ,
active: No description available. ,
expired: No description available. ,
submitted: No description available. ,
rejected: No description available. ,
cancelled: No description available. ,
}
,
Required: True ,
}
enum ,
createdDate:
{
Description: Subscription creation date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
startDate:
{
Description: Subscription activation date. The setting is for audit purposes only and the subscription is not automatically activated. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
expirationDate:
{
Description: Subscription expiration date. The setting is for audit purposes only and the subscription is not automatically expired. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
endDate:
{
Description: Date when subscription was cancelled or expired. The setting is for audit purposes only and the subscription is not automatically cancelled. The subscription lifecycle can be managed by using the `state` property. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
notificationDate:
{
Description: Upcoming subscription expiration notification date. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: False ,
}
string ,
primaryKey:
{
Description: Subscription primary key. ,
Required: True ,
}
string ,
secondaryKey:
{
Description: Subscription secondary key. ,
Required: True ,
}
string ,
stateComment:
{
Description: Optional subscription comment added by an administrator. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
UserIdentities_List (removed)
Description :  Lists all user identities.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/identities
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: User Identity values. ,
Required: False ,
}
[
{
provider:
{
Description: Identity provider name. ,
Required: False ,
}
string ,
id:
{
Description: Identifier value within provider. ,
Required: False ,
}
string ,
}
,
]
,
count:
{
Description: Total record count number across all pages. ,
Format: int64 ,
Required: False ,
}
integer ,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
User_GetSharedAccessToken (removed)
Description :  Gets the Shared Access Authorization Token for the User.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{uid}/token
{
resourceGroupName:
{
Description: The name of the resource group. ,
Required: True ,
}
string ,
serviceName:
{
Description: The name of the API Management service. ,
Required: True ,
}
string ,
uid:
{
Description: User identifier. Must be unique in the current API Management service instance. ,
Required: True ,
}
string ,
parameters:
{
Description: Create Authorization Token parameters. ,
Required: True ,
}
{
keyType:
{
Description: The Key to be used to generate token for user. ,
Enum:
{
primary: No description available. ,
secondary: No description available. ,
}
,
Required: True ,
}
enum ,
expiry:
{
Description: The Expiry time of the Token. Maximum token expiry time is set to 30 days. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard. ,
Format: date-time ,
Required: True ,
}
string ,
}
,
api-version:
{
Description: Version of the API to be used with the client request. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Shared Access Authorization token for the User. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_ListByService (removed)
Description :  Lists a collection of API Version Sets in the specified service instance.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets
{
$filter:
{
Description: | Field | Supported operators | Supported functions | |------------------|------------------------|-----------------------------------| | id | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | firstName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | lastName | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | email | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | | state | eq | N/A | | registrationDate | ge, le, eq, ne, gt, lt | N/A | | note | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith | ,
Required: False ,
}
string ,
$top:
{
Description: Number of records to return. ,
Format: int32 ,
Required: False ,
}
integer ,
$skip:
{
Description: Number of records to skip. ,
Format: int32 ,
Required: False ,
}
integer ,
}

⚐ Response (200)

{
value:
{
Description: Page values. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: Next page link if any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_GetEntityTag (removed)
Description :  Gets the entity state (Etag) version of the Api Version Set specified by its identifier.
Reference :  Link ¶

⚼ Request

HEAD:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{}

⚐ Response (200)

{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_Get (removed)
Description :  Gets the details of the Api Version Set specified by its identifier.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{}

⚐ Response (200)

{
$headers:
{
etag:
{
Description: Current entity state version. Should be treated as opaque and used to make conditional HTTP requests. ,
}
string ,
}
,
$schema:
{
Description: Api Version Set Contract details. ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_CreateOrUpdate (removed)
Description :  Creates or Updates a Api Version Set.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{
parameters:
{
Description: Create or update parameters. ,
Required: True ,
}
{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the user to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of an API Version Set. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: True ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: True ,
}
enum ,
}
,
}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_Update (removed)
Description :  Updates the details of the Api VersionSet specified by its identifier.
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{
parameters:
{
Description: Update parameters. ,
Required: True ,
}
{
properties:
{
Description: Parameters to update or create an Api Version Set Contract. ,
Required: False ,
}
{
displayName:
{
Description: Name of API Version Set ,
Required: False ,
}
string ,
versioningScheme:
{
Description: An value that determines where the API Version identifier will be located in a HTTP request. ,
Enum:
{
Segment: The API Version is passed in a path segment. ,
Query: The API Version is passed in a query parameter. ,
Header: The API Version is passed in a HTTP header. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
If-Match:
{
Description: The entity state (Etag) version of the user to update. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}
ApiVersionSet_Delete (removed)
Description :  Deletes specific Api Version Set.
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/api-version-sets/{versionSetId}
{
If-Match:
{
Description: The entity state (Etag) version of the Api Version Set to delete. A value of "*" can be used for If-Match to unconditionally apply the operation. ,
Required: True ,
}
string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
code:
{
Description: Service-defined error code. This code serves as a sub-status for the HTTP error code specified in the response. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of the error. ,
Required: False ,
}
string ,
details:
{
Description: The list of invalid fields send in request, in case of validation error. ,
Required: False ,
}
[
{
code:
{
Description: Property level error code. ,
Required: False ,
}
string ,
message:
{
Description: Human-readable representation of property-level error. ,
Required: False ,
}
string ,
target:
{
Description: Property name. ,
Required: False ,
}
string ,
}
,
]
,
}