All Products
Search

This Product

    Object Storage Service:GetTableMetadataLocation

    Document Center

    Object Storage Service:GetTableMetadataLocation

    Last Updated:May 09, 2026

    Mengambil lokasi file metadata untuk tabel tertentu.

    Catatan penggunaan

    • metadataLocation yang dikembalikan menunjuk ke file JSON metadata Iceberg terkini.

    • versionToken memungkinkan penerapan optimistic locking pada operasi UpdateTableMetadataLocation berikutnya.

    • warehouseLocation adalah path OSS ke gudang (warehouse) tabel tersebut.

    Izin

    API

    Action

    Deskripsi

    GetTableMetadataLocation

    oss:GetTableMetadataLocation

    Mengambil lokasi metadata tabel. Aksi ini juga memeriksa kebijakan tabel.

    Sintaksis permintaan

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

    Parameter permintaan

    Parameter

    Jenis

    Wajib

    Contoh

    Deskripsi

    tableBucketARN

    string

    Ya

    acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket

    ARN bucket tabel. Formatnya adalah acs:osstables:{region}:{uid}:bucket/{bucketName}. Parameter ini merupakan bagian dari URI.

    namespace

    string

    Ya

    my_namespace

    Nama namespace tabel. Parameter ini merupakan bagian dari URI.

    name

    string

    Ya

    my_table

    Nama tabel. Parameter ini merupakan bagian dari URI.

    Parameter respons

    Parameter

    Type

    Contoh

    Deskripsi

    metadataLocation

    string

    oss://bucket/metadata/00000-xxx.metadata.json

    Path OSS ke file JSON metadata Iceberg saat ini.

    versionToken

    string

    abc123def456

    Token versi untuk tabel. Gunakan token ini untuk optimistic locking dalam operasi UpdateTableMetadataLocation.

    warehouseLocation

    string

    oss://data-bucket/warehouse/

    Path OSS ke gudang (warehouse) tabel.

    Contoh

    Permintaan contoh

    GET /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/metadata-location 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****

    Respons contoh

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


{
   "metadataLocation": "oss://data-bucket/metadata/00000-xxx.metadata.json",
   "versionToken": "aaabbb",
   "warehouseLocation": "oss://data-bucket/warehouse/"
}

    SDKs

    SDK berikut mendukung operasi GetTableMetadataLocation:

    Alat baris perintah ossutil

    Untuk perintah ossutil yang sesuai, lihat get-table-metadata-location.

    Kode error

    Kode error

    Kode status HTTP

    Deskripsi

    ForbiddenException

    403

    Anda tidak memiliki izin untuk melakukan permintaan ini.

    NotFoundException

    404

    Resource yang diminta tidak ada.