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

RenameTable を使用して、テーブルの名前を変更するか、別の名前空間に移動します。

注意事項

newName および newNamespaceName のいずれか一方以上を指定する必要があります。テーブル名のみ、名前空間のみ、または両方を変更できます。
versionToken パラメーターを使用して楽観的ロックを実装し、同時操作の競合を防止できます。
新しいテーブル名は、送信先の名前空間内で一意である必要があります。

権限

API	アクション	説明
RenameTable	oss:RenameTable	テーブルの名前を変更し、テーブルポリシーをチェックします。

リクエスト構文

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"
}

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
tableBucketARN	String	はい	acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket	Table Bucket の Alibaba Cloud リソースネーム (ARN) です。形式は `acs:osstables:{region}:{uid}:bucket/{bucketName}` です。このパラメーターは URI で指定します。
namespace	String	はい	my_namespace	テーブルが含まれる名前空間の名前です。このパラメーターは URI で指定します。
name	String	はい	my_table	テーブルの現在の名前です。このパラメーターは URI で指定します。
newNamespaceName	String	いいえ	new_namespace	テーブルを移動する先の名前空間の新しい名前です。`newNamespaceName` または `newName` のいずれか一方以上を指定する必要があります。このパラメーターはリクエストボディで指定します。
newName	String	いいえ	new_table	新しいテーブル名です。名前は 1～255 文字で、小文字、数字、アンダースコア (_) のみを使用できます。`newName` または `newNamespaceName` のいずれか一方以上を指定する必要があります。このパラメーターはリクエストボディで指定します。
versionToken	String	いいえ	aaabbb	同時操作の競合を防止するための楽観的ロックに使用されるバージョントークンです。このパラメーターはリクエストボディで指定します。

使用例

リクエスト例

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"
}

レスポンス例

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

SDKs

以下の SDK が RenameTable 操作をサポートしています。

ossutil CLI

RenameTable 操作に対応する ossutil コマンドは rename-table です。

エラーコード

エラーコード	HTTP ステータスコード	説明
BadRequestException	400	リクエストが無効であるか、フォーマットが正しくありません。
ForbiddenException	403	呼び出し元にこのリクエストを実行する権限がありません。
NotFoundException	404	リクエストされたリソースが存在しません。
ConflictException	409	このリクエストは、以前の書き込み操作と競合しています。