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.
Computação
Elastic Cloud Server
Bare Metal Server
Auto Scaling
Image Management Service
Dedicated Host
FunctionGraph
Cloud Phone Host
Huawei Cloud EulerOS
Redes
Virtual Private Cloud
Elastic IP
Elastic Load Balance
NAT Gateway
Direct Connect
Virtual Private Network
VPC Endpoint
Cloud Connect
Enterprise Router
Enterprise Switch
Global Accelerator
Gerenciamento e governança
Cloud Eye
Identity and Access Management
Cloud Trace Service
Resource Formation Service
Tag Management Service
Log Tank Service
Config
Resource Access Manager
Simple Message Notification
Application Performance Management
Application Operations Management
Organizations
Optimization Advisor
Cloud Operations Center
Resource Governance Center
Migração
Server Migration Service
Object Storage Migration Service
Cloud Data Migration
Migration Center
Cloud Ecosystem
KooGallery
Partner Center
User Support
My Account
Billing Center
Cost Center
Resource Center
Enterprise Management
Service Tickets
HUAWEI CLOUD (International) FAQs
ICP Filing
Support Plans
My Credentials
Customer Operation Capabilities
Partner Support Plans
Professional Services
Análises
MapReduce Service
Data Lake Insight
CloudTable Service
Cloud Search Service
Data Lake Visualization
Data Ingestion Service
GaussDB(DWS)
DataArts Studio
IoT
IoT Device Access
Outros
Product Pricing Details
System Permissions
Console Quick Start
Common FAQs
Instructions for Associating with a HUAWEI CLOUD Partner
Message Center
Segurança e conformidade
Security Technologies and Applications
Web Application Firewall
Host Security Service
Cloud Firewall
SecMaster
Anti-DDoS Service
Data Encryption Workshop
Database Security Service
Cloud Bastion Host
Data Security Center
Cloud Certificate Manager
Situation Awareness
Managed Threat Detection
Blockchain
Blockchain Service
Serviços de mídia
Media Processing Center
Video On Demand
Live
SparkRTC
Armazenamento
Object Storage Service
Elastic Volume Service
Cloud Backup and Recovery
Cloud Server Backup Service
Storage Disaster Recovery Service
Scalable File Service
Volume Backup Service
Data Express Service
Dedicated Distributed Storage Service
Containers
Cloud Container Engine
SoftWare Repository for Container
Application Service Mesh
Ubiquitous Cloud Native Service
Cloud Container Instance
Bancos de dados
Relational Database Service
Document Database Service
Data Admin Service
Data Replication Service
GeminiDB
GaussDB
Distributed Database Middleware
Database and Application Migration UGO
TaurusDB
Middleware
Distributed Cache Service
API Gateway
Distributed Message Service for Kafka
Distributed Message Service for RabbitMQ
Distributed Message Service for RocketMQ
Cloud Service Engine
EventGrid
Dedicated Cloud
Dedicated Computing Cluster
Aplicações de negócios
ROMA Connect
Message & SMS
Domain Name Service
Edge Data Center Management
Meeting
AI
Face Recognition Service
Graph Engine Service
Content Moderation
Image Recognition
Data Lake Factory
Optical Character Recognition
ModelArts
ImageSearch
Conversational Bot Service
Speech Interaction Service
Huawei HiLens
Developer Tools
SDK Developer Guide
API Request Signing Guide
Terraform
Koo Command Line Interface
Distribuição de conteúdo e computação de borda
Content Delivery Network
Intelligent EdgeFabric
CloudPond
Soluções
SAP Cloud
High Performance Computing
Serviços para desenvolvedore
ServiceStage
CodeArts
CodeArts PerfTest
CodeArts Req
CodeArts Pipeline
CodeArts Build
CodeArts Deploy
CodeArts Artifact
CodeArts TestPlan
CodeArts Check
Cloud Application Engine
MacroVerse aPaaS
KooPhone
KooDrive

Consulta de BMSs (API OpenStack nativo)

Atualizado em 2025-02-18 GMT+08:00

Função

Essa API é usada para consultar BMSs.

Restrições

  • O resultado da consulta retornado por essa interface inclui ECSs e BMSs. Você precisa filtrar os BMSs usando o flavor usado para criar os BMSs ou as tags adicionadas aos BMSs durante a criação do BMS.
  • Se a imagem for usada como critério de pesquisa, outros critérios de pesquisa e critérios de paginação não serão suportados. Se a imagem e outros critérios de pesquisa forem usados, os BMSs serão filtrados por imagem. Se a imagem não for usada como critério de pesquisa, esta interface não tem restrições.

URI

GET /v2.1/{project_id}/servers{?changes-since={changes-since}&image={image}&flavor={flavor}&name={name}&status={status}&limit={limit}&marker={marker}&tags={tags}&not-tags={not-tags}&reservation_id={reservation_id}&sort_key={sort_key}&sort_dir={sort_dir}}

A Tabela 1 lista os parâmetros.

Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Descrição

project_id

Sim

Especifica o ID do projeto.

Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

