Microsoft.RedHatOpenShift openShiftClusters 2023-04-01

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@2023-04-01' = {
  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'
      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
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:

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

NetworkProfile

Name Description Value
outboundType The OutboundType used for egress traffic. 'Loadbalancer'
'UserDefinedRouting'
podCidr The CIDR used for OpenShift/Kubernetes Pods. string
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