Consulta de número de sistemas de arquivos compartilhados por tag

Função

Essa API é usada para consultar o número de sistemas de arquivos compartilhados por tag.

URI

• POST /v2/{project_id}/sfs/resource_instances/action
• Descrição do parâmetro

  Parâmetro	Obrigatoriedade	Tipo	Descrição
  project_id	Sim	String	Especifica o ID do projeto do operador. Para obter detalhes de como conseguir o ID do projeto, consulte Obtenção de um ID de projeto.

Request Header

The operation message header is the same as that of a common request. For details, see Tabela 3.

Solicitação

• Descrição do parâmetro

  Parâmetro	Obrigatoriedade	Tipo	Descrição
  action	Sim	String	Especifica o identificador da operação. Os valores possíveis são filter e count. Use count para consultar o número de instâncias de compartilhamento com base em tags.
  matches	Não	Array of matches	Especifica o campo de consulta do sistema de arquivos. Se esse parâmetro for deixado nulo, todos os sistemas de arquivos compartilhados do locatário serão pesquisados por padrão.
  tags	Não	Array de tags	Especifica o campo de pesquisa de tags, que é uma lista de tags. Somente sistemas de arquivos compartilhados contendo todas as tags listadas podem ser retornados. As tags neste critério de pesquisa estão na relação AND. Especificamente, um sistema de arquivos compartilhado pode ser pesquisado somente quando ele atende a todos os critérios de pesquisa de tags. Na estrutura de valores-chave de cada condição de pesquisa de tag, os valores de tag estão na relação OR. Se o valor das tags não for especificado, todos os sistemas de arquivos compartilhados atendem aos requisitos desse campo de pesquisa de tags. Este campo contém um máximo de 10 chaves de tag e cada chave de tag tem um máximo de 10 valores de tag. O valor da tag correspondente a cada chave da tag pode ser uma matriz vazia, mas a estrutura não pode estar faltando. As chaves de tag devem ser únicas. Os valores de tag em uma estrutura de valores-chave devem ser exclusivos.
  tags_any	Não	Array of tags	Especifica o campo de pesquisa de tags, que é uma lista de tags. Sistemas de arquivos compartilhados que contenham qualquer tag listada serão retornados. As tags neste critério de pesquisa estão na relação OR. Especificamente, um sistema de arquivos compartilhados pode ser pesquisado desde que atenda a uma condição de pesquisa de tags. Na estrutura de valores-chave de cada condição de pesquisa de tag, os valores de tag estão na relação OR. Se o valor de tags_any não for especificado, todos os sistemas de arquivos compartilhados atendem aos requisitos desse campo de pesquisa de tags. Este campo contém um máximo de 10 chaves de tag e cada chave de tag tem um máximo de 10 valores de tag. O valor da tag correspondente a cada chave da tag pode ser uma matriz vazia, mas a estrutura não pode estar faltando. As chaves de tag devem ser únicas. Os valores de tag em uma estrutura de valores-chave devem ser exclusivos.
  not_tags	Não	Array of tags	Especifica o campo de pesquisa de tags, que é uma lista de tags. Somente sistemas de arquivos compartilhados que não contenham nenhuma das tags listadas serão retornados. As tags neste critério de pesquisa estão na relação NOR. Especificamente, um sistema de arquivos compartilhados pode ser pesquisado somente quando não atende a nenhum critério de pesquisa de tags. Na estrutura de valores-chave de cada condição de pesquisa de tag, os valores de tag estão na relação OR. Se o valor de not_tags não for especificado, todos os sistemas de arquivos compartilhados atendem aos requisitos desse campo de pesquisa de tags. Este campo contém um máximo de 10 chaves de tag e cada chave de tag tem um máximo de 10 valores de tag. O valor da tag correspondente a cada chave da tag pode ser uma matriz vazia, mas a estrutura não pode estar faltando. As chaves de tag devem ser únicas. Os valores de tag em uma estrutura de valores-chave devem ser exclusivos.
  not_tags_any	Não	Array of tags	Especifica o campo de pesquisa de tags, que é uma lista de tags. Sistemas de arquivos compartilhados que não contenham nenhuma das tags listadas serão retornados. As tags neste critério de pesquisa estão na relação NAND. Especificamente, um sistema de arquivos compartilhados pode ser pesquisado, desde que não atenda a uma condição de pesquisa de tags. Na estrutura de valores-chave de cada condição de pesquisa de tag, os valores de tag estão na relação OR. Se o valor de not_tags_any não for especificado, todos os sistemas de arquivos compartilhados atendem aos requisitos desse campo de pesquisa de tags. Este campo contém um máximo de 10 chaves de tag e cada chave de tag tem um máximo de 10 valores de tag. O valor da tag correspondente a cada chave da tag pode ser uma matriz vazia, mas a estrutura não pode estar faltando. As chaves de tag devem ser únicas. Os valores de tag em uma estrutura de valores-chave devem ser exclusivos.
  sys_tags	Não	Array of tags	Somente a permissão op_service pode usar esse campo para filtrar recursos. Atualmente, o TMS pode invocar apenas uma chave de estrutura de tag, _sys_enterprise_project_id. Atualmente, key contém apenas um valor. 0 indica o projeto empresarial padrão. As condições de filtragem de sys_tags e de tag de locatário (tags, tags_any, not_tags e not_tags_any) não podem ser usadas ao mesmo tempo.

  

  Nos parâmetros de solicitação, os campos de pesquisa de tags, tags_any, not_tags e not_tags_any são opcionais e podem ser combinados entre si. Esses campos de pesquisa de tags estão na relação AND.

