---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "orcasecurity_custom_role Resource - orcasecurity"
subcategory: ""
description: |-
  Provides a custom role resource.
---

# orcasecurity_custom_role (Resource)

Provides a custom role resource.

## Example Usage

```terraform
//Custom role
resource "orcasecurity_custom_role" "tf-custom-role-1" {
  name = "custom_role_1"
  permission_groups = [
    "assets.asset.read",
    "auth.tokens.write"
  ]

  description = "simple role with 2 permissions"

}
```

<!-- schema generated by tfplugindocs -->

## Schema

### Required

- `description` (String) Custom role description.
- `name` (String) Custom role name. Must be unique across your Orca org.
- `permission_groups` (Set of String) Permissions to assign to the group. Possible permissions

### Read-Only

- `id` (String) Custom role ID.