GetNamespace

許可權說明

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	請求的資源不存在。