すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetMetaQueryStatus

最終更新日:Feb 27, 2025

バケットのメタデータインデックスライブラリの情報を照会します。

使用上の注意

バケットのメタデータインデックスライブラリの情報を照会するには、oss:GetMetaQueryStatus 権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

リクエスト構文

GET /?metaQuery HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

このリクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

レスポンス内のすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

要素

タイプ

説明

MetaQueryStatus

コンテナー

該当なし

メタデータ情報を格納するコンテナー。

子ノード:State、Phase、CreateTime、UpdateTime。

Phase

文字列

FullScanning

スキャンタイプ。有効な値:

  • FullScanning:フルスキャンが進行中です。

  • IncrementalScanning:増分スキャンが進行中です。

親ノード:MetaQueryStatus

State

文字列

Running

メタデータインデックスライブラリのステータス。有効な値:

  • Ready:メタデータインデックスライブラリは、作成後に準備中です。

    この場合、メタデータインデックスライブラリを使用してデータを照会することはできません。

  • Stop:メタデータインデックスライブラリは一時停止されています。

  • Running:メタデータインデックスライブラリは実行中です。

  • Retrying:メタデータインデックスライブラリの作成に失敗し、再度作成中です。

  • Failed:メタデータインデックスライブラリの作成に失敗しました。

  • Deleted:メタデータインデックスライブラリは削除されました。

親ノード:MetaQueryStatus

CreateTime

文字列

2021-08-02T10:49:17.289372919+08:00

メタデータインデックスライブラリが作成された時刻。値は YYYY-MM-DDTHH:mm:ss+TIMEZONE 形式の RFC 3339 標準に準拠しています。 YYYY-MM-DD は年、月、日を、T は時間要素の開始を、HH:mm:ss は時、分、秒を、TIMEZONE はタイムゾーンを示します。

親ノード:MetaQueryStatus

UpdateTime

文字列

2021-08-02T10:49:17.289372919+08:00

メタデータインデックスライブラリが更新された時刻。値は YYYY-MM-DDTHH:mm:ss+TIMEZONE 形式の RFC 3339 標準に準拠しています。 YYYY-MM-DD は年、月、日を、T は時間要素の開始を、HH:mm:ss は時、分、秒を、TIMEZONE はタイムゾーンを示します。

親ノード:MetaQueryStatus

MetaQueryMode

文字列

basic

検索モード:

  • basic: スカラー検索

  • semantic: ベクトル検索

親ノード: MetaQueryStatus

リクエストの例

GET /?metaQuery HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 11 Sep 2024 13:08:38 GMT
Authorization: OSS qn6q**************:77Dv****************

レスポンスの例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Wed, 11 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<MetaQueryStatus>
  <State>Running</State>
  <Phase>FullScanning</Phase>
  <CreateTime>2024-09-11T10:49:17.289372919+08:00</CreateTime>
  <UpdateTime>2024-09-11T10:49:17.289372919+08:00</UpdateTime>
  <MetaQueryMode>basic</MetaQueryMode>
</MetaQueryStatus>

OSS SDK

以下のプログラミング言語の OSS SDK を使用して GetMetaQueryStatus を呼び出すことができます。

ossutil

GetMetaQueryStatus 操作に対応する ossutil コマンドについては、「get-meta-query-status」をご参照ください。