Viewing docs for DigitalOcean v4.77.0
published on Friday, Jul 31, 2026 by Pulumi
published on Friday, Jul 31, 2026 by Pulumi
Viewing docs for DigitalOcean v4.77.0
published on Friday, Jul 31, 2026 by Pulumi
published on Friday, Jul 31, 2026 by Pulumi
Fetches a list of DigitalOcean MicroDroplet images on the account. No server-side filters — narrow the results using filter and sort.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as digitalocean from "@pulumi/digitalocean";
const all = digitalocean.getMicrodropletImages({});
const available = digitalocean.getMicrodropletImages({
filters: [{
key: "status",
values: ["IMAGE_AVAILABLE"],
}],
});
const newestFirst = digitalocean.getMicrodropletImages({
sorts: [{
key: "created_at",
direction: "desc",
}],
});
import pulumi
import pulumi_digitalocean as digitalocean
all = digitalocean.get_microdroplet_images()
available = digitalocean.get_microdroplet_images(filters=[{
"key": "status",
"values": ["IMAGE_AVAILABLE"],
}])
newest_first = digitalocean.get_microdroplet_images(sorts=[{
"key": "created_at",
"direction": "desc",
}])
package main
import (
"github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := digitalocean.GetMicrodropletImages(ctx, &digitalocean.GetMicrodropletImagesArgs{}, nil)
if err != nil {
return err
}
_, err = digitalocean.GetMicrodropletImages(ctx, &digitalocean.GetMicrodropletImagesArgs{
Filters: []digitalocean.GetMicrodropletImagesFilter{
{
Key: "status",
Values: []string{
"IMAGE_AVAILABLE",
},
},
},
}, nil)
if err != nil {
return err
}
_, err = digitalocean.GetMicrodropletImages(ctx, &digitalocean.GetMicrodropletImagesArgs{
Sorts: []digitalocean.GetMicrodropletImagesSort{
{
Key: "created_at",
Direction: pulumi.StringRef("desc"),
},
},
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using DigitalOcean = Pulumi.DigitalOcean;
return await Deployment.RunAsync(() =>
{
var all = DigitalOcean.GetMicrodropletImages.Invoke();
var available = DigitalOcean.GetMicrodropletImages.Invoke(new()
{
Filters = new[]
{
new DigitalOcean.Inputs.GetMicrodropletImagesFilterInputArgs
{
Key = "status",
Values = new[]
{
"IMAGE_AVAILABLE",
},
},
},
});
var newestFirst = DigitalOcean.GetMicrodropletImages.Invoke(new()
{
Sorts = new[]
{
new DigitalOcean.Inputs.GetMicrodropletImagesSortInputArgs
{
Key = "created_at",
Direction = "desc",
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.digitalocean.DigitaloceanFunctions;
import com.pulumi.digitalocean.inputs.GetMicrodropletImagesArgs;
import com.pulumi.digitalocean.inputs.GetMicrodropletImagesFilterArgs;
import com.pulumi.digitalocean.inputs.GetMicrodropletImagesSortArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var all = DigitaloceanFunctions.getMicrodropletImages(GetMicrodropletImagesArgs.builder()
.build());
final var available = DigitaloceanFunctions.getMicrodropletImages(GetMicrodropletImagesArgs.builder()
.filters(GetMicrodropletImagesFilterArgs.builder()
.key("status")
.values("IMAGE_AVAILABLE")
.build())
.build());
final var newestFirst = DigitaloceanFunctions.getMicrodropletImages(GetMicrodropletImagesArgs.builder()
.sorts(GetMicrodropletImagesSortArgs.builder()
.key("created_at")
.direction("desc")
.build())
.build());
}
}
variables:
all:
fn::invoke:
function: digitalocean:getMicrodropletImages
arguments: {}
available:
fn::invoke:
function: digitalocean:getMicrodropletImages
arguments:
filters:
- key: status
values:
- IMAGE_AVAILABLE
newestFirst:
fn::invoke:
function: digitalocean:getMicrodropletImages
arguments:
sorts:
- key: created_at
direction: desc
pulumi {
required_providers {
digitalocean = {
source = "pulumi/digitalocean"
}
}
}
data "digitalocean_getmicrodropletimages" "all" {
}
data "digitalocean_getmicrodropletimages" "available" {
filters {
key = "status"
values = ["IMAGE_AVAILABLE"]
}
}
data "digitalocean_getmicrodropletimages" "newestFirst" {
sorts {
key = "created_at"
direction = "desc"
}
}
Using getMicrodropletImages
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getMicrodropletImages(args: GetMicrodropletImagesArgs, opts?: InvokeOptions): Promise<GetMicrodropletImagesResult>
function getMicrodropletImagesOutput(args: GetMicrodropletImagesOutputArgs, opts?: InvokeOptions): Output<GetMicrodropletImagesResult>def get_microdroplet_images(filters: Optional[Sequence[GetMicrodropletImagesFilter]] = None,
sorts: Optional[Sequence[GetMicrodropletImagesSort]] = None,
opts: Optional[InvokeOptions] = None) -> GetMicrodropletImagesResult
def get_microdroplet_images_output(filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetMicrodropletImagesFilterArgs]]]] = None,
sorts: pulumi.Input[Optional[Sequence[pulumi.Input[GetMicrodropletImagesSortArgs]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetMicrodropletImagesResult]func GetMicrodropletImages(ctx *Context, args *GetMicrodropletImagesArgs, opts ...InvokeOption) (*GetMicrodropletImagesResult, error)
func GetMicrodropletImagesOutput(ctx *Context, args *GetMicrodropletImagesOutputArgs, opts ...InvokeOption) GetMicrodropletImagesResultOutput> Note: This function is named GetMicrodropletImages in the Go SDK.
public static class GetMicrodropletImages
{
public static Task<GetMicrodropletImagesResult> InvokeAsync(GetMicrodropletImagesArgs args, InvokeOptions? opts = null)
public static Output<GetMicrodropletImagesResult> Invoke(GetMicrodropletImagesInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetMicrodropletImagesResult> getMicrodropletImages(GetMicrodropletImagesArgs args, InvokeOptions options)
public static Output<GetMicrodropletImagesResult> getMicrodropletImages(GetMicrodropletImagesArgs args, InvokeOptions options)
fn::invoke:
function: digitalocean:index/getMicrodropletImages:getMicrodropletImages
arguments:
# arguments dictionarydata "digitalocean_get_microdroplet_images" "name" {
# arguments
}The following arguments are supported:
- Filters
List<Pulumi.
Digital Ocean. Inputs. Get Microdroplet Images Filter> - Repeatable client-side filter block:
- Sorts
List<Pulumi.
Digital Ocean. Inputs. Get Microdroplet Images Sort> - Repeatable client-side sort block:
- Filters
[]Get
Microdroplet Images Filter - Repeatable client-side filter block:
- Sorts
[]Get
Microdroplet Images Sort - Repeatable client-side sort block:
- filters list(object)
- Repeatable client-side filter block:
- sorts list(object)
- Repeatable client-side sort block:
- filters
List<Get
Microdroplet Images Filter> - Repeatable client-side filter block:
- sorts
List<Get
Microdroplet Images Sort> - Repeatable client-side sort block:
- filters
Get
Microdroplet Images Filter[] - Repeatable client-side filter block:
- sorts
Get
Microdroplet Images Sort[] - Repeatable client-side sort block:
- filters
Sequence[Get
Microdroplet Images Filter] - Repeatable client-side filter block:
- sorts
Sequence[Get
Microdroplet Images Sort] - Repeatable client-side sort block:
- filters List<Property Map>
- Repeatable client-side filter block:
- sorts List<Property Map>
- Repeatable client-side sort block:
getMicrodropletImages Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Micro
Droplet List<Pulumi.Images Digital Ocean. Outputs. Get Microdroplet Images Micro Droplet Image> - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - Filters
List<Pulumi.
Digital Ocean. Outputs. Get Microdroplet Images Filter> - Sorts
List<Pulumi.
Digital Ocean. Outputs. Get Microdroplet Images Sort>
- Id string
- The provider-assigned unique ID for this managed resource.
- Micro
Droplet []GetImages Microdroplet Images Micro Droplet Image - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - Filters
[]Get
Microdroplet Images Filter - Sorts
[]Get
Microdroplet Images Sort
- id string
- The provider-assigned unique ID for this managed resource.
- micro_
droplet_ list(object)images - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - filters list(object)
- sorts list(object)
- id String
- The provider-assigned unique ID for this managed resource.
- micro
Droplet List<GetImages Microdroplet Images Micro Droplet Image> - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - filters
List<Get
Microdroplet Images Filter> - sorts
List<Get
Microdroplet Images Sort>
- id string
- The provider-assigned unique ID for this managed resource.
- micro
Droplet GetImages Microdroplet Images Micro Droplet Image[] - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - filters
Get
Microdroplet Images Filter[] - sorts
Get
Microdroplet Images Sort[]
- id str
- The provider-assigned unique ID for this managed resource.
- micro_
droplet_ Sequence[Getimages Microdroplet Images Micro Droplet Image] - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - filters
Sequence[Get
Microdroplet Images Filter] - sorts
Sequence[Get
Microdroplet Images Sort]
- id String
- The provider-assigned unique ID for this managed resource.
- micro
Droplet List<Property Map>Images - A list of MicroDroplet image records. Each record has the same attribute set as the
digitalocean.MicrodropletImagedata source. - filters List<Property Map>
- sorts List<Property Map>
Supporting Types
GetMicrodropletImagesFilter
GetMicrodropletImagesMicroDropletImage
- created_
at string - The creation timestamp for the MicroDroplet image
- name string
- Name of the MicroDroplet image
- source string
- Source OCI reference for the MicroDroplet image
- status string
- Lifecycle status of the MicroDroplet image
- urn string
- The uniform resource name (URN) for the MicroDroplet image
- created_
at str - The creation timestamp for the MicroDroplet image
- name str
- Name of the MicroDroplet image
- source str
- Source OCI reference for the MicroDroplet image
- status str
- Lifecycle status of the MicroDroplet image
- urn str
- The uniform resource name (URN) for the MicroDroplet image
GetMicrodropletImagesSort
Package Details
- Repository
- DigitalOcean pulumi/pulumi-digitalocean
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
digitaloceanTerraform Provider.
Viewing docs for DigitalOcean v4.77.0
published on Friday, Jul 31, 2026 by Pulumi
published on Friday, Jul 31, 2026 by Pulumi