Skip to content

Commit cb824b8

Browse files
carlosh-msft2025Carlos Hinojosa Cavada
carlosh-msft2025
and
Carlos Hinojosa Cavada
authored
StandbyPool 2025-03-01 SDK release (#27616)
Co-authored-by: Carlos Hinojosa Cavada <[email protected]>
1 parent d7f209b commit cb824b8

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+648
-394
lines changed

‎src/StandbyPool/StandbyPool.Autorest/Properties/AssemblyInfo.cs

+26
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
// Copyright (c) Microsoft Corporation. All rights reserved.
2+
// Licensed under the Apache License, Version 2.0 (the ""License"");
3+
// you may not use this file except in compliance with the License.
4+
// You may obtain a copy of the License at
5+
// http://www.apache.org/licenses/LICENSE-2.0
6+
// Unless required by applicable law or agreed to in writing, software
7+
// distributed under the License is distributed on an ""AS IS"" BASIS,
8+
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
9+
// See the License for the specific language governing permissions and
10+
// limitations under the License.
11+
// Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code
12+
// is regenerated.
13+
14+
using System;
15+
using System.Reflection;
16+
using System.Runtime.CompilerServices;
17+
using System.Runtime.InteropServices;
18+
19+
[assembly: System.Reflection.AssemblyCompanyAttribute("Microsoft")]
20+
[assembly: System.Reflection.AssemblyCopyrightAttribute("Copyright © Microsoft")]
21+
[assembly: System.Reflection.AssemblyProductAttribute("Microsoft Azure PowerShell")]
22+
[assembly: System.Reflection.AssemblyTitleAttribute("Microsoft Azure PowerShell - StandbyPool")]
23+
[assembly: System.Reflection.AssemblyFileVersionAttribute("0.2.1")]
24+
[assembly: System.Reflection.AssemblyVersionAttribute("0.2.1")]
25+
[assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)]
26+
[assembly: System.CLSCompliantAttribute(false)]

