All Products
Search

This Product

    Object Storage Service:List namespaces

    Document Center

    Object Storage Service:List namespaces

    Last Updated:Jun 03, 2026

    List all namespaces in a Table Bucket.

    Usage notes

    • Use --max-namespaces to limit results per request and --continuation-token to paginate.

    • If the response includes a continuation-token, pass it as --continuation-token in the next request to retrieve more results.

    • Use --prefix to filter namespaces by name prefix.

    Syntax

    ossutil tables-api list-namespaces --table-bucket-arn value [--prefix value] [--max-namespaces value] [--continuation-token value] [flags]

    Parameter

    Type

    Description

    --continuation-token

    string

    Pagination token. Omit for the first request. For subsequent requests, use the continuation-token from the previous response.

    --max-namespaces

    int

    Maximum number of namespaces to return per request. Default and upper limit are server-defined.

    --prefix

    string

    Return only namespaces whose names start with this prefix.

    --table-bucket-arn

    string

    Table Bucket ARN. Format: acs:osstables:{region}:{uid}:bucket/{bucket-name}.
    Note

    Examples

    • List all namespaces in a specified Table Bucket.

      ossutil tables-api list-namespaces --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

    • Filter namespaces by prefix to return only names starting with test_.

      ossutil tables-api list-namespaces --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --prefix test_

    • Limit the number of namespaces returned.

      ossutil tables-api list-namespaces --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --max-namespaces 10