Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Image Management Service/ Referência de API/ As API do IMS/ Marcação de imagem/ Consulta das tags

Atualizado em 2022-11-16 GMT+08:00

Ver PDF

Consulta das tags

Função

Essa API é usada para consultar tags de imagem usando critérios de pesquisa e exibi-las em uma lista.

URI

GET /v1/cloudimages/tags{?__isregistered,__imagetype,__whole_image,__system__cmkid,protected,visibility,owner,id,status,name,flavor_id,container_format,disk_format,min_ram,min_disk,__os_bit,__platform,marker,limit,sort_key,sort_dir,__os_type,tag,member_status,__support_kvm,__support_xen,__support_largememory,__support_diskintensive,__support_highperformance,__support_xen_gpu_type,__support_kvm_gpu_type,__support_xen_hana,__support_kvm_infiniband,virtual_env_type,enterprise_project_id,created_at,updated_at}

Você pode digitar um ponto de interrogação (?) e um (&) comercial no final do URI para definir vários critérios de pesquisa. Para obter detalhes, consulte a solicitação de exemplo.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Tipo	Descrição
__está cadastrado	Não	Cadeia	Especifica se a imagem está disponível. O valor pode ser true. O valor é true para todas as API de extensão por padrão. Os usuários comuns podem consultar apenas as imagens para as quais o valor deste parâmetro é true.
__tipo de imagem	Não	Cadeia	Especifica o tipo de imagem. Há suporte para as seguintes funções: Imagem pública: O valor é gold. Imagens privadas O valor é private. Imagem compartilhada: O valor é shared. NOTA: O __imagetype de imagens que você compartilha com outros inquilinos ou que outros inquilinos compartilham com você e você aceitou é shared. Você pode usar o campo owner para distinguir os dois tipos de imagens compartilhadas. Você pode usar member_status para filtrar imagens compartilhadas que você aceitou.
__imagem_inteira	Não	Booleano	Especifica se a imagem é uma imagem de ECS inteiro. O valor pode ser true ou false.
__sistema__cmkid	Não	Cadeia	Especifica a ID da chave usada para encriptar a imagem. Você pode obter a ID no console do IMS ou chamando a API do Consulta de detalhes de uma imagem (API OpenStack nativo).
Protegida	Não	Booleano	Especifica se a imagem está protegida. O valor pode ser true ou false. Defina-o como true quando você consulta imagens públicas. Este parâmetro é opcional quando você consulta imagens privadas.
Visibilidade	Não	Cadeia	Especifica se a imagem está disponível para outros locatários. Os valores disponíveis incluem: public: imagem pública private: imagem privada shared: imagem compartilhada
Proprietário	Não	Cadeia	Especifica o locatário ao qual a imagem pertence.
ID	Não	Cadeia	Especifica o ID da imagem.
estado	Não	Cadeia	Especifica a tag de imagem. O valor pode ser um dos seguintes: queued: indica que os metadados da imagem já foram criados e que estão prontos para o upload do arquivo de imagem. saving: indica que o arquivo de imagem está sendo carregado para o armazenamento de backend. deleted: indica que a imagem foi excluída. killed: indica que ocorre um erro no upload da imagem. active: indica que a imagem está disponível para uso.
Nome	Não	Cadeia	Especifica o nome de imagem. A correspondência exata é usada. Para uma descrição detalhada, consulte Atributos da imagem.
flavor_id	Não	Cadeia	Especifica o ID de variante do ECS usada para filtrar imagens públicas disponíveis. Nota: Você pode especificar apenas um ID de variante. Você pode especificar apenas um ID de variação ECS e não pode especificar um ID de variação BMS. Para filtrar imagens públicas suportadas por uma variação do BMS, use __support_s4l=true filter criterion. s4l indicates board_type de variante do BMS physical.s4.large. Consulte Métodos Comuns de Consulta para obter um exemplo de chamada.
formato_contêiner	Não	Cadeia	Especifica o tipo de contêiner. O valor é bare.
formato_do_disco	Não	Cadeia	Especifica o formato da imagem. O valor pode servhd, raw, zvhd,iso, ou qcow2. O valor padrão é zvhd2.
min_ram	Não	número inteiro	Especifica o tamanho mínimo de memória (MB) necessário para executar a imagem. O valor do parâmetro depende das especificações do ECS. Geralmente, o valor é 0.
disco_mínimo	Não	número inteiro	Especifica o espaço mínimo em disco (GB) necessário para executar a imagem. O valor varia de 40 GB a 255 GB.
__os_bit	Não	Cadeia	Especifica a arquitetura do SO, 32 ou 64 bit.
__plataforma	Não	Cadeia	Especifica o tipo de plataforma da imagem. O valor pode ser Windows, Ubuntu, RedHat, SUSE, CentOS, Debian, OpenSUSE, Oracle Linux, Fedora, Other, CoreOS, ou EulerOS.
Marcador	Não	Cadeia	Especifica o número inicial a partir do qual as imagens são consultadas. O valor é o ID da imagem.
Limite	Não	número inteiro	Especifica o número de imagens a serem consultadas. O valor é um inteiro e é 500 por padrão.
chave_classificação	Não	Cadeia	Especifica o campo para classificar os resultados da consulta. O valor pode ser um atributo da imagem: name, container_format, disk_format, status, id, size, ou created_at. O valor padrão é created_at.
dir_classificação	Não	Cadeia	Especifica se os resultados da consulta são classificados em ordem crescente ou decrescente. Cujo valor pode ser desc (padrão) ou asc. Este parâmetro é usado junto com o parâmetro sort_key. O valor padrão é desc.
__os_tipo	Não	Cadeia	Especifica o tipo de imagem. Os valores disponíveis incluem: Linux janelas Outros
Tag	Não	Cadeia	Especifica uma tag adicionada a uma imagem. As tags podem ser usadas como um filtro para consultar imagens. NOTA: A função de marcação foi atualizada. Se as tags adicionadas antes da atualização da função estiverem no formato de "Key.Value", consulte as tags usando "Key=Value". Por exemplo, uma tag existente é a.b. Após a atualização da função tag, consulte a tag usando "tag=a=b".
estado_membro	Não	Cadeia	Especifica o status de imagem. O valor pode ser accepted, rejected, ou pending. accepted: indica que a imagem compartilhada é aceita. rejected indica que a imagem compartilhada por outras pessoas é rejeitada. pending indica que a imagem compartilhada por outras pessoas precisa ser confirmada. Para usar esse parâmetro, defina visibility para shared durante a consulta.
__suporte_kvm	Não	Cadeia	Especifica se a imagem suporta KVM. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_xen	Não	Cadeia	Especifica se a imagem suporta Xen. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_largememória	Não	Cadeia	Especifica se a imagem suporta os ECS de memória grande. Se a imagem suportar os ECS de memória grande, o valor é true. Caso contrário, este parâmetro não é necessário. Para os SO compatíveis, consulte Os SO suportados por diferentes tipos dos ECS.
__suporte_disco intensivo	Não	Cadeia	Especifica se a imagem oferece suporte aos ECS com uso intenso de disco. Se a imagem suportar os ECS com uso intenso de disco, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_alto desempenho	Não	Cadeia	Especifica se a imagem suporta os ECS de alto desempenho. Se a imagem oferecer suporte aos ECS de alto desempenho, o valor é true. Caso contrário, este parâmetro não é necessário.
__suporte_xen_gpu_type	Não	Cadeia	Especifica se a imagem suporta os ECS acelerados por GPU na plataforma Xen. Veja Tabela 2 para cujo valor. Se a imagem não oferecer suporte aos ECS acelerados por GPU na plataforma Xen, esse parâmetro não será necessário. Este atributo não pode coexistir com __support_xen ou __support_kvm.
__suporte_kvm_gpu_type	Não	Cadeia	Especifica se a imagem suporta os ECS acelerados por GPU na plataforma KVM. Veja Tabela 3 para cujo valor. Se a imagem não suportar os ECS acelerados por GPU na plataforma KVM, esse parâmetro não é necessário. Este atributo não pode coexistir com __support_xen ou __support_kvm.
__suporte_xen_hana	Não	Cadeia	Especifica se a imagem suporta os ECS HANA na plataforma Xen. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário. Este atributo não pode coexistir com __support_xen ou __support_kvm.
__suporte_kvm_infiniband	Não	Cadeia	Especifica se a imagem suporta ECSs com a NIC InfiniBand na plataforma KVM. Se sim, o valor é true. Caso contrário, este parâmetro não é necessário. Este atributo não pode coexistir com __support_xen.
tipo_virtual_env	Não	Cadeia	Especifica o ambiente em que a imagem é usada. O valor pode ser FusionCompute, Ironic, DataImage, ou IsoImage. Para uma imagem do ECS (imagem de disco do sistema), o valor é FusionCompute. Para uma imagem de disco de dados, o valor é DataImage. Para uma imagem do BMS, o valor é Ironic. Para uma imagem do ISO, o valor é IsoImage.
id_do_projeto_da_empresa	Não	Cadeia	Especifica o projeto empresarial ao qual pertencem as imagens a serem consultadas. Se o valor for 0, as imagens padrão do projeto empresarial default devem ser consultadas. Se o valor for UUID, as imagens do projeto empresarial correspondente ao UUID devem ser consultadas. Se o valor for all_granted_eps, as imagens de todos os projetos empresariais devem ser consultadas. Para obter mais informações sobre projetos corporativos e como obter os ID de projeto corporativo, consulte Centro Empresarial
criado_em	Não	Cadeia	Especifica a hora em que a imagem foi criada. As imagens podem ser consultadas por tempo. O valor está no formato de Operator:UTC time. Os seguintes valores são suportados: gt: é superior a gte: é superior ou igual a lt: menos que lte: é menos ou igual a eq: igual a neq: não é igual a O formato da hora é yyyy-MM-ddThh:mm:ssZ ou yyyy-MM-dd hh:mm:ss. Por exemplo, para consultar imagens criadas antes de 28 de outubro de 2018 10:00:00, defina o valor de created_at da seguinte forma: created_at=lt:2018-10-28T10:00:00Z
atualizado_em	Não	Cadeia	Especifica a hora em que a imagem foi atualizada. As imagens podem ser consultadas por tempo. O valor está no formato de Operator:UTC time. Os seguintes valores são suportados: gt: é superior a gte: é superior ou igual a lt: menos que lte: é menos ou igual a eq: igual a neq: não é igual a O formato da hora é yyyy-MM-ddThh:mm:ssZ ou yyyy-MM-dd hh:mm:ss. Por exemplo, para consultar imagens atualizadas antes de 28 de outubro de 2018 10:00:00, defina o valor de updated_at da seguinte forma: updated_at=lt:2018-10-28T10:00:00Z

Solicitação

Parâmetros de solicitação
Nenhum

Exemplo de solicitação

GET https://{Endpoint}/v1/cloudimages/tags?limit=5&page=1

Resposta

Parâmetros de resposta

Parâmetro	Tipo	Descrição
Tags	Matriz de strings	Lista as tags.

Exemplo de resposta

CÓDIGO DE STATUS 200

      
           {
   "tags": [
      "jjjj.11111",
      "uuuu.22222",
      "234.4",
      "test",
      "image"
   ]
}

Na nova especificação, sinais iguais são usados como separadores.

Valor retornado

Normal
200

Anormal

Valor retornado	Descrição
400 Solicitação inválida	Erro na solicitação. Para obter detalhes sobre o código de erro retornado, consulte Códigos de erro.
401 Não autorizado	Autenticação falhou.
403 Proibido	Você não tem os direitos para realizar a operação.
404 Não encontrado	O recurso solicitado não foi encontrado.
500 Erro de servidor interno	Erro do serviço interno.
503 Serviço indisponível	Serviço não está disponível.