‎src/StandbyPool/StandbyPool.Autorest/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@ For information on how to develop for `Az.StandbyPool`, see [how-to.md](how-to.m
2828
2929
```yaml
3030
# pin the swagger version by using the commit id instead of branch name
31-
commit: 1866fc3609f55fad6a5e74a9b206ae4ca144c03a
32-
tag: package-2024-03
31+
commit: 88735540206d3393d194f4e1cc1aa2daac65af8a
32+
# tag: package-2024-03
3333
require:
3434
# readme.azure.noprofile.md is the common configuration file
3535
- $(this-folder)/../../readme.azure.noprofile.md

‎src/StandbyPool/StandbyPool.Autorest/UX/Microsoft.StandbyPool/standbyContainerGroupPools-runtimeViews.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"resourceType": "standbyContainerGroupPools/runtimeViews",
3-
"apiVersion": "2024-03-01",
3+
"apiVersion": "2025-03-01",
44
"learnMore": {
55
"url": "https://learn.microsoft.com/powershell/module/az.standbypool"
66
},

‎src/StandbyPool/StandbyPool.Autorest/UX/Microsoft.StandbyPool/standbyContainerGroupPools.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"resourceType": "standbyContainerGroupPools",
3-
"apiVersion": "2024-03-01",
3+
"apiVersion": "2025-03-01",
44
"learnMore": {
55
"url": "https://learn.microsoft.com/powershell/module/az.standbypool"
66
},

‎src/StandbyPool/StandbyPool.Autorest/UX/Microsoft.StandbyPool/standbyVirtualMachinePools-runtimeViews.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"resourceType": "standbyVirtualMachinePools/runtimeViews",
3-
"apiVersion": "2024-03-01",
3+
"apiVersion": "2025-03-01",
44
"learnMore": {
55
"url": "https://learn.microsoft.com/powershell/module/az.standbypool"
66
},

‎src/StandbyPool/StandbyPool.Autorest/UX/Microsoft.StandbyPool/standbyVirtualMachinePools.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"resourceType": "standbyVirtualMachinePools",
3-
"apiVersion": "2024-03-01",
3+
"apiVersion": "2025-03-01",
44
"learnMore": {
55
"url": "https://learn.microsoft.com/powershell/module/az.standbypool"
66
},

‎src/StandbyPool/StandbyPool.Autorest/custom/Az.StandbyPool.custom.psm1

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
# region Generated
22
# Load the private module dll
3-
$null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '..\bin\Az.StandbyPool.private.dll')
3+
$null = Import-Module -PassThru -Name (Join-Path $PSScriptRoot '../bin/Az.StandbyPool.private.dll')
44

55
# Load the internal module
6-
$internalModulePath = Join-Path $PSScriptRoot '..\internal\Az.StandbyPool.internal.psm1'
6+
$internalModulePath = Join-Path $PSScriptRoot '../internal/Az.StandbyPool.internal.psm1'
77
if(Test-Path $internalModulePath) {
88
$null = Import-Module -Name $internalModulePath
99
}

‎src/StandbyPool/StandbyPool.Autorest/custom/README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Custom
2-
This directory contains custom implementation for non-generated cmdlets for the `Az.StandbyPool` module. Both scripts (`.ps1`) and C# files (`.cs`) can be implemented here. They will be used during the build process in `build-module.ps1`, and create cmdlets into the `..\exports` folder. The only generated file into this folder is the `Az.StandbyPool.custom.psm1`. This file should not be modified.
2+
This directory contains custom implementation for non-generated cmdlets for the `Az.StandbyPool` module. Both scripts (`.ps1`) and C# files (`.cs`) can be implemented here. They will be used during the build process in `build-module.ps1`, and create cmdlets into the `../exports` folder. The only generated file into this folder is the `Az.StandbyPool.custom.psm1`. This file should not be modified.
33

44
## Info
55
- Modifiable: yes
@@ -15,10 +15,10 @@ For C# cmdlets, they are compiled with the rest of the generated low-level cmdle
1515
For script cmdlets, these are loaded via the `Az.StandbyPool.custom.psm1`. Then, during the build process, this module is loaded and processed in the same manner as the C# cmdlets. The fundamental difference is the script cmdlets use the `ParameterSetName` attribute and C# cmdlets do not. To create a script cmdlet variant of a generated cmdlet, simply decorate all parameters in the script with the new `ParameterSetName` in the `Parameter` attribute. This will appropriately treat each parameter set as a separate variant when processed to be exported during the build.
1616

1717
## Purpose
18-
This allows the modules to have cmdlets that were not defined in the REST specification. It also allows combining logic using generated cmdlets. This is a level of customization beyond what can be done using the [readme configuration options](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md) that are currently available. These custom cmdlets are then referenced by the cmdlets created at build-time in the `..\exports` folder.
18+
This allows the modules to have cmdlets that were not defined in the REST specification. It also allows combining logic using generated cmdlets. This is a level of customization beyond what can be done using the [readme configuration options](https://github.com/Azure/autorest/blob/master/docs/powershell/options.md) that are currently available. These custom cmdlets are then referenced by the cmdlets created at build-time in the `../exports` folder.
1919

2020
## Usage
21-
The easiest way currently to start developing custom cmdlets is to copy an existing cmdlet. For C# cmdlets, copy one from the `generated/cmdlets` folder. For script cmdlets, build the project using `build-module.ps1` and copy one of the scripts from the `..\exports` folder. After that, if you want to add new parameter sets, follow the guidelines in the `Details` section above. For implementing a new cmdlets, at minimum, please keep these parameters:
21+
The easiest way currently to start developing custom cmdlets is to copy an existing cmdlet. For C# cmdlets, copy one from the `generated/cmdlets` folder. For script cmdlets, build the project using `build-module.ps1` and copy one of the scripts from the `../exports` folder. After that, if you want to add new parameter sets, follow the guidelines in the `Details` section above. For implementing a new cmdlets, at minimum, please keep these parameters:
2222
- Break
2323
- DefaultProfile
2424
- HttpPipelineAppend
@@ -36,6 +36,6 @@ For processing the cmdlets, we've created some additional attributes:
3636
- `Microsoft.Azure.PowerShell.Cmdlets.StandbyPool.DoNotExportAttribute`
3737
- Used in C# and script cmdlets to suppress creating an exported cmdlet at build-time. These cmdlets will *not be exposed* by `Az.StandbyPool`.
3838
- `Microsoft.Azure.PowerShell.Cmdlets.StandbyPool.InternalExportAttribute`
39-
- Used in C# cmdlets to route exported cmdlets to the `..\internal`, which are *not exposed* by `Az.StandbyPool`. For more information, see [README.md](..\internal/README.md) in the `..\internal` folder.
39+
- Used in C# cmdlets to route exported cmdlets to the `../internal`, which are *not exposed* by `Az.StandbyPool`. For more information, see [README.md](../internal/README.md) in the `../internal` folder.
4040
- `Microsoft.Azure.PowerShell.Cmdlets.StandbyPool.ProfileAttribute`
4141
- Used in C# and script cmdlets to define which Azure profiles the cmdlet supports. This is only supported for Azure (`--azure`) modules.

‎src/StandbyPool/StandbyPool.Autorest/docs/Az.StandbyPool.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
Module Name: Az.StandbyPool
3-
Module Guid: bb1182ed-2a39-47be-8b39-46b13e973cea
3+
Module Guid: 906124f0-0d0b-43ea-a3f8-27a8a5ed0afa
44
Download Help Link: https://learn.microsoft.com/powershell/module/az.standbypool
55
Help Version: 1.0.0.0
66
Locale: en-US
@@ -24,10 +24,10 @@ Get a StandbyVirtualMachinePoolResource
2424
Get a StandbyVirtualMachinePoolRuntimeViewResource
2525

2626
### [New-AzStandbyContainerGroupPool](New-AzStandbyContainerGroupPool.md)
27-
Create a StandbyContainerGroupPoolResource
27+
create a StandbyContainerGroupPoolResource
2828

2929
### [New-AzStandbyVMPool](New-AzStandbyVMPool.md)
30-
Create a StandbyVirtualMachinePoolResource
30+
create a StandbyVirtualMachinePoolResource
3131

3232
### [Remove-AzStandbyContainerGroupPool](Remove-AzStandbyContainerGroupPool.md)
3333
Delete a StandbyContainerGroupPoolResource
@@ -36,8 +36,8 @@ Delete a StandbyContainerGroupPoolResource
3636
Delete a StandbyVirtualMachinePoolResource
3737

3838
### [Update-AzStandbyContainerGroupPool](Update-AzStandbyContainerGroupPool.md)
39-
Update a StandbyContainerGroupPoolResource
39+
update a StandbyContainerGroupPoolResource
4040

4141
### [Update-AzStandbyVMPool](Update-AzStandbyVMPool.md)
42-
Update a StandbyVirtualMachinePoolResource
42+
update a StandbyVirtualMachinePoolResource
4343

‎src/StandbyPool/StandbyPool.Autorest/docs/Get-AzStandbyContainerGroupPool.md

+1
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@ SystemDataLastModifiedByType : User
7070
Tag : {
7171
}
7272
Type : microsoft.standbypool/standbycontainergrouppools
73+
Zone : {1}
7374
```
7475

7576
Above command is getting a standby container group pool.

‎src/StandbyPool/StandbyPool.Autorest/docs/Get-AzStandbyContainerGroupPoolStatus.md

+21-15
Original file line numberDiff line numberDiff line change
@@ -50,27 +50,33 @@ Get-AzStandbyContainerGroupPoolStatus `
5050
```
5151

5252
```output
53+
ForecastValueInstancesRequestedCount :
5354
Id : /subscriptions/f8da6e30-a9d8-48ab-b05c-3f7fe482e13b/resourceGroups/test-standbypool/providers/Microsoft.Standb
5455
yPool/standbyContainerGroupPools/testPool/runtimeViews/latest
5556
InstanceCountSummary : {{
56-
"instanceCountsByState": [
57-
{
58-
"state": "Creating",
59-
"count": 1
60-
},
61-
{
62-
"state": "Running",
63-
"count": 0
64-
},
65-
{
66-
"state": "Deleting",
67-
"count": 0
68-
}
69-
]
70-
}}
57+
"zone": 1,
58+
"instanceCountsByState": [
59+
{
60+
"state": "Running",
61+
"count": 0
62+
},
63+
{
64+
"state": "Deleting",
65+
"count": 1
66+
},
67+
{
68+
"state": "Creating",
69+
"count": 0
70+
}
71+
]
72+
}}
7173
Name : latest
74+
PredictionForecastInfo :
75+
PredictionForecastStartTime :
7276
ProvisioningState : Succeeded
7377
ResourceGroupName : test-standbypool
78+
StatusCode : HealthState/degraded
79+
StatusMessage :
7480
SystemDataCreatedAt :
7581
SystemDataCreatedBy :
7682
SystemDataCreatedByType :

‎src/StandbyPool/StandbyPool.Autorest/docs/Get-AzStandbyVMPoolStatus.md

+40-27
Original file line numberDiff line numberDiff line change
@@ -50,39 +50,52 @@ Get-AzStandbyVMPoolStatus `
5050
```
5151

5252
```output
53+
ForecastValueInstancesRequestedCount :
5354
Id : /subscriptions/f8da6e30-a9d8-48ab-b05c-3f7fe482e13b/resourceGroups/test-standbypool/providers/Microsoft.Standb
5455
yPool/standbyVirtualMachinePools/testPool/runtimeViews/latest
5556
InstanceCountSummary : {{
56-
"instanceCountsByState": [
57-
{
58-
"state": "Creating",
59-
"count": 0
60-
},
61-
{
62-
"state": "Starting",
63-
"count": 0
64-
},
65-
{
66-
"state": "Running",
67-
"count": 1
68-
},
69-
{
70-
"state": "Deallocating",
71-
"count": 0
72-
},
73-
{
74-
"state": "Deallocated",
75-
"count": 0
76-
},
77-
{
78-
"state": "Deleting",
79-
"count": 0
80-
}
81-
]
82-
}}
57+
"instanceCountsByState": [
58+
{
59+
"state": "Creating",
60+
"count": 0
61+
},
62+
{
63+
"state": "Starting",
64+
"count": 0
65+
},
66+
{
67+
"state": "Running",
68+
"count": 2
69+
},
70+
{
71+
"state": "Deallocating",
72+
"count": 0
73+
},
74+
{
75+
"state": "Deallocated",
76+
"count": 0
77+
},
78+
{
79+
"state": "Hibernating",
80+
"count": 0
81+
},
82+
{
83+
"state": "Hibernated",
84+
"count": 0
85+
},
86+
{
87+
"state": "Deleting",
88+
"count": 0
89+
}
90+
]
91+
}}
8392
Name : latest
93+
PredictionForecastInfo :
94+
PredictionForecastStartTime :
8495
ProvisioningState : Succeeded
8596
ResourceGroupName : test-standbypool
97+
StatusCode : HealthState/healthy
98+
StatusMessage :
8699
SystemDataCreatedAt :
87100
SystemDataCreatedBy :
88101
SystemDataCreatedByType :

