Object Storage Service:do-meta-query

Notes

Par défaut, un compte Alibaba Cloud est autorisé à interroger les objets répondant à des conditions spécifiques. Pour ajouter ou modifier des autorisations via un utilisateur RAM ou le Security Token Service (STS), vous devez disposer de l'autorisation oss:DoMetaQuery. Pour plus d'informations, consultez la rubrique Accorder des autorisations personnalisées à un utilisateur RAM.

Syntaxe de la commande

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

--meta-query

L'option de configuration --meta-query prend en charge les formats XML et JSON. Si la valeur de l'option contient le préfixe file://, ossutil lit les configurations depuis un fichier.

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

• Format JSON :

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

Exemples

• Les exemples suivants montrent comment interroger les objets répondant à des conditions spécifiques dans le bucket examplebucket en utilisant le mode scalaire de l'indexation des données.

  • Créez un fichier de configuration nommé meta-query.xml et ajoutez-y le code suivant :

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

    Exemple de commande :

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

  • Créez un fichier de configuration nommé meta-query.json et ajoutez-y le code suivant :

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

    Exemple de commande :

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

  • Utilisez des paramètres JSON directement dans la ligne de commande :

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

• Les exemples suivants montrent comment interroger les objets répondant à des conditions spécifiques dans le bucket examplebucket en utilisant le mode vectoriel de l'indexation des données.

  • Créez un fichier de configuration nommé meta-query.xml et ajoutez-y le code suivant :

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

    Exemple de commande :

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

  • Créez un fichier de configuration nommé meta-query.json et ajoutez-y le code suivant :

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

    Exemple de commande :

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

  • Utilisez des paramètres JSON directement dans la ligne de commande :

    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