Skip to content
Merged
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@
"$ref": "#/parameters/CacheControlHeader"
},
{
"$ref": "#/parameters/CreateGroupRequestParameter"
"$ref": "#/parameters/CreateManagementGroupRequestParameter"
}
],
"responses": {
Expand Down Expand Up @@ -1166,7 +1166,8 @@
"in": "path",
"required": true,
"type": "string",
"description": "Subscription ID."
"description": "Subscription ID.",
"x-ms-parameter-location": "method"
},
"ApiVersionParameter": {
"name": "api-version",
Expand Down Expand Up @@ -1194,8 +1195,8 @@
"x-ms-parameter-location": "method",
"description": "The $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload. Note that $expand=children must be passed up if $recurse is set to true."
},
"CreateGroupRequestParameter": {
"name": "createGroupRequest",
"CreateManagementGroupRequestParameter": {
"name": "createManagementGroupRequest",
"in": "body",
"required": true,
"description": "Management group creation parameters.",
Expand Down Expand Up @@ -1261,7 +1262,7 @@
"default": "no-cache",
"description": "Indicates that the request shouldn't utilize any caches.",
"type": "string",
"required": true
"x-ms-parameter-location": "method"
},
"EntityViewParameter": {
"name": "view",
Expand Down
171 changes: 171 additions & 0 deletions specification/managementgroups/resource-manager/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,171 @@
# Management Groups

> see https://aka.ms/autorest

This is the AutoRest configuration file for Management Groups.



---
## Getting Started
To build the SDK for Management Groups, 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 API.

``` yaml
openapi-type: arm
tag: package-2017-11
```

### Tag: package-2018-01
These settings apply only when `--tag=package-2018-01` is specified on the command line.

``` yaml $(tag) == 'package-2018-01'
input-file:
- Microsoft.Management/preview/2018-01-01-preview/management.json
```

### Tag: package-2017-11
These settings apply only when `--tag=package-2017-11` is specified on the command line.

``` yaml $(tag) == 'package-2017-11'
input-file:
- Microsoft.Management/preview/2017-11-01-preview/management.json
```

### Tag: package-2017-08
These settings apply only when `--tag=package-2017-08` is specified on the command line.

``` yaml $(tag) == 'package-2017-08'
input-file:
- Microsoft.Management/preview/2017-08-31-preview/management.json
```

---
# Code Generation


## Swagger to SDK

This section describes what SDK should be generated by the automatic system.
This is not used by Autorest itself.

``` yaml $(swagger-to-sdk)
swagger-to-sdk:
- repo: azure-sdk-for-python
- repo: azure-libraries-for-java
- repo: azure-sdk-for-go
```

## 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.Azure.Management.ManagementGroups
output-folder: $(csharp-sdks-folder)/ManagementGroups/Management.ManagementGroups/Generated
clear-output-folder: true
```

## Python

These settings apply only when `--python` is specified on the command line.
Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.
Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.

``` yaml $(python)
python-mode: create
python:
azure-arm: true
license-header: MICROSOFT_MIT_NO_VERSION
payload-flattening-threshold: 1
namespace: azure.mgmt.managementgroups
package-name: azure-mgmt-managementgroups
clear-output-folder: true
```
``` yaml $(python) && $(python-mode) == 'update'
python:
no-namespace-folders: true
output-folder: $(python-sdks-folder)/azure-mgmt-managementgroups/azure/mgmt/managementgroups
```
``` yaml $(python) && $(python-mode) == 'create'
python:
basic-setup-py: true
output-folder: $(python-sdks-folder)/azure-mgmt-managementgroups
```

## Go

These settings apply only when `--go` is specified on the command line.

``` yaml $(go)
go:
license-header: MICROSOFT_APACHE_NO_VERSION
clear-output-folder: true
namespace: managementgroups
```

### Go multi-api

``` yaml $(go) && $(multiapi)
batch:
- tag: package-2018-01
- tag: package-2017-11
- tag: package-2017-08
```

### Tag: package-2018-01 and go

These settings apply only when `--tag=package-2018-01 --go` is specified on the command line.
Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.

``` yaml $(tag)=='package-2018-01' && $(go)
output-folder: $(go-sdk-folder)/services/managementgroups/mgmt/2018-01-01-preview/managementgroups
```

### Tag: package-2017-11 and go

These settings apply only when `--tag=package-2017-11 --go` is specified on the command line.
Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.

``` yaml $(tag)=='package-2017-11' && $(go)
output-folder: $(go-sdk-folder)/services/managementgroups/mgmt/2017-11-01-preview/managementgroups

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Sorry I wasn't specific enough, please make this change to all of the go packages that you're modifying. :)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done. Thanks

```

### Tag: package-2017-08 and go

These settings apply only when `--tag=package-2017-08 --go` is specified on the command line.
Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.

``` yaml $(tag)=='package-2017-08' && $(go)
output-folder: $(go-sdk-folder)/services/managementgroups/mgmt/2017-08-31-preview/managementgroups

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The Go SDK has already shipped these clients to the former locations, as seen here:
Azure/azure-sdk-for-go@21b6814

Seeing as this would cause a breaking change for us, I'd like to leave the output-folder portion alone. Mind changing these to their old values?

@rajshah11 Raj Shah (rajshah11) Feb 12, 2018

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done. However, I can keep the new paths for the later api versions right? Thanks!

```

## Java

These settings apply only when `--java` is specified on the command line.
Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-libraries-for-java clone>`.

``` yaml $(java)
java:
azure-arm: true
fluent: true
namespace: com.microsoft.azure.management.managementgroups
license-header: MICROSOFT_MIT_NO_CODEGEN
payload-flattening-threshold: 1
output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-managementgroups
```
64 changes: 0 additions & 64 deletions specification/resources/resource-manager/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,10 +56,6 @@ tag: package-links-2016-09
tag: package-managedapplications-2016-09
```

``` yaml $(package-management)
tag: package-management-2017-11
```

### Tag: package-features-2015-12
These settings apply only when `--tag=package-features-2015-12` is specified on the command line.

Expand Down Expand Up @@ -207,30 +203,6 @@ input-file:
- Microsoft.Solutions/preview/2016-09-01-preview/managedapplications.json
```

### Tag: package-management-2018-01
These settings apply only when `--tag=package-management-2018-01` is specified on the command line.

``` yaml $(tag) == 'package-management-2018-01'
input-file:
- Microsoft.Management/preview/2018-01-01-preview/management.json
```

### Tag: package-management-2017-11
These settings apply only when `--tag=package-management-2017-11` is specified on the command line.

``` yaml $(tag) == 'package-management-2017-11'
input-file:
- Microsoft.Management/preview/2017-11-01-preview/management.json
```

### Tag: package-management-2017-08
These settings apply only when `--tag=package-management-2017-08` is specified on the command line.

``` yaml $(tag) == 'package-management-2017-08'
input-file:
- Microsoft.Management/preview/2017-08-31-preview/management.json
```

---
# Code Generation

Expand Down Expand Up @@ -274,7 +246,6 @@ batch:
- package-resources: true
- package-subscriptions: true
- package-links: true
- package-management: true
# - package-managedapplications: true
```

Expand Down Expand Up @@ -309,8 +280,6 @@ batch:
- tag: package-subscriptions-2015-11
- tag: package-links-2016-09
- tag: package-managedapplications-2016-09
- tag: package-management-2017-11
- tag: package-management-2017-08
```

### Tag: package-features-2015-12 and go
Expand Down Expand Up @@ -473,26 +442,6 @@ namespace: managedapplications
output-folder: $(go-sdk-folder)/services/resources/mgmt/2016-09-01-preview/managedapplications
```

### Tag: package-management-2017-11 and go

These settings apply only when `--tag=package-management-2017-11 --go` is specified on the command line.
Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.

``` yaml $(tag) == 'package-management-2017-11' && $(go)
namespace: management
output-folder: $(go-sdk-folder)/services/resources/mgmt/2017-11-01-preview/management
```

### Tag: package-management-2017-08 and go

These settings apply only when `--tag=package-management-2017-08 --go` is specified on the command line.
Please also specify `--go-sdk-folder=<path to the root directory of your azure-sdk-for-go clone>`.

``` yaml $(tag) == 'package-management-2017-08' && $(go)
namespace: management
output-folder: $(go-sdk-folder)/services/resources/mgmt/2017-08-31-preview/management
```

## Python

These settings apply only when `--python` is specified on the command line.
Expand Down Expand Up @@ -528,7 +477,6 @@ batch:
- tag: package-resources-2016-09
- tag: package-resources-2016-02
- tag: package-subscriptions-2016-06
- tag: package-management-2017-11
```

### Tag: package-features-2015-12 and python
Expand Down Expand Up @@ -674,17 +622,6 @@ python:
output-folder: $(python-sdks-folder)/azure-mgmt-resource/azure/mgmt/resource/subscriptions/v2016_06_01
```

### Tag: package-management-2017-11 and python

These settings apply only when `--tag=package-management-2017-11 --python` is specified on the command line.
Please also specify `--python-sdks-folder=<path to the root directory of your azure-sdk-for-python clone>`.

``` yaml $(tag) == 'package-management-2017-11' && $(python)
python:
namespace: azure.mgmt.resource.managementgroups
output-folder: $(python-sdks-folder)/azure-mgmt-resource/azure/mgmt/resource/managementgroups
```

## Java

These settings apply only when `--java` is specified on the command line.
Expand Down Expand Up @@ -712,5 +649,4 @@ batch:
- package-subscriptions: true
- package-links: true
- package-managedapplications: true
- package-management: true
```