Microsoft.ApiManagement service/apis

The service/apis resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

For a list of changed properties in each API version, see change log.

Template format

To create a Microsoft.ApiManagement/service/apis resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.ApiManagement/service/apis@2021-12-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    apiRevision: 'string'
    apiRevisionDescription: 'string'
    apiType: 'string'
    apiVersion: 'string'
    apiVersionDescription: 'string'
    apiVersionSet: {
      description: 'string'
      id: 'string'
      name: 'string'
      versionHeaderName: 'string'
      versioningScheme: 'string'
      versionQueryName: 'string'
    apiVersionSetId: 'string'
    authenticationSettings: {
      oAuth2: {
        authorizationServerId: 'string'
        scope: 'string'
      openid: {
        bearerTokenSendingMethods: [
        openidProviderId: 'string'
    contact: {
      email: 'string'
      name: 'string'
      url: 'string'
    description: 'string'
    displayName: 'string'
    format: 'string'
    isCurrent: bool
    license: {
      name: 'string'
      url: 'string'
    path: 'string'
    protocols: [
    serviceUrl: 'string'
    sourceApiId: 'string'
    subscriptionKeyParameterNames: {
      header: 'string'
      query: 'string'
    subscriptionRequired: bool
    termsOfServiceUrl: 'string'
    type: 'string'
    value: 'string'
    wsdlSelector: {
      wsdlEndpointName: 'string'
      wsdlServiceName: 'string'

Property values


Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.
apiVersion The resource api version

For Bicep, set this value in the resource declaration.
name The resource name

See how to set names and types for child resources in Bicep or JSON ARM templates.
string (required)

Character limit: 1-80

Valid characters:
Alphanumerics and hyphens.

Start with letter and end with alphanumeric.
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.
Symbolic name for resource of type: service
properties API entity create of update properties. ApiCreateOrUpdateProperties


Name Description Value
apiRevision Describes the revision of the API. If no value is provided, default revision 1 is created string
apiRevisionDescription Description of the API Revision. string
apiType Type of API to create.
* http creates a REST API
* soap creates a SOAP pass-through API
* websocket creates websocket API
* graphql creates GraphQL API.
apiVersion Indicates the version identifier of the API if the API is versioned string
apiVersionDescription Description of the API Version. string
apiVersionSet Version set details ApiVersionSetContractDetails
apiVersionSetId A resource identifier for the related ApiVersionSet. string
authenticationSettings Collection of authentication settings included into this API. AuthenticationSettingsContract
contact Contact information for the API. ApiContactInformation
description Description of the API. May include HTML formatting tags. string
displayName API name. Must be 1 to 300 characters long. string
format Format of the Content in which the API is getting imported. 'graphql-link'
isCurrent Indicates if API revision is current api revision. bool
license License information for the API. ApiLicenseInformation
path 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. string (required)
protocols Describes on which protocols the operations in this API can be invoked. String array containing any of:
serviceUrl Absolute URL of the backend service implementing this API. Cannot be more than 2000 characters long. string
sourceApiId API identifier of the source API. string
subscriptionKeyParameterNames Protocols over which API is made available. SubscriptionKeyParameterNamesContract
subscriptionRequired Specifies whether an API or Product subscription is required for accessing the API. bool
termsOfServiceUrl A URL to the Terms of Service for the API. MUST be in the format of a URL. string
type Type of API. 'graphql'
value Content value when Importing an API. string
wsdlSelector Criteria to limit import of WSDL to a subset of the document. ApiCreateOrUpdatePropertiesWsdlSelector


Name Description Value
description Description of API Version Set. string
id Identifier for existing API Version Set. Omit this value to create a new Version Set. string
name The display Name of the API Version Set. string
versionHeaderName Name of HTTP header parameter that indicates the API Version if versioningScheme is set to header. string
versioningScheme An value that determines where the API Version identifier will be located in a HTTP request. 'Header'
versionQueryName Name of query parameter that indicates the API Version if versioningScheme is set to query. string


Name Description Value
oAuth2 OAuth2 Authentication settings OAuth2AuthenticationSettingsContract
openid OpenID Connect Authentication Settings OpenIdAuthenticationSettingsContract


Name Description Value
authorizationServerId OAuth authorization server identifier. string
scope operations scope. string


Name Description Value
bearerTokenSendingMethods How to send token to the server. String array containing any of:
openidProviderId OAuth authorization server identifier. string


Name Description Value
email The email address of the contact person/organization. MUST be in the format of an email address string
name The identifying name of the contact person/organization string
url The URL pointing to the contact information. MUST be in the format of a URL string


Name Description Value
name The license name used for the API string
url A URL to the license used for the API. MUST be in the format of a URL string


Name Description Value
header Subscription key header name. string
query Subscription key query string parameter name. string


Name Description Value
wsdlEndpointName Name of endpoint(port) to import from WSDL string
wsdlServiceName Name of service to import from WSDL string

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create an API Management instance and all sub resources using template

Deploy to Azure
This template demonstrates how to create a API Management service and configure sub-entities
Create Azure Front Door in front of Azure API Management

Deploy to Azure
This sample demonstrates how to use Azure Front Door as a global load balancer in front of Azure API Management.