Share via

Microsoft.Communication emailServices

Bicep resource definition

The emailServices 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.Communication/emailServices resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Communication/emailServices@2025-09-01' = {
  location: 'string'
  name: 'string'
  properties: {
    dataLocation: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property Values

Microsoft.Communication/emailServices

Name Description Value
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 1
Max length = 63
Pattern = ^[a-zA-Z0-9-]+$ (required)
properties The properties of the service. EmailServiceProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates

EmailServiceProperties

Name Description Value
dataLocation The location where the email service stores its data at rest. string (required)

TrackedResourceTags

Name Description Value

Usage Examples

Bicep Samples

A basic example of deploying Email Communication Service.

param resourceName string = 'acctest0001'

resource emailService 'Microsoft.Communication/emailServices@2023-03-31' = {
  name: resourceName
  location: 'global'
  properties: {
    dataLocation: 'United States'
  }
}

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module Description
Email Communication Service AVM Resource Module for Email Communication Service

ARM template resource definition

The emailServices 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.Communication/emailServices resource, add the following JSON to your template.

{
  "type": "Microsoft.Communication/emailServices",
  "apiVersion": "2025-09-01",
  "name": "string",
  "location": "string",
  "properties": {
    "dataLocation": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property Values

Microsoft.Communication/emailServices

Name Description Value
apiVersion The api version '2025-09-01'
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 1
Max length = 63
Pattern = ^[a-zA-Z0-9-]+$ (required)
properties The properties of the service. EmailServiceProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Communication/emailServices'

EmailServiceProperties

Name Description Value
dataLocation The location where the email service stores its data at rest. string (required)

TrackedResourceTags

Name Description Value

Usage Examples

Terraform (AzAPI provider) resource definition

The emailServices 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.Communication/emailServices resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Communication/emailServices@2025-09-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      dataLocation = "string"
    }
  }
}

Property Values

Microsoft.Communication/emailServices

Name Description Value
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 1
Max length = 63
Pattern = ^[a-zA-Z0-9-]+$ (required)
properties The properties of the service. EmailServiceProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Communication/emailServices@2025-09-01"

EmailServiceProperties

Name Description Value
dataLocation The location where the email service stores its data at rest. string (required)

TrackedResourceTags

Name Description Value

Usage Examples

Terraform Samples

A basic example of deploying Email Communication Service.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "emailService" {
  type      = "Microsoft.Communication/emailServices@2023-03-31"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = "global"
  body = {
    properties = {
      dataLocation = "United States"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module Description
Email Communication Service AVM Resource Module for Email Communication Service
  • Last updated on