@pulumi/hcloud/getPrimaryIp.js

A Pulumi package for creating and managing hcloud cloud resources.

"use strict";
// *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
Object.defineProperty(exports, "__esModule", { value: true });
exports.getPrimaryIpOutput = exports.getPrimaryIp = void 0;
const pulumi = require("@pulumi/pulumi");
const utilities = require("./utilities");
/**
 * Provides details about a Hetzner Cloud Primary IP.
 *
 * This resource can be useful when you need to determine a Primary IP ID based on the IP address.
 *
 * Side note:
 *
 * If a server is getting created, it has to have a primary ip. If a server is getting created without defining primary ips, two of them (one ipv4 and one ipv6) getting created & attached.
 * Currently, Primary IPs can be only attached to servers.
 *
 * ## Example Usage
 *
 * # Data Source: hcloud.PrimaryIp
 *
 * Provides details about a Hetzner Cloud Primary IP.
 * This resource can be useful when you need to determine a Primary IP ID based on the IP address.
 *
 * ### Additional Examples
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as hcloud from "@pulumi/hcloud";
 *
 * const ip1 = hcloud.getPrimaryIp({
 *     ipAddress: "1.2.3.4",
 * });
 * const ip2 = hcloud.getPrimaryIp({
 *     name: "primary_ip_1",
 * });
 * const ip3 = hcloud.getPrimaryIp({
 *     withSelector: "key=value",
 * });
 * // Link a server to an existing primary IP
 * const serverTest = new hcloud.Server("server_test", {
 *     name: "test-server",
 *     image: "ubuntu-20.04",
 *     serverType: "cx22",
 *     datacenter: "fsn1-dc14",
 *     labels: {
 *         test: "tessst1",
 *     },
 *     publicNets: [{
 *         ipv4: ip1HcloudPrimaryIp.id,
 *     }],
 * });
 * ```
 */
function getPrimaryIp(args, opts) {
    args = args || {};
    opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
    return pulumi.runtime.invoke("hcloud:index/getPrimaryIp:getPrimaryIp", {
        "assigneeId": args.assigneeId,
        "id": args.id,
        "ipAddress": args.ipAddress,
        "name": args.name,
        "withSelector": args.withSelector,
    }, opts);
}
exports.getPrimaryIp = getPrimaryIp;
/**
 * Provides details about a Hetzner Cloud Primary IP.
 *
 * This resource can be useful when you need to determine a Primary IP ID based on the IP address.
 *
 * Side note:
 *
 * If a server is getting created, it has to have a primary ip. If a server is getting created without defining primary ips, two of them (one ipv4 and one ipv6) getting created & attached.
 * Currently, Primary IPs can be only attached to servers.
 *
 * ## Example Usage
 *
 * # Data Source: hcloud.PrimaryIp
 *
 * Provides details about a Hetzner Cloud Primary IP.
 * This resource can be useful when you need to determine a Primary IP ID based on the IP address.
 *
 * ### Additional Examples
 *
 * ```typescript
 * import * as pulumi from "@pulumi/pulumi";
 * import * as hcloud from "@pulumi/hcloud";
 *
 * const ip1 = hcloud.getPrimaryIp({
 *     ipAddress: "1.2.3.4",
 * });
 * const ip2 = hcloud.getPrimaryIp({
 *     name: "primary_ip_1",
 * });
 * const ip3 = hcloud.getPrimaryIp({
 *     withSelector: "key=value",
 * });
 * // Link a server to an existing primary IP
 * const serverTest = new hcloud.Server("server_test", {
 *     name: "test-server",
 *     image: "ubuntu-20.04",
 *     serverType: "cx22",
 *     datacenter: "fsn1-dc14",
 *     labels: {
 *         test: "tessst1",
 *     },
 *     publicNets: [{
 *         ipv4: ip1HcloudPrimaryIp.id,
 *     }],
 * });
 * ```
 */
function getPrimaryIpOutput(args, opts) {
    args = args || {};
    opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
    return pulumi.runtime.invokeOutput("hcloud:index/getPrimaryIp:getPrimaryIp", {
        "assigneeId": args.assigneeId,
        "id": args.id,
        "ipAddress": args.ipAddress,
        "name": args.name,
        "withSelector": args.withSelector,
    }, opts);
}
exports.getPrimaryIpOutput = getPrimaryIpOutput;
//# sourceMappingURL=getPrimaryIp.js.map