47 lines
2.6 KiB
Markdown
47 lines
2.6 KiB
Markdown
---
|
|
# generated by https://github.com/hashicorp/terraform-plugin-docs
|
|
page_title: "stackit_resourcemanager_project Resource - stackit"
|
|
subcategory: ""
|
|
description: |-
|
|
Resource Manager project resource schema. To use this resource, it is required that you set the service account email in the provider configuration.
|
|
-> In case you're getting started with an empty STACKIT organization and want to use this resource to create projects in it, check out this guide https://registry.terraform.io/providers/stackitcloud/stackit/latest/docs/guides/stackit_org_service_account for how to create a service account which you can use for authentication in the STACKIT Terraform provider.
|
|
---
|
|
|
|
# stackit_resourcemanager_project (Resource)
|
|
|
|
Resource Manager project resource schema. To use this resource, it is required that you set the service account email in the provider configuration.
|
|
|
|
-> In case you're getting started with an empty STACKIT organization and want to use this resource to create projects in it, check out [this guide](https://registry.terraform.io/providers/stackitcloud/stackit/latest/docs/guides/stackit_org_service_account) for how to create a service account which you can use for authentication in the STACKIT Terraform provider.
|
|
|
|
## Example Usage
|
|
|
|
```terraform
|
|
resource "stackit_resourcemanager_project" "example" {
|
|
parent_container_id = "example-parent-container-abc123"
|
|
name = "example-container"
|
|
labels = {
|
|
"Label 1" = "foo"
|
|
// "networkArea" = stackit_network_area.foo.network_area_id
|
|
}
|
|
owner_email = "john.doe@stackit.cloud"
|
|
}
|
|
```
|
|
|
|
<!-- schema generated by tfplugindocs -->
|
|
## Schema
|
|
|
|
### Required
|
|
|
|
- `name` (String) Project name.
|
|
- `owner_email` (String) Email address of the owner of the project. This value is only considered during creation. Changing it afterwards will have no effect.
|
|
- `parent_container_id` (String) Parent resource identifier. Both container ID (user-friendly) and UUID are supported
|
|
|
|
### Optional
|
|
|
|
- `labels` (Map of String) Labels are key-value string pairs which can be attached to a resource container. A label key must match the regex [A-ZÄÜÖa-zäüöß0-9_-]{1,64}. A label value must match the regex ^$|[A-ZÄÜÖa-zäüöß0-9_-]{1,64}. To add a project to a STACKIT Network Area, setting the label `networkArea=<networkAreaID>` is required.
|
|
|
|
### Read-Only
|
|
|
|
- `container_id` (String) Project container ID. Globally unique, user-friendly identifier.
|
|
- `id` (String) Terraform's internal resource ID. It is structured as "`container_id`".
|
|
- `project_id` (String) Project UUID identifier. This is the ID that can be used in most of the other resources to identify the project.
|