Exclusão de conjuntos de registros em lote em uma zona
Função
Esta API é usada para excluir conjuntos de registros em lote em uma zona. Se os conjuntos de registros a serem excluídos não existirem, os conjuntos de registros serão considerados excluídos por padrão. A resposta contém apenas conjuntos de registros que são realmente excluídos.
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
DELETE /v2.1/zones/{zone_id}/recordsets
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
zone_id |
Sim |
String |
ID da zona |
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 |
---|---|---|---|
recordset_ids |
Sim |
Array of strings |
Lista de IDs do conjunto de registros. Você pode especificar um máximo de 100 IDs. |
Parâmetros de resposta
Código de status: 200
Parâmetro |
Tipo |
Descrição |
---|---|---|
links |
pageLink object |
Link do recurso atual ou outros recursos relacionados. Quando uma resposta é dividida em páginas, um próximo link é fornecido para recuperar todos os resultados. |
recordsets |
Array of QueryRecordSetWithLineResp objects |
Lista de conjuntos de registros |
metadata |
metadata object |
Número de recursos que atendem à condição de consulta |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
ID do conjunto de registros |
name |
String |
Nome do conjunto de registros |
description |
String |
Descrição do conjunto de registros |
zone_id |
String |
ID da zona do conjunto de registros |
zone_name |
String |
Nome da zona do conjunto de registros |
type |
String |
Tipo de conjunto de registros |
ttl |
Integer |
Duração do armazenamento em cache do conjunto de registros (em segundos) em um servidor do DNS local. Quanto maior a duração, mais lenta a atualização terá efeito. |
records |
Array of strings |
Valor do conjunto de registos |
created_at |
String |
Tempo de criação |
updated_at |
String |
Hora da atualização |
status |
String |
Status do recurso |
default |
Boolean |
Se o conjunto de registros é criado por padrão. Um conjunto de registros padrão não pode ser excluído. |
project_id |
String |
ID do projeto do conjunto de registros |
links |
pageLink object |
Link do recurso atual ou outros recursos relacionados. Quando uma resposta é dividida em páginas, um próximo link é fornecido para recuperar todos os resultados. |
line |
String |
ID da linha de resolução |
weight |
Integer |
Peso do conjunto de registros |
health_check_id |
String |
ID da verificação de integridade |
alias_target |
alias_target object |
Alias de nome de domínio |
Parâmetro |
Tipo |
Descrição |
---|---|---|
self |
String |
Link para o recurso atual |
next |
String |
Link para a próxima página |
Exemplo de solicitações
{ "recordset_ids" : [ "2c9eb155587194ec01587224c9f9014a", "2c9eb155587194ec01587224c9f9014c" ] }
Exemplo de respostas
Código de status: 200
Resposta à solicitação de exclusão de conjuntos de registros em lote em uma zona
{ "links" : { "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets" }, "recordsets" : [ { "id" : "2c9eb155587194ec01587224c9f9014a", "name" : "example.com.", "type" : "A", "ttl" : 300, "records" : [ "1.1.1.1" ], "status" : "PENDING_DELETE", "links" : { "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014a" }, "zone_id" : "2c9eb155587194ec01587224c9f90149", "zone_name" : "example.com.", "created_at" : "2016-11-17T11:56:03.439", "updated_at" : "2016-11-17T11:56:06.439", "default" : false, "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c", "line" : "default_view", "weight" : null, "set_id" : null }, { "id" : "2c9eb155587194ec01587224c9f9014c", "name" : "1.example.com.", "type" : "A", "ttl" : 172800, "records" : [ "2.2.2.2" ], "status" : "PENDING_DELETE", "links" : { "self" : "https://Endpoint/v2.1/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587194ec01587224c9f9014c" }, "zone_id" : "2c9eb155587194ec01587224c9f90149", "zone_name" : "example.com.", "created_at" : "2016-11-17T11:56:03.439", "updated_at" : "2016-11-17T11:56:06.439", "default" : false, "project_id" : "e55c6f3dc4e34c9f86353b664ae0e70c", "line" : "default_view", "weight" : null, "set_id" : null } ], "metadata" : { "total_count" : 2 } }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
Resposta à solicitação de exclusão de conjuntos de registros em lote em uma zona |
Códigos de erro
Consulte Códigos de erro.