Microsoft.RedHatOpenShift openShiftClusters 2023-09-04

• Latest
• 2023-11-22
• 2023-09-04
• 2023-07-01-preview
• 2023-04-01
• 2022-09-04
• 2022-04-01
• 2021-09-01-preview
• 2020-04-30

Bicep resource definition

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

resource symbolicname 'Microsoft.RedHatOpenShift/openShiftClusters@2023-09-04' = {
  location: 'string'
  name: 'string'
  properties: {
    apiserverProfile: {
      ip: 'string'
      url: 'string'
      visibility: 'string'
    }
    clusterProfile: {
      domain: 'string'
      fipsValidatedModules: 'string'
      pullSecret: 'string'
      resourceGroupId: 'string'
      version: 'string'
    }
    consoleProfile: {
      url: 'string'
    }
    ingressProfiles: [
      {
        ip: 'string'
        name: 'string'
        visibility: 'string'
      }
    ]
    masterProfile: {
      diskEncryptionSetId: 'string'
      encryptionAtHost: 'string'
      subnetId: 'string'
      vmSize: 'string'
    }
    networkProfile: {
      outboundType: 'string'
      podCidr: 'string'
      preconfiguredNSG: 'string'
      serviceCidr: 'string'
    }
    provisioningState: 'string'
    servicePrincipalProfile: {
      clientId: 'string'
      clientSecret: 'string'
    }
    workerProfiles: [
      {
        count: int
        diskEncryptionSetId: 'string'
        diskSizeGB: int
        encryptionAtHost: 'string'
        name: 'string'
        subnetId: 'string'
        vmSize: 'string'
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

APIServerProfile

Name	Description	Value
ip	The IP of the cluster API server.	string
url	The URL to access the cluster API server.	string
visibility	API server visibility.	'Private' 'Public'

ClusterProfile

Name	Description	Value
domain	The domain for the cluster.	string
fipsValidatedModules	If FIPS validated crypto modules are used	'Disabled' 'Enabled'
pullSecret	The pull secret for the cluster.	string
resourceGroupId	The ID of the cluster resource group.	string
version	The version of the cluster.	string

ConsoleProfile

Name	Description	Value
url	The URL to access the cluster console.	string

IngressProfile

Name	Description	Value
ip	The IP of the ingress.	string
name	The ingress profile name.	string
visibility	Ingress visibility.	'Private' 'Public'

MasterProfile

Name	Description	Value
diskEncryptionSetId	The resource ID of an associated DiskEncryptionSet, if applicable.	string
encryptionAtHost	Whether master virtual machines are encrypted at host.	'Disabled' 'Enabled'
subnetId	The Azure resource ID of the master subnet.	string
vmSize	The size of the master VMs.	string

Microsoft.RedHatOpenShift/openShiftClusters

Name	Description	Value
location	The geo-location where the resource lives	string (required)
name	The resource name	string (required)
properties	The cluster properties.	OpenShiftClusterProperties
tags	Resource tags	Dictionary of tag names and values. See Tags in templates

NetworkProfile

Name	Description	Value
outboundType	The OutboundType used for egress traffic.	'Loadbalancer' 'UserDefinedRouting'
podCidr	The CIDR used for OpenShift/Kubernetes Pods.	string
preconfiguredNSG	Specifies whether subnets are pre-attached with an NSG	'Disabled' 'Enabled'
serviceCidr	The CIDR used for OpenShift/Kubernetes Services.	string

OpenShiftClusterProperties

Name	Description	Value
apiserverProfile	The cluster API server profile.	APIServerProfile
clusterProfile	The cluster profile.	ClusterProfile
consoleProfile	The console profile.	ConsoleProfile
ingressProfiles	The cluster ingress profiles.	IngressProfile[]
masterProfile	The cluster master profile.	MasterProfile
networkProfile	The cluster network profile.	NetworkProfile
provisioningState	The cluster provisioning state.	'AdminUpdating' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating'
servicePrincipalProfile	The cluster service principal profile.	ServicePrincipalProfile
workerProfiles	The cluster worker profiles.	WorkerProfile[]

ServicePrincipalProfile

Name	Description	Value
clientId	The client ID used for the cluster.	string
clientSecret	The client secret used for the cluster.	string

TrackedResourceTags

Name	Description	Value

WorkerProfile

Name	Description	Value
count	The number of worker VMs.	int
diskEncryptionSetId	The resource ID of an associated DiskEncryptionSet, if applicable.	string
diskSizeGB	The disk size of the worker VMs.	int
encryptionAtHost	Whether master virtual machines are encrypted at host.	'Disabled' 'Enabled'
name	The worker profile name.	string
subnetId	The Azure resource ID of the worker subnet.	string
vmSize	The size of the worker VMs.	string

ARM template resource definition

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

{
  "type": "Microsoft.RedHatOpenShift/openShiftClusters",
  "apiVersion": "2023-09-04",
  "name": "string",
  "location": "string",
  "properties": {
    "apiserverProfile": {
      "ip": "string",
      "url": "string",
      "visibility": "string"
    },
    "clusterProfile": {
      "domain": "string",
      "fipsValidatedModules": "string",
      "pullSecret": "string",
      "resourceGroupId": "string",
      "version": "string"
    },
    "consoleProfile": {
      "url": "string"
    },
    "ingressProfiles": [
      {
        "ip": "string",
        "name": "string",
        "visibility": "string"
      }
    ],
    "masterProfile": {
      "diskEncryptionSetId": "string",
      "encryptionAtHost": "string",
      "subnetId": "string",
      "vmSize": "string"
    },
    "networkProfile": {
      "outboundType": "string",
      "podCidr": "string",
      "preconfiguredNSG": "string",
      "serviceCidr": "string"
    },
    "provisioningState": "string",
    "servicePrincipalProfile": {
      "clientId": "string",
      "clientSecret": "string"
    },
    "workerProfiles": [
      {
        "count": "int",
        "diskEncryptionSetId": "string",
        "diskSizeGB": "int",
        "encryptionAtHost": "string",
        "name": "string",
        "subnetId": "string",
        "vmSize": "string"
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

APIServerProfile

Name	Description	Value
ip	The IP of the cluster API server.	string
url	The URL to access the cluster API server.	string
visibility	API server visibility.	'Private' 'Public'

ClusterProfile

Name	Description	Value
domain	The domain for the cluster.	string
fipsValidatedModules	If FIPS validated crypto modules are used	'Disabled' 'Enabled'
pullSecret	The pull secret for the cluster.	string
resourceGroupId	The ID of the cluster resource group.	string
version	The version of the cluster.	string

ConsoleProfile

Name	Description	Value
url	The URL to access the cluster console.	string

IngressProfile

Name	Description	Value
ip	The IP of the ingress.	string
name	The ingress profile name.	string
visibility	Ingress visibility.	'Private' 'Public'

MasterProfile

Name	Description	Value
diskEncryptionSetId	The resource ID of an associated DiskEncryptionSet, if applicable.	string
encryptionAtHost	Whether master virtual machines are encrypted at host.	'Disabled' 'Enabled'
subnetId	The Azure resource ID of the master subnet.	string
vmSize	The size of the master VMs.	string

Microsoft.RedHatOpenShift/openShiftClusters

Name	Description	Value
apiVersion	The api version	'2023-09-04'
location	The geo-location where the resource lives	string (required)
name	The resource name	string (required)
properties	The cluster properties.	OpenShiftClusterProperties
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
type	The resource type	'Microsoft.RedHatOpenShift/openShiftClusters'

NetworkProfile

Name	Description	Value
outboundType	The OutboundType used for egress traffic.	'Loadbalancer' 'UserDefinedRouting'
podCidr	The CIDR used for OpenShift/Kubernetes Pods.	string
preconfiguredNSG	Specifies whether subnets are pre-attached with an NSG	'Disabled' 'Enabled'
serviceCidr	The CIDR used for OpenShift/Kubernetes Services.	string

OpenShiftClusterProperties

Name	Description	Value
apiserverProfile	The cluster API server profile.	APIServerProfile
clusterProfile	The cluster profile.	ClusterProfile
consoleProfile	The console profile.	ConsoleProfile
ingressProfiles	The cluster ingress profiles.	IngressProfile[]
masterProfile	The cluster master profile.	MasterProfile
networkProfile	The cluster network profile.	NetworkProfile
provisioningState	The cluster provisioning state.	'AdminUpdating' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating'
servicePrincipalProfile	The cluster service principal profile.	ServicePrincipalProfile
workerProfiles	The cluster worker profiles.	WorkerProfile[]

ServicePrincipalProfile

Name	Description	Value
clientId	The client ID used for the cluster.	string
clientSecret	The client secret used for the cluster.	string

TrackedResourceTags

Name	Description	Value

WorkerProfile

Name	Description	Value
count	The number of worker VMs.	int
diskEncryptionSetId	The resource ID of an associated DiskEncryptionSet, if applicable.	string
diskSizeGB	The disk size of the worker VMs.	int
encryptionAtHost	Whether master virtual machines are encrypted at host.	'Disabled' 'Enabled'
name	The worker profile name.	string
subnetId	The Azure resource ID of the worker subnet.	string
vmSize	The size of the worker VMs.	string

Terraform (AzAPI provider) resource definition

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.RedHatOpenShift/openShiftClusters@2023-09-04"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      apiserverProfile = {
        ip = "string"
        url = "string"
        visibility = "string"
      }
      clusterProfile = {
        domain = "string"
        fipsValidatedModules = "string"
        pullSecret = "string"
        resourceGroupId = "string"
        version = "string"
      }
      consoleProfile = {
        url = "string"
      }
      ingressProfiles = [
        {
          ip = "string"
          name = "string"
          visibility = "string"
        }
      ]
      masterProfile = {
        diskEncryptionSetId = "string"
        encryptionAtHost = "string"
        subnetId = "string"
        vmSize = "string"
      }
      networkProfile = {
        outboundType = "string"
        podCidr = "string"
        preconfiguredNSG = "string"
        serviceCidr = "string"
      }
      provisioningState = "string"
      servicePrincipalProfile = {
        clientId = "string"
        clientSecret = "string"
      }
      workerProfiles = [
        {
          count = int
          diskEncryptionSetId = "string"
          diskSizeGB = int
          encryptionAtHost = "string"
          name = "string"
          subnetId = "string"
          vmSize = "string"
        }
      ]
    }
  })
}

Property values

APIServerProfile

Name	Description	Value
ip	The IP of the cluster API server.	string
url	The URL to access the cluster API server.	string
visibility	API server visibility.	'Private' 'Public'

ClusterProfile

Name	Description	Value
domain	The domain for the cluster.	string
fipsValidatedModules	If FIPS validated crypto modules are used	'Disabled' 'Enabled'
pullSecret	The pull secret for the cluster.	string
resourceGroupId	The ID of the cluster resource group.	string
version	The version of the cluster.	string

ConsoleProfile

Name	Description	Value
url	The URL to access the cluster console.	string

IngressProfile

Name	Description	Value
ip	The IP of the ingress.	string
name	The ingress profile name.	string
visibility	Ingress visibility.	'Private' 'Public'

MasterProfile

Name	Description	Value
diskEncryptionSetId	The resource ID of an associated DiskEncryptionSet, if applicable.	string
encryptionAtHost	Whether master virtual machines are encrypted at host.	'Disabled' 'Enabled'
subnetId	The Azure resource ID of the master subnet.	string
vmSize	The size of the master VMs.	string

Microsoft.RedHatOpenShift/openShiftClusters

Name	Description	Value
location	The geo-location where the resource lives	string (required)
name	The resource name	string (required)
properties	The cluster properties.	OpenShiftClusterProperties
tags	Resource tags	Dictionary of tag names and values.
type	The resource type	"Microsoft.RedHatOpenShift/openShiftClusters@2023-09-04"

NetworkProfile

Name	Description	Value
outboundType	The OutboundType used for egress traffic.	'Loadbalancer' 'UserDefinedRouting'
podCidr	The CIDR used for OpenShift/Kubernetes Pods.	string
preconfiguredNSG	Specifies whether subnets are pre-attached with an NSG	'Disabled' 'Enabled'
serviceCidr	The CIDR used for OpenShift/Kubernetes Services.	string

OpenShiftClusterProperties

Name	Description	Value
apiserverProfile	The cluster API server profile.	APIServerProfile
clusterProfile	The cluster profile.	ClusterProfile
consoleProfile	The console profile.	ConsoleProfile
ingressProfiles	The cluster ingress profiles.	IngressProfile[]
masterProfile	The cluster master profile.	MasterProfile
networkProfile	The cluster network profile.	NetworkProfile
provisioningState	The cluster provisioning state.	'AdminUpdating' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating'
servicePrincipalProfile	The cluster service principal profile.	ServicePrincipalProfile
workerProfiles	The cluster worker profiles.	WorkerProfile[]

ServicePrincipalProfile

Name	Description	Value
clientId	The client ID used for the cluster.	string
clientSecret	The client secret used for the cluster.	string

TrackedResourceTags

Name	Description	Value

WorkerProfile

Name	Description	Value
count	The number of worker VMs.	int
diskEncryptionSetId	The resource ID of an associated DiskEncryptionSet, if applicable.	string
diskSizeGB	The disk size of the worker VMs.	int
encryptionAtHost	Whether master virtual machines are encrypted at host.	'Disabled' 'Enabled'
name	The worker profile name.	string
subnetId	The Azure resource ID of the worker subnet.	string
vmSize	The size of the worker VMs.	string