Skip to content

add long running operation result to the botservice swagger#3214

Closed
swagatmishra2007 wants to merge 2 commits intoAzure:masterfrom
swagatmishra2007:master
Closed

add long running operation result to the botservice swagger#3214
swagatmishra2007 wants to merge 2 commits intoAzure:masterfrom
swagatmishra2007:master

Conversation

@swagatmishra2007
Copy link
Contributor

@swagatmishra2007 swagatmishra2007 commented Jun 12, 2018

No description provided.

@AutorestCI
Copy link

AutorestCI commented Jun 12, 2018

Automation for azure-libraries-for-java

Nothing to generate for azure-libraries-for-java

@AutorestCI
Copy link

AutorestCI commented Jun 12, 2018

Automation for azure-sdk-for-ruby

Nothing to generate for azure-sdk-for-ruby

@AutorestCI
Copy link

AutorestCI commented Jun 12, 2018

Automation for azure-sdk-for-python

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-python#2337

@AutorestCI
Copy link

AutorestCI commented Jun 12, 2018

Automation for azure-sdk-for-node

Nothing to generate for azure-sdk-for-node

@AutorestCI
Copy link

AutorestCI commented Jun 12, 2018

Automation for azure-sdk-for-go

A PR has been created for you:
Azure/azure-sdk-for-go#2016

Copy link
Contributor

@dsgouda dsgouda left a comment

Choose a reason for hiding this comment

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

Please check the API for its long running-ness

Copy link
Contributor

Choose a reason for hiding this comment

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

GET operations MUST not be long running. If the resource takes a long time to come up, please user provisioning states.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

i added the x-ms-longrunning attribute as autorest was complaining about it, so i have now removed it.
instead of a long running operation we merely want a way to query for an operation result. the operation result operation isnt longrunning itself. sorry for the confusion.

"200": {
"description": "If the operation completed successfully, the service should return 200 (OK)."
},
"202": {
Copy link
Contributor

Choose a reason for hiding this comment

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

On similar lines, not sure if the service is supposed to return a 202 response. 202 status code corresponds to accepted, i.e., the operation as been accepted but not completed. A non-long running GET operation MUST finish and return right away.
Please confirm is the service has undergone an ARM/API review

Copy link
Contributor Author

Choose a reason for hiding this comment

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

the above pattern is directly taken from azure-rest-api-specs\specification\analysisservices\resource-manager\Microsoft.AnalysisServices\stable\2016-05-16\analysisservices.json (please see line 425)

Copy link
Contributor

Choose a reason for hiding this comment

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

The file you pointed out is incorrect too. 202 is simply not acceptable for a GET operation. Does your service actually return that status code?

@dsgouda
Copy link
Contributor

dsgouda commented Jun 20, 2018

@swagatmishra2007 Please address the comments soon, the PR will be closed if not active.

@swagatmishra2007
Copy link
Contributor Author

it seems like we need further discussion on how to get the semantics working here. We were looking at the analysis services swagger and like you pointed out , they arent doing the right thing too. we will follow up on email and then send out a new pr. i am closing this for now. thanks for your comments @dsgouda

@AutorestCI
Copy link

AutorestCI commented Jun 20, 2018

Automation for azure-sdk-for-java

Nothing to generate for azure-sdk-for-java

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

Comments