PDFPOST
POST is used to create (write) a new resource in the service.
Request
Headers
X-Cloud-Lock: Optional. Specify the lock-id used to lock the resource.
Content-Type: The content type of the request entity. This should be one of the values listed as acceptable in the Resource specification.
Entity
An entity representing the resource which should be created.
Success Response
|
HTTP Code |
Description |
|
201 (Created) |
The request was accepted and processed. |
Headers
Location: The Location header will specify the definitive URI of the newly created resource.
Entity
An entity of type text/uri-list will be provided, specifying all URIs from which the newly created resource is accessible.
Error Responses
|
HTTP Code |
Description |
|
409 (Conflict) |
The resource could not be created because of a locking violation, or the desired update is somehow disallowed due to the current state of the system. |
|
415 (Unsupported Media Type) |
The Content-Type is unsupported or the entity itself does not match the content type (e.g., malformed XML). |
Side Effects
A new resource will be created and this resource will be updated to reference the newly created resource.