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.

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

Add new backup discovery API. Fix error codes for source control API,… #3195

Merged
merged 7 commits into from
Jul 12, 2018
Merged

Add new backup discovery API. Fix error codes for source control API,… #3195

merged 7 commits into from
Jul 12, 2018

Conversation

naveedaz
Copy link
Contributor

@naveedaz naveedaz commented Jun 7, 2018

… Move DeletedSite to common definition

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

@AutorestCI
Copy link

AutorestCI commented Jun 7, 2018

Automation for azure-sdk-for-go

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

@AutorestCI
Copy link

AutorestCI commented Jun 7, 2018

Automation for azure-sdk-for-python

Nothing to generate for azure-sdk-for-python

@AutorestCI
Copy link

AutorestCI commented Jun 7, 2018

Automation for azure-sdk-for-ruby

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

@AutorestCI
Copy link

AutorestCI commented Jun 7, 2018

Automation for azure-libraries-for-java

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:
AutorestCI/azure-libraries-for-java#4

@AutorestCI
Copy link

AutorestCI commented Jun 7, 2018

Automation for azure-sdk-for-node

Nothing to generate for azure-sdk-for-node

@anuchandy
Copy link
Member

@naveedaz
Copy link
Contributor Author

naveedaz commented Jun 8, 2018

@anuchandy Fixed.

},
"description": {
"description": "** New Implementation Only **\nDescription.",
"type": "string"
Copy link
Member

Choose a reason for hiding this comment

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

can you provide description for all these new properties?

"deletedSiteId": {
"format": "int32",
"description": "Numeric id for the deleted site",
"type": "integer"
Copy link
Member

Choose a reason for hiding this comment

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

is this property deletedSiteId eligible to be marked as readonly?

"type": "string"
},
"blobDuration": {
"type": "string"
Copy link
Member

Choose a reason for hiding this comment

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

Is this a numeric value? if so should we use one of the numeric types?

"x-ms-mutability": [
"create"
]
},
Copy link
Member

Choose a reason for hiding this comment

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

Removing property is breaking change, this should be done as part of new api-version

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@anuchandy Api version 2018-02-01 is not part of the default package tag so no clients are generated from it yet. 2018-02-01 is a new version. https://github.com/Azure/azure-rest-api-specs/blob/master/specification/web/resource-manager/readme.md#basic-information

@@ -1989,7 +2073,7 @@
"description": "Linux App Framework and version",
"type": "string"
},
"xenonFxVersion": {
"windowsFxVersion": {
Copy link
Member

Choose a reason for hiding this comment

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

This is a breaking change (renaming of properties from the payload), should be done as part of new api version

},
"isXenon": {
"description": "<code>true</code> if App Service plan is running as a windows container",
"type": "boolean"
Copy link
Member

Choose a reason for hiding this comment

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

above we are renaming xenonFxVersion to windowsFxVersion, which means having isXenon property instead of isWindows is inconsistent right?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This distinguishes between windows and xenon windows and is therefore expected.

"schema": {
"$ref": "#/definitions/SwiftVirtualNetwork"
}
},
Copy link
Member

Choose a reason for hiding this comment

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

is this a long running operation?, if yes model it accordingly

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Not an LRO

"responses": {
"200": {
"description": "Succesfully deleted virtual network."
},
Copy link
Member

Choose a reason for hiding this comment

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

is this LRO?

"schema": {
"$ref": "#/definitions/SwiftVirtualNetwork"
}
},
Copy link
Member

Choose a reason for hiding this comment

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

Is this a LRO?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Not an LRO

"schema": {
"$ref": "#/definitions/RestoreRequest"
}
},
Copy link
Member

Choose a reason for hiding this comment

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

is restore a long running operation?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Not an LRO.

Copy link
Member

@anuchandy anuchandy left a comment

Choose a reason for hiding this comment

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

see comments

@anuchandy
Copy link
Member

@naveedaz thanks for confirming that there is no SDK released for the api-version 2018-02-01.

There are other feedbacks (not related to breaking changes), can you address them?

@AutorestCI
Copy link

AutorestCI commented Jun 19, 2018

Automation for azure-sdk-for-java

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-java#2218

@naveedaz
Copy link
Contributor Author

@anuchandy Please take a look.

@anuchandy anuchandy added the WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required label Jun 27, 2018
@anuchandy anuchandy requested a review from ravbhatnagar June 27, 2018 15:49
@anuchandy
Copy link
Member

Looking at this PR #2802, Gaurav mentioned that this api-version (2018-02-01) is already deployed. Though this api-version is not part of default package (hence no SDK generated and no breaking change in SDK), in the api-level they are still breaking. Hence i'm requesting ARM to take a look and signoff. cc @ravbhatnagar

@ravbhatnagar
Copy link
Contributor

@naveedaz - Removing snapshotInfo from sites is technically a breaking change? Is it being used through this api-version? Will there be a customer impact of removing it if its being used via another client (portal or custom)?

@naveedaz
Copy link
Contributor Author

naveedaz commented Jul 5, 2018

@Nking92 Can you elaborate on how this property was never used.

@nking-1
Copy link

nking-1 commented Jul 5, 2018

Regarding snapshotInfo - this property was never supported and should have been hidden from Swagger, but I forgot to mark it as "ignored". It was intended for an experimental feature for creating a new app from a snapshot, but we don't support that feature now. It would be best to get rid of it. I doubt any customers have a dependency on it. We created an alternative set of APIs for restoring from snapshots that customers should use instead.

@veronicagg
Copy link
Contributor

ping @ravbhatnagar

@ravbhatnagar
Copy link
Contributor

based on ACK from RP that this property is not supported, good to remove.

@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 Jul 12, 2018
@naveedaz
Copy link
Contributor Author

@anuchandy @veronicagg Can you please merge.

@veronicagg veronicagg dismissed anuchandy’s stale review July 12, 2018 23:43

Anu is OOF, so I'm merging for him

Copy link
Contributor

@veronicagg veronicagg left a comment

Choose a reason for hiding this comment

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

Reviewed by @anuchandy already.

@veronicagg veronicagg merged commit 52e7778 into Azure:master Jul 12, 2018
@naveedaz
Copy link
Contributor Author

Thanks @veronicagg

@jianghaolu
Copy link
Contributor

#3195 (comment) was never addressed. Java SDK hurts now 😭

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants