osc object-store object list

Shows details for a container and lists objects, sorted by name, in the container. Specify query parameters in the request to filter the list and return a subset of objects. Omit query parameters to return a list of objects that are stored in the container, up to 10,000 names. The 10,000 maximum value is configurable. To view the value for the cluster, issue a GET /info request

Usage: osc object-store object list [OPTIONS] <CONTAINER>

Arguments:

  • <CONTAINER> — The unique (within an account) name for the container. The container name must be from 1 to 256 characters long and can start with any character and contain any pattern. Character set must be UTF-8. The container name cannot contain a slash (/) character because this character delimits the container and object name. For example, the path /v1/account/www/pages specifies the www container, not the www/pages container

Options:

  • --limit <LIMIT> — For an integer value n, limits the number of results to n

  • --marker <MARKER> — For a string value, x, constrains the list to items whose names are greater than x

  • --end-marker <END_MARKER> — For a string value, x, constrains the list to items whose names are less than x

  • --format <FORMAT> — The response format. Valid values are json, xml, or plain. The default is plain. If you append the format=xml or format=json query parameter to the storage account URL, the response shows extended container information serialized in that format. If you append the format=plain query parameter, the response lists the container names separated by newlines

  • --prefix <PREFIX> — Only objects with this prefix will be returned. When combined with a delimiter query, this enables API users to simulate and traverse the objects in a container as if they were in a directory tree

  • --delimiter <DELIMITER> — The delimiter is a single character used to split object names to present a pseudo-directory hierarchy of objects. When combined with a prefix query, this enables API users to simulate and traverse the objects in a container as if they were in a directory tree

  • --reverse <REVERSE> — By default, listings are returned sorted by name, ascending. If you include the reverse=true query parameter, the listing will be returned sorted by name, descending

    Possible values: true, false

  • --max-items <MAX_ITEMS> — Total limit of entities count to return. Use this when there are too many entries

    Default value: 10000