|
| 1 | +--- |
| 2 | +subcategory: "Resource Manager" |
| 3 | +layout: "oci" |
| 4 | +page_title: "Oracle Cloud Infrastructure: oci_resourcemanager_private_endpoint" |
| 5 | +sidebar_current: "docs-oci-resource-resourcemanager-private_endpoint" |
| 6 | +description: |- |
| 7 | + Provides the Private Endpoint resource in Oracle Cloud Infrastructure Resource Manager service |
| 8 | +--- |
| 9 | + |
| 10 | +# oci_resourcemanager_private_endpoint |
| 11 | +This resource provides the Private Endpoint resource in Oracle Cloud Infrastructure Resource Manager service. |
| 12 | + |
| 13 | +Creates a a private endpoint in the specified compartment. |
| 14 | + |
| 15 | + |
| 16 | +## Example Usage |
| 17 | + |
| 18 | +```hcl |
| 19 | +resource "oci_resourcemanager_private_endpoint" "test_private_endpoint" { |
| 20 | + #Required |
| 21 | + compartment_id = var.compartment_id |
| 22 | + display_name = var.private_endpoint_display_name |
| 23 | + subnet_id = oci_core_subnet.test_subnet.id |
| 24 | + vcn_id = oci_core_vcn.test_vcn.id |
| 25 | +
|
| 26 | + #Optional |
| 27 | + defined_tags = {"Operations.CostCenter"= "42"} |
| 28 | + description = var.private_endpoint_description |
| 29 | + dns_zones = var.private_endpoint_dns_zones |
| 30 | + freeform_tags = {"Department"= "Finance"} |
| 31 | + is_used_with_configuration_source_provider = var.private_endpoint_is_used_with_configuration_source_provider |
| 32 | + nsg_id_list = var.private_endpoint_nsg_id_list |
| 33 | +} |
| 34 | +``` |
| 35 | + |
| 36 | +## Argument Reference |
| 37 | + |
| 38 | +The following arguments are supported: |
| 39 | + |
| 40 | +* `compartment_id` - (Required) (Updatable) The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing this private endpoint details. |
| 41 | +* `defined_tags` - (Optional) (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` |
| 42 | +* `description` - (Optional) (Updatable) Description of the private endpoint. Avoid entering confidential information. |
| 43 | +* `display_name` - (Required) (Updatable) The private endpoint display name. Avoid entering confidential information. |
| 44 | +* `dns_zones` - (Optional) (Updatable) DNS Proxy forwards any DNS FQDN queries over into the consumer DNS resolver if the DNS FQDN is included in the dns zones list otherwise it goes to service provider VCN resolver. |
| 45 | +* `freeform_tags` - (Optional) (Updatable) Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` |
| 46 | +* `is_used_with_configuration_source_provider` - (Optional) (Updatable) When `true`, allows the private endpoint to be used with a configuration source provider. |
| 47 | +* `nsg_id_list` - (Optional) (Updatable) An array of network security group (NSG) [OCIDs](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) for the private endpoint. Order does not matter. |
| 48 | +* `subnet_id` - (Required) (Updatable) The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the subnet within the VCN for the private endpoint. |
| 49 | +* `vcn_id` - (Required) (Updatable) The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VCN for the private endpoint. |
| 50 | + |
| 51 | + |
| 52 | +** IMPORTANT ** |
| 53 | +Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values |
| 54 | + |
| 55 | +## Attributes Reference |
| 56 | + |
| 57 | +The following attributes are exported: |
| 58 | + |
| 59 | +* `compartment_id` - The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing this private endpoint details. |
| 60 | +* `defined_tags` - Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` |
| 61 | +* `description` - Description of the private endpoint. Avoid entering confidential information. |
| 62 | +* `display_name` - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. |
| 63 | +* `dns_zones` - DNS Proxy forwards any DNS FQDN queries over into the consumer DNS resolver if the DNS FQDN is included in the dns zones list otherwise it goes to service provider VCN resolver. |
| 64 | +* `freeform_tags` - Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` |
| 65 | +* `id` - Unique identifier ([OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm)) of the private endpoint details. |
| 66 | +* `is_used_with_configuration_source_provider` - When `true`, allows the private endpoint to be used with a configuration source provider. |
| 67 | +* `nsg_id_list` - An array of network security groups (NSG) that the customer can optionally provide. |
| 68 | +* `source_ips` - The source IPs which resource manager service will use to connect to customer's network. Automatically assigned by Resource Manager Service. |
| 69 | +* `state` - The current lifecycle state of the private endpoint. |
| 70 | +* `subnet_id` - The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the subnet within the VCN for the private endpoint. |
| 71 | +* `time_created` - The date and time at which the private endpoint was created. Format is defined by RFC3339. Example: `2020-11-25T21:10:29.600Z` |
| 72 | +* `vcn_id` - The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the VCN for the private endpoint. |
| 73 | + |
| 74 | +## Timeouts |
| 75 | + |
| 76 | +The `timeouts` block allows you to specify [timeouts](https://registry.terraform.io/providers/hashicorp/oci/latest/docs/guides/changing_timeouts) for certain operations: |
| 77 | + * `create` - (Defaults to 20 minutes), when creating the Private Endpoint |
| 78 | + * `update` - (Defaults to 20 minutes), when updating the Private Endpoint |
| 79 | + * `delete` - (Defaults to 20 minutes), when destroying the Private Endpoint |
| 80 | + |
| 81 | + |
| 82 | +## Import |
| 83 | + |
| 84 | +PrivateEndpoints can be imported using the `id`, e.g. |
| 85 | + |
| 86 | +``` |
| 87 | +$ terraform import oci_resourcemanager_private_endpoint.test_private_endpoint "id" |
| 88 | +``` |
| 89 | + |
0 commit comments