Nginx.NginxPlus nginxDeployments 2023-04-01

• Latest
• 2024-11-01-preview
• 2024-09-01-preview
• 2024-06-01-preview
• 2024-01-01-preview
• 2023-09-01
• 2023-04-01
• 2022-08-01
• 2021-05-01-preview

Bicep resource definition

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

• Resource groups - See resource group deployment commands

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

Resource format

To create a Nginx.NginxPlus/nginxDeployments resource, add the following Bicep to your template.

resource symbolicname 'Nginx.NginxPlus/nginxDeployments@2023-04-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    enableDiagnosticsSupport: bool
    logging: {
      storageAccount: {
        accountName: 'string'
        containerName: 'string'
      }
    }
    managedResourceGroup: 'string'
    networkProfile: {
      frontEndIPConfiguration: {
        privateIPAddresses: [
          {
            privateIPAddress: 'string'
            privateIPAllocationMethod: 'string'
            subnetId: 'string'
          }
        ]
        publicIPAddresses: [
          {
            id: 'string'
          }
        ]
      }
      networkInterfaceConfiguration: {
        subnetId: 'string'
      }
    }
    scalingProperties: {
      capacity: int
    }
    userProfile: {
      preferredEmail: 'string'
    }
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property Values

Nginx.NginxPlus/nginxDeployments

Name	Description	Value
identity		IdentityProperties
location		string
name	The resource name	string (required)
properties		NginxDeploymentProperties
sku		ResourceSku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates

IdentityProperties

Name	Description	Value
type		'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Dictionary of <UserIdentityProperties>	IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Name	Description	Value

NginxDeploymentProperties

Name	Description	Value
enableDiagnosticsSupport		bool
logging		NginxLogging
managedResourceGroup	The managed resource group to deploy VNet injection related network resources.	string
networkProfile		NginxNetworkProfile
scalingProperties		NginxDeploymentScalingProperties
userProfile		NginxDeploymentUserProfile

NginxDeploymentScalingProperties

Name	Description	Value
capacity		int

NginxDeploymentTags

Name	Description	Value

NginxDeploymentUserProfile

Name	Description	Value
preferredEmail	The preferred support contact email address of the user used for sending alerts and notification. Can be an empty string or a valid email address.	string Constraints: Pattern = ^$|^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$

NginxFrontendIPConfiguration

Name	Description	Value
privateIPAddresses		NginxPrivateIPAddress[]
publicIPAddresses		NginxPublicIPAddress[]

NginxLogging

Name	Description	Value
storageAccount		NginxStorageAccount

NginxNetworkInterfaceConfiguration

Name	Description	Value
subnetId		string

NginxNetworkProfile

Name	Description	Value
frontEndIPConfiguration		NginxFrontendIPConfiguration
networkInterfaceConfiguration		NginxNetworkInterfaceConfiguration

NginxPrivateIPAddress

Name	Description	Value
privateIPAddress		string
privateIPAllocationMethod		'Dynamic' 'Static'
subnetId		string

NginxPublicIPAddress

Name	Description	Value
id		string

NginxStorageAccount

Name	Description	Value
accountName		string
containerName		string

ResourceSku

Name	Description	Value
name	Name of the SKU.	string (required)

UserIdentityProperties

Name	Description	Value

ARM template resource definition

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

• Resource groups - See resource group deployment commands

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

Resource format

To create a Nginx.NginxPlus/nginxDeployments resource, add the following JSON to your template.

