Share via

Microsoft.Web certificates 2015-08-01

  • Article

Bicep resource definition

The certificates resource type can be deployed with operations that target:

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

Resource format

To create a Microsoft.Web/certificates resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Web/certificates@2015-08-01' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    cerBlob: 'string'
    expirationDate: 'string'
    friendlyName: 'string'
    hostingEnvironmentProfile: {
      id: 'string'
      name: 'string'
      type: 'string'
    }
    hostNames: [
      'string'
    ]
    issueDate: 'string'
    issuer: 'string'
    password: 'string'
    pfxBlob: 'string'
    publicKeyHash: 'string'
    selfLink: 'string'
    siteName: 'string'
    subjectName: 'string'
    thumbprint: 'string'
    valid: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

CertificateProperties

Name Description Value
cerBlob Raw bytes of .cer file string
expirationDate Certificate expiration date string
friendlyName Friendly name of the certificate string
hostingEnvironmentProfile Specification for the hosting environment (App Service Environment) to use for the certificate HostingEnvironmentProfile
hostNames Host names the certificate applies to string[]
issueDate Certificate issue Date string
issuer Certificate issuer string
password Certificate password string
pfxBlob Pfx blob string
publicKeyHash Public key hash string
selfLink Self link string
siteName App name string
subjectName Subject name of the certificate string
thumbprint Certificate thumbprint string
valid Is the certificate valid? bool

HostingEnvironmentProfile

Name Description Value
id Resource id of the hostingEnvironment (App Service Environment) string
name Name of the hostingEnvironment (App Service Environment) (read only) string
type Resource type of the hostingEnvironment (App Service Environment) (read only) string

Microsoft.Web/certificates

Name Description Value
kind Kind of resource string
location Resource Location string (required)
name The resource name string (required)
properties CertificateProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates

ResourceTags

Name Description Value

ARM template resource definition

The certificates resource type can be deployed with operations that target:

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

Resource format

To create a Microsoft.Web/certificates resource, add the following JSON to your template.

{
  "type": "Microsoft.Web/certificates",
  "apiVersion": "2015-08-01",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "cerBlob": "string",
    "expirationDate": "string",
    "friendlyName": "string",
    "hostingEnvironmentProfile": {
      "id": "string",
      "name": "string",
      "type": "string"
    },
    "hostNames": [ "string" ],
    "issueDate": "string",
    "issuer": "string",
    "password": "string",
    "pfxBlob": "string",
    "publicKeyHash": "string",
    "selfLink": "string",
    "siteName": "string",
    "subjectName": "string",
    "thumbprint": "string",
    "valid": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

CertificateProperties

Name Description Value
cerBlob Raw bytes of .cer file string
expirationDate Certificate expiration date string
friendlyName Friendly name of the certificate string
hostingEnvironmentProfile Specification for the hosting environment (App Service Environment) to use for the certificate HostingEnvironmentProfile
hostNames Host names the certificate applies to string[]
issueDate Certificate issue Date string
issuer Certificate issuer string
password Certificate password string
pfxBlob Pfx blob string
publicKeyHash Public key hash string
selfLink Self link string
siteName App name string
subjectName Subject name of the certificate string
thumbprint Certificate thumbprint string
valid Is the certificate valid? bool

HostingEnvironmentProfile

Name Description Value
id Resource id of the hostingEnvironment (App Service Environment) string
name Name of the hostingEnvironment (App Service Environment) (read only) string
type Resource type of the hostingEnvironment (App Service Environment) (read only) string

Microsoft.Web/certificates

Name Description Value
apiVersion The api version '2015-08-01'
kind Kind of resource string
location Resource Location string (required)
name The resource name string (required)
properties CertificateProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Web/certificates'

ResourceTags

Name Description Value

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create a App Services Managed Certificate

Deploy to Azure		 Create Managed Certificate (Free) APEX (root domain) for WebApp
Create and assign a standard App Service Certificate

Deploy to Azure		 Creates a standard App Service Certificate, verifies it using an App service App and creates SSL bindings once the certificate is ready
Create and assign a wildcard App Service Certificate

Deploy to Azure		 Creates a wildcard App Service Certificate, verifies it using an App service Domain and creates SSL bindings on an App Service App once the certificate is ready
SSL certificate for an ILB ASE or an ILB ASE v2

Deploy to Azure		 Configures the default SSL certificate for an ILB ASE or an ILB ASE v2
Web App integration with Key Vault

Deploy to Azure		 Deploy a Web App certificate from Key Vault secret and use it for creating SSL binding
Web App with a custom domain and optional SSL binding

Deploy to Azure		 Create a web app and with a custom domain and optionally add SSL certificate for https encryption.

Terraform (AzAPI provider) resource definition

The certificates resource type can be deployed with operations that target:

  • Resource groups

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

Resource format

To create a Microsoft.Web/certificates resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/certificates@2015-08-01"
  name = "string"
  kind = "string"
  location = "string"
  body = jsonencode({
    properties = {
      cerBlob = "string"
      expirationDate = "string"
      friendlyName = "string"
      hostingEnvironmentProfile = {
        id = "string"
        name = "string"
        type = "string"
      }
      hostNames = [
        "string"
      ]
      issueDate = "string"
      issuer = "string"
      password = "string"
      pfxBlob = "string"
      publicKeyHash = "string"
      selfLink = "string"
      siteName = "string"
      subjectName = "string"
      thumbprint = "string"
      valid = bool
    }
  })
  tags = {
    {customized property} = "string"
  }
}

Property values

CertificateProperties

Name Description Value
cerBlob Raw bytes of .cer file string
expirationDate Certificate expiration date string
friendlyName Friendly name of the certificate string
hostingEnvironmentProfile Specification for the hosting environment (App Service Environment) to use for the certificate HostingEnvironmentProfile
hostNames Host names the certificate applies to string[]
issueDate Certificate issue Date string
issuer Certificate issuer string
password Certificate password string
pfxBlob Pfx blob string
publicKeyHash Public key hash string
selfLink Self link string
siteName App name string
subjectName Subject name of the certificate string
thumbprint Certificate thumbprint string
valid Is the certificate valid? bool

HostingEnvironmentProfile

Name Description Value
id Resource id of the hostingEnvironment (App Service Environment) string
name Name of the hostingEnvironment (App Service Environment) (read only) string
type Resource type of the hostingEnvironment (App Service Environment) (read only) string

Microsoft.Web/certificates

Name Description Value
kind Kind of resource string
location Resource Location string (required)
name The resource name string (required)
properties CertificateProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Web/certificates@2015-08-01"

ResourceTags

Name Description Value