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 API Explorer 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.