{
  "type": "Nginx.NginxPlus/nginxDeployments",
  "apiVersion": "2023-04-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "enableDiagnosticsSupport": "bool",
    "logging": {
      "storageAccount": {
        "accountName": "string",
        "containerName": "string"
      }
    },
    "managedResourceGroup": "string",
    "networkProfile": {
      "frontEndIPConfiguration": {
        "privateIPAddresses": [
          {
            "privateIPAddress": "string",
            "privateIPAllocationMethod": "string",
            "subnetId": "string"
          }
        ],
        "publicIPAddresses": [
          {
            "id": "string"
          }
        ]
      },
      "networkInterfaceConfiguration": {
        "subnetId": "string"
      }
    },
    "scalingProperties": {
      "capacity": "int"
    },
    "userProfile": {
      "preferredEmail": "string"
    }
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property Values

Nginx.NginxPlus/nginxDeployments

Name	Description	Value
apiVersion	The api version	'2023-04-01'
identity		IdentityProperties
location		string
name	The resource name	string (required)
properties		NginxDeploymentProperties
sku		ResourceSku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
type	The resource type	'Nginx.NginxPlus/nginxDeployments'

IdentityProperties

Name	Description	Value
type		'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Dictionary of <UserIdentityProperties>	IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Name	Description	Value

NginxDeploymentProperties

Name	Description	Value
enableDiagnosticsSupport		bool
logging		NginxLogging
managedResourceGroup	The managed resource group to deploy VNet injection related network resources.	string
networkProfile		NginxNetworkProfile
scalingProperties		NginxDeploymentScalingProperties
userProfile		NginxDeploymentUserProfile

NginxDeploymentScalingProperties

Name	Description	Value
capacity		int

NginxDeploymentTags

Name	Description	Value

NginxDeploymentUserProfile

Name	Description	Value
preferredEmail	The preferred support contact email address of the user used for sending alerts and notification. Can be an empty string or a valid email address.	string Constraints: Pattern = ^$|^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$

NginxFrontendIPConfiguration

Name	Description	Value
privateIPAddresses		NginxPrivateIPAddress[]
publicIPAddresses		NginxPublicIPAddress[]

NginxLogging

Name	Description	Value
storageAccount		NginxStorageAccount

NginxNetworkInterfaceConfiguration

Name	Description	Value
subnetId		string

NginxNetworkProfile

Name	Description	Value
frontEndIPConfiguration		NginxFrontendIPConfiguration
networkInterfaceConfiguration		NginxNetworkInterfaceConfiguration

NginxPrivateIPAddress

Name	Description	Value
privateIPAddress		string
privateIPAllocationMethod		'Dynamic' 'Static'
subnetId		string

NginxPublicIPAddress

Name	Description	Value
id		string

NginxStorageAccount

Name	Description	Value
accountName		string
containerName		string

ResourceSku

Name	Description	Value
name	Name of the SKU.	string (required)

UserIdentityProperties

Name	Description	Value

Usage Examples

Terraform (AzAPI provider) resource definition

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

resource "azapi_resource" "symbolicname" {
  type = "Nginx.NginxPlus/nginxDeployments@2023-04-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      enableDiagnosticsSupport = bool
      logging = {
        storageAccount = {
          accountName = "string"
          containerName = "string"
        }
      }
      managedResourceGroup = "string"
      networkProfile = {
        frontEndIPConfiguration = {
          privateIPAddresses = [
            {
              privateIPAddress = "string"
              privateIPAllocationMethod = "string"
              subnetId = "string"
            }
          ]
          publicIPAddresses = [
            {
              id = "string"
            }
          ]
        }
        networkInterfaceConfiguration = {
          subnetId = "string"
        }
      }
      scalingProperties = {
        capacity = int
      }
      userProfile = {
        preferredEmail = "string"
      }
    }
    sku = {
      name = "string"
    }
  }
}

Property Values

Nginx.NginxPlus/nginxDeployments

Name	Description	Value
identity		IdentityProperties
location		string
name	The resource name	string (required)
properties		NginxDeploymentProperties
sku		ResourceSku
tags	Resource tags	Dictionary of tag names and values.
type	The resource type	"Nginx.NginxPlus/nginxDeployments@2023-04-01"

IdentityProperties

Name	Description	Value
type		'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Dictionary of <UserIdentityProperties>	IdentityPropertiesUserAssignedIdentities

IdentityPropertiesUserAssignedIdentities

Name	Description	Value

NginxDeploymentProperties

Name	Description	Value
enableDiagnosticsSupport		bool
logging		NginxLogging
managedResourceGroup	The managed resource group to deploy VNet injection related network resources.	string
networkProfile		NginxNetworkProfile
scalingProperties		NginxDeploymentScalingProperties
userProfile		NginxDeploymentUserProfile

NginxDeploymentScalingProperties

Name	Description	Value
capacity		int

NginxDeploymentTags

Name	Description	Value

NginxDeploymentUserProfile

Name	Description	Value
preferredEmail	The preferred support contact email address of the user used for sending alerts and notification. Can be an empty string or a valid email address.	string Constraints: Pattern = ^$|^[A-Za-z0-9._%+-]+@(?:[A-Za-z0-9-]+\.)+[A-Za-z]{2,}$

NginxFrontendIPConfiguration

Name	Description	Value
privateIPAddresses		NginxPrivateIPAddress[]
publicIPAddresses		NginxPublicIPAddress[]

NginxLogging

Name	Description	Value
storageAccount		NginxStorageAccount

NginxNetworkInterfaceConfiguration

Name	Description	Value
subnetId		string

NginxNetworkProfile

Name	Description	Value
frontEndIPConfiguration		NginxFrontendIPConfiguration
networkInterfaceConfiguration		NginxNetworkInterfaceConfiguration

NginxPrivateIPAddress

Name	Description	Value
privateIPAddress		string
privateIPAllocationMethod		'Dynamic' 'Static'
subnetId		string

NginxPublicIPAddress

Name	Description	Value
id		string

NginxStorageAccount

Name	Description	Value
accountName		string
containerName		string

ResourceSku

Name	Description	Value
name	Name of the SKU.	string (required)

UserIdentityProperties

Name	Description	Value