‎src/StandbyPool/StandbyPool.Autorest/docs/New-AzStandbyContainerGroupPool.md

+20-3
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ schema: 2.0.0
88
# New-AzStandbyContainerGroupPool
99

1010
## SYNOPSIS
11-
Create a StandbyContainerGroupPoolResource
11+
create a StandbyContainerGroupPoolResource
1212

1313
## SYNTAX
1414

@@ -17,7 +17,7 @@ Create a StandbyContainerGroupPoolResource
1717
New-AzStandbyContainerGroupPool -Name <String> -ResourceGroupName <String> -Location <String>
1818
[-SubscriptionId <String>] [-ContainerProfileId <String>] [-MaxReadyCapacity <Int64>]
1919
[-ProfileRevision <Int64>] [-RefillPolicy <String>] [-SubnetId <ISubnet[]>] [-Tag <Hashtable>]
20-
[-DefaultProfile <PSObject>] [-AsJob] [-NoWait] [-Confirm] [-WhatIf] [<CommonParameters>]
20+
[-Zone <String[]>] [-DefaultProfile <PSObject>] [-AsJob] [-NoWait] [-Confirm] [-WhatIf] [<CommonParameters>]
2121
```
2222

2323
### CreateViaJsonFilePath
@@ -35,7 +35,7 @@ New-AzStandbyContainerGroupPool -Name <String> -ResourceGroupName <String> -Json
3535
```
3636

