Microsoft.ContainerService (stable:2025-03-01)

2025/03/31 • 29 new methods

Operations_List (new)
Description :  List the operations for the provider
Reference :  Link ¶

⚼ Request

GET:  /providers/Microsoft.ContainerService/operations
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of operations supported by the resource provider ,
Required: False ,
}
[
{
name:
{
Description: The name of the operation, as per Resource-Based Access Control (RBAC). Examples: "Microsoft.Compute/virtualMachines/write", "Microsoft.Compute/virtualMachines/capture/action" ,
Required: False ,
}
string ,
isDataAction:
{
Description: Whether the operation applies to data-plane. This is "true" for data-plane operations and "false" for ARM/control-plane operations. ,
Required: False ,
}
boolean ,
display:
{
Description: Localized display information for this particular operation. ,
Required: False ,
}
{
provider:
{
Description: The localized friendly form of the resource provider name, e.g. "Microsoft Monitoring Insights" or "Microsoft Compute". ,
Required: False ,
}
string ,
resource:
{
Description: The localized friendly name of the resource type related to this operation. E.g. "Virtual Machines" or "Job Schedule Collections". ,
Required: False ,
}
string ,
operation:
{
Description: The concise, localized friendly name for the operation; suitable for dropdowns. E.g. "Create or Update Virtual Machine", "Restart Virtual Machine". ,
Required: False ,
}
string ,
description:
{
Description: The short, localized friendly description of the operation; suitable for tool tips and detailed views. ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is "user,system" ,
Enum:
{
user: No description available. ,
system: No description available. ,
user,system: No description available. ,
}
,
Required: False ,
}
enum ,
actionType:
{
Description: Enum. Indicates the action type. "Internal" refers to actions that are for internal only APIs. ,
Enum:
{
Internal: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results (if there are any). ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_ListBySubscription (new)
Description :  Lists fleets in the specified subscription.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/fleets
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The Fleet items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_ListByResourceGroup (new)
Description :  Lists fleets in the specified subscription and resource group.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The Fleet items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_Get (new)
Description :  Gets a Fleet.
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_CreateOrUpdate (new)
Description :  Creates or updates a Fleet.
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: The request should only proceed if no entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (201)

{
$headers:
{
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: The Fleet resource. ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_Update (new)
Description :  Update a Fleet
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
properties:
{
Description: The resource properties to be updated. ,
Required: True ,
}
{
tags:
{
Description: Resource tags. ,
Required: False ,
}
object ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Creating: The provisioning state of a fleet being created. ,
Updating: The provisioning state of a fleet being updated. ,
Deleting: The provisioning state of a fleet being deleted. ,
}
,
Required: False ,
}
enum ,
hubProfile:
{
Description: The FleetHubProfile configures the Fleet's hub. ,
Required: False ,
}
{
dnsPrefix:
{
Description: DNS prefix used to create the FQDN for the Fleet hub. ,
Required: False ,
}
string ,
apiServerAccessProfile:
{
Description: The access profile for the Fleet hub API server. ,
Required: False ,
}
{
enablePrivateCluster:
{
Description: Whether to create the Fleet hub as a private cluster or not. ,
Required: False ,
}
boolean ,
enableVnetIntegration:
{
Description: Whether to enable apiserver vnet integration for the Fleet hub or not. ,
Required: False ,
}
boolean ,
subnetId:
{
Description: The subnet to be used when apiserver vnet integration is enabled. It is required when creating a new Fleet with BYO vnet. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
agentProfile:
{
Description: The agent profile for the Fleet hub. ,
Required: False ,
}
{
subnetId:
{
Description: The ID of the subnet which the Fleet hub node will join on startup. If this is not specified, a vnet and subnet will be generated and used. ,
Format: arm-id ,
Required: False ,
}
string ,
vmSize:
{
Description: The virtual machine size of the Fleet hub. ,
Required: False ,
}
string ,
}
,
fqdn:
{
Description: The FQDN of the Fleet hub. ,
Required: False ,
}
string ,
kubernetesVersion:
{
Description: The Kubernetes version of the Fleet hub. ,
Required: False ,
}
string ,
portalFqdn:
{
Description: The Azure Portal FQDN of the Fleet hub. ,
Required: False ,
}
string ,
}
,
status:
{
Description: Status information for the fleet. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet. ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error for the fleet. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
identity:
{
Description: Managed identity. ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_Delete (new)
Description :  Delete a Fleet
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AutoUpgradeProfiles_ListByFleet (new)
Description :  List AutoUpgradeProfile resources by Fleet
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/autoUpgradeProfiles
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The AutoUpgradeProfile items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the AutoUpgradeProfile resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. ,
Format: arm-id ,
Required: False ,
}
string ,
channel:
{
Description: Configures how auto-upgrade will be run. ,
Enum:
{
Stable: Upgrades the clusters kubernetes version to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster runs version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, the cluster upgrades to 1.18.6. ,
Rapid: Upgrades the clusters kubernetes version to the latest supported patch release on the latest supported minor version. ,
NodeImage: Upgrade node image version of the clusters. ,
}
,
Required: True ,
}
enum ,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target clusters in auto upgrade. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
}
,
Required: True ,
}
enum ,
}
,
disabled:
{
Description: If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule. If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters. This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile. By default, this is set to False. ,
Required: False ,
}
boolean ,
autoUpgradeProfileStatus:
{
Description: The status of the auto upgrade profile. ,
Required: False ,
}
{
lastTriggeredAt:
{
Description: The UTC time of the last attempt to automatically create and start an UpdateRun as triggered by the release of new versions. ,
Format: date-time ,
Required: False ,
}
string ,
lastTriggerStatus:
{
Description: The status of the last AutoUpgrade trigger. ,
Enum:
{
Succeeded: The last AutoUpgrade trigger was succeeded. ,
Failed: The last AutoUpgrade trigger failed. ,
}
,
Required: False ,
}
enum ,
lastTriggerError:
{
Description: The error details of the last trigger. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
lastTriggerUpgradeVersions:
{
Description: The target Kubernetes version or node image versions of the last trigger. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AutoUpgradeProfiles_Get (new)
Description :  Get a AutoUpgradeProfile
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/autoUpgradeProfiles/{autoUpgradeProfileName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
autoUpgradeProfileName:
{
Description: The name of the AutoUpgradeProfile resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the AutoUpgradeProfile resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. ,
Format: arm-id ,
Required: False ,
}
string ,
channel:
{
Description: Configures how auto-upgrade will be run. ,
Enum:
{
Stable: Upgrades the clusters kubernetes version to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster runs version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, the cluster upgrades to 1.18.6. ,
Rapid: Upgrades the clusters kubernetes version to the latest supported patch release on the latest supported minor version. ,
NodeImage: Upgrade node image version of the clusters. ,
}
,
Required: True ,
}
enum ,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target clusters in auto upgrade. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
}
,
Required: True ,
}
enum ,
}
,
disabled:
{
Description: If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule. If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters. This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile. By default, this is set to False. ,
Required: False ,
}
boolean ,
autoUpgradeProfileStatus:
{
Description: The status of the auto upgrade profile. ,
Required: False ,
}
{
lastTriggeredAt:
{
Description: The UTC time of the last attempt to automatically create and start an UpdateRun as triggered by the release of new versions. ,
Format: date-time ,
Required: False ,
}
string ,
lastTriggerStatus:
{
Description: The status of the last AutoUpgrade trigger. ,
Enum:
{
Succeeded: The last AutoUpgrade trigger was succeeded. ,
Failed: The last AutoUpgrade trigger failed. ,
}
,
Required: False ,
}
enum ,
lastTriggerError:
{
Description: The error details of the last trigger. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
lastTriggerUpgradeVersions:
{
Description: The target Kubernetes version or node image versions of the last trigger. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AutoUpgradeProfiles_CreateOrUpdate (new)
Description :  Create a AutoUpgradeProfile
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/autoUpgradeProfiles/{autoUpgradeProfileName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: The request should only proceed if no entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
autoUpgradeProfileName:
{
Description: The name of the AutoUpgradeProfile resource. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the AutoUpgradeProfile resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. ,
Format: arm-id ,
Required: False ,
}
string ,
channel:
{
Description: Configures how auto-upgrade will be run. ,
Enum:
{
Stable: Upgrades the clusters kubernetes version to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster runs version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, the cluster upgrades to 1.18.6. ,
Rapid: Upgrades the clusters kubernetes version to the latest supported patch release on the latest supported minor version. ,
NodeImage: Upgrade node image version of the clusters. ,
}
,
Required: True ,
}
enum ,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target clusters in auto upgrade. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
}
,
Required: True ,
}
enum ,
}
,
disabled:
{
Description: If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule. If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters. This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile. By default, this is set to False. ,
Required: False ,
}
boolean ,
autoUpgradeProfileStatus:
{
Description: The status of the auto upgrade profile. ,
Required: False ,
}
{
lastTriggeredAt:
{
Description: The UTC time of the last attempt to automatically create and start an UpdateRun as triggered by the release of new versions. ,
Format: date-time ,
Required: False ,
}
string ,
lastTriggerStatus:
{
Description: The status of the last AutoUpgrade trigger. ,
Enum:
{
Succeeded: The last AutoUpgrade trigger was succeeded. ,
Failed: The last AutoUpgrade trigger failed. ,
}
,
Required: False ,
}
enum ,
lastTriggerError:
{
Description: The error details of the last trigger. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
lastTriggerUpgradeVersions:
{
Description: The target Kubernetes version or node image versions of the last trigger. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the AutoUpgradeProfile resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. ,
Format: arm-id ,
Required: False ,
}
string ,
channel:
{
Description: Configures how auto-upgrade will be run. ,
Enum:
{
Stable: Upgrades the clusters kubernetes version to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster runs version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, the cluster upgrades to 1.18.6. ,
Rapid: Upgrades the clusters kubernetes version to the latest supported patch release on the latest supported minor version. ,
NodeImage: Upgrade node image version of the clusters. ,
}
,
Required: True ,
}
enum ,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target clusters in auto upgrade. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
}
,
Required: True ,
}
enum ,
}
,
disabled:
{
Description: If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule. If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters. This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile. By default, this is set to False. ,
Required: False ,
}
boolean ,
autoUpgradeProfileStatus:
{
Description: The status of the auto upgrade profile. ,
Required: False ,
}
{
lastTriggeredAt:
{
Description: The UTC time of the last attempt to automatically create and start an UpdateRun as triggered by the release of new versions. ,
Format: date-time ,
Required: False ,
}
string ,
lastTriggerStatus:
{
Description: The status of the last AutoUpgrade trigger. ,
Enum:
{
Succeeded: The last AutoUpgrade trigger was succeeded. ,
Failed: The last AutoUpgrade trigger failed. ,
}
,
Required: False ,
}
enum ,
lastTriggerError:
{
Description: The error details of the last trigger. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
lastTriggerUpgradeVersions:
{
Description: The target Kubernetes version or node image versions of the last trigger. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
$headers:
{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: The AutoUpgradeProfile resource. ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the AutoUpgradeProfile resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the UpdateStrategy resource to reference. If not specified, the auto upgrade will run on all clusters which are members of the fleet. ,
Format: arm-id ,
Required: False ,
}
string ,
channel:
{
Description: Configures how auto-upgrade will be run. ,
Enum:
{
Stable: Upgrades the clusters kubernetes version to the latest supported patch release on minor version N-1, where N is the latest supported minor version. For example, if a cluster runs version 1.17.7 and versions 1.17.9, 1.18.4, 1.18.6, and 1.19.1 are available, the cluster upgrades to 1.18.6. ,
Rapid: Upgrades the clusters kubernetes version to the latest supported patch release on the latest supported minor version. ,
NodeImage: Upgrade node image version of the clusters. ,
}
,
Required: True ,
}
enum ,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target clusters in auto upgrade. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
}
,
Required: True ,
}
enum ,
}
,
disabled:
{
Description: If set to False: the auto upgrade has effect - target managed clusters will be upgraded on schedule. If set to True: the auto upgrade has no effect - no upgrade will be run on the target managed clusters. This is a boolean and not an enum because enabled/disabled are all available states of the auto upgrade profile. By default, this is set to False. ,
Required: False ,
}
boolean ,
autoUpgradeProfileStatus:
{
Description: The status of the auto upgrade profile. ,
Required: False ,
}
{
lastTriggeredAt:
{
Description: The UTC time of the last attempt to automatically create and start an UpdateRun as triggered by the release of new versions. ,
Format: date-time ,
Required: False ,
}
string ,
lastTriggerStatus:
{
Description: The status of the last AutoUpgrade trigger. ,
Enum:
{
Succeeded: The last AutoUpgrade trigger was succeeded. ,
Failed: The last AutoUpgrade trigger failed. ,
}
,
Required: False ,
}
enum ,
lastTriggerError:
{
Description: The error details of the last trigger. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
lastTriggerUpgradeVersions:
{
Description: The target Kubernetes version or node image versions of the last trigger. ,
Required: False ,
}
[
string ,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AutoUpgradeProfiles_Delete (new)
Description :  Delete a AutoUpgradeProfile
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/autoUpgradeProfiles/{autoUpgradeProfileName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
autoUpgradeProfileName:
{
Description: The name of the AutoUpgradeProfile resource. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AutoUpgradeProfileOperations_GenerateUpdateRun (new)
Description :  A long-running resource action.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/autoUpgradeProfiles/{autoUpgradeProfileName}/generateUpdateRun
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
autoUpgradeProfileName:
{
Description: The name of the AutoUpgradeProfile resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
id:
{
Description: The ARM resource id of the generated UpdateRun. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}'. ,
Required: True ,
}
string ,
}

⚐ Response (202)

{
azure-asyncoperation:
{
Description: A link to the status monitor ,
}
string ,
if-match:
{
Description: The request should only proceed if an entity matches this string. ,
}
string ,
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Fleets_ListCredentials (new)
Description :  Lists the user credentials of a Fleet.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/listCredentials
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
kubeconfigs:
{
Description: Array of base64-encoded Kubernetes configuration files. ,
Required: False ,
}
[
{
name:
{
Description: The name of the credential. ,
Required: False ,
}
string ,
value:
{
Description: Base64-encoded Kubernetes configuration file. ,
Format: byte ,
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetMembers_ListByFleet (new)
Description :  List FleetMember resources by Fleet
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/members
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The FleetMember items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
clusterResourceId:
{
Description: The ARM resource id of the cluster that joins the Fleet. Must be a valid Azure resource id. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{clusterName}'. ,
Format: arm-id ,
Required: True ,
}
string ,
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Joining: The provisioning state of a member joining a fleet. ,
Leaving: The provisioning state of a member leaving a fleet. ,
Updating: The provisioning state of a member being updated. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status information of the last operation for fleet member. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet member ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error of the fleet member ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetMembers_Get (new)
Description :  Get a FleetMember
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/members/{fleetMemberName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
fleetMemberName:
{
Description: The name of the Fleet member resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
clusterResourceId:
{
Description: The ARM resource id of the cluster that joins the Fleet. Must be a valid Azure resource id. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{clusterName}'. ,
Format: arm-id ,
Required: True ,
}
string ,
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Joining: The provisioning state of a member joining a fleet. ,
Leaving: The provisioning state of a member leaving a fleet. ,
Updating: The provisioning state of a member being updated. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status information of the last operation for fleet member. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet member ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error of the fleet member ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetMembers_Create (new)
Description :  Create a FleetMember
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/members/{fleetMemberName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: The request should only proceed if no entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
fleetMemberName:
{
Description: The name of the Fleet member resource. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
clusterResourceId:
{
Description: The ARM resource id of the cluster that joins the Fleet. Must be a valid Azure resource id. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{clusterName}'. ,
Format: arm-id ,
Required: True ,
}
string ,
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Joining: The provisioning state of a member joining a fleet. ,
Leaving: The provisioning state of a member leaving a fleet. ,
Updating: The provisioning state of a member being updated. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status information of the last operation for fleet member. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet member ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error of the fleet member ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
clusterResourceId:
{
Description: The ARM resource id of the cluster that joins the Fleet. Must be a valid Azure resource id. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{clusterName}'. ,
Format: arm-id ,
Required: True ,
}
string ,
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Joining: The provisioning state of a member joining a fleet. ,
Leaving: The provisioning state of a member leaving a fleet. ,
Updating: The provisioning state of a member being updated. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status information of the last operation for fleet member. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet member ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error of the fleet member ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
$headers:
{
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: A member of the Fleet. It contains a reference to an existing Kubernetes cluster on Azure. ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
clusterResourceId:
{
Description: The ARM resource id of the cluster that joins the Fleet. Must be a valid Azure resource id. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{clusterName}'. ,
Format: arm-id ,
Required: True ,
}
string ,
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Joining: The provisioning state of a member joining a fleet. ,
Leaving: The provisioning state of a member leaving a fleet. ,
Updating: The provisioning state of a member being updated. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status information of the last operation for fleet member. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet member ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error of the fleet member ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetMembers_Update (new)
Description :  Update a FleetMember
Reference :  Link ¶

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/members/{fleetMemberName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
fleetMemberName:
{
Description: The name of the Fleet member resource. ,
Required: True ,
}
string ,
properties:
{
Description: The resource properties to be updated. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
clusterResourceId:
{
Description: The ARM resource id of the cluster that joins the Fleet. Must be a valid Azure resource id. e.g.: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{clusterName}'. ,
Format: arm-id ,
Required: True ,
}
string ,
group:
{
Description: The group this member belongs to for multi-cluster update management. ,
Required: False ,
}
string ,
provisioningState:
{
Description: The status of the last operation. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
Joining: The provisioning state of a member joining a fleet. ,
Leaving: The provisioning state of a member leaving a fleet. ,
Updating: The provisioning state of a member being updated. ,
}
,
Required: False ,
}
enum ,
status:
{
Description: Status information of the last operation for fleet member. ,
Required: False ,
}
{
lastOperationId:
{
Description: The last operation ID for the fleet member ,
Required: False ,
}
string ,
lastOperationError:
{
Description: The last operation error of the fleet member ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetMembers_Delete (new)
Description :  Delete a FleetMember
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/members/{fleetMemberName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
fleetMemberName:
{
Description: The name of the Fleet member resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_ListByFleet (new)
Description :  List UpdateRun resources by Fleet
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The UpdateRun items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_Get (new)
Description :  Get a UpdateRun
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateRunName:
{
Description: The name of the UpdateRun resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_CreateOrUpdate (new)
Description :  Create a UpdateRun
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: The request should only proceed if no entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateRunName:
{
Description: The name of the UpdateRun resource. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
$headers:
{
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: A multi-stage process to perform update operations across members of a Fleet. ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_Delete (new)
Description :  Delete a UpdateRun
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateRunName:
{
Description: The name of the UpdateRun resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_Skip (new)
Description :  Skips one or a combination of member/group/stage/afterStageWait(s) of an update run.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/skip
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateRunName:
{
Description: The name of the UpdateRun resource. ,
Required: True ,
}
string ,
body:
{
Description: The content of the action request ,
Required: True ,
}
{
targets:
{
Description: The targets to skip. ,
Required: True ,
}
[
{
type:
{
Description: The skip target type. ,
Enum:
{
Member: Skip the update of a member. ,
Group: Skip the update of a group. ,
Stage: Skip the update of an entire stage including the after stage wait. ,
AfterStageWait: Skip the update of the after stage wait of a certain stage. ,
}
,
Required: True ,
}
enum ,
name:
{
Description: The skip target's name. To skip a member/group/stage, use the member/group/stage's name; Tp skip an after stage wait, use the parent stage's name. ,
Required: True ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_Start (new)
Description :  Starts an UpdateRun.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/start
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateRunName:
{
Description: The name of the UpdateRun resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
UpdateRuns_Stop (new)
Description :  Stops an UpdateRun.
Reference :  Link ¶

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/stop
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateRunName:
{
Description: The name of the UpdateRun resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateRun resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
updateStrategyId:
{
Description: The resource id of the FleetUpdateStrategy resource to reference. When creating a new run, there are three ways to define a strategy for the run: 1. Define a new strategy in place: Set the "strategy" field. 2. Use an existing strategy: Set the "updateStrategyId" field. (since 2023-08-15-preview) 3. Use the default strategy to update all the members one by one: Leave both "updateStrategyId" and "strategy" unset. (since 2023-08-15-preview) Setting both "updateStrategyId" and "strategy" is invalid. UpdateRuns created by "updateStrategyId" snapshot the referenced UpdateStrategy at the time of creation and store it in the "strategy" field. Subsequent changes to the referenced FleetUpdateStrategy resource do not propagate. UpdateRunStrategy changes can be made directly on the "strategy" field before launching the UpdateRun. ,
Format: arm-id ,
Required: False ,
}
string ,
strategy:
{
Description: The strategy defines the order in which the clusters will be updated. If not set, all members will be updated sequentially. The UpdateRun status will show a single UpdateStage and a single UpdateGroup targeting all members. The strategy of the UpdateRun can be modified until the run is started. ,
Required: False ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
managedClusterUpdate:
{
Description: The update to be applied to all clusters in the UpdateRun. The managedClusterUpdate can be modified until the run is started. ,
Required: True ,
}
{
upgrade:
{
Description: The upgrade to apply to the ManagedClusters. ,
Required: True ,
}
{
type:
{
Description: ManagedClusterUpgradeType is the type of upgrade to be applied. ,
Enum:
{
Full: Full upgrades the control plane and all agent pools of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
NodeImageOnly: NodeImageOnly upgrades only the node images of the target ManagedClusters. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to NOT be set. ,
ControlPlaneOnly: ControlPlaneOnly upgrades only targets the KubernetesVersion of the ManagedClusters and will not be applied to the AgentPool. Requires the ManagedClusterUpgradeSpec.KubernetesVersion property to be set. ,
}
,
Required: True ,
}
enum ,
kubernetesVersion:
{
Description: The Kubernetes version to upgrade the member clusters to. ,
Required: False ,
}
string ,
}
,
nodeImageSelection:
{
Description: The node image upgrade to be applied to the target nodes in update run. ,
Required: False ,
}
{
type:
{
Description: The node image upgrade type. ,
Enum:
{
Latest: Use the latest image version when upgrading nodes. Clusters may use different image versions (e.g., 'AKSUbuntu-1804gen2containerd-2021.10.12' and 'AKSUbuntu-1804gen2containerd-2021.10.19') because, for example, the latest available version is different in different regions. ,
Consistent: The image versions to upgrade nodes to are selected as described below: for each node pool in managed clusters affected by the update run, the system selects the latest image version such that it is available across all other node pools (in all other clusters) of the same image type. As a result, all node pools of the same image type will be upgraded to the same image version. For example, if the latest image version for image type 'AKSUbuntu-1804gen2containerd' is 'AKSUbuntu-1804gen2containerd-2021.10.12' for a node pool in cluster A in region X, and is 'AKSUbuntu-1804gen2containerd-2021.10.17' for a node pool in cluster B in region Y, the system will upgrade both node pools to image version 'AKSUbuntu-1804gen2containerd-2021.10.12'. ,
Custom: Upgrade the nodes to the custom image versions. When set, update run will use node image versions provided in customNodeImageVersions to upgrade the nodes. If set, customNodeImageVersions must not be empty. ,
}
,
Required: True ,
}
enum ,
customNodeImageVersions:
{
Description: Custom node image versions to upgrade the nodes to. This field is required if node image selection type is Custom. Otherwise, it must be empty. For each node image family (e.g., 'AKSUbuntu-1804gen2containerd'), this field can contain at most one version (e.g., only one of 'AKSUbuntu-1804gen2containerd-2023.01.12' or 'AKSUbuntu-1804gen2containerd-2023.02.12', not both). If the nodes belong to a family without a matching image version in this field, they are not upgraded. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
status:
{
Description: The status of the UpdateRun. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
stages:
{
Description: The stages composing an update run. Stages are run sequentially withing an UpdateRun. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateStage. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateStage. ,
Required: False ,
}
string ,
groups:
{
Description: The list of groups to be updated as part of this UpdateStage. ,
Required: False ,
}
[
{
status:
{
Description: The status of the UpdateGroup. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the UpdateGroup. ,
Required: False ,
}
string ,
members:
{
Description: The list of member this UpdateGroup updates. ,
Required: False ,
}
[
{
status:
{
Description: The status of the MemberUpdate operation. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
name:
{
Description: The name of the FleetMember. ,
Required: False ,
}
string ,
clusterResourceId:
{
Description: The Azure resource id of the target Kubernetes cluster. ,
Required: False ,
}
string ,
operationId:
{
Description: The operation resource id of the latest attempt to perform the operation. ,
Required: False ,
}
string ,
message:
{
Description: The status message after processing the member update operation. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
afterStageWaitStatus:
{
Description: The status of the wait period configured on the UpdateStage. ,
Required: False ,
}
{
status:
{
Description: The status of the wait duration. ,
Required: False ,
}
{
startTime:
{
Description: The time the operation or group was started. ,
Format: date-time ,
Required: False ,
}
string ,
completedTime:
{
Description: The time the operation or group was completed. ,
Format: date-time ,
Required: False ,
}
string ,
state:
{
Description: The State of the operation or group. ,
Enum:
{
NotStarted: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has not been started. ,
Running: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is running. ,
Stopping: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that is being stopped. ,
Stopped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has stopped. ,
Skipped: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has been skipped. ,
Failed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has failed. ,
Completed: The state of an UpdateRun/UpdateStage/UpdateGroup/MemberUpdate that has completed. ,
}
,
Required: False ,
}
enum ,
error:
{
Description: The error details when a failure is encountered. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
,
waitDurationInSeconds:
{
Description: The wait duration configured in seconds. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
}
,
]
,
nodeImageSelection:
{
Description: The node image upgrade specs for the update run. It is only set in update run when `NodeImageSelection.type` is `Consistent`. ,
Required: False ,
}
{
selectedNodeImageVersions:
{
Description: The image versions to upgrade the nodes to. ,
Required: False ,
}
[
{
version:
{
Description: The image version to upgrade the nodes to (e.g., 'AKSUbuntu-1804gen2containerd-2022.12.13'). ,
Required: False ,
}
string ,
}
,
]
,
}
,
}
,
autoUpgradeProfileId:
{
Description: AutoUpgradeProfileId is the id of an auto upgrade profile resource. ,
Format: arm-id ,
Required: False ,
}
string ,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetUpdateStrategies_ListByFleet (new)
Description :  List FleetUpdateStrategy resources by Fleet
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The FleetUpdateStrategy items on this page ,
Required: True ,
}
[
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateStrategy resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
strategy:
{
Description: Defines the update sequence of the clusters. ,
Required: True ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: The link to the next page of items ,
Format: uri ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetUpdateStrategies_Get (new)
Description :  Get a FleetUpdateStrategy
Reference :  Link ¶

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies/{updateStrategyName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateStrategyName:
{
Description: The name of the UpdateStrategy resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateStrategy resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
strategy:
{
Description: Defines the update sequence of the clusters. ,
Required: True ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetUpdateStrategies_CreateOrUpdate (new)
Description :  Create a FleetUpdateStrategy
Reference :  Link ¶

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies/{updateStrategyName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
If-None-Match:
{
Description: The request should only proceed if no entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateStrategyName:
{
Description: The name of the UpdateStrategy resource. ,
Required: True ,
}
string ,
resource:
{
Description: Resource create parameters. ,
Required: True ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateStrategy resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
strategy:
{
Description: Defines the update sequence of the clusters. ,
Required: True ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateStrategy resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
strategy:
{
Description: Defines the update sequence of the clusters. ,
Required: True ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
$headers:
{
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}
,
$schema:
{
Description: Defines a multi-stage process to perform update operations across members of a Fleet. ,
}
{
properties:
{
Description: The resource-specific properties for this resource. ,
Required: False ,
}
{
provisioningState:
{
Description: The provisioning state of the UpdateStrategy resource. ,
Enum:
{
Succeeded: Resource has been created. ,
Failed: Resource creation failed. ,
Canceled: Resource creation was canceled. ,
}
,
Required: False ,
}
enum ,
strategy:
{
Description: Defines the update sequence of the clusters. ,
Required: True ,
}
{
stages:
{
Description: The list of stages that compose this update run. Min size: 1. ,
Required: True ,
}
[
{
name:
{
Description: The name of the stage. Must be unique within the UpdateRun. ,
Required: True ,
}
string ,
groups:
{
Description: Defines the groups to be executed in parallel in this stage. Duplicate groups are not allowed. Min size: 1. ,
Required: False ,
}
[
{
name:
{
Description: Name of the group. It must match a group name of an existing fleet member. ,
Required: True ,
}
string ,
}
,
]
,
afterStageWaitInSeconds:
{
Description: The time in seconds to wait at the end of this stage before starting the next one. Defaults to 0 seconds if unspecified. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
eTag:
{
Description: If eTag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
FleetUpdateStrategies_Delete (new)
Description :  Delete a FleetUpdateStrategy
Reference :  Link ¶

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateStrategies/{updateStrategyName}
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: The name of the resource group. The name is case insensitive. ,
Required: True ,
}
string ,
If-Match:
{
Description: The request should only proceed if an entity matches this string. ,
Required: False ,
}
string ,
fleetName:
{
Description: The name of the Fleet resource. ,
Required: True ,
}
string ,
updateStrategyName:
{
Description: The name of the UpdateStrategy resource. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location:
{
Description: The Location header contains the URL where the status of the long running operation can be checked. ,
}
string ,
retry-after:
{
Description: The Retry-After header can indicate how long the client should wait before polling the operation status. ,
}
integer ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}