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.
Atualizado em 2024-09-29 GMT+08:00

Consulta de instâncias de BD

Função

Essa API é usada para consultar instâncias de BD de acordo com critérios de pesquisa. Antes de chamar essa API:

Essa API estará indisponível em 31 de dezembro de 2024.

URI

GET /v3/{project_id}/instances

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário numa região.

Para obter esse valor, consulte Obtenção de um ID de projeto.

Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

id

Não

String

ID da instância. O asterisco (*) é reservado para o sistema. Se o ID da instância começar com *, isso indica que a correspondência difusa é executada com base no valor seguinte a *. Caso contrário, a correspondência exata é executada com base no ID da instância. O valor não pode conter apenas asteriscos (*).

name

Não

String

Nome da instância. O asterisco (*) é reservado para o sistema. Se o nome da instância começar com *, isso indica que a correspondência difusa é executada com base no valor seguinte a *. Caso contrário, a correspondência exata é executada com base no nome da instância. O valor não pode conter apenas asteriscos (*).

type

Não

String

Tipo de instância a ser consultada. Atualmente, apenas o tipo de cluster é suportado.

datastore_type

Não

String

Tipo do BD. Atualmente, apenas o gaussdb-mysql é suportado.

vpc_id

Não

String

ID de VPC

subnet_id

Não

String

ID de rede da sub-rede.

private_ip

Não

String

Endereço IP privado.

readonly_private_ip

Não

String

Endereço IP privado para leitura.

proxy_ip

Não

String

Endereço de divisão de leitura/gravação.

offset

Não

Integer

Deslocamento do índice. Se offset for definido como N, a consulta de recursos será iniciada a partir da parte N+1 dos dados. O valor é 0 por padrão, indicando que a consulta começa a partir da primeira parte dos dados. O valor não pode ser um número negativo.

limit

Não

Integer

Número de registros a serem consultados. O valor padrão é 100. O valor deve ser um número inteiro positivo. O valor mínimo é 1 e o valor máximo é 100.

tags

Não

String

Consulta com base na chave e no valor da tag da instância.

  • {key} indica a chave da tag.
  • {value} indica o valor da tag.

Para consultar instâncias com várias chaves e valores de tag, separe os pares chave-valor com vírgulas (,). A chave deve ser exclusiva. Várias chaves estão na relação AND.

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida.

Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token.

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us.

Valor:

  • en-us
  • zh-cn

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

instances

Array of MysqlInstanceListInfo objects

Informações da lista de instâncias.

total_count

Integer

Número total de registros.

Tabela 5 MysqlInstanceListInfo

Parâmetro

Tipo

Descrição

id

String

ID da instância.

name

String

Nome da instância.

status

String

Status da instância.

private_ips

Array of strings

Endereço IP privado para gravação. Ele é deixado em branco até que um ECS seja criado.

readonly_private_ips

Array of strings

Endereços IP privados para leitura. Ele é deixado em branco até que um ECS seja criado.

proxy_ips

Array of strings

Endereços IP de divisão de leitura/gravação. Ele é deixado em branco até que instâncias de proxy sejam criadas para uma instância.

public_ips

Array of strings

Endereços IP públicos.

port

String

Porta do banco de dados.

type

String

Tipo de instância de BD. O valor é Cluster.

region

String

Região onde a instância de BD é implementada.

datastore

MysqlDatastore object

Informações do banco de dados.

created

String

Tempo de criação no formato "aaaa-mm-ddThh:mm:ssZ". T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, no fuso horário de Pequim, o deslocamento do fuso horário é mostrado como +0800.

NOTA:

O valor fica vazio quando a instância de BD está sendo criada. Depois que a instância de BD é criada, o valor não está vazio.

updated

String

Hora da atualização. O formato é o mesmo do campo created.

NOTA:

O valor fica vazio quando a instância de BD está sendo criada. Depois que a instância de BD é criada, o valor não está vazio.

db_user_name

String

Nome de usuário padrão.

vpc_id

String

ID de VPC

subnet_id

String

ID de rede da sub-rede.

security_group_id

String

ID do grupo de segurança.

flavor_ref

String

Código de especificação.

flavor_info

MysqlFlavorInfo object

Informações sobre flavors.

volume

MysqlVolumeInfo object

Informações do disco de armazenamento.

backup_strategy

MysqlBackupStrategy object

Política de backup automatizado.

enterprise_project_id

String

ID do projeto empresarial.

time_zone

String

Fuso horário.

charge_info

MysqlChargeInfo object

Modo de cobrança, que é anual/mensal ou pagamento por uso (configuração padrão).

dedicated_resource_id

String

ID do pool de recursos dedicado. Esse parâmetro é retornado somente quando a instância pertence a um pool de recursos dedicado.

tags

Array of InstanceTagItem objects

Lista de tags.

Tabela 6 MysqlDatastoreWithKernelVersion

Parâmetro

Tipo

Descrição

type

String

