@pulumi/digitalocean
Version:
A Pulumi package for creating and managing DigitalOcean cloud resources.
155 lines • 5.17 kB
JavaScript
;
// *** WARNING: this file was generated by pulumi-language-nodejs. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
desc = { enumerable: true, get: function() { return m[k]; } };
}
Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
o["default"] = v;
});
var __importStar = (this && this.__importStar) || function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
__setModuleDefault(result, mod);
return result;
};
Object.defineProperty(exports, "__esModule", { value: true });
exports.getImagesOutput = exports.getImages = void 0;
const pulumi = __importStar(require("@pulumi/pulumi"));
const utilities = __importStar(require("./utilities"));
/**
* Get information on images for use in other resources (e.g. creating a Droplet
* based on a snapshot), with the ability to filter and sort the results. If no filters are specified,
* all images will be returned.
*
* This data source is useful if the image in question is not managed by Terraform or you need to utilize any
* of the image's data.
*
* Note: You can use the `digitalocean.getImage` data source to obtain metadata
* about a single image if you already know the `slug`, unique `name`, or `id` to retrieve.
*
* ## Example Usage
*
* Use the `filter` block with a `key` string and `values` list to filter images.
*
* For example to find all Ubuntu images:
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as digitalocean from "@pulumi/digitalocean";
*
* const ubuntu = digitalocean.getImages({
* filters: [{
* key: "distribution",
* values: ["Ubuntu"],
* }],
* });
* ```
*
* You can filter on multiple fields and sort the results as well:
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as digitalocean from "@pulumi/digitalocean";
*
* const available = digitalocean.getImages({
* filters: [
* {
* key: "distribution",
* values: ["Ubuntu"],
* },
* {
* key: "regions",
* values: ["nyc3"],
* },
* ],
* sorts: [{
* key: "created",
* direction: "desc",
* }],
* });
* ```
*/
function getImages(args, opts) {
args = args || {};
opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
return pulumi.runtime.invoke("digitalocean:index/getImages:getImages", {
"filters": args.filters,
"sorts": args.sorts,
}, opts);
}
exports.getImages = getImages;
/**
* Get information on images for use in other resources (e.g. creating a Droplet
* based on a snapshot), with the ability to filter and sort the results. If no filters are specified,
* all images will be returned.
*
* This data source is useful if the image in question is not managed by Terraform or you need to utilize any
* of the image's data.
*
* Note: You can use the `digitalocean.getImage` data source to obtain metadata
* about a single image if you already know the `slug`, unique `name`, or `id` to retrieve.
*
* ## Example Usage
*
* Use the `filter` block with a `key` string and `values` list to filter images.
*
* For example to find all Ubuntu images:
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as digitalocean from "@pulumi/digitalocean";
*
* const ubuntu = digitalocean.getImages({
* filters: [{
* key: "distribution",
* values: ["Ubuntu"],
* }],
* });
* ```
*
* You can filter on multiple fields and sort the results as well:
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as digitalocean from "@pulumi/digitalocean";
*
* const available = digitalocean.getImages({
* filters: [
* {
* key: "distribution",
* values: ["Ubuntu"],
* },
* {
* key: "regions",
* values: ["nyc3"],
* },
* ],
* sorts: [{
* key: "created",
* direction: "desc",
* }],
* });
* ```
*/
function getImagesOutput(args, opts) {
args = args || {};
opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
return pulumi.runtime.invokeOutput("digitalocean:index/getImages:getImages", {
"filters": args.filters,
"sorts": args.sorts,
}, opts);
}
exports.getImagesOutput = getImagesOutput;
//# sourceMappingURL=getImages.js.map