Skip to main content
  1. Docs
  2. Administration
  3. Access & Identity
  4. Role-Based Access Control (RBAC)
  5. Scopes
  6. RBAC Scopes: Environments

RBAC Scopes: Environments

    This document defines all the available scopes in Pulumi Cloud assignable to specific environments or sets of environments.

    Pulumi Cloud’s configurable RBAC features are only available in the Pulumi Enterprise or Business Critical editions. To learn more, see the pricing page.

    Note that creating, listing, or restoring environments are organization-level operations, and these scopes can be found in the organization settings scopes.

    Environments

    ValueDescription
    environment:cloneCreate a copy of an existing environment with all its configurations. This is useful for creating staging or testing environments.

    Granted by default permission set: Environment Open
    environment:deleteRemove an environment and its associated resources. This permanently deletes the environment and its configurations.

    Granted by default permission set: Environment Admin
    environment:openAccess and interact with an environment’s resources. This includes the ability to view and modify environment configurations.

    Granted by default permission set: Environment Open
    environment:readView environment configurations and settings. This provides read-only access to environment details and parameters.

    Granted by default permission set: Environment Read
    environment:writeModify environment configurations and settings. This allows updating environment parameters and resource definitions.

    Granted by default permission set: Environment Write

    Environment Secrets Rotation

    ValueDescription
    environment:rotateInitiate a rotation of secrets and credentials in an environment. This is a security measure to regularly update sensitive information.

    Granted by default permission set: Environment Write
    environment:rotate_historyView the history of secret rotations for an environment. This provides an audit trail of when secrets were last changed.

    Granted by default permission set: Environment Read

    Environment Schedules

    ValueDescription
    environment_schedule:createCreate a new schedule for automated environment operations. This allows setting up recurring tasks and maintenance windows.

    Granted by default permission set: Environment Write
    environment_schedule:deleteRemove an existing environment schedule. This permanently deletes the scheduled task and its configuration.

    Granted by default permission set: Environment Write
    environment_schedule:pauseTemporarily suspend an environment schedule. This halts automated operations without deleting the schedule.

    Granted by default permission set: Environment Write
    environment_schedule:readView environment schedule configurations and status. This includes access to schedule details and execution history.

    Granted by default permission set: Environment Read
    environment_schedule:resumeResume a paused environment schedule. This restores automated operations according to the schedule.

    Granted by default permission set: Environment Write
    environment_schedule:updateModify an existing environment schedule. This allows updating timing, frequency, and other schedule parameters.

    Granted by default permission set: Environment Write

    Environment Tags

    ValueDescription
    environment_tag:createAdd a new tag to an environment. This helps in organizing and categorizing environments.

    Granted by default permission set: Environment Write
    environment_tag:deleteRemove a tag from an environment. This allows cleaning up or reorganizing environment categorization.

    Granted by default permission set: Environment Write
    environment_tag:readView tags associated with environments. This provides access to environment categorization and metadata.

    Granted by default permission set: Environment Read
    environment_tag:updateModify existing environment tags. This allows updating tag values and metadata.

    Granted by default permission set: Environment Write

    Environment Versions

    ValueDescription
    environment_version:createCreate a new version of an environment. This allows tracking changes and maintaining environment history.

    Granted by default permission set: Environment Write
    environment_version:deleteRemove a specific version of an environment. This permanently deletes the version and its configurations.

    Granted by default permission set: Environment Write
    environment_version:openAccess and interact with a specific environment version. This includes viewing and using version-specific configurations.

    Granted by default permission set: Environment Open
    environment_version:readView details of a specific environment version. This provides access to version-specific configurations and metadata.

    Granted by default permission set: Environment Open
    environment_version:retractMark a specific environment version as invalid or deprecated. This prevents its use while maintaining history.

    Granted by default permission set: Environment Write
    environment_version:updateModify an existing environment version. This allows updating version-specific configurations and metadata.

    Granted by default permission set: Environment Write

    Environment Webhooks

    ValueDescription
    environment_webhook:createCreate a new webhook for environment events. This enables integration with external systems and automation.

    Granted by default permission set: Environment Write
    environment_webhook:deleteRemove an existing environment webhook. This permanently deletes the webhook configuration.

    Granted by default permission set: Environment Write
    environment_webhook:readView environment webhook configurations. This includes access to webhook settings and event triggers.

    Granted by default permission set: Environment Write
    environment_webhook:updateModify an existing environment webhook. This allows updating webhook settings and event triggers.

    Granted by default permission set: Environment Write

    Environment change requests (approvals)

    ValueDescription
    change_gate:createCreate approval rules (change gates) for this environment. This requires approval before deployments or changes proceed.

    Granted by default permission set: Environment Write
    change_gate:updateModify approval rules for this environment.

    Granted by default permission set: Environment Write
    change_gate:deleteRemove approval rules (change gates) for this environment.

    Granted by default permission set: Environment Write