Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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' = {
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: {
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
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 |
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 |
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": "2022-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": {
"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
Microsoft.RedHatOpenShift/openShiftClusters
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2022-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' |
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 |
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 |
Usage Examples
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"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
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
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@2022-04-01" |
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 |
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 |