Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[Azure Stack] Updates to Azs.Fabric.Admin spec for autorest config #9030

Merged
merged 6 commits into from
Sep 4, 2020
Merged

[Azure Stack] Updates to Azs.Fabric.Admin spec for autorest config #9030

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
e891270
Cumulative commit message:
viananth Mar 26, 2020
da932d4
Address PR comments
viananth May 26, 2020
efb3311
Fix semantic issue
viananth May 26, 2020
c5d6dc0
Reset NasCluster files to master
viananth Aug 3, 2020
afb9047
Add nascluster changes
viananth Aug 3, 2020
9ecb90c
Revert readme.md changes
viananth Aug 31, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions ...on/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2016-05-01/Common.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
{
"swagger": "2.0",
"info": {
"version": "2016-05-01",
"title": "FabricAdminClient",
"description": "The common parameters for Fabric Management specs."
},
"host": "management.azure.com",
"schemes": [
"https"
],
"produces": [
"application/json"
],
"consumes": [
"application/json"
],
"paths": {},
"parameters": {
"TopParameter": {
"description": "OData top parameter.",
"name": "$top",
"in": "query",
"type": "string",
"x-ms-parameter-location": "method"
},
"SkipParameter": {
"description": "OData skip parameter.",
"name": "$skip",
"in": "query",
"type": "string",
"x-ms-parameter-location": "method"
}
}
}
6 changes: 6 additions & 0 deletions ...azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2016-05-01/FileShare.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,12 @@
},
{
"$ref": "Fabric.json#/parameters/FilterParameter"
},
{
"$ref": "Common.json#/parameters/TopParameter"
},
{
"$ref": "Common.json#/parameters/SkipParameter"
}
],
"responses": {
Expand Down
6 changes: 6 additions & 0 deletions ...n/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2018-10-01/StorageSubSystem.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,12 @@
},
{
"$ref": "../2016-05-01/Fabric.json#/parameters/FilterParameter"
},
{
bganapa marked this conversation as resolved.
Show resolved Hide resolved
"$ref": "../2016-05-01/Common.json#/parameters/TopParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/SkipParameter"
}
],
"responses": {
Expand Down
6 changes: 6 additions & 0 deletions ...ion/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2019-05-01/Drive.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,12 @@
},
{
"$ref": "../2016-05-01/Fabric.json#/parameters/FilterParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/TopParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/SkipParameter"
}
],
"responses": {
Expand Down
6 changes: 6 additions & 0 deletions ...zsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2019-05-01/NasCluster.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,12 @@
},
{
"$ref": "../2016-05-01/Fabric.json#/parameters/FilterParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/TopParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/SkipParameter"
}
],
"responses": {
Expand Down
6 changes: 6 additions & 0 deletions ...on/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2019-05-01/Volume.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,12 @@
},
{
"$ref": "../2016-05-01/Fabric.json#/parameters/FilterParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/TopParameter"
},
{
"$ref": "../2016-05-01/Common.json#/parameters/SkipParameter"
}
],
"responses": {
Expand Down
72 changes: 72 additions & 0 deletions specification/azsadmin/resource-manager/fabric/readme.azsautogen.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Fabric Admin
bganapa marked this conversation as resolved.
Show resolved Hide resolved

> see https://aka.ms/autorest

This is the AutoRest configuration file for Fabric Admin.

---
## Getting Started
To build the SDK for Fabric Admin, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:

> `autorest`

To see additional help and options, run:

> `autorest --help`
---

## Configuration

### Basic Information
These are the global settings for the Fabric API.

``` yaml
title: FabricAdminClient
description: Fabric Admin Client
openapi-type: arm
tag: package-2019-05-01
```

``` yaml
input-file:
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ApplicationOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ComputeOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/Fabric.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/EdgeGateway.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/EdgeGatewayPool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/FabricLocation.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/FileShare.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/InfraRole.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/InfraRoleInstance.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/IpPool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/LogicalNetwork.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/LogicalSubnet.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/MacAddressPool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/NetworkOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ScaleUnit.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ScaleUnitNode.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/SlbMuxInstance.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/StorageOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2018-10-01/StorageSubSystem.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Drive.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Volume.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/NasCluster.json"
```

---
# Code Generation

## C#

These settings apply only when `--csharp` is specified on the command line.
Please also specify `--csharp-sdks-folder=<path to "SDKs" directory of your azure-sdk-for-net clone>`.

``` yaml $(csharp)
csharp:
azure-arm: true
license-header: MICROSOFT_MIT_NO_VERSION
namespace: Microsoft.AzureStack.Management.Fabric.Admin
payload-flattening-threshold: 1
output-folder: $(csharp-sdks-folder)/Generated
clear-output-folder: true
```
52 changes: 0 additions & 52 deletions specification/azsadmin/resource-manager/fabric/readme.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -130,7 +130,6 @@ directive:
reason: externalDNSIPAddress02 is a customized name, no camel case restriction needed.
```

---
# Code Generation

## C#
Expand All @@ -147,54 +146,3 @@ csharp:
output-folder: $(csharp-sdks-folder)/Generated
clear-output-folder: true
```

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi, why do we remove this part? Should we bring it back too?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This part is added in readme.azsautogen.md for autorest generation config.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this one is used for autorest v3?

## Multi-API/Profile support for AutoRest v3 generators

AutoRest V3 generators require the use of `--tag=all-api-versions` to select api files.

This block is updated by an automatic script. Edits may be lost!

``` yaml $(tag) == 'all-api-versions' /* autogenerated */
# include the azure profile definitions from the standard location
require: $(this-folder)/../../../../profiles/readme.md

# all the input files across all versions
input-file:
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ApplicationOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ComputeOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/Fabric.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/EdgeGateway.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/EdgeGatewayPool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/FabricLocation.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/FileShare.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/InfraRole.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/InfraRoleInstance.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/IpPool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/LogicalNetwork.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/StoragePool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/StorageSystem.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/Volume.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/LogicalSubnet.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/MacAddressPool.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/NetworkOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ScaleUnit.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/ScaleUnitNode.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/SlbMuxInstance.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2016-05-01/StorageOperationResults.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2018-10-01/Drive.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2018-10-01/StorageSubSystem.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2018-10-01/Volume.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Drive.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Volume.json
- $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/NasCluster.json

```

If there are files that should not be in the `all-api-versions` set,
uncomment the `exclude-file` section below and add the file paths.

``` yaml $(tag) == 'all-api-versions'
#exclude-file:
# - $(this-folder)/Microsoft.Example/stable/2010-01-01/somefile.json
```