Gunakan operasi CreateNamespace untuk membuat namespace dalam bucket tabel tertentu. Namespace merupakan pengelompokan logis dalam bucket tabel yang berfungsi untuk mengorganisasi dan mengelola tabel.
Catatan penggunaan
-
Nama namespace harus unik dalam satu bucket tabel.
-
Nama namespace harus terdiri dari 1 hingga 255 karakter, hanya boleh berisi huruf kecil, angka, dan garis bawah (_), tidak boleh diawali atau diakhiri dengan garis bawah, serta tidak boleh diawali dengan oss, acs, aliyun, alibaba, atau aws.
-
Pastikan bucket tabel tujuan telah tersedia sebelum membuat namespace.
Izin
|
API |
Action |
Deskripsi |
|
CreateNamespace |
oss:CreateNamespace |
Membuat namespace. |
Sintaks permintaan
PUT /namespaces/{tableBucketARN} HTTP/1.1
Content-type: application/json
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
{
"namespace": ["string"]
}Parameter permintaan
|
Parameter |
Tipe |
Wajib |
Contoh |
Deskripsi |
|
tableBucketARN |
string |
Ya |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
ARN bucket tabel. Formatnya adalah acs:osstables:{region}:{accountId}:bucket/{bucketName}. |
|
namespace |
array |
Ya |
["my_namespace"] |
Array nama namespace. Saat ini, Anda hanya dapat menentukan satu namespace per permintaan. Nama harus terdiri dari 1 hingga 255 karakter dan hanya boleh berisi huruf kecil, angka, serta garis bawah (_). Nama tidak boleh diawali atau diakhiri dengan garis bawah, serta tidak boleh diawali dengan oss, acs, aliyun, alibaba, atau aws. |
Parameter respons
|
Parameter |
Jenis |
Contoh |
Deskripsi |
|
namespace |
array |
["my_namespace"] |
Array nama namespace yang telah dibuat. |
|
tableBucketARN |
string |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
ARN bucket tabel yang memiliki namespace tersebut. |
Contoh
Contoh permintaan
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"]
}Contoh respons
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
Operasi CreateNamespace tersedia di SDK berikut:
CLI ossutil
Untuk perintah ossutil yang setara, lihat create-namespace.
Kode error
|
Kode error |
Kode status HTTP |
Deskripsi |
|
BadRequestException |
400 |
Permintaan tidak valid atau rusak formatnya. |
|
ForbiddenException |
403 |
Pemanggil tidak memiliki izin untuk permintaan ini. |
|
NotFoundException |
404 |
Resource yang diminta tidak ada. |
|
ConflictException |
409 |
Namespace yang ditentukan sudah ada. |