Updates the group with the value

POST /v1/dns/name-groups/{group_name}/update

Updates the name group with the target value.

Path Parameters

group_name

The group name.

Example: group-name_1

Body

application/json

Body Sample

{
  "A": "192.0.2.1",
  "AAAA": "2001:db8::1"
}

Body Description

A string

AAAA string

Response

200 400 401 402 403 404 409

---

OK

success

{
  "data": {
    "targets": [
      {
        "changed": true,
        "name": "h1",
        "zone_name": "example.com"
      },
      {
        "changed": false,
        "name": "h2",
        "zone_name": "example.com"
      }
    ]
  },
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Bad Request

Multiple error variants are possible:

• appending to this RRset violates DNS rules (code: 4391)
• group update must have at least one field set (code: 2108)
• invalid DNS group name (code: 3315)
• invalid IPv4 address for A (code: 2106)
• invalid IPv6 address for AAAA (code: 2107)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Unauthorized

unauthorized (code: 2465)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Payment Required

Multiple error variants are possible:

• RRset metadata over limit; please contact support (code: 4556)
• Rdata count is over limit; please contact support (code: 4428)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Forbidden

Multiple error variants are possible:

• Rdata not allowed (code: 3627)
• changing this DNS name is prohibited; please contact support (code: 4821)
• changing this RRset is forbidden (code: 2710)
• changing this Rdata is forbidden (code: 2730)
• changing this zone is prohibited; please contact support (code: 3903)
• creating Rdata in this zone is forbidden (code: 4635)
• creating this RRset is forbidden (code: 4403)
• only auto-generated Rdata labels may start with an underscore (code: 4555)
• target not allowed (code: 2498)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Not Found

DNS name group not found (code: 2453)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}

---

Conflict

Rdata value already exists (code: 2722)

{
  "errors": [
    {
      "code": "string",
      "detail": "string",
      "id": "string",
      "location": "string",
      "pointer": "string",
      "title": "string"
    }
  ],
  "warnings": [
    {
      "code": "string",
      "detail": "string",
      "title": "string"
    }
  ]
}