Skip to content
Open
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
[assembly: System.Reflection.AssemblyCopyrightAttribute("Copyright © Microsoft")]
[assembly: System.Reflection.AssemblyProductAttribute("Microsoft Azure PowerShell")]
[assembly: System.Reflection.AssemblyTitleAttribute("Microsoft Azure PowerShell - NetworkCloud")]
[assembly: System.Reflection.AssemblyFileVersionAttribute("1.2.0")]
[assembly: System.Reflection.AssemblyVersionAttribute("1.2.0")]
[assembly: System.Reflection.AssemblyFileVersionAttribute("2.0.0")]
[assembly: System.Reflection.AssemblyVersionAttribute("2.0.0")]
[assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)]
[assembly: System.CLSCompliantAttribute(false)]
120 changes: 31 additions & 89 deletions src/NetworkCloud/NetworkCloud.Autorest/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,15 +28,15 @@ For information on how to develop for `Az.NetworkCloud`, see [how-to.md](how-to.

```yaml
# pin the swagger version by using the commit id instead of branch name : https://github.com/Azure/azure-rest-api-specs/
# the 2025-02-01 stable in a commit: 08973141b0d31a7e75d4dc43a5224a1814a0994f
commit: 08973141b0d31a7e75d4dc43a5224a1814a0994f
# the 2025-09-01 stable in a commit: ccd751d5bf9d1457426de7fe6d857a4cfe890cd5
commit: ccd751d5bf9d1457426de7fe6d857a4cfe890cd5
require:
# readme.azure.noprofile.md is the common configuration file
- $(this-folder)/../../readme.azure.noprofile.md
- $(repo)/specification/networkcloud/resource-manager/readme.md
input-file:
# You need to specify your swagger files here.
- $(repo)/specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-02-01/networkcloud.json
- $(repo)/specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/networkcloud.json

# For new RP, the version is 0.1.0
module-version: 0.1.0
Expand All @@ -45,32 +45,26 @@ title: NetworkCloud
service-name: NetworkCloud
subject-prefix: NetworkCloud

# If there are post APIs for some kinds of actions in the RP, you may need to
# uncomment following line to support viaIdentity for these post APIs
identity-correction-for-post: true
resourcegroup-append: true
nested-object-to-string: true

# For new modules, please avoid setting 3.x using the use-extension method and instead, use 4.x as the default option
use-extension:
"@autorest/powershell": "3.x"

directive:
# Fix model definition line break replacement issue
- from: swagger-document
where: $.definitions.L3NetworkProperties.properties.ipv4ConnectedPrefix
transform: $['description'] = 'The IPV4 prefix (CIDR) assigned to this L3 network. Required when the IP allocation type is IPV4 or DualStack.'
- from: swagger-document
where: $.definitions.L3NetworkProperties.properties.ipv6ConnectedPrefix
transform: $['description'] = 'The IPV6 prefix (CIDR) assigned to this L3 network. Required when the IP allocation type is IPV6 or DualStack.'
- from: swagger-document
where: $.definitions.BareMetalMachinePatchProperties.properties.machineDetails
transform: $['description'] = 'The details provided by the customer during the creation of rack manifests that allows for custom data to be associated with this machine.'
- from: swagger-document
where: $.definitions.ClusterProperties.properties.computeRackDefinitions
transform: $['description'] = 'The list of rack definitions for the compute racks in a multi-rack cluster, or an empty list in a single-rack cluster.'
# Following is two common directive which are normally required in all the RPs
# 1. Remove the unexpanded parameter set
# 2. For New-* cmdlets, ViaIdentity is not required, so CreateViaIdentityExpanded is removed as well
- where:
variant: ^(Create|Update|Cordon|Deploy|Enable|Replace|Run|PowerOff)(?!.*?(Expanded|JsonFilePath|JsonString))
remove: true
- where:
variant: ^CreateViaIdentityExpanded$
variant: ^Create$|^CreateViaIdentity$|^CreateViaIdentityExpanded$|^Update$|^UpdateViaIdentity$|^Cordon$|^CordonViaIdentity$|^DeployViaIdentity$|^Deploy$|^Enable$|^EnableViaIdentity$|^Replace$|^ReplaceViaIdentity$|^Run$|^RunViaIdentity$|^PowerOff$|^PowerOffViaIdentity$
remove: true
- where:
subject: KuberneteClusterNode
variant: ^(Restart)(?!.*?(Expanded|JsonFilePath|JsonString))
variant: ^Restart$|^RestartViaIdentity$
remove: true
# Remove the set-* cmdlet
- where:
Expand Down Expand Up @@ -293,74 +287,22 @@ directive:
- from: swagger-document
where: $.definitions.ServicePrincipalInformation.properties.password
transform: $.format = "password"
# Fix required property missing mutability
- from: swagger-document
where: $.definitions.BgpAdvertisement.properties.ipAddressPools
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.ControlPlaneNodeConfiguration.properties.vmSkuName
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.InitialAgentPoolConfiguration.properties.count
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.InitialAgentPoolConfiguration.properties.mode
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.InitialAgentPoolConfiguration.properties.vmSkuName
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.InitialAgentPoolConfiguration.properties.name
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.IpAddressPool.properties.name
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.L3NetworkAttachmentConfiguration.properties.networkId
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.NetworkAttachment.properties.attachedNetworkId
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.NetworkAttachment.properties.ipAllocationMethod
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.ServiceLoadBalancerBgpPeer.properties.name
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.ServiceLoadBalancerBgpPeer.properties.peerAddress
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.ServiceLoadBalancerBgpPeer.properties.peerAsn
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.VirtualMachinePlacementHint.properties.hintType
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.VirtualMachinePlacementHint.properties.schedulingExecution
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.VirtualMachinePlacementHint.properties.resourceId
transform: $['x-ms-mutability'] = ["read", "update", "create"]
- from: swagger-document
where: $.definitions.VirtualMachinePlacementHint.properties.scope
transform: $['x-ms-mutability'] = ["read", "update", "create"]


# Add model-cmdlet for any properties/sub-properties of complex type
- model-cmdlet:
- model-name: BareMetalMachineConfigurationData
- model-name: BgpAdvertisement
- model-name: BgpServiceLoadBalancerConfiguration
- model-name: ControlPlaneNodeConfiguration
- model-name: EgressEndpoint
- model-name: EndpointDependency
- model-name: InitialAgentPoolConfiguration
- model-name: IpAddressPool
- model-name: KeySetUser
- model-name: L3NetworkAttachmentConfiguration
- model-name: NetworkAttachment
- model-name: RackDefinition
- model-name: ServiceLoadBalancerBgpPeer
- model-name: StorageApplianceConfigurationData
- model-name: VirtualMachinePlacementHint
- BareMetalMachineConfigurationData
- BgpAdvertisement
- BgpServiceLoadBalancerConfiguration
- ControlPlaneNodeConfiguration
- EgressEndpoint
- EndpointDependency
- InitialAgentPoolConfiguration
- IpAddressPool
- KeySetUser
- L3NetworkAttachmentConfiguration
- NetworkAttachment
- RackDefinition
- ServiceLoadBalancerBgpPeer
- StorageApplianceConfigurationData
- VirtualMachinePlacementHint
```
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "bareMetalMachines",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "cloudServicesNetworks",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "clusterManagers",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "clusters/bareMetalMachineKeySets",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "clusters/bmcKeySets",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "clusters/metricsConfigurations",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "clusters",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down Expand Up @@ -43,6 +43,82 @@
}
]
},
{
"name": "Invoke-AzNetworkCloudClusterContinueVersionUpdate",
"description": "Trigger the continuation of an update for a cluster with a matching update strategy that has paused after completing a segment of the update.",
"path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/continueUpdateVersion",
"help": {
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud/invoke-aznetworkcloudclustercontinueversionupdate"
},
"parameterSets": [
{
"parameters": [
"-ClusterName <String>",
"-ResourceGroupName <String>",
"[-SubscriptionId <String>]"
]
}
]
},
"examples": [
{
"description": "Trigger the continuation of an update for a cluster with a matching update strategy that has paused after completing a segment of the update.",
"parameters": [
{
"name": "-ClusterName",
"value": "[Path.clusterName]"
},
{
"name": "-ResourceGroupName",
"value": "[Path.resourceGroupName]"
},
{
"name": "-SubscriptionId",
"value": "[Path.subscriptionId]"
}
]
}
]
},
{
"name": "Invoke-AzNetworkCloudScanClusterRuntime",
"description": "Triggers the execution of a runtime protection scan to detect and remediate detected issues, in accordance with the cluster configuration.",
"path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/clusters/{clusterName}/scanRuntime",
"help": {
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud/invoke-aznetworkcloudscanclusterruntime"
},
"parameterSets": [
{
"parameters": [
"-ClusterName <String>",
"-ResourceGroupName <String>",
"[-SubscriptionId <String>]"
]
}
]
},
"examples": [
{
"description": "Triggers the execution of a runtime protection scan to detect and remediate detected issues, in accordance with the cluster configuration.",
"parameters": [
{
"name": "-ClusterName",
"value": "[Path.clusterName]"
},
{
"name": "-ResourceGroupName",
"value": "[Path.resourceGroupName]"
},
{
"name": "-SubscriptionId",
"value": "[Path.subscriptionId]"
}
]
}
]
},
{
"name": "Remove-AzNetworkCloudCluster",
"description": "Delete the provided cluster.",
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "kubernetesClusters/agentPools",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "kubernetesClusters/features",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "kubernetesClusters",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "l2Networks",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "l3Networks",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "rackSkus",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "racks",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "storageAppliances",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "trunkedNetworks",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "virtualMachines/consoles",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "virtualMachines",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"resourceType": "volumes",
"apiVersion": "2025-02-01",
"apiVersion": "2025-09-01",
"learnMore": {
"url": "https://learn.microsoft.com/powershell/module/az.networkcloud"
},
Expand Down
Loading
Loading