View a markdown version of this page

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

Actions, resources, and condition keys for AWS CodeConnections

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

References:

API operations defined by AWS CodeConnections

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

CreateConnection

codeconnections:CreateConnection

Write

codeconnections:TagResource

Tagging, Write

codestar-connections:CreateConnection

Write

codestar-connections:TagResource

Tagging, Write

CreateHost

codeconnections:CreateHost

Write

codeconnections:TagResource

Tagging, Write

codestar-connections:CreateHost

Write

codestar-connections:TagResource

Tagging, Write

CreateRepositoryLink

codeconnections:CreateRepositoryLink

Write

codeconnections:PassConnection

Read

codeconnections:TagResource

Tagging, Write

codeconnections:UseConnection

Read

codestar-connections:CreateRepositoryLink

Write

codestar-connections:PassConnection

Read

codestar-connections:TagResource

Tagging, Write

codestar-connections:UseConnection

Read

CreateSyncConfiguration

codeconnections:CreateSyncConfiguration

Write

codeconnections:PassRepository

Read

codestar-connections:CreateSyncConfiguration

Write

codestar-connections:PassRepository

Read

iam:PassRole

iam:PassedToService

cloudformation.sync.codeconnections.amazonaws.com

Write

DeleteConnection

codeconnections:DeleteConnection

Write

codestar-connections:DeleteConnection

Write

DeleteHost

codeconnections:DeleteHost

Write

codestar-connections:DeleteHost

Write

DeleteRepositoryLink

codeconnections:DeleteRepositoryLink

Write

codestar-connections:DeleteRepositoryLink

Write

DeleteSyncConfiguration

codeconnections:DeleteSyncConfiguration

Write

codestar-connections:DeleteSyncConfiguration

Write

GetConnection

codeconnections:GetConnection

Read

codestar-connections:GetConnection

Read

GetHost

codeconnections:GetHost

Read

codestar-connections:GetHost

Read

GetRepositoryLink

codeconnections:GetRepositoryLink

Read

codestar-connections:GetRepositoryLink

Read

GetRepositorySyncStatus

codeconnections:GetRepositorySyncStatus

Read

codestar-connections:GetRepositorySyncStatus

Read

GetResourceSyncStatus

codeconnections:GetResourceSyncStatus

Read

codestar-connections:GetResourceSyncStatus

Read

GetSyncBlockerSummary

codeconnections:GetSyncBlockerSummary

Read

codestar-connections:GetSyncBlockerSummary

Read

GetSyncConfiguration

codeconnections:GetSyncConfiguration

Read

codestar-connections:GetSyncConfiguration

Read

ListConnections

codeconnections:ListConnections

List

codestar-connections:ListConnections

List

ListHosts

codeconnections:ListHosts

List

codestar-connections:ListHosts

List

ListRepositoryLinks

codeconnections:ListRepositoryLinks

List

codestar-connections:ListRepositoryLinks

List

ListSyncConfigurations

codeconnections:ListSyncConfigurations

List

codestar-connections:ListSyncConfigurations

List

ListTagsForResource

codeconnections:ListTagsForResource

List

codestar-connections:ListTagsForResource

List

TagResource

codeconnections:TagResource

Tagging, Write

codestar-connections:TagResource

Tagging, Write

UntagResource

codeconnections:UntagResource

Tagging, Write

codestar-connections:UntagResource

Tagging, Write

UpdateHost

codeconnections:UpdateHost

Write

codestar-connections:UpdateHost

Write

UpdateRepositoryLink

codeconnections:PassConnection

Read

codeconnections:UpdateRepositoryLink

Write

codeconnections:UseConnection

Read

codestar-connections:PassConnection

Read

codestar-connections:UpdateRepositoryLink

Write

codestar-connections:UseConnection

Read

UpdateSyncConfiguration

codeconnections:PassRepository

Read

codeconnections:UpdateSyncConfiguration

Write

codestar-connections:PassRepository

Read

codestar-connections:UpdateSyncConfiguration

Write

