Retrieves the current user's preferred mirror server
This request has no parameters.
the preferred mirror server
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/account/settings/preferred-mirror' \
--header 'Accept: application/json;charset=UTF-8'
Sets the mirror specified by a mirror ID as the current user's preferred mirror
the mirror ID
string
an empty response indicating that the user setting has been updated
1
2
3
4
curl --request POST \
--url 'http://{baseurl}/rest/mirroring/latest/account/settings/preferred-mirror' \
--header 'Content-Type: application/json' \
--data '"<string>"'
Removes the current user's preferred mirror
This request has no parameters.
an empty response indicating that the user setting has been updated
1
2
curl --request DELETE \
--url 'http://{baseurl}/rest/mirroring/latest/account/settings/preferred-mirror'
Gets the analytics settings from the mirroring upstream
This request has no parameters.
The analytics settings from upstream
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/analyticsSettings' \
--header 'Accept: application/json;charset=UTF-8'
Authenticates on behalf of a user. Used by mirrors to check the credentials supplied to them by users. If successful a user and their effective permissions are returned as follows -
Currently only username/password, bearer token and SSH credentials are supported.
oneOf [RestUsernamePasswordCredentials, RestBearerTokenCredentials, RestSshCredentials]
Requiredinteger
The user for the supplied credentials and their effective permissions}.
1
2
3
4
5
6
7
8
curl --request POST \
--url 'http://{baseurl}/rest/mirroring/latest/authenticate' \
--header 'Accept: application/json;charset=UTF-8' \
--header 'Content-Type: application/json' \
--data '{
"credentials": {},
"repositoryId": 2154
}'
Returns a list of mirrors
number
number
a page of mirrors
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/mirrorServers' \
--header 'Accept: application/json;charset=UTF-8'
Returns the mirror specified by a mirror ID
string
Requiredthe mirror
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/mirrorServers/{mirrorId}' \
--header 'Accept: application/json;charset=UTF-8'
Upgrades the mirror server in question with the provided details.This endpoint can only be called by the mirror instance or system administrators
Since 5.8
string
Requiredstring
string
the mirror
1
2
3
4
5
6
7
8
curl --request PUT \
--url 'http://{baseurl}/rest/mirroring/latest/mirrorServers/{mirrorId}' \
--header 'Accept: application/json;charset=UTF-8' \
--header 'Content-Type: application/json' \
--data '{
"baseUrl": "https://bitbucket-eu.example.com:7990/bitbucket",
"productVersion": "8.0.0"
}'
Removes a mirror, disabling all access and notifications for the mirror server in question
string
Requiredan empty response indicating that the mirror has been removed
1
2
curl --request DELETE \
--url 'http://{baseurl}/rest/mirroring/latest/mirrorServers/{mirrorId}'
Publishes a RepositoryMirrorEvent on the event queue.
string
Requiredinteger
string
string
The event was successfully placed on the queue
1
2
3
4
5
6
7
8
curl --request POST \
--url 'http://{baseurl}/rest/mirroring/latest/mirrorServers/{mirrorId}/events' \
--header 'Content-Type: application/json' \
--data '{
"mirrorRepoId": 42,
"type": "SYNCHRONIZED",
"upstreamRepoId": "24"
}'
Returns the requested project using its primary key ID.
Since 6.7
string
RequiredThe project with the specified ID
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/projects/{projectId}' \
--header 'Accept: application/json;charset=UTF-8'
Returns a page of repositories for a given project, enriched with a content hash
string
Requiredstring
number
number
A page of repositories with content hashes
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/projects/{projectId}/repos' \
--header 'Accept: application/json;charset=UTF-8'
Returns a page of repositories enriched with a content hash and default branch
string
A page of repositories with content hashes and default branch
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/repos' \
--header 'Accept: application/json;charset=UTF-8'
Returns a repository enriched with a content hash and default branch
string
Requiredboolean
The repository with the specified repoId
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/repos/{repoId}' \
--header 'Accept: application/json;charset=UTF-8'
Returns a page of mirrors for a repository. This resource will return all mirrors along with authorized links to the mirror's repository REST resource. To determine if a repository is available on the mirror, the returned URL needs to be called.
string
Requiredboolean
The mirrored repository descriptor
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/repos/{repoId}/mirrors' \
--header 'Accept: application/json;charset=UTF-8'
Retrieves a mirroring request
string
number
number
A page of mirroring requests
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/requests' \
--header 'Accept: application/json;charset=UTF-8'
Creates a new mirroring request
string
string
string
string
string
string
The created mirroring request
1
2
3
4
5
6
7
8
9
10
11
12
curl --request POST \
--url 'http://{baseurl}/rest/mirroring/latest/requests' \
--header 'Accept: application/json;charset=UTF-8' \
--header 'Content-Type: application/json' \
--data '{
"mirrorBaseUrl": "https://bitbucket-eu.example.com:7990/bitbucket",
"mirrorId": "4f0eb5fc-67fc-48f8-b4a7-87981f026c6a",
"mirrorName": "Bitbucket Mirror",
"mirrorType": "SINGLE",
"productVersion": "8.0.0",
"state": "PENDING"
}'
Retrieves a mirroring request
string
RequiredThe mirroring request
1
2
3
curl --request GET \
--url 'http://{baseurl}/rest/mirroring/latest/requests/{mirroringRequestId}' \
--header 'Accept: application/json;charset=UTF-8'
Deletes a mirroring request
string
RequiredThe request was deleted
1
2
curl --request DELETE \
--url 'http://{baseurl}/rest/mirroring/latest/requests/{mirroringRequestId}'
Accepts a mirroring request
string
RequiredThe accepted mirror server
1
2
3
curl --request POST \
--url 'http://{baseurl}/rest/mirroring/latest/requests/{mirroringRequestId}/accept' \
--header 'Accept: application/json;charset=UTF-8'
Rejects a mirroring request
string
RequiredThe rejected mirror server
1
2
3
curl --request POST \
--url 'http://{baseurl}/rest/mirroring/latest/requests/{mirroringRequestId}/reject' \
--header 'Accept: application/json;charset=UTF-8'
Rate this page: