指定された名前空間に関する詳細情報を取得します。
権限
|
API |
アクション |
説明 |
|
GetNamespace |
oss:GetNamespace |
名前空間情報を取得します。 |
リクエスト構文
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。形式は |
|
namespace |
文字列 |
はい |
my_namespace |
名前空間の名前。 |
レスポンスパラメーター
|
パラメーター |
タイプ |
例 |
説明 |
|
namespace |
配列 |
["my_namespace"] |
名前空間の名前を含む配列。 |
|
namespaceId |
文字列 |
26104520-f117-401a-9c09-94b031352251 |
名前空間の一意な識別子。 |
|
tableBucketId |
文字列 |
9cd83fc6-5f1b-420f-b1e0-f77024b7c225 |
親 Table Bucket の一意な識別子。 |
|
ownerAccountId |
文字列 |
1234567890 |
所有者の Alibaba Cloud アカウント ID。 |
|
createdAt |
文字列 |
2026-01-01T00:00:00.000000+00:00 |
ISO 8601 形式での名前空間作成時のタイムスタンプ。 |
|
createdBy |
文字列 |
1234567890 |
作成者の Alibaba Cloud アカウント 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 CLI
同等の ossutil コマンドについては、「get-namespace」をご参照ください。
エラーコード
|
エラーコード |
HTTP ステータスコード |
説明 |
|
ForbiddenException |
403 |
呼び出し元にこのリクエストに必要な権限がありません。 |
|
NotFoundException |
404 |
リクエストされたリソースが存在しません。 |