3737
## DESCRIPTION
38-
Create a StandbyContainerGroupPoolResource
38+
create a StandbyContainerGroupPoolResource
3939

4040
## EXAMPLES
4141

@@ -51,6 +51,7 @@ New-AzStandbyContainerGroupPool `
5151
-ContainerProfileId /subscriptions/f8da6e30-a9d8-48ab-b05c-3f7fe482e13b/resourcegroups/test-standbypool/providers/Microsoft.ContainerInstance/containerGroupProfiles/testCG `
5252
-ProfileRevision 1 `
5353
-SubnetId @{id="/subscriptions/f8da6e30-a9d8-48ab-b05c-3f7fe482e13b/resourceGroups/test-standbypool/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/default"} `
54+
-Zone @("1", "2", "3") `
5455
```
5556

5657
```output
@@ -75,6 +76,7 @@ SystemDataLastModifiedByType : User
7576
Tag : {
7677
}
7778
Type : microsoft.standbypool/standbycontainergrouppools
79+
Zone : {1, 2, 3}
7880
```
7981

8082
The above command created a standby container pool.
@@ -309,6 +311,21 @@ Accept pipeline input: False
309311
Accept wildcard characters: False
310312
```
311313
314+
### -Zone
315+
Specifies zones of standby container group pools.
316+
317+
```yaml
318+
Type: System.String[]
319+
Parameter Sets: CreateExpanded
320+
Aliases:
321+
322+
Required: False
323+
Position: Named
324+
Default value: None
325+
Accept pipeline input: False
326+
Accept wildcard characters: False
327+
```
328+
312329
### -Confirm
313330
Prompts you for confirmation before running the cmdlet.
314331

‎src/StandbyPool/StandbyPool.Autorest/docs/New-AzStandbyVMPool.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ schema: 2.0.0
88
# New-AzStandbyVMPool
99

1010
## SYNOPSIS
11-
Create a StandbyVirtualMachinePoolResource
11+
create a StandbyVirtualMachinePoolResource
1212

1313
## SYNTAX
1414

@@ -33,7 +33,7 @@ New-AzStandbyVMPool -Name <String> -ResourceGroupName <String> -JsonString <Stri
3333
```
3434

