{"action":"created","comment":{"url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/comments/120409451","pull_request_review_id":42369954,"id":120409451,"diff_hunk":"@@ -387,15 +387,15 @@ $ curl http://username:password@broker-url/v2/service_instances/:instance_id?acc\n ```\n \n ### Response\n-\n | Status Code | Description |\n-| --- | --- |\n-| 201 Created | Service instance has been provisioned. The expected response body is below. |\n-| 200 OK | MAY be returned if the service instance already exists and the requested parameters are identical to the existing service instance. The expected response body is below. |\n-| 202 Accepted | Service instance provisioning is in progress. This triggers the platform marketplace to poll the [Last Operation](#polling-last-operation) endpoint for operation status. |\n+|---|---|\n+| 200 OK | MUST be returned if the service instance already exists, is fully provisioned, and the requested parameters are identical to the existing service instance. The expected response body is below. |\n+| 201 Created | MUST be returned if the service instance was provisioned as a result of this request. The expected response body is below. |\n+| 202 Accepted | MUST be returned if the service instance provisioning is in progress. This triggers the platform marketplace to poll the [Service Instance Last Operation Endpoint](#polling-last-operation) for operation status. Note that a re-sent `PUT` request MUST return a `202 Accepted`, not a `200 OK`, if the service instance is not yet fully provisioned. |\n | 409 Conflict | MUST be returned if a service instance with the same id already exists but with different attributes. The expected response body is `{}`. |\n | 422 Unprocessable Entity | MUST be returned if the broker only supports asynchronous provisioning for the requested plan and the request did not include `?accepts_incomplete=true`. The expected response body is: `{ \"error\": \"AsyncRequired\", \"description\": \"This service plan requires client support for asynchronous service operations.\" }`, as described below. |\n \n+","path":"spec.md","position":44,"original_position":44,"commit_id":"0b055a11c691692430e089bfe092a25b611b2591","original_commit_id":"0b055a11c691692430e089bfe092a25b611b2591","user":{"login":"duglin","id":1944671,"avatar_url":"https://avatars2.githubusercontent.com/u/1944671?v=3","gravatar_id":"","url":"https://api.github.com/users/duglin","html_url":"https://github.com/duglin","followers_url":"https://api.github.com/users/duglin/followers","following_url":"https://api.github.com/users/duglin/following{/other_user}","gists_url":"https://api.github.com/users/duglin/gists{/gist_id}","starred_url":"https://api.github.com/users/duglin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/duglin/subscriptions","organizations_url":"https://api.github.com/users/duglin/orgs","repos_url":"https://api.github.com/users/duglin/repos","events_url":"https://api.github.com/users/duglin/events{/privacy}","received_events_url":"https://api.github.com/users/duglin/received_events","type":"User","site_admin":false},"body":"removed","created_at":"2017-06-06T16:23:19Z","updated_at":"2017-06-06T16:23:19Z","html_url":"https://github.com/openservicebrokerapi/servicebroker/pull/178#discussion_r120409451","pull_request_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178","_links":{"self":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/comments/120409451"},"html":{"href":"https://github.com/openservicebrokerapi/servicebroker/pull/178#discussion_r120409451"},"pull_request":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178"}}},"pull_request":{"url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178","id":118775958,"html_url":"https://github.com/openservicebrokerapi/servicebroker/pull/178","diff_url":"https://github.com/openservicebrokerapi/servicebroker/pull/178.diff","patch_url":"https://github.com/openservicebrokerapi/servicebroker/pull/178.patch","issue_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues/178","number":178,"state":"open","locked":false,"title":"Clean-up some text around our status codes","user":{"login":"duglin","id":1944671,"avatar_url":"https://avatars2.githubusercontent.com/u/1944671?v=3","gravatar_id":"","url":"https://api.github.com/users/duglin","html_url":"https://github.com/duglin","followers_url":"https://api.github.com/users/duglin/followers","following_url":"https://api.github.com/users/duglin/following{/other_user}","gists_url":"https://api.github.com/users/duglin/gists{/gist_id}","starred_url":"https://api.github.com/users/duglin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/duglin/subscriptions","organizations_url":"https://api.github.com/users/duglin/orgs","repos_url":"https://api.github.com/users/duglin/repos","events_url":"https://api.github.com/users/duglin/events{/privacy}","received_events_url":"https://api.github.com/users/duglin/received_events","type":"User","site_admin":false},"body":"Follow-on to this comment: https://github.com/openservicebrokerapi/servicebroker/pull/166/files#r113097103\r\n\r\nChanges:\r\n- Add MUSTs/MAYs on each status code in the tables\r\n- Add a 404 as the more appropriate response after a DELETE, not 410\r\n- Allow for a 200 in spots where it was missing\r\n- Clarify things, like when a conflict happens\r\n- lots of typographical changes (spaces, wrong casing, etc...) - nits\r\n\r\nSigned-off-by: Doug Davis <dug@us.ibm.com>","created_at":"2017-05-03T14:33:56Z","updated_at":"2017-06-06T16:23:19Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ba501c1912344474dd41fba6091371487c3e559a","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":{"url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/milestones/1","html_url":"https://github.com/openservicebrokerapi/servicebroker/milestone/1","labels_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/milestones/1/labels","id":2540185,"number":1,"title":"2.12","description":null,"creator":{"login":"avade","id":491991,"avatar_url":"https://avatars0.githubusercontent.com/u/491991?v=3","gravatar_id":"","url":"https://api.github.com/users/avade","html_url":"https://github.com/avade","followers_url":"https://api.github.com/users/avade/followers","following_url":"https://api.github.com/users/avade/following{/other_user}","gists_url":"https://api.github.com/users/avade/gists{/gist_id}","starred_url":"https://api.github.com/users/avade/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/avade/subscriptions","organizations_url":"https://api.github.com/users/avade/orgs","repos_url":"https://api.github.com/users/avade/repos","events_url":"https://api.github.com/users/avade/events{/privacy}","received_events_url":"https://api.github.com/users/avade/received_events","type":"User","site_admin":false},"open_issues":10,"closed_issues":5,"state":"open","created_at":"2017-05-24T09:12:44Z","updated_at":"2017-06-06T14:49:02Z","due_on":null,"closed_at":null},"commits_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178/commits","review_comments_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178/comments","review_comment_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/comments{/number}","comments_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues/178/comments","statuses_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/statuses/0b055a11c691692430e089bfe092a25b611b2591","head":{"label":"duglin:clarify202","ref":"clarify202","sha":"0b055a11c691692430e089bfe092a25b611b2591","user":{"login":"duglin","id":1944671,"avatar_url":"https://avatars2.githubusercontent.com/u/1944671?v=3","gravatar_id":"","url":"https://api.github.com/users/duglin","html_url":"https://github.com/duglin","followers_url":"https://api.github.com/users/duglin/followers","following_url":"https://api.github.com/users/duglin/following{/other_user}","gists_url":"https://api.github.com/users/duglin/gists{/gist_id}","starred_url":"https://api.github.com/users/duglin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/duglin/subscriptions","organizations_url":"https://api.github.com/users/duglin/orgs","repos_url":"https://api.github.com/users/duglin/repos","events_url":"https://api.github.com/users/duglin/events{/privacy}","received_events_url":"https://api.github.com/users/duglin/received_events","type":"User","site_admin":false},"repo":{"id":62855819,"name":"servicebroker","full_name":"duglin/servicebroker","owner":{"login":"duglin","id":1944671,"avatar_url":"https://avatars2.githubusercontent.com/u/1944671?v=3","gravatar_id":"","url":"https://api.github.com/users/duglin","html_url":"https://github.com/duglin","followers_url":"https://api.github.com/users/duglin/followers","following_url":"https://api.github.com/users/duglin/following{/other_user}","gists_url":"https://api.github.com/users/duglin/gists{/gist_id}","starred_url":"https://api.github.com/users/duglin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/duglin/subscriptions","organizations_url":"https://api.github.com/users/duglin/orgs","repos_url":"https://api.github.com/users/duglin/repos","events_url":"https://api.github.com/users/duglin/events{/privacy}","received_events_url":"https://api.github.com/users/duglin/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/duglin/servicebroker","description":"Open Service Broker API Specification","fork":true,"url":"https://api.github.com/repos/duglin/servicebroker","forks_url":"https://api.github.com/repos/duglin/servicebroker/forks","keys_url":"https://api.github.com/repos/duglin/servicebroker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/duglin/servicebroker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/duglin/servicebroker/teams","hooks_url":"https://api.github.com/repos/duglin/servicebroker/hooks","issue_events_url":"https://api.github.com/repos/duglin/servicebroker/issues/events{/number}","events_url":"https://api.github.com/repos/duglin/servicebroker/events","assignees_url":"https://api.github.com/repos/duglin/servicebroker/assignees{/user}","branches_url":"https://api.github.com/repos/duglin/servicebroker/branches{/branch}","tags_url":"https://api.github.com/repos/duglin/servicebroker/tags","blobs_url":"https://api.github.com/repos/duglin/servicebroker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/duglin/servicebroker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/duglin/servicebroker/git/refs{/sha}","trees_url":"https://api.github.com/repos/duglin/servicebroker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/duglin/servicebroker/statuses/{sha}","languages_url":"https://api.github.com/repos/duglin/servicebroker/languages","stargazers_url":"https://api.github.com/repos/duglin/servicebroker/stargazers","contributors_url":"https://api.github.com/repos/duglin/servicebroker/contributors","subscribers_url":"https://api.github.com/repos/duglin/servicebroker/subscribers","subscription_url":"https://api.github.com/repos/duglin/servicebroker/subscription","commits_url":"https://api.github.com/repos/duglin/servicebroker/commits{/sha}","git_commits_url":"https://api.github.com/repos/duglin/servicebroker/git/commits{/sha}","comments_url":"https://api.github.com/repos/duglin/servicebroker/comments{/number}","issue_comment_url":"https://api.github.com/repos/duglin/servicebroker/issues/comments{/number}","contents_url":"https://api.github.com/repos/duglin/servicebroker/contents/{+path}","compare_url":"https://api.github.com/repos/duglin/servicebroker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/duglin/servicebroker/merges","archive_url":"https://api.github.com/repos/duglin/servicebroker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/duglin/servicebroker/downloads","issues_url":"https://api.github.com/repos/duglin/servicebroker/issues{/number}","pulls_url":"https://api.github.com/repos/duglin/servicebroker/pulls{/number}","milestones_url":"https://api.github.com/repos/duglin/servicebroker/milestones{/number}","notifications_url":"https://api.github.com/repos/duglin/servicebroker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/duglin/servicebroker/labels{/name}","releases_url":"https://api.github.com/repos/duglin/servicebroker/releases{/id}","deployments_url":"https://api.github.com/repos/duglin/servicebroker/deployments","created_at":"2016-07-08T03:27:37Z","updated_at":"2016-11-21T13:51:40Z","pushed_at":"2017-06-06T16:20:49Z","git_url":"git://github.com/duglin/servicebroker.git","ssh_url":"git@github.com:duglin/servicebroker.git","clone_url":"https://github.com/duglin/servicebroker.git","svn_url":"https://github.com/duglin/servicebroker","homepage":"","size":6806,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"openservicebrokerapi:master","ref":"master","sha":"ba48117731f666dd3ed36cf425d50c794d320d00","user":{"login":"openservicebrokerapi","id":19862012,"avatar_url":"https://avatars3.githubusercontent.com/u/19862012?v=3","gravatar_id":"","url":"https://api.github.com/users/openservicebrokerapi","html_url":"https://github.com/openservicebrokerapi","followers_url":"https://api.github.com/users/openservicebrokerapi/followers","following_url":"https://api.github.com/users/openservicebrokerapi/following{/other_user}","gists_url":"https://api.github.com/users/openservicebrokerapi/gists{/gist_id}","starred_url":"https://api.github.com/users/openservicebrokerapi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openservicebrokerapi/subscriptions","organizations_url":"https://api.github.com/users/openservicebrokerapi/orgs","repos_url":"https://api.github.com/users/openservicebrokerapi/repos","events_url":"https://api.github.com/users/openservicebrokerapi/events{/privacy}","received_events_url":"https://api.github.com/users/openservicebrokerapi/received_events","type":"Organization","site_admin":false},"repo":{"id":62855546,"name":"servicebroker","full_name":"openservicebrokerapi/servicebroker","owner":{"login":"openservicebrokerapi","id":19862012,"avatar_url":"https://avatars3.githubusercontent.com/u/19862012?v=3","gravatar_id":"","url":"https://api.github.com/users/openservicebrokerapi","html_url":"https://github.com/openservicebrokerapi","followers_url":"https://api.github.com/users/openservicebrokerapi/followers","following_url":"https://api.github.com/users/openservicebrokerapi/following{/other_user}","gists_url":"https://api.github.com/users/openservicebrokerapi/gists{/gist_id}","starred_url":"https://api.github.com/users/openservicebrokerapi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/openservicebrokerapi/subscriptions","organizations_url":"https://api.github.com/users/openservicebrokerapi/orgs","repos_url":"https://api.github.com/users/openservicebrokerapi/repos","events_url":"https://api.github.com/users/openservicebrokerapi/events{/privacy}","received_events_url":"https://api.github.com/users/openservicebrokerapi/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/openservicebrokerapi/servicebroker","description":"Open Service Broker API Specification","fork":false,"url":"https://api.github.com/repos/openservicebrokerapi/servicebroker","forks_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/forks","keys_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/teams","hooks_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/hooks","issue_events_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues/events{/number}","events_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/events","assignees_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/assignees{/user}","branches_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/branches{/branch}","tags_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/tags","blobs_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/git/refs{/sha}","trees_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/statuses/{sha}","languages_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/languages","stargazers_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/stargazers","contributors_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/contributors","subscribers_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/subscribers","subscription_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/subscription","commits_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/commits{/sha}","git_commits_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/git/commits{/sha}","comments_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/comments{/number}","issue_comment_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues/comments{/number}","contents_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/contents/{+path}","compare_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/merges","archive_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/downloads","issues_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues{/number}","pulls_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls{/number}","milestones_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/milestones{/number}","notifications_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/labels{/name}","releases_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/releases{/id}","deployments_url":"https://api.github.com/repos/openservicebrokerapi/servicebroker/deployments","created_at":"2016-07-08T03:22:26Z","updated_at":"2017-06-05T23:50:56Z","pushed_at":"2017-06-06T16:20:52Z","git_url":"git://github.com/openservicebrokerapi/servicebroker.git","ssh_url":"git@github.com:openservicebrokerapi/servicebroker.git","clone_url":"https://github.com/openservicebrokerapi/servicebroker.git","svn_url":"https://github.com/openservicebrokerapi/servicebroker","homepage":"","size":6797,"stargazers_count":131,"watchers_count":131,"language":null,"has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":42,"mirror_url":null,"open_issues_count":70,"forks":42,"open_issues":70,"watchers":131,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178"},"html":{"href":"https://github.com/openservicebrokerapi/servicebroker/pull/178"},"issue":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues/178"},"comments":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/issues/178/comments"},"review_comments":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178/comments"},"review_comment":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/pulls/178/commits"},"statuses":{"href":"https://api.github.com/repos/openservicebrokerapi/servicebroker/statuses/0b055a11c691692430e089bfe092a25b611b2591"}}}}
{"actor":{"display_login":"duglin"}}