Menu
AWS CodeStar
User Guide

Remove Team Members from an AWS CodeStar Project

After you remove from an AWS CodeStar project, the user will still appear in the commit history for the project repository, but will no longer have access to the AWS CodeCommit repository or any other project resources, such as the project pipeline. (The exception to this rule is an IAM user who has other policies applied that grant access to those resources.) The user will not be able to access the project dashboard, and the project will no longer appear in the list of projects that user sees on the AWS CodeStar dashboard.

Note

Although removing a team member from a project will deny remote access to project Amazon EC2 instances, it will not close any of the user's active SSH sessions.

Removing a team member does not affect that team member's access to any resources that are outside of AWS, for example a GitHub repository or issues in Atlassian JIRA. Those access permissions are controlled by the resource provider, not AWS CodeStar. For more information, consult the resource provider's documentation.

To remove a team member from a project, you must have the AWS CodeStar Owner role for that project or have the AWSCodeStarFullAccess policy applied to your account.

Remove Team Members Using the Console

You can remove team members from your project team using the AWS CodeStar console.

To remove a team member from a project

  1. Open the AWS CodeStar console at https://console.aws.amazon.com/codestar/.

    Choose the project.

  2. In the navigation bar for the project, choose Team.

  3. On the Team members page, find the name of the team member you want to remove, and then choose Remove.

Remove Team Members Using the AWS CLI

You can remove team members from your project team using the AWS CLI.

To remove a team member (AWS CLI)

  1. Open a terminal or command window.

  2. Run the disassociate-team-member command, including the --project-id and -user-arn parameters to remove a team member from your project. For example:

    Copy
    aws codestar disassociate-team-member --project-id my-first-projec --user-arn arn:aws:iam:111111111111:user/John_Doe

    This command returns output similar to the following:

    Copy
    { "projectId": "my-first-projec", "userArn": "arn:aws:iam::111111111111:user/John_Doe" }