Crée un Table Bucket pour stocker et gérer des tables Apache Iceberg dans OSS Tables.
Notes d'utilisation
Un Table Bucket est le conteneur de ressources de niveau supérieur pour OSS Tables. Il stocke et gère les tables au format Apache Iceberg. Un Table Bucket utilise une hiérarchie à trois niveaux : Table Bucket > namespace > table.
Lorsque vous appelez cette opération :
Un compte Alibaba Cloud peut créer au maximum 10 Table Buckets dans une seule région.
Le nom d'un Table Bucket doit être unique au sein du même compte Alibaba Cloud et de la même région.
Autorisations
|
API |
Action |
Description |
|
CreateTableBucket |
oss:CreateTableBucket |
Requis pour créer un Table Bucket. |
|
oss:PutTableBucketEncryption |
Requis si vous spécifiez le paramètre encryptionConfiguration. |
Syntaxe de la requête
PUT /buckets HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
{
"encryptionConfiguration": {
"kmsKeyArn": "string",
"sseAlgorithm": "string"
},
"name": "string"
}Paramètres de la requête
|
Parameter |
Type |
Required |
Example |
Description |
|
name |
String |
Yes |
my-table-bucket |
Nom du Table Bucket. Doit contenir entre 3 et 32 caractères et ne peut inclure que des lettres minuscules, des chiffres et des traits d'union (-). Ne peut pas commencer ou se terminer par un trait d'union. Ne peut pas commencer par oss, acs, aliyun, alibaba ou aws. |
|
encryptionConfiguration |
Container |
No |
- |
Configuration du chiffrement côté serveur. |
|
sseAlgorithm |
String |
No |
AES256 |
Algorithme de chiffrement. Seul AES256 est pris en charge. Nœud parent : encryptionConfiguration |
|
kmsKeyArn |
String |
No |
- |
ARN de la clé KMS. Ce paramètre doit rester vide. Nœud parent : encryptionConfiguration |
Paramètres de la réponse
|
Parameter |
Type |
Example |
Description |
|
arn |
String |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
ARN du Table Bucket. |
Exemples
Exemple de requête
Crée un Table Bucket nommé my-table-bucket avec un chiffrement côté serveur AES256.
PUT /buckets HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****
{
"name": "my-table-bucket",
"encryptionConfiguration": {
"sseAlgorithm": "AES256"
}
}Exemple de réponse
HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json
{
"arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket"
}SDK
Les SDK suivants prennent en charge cette opération :
CLI ossutil
L'équivalent dans ossutil est create-table-bucket.
Codes d'erreur
|
Error code |
HTTP status code |
Description |
|
BadRequestException |
400 |
La requête n'est pas valide ou est mal formée. |
|
ForbiddenException |
403 |
L'appelant ne dispose pas des autorisations requises. |
|
ConflictException |
409 |
La requête entre en conflit avec une opération d'écriture précédente. Réessayez la requête. |