Mecanismo de BD. Atualmente, apenas gaussdb-mysql é suportado.

version

String

Versão de BD.

Para obter detalhes sobre as versões suportadas do mecanismo de BD, chame a API para consultar as versões do mecanismo de BD.

kernel_version

String

Versão do kernel do banco de dados.

Tabela 7 MysqlFlavorInfo

Parâmetro

Tipo

Descrição

vcpus

String

Número de vCPUs.

ram

String

Tamanho da memória em GB.

Tabela 8 MysqlVolumeInfo

Parâmetro

Tipo

Descrição

type

String

Tipo de disco.

size

String

Tamanho do disco usado em GB.

Tabela 9 MysqlBackupStrategy

Parâmetro

Tipo

Descrição

start_time

String

Hora de início do backup automatizado. O backup automatizado será acionado dentro de uma hora após o horário especificado por este parâmetro.

O valor não pode ser vazio. Deve ser um valor válido no formato "hh:mm-HH:MM". A hora atual está no formato UTC.

  1. O valor de HH deve ser 1 maior que o valor de hh.
  2. Os valores de mm e MM devem ser os mesmos e devem ser definidos como 00.

keep_days

String

Dias de retenção de backup automatizado. Valor: 1-732.

Tabela 10 MysqlChargeInfo

Parâmetro

Tipo

Descrição

charge_mode

String

Modo de cobrança.

Valor válido:

  • prePaid: indica o modo de cobrança anual/mensal.
  • postPaid: indica o modo de cobrança de pagamento por uso.

period_type

String

Período de assinatura. Este parâmetro está disponível e é obrigatório apenas quando charge_mode é definido como prePaid.

Valor válido:

  • month: o serviço é assinado por mês.
  • year: o serviço é assinado por ano.

period_num

Integer

Esse parâmetro é válido e obrigatório somente quando charge_mode é definido como prePaid.

Valor válido:

  • Quando period_type é definido como month, o valor do parâmetro varia de 1 a 9.
  • Quando period_type é definido como year, o valor do parâmetro varia de 1 a 3.

is_auto_renew

String

Se a renovação automática está ativada para instâncias de BD anuais/mensais. O período de renovação é o mesmo que o período original e o pedido será pago automaticamente durante a renovação da assinatura.

  • true: indica que a renovação automática está ativada.
  • false: indica que a renovação automática está desativada. O valor padrão é false.

is_auto_pay

String

Se o pedido será pago automaticamente após a criação de instâncias anuais/mensais. Este parâmetro não afeta o método de pagamento de renovação automática.

  • true: indica que o pedido será pago automaticamente de sua conta. O valor padrão é true.
  • false: indica que o pedido será pago manualmente.
Tabela 11 InstanceTagItem

Parâmetro

Tipo

Descrição

key

String

Chave da tag.

value

String

Valor da tag.

Código de status: 400

Tabela 12 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 13 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Consulta de instâncias do GaussDB(for MySQL) cujos endereços IP privados são 192.168.0.142

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances?id=61a4ea66210545909d74a05c27a7179ein07&name=hyAbc&type=Cluster&datastore_type=gaussdb-mysql&vpc_id=19e5d45d-70fd-4a91-87e9-b27e71c9891f&subnet_id=bd51fb45-2dcb-4296-8783-8623bfe89bb7&private_ip=192.168.0.142&offset=0&limit=10&tags=taurusKey1=value1

Exemplo de resposta

Código de status: 200

O valor de region é usado como um exemplo na resposta a seguir.

Bem-sucedido.

{
  "total_count" : 1,
  "instances" : [ {
    "id" : "d738399de028480fabb2b8120d4e01a4in07",
    "name" : "gaussdb-mysql-instance01",
    "status" : "ACTIVE",
    "port" : 3306,
    "type" : "Cluster",
    "private_ips" : [ "192.168.0.142" ],
    "db_user_name" : "root",
    "region" : "aaa",
    "datastore" : {
      "type" : "gaussdb-mysql",
      "version" : "8.0",
      "kernel_version" : "2.0.29.1"
    },
    "created" : "2018-08-20T02:33:49_0800",
    "updated" : "2018-08-20T02:33:49_0800",
    "volume" : {
      "type" : "POOL",
      "size" : 100
    },
    "vpc_id" : "3cedfc54-b105-4652-a4e0-847b11576b58",
    "subnet_id" : "c1cfa53c-65d3-431e-8552-326bf310c7ad",
    "security_group_id" : "fc577a1a-f202-424a-977f-24faec3fdd55",
    "flavor_ref" : "gaussdb.mysql.xlarge.x86.4",
    "flavor_info" : {
      "vcpus" : 4,
      "ram" : 16
    },
    "backup_strategy" : {
      "start_time" : "19:00-20:00",
      "keep_days" : 7
    },
    "charge_info" : {
      "charge_mode" : "postPaid"
    },
    "enterprise_project_id" : 0,
    "time_zone" : "UTC",
    "tags" : [ ]
  } ]
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.