Update Entity
Updates an entity.
Request
| Method | Request URI | HTTP Version |
|---|---|---|
|
PUT |
https://{serviceNamespace}.servicebus.windows.net/{Entity Path} |
HTTP/1.1 |
Request Headers
The following table describes required and optional request headers.
| Request Header | Description |
|---|---|
|
Authorization |
Specifies a WRAPv0.9.7.2 token containing a SimpleWebToken acquired from ACS. Set to WRAP access_token=”{swt}”. |
|
Content-Type |
Set to application/atom+xml;type=entry;charset=utf-8. |
|
If-Match |
Set this header to “*” to update the entity. You need to provide ALL the property values that are desired on the updated entity, any values NOT provided will be set to the service DEFAULT values. If this header is missing then the update call will return an error indicating that this entity already exists. |
Request Body
Response
The response includes an HTTP status code and a set of response headers.
Response Codes
 Note |
|---|
| If you update an entity with a name containing special or encoded characters (for example, "test?Name=value&", which gets encoded to "test%3FName%3Dvalue%26", a (401) Unauthorized exception will be generated. |
| Code | Description |
|---|---|
|
201 |
Entity updated. |
|
400 |
Invalid request body. |
|
401 |
Authorization failure. |
|
403 |
Quota exceeded; entity not updated. |
|
500 |
Internal error. |
For information about status codes, see Status and Error Codes.
Response Headers
None.
Response Body
The entity description is returned. Some description properties might contain default values if they were missing from the PUT request.
