Criação de uma linha personalizada
Função
Esta API é usada para criar uma linha personalizada.
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
POST /v2.1/customlines
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âmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| name | Sim | String | Nome da linha de resolução. O valor consiste 1 a 80 caracteres, incluindo letras, dígitos, hifens (-) sublinhados (_), e pontos (.). O nome de cada linha de resolução definida por uma conta deve ser exclusivo. |
| ip_segments | Sim | Array of strings | Intervalo de endereços IP. O endereço IP inicial é separado do endereço IP final de um hífen (-). Os intervalos de endereços IP não podem se sobrepor. Se os endereços IP de início e fim forem os mesmos, há apenas um endereço IP no intervalo. Defina o valor para IP1-IP1. Atualmente, apenas endereços IPv4 são suportados. Você pode especificar um máximo de 50 intervalos de endereços IP. |
| description | Não | String | Descrição de linha personalizada. São permitidos no máximo 255 caracteres. É deixado em branco por padrão. |
Parâmetros de resposta
Código de status: 200
| Parâmetro | Tipo | Descrição |
|---|---|---|
| line_id | String | ID da linha de resolução |
| name | String | Nome de linha personalizada |
| ip_segments | Array of strings | Intervalo de endereços IP |
| created_at | String | Tempo de criação |
| updated_at | String | Hora da atualização |
| status | String | Status do recurso |
| description | String | Descrição da linha personalizada |
Exemplo de solicitações
{
"name" : "customline",
"ip_segments" : [ "1.1.1.1-1.1.1.1", "1.1.1.2-1.1.1.3" ],
"description" : "123"
} Exemplo de respostas
Código de status: 200
Solicitação de criação de uma linha personalizada
{
"line_id" : "custom_2ce45ef669fc87870169fcbada7a0007",
"name" : "customline",
"ip_segments" : [ "1.1.1.1-1.1.1.1", "1.1.1.2-1.1.1.3" ],
"status" : "PENDING_CREATE",
"created_at" : "2019-04-10T12:03:17.827",
"updated_at" : null,
"description" : "123"
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | Solicitação de criação de uma linha personalizada |
Códigos de erro
Consulte Códigos de erro.
