View a markdown version of this page

Actions, resources, and condition keys for AWS Cloud9 - Service Authorization Reference

Actions, resources, and condition keys for AWS Cloud9

AWS Cloud9 (service prefix: cloud9) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by AWS Cloud9

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation IAM action Condition key Possible value(s) Access level

CreateEnvironmentEC2

cloud9:CreateEnvironmentEC2

Write

cloud9:TagResource

Tagging, Write

CreateEnvironmentMembership

cloud9:CreateEnvironmentMembership

Write

DeleteEnvironment

cloud9:DeleteEnvironment

Write

DeleteEnvironmentMembership

cloud9:DeleteEnvironmentMembership

Write

DescribeEnvironmentMemberships

cloud9:DescribeEnvironmentMemberships

Read

DescribeEnvironmentStatus

cloud9:DescribeEnvironmentStatus

Read

DescribeEnvironments

cloud9:DescribeEnvironments

Read

ListEnvironments

cloud9:ListEnvironments

Read

ListTagsForResource

cloud9:ListTagsForResource

Read

TagResource

cloud9:TagResource

Tagging, Write

UntagResource

cloud9:UntagResource

Tagging, Write

UpdateEnvironment

cloud9:UpdateEnvironment

Write

UpdateEnvironmentMembership

cloud9:UpdateEnvironmentMembership

Write

Actions defined by AWS Cloud9

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

CreateEnvironmentEC2

Grants permission to create an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then hosts the environment on the instance

aws:RequestTag/${TagKey}

aws:TagKeys

cloud9:EnvironmentName

cloud9:InstanceType

cloud9:OwnerArn

cloud9:SubnetId

cloud9:UserArn

Write

CreateEnvironmentMembership

Grants permission to add an environment member to an AWS Cloud9 development environment

environment*

aws:ResourceTag/${TagKey}

cloud9:EnvironmentId

cloud9:Permissions

cloud9:UserArn

Write

DeleteEnvironment

Grants permission to delete an AWS Cloud9 development environment. If the environment is hosted on an Amazon Elastic Compute Cloud (Amazon EC2) instance, also terminates the instance

environment*

aws:ResourceTag/${TagKey}

Write

DeleteEnvironmentMembership

Grants permission to delete an environment member from an AWS Cloud9 development environment

environment*

aws:ResourceTag/${TagKey}

cloud9:EnvironmentId

cloud9:UserArn

Write

DescribeEnvironmentMemberships

Grants permission to get information about environment members for an AWS Cloud9 development environment

environment*

aws:ResourceTag/${TagKey}

cloud9:EnvironmentId

cloud9:UserArn

Read

DescribeEnvironmentStatus

Grants permission to get status information for an AWS Cloud9 development environment

environment*

aws:ResourceTag/${TagKey}

Read

DescribeEnvironments

Grants permission to get information about AWS Cloud9 development environments

environment*

aws:ResourceTag/${TagKey}

Read

ListEnvironments

Grants permission to get a list of AWS Cloud9 development environment identifiers

Read

ListTagsForResource

Grants permission to list tags for a cloud9 environment

environment*

aws:ResourceTag/${TagKey}

Read

TagResource

Grants permission to add tags to a cloud9 environment

environment*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

UntagResource

Grants permission to remove tags from a cloud9 environment

environment*

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

UpdateEnvironment

Grants permission to change the settings of an existing AWS Cloud9 development environment

environment*

aws:ResourceTag/${TagKey}

Write

UpdateEnvironmentMembership

Grants permission to change the settings of an existing environment member for an AWS Cloud9 development environment

environment*

aws:ResourceTag/${TagKey}

cloud9:EnvironmentId

cloud9:Permissions

cloud9:UserArn

Write

Permission-only actions for AWS Cloud9

The following actions are defined by AWS Cloud9 but are not directly invocable through any API operation. They can only be used in IAM policy statements to grant or deny permissions.

Actions Description Resource types (*required) Condition keys Access level

ActivateEC2Remote

Grants permission to start the Amazon EC2 instance that your AWS Cloud9 IDE connects to

environment*

aws:ResourceTag/${TagKey}

Write

CreateEnvironmentSSH

Grants permission to create an AWS Cloud9 SSH development environment

aws:RequestTag/${TagKey}

aws:TagKeys

cloud9:EnvironmentName

cloud9:OwnerArn

Write

CreateEnvironmentToken

Grants permission to create an authentication token that allows a connection between the AWS Cloud9 IDE and the user's environment

environment*

aws:ResourceTag/${TagKey}

Read

DescribeEC2Remote

Grants permission to get details about the connection to the EC2 development environment, including host, user, and port

environment*

aws:ResourceTag/${TagKey}

Read

DescribeSSHRemote

Grants permission to get details about the connection to the SSH development environment, including host, user, and port

environment*

aws:ResourceTag/${TagKey}

Read

GetEnvironmentConfig

Grants permission to get configuration information that's used to initialize the AWS Cloud9 IDE

environment*

aws:ResourceTag/${TagKey}

Read

GetEnvironmentSettings

Grants permission to get the AWS Cloud9 IDE settings for a specified development environment

environment*

aws:ResourceTag/${TagKey}

Read

GetMembershipSettings

Grants permission to get the AWS Cloud9 IDE settings for a specified environment member

environment*

aws:ResourceTag/${TagKey}

Read

GetMigrationExperiences

Grants permission to get the migration experience for a cloud9 user

Read

GetUserPublicKey

Grants permission to get the user's public SSH key, which is used by AWS Cloud9 to connect to SSH development environments

cloud9:UserArn

Read

GetUserSettings

Grants permission to get the AWS Cloud9 IDE settings for a specified user

Read

ModifyTemporaryCredentialsOnEnvironmentEC2

Grants permission to set AWS managed temporary credentials on the Amazon EC2 instance that's used by the AWS Cloud9 integrated development environment (IDE)

environment*

aws:ResourceTag/${TagKey}

Write

UpdateEnvironmentSettings

Grants permission to update the AWS Cloud9 IDE settings for a specified development environment

environment*

aws:ResourceTag/${TagKey}

Write

UpdateMembershipSettings

Grants permission to update the AWS Cloud9 IDE settings for a specified environment member

environment*

aws:ResourceTag/${TagKey}

Write

UpdateSSHRemote

Grants permission to update details about the connection to the SSH development environment, including host, user, and port

environment*

aws:ResourceTag/${TagKey}

Write

UpdateUserSettings

Grants permission to update IDE-specific settings of an AWS Cloud9 user

Write

Resource types defined by AWS Cloud9

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

environment

arn:${Partition}:cloud9:${Region}:${Account}:environment:${ResourceId}

aws:ResourceTag/${TagKey}

Condition keys for AWS Cloud9

AWS Cloud9 defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:RequestTag/${TagKey}

Filters access by the presence of tag key-value pairs in the request

String

aws:ResourceTag/${TagKey}

Filters access by tag key-value pairs attached to the resource

String

aws:TagKeys

Filters access by the presence of tag keys in the request

ArrayOfString

cloud9:EnvironmentId

Filters access by the AWS Cloud9 environment ID

String

cloud9:EnvironmentName

Filters access by the AWS Cloud9 environment name

String

cloud9:InstanceType

Filters access by the instance type of the AWS Cloud9 environment's Amazon EC2 instance

String

cloud9:OwnerArn

Filters access by the owner ARN specified

ARN

cloud9:Permissions

Filters access by the type of AWS Cloud9 permissions

String

cloud9:SubnetId

Filters access by the subnet ID that the AWS Cloud9 environment will be created in

String

cloud9:UserArn

Filters access by the user ARN specified

ARN