• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (Swift)
  4. Operations on Accounts
  5. Show Account Details and List Containers
  6. Request

Request

Method

Table 1 Method description

Method

URI

Description

GET

/v1/{account}{?limit,marker,end_marker,format,prefix,delimiter}

Shows details of a specified account and lists the containers, sorted by name in ascending order, in the account.

{account} indicates the name of an account.

This operation does not involve a request body.

Example Request

Show account details and list containers, and ask for a JSON response:

curl -i $publicURL?format=json -X GET -H "X-Auth-Token:$token"

Request Headers

Request URI parameters

Parameter

Type

Description

{account}

String

(Required)

Unique name of the account. In the current version, it indicates the unique ID of the account.

Request header parameters

Parameter

Type

Description

X-Auth-Token

String

(Required)

Authentication token.

Accept

String

(Optional)

Similar to the format query parameter, set this header to application/json, application/xml, or text/xml.

NOTE:

If the value of Accept is invalid, OBS (compatible with OpenStack Swift) returns the 406 (Not Acceptable) error code. Then, OpenStack Swift will process the request based on the default value of Accept.

Request Query Parameters

Table 2 Request query parameters

Parameter

Type

Description

limit

Int

(Optional)

Limits the number of containers in a query result. The value ranges from 0 to 10000. If the value is larger than 10000, an error is reported. The default value is 10000.

marker

String

(Optional)

Returns container names that are greater than the specified marker.

end_marker

String

(Optional)

Returns container names that are smaller than the specified marker.

format

String

(Optional)

Sets the format of the returned container list. The valid values are plain (default), json, and xml. Its function is the same as Accept.

prefix

String

(Optional)

Returns containers that have the specified prefix.

delimiter

Char

(Optional)

Returns the container names that are nested in the account.