...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Table of Contents |
|---|
...
| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Info |
|---|
ImportantAll commands include specific formats for named objects and for unnamed objects. |
When to
...
Include Domain and Host
The only time domain Domain is required is for an SCSP method methods on a domain object itself. Neither domain nor Host is required for requests within the default cluster domain; otherwise, the domain name must be passed as the Host in the request. (Your A cluster should needs to have one domain with the same name as the cluster, which sets up a default cluster domain.)
Client applications most often send the domain name as the Host in the request. When the Host header does not match the domain name, the The client can supply the domain argument to explicitly override any value from the Host request header when the Host header does not match the domain name, . A domain argument always has precedence over the Host header in the HTTP/1.1 request.
Calling
...
Named Objects
The named object format is:
| Code Block | ||
|---|---|---|
| ||
METHOD /bucketname/objectname[?query-arguments] HTTP/1.1 |
where
bucketname is a
simple,URL-encoded identifier that cannot contain slash characters
(or any other character not allowed in HTTP
URLs)URL
objectname is any legitimate URL, which can contain slash characters.
Calling
...
Unnamed Objects
The unnamed object format is:
| Code Block | ||
|---|---|---|
| ||
METHOD /[uuid][?query-arguments] HTTP/1.1 |
You specify Specify the UUID with all SCSP methods except WRITE, in which case the cluster will return returns the UUID in the response if the write is successful.
| Info |
|---|
ImportantWhen writing unnamed objects, useUse a HOST header equivalent to the cluster name, the host IP address, or a domain=clusterName query argargument on all requests even if you arenot using domains for other purposes when writing unnamed objects. |
| Infonote | |
|---|---|
| title | CautionWhen writing unnamed objects, ensure that yourVerify the application is not passing a HOST header that isequal to neither an IP address nor a domain that exists in the cluster (unless the host header matches the cluster name )when writing unnamed objects. Swarm will attemptattempts to look up the non-existent domain on every request and will waitwaits for multiple retries before the lookup times out, impacting performance. |