Share via

Microsoft.RedHatOpenShift openShiftClusters 2022-09-04

  • Article

Bicep resource definition

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

resource symbolicname 'Microsoft.RedHatOpenShift/openShiftClusters@2022-09-04' = {
  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:

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-09-04",
  "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-09-04'
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-09-04"
  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-09-04"
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