do-meta-query

注意事项

阿里云账号默认拥有查询满足指定条件的文件Object的权限。如果您需要通过RAM用户或者STS的方式进行添加修改，您必须拥有oss：DoMetaQuery权限。具体操作，请参见为RAM用户授权自定义的权限策略。

命令格式

ossutil api do-meta-query --bucket value --meta-query value [flags]

--meta-query

--meta-query配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

• XML语法：

  <MetaQuery>
    <Sort>string</Sort>
    <Order>string</Order>
    <Aggregations>
      <Aggregation>
        <Field>string</Field>
        <Operation>string</Operation>
      </Aggregation>
      ...
    </Aggregations>
    <NextToken>string</NextToken>
    <MaxResults>integer</MaxResults>
    <Query>string</Query>
  </MetaQuery>

• JSON语法：

  {
    "Query": "string",
    "Sort": "string",
    "Order": "string",
    "Aggregations": {
      "Aggregation": [
        {
          "Field": "string",
          "Operation": "string"
        },
        ...
      ]
    },
    "NextToken": "string",
    "MaxResults": integer
  }

使用示例

以下示例展示了如何查询存储空间examplebucket中满足指定条件的文件。

• 使用XML配置文件，meta-query.xml内容如下：

  <?xml version="1.0" encoding="UTF-8"?>
  <MetaQuery>
      <NextToken></NextToken>
      <MaxResults>5</MaxResults>
      <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
      <Sort>Size</Sort>
      <Order>asc</Order>
      <Aggregations>
          <Aggregation>
              <Field>Size</Field>
              <Operation>sum</Operation>
          </Aggregation>
          <Aggregation>
              <Field>Size</Field>
              <Operation>max</Operation>
          </Aggregation>
      </Aggregations>
  </MetaQuery>

命令示例如下：

ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.xml

• 使用JSON配置文件，meta-query.json内容如下：

  {
    "MaxResults": "5",
    "Query": "{\"Field\": \"Size\",\"Value\": \"1048576\",\"Operation\": \"gt\"}",
    "Sort": "Size",
    "Order": "asc",
    "Aggregations": {
      "Aggregation": [
        {
          "Field": "Size",
          "Operation": "sum"
        },
        {
          "Field": "Size",
          "Operation": "max"
        }
      ]
    }
  }

  命令示例如下：

  ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.json

• 使用JSON配置参数，命令示例如下：

  ossutil api do-meta-query --bucket examplebucket --meta-query "{\"MaxResults\":\"5\",\"Query\":\"{\\\"Field\\\": \\\"Size\\\",\\\"Value\\\": \\\"1048576\\\",\\\"Operation\\\": \\\"gt\\\"}\",\"Sort\":\"Size\",\"Order\":\"asc\",\"Aggregations\":{\"Aggregation\":[{\"Field\":\"Size\",\"Operation\":\"sum\"},{\"Field\":\"Size\",\"Operation\":\"max\"}]}}"