RenameTable - OSS Tables API - Object Storage Service - Centre de documentation Alibaba Cloud

Notes d'utilisation

Spécifiez au moins l'un des paramètres newName et newNamespaceName. Vous pouvez modifier le nom de la table, le namespace, ou les deux.
Utilisez le paramètre versionToken pour le verrouillage optimiste afin d'éviter les conflits liés aux opérations simultanées.
Le nouveau nom de la table doit être unique dans le namespace de destination.

Permissions

API

Action

Description

RenameTable

oss:RenameTable

Renomme une table et vérifie la politique de la table.

Syntaxe de la requête

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

Paramètres de la requête

Parameter

Type

Required

Example

Description

tableBucketARN

String

Yes

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

ARN du bucket de tables au format acs:osstables:{region}:{uid}:bucket/{bucketName}. Spécifié dans l'URI.

namespace

String

Yes

my_namespace

Namespace contenant la table. Spécifié dans l'URI.

name

String

Yes

my_table

Nom actuel de la table. Spécifié dans l'URI.

newNamespaceName

String

No

new_namespace

Namespace de destination pour la table. Spécifiez au moins l'un des paramètres newNamespaceName ou newName. Spécifié dans le corps de la requête.

newName

String

No

new_table

Nouveau nom de la table. Doit comporter entre 1 et 255 caractères et contenir uniquement des lettres minuscules, des chiffres et des traits de soulignement (_). Spécifiez au moins l'un des paramètres newName ou newNamespaceName. Spécifié dans le corps de la requête.

versionToken

String

No

aaabbb

Jeton de version pour le verrouillage optimiste afin d'éviter les conflits liés aux opérations simultanées. Spécifié dans le corps de la requête.

Exemples

Exemple de requête

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

Exemple de réponse

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

SDK

Les SDK suivants prennent en charge RenameTable :

CLI ossutil

La commande ossutil pour RenameTable est rename-table.

Codes d'erreur

Error code

HTTP status code

Description

BadRequestException

400

Requête non valide ou mal formée.

ForbiddenException

403

Permissions insuffisantes pour cette opération.

NotFoundException

404

Ressource introuvable.

ConflictException

409

Conflit avec une opération d'écriture précédente.