Microsoft.RedHatOpenShift openShiftClusters 2022-04-01

Article
09/18/2023

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@2022-04-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  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: {
      podCidr: '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

openShiftClusters

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

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[]

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

NetworkProfile

Name	Description	Value
podCidr	The CIDR used for OpenShift/Kubernetes Pods.	string
serviceCidr	The CIDR used for OpenShift/Kubernetes Services.	string

ServicePrincipalProfile

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

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": "2022-04-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "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": {
      "podCidr": "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

openShiftClusters

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

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[]

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

NetworkProfile

Name	Description	Value
podCidr	The CIDR used for OpenShift/Kubernetes Pods.	string
serviceCidr	The CIDR used for OpenShift/Kubernetes Services.	string

ServicePrincipalProfile

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

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@2022-04-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  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 = {
        podCidr = "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

openShiftClusters

Name	Description	Value
type	The resource type	"Microsoft.RedHatOpenShift/openShiftClusters@2022-04-01"
name	The resource name	string (required)
location	The geo-location where the resource lives	string (required)
parent_id	To deploy to a resource group, use the ID of that resource group.	string (required)
tags	Resource tags.	Dictionary of tag names and values.
properties	The cluster properties.	OpenShiftClusterProperties

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[]

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

NetworkProfile

Name	Description	Value
podCidr	The CIDR used for OpenShift/Kubernetes Pods.	string
serviceCidr	The CIDR used for OpenShift/Kubernetes Services.	string

ServicePrincipalProfile

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

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

Microsoft.RedHatOpenShift openShiftClusters 2022-04-01

Bicep resource definition

Resource format

Property values

openShiftClusters

OpenShiftClusterProperties

APIServerProfile

ClusterProfile

ConsoleProfile

IngressProfile

MasterProfile

NetworkProfile

ServicePrincipalProfile

WorkerProfile

ARM template resource definition

Resource format

Property values

openShiftClusters

OpenShiftClusterProperties

APIServerProfile

ClusterProfile

ConsoleProfile

IngressProfile

MasterProfile

NetworkProfile

ServicePrincipalProfile

WorkerProfile

Terraform (AzAPI provider) resource definition

Resource format

Property values

openShiftClusters

OpenShiftClusterProperties

APIServerProfile

ClusterProfile

ConsoleProfile

IngressProfile

MasterProfile

NetworkProfile

ServicePrincipalProfile

WorkerProfile

Additional resources

Additional resources