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 recursos por tag

Atualizado em 2023-02-20 GMT+08:00

Função

Essa API é usada para consultar recursos como gateways virtuais e interfaces virtuais por tag.

URI

POST /v3/{project_id}/{resource_type}/resource-instances/action

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Especifica o ID do projeto.

resource_type

Sim

String

Especifica o tipo de recurso da Direct Connect.

  • dc-directconnect: conexão
  • dc-vgw: gateway virtual
  • dc-vif: interface virtual

Valores de enumeração:

  • dc-directconnect
  • dc-vgw
  • dc-vif
  • dc-lag

Parâmetros de solicitação

Tabela 2 Parâmetros de corpo de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

offset

Não

String

Especifica a posição do índice. A consulta começa a partir do próximo registro de dados indexado por esse parâmetro. Não é necessário especificar esse parâmetro ao consultar recursos na primeira página. Ao consultar recursos em páginas subsequentes, defina esse parâmetro como o valor retornado no corpo da resposta da consulta anterior. Este parâmetro não está disponível quando action é definida como count. Se action estiver definida como filter, o valor deve ser um número e o valor padrão é 0. O valor não pode ser um número negativo.

limit

Não

String

Especifica o número de registros a serem consultadas. Este parâmetro não está disponível quando action é definida como count. Se action estiver definida como filter, o valor padrão é 1000. O valor máximo é 1000 e o valor mínimo é 1. O valor não pode ser um número negativo.

action

Sim

String

Especifica a operação a ser executada, que só pode ser filter (filtragem) ou count (consultando o número total). O filter indica consulta de paginação. O count indica que o número total de resultados de consulta que atendem aos critérios de pesquisa será retornado. Não é permitido devolver outros campos.

Valores de enumeração:

  • filter
  • count

matches

Não

Array of Match objects

Especifica os critérios de pesquisa. A key é o campo a ser correspondido, por exemplo, resource_name. O value indica o valor a ser correspondido. Este campo é um valor de dicionário fixo. Determine se a correspondência difusa é necessária com base em campos diferentes. Por exemplo, se a key for resource_name, a pesquisa difusa (sem distinção entre maiúsculas e minúsculas) será usada por padrão. Se o value for uma cadeia vazia, a correspondência exata será usada. Se key for resource_id, a correspondência exata será usada. Atualmente, somente resource_name é suportado.

not_tags

Não

Array of Tags objects

Especifica as tags que não estão incluídas. Cada tag contém um máximo de 10 chaves, e cada chave contém um máximo de 10 valores. O corpo da estrutura não pode estar ausente e a chave não pode ser deixada em branco ou definida como uma cadeia vazia. As chaves devem ser únicas e os valores de uma chave devem ser exclusivos. Os recursos não identificados por chaves diferentes estão no relacionamento AND e os valores em uma tag estão no relacionamento OR. Se nenhuma condição de filtragem for especificada, os dados completos serão retornados.

tags

Não

Array of Tags objects

Especifica as tags que estão incluídas. Cada tag contém um máximo de 10 chaves, e cada chave contém um máximo de 10 valores. O corpo da estrutura não pode estar ausente e a chave não pode ser deixada em branco ou definida como uma cadeia vazia. As chaves devem ser únicas e os valores de uma chave devem ser exclusivos. Os recursos identificados por chaves diferentes estão no relacionamento AND e os valores em uma tag estão no relacionamento OR. Se nenhum critério de filtragem de tag for especificado, dados completos serão retornados.

tags_any

Não

Array of Tags objects

Especifica qualquer tag incluída. Cada tag contém um máximo de 10 chaves, e cada chave contém um máximo de 10 valores. O corpo da estrutura não pode estar ausente e a chave não pode ser deixada em branco ou definida como uma cadeia vazia. As chaves devem ser únicas e os valores de uma chave devem ser exclusivos. Os recursos identificados por chaves diferentes estão no relacionamento OR e os valores em uma tag estão no relacionamento OR. Se nenhuma condição de filtragem for especificada, os dados completos serão retornados.

not_tags_any

Não

Array of Tags objects

Especifica qualquer tag que não esteja incluída. Cada tag contém um máximo de 10 chaves, e cada chave contém um máximo de 10 valores. O corpo da estrutura não pode estar ausente e a chave não pode ser deixada em branco ou definida como uma cadeia vazia. As chaves devem ser únicas e os valores de uma chave devem ser exclusivos. Os recursos não identificados por chaves diferentes estão no relacionamento OR e os valores em uma tag estão no relacionamento OR. Se nenhuma condição de filtragem for especificada, os dados completos serão retornados.

sys_tags

Não

