DigitalOcean.Image (digital_ocean v0.1.0)

Link to this section Summary

Functions

Create a custom image.

Delete an image.

Retrieve an image by id or slug.

Retrieve a list of images.

Update an image.

Link to this section Functions

Specs

Create a custom image.

Examples

iex> DigitalOcean.Image.create(
...>   name: "ubuntu-18.04-minimal",
...>   url: "http://cloud-images.ubuntu.com/minimal/releases/bionic/release/ubuntu-18.04-minimal-cloudimg-amd64.img",
...>   distribution: "ubuntu",
...>   region: "nyc3",
...>   description: "Cloud-optimized image w/ small footprint",
...>   tags: ["base-image", "prod"]
...> ) |> DigitalOcean.request()
{ :ok, %DigitalOcean.Response{} }
Link to this function

delete(image_id)

Specs

Delete an image.

Examples

iex> DigitalOcean.Image.delete(7938391) |> DigitalOcean.request()
{ :ok, %DigitalOcean.Response{} }
Link to this function

get(id_or_slug)

Specs

Retrieve an image by id or slug.

Example retrieving an image by id

iex> DigitalOcean.Image.get(7555620) |> DigitalOcean.request()
{ :ok, %DigitalOcean.Response{} }

Example retrieving an image by slug

iex> DigitalOcean.Image.get("ubuntu-16-04-x64") |> DigitalOcean.request()
{ :ok, %DigitalOcean.Response{} }
Link to this function

list(opts \\ [])

Specs

Retrieve a list of images.

Example retrieving all images

iex> DigitalOcean.Image.list() |> DigitalOcean.request()
{ :ok, %DigitalOcean.Response{} }

Example retrieving distribution images

iex> DigitalOcean.Image.list(type: "distribution") |> DigitalOcean.request()
{ :ok, %DigitalOcean.Response{} }

See the official DigitalOcean v2 API documentation for all options listing images.

Link to this function

update(image_id, opts)

Specs

Update an image.

Examples

iex> DigitalOcean.Image.update("7938391", name: "new-image-name") |> DigitalOcean.request()
{ :ok, DigitalOcean.Response{} }