iam:PassRole

iam:PassedToService

cloudformation.sync.codeconnections.amazonaws.com

Write

Actions defined by AWS CodeConnections

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

CreateConnection

Grants permission to create a Connection resource

aws:RequestTag/${TagKey}

aws:TagKeys

codeconnections:ProviderType

Write

CreateHost

Grants permission to create a host resource

aws:RequestTag/${TagKey}

aws:TagKeys

codeconnections:ProviderType

codeconnections:VpcId

Write

CreateRepositoryLink

Grants permission to create a repository link

Connection*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Write

CreateSyncConfiguration

Grants permission to create a template sync config

RepositoryLink*

aws:ResourceTag/${TagKey}

codeconnections:Branch

Write

DeleteConnection

Grants permission to delete a Connection resource

Connection*

aws:ResourceTag/${TagKey}

Write

DeleteHost

Grants permission to delete a host resource

Host*

aws:ResourceTag/${TagKey}

Write

DeleteRepositoryLink

Grants permission to delete a repository link

RepositoryLink*

aws:ResourceTag/${TagKey}

Write

DeleteSyncConfiguration

Grants permission to delete a sync configuration

Write

GetConnection

Grants permission to get details about a Connection resource

Connection*

aws:ResourceTag/${TagKey}

Read

GetHost

Grants permission to get details about a host resource

Host*

aws:ResourceTag/${TagKey}

Read

GetRepositoryLink

Grants permission to describe a repository link

RepositoryLink*

aws:ResourceTag/${TagKey}

Read

GetRepositorySyncStatus

Grants permission to get the latest sync status for a repository

RepositoryLink*

aws:ResourceTag/${TagKey}

codeconnections:Branch

Read

GetResourceSyncStatus

Grants permission to get the latest sync status for a resource (cfn stack or other resources)

Read

GetSyncBlockerSummary

Grants permission to describe service sync blockers on a resource (cfn stack or other resources)

Read

GetSyncConfiguration

Grants permission to describe a sync configuration

Read

ListConnections

Grants permission to list Connection resources

Connection*

aws:ResourceTag/${TagKey}

codeconnections:ProviderTypeFilter

List

ListHosts

Grants permission to list host resources

codeconnections:ProviderTypeFilter

List

ListRepositoryLinks

Grants permission to list repository links

List

ListRepositorySyncDefinitions

Grants permission to list repository sync definitions

List

ListSyncConfigurations

Grants permission to list sync configurations for a repository link

List

ListTagsForResource

Grants permission to the set of key-value pairs that are used to manage the resource

Connection

aws:ResourceTag/${TagKey}

List

Host

aws:ResourceTag/${TagKey}

RepositoryLink

aws:ResourceTag/${TagKey}

TagResource

Grants permission to add or modify the tags of the given resource

Connection

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

Host

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

RepositoryLink

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

UntagResource

Grants permission to remove tags from an AWS resource

Connection

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

Host

aws:ResourceTag/${TagKey}

aws:TagKeys

RepositoryLink

aws:ResourceTag/${TagKey}

aws:TagKeys

UpdateConnectionInstallation

Grants permission to update a Connection resource with an installation of the CodeStar Connections App

Connection*

aws:ResourceTag/${TagKey}

codeconnections:InstallationId

Write

UpdateHost

Grants permission to update a host resource

Host*

aws:ResourceTag/${TagKey}

codeconnections:VpcId

Write

UpdateRepositoryLink

Grants permission to update a repository link

RepositoryLink*

aws:ResourceTag/${TagKey}

Write

UpdateSyncBlocker

Grants permission to update a sync blocker for a resource (cfn stack or other resources)

Write

UpdateSyncConfiguration

Grants permission to update a sync configuration

codeconnections:Branch

Write

Permission-only actions for AWS CodeConnections

The following actions are defined by AWS CodeConnections 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

GetConnectionToken

Grants permission to get a Connection token to call provider actions

Connection*

aws:ResourceTag/${TagKey}

Read

GetIndividualAccessToken

