Skip to content
New issue

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

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

Already on GitHub? # to your account

Add Management Groups 2018-03-01-preview version #3064

Merged
merged 5 commits into from
May 18, 2018

Conversation

rajshah11
Copy link
Contributor

@rajshah11 rajshah11 commented May 14, 2018

This checklist is used to make sure that common issues in a pull request are addressed. This will expedite the process of getting your pull request merged and avoid extra work on your part to fix issues discovered during the review process.

PR information

  • The title of the PR is clear and informative.
  • There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For information on cleaning up the commits in your pull request, see this page.
  • Except for special cases involving multiple contributors, the PR is started from a fork of the main repository, not a branch.
  • If applicable, the PR references the bug/issue that it fixes.
  • Swagger files are correctly named (e.g. the api-version in the path should match the api-version in the spec).

Quality of Swagger

@azuresdkciprbot
Copy link

AutoRest linter results for ARM Related Validation Errors/Warnings

These errors are reported by the ARM team's validation tools, reachout to ARM RP API Review directly for any questions or concerns.

File: specification/managementgroups/resource-manager/readme.md

⚠️0 new Warnings.(1 total)
0 new Errors.(0 total)

AutoRest Linter Guidelines | AutoRest Linter Issues | Send feedback

Thanks for your co-operation.

@azuresdkciprbot
Copy link

AutoRest linter results for SDK Related Validation Errors/Warnings

These errors are reported by the SDK team's validation tools, reachout to ADX Swagger Reviewers directly for any questions or concerns.

File: specification/managementgroups/resource-manager/readme.md

⚠️2 new Warnings.(2 total)
Code Id Source Message
PostOperationIdContainsUrlVerb R2066 Link OperationId should contain the verb: 'getentities' in:'Entities_List'. Consider updating the operationId
LongRunningOperationsWithLongRunningExtension R2007 Link The operation 'StartTenantBackfill' returns 202 status code, which indicates a long running operation, please enable "x-ms-long-running-operation.
0 new Errors.(0 total)

AutoRest Linter Guidelines | AutoRest Linter Issues | Send feedback

Thanks for your co-operation.

@annatisch
Copy link
Member

Thanks @rajshah11 - could you take a look at the model validation errors:
https://travis-ci.org/Azure/azure-rest-api-specs/jobs/378549766

@annatisch annatisch added the WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required label May 15, 2018
@annatisch
Copy link
Member

@ravbhatnagar - looks like we have a new preview API for you to review :)
FYI @rajshah11

@AutorestCI
Copy link

AutorestCI commented May 17, 2018

Automation for azure-sdk-for-node

Nothing to generate for azure-sdk-for-node

@AutorestCI
Copy link

AutorestCI commented May 17, 2018

Automation for azure-sdk-for-python

The initial PR has been merged into your service PR:
Azure/azure-sdk-for-python#2520

@AutorestCI
Copy link

AutorestCI commented May 17, 2018

Automation for azure-libraries-for-java

The initial PR has been merged into your service PR:
AutorestCI/azure-libraries-for-java#135

@AutorestCI
Copy link

AutorestCI commented May 17, 2018

Automation for azure-sdk-for-go

A PR has been created for you based on this PR content.

Once this PR will be merged, content will be added to your service PR:
Azure/azure-sdk-for-go#1868

@rajshah11 rajshah11 force-pushed the mgmt-groups-2018-preview branch from 025c1ca to 8ba3955 Compare May 18, 2018 01:20
@ravbhatnagar ravbhatnagar added ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels May 18, 2018
@ravbhatnagar
Copy link
Contributor

Looks good.

Copy link
Member

@annatisch annatisch left a comment

Choose a reason for hiding this comment

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

Some small fixes are needed:

  • please remove all the newline characters from the end of descriptions.
  • please make query parameters located on the method rather than client.
  • please fix the last model validation error in the CI

"in": "query",
"required": false,
"type": "string",
"description": "Page continuation token is only used if a previous operation returned a partial result. \nIf a previous response contains a nextLink element, the value of the nextLink element will include a token parameter that specifies a starting point to use for subsequent calls.\n",
Copy link
Member

Choose a reason for hiding this comment

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

Please remove newline from the end of descriptions.

"info": {
"version": "2018-03-01-preview",
"title": "Management Groups API",
"description": "The Azure Management Groups API enables consolidation of multiple \nsubscriptions/resources into an organizational hierarchy and centrally \nmanage access control, policies, alerting and reporting for those resources.\n"
Copy link
Member

Choose a reason for hiding this comment

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

Please remove newline from the end of description.

"tags": [
{
"name": "ManagementGroups",
"description": "A Management Group is a customer defined scope (grouping mechanism) that \nprovides access control (authorization), policy management and reporting. \nManagement Groups are organized in a strictly tree-based hierarchy.\n"
Copy link
Member

Choose a reason for hiding this comment

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

Please remove newline from the end of description.

},
{
"name": "Operations",
"description": "Management operations supported by the Microsoft.Management resource provider.\n"
Copy link
Member

Choose a reason for hiding this comment

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

Please remove newline from the end of description.

},
{
"name": "Entities",
"description": "A list of entities that belong to the Management Groups.\n"
Copy link
Member

Choose a reason for hiding this comment

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

Please remove newline from the end of description.

"delete"
],
"description": "The id of the operation result.",
"x-ms-parameter-location": "client"
Copy link
Member

Choose a reason for hiding this comment

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

The parameter location needs to be "method"

"schema": {
"$ref": "#/definitions/PatchManagementGroupRequest"
},
"x-ms-parameter-location": "client"
Copy link
Member

Choose a reason for hiding this comment

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

The parameter location needs to be "method"

"schema": {
"$ref": "#/definitions/CreateManagementGroupRequest"
},
"x-ms-parameter-location": "client"
Copy link
Member

Choose a reason for hiding this comment

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

The parameter location needs to be "method"

"required": false,
"type": "integer",
"description": "Number of elements to return when retrieving results. Passing this in will override $skipToken.",
"x-ms-parameter-location": "client"
Copy link
Member

Choose a reason for hiding this comment

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

The parameter location needs to be "method"

"required": false,
"type": "string",
"description": "Page continuation token is only used if a previous operation returned a partial result. \nIf a previous response contains a nextLink element, the value of the nextLink element will include a token parameter that specifies a starting point to use for subsequent calls.\n",
"x-ms-parameter-location": "client"
Copy link
Member

Choose a reason for hiding this comment

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

The parameter location needs to be "method"

@rajshah11 rajshah11 force-pushed the mgmt-groups-2018-preview branch from 9bcdff3 to 4f0f311 Compare May 18, 2018 19:31
"$ref": "./examples/GetEntities.json"
}
},
"x-ms-long-running-operation": true
Copy link
Member

Choose a reason for hiding this comment

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

@rajshah11 - can you confirm that this list operation is indeed also a long running operation?

@rajshah11 rajshah11 force-pushed the mgmt-groups-2018-preview branch from 2774e2f to 29f23e0 Compare May 18, 2018 21:54
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants