list-tables

注意事項

當表數量較多時，可以通過--max-tables參數限制單次返回的最大數量，並使用--continuation-token參數進行分頁查詢。
如果返回結果中包含continuation-token，說明還有更多表未列出，可以將該值作為下一次請求的--continuation-token參數以繼續列舉。
可以使用--prefix參數按首碼過濾表名。

命令格式

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

參數	類型	說明
--continuation-token	string	分頁標記，用於繼續列舉上一次未列完的表。首次請求無需指定，後續請求使用上一次返回的token值。
--max-tables	int	單次查詢返回的最大表數量。預設值和最大值取決於服務端限制。
--namespace	string	要列舉表的命名空間名稱。
--prefix	string	按首碼過濾，僅返回名稱以指定首碼開頭的表。
--table-bucket-arn	string	Table Bucket的ARN，格式為`acs:osstables:{region}:{uid}:bucket/{bucket-name}`。

說明

list-tables命令對應API介面ListTables。關於API中的具體參數含義，請參見ListTables。
關於支援的全域命令列選項，請參見ossutil全域選項。

使用樣本

列舉指定命名空間下的所有表。

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

按首碼過濾表名，僅返回名稱以test_開頭的表。

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

列舉表，限制單次最多返回10條結果。

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