Skip to content

add long running operation result to the botservice swagger #3214

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

Closed
swagatmishra2007 wants to merge 2 commits into from
Closed

add long running operation result to the botservice swagger #3214

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
536d817
add long running operation result to the botservice swagger
Jun 12, 2018
7818941
long runnning operation attribute
Jun 13, 2018
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
76 changes: 63 additions & 13 deletions ...ation/botservice/resource-manager/Microsoft.BotService/preview/2017-12-01/botservice.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -683,6 +683,56 @@
}
}
},
"/subscriptions/{subscriptionId}/providers/Microsoft.BotService/locations/{location}/operationresults/{operationId}": {
"get": {
"x-ms-examples": {
"Get Server Details": {
"$ref": "./examples/operationResults.json"
}
},
"tags": [
"Operations"
],
"operationId": "OperationResult_Get",
"description": "List the result of the specified operation.",
"parameters": [
{
"name": "location",
"in": "path",
"required": true,
"type": "string",
"description": "The region name which the operation will lookup into. including 'global'"
},
{
"name": "operationId",
"in": "path",
"required": true,
"type": "string",
"description": "The target operation Id."
},
{
"$ref": "#/parameters/apiVersionParameter"
},
{
"$ref": "#/parameters/subscriptionIdParameter"
}
],
"responses": {
"200": {
"description": "If the operation completed successfully, the service should return 200 (OK)."
},
"202": {
Copy link
Contributor

@dsgouda dsgouda Jun 13, 2018

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

@swagatmishra2007 swagatmishra2007 Jun 13, 2018

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

@dsgouda dsgouda Jun 14, 2018

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?

"description": "If the operation has been accepted and is ongoing, the service should return 202 (Accepted)"
},
"default": {
"description": "Error response describing why the operation failed",
"schema": {
"$ref": "#/definitions/Error"
}
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/BotServices/listServiceProviders": {
"post": {
"tags": [
Expand Down Expand Up @@ -765,7 +815,7 @@
}
}
}
}
}
},
"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.BotService/botServices/{resourceName}/Connections/{connectionName}": {
"put": {
Expand Down Expand Up @@ -1990,7 +2040,7 @@
"description": "Diplay Name of the Service Provider",
"readOnly": true
},
"serviceProviderName": {
"serviceProviderName": {
"type": "string",
"description": "Diplay Name of the Service Provider",
"readOnly": true
Expand Down Expand Up @@ -2212,38 +2262,38 @@
"modelAsString": false,
"values": [
{
"value": "FacebookChannel"
"value": "FacebookChannel"
},
{
"value": "EmailChannel"
"value": "EmailChannel"
},
{
"value": "KikChannel"
"value": "KikChannel"
},
{
"value": "TelegramChannel"
"value": "TelegramChannel"
},
{
"value": "SlackChannel"
"value": "SlackChannel"
},
{
"value": "MsTeamsChannel"
"value": "MsTeamsChannel"
},
{
"value": "SkypeChannel"
"value": "SkypeChannel"
},
{
"value": "WebChatChannel"
"value": "WebChatChannel"
},
{
"value": "DirectLineChannel"
"value": "DirectLineChannel"
},
{
"value": "SmsChannel"
"value": "SmsChannel"
}
]
},
"description": "The name of the Channel resource."
}
}
}
}
16 changes: 16 additions & 0 deletions ...e/resource-manager/Microsoft.BotService/preview/2017-12-01/examples/operationResults.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"parameters": {
"subscriptionId": "613192d7-503f-477a-9cfe-4efc3ee2bd60",
"location": "global",
"operationId": "00000000000000000000000000000000",
"api-version": "2017-12-01"
},
"responses": {
"200": {
"headers": {}
},
"202": {
"headers": {}
}
}
}