Array of Tags objects

Somente usuários com a permissão op_service podem usar esse campo para filtrar recursos. Apenas uma estrutura de tags está contida quando essa API é chamada pelo Tag Management Service (TMS). O key é _sys_enterprise_project_id e value é a lista de IDs do projeto empresarial. Quando o TMS invoca essa API, uma chave pode ter apenas um valor. 0 indica o projeto corporativo padrão. O sys_tags e condições de filtragem de tags de locatário (without_any_tag, tags, tags_any, not_tags e not_tags_any) não podem ser usadas ao mesmo tempo.

Tabela 3 Correspondente

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

String

Especifica a chave de tag. O valor pode ser dc-directconnect, dc-vgw ou dc-vif.

value

Sim

String

Especifica o valor de tag. Cada valor pode conter um máximo de 255 caracteres Unicode.

Tabela 4 Tags

Parâmetro

Obrigatório

Tipo

Descrição

key

Sim

String

Especifica a chave de tag. Cada chave de tag pode conter no máximo 127 caracteres Unicode. A key deve ser especificada.

values

Sim

Array of strings

Especifica a lista de valores de tag. Cada valor pode conter um máximo de 255 caracteres Unicode.

Parâmetros de resposta

Código de status: 200

Tabela 5 Parâmetros de corpo de resposta

Parâmetro

Tipo

Descrição

resources

Array of Resource objects

Especifica a lista de recurso.

total_count

Integer

Especifica o número total de registros.

request_id

String

Especifica o ID da solicitação.

Tabela 6 Recurso

Parâmetro

Tipo

Descrição

resource_detail

Object

Especifica os detalhes do recurso.

resource_id

String

Especifica o ID do recurso.

resource_name

String

Especifica o nome de recurso. Este parâmetro é uma cadeia vazia por padrão se não houver nome de recurso.

tags

Array of Tag objects

Especifica a lista de tags consultadas. Se nenhuma tag for correspondida, uma matriz vazia é retornada.

sys_tags

Array of Tag objects

Especifica a lista de tags consultadas. Se nenhuma tag for correspondida, uma matriz vazia é retornada.

Tabela 7 Tag

Parâmetro

Tipo

Descrição

key

String

Especifica a chave de tag. A chave pode conter no máximo 36 caracteres Unicode, incluindo letras, dígitos, hifens (-) e sublinhados (_).

Mínimo: 0

Máximo: 36

value

String

Especifica o valor de tag. O valor pode conter no máximo 43 caracteres Unicode, incluindo letras, dígitos, hifens (-) sublinhados (_) e pontos (.).

Mínimo: 0

Máximo: 43

Exemplos de solicitações

  • Corpo da solicitação quando a action é definida como filter
    https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/resource-instances/action
    
    {
      "offset" : "10",
      "limit" : "10",
      "action" : "filter",
      "matches" : [ {
        "key" : "resource_name",
        "value" : "resource1"
      } ],
      "not_tags" : [ {
        "key" : "key1",
        "values" : [ "*value1", "value2" ]
      } ],
      "tags" : [ {
        "key" : "key1",
        "values" : [ "*value1", "value2" ]
      } ],
      "tags_any" : [ {
        "key" : "key1",
        "values" : [ "value1", "value2" ]
      } ],
      "not_tags_any" : [ {
        "key" : "key1",
        "values" : [ "value1", "value2" ]
      } ]
    }
  • Corpo da solicitação quando a action está definida para count
    https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/resource_instances/action
    
    {
      "action" : "count",
      "not_tags" : [ {
        "key" : "key1",
        "values" : [ "value1", "*value2" ]
      } ],
      "tags" : [ {
        "key" : "key1",
        "values" : [ "value1", "value2" ]
      }, {
        "key" : "key2",
        "values" : [ "value1", "value2" ]
      } ],
      "tags_any" : [ {
        "key" : "key1",
        "values" : [ "value1", "value2" ]
      } ],
      "not_tags_any" : [ {
        "key" : "key1",
        "values" : [ "value1", "value2" ]
      } ],
      "sys_tags" : [ {
        "key" : "_sys_enterprise_project_id",
        "values" : [ "5aa119a8-d25b-45a7-8d1b-88e127885635" ]
      } ],
      "matches" : [ {
        "key" : "resource_name",
        "value" : "resource1"
      } ]
    }

Exemplo de respostas

Código de status: 200

Operação bem-sucedida.

{
  "resources" : [ ],
  "total_count" : 0,
  "request_id" : "9a4f4dfc4fb2fc101e65bba07d908535"
}

Códigos de status

Código de status

Descrição

200

Operação bem-sucedida.

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