getImages

Get information about Google Compute Images. Check that your service account has the compute.imageUser role if you want to share custom images from another project. If you want to use pubimg, do not forget to specify the dedicated project. For more information see the official documentation and its API.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const debian = gcp.compute.getImages({
filter: "name eq my-image.*",
});
const _default = new gcp.compute.Instance("default", {
name: "test",
machineType: "f1-micro",
zone: "us-central1-a",
bootDisk: {
initializeParams: {
image: debian.then(debian => debian.images?.[0]?.selfLink),
},
},
networkInterfaces: [{
network: defaultGoogleComputeNetwork.name,
}],
});
import pulumi
import pulumi_gcp as gcp
debian = gcp.compute.get_images(filter="name eq my-image.*")
default = gcp.compute.Instance("default",
name="test",
machine_type="f1-micro",
zone="us-central1-a",
boot_disk={
"initialize_params": {
"image": debian.images[0].self_link,
},
},
network_interfaces=[{
"network": default_google_compute_network["name"],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var debian = Gcp.Compute.GetImages.Invoke(new()
{
Filter = "name eq my-image.*",
});
var @default = new Gcp.Compute.Instance("default", new()
{
Name = "test",
MachineType = "f1-micro",
Zone = "us-central1-a",
BootDisk = new Gcp.Compute.Inputs.InstanceBootDiskArgs
{
InitializeParams = new Gcp.Compute.Inputs.InstanceBootDiskInitializeParamsArgs
{
Image = debian.Apply(getImagesResult => getImagesResult.Images[0]?.SelfLink),
},
},
NetworkInterfaces = new[]
{
new Gcp.Compute.Inputs.InstanceNetworkInterfaceArgs
{
Network = defaultGoogleComputeNetwork.Name,
},
},
});
});
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v8/go/gcp/compute"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
debian, err := compute.GetImages(ctx, &compute.GetImagesArgs{
Filter: pulumi.StringRef("name eq my-image.*"),
}, nil)
if err != nil {
return err
}
_, err = compute.NewInstance(ctx, "default", &compute.InstanceArgs{
Name: pulumi.String("test"),
MachineType: pulumi.String("f1-micro"),
Zone: pulumi.String("us-central1-a"),
BootDisk: &compute.InstanceBootDiskArgs{
InitializeParams: &compute.InstanceBootDiskInitializeParamsArgs{
Image: pulumi.String(debian.Images[0].SelfLink),
},
},
NetworkInterfaces: compute.InstanceNetworkInterfaceArray{
&compute.InstanceNetworkInterfaceArgs{
Network: pulumi.Any(defaultGoogleComputeNetwork.Name),
},
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.compute.ComputeFunctions;
import com.pulumi.gcp.compute.inputs.GetImagesArgs;
import com.pulumi.gcp.compute.Instance;
import com.pulumi.gcp.compute.InstanceArgs;
import com.pulumi.gcp.compute.inputs.InstanceBootDiskArgs;
import com.pulumi.gcp.compute.inputs.InstanceBootDiskInitializeParamsArgs;
import com.pulumi.gcp.compute.inputs.InstanceNetworkInterfaceArgs;
import java.util.List;
import java.util.ArrayList;
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 debian = ComputeFunctions.getImages(GetImagesArgs.builder()
.filter("name eq my-image.*")
.build());
var default_ = new Instance("default", InstanceArgs.builder()
.name("test")
.machineType("f1-micro")
.zone("us-central1-a")
.bootDisk(InstanceBootDiskArgs.builder()
.initializeParams(InstanceBootDiskInitializeParamsArgs.builder()
.image(debian.images()[0].selfLink())
.build())
.build())
.networkInterfaces(InstanceNetworkInterfaceArgs.builder()
.network(defaultGoogleComputeNetwork.name())
.build())
.build());
}
}
resources:
default:
type: gcp:compute:Instance
properties:
name: test
machineType: f1-micro
zone: us-central1-a
bootDisk:
initializeParams:
image: ${debian.images[0].selfLink}
networkInterfaces:
- network: ${defaultGoogleComputeNetwork.name}
variables:
debian:
fn::invoke:
function: gcp:compute:getImages
arguments:
filter: name eq my-image.*

Return

A collection of values returned by getImages.

Parameters

argument

A collection of arguments for invoking getImages.


suspend fun getImages(filter: String? = null, project: String? = null): GetImagesResult

Return

A collection of values returned by getImages.

Parameters

filter

Filter for the images to be returned by the data source. Syntax can be found here in the filter section.

project

The project in which the resource belongs. If it is not provided, the provider project is used. If you are using a pubimg, be sure to specify the correct Image Project.

See also


suspend fun getImages(argument: suspend GetImagesPlainArgsBuilder.() -> Unit): GetImagesResult

Return

A collection of values returned by getImages.

Parameters

argument

Builder for com.pulumi.gcp.compute.kotlin.inputs.GetImagesPlainArgs.

See also