Microsoft.ApiManagement service/apis template reference

Template format

To create a Microsoft.ApiManagement/service/apis resource, add the following JSON to the resources section of your template.

  "name": "string",
  "type": "Microsoft.ApiManagement/service/apis",
  "apiVersion": "2016-10-10",
  "description": "string",
  "authenticationSettings": {
    "oAuth2": {
      "authorizationServerId": "string",
      "scope": "string"
  "subscriptionKeyParameterNames": {
    "header": "string",
    "query": "string"
  "serviceUrl": "string",
  "path": "string",
  "protocols": [
  "resources": []

Property values

The following tables describe the values you need to set in the schema.

Microsoft.ApiManagement/service/apis object

Name Type Required Value
name string Yes API identifier. Must be unique in the current API Management service instance.
type enum Yes apis

See Set name and type for child resources.
apiVersion enum Yes 2016-10-10
description string No Description of the API. May include HTML formatting tags.
authenticationSettings object No Collection of authentication settings included into this API. - AuthenticationSettingsContract object
subscriptionKeyParameterNames object No Protocols over which API is made available. - SubscriptionKeyParameterNamesContract object
serviceUrl string Yes Absolute URL of the backend service implementing this API.
path string Yes 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.
protocols array Yes Describes on which protocols the operations in this API can be invoked. - Http or Https
resources array No operations

AuthenticationSettingsContract object

Name Type Required Value
oAuth2 object No OAuth2AuthenticationSettingsContract object

SubscriptionKeyParameterNamesContract object

Name Type Required Value
header string No Subscription key header name.
query string No Subscription key query string parameter name.

OAuth2AuthenticationSettingsContract object

Name Type Required Value
authorizationServerId string No OAuth authorization server identifier.
scope string No operations scope.

Quickstart templates

The following quickstart templates deploy this resource type.