テーブルのリスト表示 - Object Storage Service - Alibaba Cloud ドキュメントセンター

指定されたテーブルバケット内のテーブルを一覧表示します。

注意事項

1 回のリクエストで最大 1,000 件のテーブルが返されます。ページネーションには continuationToken パラメーターを使用できます。
特定の名前空間内のテーブルを一覧表示するには、namespace パラメーターを使用します。
テーブル名のプレフィックスで結果をフィルターするには、prefix パラメーターを使用できます。

権限

API	アクション	説明
ListTables	oss:ListTables	テーブルを一覧表示する権限を付与します。

リクエスト構文

GET /tables/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
tableBucketARN	String	はい	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	リクエスト URI で指定するテーブルバケットの ARN です。フォーマットは `acs:osstables:{region}:{uid}:bucket/{bucketName}` です。
continuationToken	String	いいえ	xxx-continuation-token	ページネーショントークンです。次のページを取得するには、前の応答の `continuationToken` 値を渡します。最初のリクエストではこのパラメーターを省略してください。これはクエリパラメーターです。
maxTables	Integer	いいえ	100	返されるテーブルの最大数です。有効値：1～1,000。デフォルト値：1,000。これはクエリパラメーターです。
namespace	String	いいえ	my_namespace	指定した場合、その名前空間内にあるテーブルのみが返されます。これはクエリパラメーターです。
prefix	String	いいえ	my_	指定されたプレフィックスで始まるテーブル名を持つテーブルのみを返すように結果をフィルターします。これはクエリパラメーターです。

応答パラメーター

パラメーター	タイプ	例	説明
tables	配列	-	テーブルのリストです。配列内の各要素は、以下のプロパティを含むオブジェクトです：`name`（テーブル名）、`namespace`（名前空間名の配列）、`tableARN`（テーブル ARN）、`type`（テーブルタイプ）、`createdAt`（作成時刻）、および `modifiedAt`（最終変更時刻）。
continuationToken	String	xxx-continuation-token	このパラメーターは、結果が切り捨てられた場合にのみ返されます。後続のリクエストで使用して、次のページの結果を取得できます。

使用例

リクエスト例

GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket?namespace=my_namespace HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****

レスポンス例

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json


{
   "continuationToken": "xxxxx",
   "tables": [
      {
         "name": "my_table",
         "namespace": ["my_namespace"],
         "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
         "type": "customer",
         "createdAt": "2024-01-01T00:00:00.000000Z",
         "modifiedAt": "2024-06-01T00:00:00.000000Z"
      }
   ]
}

SDK

ListTables 操作は、以下の SDK で利用できます：

ossutil CLI

対応する ossutil コマンドについては、「list-tables」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
BadRequestException	400	リクエストが無効または不正な形式です。
ForbiddenException	403	呼び出し元にリクエストを実行する必要な権限がありません。
NotFoundException	404	要求されたリソースが存在しません。