Object Storage Service:do-meta-query

Observações

Por padrão, uma conta Alibaba Cloud tem permissão para consultar objetos que atendem a condições específicas. Para adicionar ou modifique permissões com um usuário RAM ou o Security Token Service (STS), você deve ter a permissão oss:DoMetaQuery. Para mais informações, consulte Conceder permissões personalizadas a um usuário RAM.

Sintaxe do comando

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

--meta-query

A opção de configuração --meta-query aceita os formatos XML e JSON. Se o valor contiver o prefixo file://, o ossutil lê as configurações de um arquivo.

• Formato XML:

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

• Formato json:

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

Exemplos

• Os exemplos a seguir mostram como consultar objetos que atendem a condições específicas no bucket examplebucket usando o modo escalar de indexação de dados.

  • Crie um arquivo de configuração chamado meta-query.xml e adicione o seguinte código:

    <?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>

    Comandos de exemplo:

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

  • Crie um arquivo de configuração chamado meta-query.json e adicione o seguinte código:

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

    Comandos de exemplo:

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

  • Use parâmetros json na linha de comando:

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

• Os exemplos a seguir mostram como consultar objetos que atendem a condições específicas no bucket examplebucket usando o modo vetorial de indexação de dados.

  • Crie um arquivo de configuração chamado meta-query.xml e adicione o seguinte código:

    <?xml version="1.0" encoding="UTF-8"?>
    <MetaQuery>
        <Query>Overlooking the snow covered forest</Query>
        <MediaTypes>
            <MediaType>image</MediaType>
        </MediaTypes>
        <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "1"}</SimpleQuery>
    </MetaQuery>

    Comandos de exemplo:

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

  • Crie um arquivo de configuração chamado meta-query.json e adicione o seguinte código:

    {
        "Query": "Overlooking the snow covered forest",
        "MediaTypes": {
          "MediaType": "image"
        },
        "SimpleQuery": "{\"Operation\":\"gt\", \"Field\": \"Size\", \"Value\": \"1\"}"
    }

    Comandos de exemplo:

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

  • Use parâmetros json na linha de comando:

    ossutil api do-meta-query --bucket examplebucket --meta-query "{\"Query\":\"Overlooking the snow covered forest\",\"MediaTypes\":{\"MediaType\":\"image\"},\"SimpleQuery\":\"{\\\"Operation\\\":\\\"gt\\\", \\\"Field\\\": \\\"Size\\\", \\\"Value\\\": \\\"1\\\"}\"}" --meta-query-mode semantic