OBS is based on a standard request and response model. A request sent to OBS must comply with HTTP 1.1 and headers of a request must contain OBS-defined parameters, for example, authentication fields.
Requests can be sent to OBS using multiple HTTP methods such as GET, PUT, POST, DELETE, and HEAD. You can send a GET, PUT, POST, DELETE, or HEAD request to read, create, update, delete, or obtain a resource. Table 1 describes the request methods supported by OBS REST APIs.
Method |
Description |
|---|---|
GET |
Requests that the server returns a specific resource, for example, a bucket list or object. |
PUT |
Requests that the server creates a specific resource, for example, a bucket or object. |
POST |
Requests that the server performs specific operations on a specific resource, for example, initiating or completing a multipart upload. |
DELETE |
Requests that the server deletes a specific resource, for example, an object. |
HEAD |
Requests that the server returns the metadata of a specific resource, for example, object metadata. |
Parameters must be specified in the headers of requests sent to OBS using OBS REST APIs. For details about headers common to OBS REST requests, see section Common Request Headers.