调用GetNamespace接口获取指定Namespace的详细信息。
权限说明
|
API |
Action |
说明 |
|
GetNamespace |
oss:GetNamespace |
获取Namespace信息 |
请求语法
GET /namespaces/{tableBucketARN}/{namespace} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue请求参数
|
名称 |
数据类型 |
是否必选 |
示例值 |
描述 |
|
tableBucketARN |
字符串 |
是 |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
Table Bucket的ARN，格式为acs:osstables:{region}:{accountId}:bucket/{bucketName}。 |
|
namespace |
字符串 |
是 |
my_namespace |
要查询的Namespace名称。 |
响应参数
|
名称 |
数据类型 |
示例值 |
描述 |
|
namespace |
数组 |
["my_namespace"] |
Namespace名称列表。 |
|
namespaceId |
字符串 |
26104520-f117-401a-9c09-94b031352251 |
Namespace的唯一标识。 |
|
tableBucketId |
字符串 |
9cd83fc6-5f1b-420f-b1e0-f77024b7c225 |
所属Table Bucket的唯一标识。 |
|
ownerAccountId |
字符串 |
1234567890 |
拥有者的阿里云账号ID。 |
|
createdAt |
字符串 |
2026-01-01T00:00:00.000000+00:00 |
创建时间，ISO 8601格式。 |
|
createdBy |
字符串 |
1234567890 |
创建者的阿里云账号ID。 |
示例
请求示例
GET /namespaces/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace HTTP/1.1
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****返回示例
HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3
Content-Type: application/json
{
"namespace": ["my_namespace"],
"namespaceId": "ns-xxxxxxxx",
"tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ownerAccountId": "1234567890",
"createdAt": "2024-01-01T00:00:00.000000Z",
"createdBy": "1234567890"
}SDK
GetNamespace接口所对应的各语言SDK如下：
命令行工具ossutil
GetNamespace接口所对应的ossutil命令，请参见get-namespace。
错误码
|
错误码 |
HTTP状态码 |
描述 |
|
ForbiddenException |
403 |
调用者无权执行此请求。 |
|
NotFoundException |
404 |
请求的资源不存在。 |