Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions docs/data-sources/dedicated_ip.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "render_dedicated_ip Data Source - render"
subcategory: ""
description: |-
Provides information about a Render Dedicated IP.
---

# render_dedicated_ip (Data Source)

Provides information about a Render Dedicated IP.

## Example Usage

```terraform
data "render_dedicated_ip" "outbound" {
id = "egs-abc123"
}

output "outbound_ips" {
value = data.render_dedicated_ip.outbound.ips
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `id` (String) Unique identifier for this dedicated IP.

### Read-Only

- `created_at` (String) Time the dedicated IP was created.
- `description` (String) Free-form description for this dedicated IP.
- `environment_ids` (Set of String) Environments this dedicated IP applies to. Empty when the IP is workspace-scoped.
- `ips` (List of String) The IPv4 addresses assigned to this dedicated IP. Empty until provisioning completes (status is RUNNING).
- `name` (String) Descriptive name for this dedicated IP.
- `owner_id` (String) The ID of the workspace that owns this dedicated IP.
- `region` (String) Region the dedicated IP applies in.
- `status` (String) Provisioning status. One of UNKNOWN, CREATING, PENDING, RUNNING, FAILED, DELETING, DELETED.
- `updated_at` (String) Time the dedicated IP was last updated.
60 changes: 60 additions & 0 deletions docs/resources/dedicated_ip.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "render_dedicated_ip Resource - render"
subcategory: ""
description: |-
Provides a Render Dedicated IP resource. Use this to allocate a workspace-scoped or environment-scoped egress IP that services in the same region will route outbound traffic through.
---

# render_dedicated_ip (Resource)

Provides a Render Dedicated IP resource. Use this to allocate a workspace-scoped or environment-scoped egress IP that services in the same region will route outbound traffic through.

## Example Usage

```terraform
# Workspace-scoped: every service in the workspace within this region
# routes outbound traffic through this dedicated IP.
resource "render_dedicated_ip" "outbound" {
name = "primary-egress"
description = "egress IP shared by all services in oregon"
region = "oregon"
}

# Environment-scoped: only services in the listed environments use this IP.
resource "render_dedicated_ip" "production" {
name = "production-egress"
region = "oregon"
environment_ids = ["evm-abc123"]
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `name` (String) Descriptive name for this dedicated IP.
- `region` (String) [Region](https://render.com/docs/regions) to deploy the service. One of `frankfurt`, `ohio`, `oregon`, `singapore`, `virginia`.

### Optional

- `description` (String) Free-form description for this dedicated IP.
- `environment_ids` (Set of String) Environments to scope this dedicated IP to. Leave unset (or pass an empty set) to apply the IP to every service in the workspace within its region. Mutually exclusive with another workspace-scoped IP in the same region.

### Read-Only

- `created_at` (String) Time the dedicated IP was created.
- `id` (String) Unique identifier for this dedicated IP.
- `ips` (List of String) The IPv4 addresses assigned to this dedicated IP. Empty until provisioning completes (when status is RUNNING).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does it mean for multiple IPs to be assigned to a single IP?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How long does provisioning take? I think my expectation with Terraform is that a resource will block on apply until it's fully ready, rather than return a "RUNNING" status.

- `owner_id` (String) The ID of the workspace that owns this dedicated IP.
- `status` (String) Provisioning status. One of UNKNOWN, CREATING, PENDING, RUNNING, FAILED, DELETING, DELETED.
- `updated_at` (String) Time the dedicated IP was last updated.

## Import

Import is supported using the following syntax:

```shell
terraform import render_dedicated_ip.outbound egs-abc123
```
7 changes: 7 additions & 0 deletions examples/data-sources/render_dedicated_ip/data-source.tf
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
data "render_dedicated_ip" "outbound" {
id = "egs-abc123"
}

output "outbound_ips" {
value = data.render_dedicated_ip.outbound.ips
}
1 change: 1 addition & 0 deletions examples/resources/render_dedicated_ip/import.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
terraform import render_dedicated_ip.outbound egs-abc123
14 changes: 14 additions & 0 deletions examples/resources/render_dedicated_ip/resource.tf
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Workspace-scoped: every service in the workspace within this region
# routes outbound traffic through this dedicated IP.
resource "render_dedicated_ip" "outbound" {
name = "primary-egress"
description = "egress IP shared by all services in oregon"
region = "oregon"
}

# Environment-scoped: only services in the listed environments use this IP.
resource "render_dedicated_ip" "production" {
name = "production-egress"
region = "oregon"
environment_ids = ["evm-abc123"]
}
125 changes: 125 additions & 0 deletions internal/client/artifactsources/artifactsources_gen.go

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

80 changes: 73 additions & 7 deletions internal/client/blueprints/blueprints_gen.go

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading