Open Shift Managed Clusters - List
Gets a list of OpenShift managed clusters in the specified subscription. The operation returns properties of each OpenShift managed cluster.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/openShiftManagedClusters?api-version=2019-04-30
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
api-version
|
query | True |
string |
Client Api Version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
Security
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
List Managed Clusters
Sample request
Sample response
{
"value": [
{
"id": "/subscriptions/subid1/providers/Microsoft.ContainerService/openShiftManagedClusters",
"location": "location1",
"name": "clustername1",
"tags": {
"archv2": "",
"tier": "production"
},
"type": "Microsoft.ContainerService/OpenShiftManagedClusters",
"properties": {
"provisioningState": "Succeeded",
"openShiftVersion": "v3.11",
"clusterVersion": "osa.1",
"fqdn": "df9337748a4b.location1.cloudapp.azure.com",
"publicHostname": "openshift.1225bdf9337748a4bd3a.location1.azmosa.io",
"networkProfile": {
"vnetCidr": "10.0.0.0/8"
},
"masterPoolProfile": {
"count": 3,
"vmSize": "Standard_D4s_v3",
"subnetCidr": "10.0.0.0/24"
},
"agentPoolProfiles": [
{
"name": "infra",
"role": "infra",
"count": 2,
"vmSize": "Standard_D4s_v3",
"osType": "Linux",
"subnetCidr": "10.0.0.0/24"
},
{
"name": "compute",
"role": "compute",
"count": 4,
"vmSize": "Standard_D4s_v3",
"osType": "Linux",
"subnetCidr": "10.0.0.0/24"
}
],
"routerProfiles": [
{
"name": "default",
"fqdn": "osa2925bdf9337748f4bd3b.location1.cloudapp.azure.com",
"publicSubdomain": "apps.bc309ee87c164153871c.location1.azmosa.io"
}
],
"authProfile": {
"identityProviders": [
{
"name": "Azure AD",
"provider": {
"kind": "AADIdentityProvider",
"clientId": "clientId",
"tenantId": "tenantId",
"customerAdminGroupId": "customerAdminGroupId"
}
}
]
}
}
}
]
}
Definitions
Name | Description |
---|---|
Network |
Represents the OpenShift networking configuration |
Open |
OpenShiftAgentPoolProfileRole represents the role of the AgentPoolProfile. |
Open |
Size of OpenShift VMs. |
Open |
OpenShift Managed cluster. |
Open |
Defines the Identity provider for MS AAD. |
Open |
Defines the configuration of the OpenShift cluster VMs. |
Open |
Defines all possible authentication profiles for the OpenShift cluster. |
Open |
Defines the configuration of the identity providers to be used in the OpenShift cluster. |
Open |
The response from the List OpenShift Managed Clusters operation. |
Open |
OpenShiftManagedClusterMaterPoolProfile contains configuration for OpenShift master VMs. |
Open |
Represents an OpenShift router |
OSType |
OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux. |
Purchase |
Used for establishing the purchase context of any 3rd Party artifact through MarketPlace. |
NetworkProfile
Represents the OpenShift networking configuration
Name | Type | Default value | Description |
---|---|---|---|
peerVnetId |
string |
CIDR of the Vnet to peer. |
|
vnetCidr |
string |
10.0.0.0/8 |
CIDR for the OpenShift Vnet. |
vnetId |
string |
ID of the Vnet created for OSA cluster. |
OpenShiftAgentPoolProfileRole
OpenShiftAgentPoolProfileRole represents the role of the AgentPoolProfile.
Value | Description |
---|---|
compute | |
infra |
OpenShiftContainerServiceVMSize
Size of OpenShift VMs.
Value | Description |
---|---|
Standard_D2s_v3 | |
Standard_D4s_v3 | |
Standard_D8s_v3 | |
Standard_D16s_v3 | |
Standard_D32s_v3 | |
Standard_D64s_v3 | |
Standard_DS4_v2 | |
Standard_DS5_v2 | |
Standard_F8s_v2 | |
Standard_F16s_v2 | |
Standard_F32s_v2 | |
Standard_F64s_v2 | |
Standard_F72s_v2 | |
Standard_F8s | |
Standard_F16s | |
Standard_E4s_v3 | |
Standard_E8s_v3 | |
Standard_E16s_v3 | |
Standard_E20s_v3 | |
Standard_E32s_v3 | |
Standard_E64s_v3 | |
Standard_GS2 | |
Standard_GS3 | |
Standard_GS4 | |
Standard_GS5 | |
Standard_DS12_v2 | |
Standard_DS13_v2 | |
Standard_DS14_v2 | |
Standard_DS15_v2 | |
Standard_L4s | |
Standard_L8s | |
Standard_L16s | |
Standard_L32s |
OpenShiftManagedCluster
OpenShift Managed cluster.
Name | Type | Description |
---|---|---|
id |
string |
Resource Id |
location |
string |
Resource location |
name |
string |
Resource name |
plan |
Define the resource plan as required by ARM for billing purposes |
|
properties.agentPoolProfiles |
Configuration of OpenShift cluster VMs. |
|
properties.authProfile |
Configures OpenShift authentication. |
|
properties.clusterVersion |
string |
Version of OpenShift specified when creating the cluster. |
properties.fqdn |
string |
Service generated FQDN for OpenShift API server loadbalancer internal hostname. |
properties.masterPoolProfile |
Configuration for OpenShift master VMs. |
|
properties.networkProfile |
Configuration for OpenShift networking. |
|
properties.openShiftVersion |
string |
Version of OpenShift specified when creating the cluster. |
properties.provisioningState |
string |
The current deployment or provisioning state, which only appears in the response. |
properties.publicHostname |
string |
Service generated FQDN for OpenShift API server. |
properties.routerProfiles |
Configuration for OpenShift router(s). |
|
tags |
object |
Resource tags |
type |
string |
Resource type |
OpenShiftManagedClusterAADIdentityProvider
Defines the Identity provider for MS AAD.
Name | Type | Description |
---|---|---|
clientId |
string |
The clientId password associated with the provider. |
customerAdminGroupId |
string |
The groupId to be granted cluster admin role. |
kind |
string:
AADIdentity |
The kind of the provider. |
secret |
string |
The secret password associated with the provider. |
tenantId |
string |
The tenantId associated with the provider. |
OpenShiftManagedClusterAgentPoolProfile
Defines the configuration of the OpenShift cluster VMs.
Name | Type | Default value | Description |
---|---|---|---|
count |
integer (int32) |
Number of agents (VMs) to host docker containers. |
|
name |
string |
Unique name of the pool profile in the context of the subscription and resource group. |
|
osType | Linux |
OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux. |
|
role |
Define the role of the AgentPoolProfile. |
||
subnetCidr |
string |
10.0.0.0/24 |
Subnet CIDR for the peering. |
vmSize |
Size of agent VMs. |
OpenShiftManagedClusterAuthProfile
Defines all possible authentication profiles for the OpenShift cluster.
Name | Type | Description |
---|---|---|
identityProviders |
Type of authentication profile to use. |
OpenShiftManagedClusterIdentityProvider
Defines the configuration of the identity providers to be used in the OpenShift cluster.
Name | Type | Description |
---|---|---|
name |
string |
Name of the provider. |
provider | OpenShiftManagedClusterBaseIdentityProvider: |
Configuration of the provider. |
OpenShiftManagedClusterListResult
The response from the List OpenShift Managed Clusters operation.
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to get the next set of OpenShift managed cluster results. |
value |
The list of OpenShift managed clusters. |
OpenShiftManagedClusterMasterPoolProfile
OpenShiftManagedClusterMaterPoolProfile contains configuration for OpenShift master VMs.
Name | Type | Default value | Description |
---|---|---|---|
count |
integer (int32) |
Number of masters (VMs) to host docker containers. The default value is 3. |
|
name |
string |
Unique name of the master pool profile in the context of the subscription and resource group. |
|
osType | Linux |
OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux. |
|
subnetCidr |
string |
Subnet CIDR for the peering. |
|
vmSize |
Size of agent VMs. |
OpenShiftRouterProfile
Represents an OpenShift router
Name | Type | Description |
---|---|---|
fqdn |
string |
Auto-allocated FQDN for the OpenShift router. |
name |
string |
Name of the router profile. |
publicSubdomain |
string |
DNS subdomain for OpenShift router. |
OSType
OsType to be used to specify os type. Choose from Linux and Windows. Default to Linux.
Value | Description |
---|---|
Linux | |
Windows |
PurchasePlan
Used for establishing the purchase context of any 3rd Party artifact through MarketPlace.
Name | Type | Description |
---|---|---|
name |
string |
The plan ID. |
product |
string |
Specifies the product of the image from the marketplace. This is the same value as Offer under the imageReference element. |
promotionCode |
string |
The promotion code. |
publisher |
string |
The plan ID. |