Get Kubernetes Versions - Get Kubernetes Versions
Lists the supported kubernetes versions for the specified custom location
GET https://management.azure.com/{customLocationResourceUri}/providers/Microsoft.HybridContainerService/kubernetesVersions/default?api-version=2024-01-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
custom
|
path | True |
string |
The fully qualified Azure Resource Manager identifier of the custom location resource. |
api-version
|
query | True |
string minLength: 1 |
The API version to use for this operation. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Lists the supported kubernetes versions for the specified custom location |
|
Other Status Codes |
Error response describing why the operation failed. |
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
GetKubernetesVersions
Sample request
GET https://management.azure.com/subscriptions/a3e42606-29b1-4d7d-b1d9-9ff6b9d3c71b/resourceGroups/test-arcappliance-resgrp/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation/providers/Microsoft.HybridContainerService/kubernetesVersions/default?api-version=2024-01-01
Sample response
{
"id": "/subscriptions/a3e42606-29b1-4d7d-b1d9-9ff6b9d3c71b/resourceGroups/test-arcappliance-resgrp/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation/providers/Microsoft.HybridContainerService/kubernetesVersions/default",
"name": "default",
"type": "microsoft.hybridcontainerservice/kubernetesVersions",
"extendedLocation": {
"name": "/subscriptions/a3e42606-29b1-4d7d-b1d9-9ff6b9d3c71b/resourcegroups/test-arcappliance-resgrp/providers/microsoft.extendedlocation/customlocations/testcustomlocation",
"type": "CustomLocation"
},
"properties": {
"provisioningState": "Succeeded",
"values": [
{
"version": "1.23",
"isPreview": false,
"patchVersions": {
"1.23.12": {
"readiness": [
{
"osType": "Linux",
"osSku": "CBLMariner",
"ready": true
},
{
"osType": "Windows",
"osSku": "Windows",
"ready": true
},
{
"osType": "Windows",
"osSku": "Windows2022",
"ready": false,
"errorMessage": "Not Ready. Reasons: Failed to find proudct stream windoes2022 in release aks-hybrid-catalog-stable-int"
}
],
"upgrades": [
"1.23.13"
]
},
"1.23.13": {
"readiness": [
{
"osType": "Linux",
"osSku": "CBLMariner",
"ready": true
},
{
"osType": "Windows",
"osSku": "Windows2019",
"ready": true
},
{
"osType": "Windows",
"osSku": "Windows2022",
"ready": true
}
],
"upgrades": []
}
}
}
]
}
}
Definitions
Name | Description |
---|---|
created |
The type of identity that created the resource. |
Credential |
The credential result response. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Extended |
Extended location pointing to the underlying infrastructure |
Extended |
The extended location type. Allowed value: 'CustomLocation' |
Kubernetes |
The supported kubernetes versions. |
Properties | |
system |
Metadata pertaining to creation and last modification of the resource. |
createdByType
The type of identity that created the resource.
Value | Description |
---|---|
User | |
Application | |
ManagedIdentity | |
Key |
CredentialResult
The credential result response.
Name | Type | Description |
---|---|---|
name |
string |
The name of the credential. |
value |
string (byte) |
Base64-encoded Kubernetes configuration file. |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
ExtendedLocation
Extended location pointing to the underlying infrastructure
Name | Type | Description |
---|---|---|
name |
string |
ARM Id of the extended location. |
type |
The extended location type. Allowed value: 'CustomLocation' |
ExtendedLocationTypes
The extended location type. Allowed value: 'CustomLocation'
Value | Description |
---|---|
CustomLocation |
KubernetesVersionProfile
The supported kubernetes versions.
Name | Type | Description |
---|---|---|
extendedLocation |
Extended location pointing to the underlying infrastructure |
|
id |
string (arm-id) |
Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
The name of the resource |
properties | ||
systemData |
Azure Resource Manager metadata containing createdBy and modifiedBy information. |
|
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
Properties
Name | Type | Description |
---|---|---|
kubeconfigs |
Base64-encoded Kubernetes configuration file. |
systemData
Metadata pertaining to creation and last modification of the resource.
Name | Type | Description |
---|---|---|
createdAt |
string (date-time) |
The timestamp of resource creation (UTC). |
createdBy |
string |
The identity that created the resource. |
createdByType |
The type of identity that created the resource. |
|
lastModifiedAt |
string (date-time) |
The timestamp of resource last modification (UTC) |
lastModifiedBy |
string |
The identity that last modified the resource. |
lastModifiedByType |
The type of identity that last modified the resource. |