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

使用上の注意

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

リクエストの構文

GET /?metaQuery HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue

レスポンス要素

要素名 データ型 説明
MetaQueryStatus コンテナー N/A メタデータ情報を格納するコンテナ。

子ノード: State、Phase、CreateTime、およびUpdateTime。

フェーズ String FullScanning スキャンタイプ。 設定可能な値は以下のとおりです。
  • FullScanning: Full scanning is in progress.
  • IncrementalScanning: Incremental scanning is in progress.

親ノード: MetaQuery。

ステータス String 実行中 メタデータインデックスライブラリのステータス。 設定可能な値は以下のとおりです。
  • 準備完了: メタデータインデックスライブラリは、作成後に準備中です。

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

  • 停止: メタデータインデックスライブラリは一時停止しています。
  • 実行中: メタデータインデックスライブラリが実行中です。
  • 再試行: メタデータインデックスライブラリの作成に失敗し、再度作成中です。
  • Failed: The metadata index library failed to be created.
  • Deleted: メタデータインデックスライブラリが削除されました。

親ノード: MetaQuery。

CreateTime String 2021-08-02T10:49:17.289372919+08:00 メタデータインデックスライブラリが作成された時刻。 この値は、YYYY-MM-DDTHH:mm:ss + TIMEZONE形式のRFC 3339標準に従います。 YYYY-MM-DDは、年、月、および日を示します。 Tは時間要素の開始を示す。 HH:mm:ssは、時、分、秒を示します。 TIMEZONE indicates the time zone.

親ノード: MetaQuery。

UpdateTime String 2021-08-02T10:49:17.289372919 + 08:00 メタデータインデックスライブラリが更新された時刻。 この値は、YYYY-MM-DDTHH:mm:ss + TIMEZONE形式のRFC 3339標準に従います。 YYYY-MM-DDは、年、月、および日を示します。 Tは時間要素の開始を示す。 HH:mm:ssは、時、分、秒を示します。 TIMEZONEはタイムゾーンを示します。

親ノード: MetaQuery。

リクエストの例
GET /?metaQuery HTTP/1.1
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
日付: 7月26日月曜日2021 13:08:38 GMT
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****
レスポンスの例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D ****
日付: 7月26日月曜日2021 13:08:38 GMT
コンテンツ-長さ: 118
Content-Type: application/xml
接続: キープアライブ
サーバー: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<MetaQueryStatus>
  <State> ランニング </State>
  <Phase>FullScanning</Phase>
  <CreateTime>2021-08-02T10:49:17.289372919 + 08:00</CreateTime>
  <UpdateTime>2021-08-02T10:49:17.289372919 + 08:00</UpdateTime>
</MetaQueryStatus>

エラーコード

エラーコード HTTP ステータスコード 説明
MetaQueryNotExist 400 メタデータインデックスライブラリがバケットに存在しない場合に返されるエラーメッセージ。 バケットのメタデータ管理機能が有効になっていることを確認し、メタデータインデックスライブラリの作成後に再試行してください。
AccessDenied 403 バケットにアクセスする権限がない場合に返されるエラーメッセージ。 RAMユーザーにバケットへのアクセス権限が付与されていることを確認します。
NoSuchBucket 404 宛先バケットが存在しない場合に返されるエラーメッセージ。 有効なバケット名を指定します。