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/ GaussDB(for MySQL)/ Referência de API/ APIs (recomendadas)/ Gerenciamento de modelo de parâmetro/ Consulta de instâncias às quais um modelo de parâmetro pode ser aplicado

Atualizado em 2024-09-29 GMT+08:00

Ver PDF

Consulta de instâncias às quais um modelo de parâmetro pode ser aplicado

Função

Essa API é usada para consultar instâncias de banco de dados às quais um modelo de parâmetro pode ser aplicado. Antes de chamar essa API:

Saiba como autorizá-la e autenticá-la.
Obtenha a região e o ponto de extremidade necessários.

URI

GET /v3/{project_id}/configurations/{configuration_id}/applicable-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.
configuration_id	Sim	String	ID do modelo de parâmetro. Para obter esse valor, consulte Consulta de modelos de parâmetros. Depois que a solicitação é processada, o valor de id no corpo da resposta é o valor de configuration_id.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descriçã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.

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 ApplicableInstances objects	Lista de instâncias às quais o modelo de parâmetro pode ser aplicado.
total_count	Integer	Número de instâncias às quais o modelo de parâmetro pode ser aplicado.

**Tabela 5** ApplicableInstances
Parâmetro	Tipo	Descrição
instance_id	String	ID da instância.
instance_name	String	Nome da instância.

Código de status: 400

**Tabela 6** 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 7** 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 às quais um modelo de parâmetro de modelo pode ser aplicado

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/configurations/0c82974e2354466098d7b4b72e55129dpr07/applicable-instances

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "total_count" : 10,
  "instances" : [ {
    "instance_id" : "75e1935142974ca685357dc784626f22in07",
    "instance_name" : "gauss-ff14-hll"
  }, {
    "instance_id" : "cf72c31a689c40b7883c355a0bb5cc1din07",
    "instance_name" : "tst-bbbnew"
  }, {
    "instance_id" : "4a99fbae95df43648281cdd9e269c1c7in07",
    "instance_name" : "gauss-62d8"
  }, {
    "instance_id" : "fb6244dc9b1443b7ad0aae81283d5d28in07",
    "instance_name" : "gauss-test-1"
  }, {
    "instance_id" : "2260da7e105e485ebc9c060c1663d89ain07",
    "instance_name" : "gauss-f4c6-cx"
  }, {
    "instance_id" : "1cf7357f931448f89229de664c114d05in07",
    "instance_name" : "gauss-wry-0710-3"
  }, {
    "instance_id" : "5280b1a667d142378fe28816afb2e4b8in07",
    "instance_name" : "taurus_WAkJSzVy"
  }, {
    "instance_id" : "56c6924923804259a1b15b846c6b4bf1in07",
    "instance_name" : "tck-update3"
  }, {
    "instance_id" : "72a8f4287e04427985087795825fcddain07",
    "instance_name" : "critBack"
  }, {
    "instance_id" : "c5df1dec75ed48ab85fe52c72ba784bbin07",
    "instance_name" : "gauss-f873-cx"
  } ]
}