Solicitação

  • Parâmetros de solicitação

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    changes-since

    Não

    String

    Especifica o carimbo de data/hora da última atualização de status do BMS. O parâmetro está no formato de hora ISO 8601, por exemplo, 2013-06-09T06:42:18Z.

    image

    Não

    String

    Especifica o ID da imagem.

    Você pode obter o ID da imagem no console do IMS ou chamando a API de Consulta de imagens.

    NOTA:

    Se a imagem for usada como critério de pesquisa, outros critérios de pesquisa e critérios de paginação não serão suportados. Se a imagem e outros critérios de pesquisa forem usados, os detalhes do BMS serão filtrados por imagem. Se a imagem não for usada como critério de pesquisa, esta interface não tem restrições.

    flavor

    Não

    String

    Especifica o ID do flavor.

    Você pode obter o ID do flavor no console do BMS ou usando a API de Consulta de flavors do BMS (API OpenStack nativo).

    name

    Não

    String

    Especifica o nome de BMS. Este parâmetro suporta correspondência difusa.

    Por exemplo, a expressão regular ?name=bob retornará bob e bobb. Para obter apenas bob, você pode usar uma expressão regular que combine com a sintaxe básica do banco de dados, como MySQL ou PostgreSQL (site oficial: https://www.postgresql.org/docs/9.2/static/functions-matching.html).

    status

    Não

    String

    Especifica o status do BMS.

    Intervalo de valores:

    • ACTIVE: executando, interrompendo, apagando
    • BUILD: criando
    • ERROR: defeito
    • HARD_REBOOT: reiniciando à força
    • REBOOT: reiniciando
    • DELETED: excluída
    • SHUTOFF: interrompido, iniciando, excluindo, reconstruindo, reinstalando SO, falha na reinstalação do SO, congelado

    limit

    Não

    Integer

    Especifica o número de BMSs exibidos em cada página.

    marker

    Não

    String

    Especifica o ID do BMS ao qual o marcador corresponde. A consulta começará a partir do próximo ID.

    tags

    Não

    String

    Consulta os BMSs com tags especificadas.

    Adicionado na versão micro 2.26.

    not-tags

    Não

    String

    Consulta os BMSs com tags que não contêm o valor especificado. O valor é uma lista de chaves de tag.

    NOTA:

    Se as tags adicionadas antes da atualização da função estiverem no formato "Key.Value", consulte as tags usando "Key".

    Por exemplo, uma tag existente é a.b. Após a atualização da função tag, consulte a tag usando "not-tags=a".

    Adicionado na versão micro 2.26.

    reservation_id

    Não

    String

    Especifica o ID reservado, que pode ser usado para consultar BMSs criados em um lote.

    Adicionado na versão micro 2.26.

    sort_key

    Não

    String

    Especifica o atributo de classificação do BMS, que pode ser o UUID do BMS (uuid), status do BMS (vm_state), nome do BMS (display_name), status da tarefa do BMS (task_state), status da energia (power_state), tempo de criação (created_at), última vez quando o BMS é atualizado (updated_at) e AZ (availability_zone). Você pode especificar vários pares sort_key e sort_dir.

    A classificação padrão é a ordem inversa por created_at.

    sort_dir

    Não

    String

    Especifica a direção de classificação.

    • asc: os resultados da consulta são exibidos em ordem crescente.
    • desc (valor padrão): os resultados da consulta são exibidos em ordem decrescente.
  • Exemplo de solicitação
    • Sem nenhum parâmetro opcional
      1
      GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers
      
    • Com um parâmetro opcional
      1
      GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers?tags=__type_baremetal
      
    • Com vários parâmetros opcionais
      1
      GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers?tags=__type_baremetal&name=bms-test01
      

Resposta

  • Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    servers

    Array of objects

    Especifica a lista do BMS. Para mais detalhes, consulte Tabela 2.

    Tabela 2 Descrição da estrutura de dados do campo servers

    Parâmetro

    Tipo

    Descrição

    name

    String

    Especifica o nome de BMS.

    id

    String

    Especifica o ID exclusivo do BMS.

    links

    Array of objects

    Especifica os links de atalho do BMS. Para mais detalhes, consulte Tabela 3.

    Tabela 3 Descrição da estrutura de dados do campo links

    Parâmetro

    Tipo

    Descrição

    rel

    String

    Especifica o nome do marcador do link de atalho. O valor pode ser:

    • self: link de recurso que contém o número da versão. É usado quando o rastreamento imediato é necessário.
    • bookmark: link de recurso que pode ser armazenado por um longo tempo.

    href

    String

    Especifica o link de atalho correspondente.

  • Exemplo de resposta
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    {
        "servers": [
            {
                "name": "bms",
                "links": [
                    {
                        "rel": "self",
                        "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/820abbd0-2d8b-4bc5-ae46-69cacfd4fbaa"
                    },
                    {
                        "rel": "bookmark",
                        "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa"
                    }
                ],
                "id": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa"
            }
        ]
    }
    

Valores retornados

Valores normais

Valores retornados

Descrição

200

A solicitação foi processada com sucesso.

Para obter detalhes sobre outros valores retornados, consulte Códigos de status.

Códigos de erro

Consulte Códigos de erro.

Usamos cookies para aprimorar nosso site e sua experiência. Ao continuar a navegar em nosso site, você aceita nossa política de cookies. Saiba mais

Feedback

Feedback

Feedback

0/500

Conteúdo selecionado

Envie o conteúdo selecionado com o feedback