列举指定Table Bucket下的所有命名空间(Namespace)。
注意事项
-
当Namespace数量较多时,可以通过--max-namespaces参数限制单次返回的最大数量,并使用--continuation-token参数进行分页查询。
-
如果返回结果中包含continuation-token,说明还有更多Namespace未列出,可以将该值作为下一次请求的--continuation-token参数以继续列举。
-
可以使用--prefix参数按前缀过滤Namespace。
命令格式
ossutil tables-api list-namespaces --table-bucket-arn value [--prefix value] [--max-namespaces value] [--continuation-token value] [flags]
|
参数 |
类型 |
说明 |
|
--continuation-token |
string |
分页标记,用于继续列举上一次未列完的Namespace。首次请求无需指定,后续请求使用上一次返回的token值。 |
|
--max-namespaces |
int |
单次查询返回的最大命名空间数量。默认值和最大值取决于服务端限制。 |
|
--prefix |
string |
按前缀过滤,仅返回名称以指定前缀开头的Namespace。 |
|
--table-bucket-arn |
string |
Table Bucket的ARN,格式为 |
说明
-
list-namespaces命令对应API接口ListNamespaces。关于API中的具体参数含义,请参见ListNamespaces。
-
关于支持的全局命令行选项,请参见ossutil全局选项。
使用示例
-
列举指定Table Bucket下的所有命名空间。
ossutil tables-api list-namespaces --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket -
按前缀过滤命名空间,仅返回名称以
test_开头的命名空间。ossutil tables-api list-namespaces --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --prefix test_ -
列举命名空间,限制单次最多返回10条结果。
ossutil tables-api list-namespaces --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --max-namespaces 10