Grants permission to associate a third party, such as a Bitbucket App installation, with a Connection

codeconnections:ProviderType

Read

GetInstallationUrl

Grants permission to associate a third party, such as a Bitbucket App installation, with a Connection

codeconnections:ProviderType

Read

ListInstallationTargets

Grants permission to associate a third party, such as a Bitbucket App installation, with a Connection

List

PassConnection

Grants permission to pass a Connection resource to an AWS service that accepts a Connection ARN as input, such as codepipeline:CreatePipeline

Connection*

aws:ResourceTag/${TagKey}

codeconnections:PassedToService

Read

PassRepository

Grants permission to pass a repository link resource to an AWS service that accepts a RepositoryLinkId as input, such as codeconnections:CreateSyncConfiguration

RepositoryLink*

aws:ResourceTag/${TagKey}

codeconnections:PassedToService

Read

RegisterAppCode

Grants permission to associate a third party server, such as a GitHub Enterprise Server instance, with a Host

codeconnections:HostArn

Read

StartAppRegistrationHandshake

Grants permission to associate a third party server, such as a GitHub Enterprise Server instance, with a Host

codeconnections:HostArn

Read

StartOAuthHandshake

Grants permission to associate a third party, such as a Bitbucket App installation, with a Connection

codeconnections:ProviderType

Read

UseConnection

Grants permission to use a Connection resource to call provider actions

Connection*

aws:ResourceTag/${TagKey}

codeconnections:BranchName

codeconnections:FullRepositoryId

codeconnections:OwnerId

codeconnections:ProviderAction

codeconnections:ProviderPermissionsRequired

codeconnections:RepositoryName

Read

Resource types defined by AWS CodeConnections

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

Connection

arn:${Partition}:codeconnections:${Region}:${Account}:connection/${ConnectionId}

aws:ResourceTag/${TagKey}

Host

arn:${Partition}:codeconnections:${Region}:${Account}:host/${HostId}

aws:ResourceTag/${TagKey}

RepositoryLink

arn:${Partition}:codeconnections:${Region}:${Account}:repository-link/${RepositoryLinkId}

aws:ResourceTag/${TagKey}

Condition keys for AWS CodeConnections

AWS CodeConnections 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 tags that are passed in the request

String

aws:ResourceTag/${TagKey}

Filters access by the tags associated with the resource

String

aws:TagKeys

Filters access by the tag keys that are passed in the request

ArrayOfString

codeconnections:Branch

Filters access by the branch name that is passed in the request

String

codeconnections:BranchName

Filters access by the branch name that is passed in the request. Applies only to UseConnection requests for access to a specific repository branch

String

codeconnections:FullRepositoryId

Filters access by the repository that is passed in the request. Applies only to UseConnection requests for access to a specific repository

String

codeconnections:HostArn

Filters access by the host resource associated with the connection used in the request

ARN

codeconnections:InstallationId

Filters access by the third-party ID (such as the Bitbucket App installation ID for CodeConnections) that is used to update a Connection. Allows you to restrict which third-party App installations can be used to make a Connection

String

codeconnections:OwnerId

Filters access by the owner of the third-party repository. Applies only to UseConnection requests for access to repositories owned by a specific user

String

codeconnections:PassedToService

Filters access by the service to which the principal is allowed to pass a Connection or RepositoryLink

String

codeconnections:ProviderAction

Filters access by the provider action in a UseConnection request such as ListRepositories. See documentation for all valid values

String

codeconnections:ProviderPermissionsRequired

Filters access by the write permissions of a provider action in a UseConnection request. Valid types include read_only and read_write

String

codeconnections:ProviderType

Filters access by the type of third-party provider passed in the request

String

codeconnections:ProviderTypeFilter

Filters access by the type of third-party provider used to filter results

String

codeconnections:RepositoryName

Filters access by the repository name that is passed in the request. Applies only to UseConnection requests for access to repositories owned by a specific user

String

codeconnections:VpcId

Filters access by the VpcId passed in the request

String