Common

Some common fields are handled with specific CLI parameters

CLI Field	POST Field	Discussion
plan	planKey	Leave blank to add linked (global) repositories.
repositoryKey	selectedRepository	Required for add. We have defined some common aliases (case insensitive): BITBUCKET_CLOUD (same as BITBUCKET), BITBUCKET_SERVER (same as STASH), CVS, GIT, GITHUB, MERCURIAL, PERFORCE, SUBVERSION
repository (or name)	repositoryName	Required for add.
credentials	varies	New for to allow shared credentials to be referenced and their respective fields automatically handled. Supports Git, Mercurial, and Bitbucket Cloud repositories. We strongly recommend using to avoid hassles with setting and maintaining authentication fields.
type	repository.bitbucket.scm	Values are GIT (default) or HG (MERCURIAL is an alias). Only for Bitbucket Cloud.

Mercurial

POST Field	Example POST Value	Discussion
selectedRepository	com.atlassian.bamboo.plugins.atlassian-bamboo-plugin-mercurial:bb com.atlassian.bamboo.plugins.atlassian-bamboo-plugin-mercurial:hg	Use as repository key or use one of the aliases.
repository.bitbucket.repository	bob_swift/cli	Selected repository when using BitBucket.
repository.bitbucket.username	bob_swift
repository.bitbucket.temporary.password	***
repository.bitbucket.password.change	true	Register the password setting.
repository.hg.repositoryUrl	http://xxx:8001/cli/	Repository URL when using Mercurial.
repository.hg.authentication	PASSWORD	Others are SSH_PROXY, KEYFILE.
repository.hg.username	bob_swift
repository.hg.password	***
repository.hg.branch	219	Best to let it default.
repository.hg.commandTimeout	180	A valid integer value is required. Use -1 for unlimited.
repository.common.quietPeriod.enabled	true	Defaults to false.
selectedWebRepositoryViewer	bamboo.webrepositoryviewer.provided:noRepositoryViewer	A valid value is required for Bamboo releases < 5.5.
...		There are lots of other fields. Look up the name when needed.

GIT

POST Field	Example POST Value	Discussion
selectedRepository	com.atlassian.bamboo.plugins.atlassian-bamboo-plugin-git:git	Use as repository key or use one of the aliases.
repository.bitbucket.repository	bob_swift/git-example	Selected repository when using BitBucket.
repository.git.repositoryUrl	<direct url to git repository>	Alternative if not accessing GIT via Bitbucket name.
repository.git.authenticationType	PASSWORD or SHARED_CREDENTIALS	Needed on Bitbucket 5.14 and higher at least
repository.git.username	bob_swift	Omit if repository allows anonymous access.
repository.git.temporary.password	***	Omit if repository allows anonymous access.
repository.git.password.change	true	Register the password setting.
repository.git.branch	master	Branch. Best to let it default.
repository.git.commandTimeout	180	A valid integer value is required. Use -1 for unlimited.
repository.common.quietPeriod.enabled	true	Defaults to false.
selectedWebRepositoryViewer	bamboo.webrepositoryviewer.provided:noRepositoryViewer	A valid value is required for Bamboo releases < 5.5.

Bitbucket Cloud

POST Field	Example POST Value	Discussion
selectedRepository	com.atlassian.bamboo.plugins.stash.atlassian-bamboo-plugin-bitbucket:bb	Use as repository key or use one of the aliases - BITBUCKET or BITBUCKET_CLOUD
repository.bitbucket.repository	cli
repository.bitbucket.scm	GIT or HG	CLI defaults to GIT. For Mercurial, recommend using –type HG to simplify
repository.bitbucket.branch	master	Branch. Defaults correctly, but recommend setting explicitly to make it obvious.
repository.bitbucket.username	automation
repository.bitbucket.temporary.password	***
repository.bitbucket.password.change	true
repository.bitbucket.commandTimeout	180	A valid integer value is required. Use -1 for unlimited.
repository.common.quietPeriod.enabled	true	Defaults to false.

Bitbucket Server

(formerly Stash)

POST Field	Example POST Value	Discussion
selectedRepository	com.atlassian.bamboo.plugins.stash.atlassian-bamboo-plugin-stash:stash-rep	Use as repository key or use one of the aliases - BITBUCKET_SERVER or STASH
repository.stash.projectKey	CLI	Bitbucket project key. Required.
repository.stash.repositoryId	112	Numeric repository id. For instance, use getRepositoryList from Bitbucket CLI to find the id. Required
repository.stash.repositorySlug	cli	For instance, use getRepositoryList from Bitbucket CLI to find the id. Required.
repository.stash.repositoryUrl	ssh://git@examplegear.com:7999/cli/cli.git	This was required, but, it accepted any non-blank value. Do not know if this is actually used by Bamboo.
repository.stash.server	42949fec-6f88-3cd8-b146-a1189f8dab5	Application link id to your Bitbucket server. Use the browser source or Inspect Element support on the list of Configure Application Links screen.
repository.stash.branch	master	Branch. Defaults to master, but recommend setting explicitly to make it obvious.
repository.stash.commandTimeout	180	A valid integer value is required. Use -1 for unlimited.
repository.common.quietPeriod.enabled	true	Defaults to false.
repository.common.quietPeriod.period	10	Defaults to 10 seconds
repository.common.quietPeriod.maxRetries	5	Defaults to 5 times
selectedWebRepositoryViewer	bamboo.webrepositoryviewer.provided:noRepositoryViewer	A valid value is required for Bamboo releases < 5.5. Otherwise let it default. Or use: none:none
repository.stash.useShallowClones	true	Defaults to false
repository.stash.useRemoteAgentCache	true	Defaults to true
repository.stash.useSubmodules	true	Defaults to false
repository.stash.lfs	true	Defaults to false
repository.stash.mirror.id		Defaults to blank
repository.stash.mirror.name		Defaults to blank
repository.stash.mirror.url		Defaults to blank

Recommendation

We recommend following the newer techniques discussed more fully in BCLI-408 available with CLI 7.4 and higher where the Bitbucket server can be referenced by application link name or url:

--targetUser xxx --targetPassword ***]]>

_ExamplesForAddRepositoryAction

Related content