Consulta de servidores de nomes
Função
Consulta de servidores de nomes
Depuração
Você pode depurar esta API por meio da autenticação automática no Chamada das API ou usar o código de exemplo do SDK gerado pelo API Explorer.
URI
GET /v2/nameservers
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| type | Não | String | Tipo do servidor de nomes. Opções de valor:
A correspondência exata funcionará. É deixado em branco por padrão. |
| region | Não | String | ID da região. Ao consultar um servidor de nomes público, deixe este parâmetro em branco. A correspondência exata funcionará. É deixado em branco por padrão. |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| X-Auth-Token | Sim | String | Token do usuário. Ele pode ser obtido pela chamada de uma API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| nameservers | Array of NameServersResp objects | Lista de servidores de nomes |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| type | String | Tipo do servidor de nomes. Opções de valor: - public indica um servidor de nomes público.- private indica um servidor de nomes privado. |
| region | String | ID da região. Ao consultar um servidor de nomes público, deixe este parâmetro em branco. |
| ns_records | Array of ns_records objects | Lista de servidores de nomes |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| hostname | String | Nome do host. Este parâmetro é deixado em branco quando um servidor de nomes privado é usado. |
| address | String | Endereço do servidor de nomes. Quando o servidor é um servidor de nomes público, esse parâmetro é deixado em branco. |
| priority | Integer | Prioridade. Se o valor de priority for 1, o servidor do DNS é o primeiro a resolver nomes de domínio. |
Exemplo de solicitações
Nenhum
Exemplo de respostas
Código de status: 200
Resposta à solicitação de consulta da lista de servidores de nomes
{
"nameservers" : [ {
"region" : null,
"type" : "public",
"ns_records" : [ {
"hostname" : "ns1.huawei.com.",
"priority" : 1
}, {
"hostname" : "ns2.huawei.com.",
"priority" : 2
} ]
}, {
"region" : "xxx",
"type" : "private",
"ns_records" : [ {
"priority" : 1,
"address" : "100.125.1.0"
}, {
"priority" : 2,
"address" : "100.125.1.1"
} ]
} ]
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | Resposta à solicitação de consulta da lista de servidores de nomes |
Códigos de erro
Consulte Códigos de erro.
