列舉Namespace

更新時間:
Copy as MD

列舉指定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 BucketARN,格式為acs:osstables:{region}:{uid}:bucket/{bucket-name}

說明
  • 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