Skip to content

Commit f930569

Browse files
committed
Clarify status codes for POST
1 parent 7db5a22 commit f930569

File tree

1 file changed

+4
-3
lines changed

1 file changed

+4
-3
lines changed

azure/Guidelines.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,7 @@ Method | Description | Response Status Code
127127
PATCH | Create/Modify the resource with JSON Merge Patch | `200-OK`, `201-Created`
128128
PUT | Create/Replace the _whole_ resource | `200-OK`, `201-Created`
129129
POST | Create new resource (ID set by service) | `201-Created` with URL of created resource
130+
POST | Action | `200-OK`, `204-No Content`
130131
GET | Read (i.e. list) a resource collection | `200-OK`
131132
GET | Read the resource | `200-OK`
132133
DELETE | Remove the resource | `204-No Content`\; avoid `404-Not Found`
@@ -297,13 +298,13 @@ There are 2 kinds of errors:
297298
**ErrorResponse** : Object
298299

299300
Property | Type | Required | Description
300-
-------- | ---- | -------- | -----------
301+
-------- | ---- | :------: | -----------
301302
`error` | ErrorDetail | ✔ | The error object.
302303

303304
**ErrorDetail** : Object
304305

305306
Property | Type | Required | Description
306-
-------- | ---- | -------- | -----------
307+
-------- | ---- | :------: | -----------
307308
`code` | String | ✔ | One of a server-defined set of error codes.
308309
`message` | String | ✔ | A human-readable representation of the error.
309310
`target` | String | | The target of the error.
@@ -313,7 +314,7 @@ Property | Type | Required | Description
313314
**InnerError** : Object
314315

315316
Property | Type | Required | Description
316-
-------- | ---- | -------- | -----------
317+
-------- | ---- | :------: | -----------
317318
`code` | String | | A more specific error code than was provided by the containing error.
318319
`innererror` | InnerError | | An object containing more specific information than the current object about the error.
319320

0 commit comments

Comments
 (0)