You are viewing the docs for v1.3, which is not the latest release.
View latest

Manage Kestra Roles with the Terraform Provider

For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

Terraform Resource: kestra_role

Manages a Kestra Role.

Example usage

hclresource "kestra_role" "example" {
  name        = "Friendly name"
  description = "Friendly description"

  permissions {
    type        = "FLOW"
    permissions = ["READ", "UPDATE"]
  }

  permissions {
    type        = "EXECUTION"
    permissions = ["READ", "UPDATE"]
  }
}

Schema

Required

  • name (String) The role name.

Optional

  • description (String) The role description.
  • is_default (Boolean) The role is the default one at user creation. Only one role can be default. Latest create/update to true will be keep as default. Defaults to false.
  • namespace (String) The linked namespace.
  • permissions (Block Set) The role permissions. (see below for nested schema)

Read-Only

  • id (String) The ID of this resource.
  • tenant_id (String) The tenant id.

Nested schema for permissions

Required:

  • permissions (List of String) The permissions for this type.
  • type (String) The type of permission.

Import

Import is supported using the following syntax:

shellterraform import kestra_role.example {{role_id}}