@pulumi/digitalocean 4.77.0-alpha.1785220775 → 4.77.0

package/microdroplet.d.ts

@@ -0,0 +1,285 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as inputs from "./types/input";
+import * as outputs from "./types/output";
+/**
+ * Provides a [DigitalOcean MicroDroplet](https://docs.digitalocean.com/products/microdroplets/) resource. MicroDroplets run OCI images and can auto-pause when idle to reduce cost.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as digitalocean from "@pulumi/digitalocean";
+ *
+ * const example = new digitalocean.Microdroplet("example", {
+ *     name: "example-microdroplet",
+ *     region: "nyc3",
+ *     size: "microdroplet-1",
+ *     image: "docker.io/library/nginx:latest",
+ *     httpPort: 8080,
+ *     httpProtocol: "http",
+ *     autoPause: {
+ *         enabled: true,
+ *         idleTimeout: "5m",
+ *     },
+ *     autoResume: true,
+ *     environment: {
+ *         LOG_LEVEL: "info",
+ *     },
+ *     tags: [
+ *         "web",
+ *         "prod",
+ *     ],
+ * });
+ * ```
+ *
+ * ### Pausing and resuming
+ *
+ * The `state` attribute is settable and defaults to `running`. Changing it to `paused` calls the MicroDroplet pause action endpoint; changing it back to `running` calls the resume action endpoint. Neither triggers recreation:
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as digitalocean from "@pulumi/digitalocean";
+ *
+ * const example = new digitalocean.Microdroplet("example", {state: "paused"});
+ * ```
+ *
+ * Setting `state = "running"` on a paused MicroDroplet resumes it. When `autoPause` is enabled, the platform may transition the MicroDroplet to `paused` on its own — Terraform suppresses the diff in that case so it does not fight the platform.
+ *
+ * ## Import
+ *
+ * A MicroDroplet can be imported using its `id`, e.g.
+ *
+ * ```sh
+ * $ pulumi import digitalocean:index/microdroplet:Microdroplet example 506f78a4-e098-11e5-ad9f-000f53306ae1
+ * ```
+ */
+export declare class Microdroplet extends pulumi.CustomResource {
+    /**
+     * Get an existing Microdroplet resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MicrodropletState, opts?: pulumi.CustomResourceOptions): Microdroplet;
+    /**
+     * Returns true if the given object is an instance of Microdroplet.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is Microdroplet;
+    /**
+     * Auto-pause configuration block. Forces recreation on change: the MicroDroplets API has no in-place update path for auto_pause.
+     */
+    readonly autoPause: pulumi.Output<outputs.MicrodropletAutoPause>;
+    /**
+     * Whether the MicroDroplet auto-resumes when it receives a request. Forces recreation on change: the MicroDroplets API has no in-place update path for auto_resume.
+     */
+    readonly autoResume: pulumi.Output<boolean>;
+    /**
+     * RFC3339 timestamp of when the MicroDroplet was created.
+     */
+    readonly createdAt: pulumi.Output<string>;
+    /**
+     * Observed lifecycle state of the MicroDroplet (may differ transiently from `state` while a transition is in progress).
+     */
+    readonly currentState: pulumi.Output<string>;
+    /**
+     * The uniform resource name (URN) for the MicroDroplet.
+     */
+    readonly digitaloceanUrn: pulumi.Output<string>;
+    /**
+     * Public endpoint URL for the MicroDroplet.
+     */
+    readonly endpoint: pulumi.Output<string>;
+    /**
+     * Map of environment variables passed to the MicroDroplet at boot. Forces recreation on change.
+     */
+    readonly environment: pulumi.Output<{
+        [key: string]: string;
+    } | undefined>;
+    /**
+     * HTTP port to expose. Forces recreation on change.
+     */
+    readonly httpPort: pulumi.Output<number | undefined>;
+    /**
+     * HTTP protocol: `http` or `http2`. Forces recreation on change.
+     */
+    readonly httpProtocol: pulumi.Output<string | undefined>;
+    /**
+     * MicroDroplet image reference (UUID or URN). Forces recreation on change.
+     */
+    readonly image: pulumi.Output<string>;
+    /**
+     * Name of the MicroDroplet. Forces recreation on change.
+     */
+    readonly name: pulumi.Output<string>;
+    /**
+     * Networking mode: `public` (default) or `vpc`. Forces recreation on change.
+     */
+    readonly networking: pulumi.Output<string>;
+    /**
+     * DigitalOcean region slug for the MicroDroplet's location. Forces recreation on change.
+     */
+    readonly region: pulumi.Output<string>;
+    /**
+     * MicroDroplet size slug. Forces recreation on change.
+     */
+    readonly size: pulumi.Output<string>;
+    /**
+     * Desired lifecycle state. One of `running` (default) or `paused`. Changes are applied by invoking the pause / resume action endpoints and do not recreate the resource. This is the only attribute the provider can mutate in place.
+     */
+    readonly state: pulumi.Output<string | undefined>;
+    /**
+     * Set of tags applied to the MicroDroplet at create time. Forces recreation on change: MicroDroplets are not exposed via the shared `/v2/tags` API, so tags cannot be added, removed, or verified after creation. They also do not populate on `pulumi import` or on `digitalocean.Microdroplet` / `digitalocean.getMicrodroplets` data sources.
+     */
+    readonly tags: pulumi.Output<string[] | undefined>;
+    /**
+     * UUID of a VPC to attach to. Only valid when `networking = "vpc"`. Forces recreation on change.
+     */
+    readonly vpcUuid: pulumi.Output<string>;
+    /**
+     * Create a Microdroplet resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: MicrodropletArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering Microdroplet resources.
+ */
+export interface MicrodropletState {
+    /**
+     * Auto-pause configuration block. Forces recreation on change: the MicroDroplets API has no in-place update path for auto_pause.
+     */
+    autoPause?: pulumi.Input<inputs.MicrodropletAutoPause | undefined>;
+    /**
+     * Whether the MicroDroplet auto-resumes when it receives a request. Forces recreation on change: the MicroDroplets API has no in-place update path for auto_resume.
+     */
+    autoResume?: pulumi.Input<boolean | undefined>;
+    /**
+     * RFC3339 timestamp of when the MicroDroplet was created.
+     */
+    createdAt?: pulumi.Input<string | undefined>;
+    /**
+     * Observed lifecycle state of the MicroDroplet (may differ transiently from `state` while a transition is in progress).
+     */
+    currentState?: pulumi.Input<string | undefined>;
+    /**
+     * The uniform resource name (URN) for the MicroDroplet.
+     */
+    digitaloceanUrn?: pulumi.Input<string | undefined>;
+    /**
+     * Public endpoint URL for the MicroDroplet.
+     */
+    endpoint?: pulumi.Input<string | undefined>;
+    /**
+     * Map of environment variables passed to the MicroDroplet at boot. Forces recreation on change.
+     */
+    environment?: pulumi.Input<{
+        [key: string]: pulumi.Input<string>;
+    } | undefined>;
+    /**
+     * HTTP port to expose. Forces recreation on change.
+     */
+    httpPort?: pulumi.Input<number | undefined>;
+    /**
+     * HTTP protocol: `http` or `http2`. Forces recreation on change.
+     */
+    httpProtocol?: pulumi.Input<string | undefined>;
+    /**
+     * MicroDroplet image reference (UUID or URN). Forces recreation on change.
+     */
+    image?: pulumi.Input<string | undefined>;
+    /**
+     * Name of the MicroDroplet. Forces recreation on change.
+     */
+    name?: pulumi.Input<string | undefined>;
+    /**
+     * Networking mode: `public` (default) or `vpc`. Forces recreation on change.
+     */
+    networking?: pulumi.Input<string | undefined>;
+    /**
+     * DigitalOcean region slug for the MicroDroplet's location. Forces recreation on change.
+     */
+    region?: pulumi.Input<string | undefined>;
+    /**
+     * MicroDroplet size slug. Forces recreation on change.
+     */
+    size?: pulumi.Input<string | undefined>;
+    /**
+     * Desired lifecycle state. One of `running` (default) or `paused`. Changes are applied by invoking the pause / resume action endpoints and do not recreate the resource. This is the only attribute the provider can mutate in place.
+     */
+    state?: pulumi.Input<string | undefined>;
+    /**
+     * Set of tags applied to the MicroDroplet at create time. Forces recreation on change: MicroDroplets are not exposed via the shared `/v2/tags` API, so tags cannot be added, removed, or verified after creation. They also do not populate on `pulumi import` or on `digitalocean.Microdroplet` / `digitalocean.getMicrodroplets` data sources.
+     */
+    tags?: pulumi.Input<pulumi.Input<string>[] | undefined>;
+    /**
+     * UUID of a VPC to attach to. Only valid when `networking = "vpc"`. Forces recreation on change.
+     */
+    vpcUuid?: pulumi.Input<string | undefined>;
+}
+/**
+ * The set of arguments for constructing a Microdroplet resource.
+ */
+export interface MicrodropletArgs {
+    /**
+     * Auto-pause configuration block. Forces recreation on change: the MicroDroplets API has no in-place update path for auto_pause.
+     */
+    autoPause?: pulumi.Input<inputs.MicrodropletAutoPause | undefined>;
+    /**
+     * Whether the MicroDroplet auto-resumes when it receives a request. Forces recreation on change: the MicroDroplets API has no in-place update path for auto_resume.
+     */
+    autoResume?: pulumi.Input<boolean | undefined>;
+    /**
+     * Map of environment variables passed to the MicroDroplet at boot. Forces recreation on change.
+     */
+    environment?: pulumi.Input<{
+        [key: string]: pulumi.Input<string>;
+    } | undefined>;
+    /**
+     * HTTP port to expose. Forces recreation on change.
+     */
+    httpPort?: pulumi.Input<number | undefined>;
+    /**
+     * HTTP protocol: `http` or `http2`. Forces recreation on change.
+     */
+    httpProtocol?: pulumi.Input<string | undefined>;
+    /**
+     * MicroDroplet image reference (UUID or URN). Forces recreation on change.
+     */
+    image: pulumi.Input<string>;
+    /**
+     * Name of the MicroDroplet. Forces recreation on change.
+     */
+    name?: pulumi.Input<string | undefined>;
+    /**
+     * Networking mode: `public` (default) or `vpc`. Forces recreation on change.
+     */
+    networking?: pulumi.Input<string | undefined>;
+    /**
+     * DigitalOcean region slug for the MicroDroplet's location. Forces recreation on change.
+     */
+    region: pulumi.Input<string>;
+    /**
+     * MicroDroplet size slug. Forces recreation on change.
+     */
+    size: pulumi.Input<string>;
+    /**
+     * Desired lifecycle state. One of `running` (default) or `paused`. Changes are applied by invoking the pause / resume action endpoints and do not recreate the resource. This is the only attribute the provider can mutate in place.
+     */
+    state?: pulumi.Input<string | undefined>;
+    /**
+     * Set of tags applied to the MicroDroplet at create time. Forces recreation on change: MicroDroplets are not exposed via the shared `/v2/tags` API, so tags cannot be added, removed, or verified after creation. They also do not populate on `pulumi import` or on `digitalocean.Microdroplet` / `digitalocean.getMicrodroplets` data sources.
+     */
+    tags?: pulumi.Input<pulumi.Input<string>[] | undefined>;
+    /**
+     * UUID of a VPC to attach to. Only valid when `networking = "vpc"`. Forces recreation on change.
+     */
+    vpcUuid?: pulumi.Input<string | undefined>;
+}
+//# sourceMappingURL=microdroplet.d.ts.map

package/microdroplet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microdroplet.d.ts","sourceRoot":"","sources":["../microdroplet.ts"],"names":[],"mappings":"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"}

package/microdroplet.js

@@ -0,0 +1,165 @@
+"use strict";
+// *** 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.Microdroplet = void 0;
+const pulumi = __importStar(require("@pulumi/pulumi"));
+const utilities = __importStar(require("./utilities"));
+/**
+ * Provides a [DigitalOcean MicroDroplet](https://docs.digitalocean.com/products/microdroplets/) resource. MicroDroplets run OCI images and can auto-pause when idle to reduce cost.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as digitalocean from "@pulumi/digitalocean";
+ *
+ * const example = new digitalocean.Microdroplet("example", {
+ *     name: "example-microdroplet",
+ *     region: "nyc3",
+ *     size: "microdroplet-1",
+ *     image: "docker.io/library/nginx:latest",
+ *     httpPort: 8080,
+ *     httpProtocol: "http",
+ *     autoPause: {
+ *         enabled: true,
+ *         idleTimeout: "5m",
+ *     },
+ *     autoResume: true,
+ *     environment: {
+ *         LOG_LEVEL: "info",
+ *     },
+ *     tags: [
+ *         "web",
+ *         "prod",
+ *     ],
+ * });
+ * ```
+ *
+ * ### Pausing and resuming
+ *
+ * The `state` attribute is settable and defaults to `running`. Changing it to `paused` calls the MicroDroplet pause action endpoint; changing it back to `running` calls the resume action endpoint. Neither triggers recreation:
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as digitalocean from "@pulumi/digitalocean";
+ *
+ * const example = new digitalocean.Microdroplet("example", {state: "paused"});
+ * ```
+ *
+ * Setting `state = "running"` on a paused MicroDroplet resumes it. When `autoPause` is enabled, the platform may transition the MicroDroplet to `paused` on its own — Terraform suppresses the diff in that case so it does not fight the platform.
+ *
+ * ## Import
+ *
+ * A MicroDroplet can be imported using its `id`, e.g.
+ *
+ * ```sh
+ * $ pulumi import digitalocean:index/microdroplet:Microdroplet example 506f78a4-e098-11e5-ad9f-000f53306ae1
+ * ```
+ */
+class Microdroplet extends pulumi.CustomResource {
+    /**
+     * Get an existing Microdroplet resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new Microdroplet(name, state, { ...opts, id: id });
+    }
+    /** @internal */
+    static __pulumiType = 'digitalocean:index/microdroplet:Microdroplet';
+    /**
+     * Returns true if the given object is an instance of Microdroplet.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === Microdroplet.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["autoPause"] = state?.autoPause;
+            resourceInputs["autoResume"] = state?.autoResume;
+            resourceInputs["createdAt"] = state?.createdAt;
+            resourceInputs["currentState"] = state?.currentState;
+            resourceInputs["digitaloceanUrn"] = state?.digitaloceanUrn;
+            resourceInputs["endpoint"] = state?.endpoint;
+            resourceInputs["environment"] = state?.environment;
+            resourceInputs["httpPort"] = state?.httpPort;
+            resourceInputs["httpProtocol"] = state?.httpProtocol;
+            resourceInputs["image"] = state?.image;
+            resourceInputs["name"] = state?.name;
+            resourceInputs["networking"] = state?.networking;
+            resourceInputs["region"] = state?.region;
+            resourceInputs["size"] = state?.size;
+            resourceInputs["state"] = state?.state;
+            resourceInputs["tags"] = state?.tags;
+            resourceInputs["vpcUuid"] = state?.vpcUuid;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.image === undefined && !opts.urn) {
+                throw new Error("Missing required property 'image'");
+            }
+            if (args?.region === undefined && !opts.urn) {
+                throw new Error("Missing required property 'region'");
+            }
+            if (args?.size === undefined && !opts.urn) {
+                throw new Error("Missing required property 'size'");
+            }
+            resourceInputs["autoPause"] = args?.autoPause;
+            resourceInputs["autoResume"] = args?.autoResume;
+            resourceInputs["environment"] = args?.environment;
+            resourceInputs["httpPort"] = args?.httpPort;
+            resourceInputs["httpProtocol"] = args?.httpProtocol;
+            resourceInputs["image"] = args?.image;
+            resourceInputs["name"] = args?.name;
+            resourceInputs["networking"] = args?.networking;
+            resourceInputs["region"] = args?.region;
+            resourceInputs["size"] = args?.size;
+            resourceInputs["state"] = args?.state;
+            resourceInputs["tags"] = args?.tags;
+            resourceInputs["vpcUuid"] = args?.vpcUuid;
+            resourceInputs["createdAt"] = undefined /*out*/;
+            resourceInputs["currentState"] = undefined /*out*/;
+            resourceInputs["digitaloceanUrn"] = undefined /*out*/;
+            resourceInputs["endpoint"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(Microdroplet.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.Microdroplet = Microdroplet;
+//# sourceMappingURL=microdroplet.js.map

package/microdroplet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microdroplet.js","sourceRoot":"","sources":["../microdroplet.ts"],"names":[],"mappings":"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"}

package/microdropletImage.d.ts

@@ -0,0 +1,116 @@
+import * as pulumi from "@pulumi/pulumi";
+/**
+ * Provides a [DigitalOcean MicroDroplet image](https://docs.digitalocean.com/products/microdroplets/) resource. Images are OCI references imported into DigitalOcean and consumed by `digitalocean.Microdroplet` resources.
+ *
+ * Both `name` and `source` are immutable — changing either recreates the image. There is no in-place update; images are create-only and delete-only.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as digitalocean from "@pulumi/digitalocean";
+ *
+ * const example = new digitalocean.MicrodropletImage("example", {
+ *     name: "my-app-v1",
+ *     source: "docker.io/myorg/my-app:v1",
+ * });
+ * const exampleMicrodroplet = new digitalocean.Microdroplet("example", {
+ *     name: "my-app",
+ *     region: "nyc3",
+ *     size: "microdroplet-1",
+ *     image: example.id,
+ * });
+ * ```
+ *
+ * ## Import
+ *
+ * A MicroDroplet image can be imported using its `id`, e.g.
+ *
+ * ```sh
+ * $ pulumi import digitalocean:index/microdropletImage:MicrodropletImage example 4a2c9f10-3d18-4b6a-9e3d-2b7f8e0f1c11
+ * ```
+ */
+export declare class MicrodropletImage extends pulumi.CustomResource {
+    /**
+     * Get an existing MicrodropletImage resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MicrodropletImageState, opts?: pulumi.CustomResourceOptions): MicrodropletImage;
+    /**
+     * Returns true if the given object is an instance of MicrodropletImage.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is MicrodropletImage;
+    /**
+     * RFC3339 timestamp of when the image was created.
+     */
+    readonly createdAt: pulumi.Output<string>;
+    /**
+     * The uniform resource name (URN) for the MicroDroplet image.
+     */
+    readonly digitaloceanUrn: pulumi.Output<string>;
+    /**
+     * Name of the MicroDroplet image. Forces recreation on change.
+     */
+    readonly name: pulumi.Output<string>;
+    /**
+     * OCI reference to import (e.g. `docker.io/library/nginx:latest` or a DOCR ref). Forces recreation on change.
+     */
+    readonly source: pulumi.Output<string>;
+    /**
+     * Lifecycle status (`IMAGE_AVAILABLE` once import completes).
+     */
+    readonly status: pulumi.Output<string>;
+    /**
+     * Create a MicrodropletImage resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: MicrodropletImageArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering MicrodropletImage resources.
+ */
+export interface MicrodropletImageState {
+    /**
+     * RFC3339 timestamp of when the image was created.
+     */
+    createdAt?: pulumi.Input<string | undefined>;
+    /**
+     * The uniform resource name (URN) for the MicroDroplet image.
+     */
+    digitaloceanUrn?: pulumi.Input<string | undefined>;
+    /**
+     * Name of the MicroDroplet image. Forces recreation on change.
+     */
+    name?: pulumi.Input<string | undefined>;
+    /**
+     * OCI reference to import (e.g. `docker.io/library/nginx:latest` or a DOCR ref). Forces recreation on change.
+     */
+    source?: pulumi.Input<string | undefined>;
+    /**
+     * Lifecycle status (`IMAGE_AVAILABLE` once import completes).
+     */
+    status?: pulumi.Input<string | undefined>;
+}
+/**
+ * The set of arguments for constructing a MicrodropletImage resource.
+ */
+export interface MicrodropletImageArgs {
+    /**
+     * Name of the MicroDroplet image. Forces recreation on change.
+     */
+    name?: pulumi.Input<string | undefined>;
+    /**
+     * OCI reference to import (e.g. `docker.io/library/nginx:latest` or a DOCR ref). Forces recreation on change.
+     */
+    source: pulumi.Input<string>;
+}
+//# sourceMappingURL=microdropletImage.d.ts.map

package/microdropletImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microdropletImage.d.ts","sourceRoot":"","sources":["../microdropletImage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAGzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,iBAAkB,SAAQ,MAAM,CAAC,cAAc;IACxD;;;;;;;;OAQG;WACW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,qBAAqB,GAAG,iBAAiB;IAOpJ;;;OAGG;WACW,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,iBAAiB;IAO5D;;OAEG;IACH,SAAgC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjE;;OAEG;IACH,SAAgC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvE;;OAEG;IACH,SAAwB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpD;;OAEG;IACH,SAAwB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD;;OAEG;IACH,SAAgC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9D;;;;;;OAMG;gBACS,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,qBAAqB;CAyB7F;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;CAChC"}