3535
## DESCRIPTION
36-
Create a StandbyVirtualMachinePoolResource
36+
create a StandbyVirtualMachinePoolResource
3737

3838
## EXAMPLES
3939

‎src/StandbyPool/StandbyPool.Autorest/docs/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# Docs
2-
This directory contains the documentation of the cmdlets for the `Az.StandbyPool` module. To run documentation generation, use the `generate-help.ps1` script at the root module folder. Files in this folder will *always be overridden on regeneration*. To update documentation examples, please use the `..\examples` folder.
2+
This directory contains the documentation of the cmdlets for the `Az.StandbyPool` module. To run documentation generation, use the `generate-help.ps1` script at the root module folder. Files in this folder will *always be overridden on regeneration*. To update documentation examples, please use the `../examples` folder.
33

44
## Info
55
- Modifiable: no
@@ -8,4 +8,4 @@ This directory contains the documentation of the cmdlets for the `Az.StandbyPool
88
- Packaged: yes
99

1010
## Details
11-
The process of documentation generation loads `Az.StandbyPool` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) that are generated into the scripts in the `..\exports` folder. Additionally, when writing custom cmdlets in the `..\custom` folder, you can use the help comments syntax, which decorate the exported scripts at build-time. The documentation examples are taken from the `..\examples` folder.
11+
The process of documentation generation loads `Az.StandbyPool` and analyzes the exported cmdlets from the module. It recognizes the [help comments](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_comment_based_help) that are generated into the scripts in the `../exports` folder. Additionally, when writing custom cmdlets in the `../custom` folder, you can use the help comments syntax, which decorate the exported scripts at build-time. The documentation examples are taken from the `../examples` folder.

0 commit comments

Comments
 (0)