Crée un namespace dans un compartiment de tables (table bucket). Un namespace est un regroupement logique permettant d'organiser et de gérer des tables.
Notes d'utilisation
Les noms de namespace doivent être uniques au sein d'un même compartiment de tables.
Un nom de namespace doit comporter entre 1 et 255 caractères et ne peut contenir que des lettres minuscules, des chiffres et des traits de soulignement (_). Il ne peut ni commencer ni se terminer par un trait de soulignement, et ne doit pas être préfixé par oss, acs, aliyun, alibaba ou aws.
Le compartiment de tables de destination doit exister avant la création du namespace.
Permissions
|
API |
Action |
Description |
|
CreateNamespace |
oss:CreateNamespace |
Crée un namespace. |
Syntaxe de la requête
PUT /namespaces/{tableBucketARN} HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
{
"namespace": ["string"]
}Paramètres de requête
|
Parameter |
Type |
Required |
Example |
Description |
|
tableBucketARN |
string |
Yes |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
L'ARN du compartiment de tables, au format acs:osstables:{region}:{accountId}:bucket/{bucketName}. |
|
namespace |
array |
Yes |
["my_namespace"] |
Tableau de noms de namespace. Chaque requête ne prend en charge qu'un seul namespace. Le nom doit comporter entre 1 et 255 caractères et ne peut contenir que des lettres minuscules, des chiffres et des traits de soulignement (_). Il ne peut ni commencer ni se terminer par un trait de soulignement, et ne doit pas être préfixé par oss, acs, aliyun, alibaba ou aws. |
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
|
namespace |
array |
["my_namespace"] |
Tableau contenant les noms des namespaces créés. |
|
tableBucketARN |
string |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
L'ARN du compartiment de tables propriétaire du namespace. |
Exemples
Exemple de requête
PUT /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket 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****
{
"namespace": ["my_namespace"]
}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
{
"namespace": ["my_namespace"],
"tableBucketARN": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket"
}SDK
L'opération CreateNamespace est disponible dans les SDK suivants :
CLI ossutil
La commande ossutil équivalente est create-namespace.
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 nécessaires pour cette requête. |
|
NotFoundException |
404 |
La ressource demandée n'existe pas. |
|
ConflictException |
409 |
Le namespace spécifié existe déjà. |