GetTableBucket 操作は、指定された Table Bucket の詳細情報を取得します。取得される情報には、バケット名、ARN、作成時刻、所有者が含まれます。
注意事項
呼び出し元は、指定された Table Bucket に対する読み取り権限を保有している必要があります。
応答には、Table Bucket の ARN、名前、作成時刻、所有者の Alibaba Cloud アカウント ID、および Table Bucket ID などの基本プロパティが含まれます。
権限
API | アクション | 説明 |
GetTableBucket | oss:GetTableBucket | Table Bucket の情報を取得します。 |
リクエスト構文
GET /buckets/{tableBucketARN} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
tableBucketARN | String | はい | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket の ARN。形式は acs:osstables:{region}:{accountId}:bucket/{bucketName} です。 |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
arn | String | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket の ARN。 |
createdAt | String | 2024-01-01T00:00:00.000000Z | ISO 8601 形式の作成時刻。 |
name | String | my-table-bucket | Table Bucket の名前。 |
ownerAccountId | String | 1234567890 | 所有者の Alibaba Cloud アカウント ID。 |
tableBucketId | String | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | UUID 形式の Table Bucket 固有識別子。 |
type | String | customer | Table Bucket のタイプ。 |
使用例
リクエスト例
GET /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
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
{
"arn": "acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket",
"createdAt": "2024-01-01T00:00:00.000000Z",
"name": "my-table-bucket",
"ownerAccountId": "1234567890",
"tableBucketId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "customer"
}SDK
GetTableBucket 操作は、以下の SDK で利用できます。
Ossutil コマンドラインツール
この操作は、ossutil コマンド get-table-bucket に対応しています。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NotFoundException | 404 | 要求されたリソースが存在しません。 |
ForbiddenException | 403 | このリクエストを実行する権限がありません。 |