Object Storage Service:do-meta-query

Notas

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos para consultar objetos que cumplen condiciones específicas. Si desea agregar o modificar permisos mediante un usuario de RAM o Security Token Service (STS), debe contar con el permiso oss:DoMetaQuery. Para obtener más información, consulte Grant custom permissions to a RAM user.

Sintaxis del comando

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

--meta-query

La opción de configuración --meta-query admite formatos XML y JSON. Si el valor de la opción incluye el prefijo file://, ossutil lee la configuración desde un archivo de configuración.

• 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
  }

Ejemplos

• A continuación se muestra cómo consultar objetos que cumplen condiciones específicas en el bucket examplebucket mediante el modo escalar de indexación de datos.

  • Cree un archivo de configuración llamado meta-query.xml y agregue el siguiente código al archivo:

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

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

  • Cree un archivo de configuración llamado meta-query.json y agregue el siguiente código al archivo:

    {
      "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 ejemplo:

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

  • Use parámetros JSON directamente en la línea de comandos:

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

• Los siguientes ejemplos muestran cómo consultar objetos que cumplen condiciones específicas en el bucket examplebucket mediante el modo vectorial de indexación de datos.

  • Cree un archivo de configuración llamado meta-query.xml y agregue el siguiente código al archivo:

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

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

  • Cree un archivo de configuración llamado meta-query.json y agregue el siguiente código al archivo:

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

    Comandos de ejemplo:

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

  • Use parámetros JSON directamente en la línea de comandos:

    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