IONOS Cloud VPN Gateway icon

IONOS Cloud VPN Gateway

Manage IONOS Cloud VPN Gateways (WireGuard and IPSec). Developped with Love by Ascenzia (ascenzia.fr)

Actions20

WireGuard Peer → Update

AI-generated

Summary

Updates a WireGuard Peer on an IONOS Cloud VPN Gateway

Inputs

  • wireguardGatewayId (required) — The ID (UUID) of the WireGuard Gateway containing the peer.
  • peerId (required) — The ID (UUID) of the WireGuard Peer to update.
  • name (required) — Human-readable name of the peer.
  • publicKey (required) — WireGuard public key of the connecting peer.
  • allowedIPs (required) — Comma-separated list of subnet CIDRs allowed to connect. Split into an array of trimmed CIDRs at runtime.
  • location — IONOS Cloud location. Defaults to 'de-fra' if omitted. Used to construct the API base URL.
  • description — Human-readable description of the peer.
  • endpointHost — Hostname or IPv4 address of the WireGuard Server endpoint.
  • endpointPort — Port that the WireGuard Server will connect to. Defaults to 51820.

Output shape

The updated WireGuard Peer resource object returned by the IONOS Cloud API.

If endpointHost is provided, the request body includes an endpoint object with host and port. The allowedIPs string is parsed into an array of non-empty trimmed CIDR substrings.

Examples

Example 1: Update peer name and allowed IPs

wireguardGatewayId: 'gw-1234', peerId: 'peer-5678', name: 'new-peer-name', allowedIPs: '10.0.0.0/24', location: 'de-fra'

Links

Discussion