GetTable - Object Storage Service - Alibaba Cloud ドキュメントセンター

GetTable 操作は、指定されたテーブルに関する詳細情報を取得します。

注意事項

この操作では、名前によるクエリ（tableBucketARN、namespace、および name パラメーターを使用）と ARN によるクエリ（tableArn パラメーターを使用）の 2 つのクエリ方法がサポートされています。これらの方法は相互排他です。

権限

API	アクション	説明
GetTable	oss:GetTable	テーブルに関する情報を取得します。このアクションでは、テーブルポリシーもチェックされます。管理者ユーザーはこのチェックの対象外です。

リクエスト構文

GET /get-table 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	テーブルバケットの ARN です。このパラメーターは `namespace` および `name` とともに使用されます。名前によるクエリ時に必須であり、`tableArn` パラメーターとは相互排他です。
namespace	String	いいえ	my_namespace	テーブルが存在する名前空間です。このパラメーターは名前によるクエリ時に必須で、クエリ文字列に含まれます。
name	String	いいえ	my_table	テーブルの名前です。このパラメーターは名前によるクエリ時に必須で、クエリ文字列に含まれます。
tableArn	String	いいえ	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id	テーブルの ARN です。このパラメーターは ARN によるクエリ時に必須で、クエリ文字列に含まれます。`tableBucketARN`、`namespace`、および `name` パラメーターとは相互排他です。

レスポンスパラメーター

パラメーター	タイプ	例	説明
name	String	my_table	テーブルの名前です。
namespace	配列	-	テーブルが存在する名前空間名の配列です。
tableARN	String	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table-id	テーブルの ARN です。
format	String	ICEBERG	テーブルのフォーマットです。値は `ICEBERG` です。
versionToken	String	abc123def456	楽観的ロックに使用されるテーブルのバージョントークンです。
metadataLocation	String	oss://bucket/metadata/00000-xxx.metadata.json	テーブルのメタデータファイルへの OSS パスです。
warehouseLocation	String	oss://data-bucket/warehouse/	テーブルのウェアハウスへの OSS パスです。
type	String	customer	テーブルのタイプです。値は `customer` です。
createdAt	String	2024-01-01T00:00:00.000000Z	ISO 8601 形式でのテーブル作成時刻です。
createdBy	String	1234567890	テーブル作成者のアカウント ID です。
modifiedAt	String	2024-06-01T00:00:00.000000Z	ISO 8601 形式でのテーブル最終更新時刻です。
modifiedBy	String	1234567890	最終更新者のアカウント ID です。
ownerAccountId	String	1234567890	テーブル所有者のアカウント ID です。
tableBucketId	String	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx	テーブルを含むテーブルバケットの ID です。
namespaceId	String	ns-xxxxxxxx	テーブルを含む名前空間の ID です。

使用例

リクエスト例

GET /get-table?tableBucketARN=acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket&namespace=my_namespace&name=my_table 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


{
   "name": "my_table",
   "namespace": ["my_namespace"],
   "tableARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id",
   "format": "ICEBERG",
   "versionToken": "aaabbb",
   "metadataLocation": "oss://data-bucket/metadata/00000-xxx.metadata.json",
   "warehouseLocation": "oss://data-bucket/warehouse/",
   "type": "customer",
   "createdAt": "2024-01-01T00:00:00.000000Z",
   "createdBy": "1234567890",
   "modifiedAt": "2024-06-01T00:00:00.000000Z",
   "modifiedBy": "1234567890",
   "ownerAccountId": "1234567890",
   "tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
   "namespaceId": "ns-xxxxxxxx"
}

SDK

以下の SDK を使用して GetTable 操作を呼び出すことができます。

ossutil コマンドラインツール

ossutil コマンドラインツールにおける対応コマンドは get-table です。

エラーコード

エラーコード	HTTP ステータスコード	説明
BadRequestException	400	リクエストが無効であるか、形式が正しくありません。
ForbiddenException	403	この操作を実行する権限がありません。
NotFoundException	404	要求されたリソースが存在しません。