Operasi GetTable mengambil informasi detail tentang tabel tertentu.
Usage notes
Operasi ini mendukung dua metode kueri: berdasarkan nama (menggunakan parameter tableBucketARN, namespace, dan name) atau berdasarkan ARN (menggunakan parameter tableArn). Kedua metode ini saling eksklusif.
Permissions
API | Action | Description |
GetTable | oss:GetTable | Mengambil informasi tentang sebuah tabel. Aksi ini juga memeriksa kebijakan tabel. Pengguna admin dikecualikan dari pemeriksaan ini. |
Request syntax
GET /get-table HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueRequest parameters
Parameter | Type | Required | Example value | Description |
tableBucketARN | String | No | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | ARN dari Table Bucket. Parameter ini digunakan bersama dengan |
namespace | String | No | my_namespace | Namespace tempat tabel berada. Parameter ini wajib untuk kueri berdasarkan nama dan dikirimkan dalam query string. |
name | String | No | my_table | Nama tabel. Parameter ini wajib untuk kueri berdasarkan nama dan dikirimkan dalam query string. |
tableArn | String | No | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table_id | ARN dari tabel. Parameter ini wajib untuk kueri berdasarkan ARN dan dikirimkan dalam query string. Parameter ini saling eksklusif dengan parameter |
Response parameters
Parameter | Type | Example value | Description |
name | String | my_table | Nama tabel. |
namespace | Array | - | Array nama namespace tempat tabel berada. |
tableARN | String | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket/table/table-id | ARN dari tabel. |
format | String | ICEBERG | Format tabel. Nilainya adalah |
versionToken | String | abc123def456 | Token versi tabel, digunakan untuk kunci optimis. |
metadataLocation | String | oss://bucket/metadata/00000-xxx.metadata.json | Jalur OSS ke file metadata tabel. |
warehouseLocation | String | oss://data-bucket/warehouse/ | Jalur OSS ke warehouse tabel. |
type | String | customer | Jenis tabel. Nilainya adalah |
createdAt | String | 2024-01-01T00:00:00.000000Z | Waktu pembuatan tabel, dalam format ISO 8601. |
createdBy | String | 1234567890 | ID akun pembuat tabel. |
modifiedAt | String | 2024-06-01T00:00:00.000000Z | Waktu terakhir tabel dimodifikasi, dalam format ISO 8601. |
modifiedBy | String | 1234567890 | ID akun pengguna yang terakhir melakukan modifikasi. |
ownerAccountId | String | 1234567890 | ID akun pemilik tabel. |
tableBucketId | String | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | ID Table Bucket yang berisi tabel tersebut. |
namespaceId | String | ns-xxxxxxxx | ID namespace yang berisi tabel tersebut. |
Examples
Request example
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****Response example
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"
}SDKs
Anda dapat memanggil operasi GetTable menggunakan SDK berikut:
ossutil command-line tool
Perintah yang sesuai dalam alat baris perintah ossutil adalah get-table.
Error codes
Error code | HTTP status code | Description |
BadRequestException | 400 | Permintaan tidak valid atau memiliki format yang salah. |
ForbiddenException | 403 | Anda tidak memiliki otorisasi untuk melakukan operasi ini. |
NotFoundException | 404 | Resource yang diminta tidak ada. |