OpenMetaQuery 操作を呼び出して、バケットのメタデータ管理機能を有効にし、取得モードを選択します。 この機能を有効にすると、Object Storage Service (OSS) はバケットのメタデータインデックスライブラリを作成します。 その後、OSS はバケット内のすべてのオブジェクトのメタデータインデックスを構築します。 インデックスライブラリが作成されると、OSS はほぼリアルタイムの増分スキャンを実行して、新しいオブジェクトを追跡し、インデックスを構築します。
注意事項
デフォルトでは、Alibaba Cloud アカウントはメタデータ管理機能を有効にする権限を持っています。 Resource Access Management (RAM) ユーザーを使用してこの機能を有効にする場合は、RAM ユーザーに
oss:OpenMetaQuery権限が付与されていることを確認してください。 詳細については、「RAM ユーザーにカスタム権限を付与する」をご参照ください。データインデックス作成の詳細については、「データインデックス作成」をご参照ください。
リクエスト構文
POST /?metaQuery&comp=add&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
この操作は、共通のリクエストヘッダーのみを使用します。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
名前 | タイプ | 必須 | 例 | 説明 |
mode | String | はい | basic | 取得モード。 有効な値:
|
role | String | いいえ | my-oss-role | OSS へのアクセスに使用される RAM ロールの名前。 コンソールでロールに権限を付与して、安全なアクセスを確保できます。 |
レスポンスヘッダー
DescribeRegions リクエストへの応答のすべてのヘッダーは、共通の応答ヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
例
リクエストの例
POST /?metaQuery&comp=add&mode=basic HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 13:08:38 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eレスポンスの例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422299D
x-oss-server-time: 544SDK
この操作は、次の SDK を使用して呼び出すことができます:
ossutil コマンドラインインターフェイス
OpenMetaQuery 操作に対応する ossutil コマンドの詳細については、「open-meta-query」をご参照ください。