RenameTable - Object Storage Service - Alibaba Cloud Documentation Center

Gunakan RenameTable untuk mengganti nama tabel atau memindahkannya ke namespace yang berbeda.

Usage notes

Anda harus menentukan setidaknya salah satu dari newName atau newNamespaceName. Anda dapat mengubah hanya nama tabel, hanya namespace, atau keduanya sekaligus.
Anda dapat menggunakan parameter versionToken untuk menerapkan optimistic lock guna mencegah konflik akibat operasi konkuren.
Nama tabel baru harus unik dalam namespace tujuan.

Permissions

API	Action	Description
RenameTable	oss:RenameTable	Mengganti nama tabel dan memeriksa kebijakan tabel.

Request syntax

PUT /tables/{tableBucketARN}/{namespace}/{name}/rename HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
{
   "newNamespaceName": "string",
   "newName": "string",
   "versionToken": "string"
}

Request parameters

Parameter	Type	Required	Example	Description
tableBucketARN	String	Yes	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Nama Sumber Daya Alibaba Cloud (ARN) dari Table Bucket. Formatnya adalah `acs:osstables:{region}:{uid}:bucket/{bucketName}`. Parameter ini ditentukan dalam URI.
namespace	String	Yes	my_namespace	Nama namespace yang berisi tabel tersebut. Parameter ini ditentukan dalam URI.
name	String	Yes	my_table	Nama saat ini dari tabel. Parameter ini ditentukan dalam URI.
newNamespaceName	String	No	new_namespace	Nama baru untuk namespace tempat tabel akan dipindahkan. Anda harus menentukan setidaknya salah satu dari `newNamespaceName` atau `newName`. Parameter ini ditentukan dalam badan permintaan.
newName	String	No	new_table	Nama tabel baru. Nama harus terdiri dari 1 hingga 255 karakter dan hanya boleh berisi huruf kecil, angka, dan garis bawah (_). Anda harus menentukan setidaknya salah satu dari `newName` atau `newNamespaceName`. Parameter ini ditentukan dalam badan permintaan.
versionToken	String	No	aaabbb	Token versi yang digunakan untuk optimistic lock guna mencegah konflik operasi konkuren. Parameter ini ditentukan dalam badan permintaan.

Examples

Request example

PUT /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table/rename HTTP/1.1
Content-type: application/json
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****


{
   "newNamespaceName": "new_namespace",
   "newName": "new_table",
   "versionToken": "aaabbb"
}

Response example

HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3

SDKs

SDK berikut mendukung operasi RenameTable:

ossutil CLI

Perintah ossutil untuk operasi RenameTable adalah rename-table.

Error codes

Error code	HTTP status code	Description
BadRequestException	400	Permintaan tidak valid atau memiliki format yang salah.
ForbiddenException	403	Pemanggil tidak memiliki otorisasi untuk melakukan permintaan ini.
NotFoundException	404	Sumber daya yang diminta tidak ada.
ConflictException	409	Permintaan bertentangan dengan operasi tulis sebelumnya.