Bicep resource definition
The clusters/applications resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
To create a Microsoft.HDInsight/clusters/applications resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.HDInsight/clusters/applications@2023-08-15-preview' = {
parent: resourceSymbolicName
etag: 'string'
name: 'string'
properties: {
applicationType: 'string'
computeProfile: {
roles: [
{
autoscale: {
capacity: {
maxInstanceCount: int
minInstanceCount: int
}
recurrence: {
schedule: [
{
days: [
'string'
]
timeAndCapacity: {
maxInstanceCount: int
minInstanceCount: int
time: 'string'
}
}
]
timeZone: 'string'
}
}
dataDisksGroups: [
{
disksPerNode: int
}
]
encryptDataDisks: bool
hardwareProfile: {
vmSize: 'string'
}
minInstanceCount: int
name: 'string'
osProfile: {
linuxOperatingSystemProfile: {
password: 'string'
sshProfile: {
publicKeys: [
{
certificateData: 'string'
}
]
}
username: 'string'
}
}
scriptActions: [
{
name: 'string'
parameters: 'string'
uri: 'string'
}
]
targetInstanceCount: int
virtualNetworkProfile: {
id: 'string'
subnet: 'string'
}
VMGroupName: 'string'
}
]
}
errors: [
{
code: 'string'
message: 'string'
}
]
httpsEndpoints: [
{
accessModes: [
'string'
]
destinationPort: int
disableGatewayAuth: bool
privateIPAddress: 'string'
subDomainSuffix: 'string'
}
]
installScriptActions: [
{
name: 'string'
parameters: 'string'
roles: [
'string'
]
uri: 'string'
}
]
privateLinkConfigurations: [
{
name: 'string'
properties: {
groupId: 'string'
ipConfigurations: [
{
name: 'string'
properties: {
primary: bool
privateIPAddress: 'string'
privateIPAllocationMethod: 'string'
subnet: {
id: 'string'
}
}
}
]
}
}
]
sshEndpoints: [
{
destinationPort: int
location: 'string'
privateIPAddress: 'string'
publicPort: int
}
]
uninstallScriptActions: [
{
name: 'string'
parameters: 'string'
roles: [
'string'
]
uri: 'string'
}
]
}
tags: {
{customized property}: 'string'
}
}
Property Values
Microsoft.HDInsight/clusters/applications
Name |
Description |
Value |
etag |
The ETag for the application |
string |
name |
The resource name |
string (required) |
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: clusters |
properties |
The properties of the application. |
ApplicationProperties |
tags |
Resource tags |
Dictionary of tag names and values. See Tags in templates |
ApplicationGetEndpoint
Name |
Description |
Value |
destinationPort |
The destination port to connect to. |
int |
location |
The location of the endpoint. |
string |
privateIPAddress |
The private ip address of the endpoint. |
string |
publicPort |
The public port to connect to. |
int |
ApplicationGetHttpsEndpoint
Name |
Description |
Value |
accessModes |
The list of access modes for the application. |
string[] |
destinationPort |
The destination port to connect to. |
int |
disableGatewayAuth |
The value indicates whether to disable GatewayAuth. |
bool |
privateIPAddress |
The private ip address of the endpoint. |
string |
subDomainSuffix |
The subdomain suffix of the application. |
string |
ApplicationProperties
Autoscale
AutoscaleCapacity
Name |
Description |
Value |
maxInstanceCount |
The maximum instance count of the cluster |
int |
minInstanceCount |
The minimum instance count of the cluster |
int |
AutoscaleRecurrence
Name |
Description |
Value |
schedule |
Array of schedule-based autoscale rules |
AutoscaleSchedule[] |
timeZone |
The time zone for the autoscale schedule times |
string |
AutoscaleSchedule
Name |
Description |
Value |
days |
Days of the week for a schedule-based autoscale rule |
String array containing any of: 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
timeAndCapacity |
Time and capacity for a schedule-based autoscale rule |
AutoscaleTimeAndCapacity |
AutoscaleTimeAndCapacity
Name |
Description |
Value |
maxInstanceCount |
The maximum instance count of the cluster |
int |
minInstanceCount |
The minimum instance count of the cluster |
int |
time |
24-hour time in the form xx:xx |
string |
ComputeProfile
Name |
Description |
Value |
roles |
The list of roles in the cluster. |
Role[] |
DataDisksGroups
Name |
Description |
Value |
disksPerNode |
The number of disks per node. |
int |
Errors
Name |
Description |
Value |
code |
The error code. |
string |
message |
The error message. |
string |
HardwareProfile
Name |
Description |
Value |
vmSize |
The size of the VM |
string |
IPConfiguration
Name |
Description |
Value |
name |
The name of private link IP configuration. |
string (required) |
properties |
The private link ip configuration properties. |
IPConfigurationProperties |
IPConfigurationProperties
Name |
Description |
Value |
primary |
Indicates whether this IP configuration is primary for the corresponding NIC. |
bool |
privateIPAddress |
The IP address. |
string |
privateIPAllocationMethod |
The method that private IP address is allocated. |
'dynamic' 'static' |
subnet |
The subnet resource id. |
ResourceId |
LinuxOperatingSystemProfile
Name |
Description |
Value |
password |
The password. |
string |
sshProfile |
The SSH profile. |
SshProfile |
username |
The username. |
string |
OsProfile
PrivateLinkConfiguration
Name |
Description |
Value |
name |
The name of private link configuration. |
string (required) |
properties |
The private link configuration properties. |
PrivateLinkConfigurationProperties (required) |
PrivateLinkConfigurationProperties
Name |
Description |
Value |
groupId |
The HDInsight private linkable sub-resource name to apply the private link configuration to. For example, 'headnode', 'gateway', 'edgenode'. |
string (required) |
ipConfigurations |
The IP configurations for the private link service. |
IPConfiguration[] (required) |
ResourceId
Name |
Description |
Value |
id |
The azure resource id. |
string |
Role
Name |
Description |
Value |
autoscale |
The autoscale configurations. |
Autoscale |
dataDisksGroups |
The data disks groups for the role. |
DataDisksGroups[] |
encryptDataDisks |
Indicates whether encrypt the data disks. |
bool |
hardwareProfile |
The hardware profile. |
HardwareProfile |
minInstanceCount |
The minimum instance count of the cluster. |
int |
name |
The name of the role. |
string |
osProfile |
The operating system profile. |
OsProfile |
scriptActions |
The list of script actions on the role. |
ScriptAction[] |
targetInstanceCount |
The instance count of the cluster. |
int |
virtualNetworkProfile |
The virtual network profile. |
VirtualNetworkProfile |
VMGroupName |
The name of the virtual machine group. |
string |
RuntimeScriptAction
Name |
Description |
Value |
name |
The name of the script action. |
string (required) |
parameters |
The parameters for the script |
string |
roles |
The list of roles where script will be executed. |
string[] (required) |
uri |
The URI to the script. |
string (required) |
ScriptAction
Name |
Description |
Value |
name |
The name of the script action. |
string (required) |
parameters |
The parameters for the script provided. |
string (required) |
uri |
The URI to the script. |
string (required) |
SshProfile
Name |
Description |
Value |
publicKeys |
The list of SSH public keys. |
SshPublicKey[] |
SshPublicKey
Name |
Description |
Value |
certificateData |
The certificate for SSH. |
string |
VirtualNetworkProfile
Name |
Description |
Value |
id |
The ID of the virtual network. |
string |
subnet |
The name of the subnet. |
string |
ARM template resource definition
The clusters/applications resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
To create a Microsoft.HDInsight/clusters/applications resource, add the following JSON to your template.
{
"type": "Microsoft.HDInsight/clusters/applications",
"apiVersion": "2023-08-15-preview",
"name": "string",
"etag": "string",
"properties": {
"applicationType": "string",
"computeProfile": {
"roles": [
{
"autoscale": {
"capacity": {
"maxInstanceCount": "int",
"minInstanceCount": "int"
},
"recurrence": {
"schedule": [
{
"days": [ "string" ],
"timeAndCapacity": {
"maxInstanceCount": "int",
"minInstanceCount": "int",
"time": "string"
}
}
],
"timeZone": "string"
}
},
"dataDisksGroups": [
{
"disksPerNode": "int"
}
],
"encryptDataDisks": "bool",
"hardwareProfile": {
"vmSize": "string"
},
"minInstanceCount": "int",
"name": "string",
"osProfile": {
"linuxOperatingSystemProfile": {
"password": "string",
"sshProfile": {
"publicKeys": [
{
"certificateData": "string"
}
]
},
"username": "string"
}
},
"scriptActions": [
{
"name": "string",
"parameters": "string",
"uri": "string"
}
],
"targetInstanceCount": "int",
"virtualNetworkProfile": {
"id": "string",
"subnet": "string"
},
"VMGroupName": "string"
}
]
},
"errors": [
{
"code": "string",
"message": "string"
}
],
"httpsEndpoints": [
{
"accessModes": [ "string" ],
"destinationPort": "int",
"disableGatewayAuth": "bool",
"privateIPAddress": "string",
"subDomainSuffix": "string"
}
],
"installScriptActions": [
{
"name": "string",
"parameters": "string",
"roles": [ "string" ],
"uri": "string"
}
],
"privateLinkConfigurations": [
{
"name": "string",
"properties": {
"groupId": "string",
"ipConfigurations": [
{
"name": "string",
"properties": {
"primary": "bool",
"privateIPAddress": "string",
"privateIPAllocationMethod": "string",
"subnet": {
"id": "string"
}
}
}
]
}
}
],
"sshEndpoints": [
{
"destinationPort": "int",
"location": "string",
"privateIPAddress": "string",
"publicPort": "int"
}
],
"uninstallScriptActions": [
{
"name": "string",
"parameters": "string",
"roles": [ "string" ],
"uri": "string"
}
]
},
"tags": {
"{customized property}": "string"
}
}
Property Values
Microsoft.HDInsight/clusters/applications
Name |
Description |
Value |
apiVersion |
The api version |
'2023-08-15-preview' |
etag |
The ETag for the application |
string |
name |
The resource name |
string (required) |
properties |
The properties of the application. |
ApplicationProperties |
tags |
Resource tags |
Dictionary of tag names and values. See Tags in templates |
type |
The resource type |
'Microsoft.HDInsight/clusters/applications' |
ApplicationGetEndpoint
Name |
Description |
Value |
destinationPort |
The destination port to connect to. |
int |
location |
The location of the endpoint. |
string |
privateIPAddress |
The private ip address of the endpoint. |
string |
publicPort |
The public port to connect to. |
int |
ApplicationGetHttpsEndpoint
Name |
Description |
Value |
accessModes |
The list of access modes for the application. |
string[] |
destinationPort |
The destination port to connect to. |
int |
disableGatewayAuth |
The value indicates whether to disable GatewayAuth. |
bool |
privateIPAddress |
The private ip address of the endpoint. |
string |
subDomainSuffix |
The subdomain suffix of the application. |
string |
ApplicationProperties
Autoscale
AutoscaleCapacity
Name |
Description |
Value |
maxInstanceCount |
The maximum instance count of the cluster |
int |
minInstanceCount |
The minimum instance count of the cluster |
int |
AutoscaleRecurrence
Name |
Description |
Value |
schedule |
Array of schedule-based autoscale rules |
AutoscaleSchedule[] |
timeZone |
The time zone for the autoscale schedule times |
string |
AutoscaleSchedule
Name |
Description |
Value |
days |
Days of the week for a schedule-based autoscale rule |
String array containing any of: 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
timeAndCapacity |
Time and capacity for a schedule-based autoscale rule |
AutoscaleTimeAndCapacity |
AutoscaleTimeAndCapacity
Name |
Description |
Value |
maxInstanceCount |
The maximum instance count of the cluster |
int |
minInstanceCount |
The minimum instance count of the cluster |
int |
time |
24-hour time in the form xx:xx |
string |
ComputeProfile
Name |
Description |
Value |
roles |
The list of roles in the cluster. |
Role[] |
DataDisksGroups
Name |
Description |
Value |
disksPerNode |
The number of disks per node. |
int |
Errors
Name |
Description |
Value |
code |
The error code. |
string |
message |
The error message. |
string |
HardwareProfile
Name |
Description |
Value |
vmSize |
The size of the VM |
string |
IPConfiguration
Name |
Description |
Value |
name |
The name of private link IP configuration. |
string (required) |
properties |
The private link ip configuration properties. |
IPConfigurationProperties |
IPConfigurationProperties
Name |
Description |
Value |
primary |
Indicates whether this IP configuration is primary for the corresponding NIC. |
bool |
privateIPAddress |
The IP address. |
string |
privateIPAllocationMethod |
The method that private IP address is allocated. |
'dynamic' 'static' |
subnet |
The subnet resource id. |
ResourceId |
LinuxOperatingSystemProfile
Name |
Description |
Value |
password |
The password. |
string |
sshProfile |
The SSH profile. |
SshProfile |
username |
The username. |
string |
OsProfile
PrivateLinkConfiguration
Name |
Description |
Value |
name |
The name of private link configuration. |
string (required) |
properties |
The private link configuration properties. |
PrivateLinkConfigurationProperties (required) |
PrivateLinkConfigurationProperties
Name |
Description |
Value |
groupId |
The HDInsight private linkable sub-resource name to apply the private link configuration to. For example, 'headnode', 'gateway', 'edgenode'. |
string (required) |
ipConfigurations |
The IP configurations for the private link service. |
IPConfiguration[] (required) |
ResourceId
Name |
Description |
Value |
id |
The azure resource id. |
string |
Role
Name |
Description |
Value |
autoscale |
The autoscale configurations. |
Autoscale |
dataDisksGroups |
The data disks groups for the role. |
DataDisksGroups[] |
encryptDataDisks |
Indicates whether encrypt the data disks. |
bool |
hardwareProfile |
The hardware profile. |
HardwareProfile |
minInstanceCount |
The minimum instance count of the cluster. |
int |
name |
The name of the role. |
string |
osProfile |
The operating system profile. |
OsProfile |
scriptActions |
The list of script actions on the role. |
ScriptAction[] |
targetInstanceCount |
The instance count of the cluster. |
int |
virtualNetworkProfile |
The virtual network profile. |
VirtualNetworkProfile |
VMGroupName |
The name of the virtual machine group. |
string |
RuntimeScriptAction
Name |
Description |
Value |
name |
The name of the script action. |
string (required) |
parameters |
The parameters for the script |
string |
roles |
The list of roles where script will be executed. |
string[] (required) |
uri |
The URI to the script. |
string (required) |
ScriptAction
Name |
Description |
Value |
name |
The name of the script action. |
string (required) |
parameters |
The parameters for the script provided. |
string (required) |
uri |
The URI to the script. |
string (required) |
SshProfile
Name |
Description |
Value |
publicKeys |
The list of SSH public keys. |
SshPublicKey[] |
SshPublicKey
Name |
Description |
Value |
certificateData |
The certificate for SSH. |
string |
VirtualNetworkProfile
Name |
Description |
Value |
id |
The ID of the virtual network. |
string |
subnet |
The name of the subnet. |
string |
Usage Examples
Azure Quickstart Templates
The following Azure Quickstart templates deploy this resource type.
The clusters/applications resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
To create a Microsoft.HDInsight/clusters/applications resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.HDInsight/clusters/applications@2023-08-15-preview"
name = "string"
parent_id = "string"
tags = {
{customized property} = "string"
}
body = {
etag = "string"
properties = {
applicationType = "string"
computeProfile = {
roles = [
{
autoscale = {
capacity = {
maxInstanceCount = int
minInstanceCount = int
}
recurrence = {
schedule = [
{
days = [
"string"
]
timeAndCapacity = {
maxInstanceCount = int
minInstanceCount = int
time = "string"
}
}
]
timeZone = "string"
}
}
dataDisksGroups = [
{
disksPerNode = int
}
]
encryptDataDisks = bool
hardwareProfile = {
vmSize = "string"
}
minInstanceCount = int
name = "string"
osProfile = {
linuxOperatingSystemProfile = {
password = "string"
sshProfile = {
publicKeys = [
{
certificateData = "string"
}
]
}
username = "string"
}
}
scriptActions = [
{
name = "string"
parameters = "string"
uri = "string"
}
]
targetInstanceCount = int
virtualNetworkProfile = {
id = "string"
subnet = "string"
}
VMGroupName = "string"
}
]
}
errors = [
{
code = "string"
message = "string"
}
]
httpsEndpoints = [
{
accessModes = [
"string"
]
destinationPort = int
disableGatewayAuth = bool
privateIPAddress = "string"
subDomainSuffix = "string"
}
]
installScriptActions = [
{
name = "string"
parameters = "string"
roles = [
"string"
]
uri = "string"
}
]
privateLinkConfigurations = [
{
name = "string"
properties = {
groupId = "string"
ipConfigurations = [
{
name = "string"
properties = {
primary = bool
privateIPAddress = "string"
privateIPAllocationMethod = "string"
subnet = {
id = "string"
}
}
}
]
}
}
]
sshEndpoints = [
{
destinationPort = int
location = "string"
privateIPAddress = "string"
publicPort = int
}
]
uninstallScriptActions = [
{
name = "string"
parameters = "string"
roles = [
"string"
]
uri = "string"
}
]
}
}
}
Property Values
Microsoft.HDInsight/clusters/applications
Name |
Description |
Value |
etag |
The ETag for the application |
string |
name |
The resource name |
string (required) |
parent_id |
The ID of the resource that is the parent for this resource. |
ID for resource of type: clusters |
properties |
The properties of the application. |
ApplicationProperties |
tags |
Resource tags |
Dictionary of tag names and values. |
type |
The resource type |
"Microsoft.HDInsight/clusters/applications@2023-08-15-preview" |
ApplicationGetEndpoint
Name |
Description |
Value |
destinationPort |
The destination port to connect to. |
int |
location |
The location of the endpoint. |
string |
privateIPAddress |
The private ip address of the endpoint. |
string |
publicPort |
The public port to connect to. |
int |
ApplicationGetHttpsEndpoint
Name |
Description |
Value |
accessModes |
The list of access modes for the application. |
string[] |
destinationPort |
The destination port to connect to. |
int |
disableGatewayAuth |
The value indicates whether to disable GatewayAuth. |
bool |
privateIPAddress |
The private ip address of the endpoint. |
string |
subDomainSuffix |
The subdomain suffix of the application. |
string |
ApplicationProperties
Autoscale
AutoscaleCapacity
Name |
Description |
Value |
maxInstanceCount |
The maximum instance count of the cluster |
int |
minInstanceCount |
The minimum instance count of the cluster |
int |
AutoscaleRecurrence
Name |
Description |
Value |
schedule |
Array of schedule-based autoscale rules |
AutoscaleSchedule[] |
timeZone |
The time zone for the autoscale schedule times |
string |
AutoscaleSchedule
Name |
Description |
Value |
days |
Days of the week for a schedule-based autoscale rule |
String array containing any of: 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday' |
timeAndCapacity |
Time and capacity for a schedule-based autoscale rule |
AutoscaleTimeAndCapacity |
AutoscaleTimeAndCapacity
Name |
Description |
Value |
maxInstanceCount |
The maximum instance count of the cluster |
int |
minInstanceCount |
The minimum instance count of the cluster |
int |
time |
24-hour time in the form xx:xx |
string |
ComputeProfile
Name |
Description |
Value |
roles |
The list of roles in the cluster. |
Role[] |
DataDisksGroups
Name |
Description |
Value |
disksPerNode |
The number of disks per node. |
int |
Errors
Name |
Description |
Value |
code |
The error code. |
string |
message |
The error message. |
string |
HardwareProfile
Name |
Description |
Value |
vmSize |
The size of the VM |
string |
IPConfiguration
Name |
Description |
Value |
name |
The name of private link IP configuration. |
string (required) |
properties |
The private link ip configuration properties. |
IPConfigurationProperties |
IPConfigurationProperties
Name |
Description |
Value |
primary |
Indicates whether this IP configuration is primary for the corresponding NIC. |
bool |
privateIPAddress |
The IP address. |
string |
privateIPAllocationMethod |
The method that private IP address is allocated. |
'dynamic' 'static' |
subnet |
The subnet resource id. |
ResourceId |
LinuxOperatingSystemProfile
Name |
Description |
Value |
password |
The password. |
string |
sshProfile |
The SSH profile. |
SshProfile |
username |
The username. |
string |
OsProfile
PrivateLinkConfiguration
Name |
Description |
Value |
name |
The name of private link configuration. |
string (required) |
properties |
The private link configuration properties. |
PrivateLinkConfigurationProperties (required) |
PrivateLinkConfigurationProperties
Name |
Description |
Value |
groupId |
The HDInsight private linkable sub-resource name to apply the private link configuration to. For example, 'headnode', 'gateway', 'edgenode'. |
string (required) |
ipConfigurations |
The IP configurations for the private link service. |
IPConfiguration[] (required) |
ResourceId
Name |
Description |
Value |
id |
The azure resource id. |
string |
Role
Name |
Description |
Value |
autoscale |
The autoscale configurations. |
Autoscale |
dataDisksGroups |
The data disks groups for the role. |
DataDisksGroups[] |
encryptDataDisks |
Indicates whether encrypt the data disks. |
bool |
hardwareProfile |
The hardware profile. |
HardwareProfile |
minInstanceCount |
The minimum instance count of the cluster. |
int |
name |
The name of the role. |
string |
osProfile |
The operating system profile. |
OsProfile |
scriptActions |
The list of script actions on the role. |
ScriptAction[] |
targetInstanceCount |
The instance count of the cluster. |
int |
virtualNetworkProfile |
The virtual network profile. |
VirtualNetworkProfile |
VMGroupName |
The name of the virtual machine group. |
string |
RuntimeScriptAction
Name |
Description |
Value |
name |
The name of the script action. |
string (required) |
parameters |
The parameters for the script |
string |
roles |
The list of roles where script will be executed. |
string[] (required) |
uri |
The URI to the script. |
string (required) |
ScriptAction
Name |
Description |
Value |
name |
The name of the script action. |
string (required) |
parameters |
The parameters for the script provided. |
string (required) |
uri |
The URI to the script. |
string (required) |
SshProfile
Name |
Description |
Value |
publicKeys |
The list of SSH public keys. |
SshPublicKey[] |
SshPublicKey
Name |
Description |
Value |
certificateData |
The certificate for SSH. |
string |
VirtualNetworkProfile
Name |
Description |
Value |
id |
The ID of the virtual network. |
string |
subnet |
The name of the subnet. |
string |