From 100f68352cef3a35fcf2605af1136dd6b39f42c7 Mon Sep 17 00:00:00 2001 From: zman-ms <99997769+zman-ms@users.noreply.github.com> Date: Thu, 18 Jan 2024 14:15:29 -0800 Subject: [PATCH] [Fleet] UpdateRun manual skip (#27323) * manual skip API * copied examples * fix typo * fix example * add missing examples * add missing examples * fix examples * fix examples * fix examples * fix examples * fix examples * fix examples * fix examples * add fleet hub profile back * custom-words --- custom-words.txt | 1 + .../FleetMembers_Create.json | 68 ++++++ .../FleetMembers_Delete.json | 21 ++ .../2024-02-02-preview/FleetMembers_Get.json | 36 ++++ .../FleetMembers_ListByFleet.json | 37 ++++ .../FleetMembers_Update.json | 48 +++++ .../Fleets_CreateOrUpdate.json | 103 +++++++++ .../2024-02-02-preview/Fleets_Delete.json | 20 ++ .../2024-02-02-preview/Fleets_Get.json | 48 +++++ .../Fleets_ListByResourceGroup.json | 49 +++++ .../2024-02-02-preview/Fleets_ListBySub.json | 48 +++++ .../Fleets_ListCredentialsResult.json | 22 ++ .../2024-02-02-preview/Fleets_PatchTags.json | 61 ++++++ .../2024-02-02-preview/Operations_List.json | 25 +++ .../UpdateRuns_CreateOrUpdate.json | 196 ++++++++++++++++++ .../2024-02-02-preview/UpdateRuns_Delete.json | 21 ++ .../2024-02-02-preview/UpdateRuns_Get.json | 90 ++++++++ .../UpdateRuns_ListByFleet.json | 94 +++++++++ .../2024-02-02-preview/UpdateRuns_Skip.json | 124 +++++++++++ .../2024-02-02-preview/UpdateRuns_Start.json | 99 +++++++++ .../2024-02-02-preview/UpdateRuns_Stop.json | 99 +++++++++ .../UpdateStrategies_CreateOrUpdate.json | 94 +++++++++ .../UpdateStrategies_Delete.json | 21 ++ .../UpdateStrategies_Get.json | 45 ++++ .../UpdateStrategies_ListByFleet.json | 49 +++++ .../Fleet.Management/fleet.tsp | 5 + .../Fleet.Management/main.tsp | 5 + .../Fleet.Management/tspconfig.yaml | 1 + .../Fleet.Management/update/run.tsp | 47 +++++ .../preview/2022-09-02-preview/fleets.json | 6 +- .../preview/2023-03-15-preview/fleets.json | 9 +- .../preview/2023-06-15-preview/fleets.json | 9 +- .../preview/2023-08-15-preview/fleets.json | 12 +- .../examples/UpdateRuns_Skip.json | 124 +++++++++++ .../preview/2024-02-02-preview/fleets.json | 163 ++++++++++++++- .../fleet/stable/2023-10-15/fleets.json | 12 +- 36 files changed, 1891 insertions(+), 21 deletions(-) create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Create.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Delete.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Get.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_ListByFleet.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Update.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_CreateOrUpdate.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Delete.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Get.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListByResourceGroup.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListBySub.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListCredentialsResult.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_PatchTags.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Operations_List.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_CreateOrUpdate.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Delete.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Get.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_ListByFleet.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Skip.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Start.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Stop.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_CreateOrUpdate.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Delete.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Get.json create mode 100644 specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_ListByFleet.json create mode 100644 specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/examples/UpdateRuns_Skip.json diff --git a/custom-words.txt b/custom-words.txt index 5f0157ebeff3..097744ef3a13 100644 --- a/custom-words.txt +++ b/custom-words.txt @@ -561,6 +561,7 @@ connectionstrings conntrack consistencygroup consumergroups +containerd containerid containerinstance containerlogs diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Create.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Create.json new file mode 100644 index 000000000000..e3f2759e9ef9 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Create.json @@ -0,0 +1,68 @@ +{ + "operationId": "FleetMembers_Create", + "title": "Creates a FleetMember resource with a long running operation.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "fleetMemberName": "member-1", + "resource": { + "properties": { + "clusterResourceId": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster-1" + } + } + }, + "responses": { + "201": { + "headers": { + "ETag": "23ujdflewrj3=", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1/members/member-1", + "name": "member-1", + "type": "Microsoft.ContainerService/fleets/members", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "eTag": "23ujdflewrj3=", + "properties": { + "clusterResourceId": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster-1", + "provisioningState": "Succeeded" + } + } + }, + "200": { + "headers": { + "ETag": "23ujdflewrj3=", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1/members/member-1", + "name": "member-1", + "type": "Microsoft.ContainerService/fleets/members", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "eTag": "23ujdflewrj3=", + "properties": { + "clusterResourceId": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster-1", + "provisioningState": "Succeeded" + } + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Delete.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Delete.json new file mode 100644 index 000000000000..96ea318bfb1c --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Delete.json @@ -0,0 +1,21 @@ +{ + "operationId": "FleetMembers_Delete", + "title": "Deletes a FleetMember resource asynchronously with a long running operation.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "fleetMemberName": "member-1" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + } + }, + "200": {}, + "204": {} + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Get.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Get.json new file mode 100644 index 000000000000..e1bbe2da8cb6 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Get.json @@ -0,0 +1,36 @@ +{ + "operationId": "FleetMembers_Get", + "title": "Gets a FleetMember resource.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "fleetMemberName": "member-1" + }, + "responses": { + "200": { + "headers": { + "ETag": "kd30rkdfo49=" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1/members/member-1", + "name": "member-1", + "type": "Microsoft.ContainerService/fleets/members", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "eTag": "kd30rkdfo49=", + "properties": { + "clusterResourceId": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster-1", + "provisioningState": "Succeeded" + } + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_ListByFleet.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_ListByFleet.json new file mode 100644 index 000000000000..b82dbb7b76a0 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_ListByFleet.json @@ -0,0 +1,37 @@ +{ + "operationId": "FleetMembers_ListByFleet", + "title": "Lists the members of a Fleet.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1/members/member-1", + "name": "member-1", + "type": "Microsoft.ContainerService/fleets/members", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "eTag": "kd30rkdfo49=", + "properties": { + "clusterResourceId": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster-1", + "provisioningState": "Succeeded" + } + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Update.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Update.json new file mode 100644 index 000000000000..ba8d1f69123a --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/FleetMembers_Update.json @@ -0,0 +1,48 @@ +{ + "operationId": "FleetMembers_Update", + "title": "Updates a FleetMember resource synchronously.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "fleetMemberName": "member-1", + "properties": { + "properties": { + "group": "staging" + } + } + }, + "responses": { + "200": { + "headers": { + "ETag": "23ujdflewrj3=" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1/members/member-1", + "name": "member-1", + "type": "Microsoft.ContainerService/fleets/members", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "eTag": "23ujdflewrj3=", + "properties": { + "clusterResourceId": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster-1", + "group": "staging", + "provisioningState": "Succeeded" + } + } + }, + "202": { + "headers": { + "Retry-After": "20", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_CreateOrUpdate.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_CreateOrUpdate.json new file mode 100644 index 000000000000..2a0e618cb213 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_CreateOrUpdate.json @@ -0,0 +1,103 @@ +{ + "operationId": "Fleets_CreateOrUpdate", + "title": "Creates a Fleet resource with a long running operation.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "resource": { + "tags": { + "tier": "production", + "archv2": "" + }, + "location": "East US", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "agentProfile": { + "vmSize": "Standard_DS1" + } + } + } + } + }, + "responses": { + "200": { + "headers": { + "ETag": "23ujdflewrj3=", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1", + "name": "fleet-1", + "type": "Microsoft.ContainerService/fleets", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "tags": { + "tier": "production", + "archv2": "" + }, + "location": "East US", + "eTag": "23ujdflewrj3=", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "kubernetesVersion": "1.22.4", + "agentProfile": { + "vmSize": "Standard_DS1" + } + }, + "provisioningState": "Updating" + } + } + }, + "201": { + "headers": { + "ETag": "23ujdflewrj3=", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet1", + "name": "fleet1", + "type": "Microsoft.ContainerService/fleets", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "tags": { + "tier": "production", + "archv2": "" + }, + "location": "East US", + "eTag": "23ujdflewrj3=", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "kubernetesVersion": "1.22.4", + "agentProfile": { + "vmSize": "Standard_DS1" + } + }, + "provisioningState": "Creating" + } + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Delete.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Delete.json new file mode 100644 index 000000000000..c77c8535ffb8 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Delete.json @@ -0,0 +1,20 @@ +{ + "operationId": "Fleets_Delete", + "title": "Deletes a Fleet resource asynchronously with a long running operation.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + } + }, + "200": {}, + "204": {} + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Get.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Get.json new file mode 100644 index 000000000000..4c6ff8a5610e --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_Get.json @@ -0,0 +1,48 @@ +{ + "operationId": "Fleets_Get", + "title": "Gets a Fleet resource.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1" + }, + "responses": { + "200": { + "headers": { + "ETag": "23ujdflewrj3=" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1", + "name": "fleet-1", + "type": "Microsoft.ContainerService/fleets", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "tags": { + "tier": "production", + "archv2": "" + }, + "location": "East US", + "eTag": "23ujdflewrj3=", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "kubernetesVersion": "1.22.4", + "agentProfile": { + "vmSize": "Standard_DS1" + } + }, + "provisioningState": "Succeeded" + } + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListByResourceGroup.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListByResourceGroup.json new file mode 100644 index 000000000000..0ea97f40c667 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListByResourceGroup.json @@ -0,0 +1,49 @@ +{ + "operationId": "Fleets_ListByResourceGroup", + "title": "Lists the Fleet resources in a resource group.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1", + "name": "fleet1", + "type": "Microsoft.ContainerService/fleets", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "tags": { + "tier": "production", + "archv2": "" + }, + "location": "East US", + "eTag": "23ujdflewrj3=", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "kubernetesVersion": "1.22.4", + "agentProfile": { + "vmSize": "Standard_DS1" + } + }, + "provisioningState": "Succeeded" + } + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListBySub.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListBySub.json new file mode 100644 index 000000000000..93c05450e1ab --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListBySub.json @@ -0,0 +1,48 @@ +{ + "operationId": "Fleets_ListBySubscription", + "title": "Lists the Fleet resources in a subscription.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet1", + "name": "fleet-1", + "type": "Microsoft.ContainerService/fleets", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "tags": { + "tier": "production", + "archv2": "" + }, + "location": "East US", + "eTag": "23ujdflewrj3=", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "kubernetesVersion": "1.22.4", + "agentProfile": { + "vmSize": "Standard_DS1" + } + }, + "provisioningState": "Succeeded" + } + } + ], + "nextLink": null + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListCredentialsResult.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListCredentialsResult.json new file mode 100644 index 000000000000..f07524926a1b --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_ListCredentialsResult.json @@ -0,0 +1,22 @@ +{ + "operationId": "Fleets_ListCredentials", + "title": "Lists the user credentials of a Fleet.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet" + }, + "responses": { + "200": { + "body": { + "kubeconfigs": [ + { + "name": "credentialName1", + "value": "Y3JlZGVudGlhbFZhbHVlMQ==" + } + ] + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_PatchTags.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_PatchTags.json new file mode 100644 index 000000000000..7d6ac5ac3bd8 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Fleets_PatchTags.json @@ -0,0 +1,61 @@ +{ + "operationId": "Fleets_Update", + "title": "Update a Fleet.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "If-Match": "dfjkwelr7384", + "properties": { + "tags": { + "tier": "secure", + "env": "prod" + } + } + }, + "responses": { + "200": { + "headers": { + "ETag": "23ujdflewrj3=" + }, + "body": { + "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/fleets/fleet-1", + "name": "fleet-1", + "type": "Microsoft.ContainerService/fleets", + "systemData": { + "createdBy": "someUser", + "createdByType": "User", + "createdAt": "2022-03-23T05:40:40.657Z", + "lastModifiedBy": "someOtherUser", + "lastModifiedByType": "User", + "lastModifiedAt": "2022-03-23T05:40:40.657Z" + }, + "tags": { + "tier": "secure", + "env": "prod" + }, + "location": "East US", + "eTag": "23ujdflewrj3=", + "properties": { + "hubProfile": { + "dnsPrefix": "dnsprefix1", + "fqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "portalFqdn": "dnsprefix1-abcd1234.flt.eastus.azmk8s.io", + "kubernetesVersion": "1.22.4", + "agentProfile": { + "vmSize": "Standard_DS1" + } + }, + "provisioningState": "Succeeded" + } + } + }, + "202": { + "headers": { + "Retry-After": "20", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Operations_List.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Operations_List.json new file mode 100644 index 000000000000..aa8f9f0ceb96 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/Operations_List.json @@ -0,0 +1,25 @@ +{ + "operationId": "Operations_List", + "title": "List the operations for the provider.", + "parameters": { + "api-version": "2024-02-02-preview" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "display": { + "description": "Gets the status of an asynchronous operation", + "operation": "Get Operation", + "provider": "Microsoft Container Service", + "resource": "Operation" + }, + "name": "Microsoft.ContainerService/locations/operations/read", + "origin": "user,system" + } + ] + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_CreateOrUpdate.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_CreateOrUpdate.json new file mode 100644 index 000000000000..d53cf937fc4e --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_CreateOrUpdate.json @@ -0,0 +1,196 @@ +{ + "operationId": "UpdateRuns_CreateOrUpdate", + "title": "Create an UpdateRun.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1", + "resource": { + "properties": { + "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + } + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "state": "NotStarted" + }, + "stages": [ + { + "status": { + "state": "NotStarted" + }, + "name": "stage1", + "groups": [ + { + "status": { + "state": "NotStarted" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "NotStarted" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "NotStarted" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + }, + "201": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "updateStrategyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "state": "NotStarted" + }, + "stages": [ + { + "status": { + "state": "NotStarted" + }, + "name": "stage1", + "groups": [ + { + "status": { + "state": "NotStarted" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "NotStarted" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "NotStarted" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Delete.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Delete.json new file mode 100644 index 000000000000..4943c4c2100b --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Delete.json @@ -0,0 +1,21 @@ +{ + "operationId": "UpdateRuns_Delete", + "title": "Delete an updateRun resource.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-09-02-preview", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-09-02-preview" + } + }, + "200": {}, + "204": {} + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Get.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Get.json new file mode 100644 index 000000000000..4b96e44e784e --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Get.json @@ -0,0 +1,90 @@ +{ + "operationId": "UpdateRuns_Get", + "title": "Gets an UpdateRun resource.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "state": "NotStarted" + }, + "stages": [ + { + "status": { + "state": "NotStarted" + }, + "name": "stage1", + "groups": [ + { + "status": { + "state": "NotStarted" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "NotStarted" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "NotStarted" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_ListByFleet.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_ListByFleet.json new file mode 100644 index 000000000000..d5d987b71552 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_ListByFleet.json @@ -0,0 +1,94 @@ +{ + "operationId": "UpdateRuns_ListByFleet", + "title": "Lists the UpdateRun resources by fleet.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "state": "NotStarted" + }, + "stages": [ + { + "status": { + "state": "NotStarted" + }, + "name": "stage1", + "groups": [ + { + "status": { + "state": "NotStarted" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "NotStarted" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "NotStarted" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + ], + "nextLink": "http://nextlink.contoso.com" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Skip.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Skip.json new file mode 100644 index 000000000000..4909edad9b8e --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Skip.json @@ -0,0 +1,124 @@ +{ + "operationId": "UpdateRuns_Skip", + "title": "Skips one or more member/group/stage/afterStageWait(s) of an UpdateRun.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1", + "body": { + "targets": [ + { + "type": "Member", + "target": "member-one" + }, + { + "type": "AfterStageWait", + "target": "stage1" + } + ] + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:09:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + }, + { + "name": "group-b" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "stages": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "name": "stage1", + "groups": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Skipped" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "Skipped" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster-1" + } + ] + }, + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "name": "group-b", + "members": [ + { + "status": { + "state": "Running" + }, + "name": "member-two", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster-2" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "Skipped" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Start.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Start.json new file mode 100644 index 000000000000..254b0b02b9d2 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Start.json @@ -0,0 +1,99 @@ +{ + "operationId": "UpdateRuns_Start", + "title": "Starts an UpdateRun.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:09:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "stages": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "name": "stage1", + "groups": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "Running" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "NotStarted" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Stop.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Stop.json new file mode 100644 index 000000000000..d25b413bb0a4 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateRuns_Stop.json @@ -0,0 +1,99 @@ +{ + "operationId": "UpdateRuns_Stop", + "title": "Stops an UpdateRun.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:09:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Stopping" + }, + "stages": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Stopping" + }, + "name": "stage1", + "groups": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Stopping" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "Stopping" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "NotStarted" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + }, + "202": { + "headers": { + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01", + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-02-01" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_CreateOrUpdate.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_CreateOrUpdate.json new file mode 100644 index 000000000000..99d05f6b9cb1 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_CreateOrUpdate.json @@ -0,0 +1,94 @@ +{ + "operationId": "FleetUpdateStrategies_CreateOrUpdate", + "title": "Create a FleetUpdateStrategy.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateStrategyName": "strartegy1", + "resource": { + "properties": { + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + } + } + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "name": "strategy1", + "type": "Microsoft.ContainerService/fleets/updateStrategies", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + }, + "201": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "name": "strategy1", + "type": "Microsoft.ContainerService/fleets/updateStrategies", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Delete.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Delete.json new file mode 100644 index 000000000000..db050c2f3553 --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Delete.json @@ -0,0 +1,21 @@ +{ + "operationId": "FleetUpdateStrategies_Delete", + "title": "Delete a FleetUpdateStrategy resource.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "subid1", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateStrategyName": "strategy1" + }, + "responses": { + "202": { + "headers": { + "Location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operations/00000000-0000-0000-0000-000000000000?api-version=2022-09-02-preview", + "Azure-AsyncOperation": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-09-02-preview" + } + }, + "200": {}, + "204": {} + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Get.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Get.json new file mode 100644 index 000000000000..437ab957b3bd --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_Get.json @@ -0,0 +1,45 @@ +{ + "operationId": "FleetUpdateStrategies_Get", + "title": "Get a FleetUpdateStrategy resource.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateStrategyName": "strategy1" + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "name": "strategy1", + "type": "Microsoft.ContainerService/fleets/updateStrategies", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_ListByFleet.json b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_ListByFleet.json new file mode 100644 index 000000000000..9f09d567e9da --- /dev/null +++ b/specification/containerservice/Fleet.Management/examples/2024-02-02-preview/UpdateStrategies_ListByFleet.json @@ -0,0 +1,49 @@ +{ + "operationId": "FleetUpdateStrategies_ListByFleet", + "title": "List the FleetUpdateStrategy resources by fleet.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateStrategies/strategy1", + "name": "strategy1", + "type": "Microsoft.ContainerService/fleets/updateStrategies", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:10:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + ], + "nextLink": "http://nextlink.contoso.com" + } + } + } +} diff --git a/specification/containerservice/Fleet.Management/fleet.tsp b/specification/containerservice/Fleet.Management/fleet.tsp index 68d77053e51c..a6ea0824a870 100644 --- a/specification/containerservice/Fleet.Management/fleet.tsp +++ b/specification/containerservice/Fleet.Management/fleet.tsp @@ -50,7 +50,12 @@ model FleetProperties { #suppress "@azure-tools/typespec-providerhub/non-breaking-versioning" "https://github.com/Azure/typespec-azure/issues/3558" @doc("The FleetHubProfile configures the Fleet's hub.") + @added(Versions.v2022_09_02_preview) + @added(Versions.v2023_03_15_preview) + @added(Versions.v2023_06_15_preview) + @added(Versions.v2023_08_15_preview) @removed(Versions.v2023_10_15) + @added(Versions.v2024_02_02_preview) hubProfile?: FleetHubProfile; } diff --git a/specification/containerservice/Fleet.Management/main.tsp b/specification/containerservice/Fleet.Management/main.tsp index 894c2d6a0e90..669d843a5754 100644 --- a/specification/containerservice/Fleet.Management/main.tsp +++ b/specification/containerservice/Fleet.Management/main.tsp @@ -46,4 +46,9 @@ enum Versions { @useDependency(Azure.Core.Versions.v1_0_Preview_2) @useDependency(Azure.ResourceManager.Versions.v1_0_Preview_1) v2023_10_15: "2023-10-15", + + @doc("Azure Kubernetes Fleet Manager api version 2024-02-02-preview.") + @useDependency(Azure.Core.Versions.v1_0_Preview_2) + @useDependency(Azure.ResourceManager.Versions.v1_0_Preview_1) + v2024_02_02_preview: "2024-02-02-preview", } diff --git a/specification/containerservice/Fleet.Management/tspconfig.yaml b/specification/containerservice/Fleet.Management/tspconfig.yaml index ffd0e4e00f32..4d987e847d4c 100644 --- a/specification/containerservice/Fleet.Management/tspconfig.yaml +++ b/specification/containerservice/Fleet.Management/tspconfig.yaml @@ -13,3 +13,4 @@ options: examples-directory: "examples" output-file: "{azure-resource-provider-folder}/{service-name}/fleet/{version-status}/{version}/fleets.json" omit-unreachable-types: true + use-read-only-status-schema: true diff --git a/specification/containerservice/Fleet.Management/update/run.tsp b/specification/containerservice/Fleet.Management/update/run.tsp index c657f951b2ab..5b4801bb18ff 100644 --- a/specification/containerservice/Fleet.Management/update/run.tsp +++ b/specification/containerservice/Fleet.Management/update/run.tsp @@ -293,6 +293,44 @@ model MemberUpdateStatus { message?: string; } +@doc("The target type of a skip request.") +@added(Versions.v2024_02_02_preview) +enum TargetType { + @doc("Skip the update of a member.") + Member, + + @doc("Skip the update of a group.") + Group, + + @doc("Skip the update of an entire stage including the after stage wait.") + Stage, + + @doc("Skip the update of the after stage wait of a certain stage.") + AfterStageWait, +} + +@doc("The definition of a single skip request.") +@added(Versions.v2024_02_02_preview) +model SkipRequest { + @doc("The skip target type.") + type: TargetType; + + @doc(""" + The skip target. + 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. + """) + target: string; +} + +@doc("The properties of a skip operation containing multiple skip requests.") +@added(Versions.v2024_02_02_preview) +model SkipProperties { + @doc("The targets to skip.") + @extension("x-ms-identifiers", ["target"]) + targets: SkipRequest[]; +} + @added(Versions.v2023_03_15_preview) @armResourceOperations interface UpdateRuns { @@ -331,4 +369,13 @@ interface UpdateRuns { UpdateRun, BaseParameters & IfMatchParameters >; + + @doc("Skips one or a combination of member/group/stage/afterStageWait(s) of an update run.") + @added(Versions.v2024_02_02_preview) + skip is ArmResourceActionSync< + UpdateRun, + SkipProperties, + UpdateRun, + BaseParameters & IfMatchParameters + >; } diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2022-09-02-preview/fleets.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2022-09-02-preview/fleets.json index b705bc0d0c60..91076f75fd3d 100644 --- a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2022-09-02-preview/fleets.json +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2022-09-02-preview/fleets.json @@ -1019,7 +1019,8 @@ "description": "The provisioning state of a member being updated." } ] - } + }, + "readOnly": true }, "FleetPatch": { "type": "object", @@ -1095,7 +1096,8 @@ "description": "The provisioning state of a fleet being deleted." } ] - } + }, + "readOnly": true } }, "parameters": {} diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-03-15-preview/fleets.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-03-15-preview/fleets.json index ddef9653c725..8b25ba6634ce 100644 --- a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-03-15-preview/fleets.json +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-03-15-preview/fleets.json @@ -1566,7 +1566,8 @@ "description": "The provisioning state of a member being updated." } ] - } + }, + "readOnly": true }, "FleetMemberUpdate": { "type": "object", @@ -1665,7 +1666,8 @@ "description": "The provisioning state of a fleet being deleted." } ] - } + }, + "readOnly": true }, "KubernetesVersion": { "type": "string" @@ -1894,7 +1896,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "UpdateRunStatus": { "type": "object", diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-06-15-preview/fleets.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-06-15-preview/fleets.json index cb8c55a3c3c8..8a05ea0c8fb6 100644 --- a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-06-15-preview/fleets.json +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-06-15-preview/fleets.json @@ -1666,7 +1666,8 @@ "description": "The provisioning state of a member being updated." } ] - } + }, + "readOnly": true }, "FleetMemberUpdate": { "type": "object", @@ -1769,7 +1770,8 @@ "description": "The provisioning state of a fleet being deleted." } ] - } + }, + "readOnly": true }, "KubernetesVersion": { "type": "string" @@ -2092,7 +2094,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "UpdateRunStatus": { "type": "object", diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-08-15-preview/fleets.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-08-15-preview/fleets.json index b9edaac39a11..dcacc9cf16ca 100644 --- a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-08-15-preview/fleets.json +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2023-08-15-preview/fleets.json @@ -1975,7 +1975,8 @@ "description": "The provisioning state of a member being updated." } ] - } + }, + "readOnly": true }, "FleetMemberUpdate": { "type": "object", @@ -2078,7 +2079,8 @@ "description": "The provisioning state of a fleet being deleted." } ] - } + }, + "readOnly": true }, "FleetUpdateStrategy": { "type": "object", @@ -2177,7 +2179,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "FleetUpdateStrategyResourceId": { "type": "string", @@ -2516,7 +2519,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "UpdateRunStatus": { "type": "object", diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/examples/UpdateRuns_Skip.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/examples/UpdateRuns_Skip.json new file mode 100644 index 000000000000..4909edad9b8e --- /dev/null +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/examples/UpdateRuns_Skip.json @@ -0,0 +1,124 @@ +{ + "operationId": "UpdateRuns_Skip", + "title": "Skips one or more member/group/stage/afterStageWait(s) of an UpdateRun.", + "parameters": { + "api-version": "2024-02-02-preview", + "subscriptionId": "00000000-0000-0000-0000-000000000000", + "resourceGroupName": "rg1", + "fleetName": "fleet1", + "updateRunName": "run1", + "body": { + "targets": [ + { + "type": "Member", + "target": "member-one" + }, + { + "type": "AfterStageWait", + "target": "stage1" + } + ] + } + }, + "responses": { + "200": { + "body": { + "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/fleets/myFleet/updateRuns/run1", + "name": "run1", + "type": "Microsoft.ContainerService/fleets/updateRuns", + "systemData": { + "createdBy": "@contoso.com", + "createdByType": "User", + "createdAt": "2023-03-01T01:09:08.395Z", + "lastModifiedBy": "@contoso.com", + "lastModifiedByType": "User", + "lastModifiedAt": "2023-03-01T01:10:08.395Z" + }, + "properties": { + "provisioningState": "Succeeded", + "strategy": { + "stages": [ + { + "name": "stage1", + "groups": [ + { + "name": "group-a" + }, + { + "name": "group-b" + } + ], + "afterStageWaitInSeconds": 3600 + } + ] + }, + "managedClusterUpdate": { + "upgrade": { + "type": "Full", + "kubernetesVersion": "1.26.1" + }, + "nodeImageSelection": { + "type": "Latest" + } + }, + "status": { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "stages": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "name": "stage1", + "groups": [ + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Skipped" + }, + "name": "group-a", + "members": [ + { + "status": { + "state": "Skipped" + }, + "name": "member-one", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster-1" + } + ] + }, + { + "status": { + "startTime": "2023-03-01T01:10:08.395Z", + "state": "Running" + }, + "name": "group-b", + "members": [ + { + "status": { + "state": "Running" + }, + "name": "member-two", + "clusterResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myClusters/providers/Microsoft.ContainerService/managedClusters/myCluster-2" + } + ] + } + ], + "afterStageWaitStatus": { + "status": { + "state": "Skipped" + }, + "waitDurationInSeconds": 3600 + } + } + ] + } + }, + "eTag": "\"EtagValue\"" + } + } + } +} diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/fleets.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/fleets.json index 48135755e546..f1027de3f8a2 100644 --- a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/fleets.json +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/preview/2024-02-02-preview/fleets.json @@ -1193,6 +1193,82 @@ "x-ms-long-running-operation": true } }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/skip": { + "post": { + "operationId": "UpdateRuns_Skip", + "tags": [ + "UpdateRuns" + ], + "description": "Skips one or a combination of member/group/stage/afterStageWait(s) of an update run.", + "parameters": [ + { + "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ApiVersionParameter" + }, + { + "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../../../../common-types/resource-management/v3/types.json#/parameters/ResourceGroupNameParameter" + }, + { + "name": "If-Match", + "in": "header", + "description": "The request should only proceed if an entity matches this string.", + "required": false, + "type": "string", + "x-ms-client-name": "ifMatch" + }, + { + "name": "fleetName", + "in": "path", + "description": "The name of the Fleet resource.", + "required": true, + "type": "string", + "minLength": 1, + "maxLength": 63, + "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$" + }, + { + "name": "updateRunName", + "in": "path", + "description": "The name of the UpdateRun resource.", + "required": true, + "type": "string", + "minLength": 1, + "maxLength": 50, + "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$" + }, + { + "name": "body", + "in": "body", + "description": "The content of the action request", + "required": true, + "schema": { + "$ref": "#/definitions/SkipProperties" + } + } + ], + "responses": { + "200": { + "description": "ARM operation completed successfully.", + "schema": { + "$ref": "#/definitions/UpdateRun" + } + }, + "default": { + "description": "An unexpected error response.", + "schema": { + "$ref": "../../../../../../common-types/resource-management/v3/types.json#/definitions/ErrorResponse" + } + } + }, + "x-ms-examples": { + "Skips one or more member/group/stage/afterStageWait(s) of an UpdateRun.": { + "$ref": "./examples/UpdateRuns_Skip.json" + } + } + } + }, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/fleets/{fleetName}/updateRuns/{updateRunName}/start": { "post": { "operationId": "UpdateRuns_Start", @@ -1975,7 +2051,8 @@ "description": "The provisioning state of a member being updated." } ] - } + }, + "readOnly": true }, "FleetMemberUpdate": { "type": "object", @@ -2078,7 +2155,8 @@ "description": "The provisioning state of a fleet being deleted." } ] - } + }, + "readOnly": true }, "FleetUpdateStrategy": { "type": "object", @@ -2177,7 +2255,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "FleetUpdateStrategyResourceId": { "type": "string", @@ -2356,6 +2435,43 @@ } } }, + "SkipProperties": { + "type": "object", + "description": "The properties of a skip operation containing multiple skip requests.", + "properties": { + "targets": { + "type": "array", + "description": "The targets to skip.", + "items": { + "$ref": "#/definitions/SkipRequest" + }, + "x-ms-identifiers": [ + "target" + ] + } + }, + "required": [ + "targets" + ] + }, + "SkipRequest": { + "type": "object", + "description": "The definition of a single skip request.", + "properties": { + "type": { + "$ref": "#/definitions/TargetType", + "description": "The skip target type." + }, + "target": { + "type": "string", + "description": "The skip target. \nTo skip a member/group/stage, use the member/group/stage's name;\nTp skip an after stage wait, use the parent stage's name." + } + }, + "required": [ + "type", + "target" + ] + }, "SubnetResourceId": { "type": "string", "format": "arm-id", @@ -2368,6 +2484,42 @@ ] } }, + "TargetType": { + "type": "string", + "description": "The target type of a skip request.", + "enum": [ + "Member", + "Group", + "Stage", + "AfterStageWait" + ], + "x-ms-enum": { + "name": "TargetType", + "modelAsString": true, + "values": [ + { + "name": "Member", + "value": "Member", + "description": "Skip the update of a member." + }, + { + "name": "Group", + "value": "Group", + "description": "Skip the update of a group." + }, + { + "name": "Stage", + "value": "Stage", + "description": "Skip the update of an entire stage including the after stage wait." + }, + { + "name": "AfterStageWait", + "value": "AfterStageWait", + "description": "Skip the update of the after stage wait of a certain stage." + } + ] + } + }, "UpdateGroup": { "type": "object", "description": "A group to be updated.", @@ -2468,7 +2620,7 @@ }, "updateStrategyId": { "$ref": "#/definitions/FleetUpdateStrategyResourceId", - "description": "The resource id of the FleetUpdateStrategy resource to reference.\n\nWhen creating a new run, there are three ways to define a strategy for the run:\n1. Define a new strategy in place: Set the \"strategy\" field.\n2. Use an existing strategy: Set the \"updateStrategyId\" field. (since 2024-02-02-preview)\n3. Use the default strategy to update all the members one by one: Leave both \"updateStrategyId\" and \"strategy\" unset. (since 2024-02-02-preview)\n\nSetting both \"updateStrategyId\" and \"strategy\" is invalid.\n\nUpdateRuns created by \"updateStrategyId\" snapshot the referenced UpdateStrategy at the time of creation and store it in the \"strategy\" field. \nSubsequent changes to the referenced FleetUpdateStrategy resource do not propagate. \nUpdateRunStrategy changes can be made directly on the \"strategy\" field before launching the UpdateRun." + "description": "The resource id of the FleetUpdateStrategy resource to reference.\n\nWhen creating a new run, there are three ways to define a strategy for the run:\n1. Define a new strategy in place: Set the \"strategy\" field.\n2. Use an existing strategy: Set the \"updateStrategyId\" field. (since 2023-08-15-preview)\n3. Use the default strategy to update all the members one by one: Leave both \"updateStrategyId\" and \"strategy\" unset. (since 2023-08-15-preview)\n\nSetting both \"updateStrategyId\" and \"strategy\" is invalid.\n\nUpdateRuns created by \"updateStrategyId\" snapshot the referenced UpdateStrategy at the time of creation and store it in the \"strategy\" field. \nSubsequent changes to the referenced FleetUpdateStrategy resource do not propagate. \nUpdateRunStrategy changes can be made directly on the \"strategy\" field before launching the UpdateRun." }, "strategy": { "$ref": "#/definitions/UpdateRunStrategy", @@ -2516,7 +2668,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "UpdateRunStatus": { "type": "object", diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2023-10-15/fleets.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2023-10-15/fleets.json index fa08f48b9c3e..329ecaf049fe 100644 --- a/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2023-10-15/fleets.json +++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/fleet/stable/2023-10-15/fleets.json @@ -1875,7 +1875,8 @@ "description": "The provisioning state of a member being updated." } ] - } + }, + "readOnly": true }, "FleetMemberUpdate": { "type": "object", @@ -1974,7 +1975,8 @@ "description": "The provisioning state of a fleet being deleted." } ] - } + }, + "readOnly": true }, "FleetUpdateStrategy": { "type": "object", @@ -2073,7 +2075,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "FleetUpdateStrategyResourceId": { "type": "string", @@ -2400,7 +2403,8 @@ "description": "Resource creation was canceled." } ] - } + }, + "readOnly": true }, "UpdateRunStatus": { "type": "object",