• Descrição do campo de match

  Parâmetro	Obrigatoriedade	Tipo	Descrição
  key	Sim	String	Especifica a chave. O valor é fixado em resource_name.
  value	Sim	String	Especifica o valor. value indica o nome de um sistema de arquivos compartilhado. Uma cadeia de caracteres vazia especifica uma correspondência exata e somente sistemas de arquivos compartilhados cujos nomes estão vazios podem ser consultados. Uma cadeia não vazia especifica uma consulta difusa (não diferencia maiúsculas de minúsculas). O valor pode conter no máximo 255 caracteres.

• Descrição do campo de tag

  Parâmetro	Obrigatoriedade	Tipo	Descrição
  key	Sim	String	Especifica a chave da tag. A chave de tag pode conter no máximo 127 caracteres. Este parâmetro não pode ser deixado em branco.
  valores	Sim	Array of strings	Lista os valores. Cada valor pode conter no máximo 255 caracteres. Se o valor for deixado vazio, qualquer valor será correspondido. Os valores estão na relação OR.

• Exemplo de solicitação

  {
      "action": "count",
      "matches": [{
          "key": "resource_name",
          "value": "share_name"
      }],
      "tags": [{
          "key": "key1",
          "values": ["value2"]
      }, {
          "key": "key2",
          "values": []
      }],
      "tags_any": [{
          "key": "key3",
          "values": ["value3"]
      }, {
          "key": "key4",
          "values": []
      }],
      "not_tags": [{
          "key": "key5",
          "values": ["value5"]
      }, {
          "key": "key6",
          "values": []
      }],
      "not_tags_any": [{
          "key": "key7",
          "values": ["value7", "value8"]
      }, {
          "key": "key9",
          "values": []
      }]
  }

Resposta

• Descrição do parâmetro

  Parâmetro	Tipo	Descrição
  total_count	Integer	Especifica o número total de sistemas de arquivos compartilhados que atendem aos critérios de consulta.

• Exemplo de resposta

  {
      "total_count":1
  }

Códigos de estado

• Normal

  200

• Anormal

  Código de estado	Descrição
  400 Bad Request	Valor inválido.
  401 Unauthorized	Autenticação falhou.
  403 Forbidden	O acesso à página solicitada é proibido.
  404 Not Found	O recurso solicitado não foi encontrado.
  500 Internal Server Error	A solicitação não foi concluída devido a um erro de serviço.