Give Feedback

godo.ReservedIPV6Actions.Assign()

Generated on 5 Nov 2026 from godo version v1.236.0

Copy page as Markdown View page as Markdown

Usage

client.ReservedIPV6Actions.Assign(ctx context.Context, ip string, dropletID int) (*godo.Action, *godo.Response, error)

Description

Assign a reserved IP to a droplet.

This method sends a POST request to /v2/reserved_ipv6/{}/actions.

Parameters

ip string required
dropletID int required

Returns

*godo.Action
*godo.Response: The HTTP response, with pagination Links, Meta, and Rate limit information.
error: Non-nil when the request fails. API errors are returned as *godo.ErrorResponse.

Fields of `godo.Action`

Action represents a DigitalOcean Action

ID int: JSON key: id
Status string: JSON key: status
Type string: JSON key: type
StartedAt *godo.Timestamp: JSON key: started_at
CompletedAt *godo.Timestamp: JSON key: completed_at
ResourceID int: JSON key: resource_id
ResourceType string: JSON key: resource_type
Region *godo.Region: Omitted from JSON when empty. JSON key: region
RegionSlug string: Omitted from JSON when empty. JSON key: region_slug

Request Sample

Show Request Sample

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"github.com/digitalocean/godo"
)

func main() {
	client := godo.NewFromToken(os.Getenv("DIGITALOCEAN_TOKEN"))
	ctx := context.TODO()

	result, _, err := client.ReservedIPV6Actions.Assign(ctx, "<your-ip>", 1234567)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", result)
}

Response Example

Show Response Example

{
  "action": {
    "id": 72531856,
    "status": "completed",
    "type": "assign_ip",
    "started_at": "2015-11-12T17:51:03Z",
    "completed_at": "2015-11-12T17:51:14Z",
    "resource_id": 758604968,
    "resource_type": "reserved_ipv6",
    "region": {
      "name": "New York 3",
      "slug": "nyc3",
      "sizes": [
        "s-1vcpu-1gb",
        "s-1vcpu-2gb",
        "s-1vcpu-3gb",
        "s-2vcpu-2gb",
        "s-3vcpu-1gb",
        "s-2vcpu-4gb",
        "s-4vcpu-8gb",
        "s-6vcpu-16gb",
        "s-8vcpu-32gb",
        "s-12vcpu-48gb",
        "s-16vcpu-64gb",
        "s-20vcpu-96gb",
        "s-24vcpu-128gb",
        "s-32vcpu-192gb"
      ],
      "features": [
        "private_networking",
        "backups",
        "ipv6",
        "metadata"
      ],
      "available": true
    },
    "region_slug": "nyc3"
  }
}