Bitbucket Schema#
graph LR
BitbucketProject -- CONTAINS --> BitbucketRepository
BitbucketWorkspace -- RESOURCE --> BitbucketProject
BitbucketWorkspace -- RESOURCE --> BitbucketRepository
BitbucketWorkspace -- RESOURCE --> BitbucketUser
BitbucketProject#
A Bitbucket Cloud project, grouping repositories within a workspace.
Properties#
Field |
Index |
Description |
|---|---|---|
id |
Yes |
Bitbucket project UUID. |
firstseen |
Timestamp when a sync job first created this node. |
|
lastupdated |
Yes |
Timestamp of the last sync that observed this node. |
created_on |
Timestamp when Bitbucket created the project. |
|
description |
Human-readable description of the project. |
|
is_private |
Whether the project is private. |
|
key |
Yes |
Short project key, unique within the workspace. |
link_html |
URL for viewing the project in Bitbucket. |
|
name |
Yes |
Display name of the project. |
updated_on |
Timestamp of the project’s most recent update. |
Relationships#
(:BitbucketProject)-[:CONTAINS]->(:BitbucketRepository): Relationship from BitbucketRepository to BitbucketProject via CONTAINS. Only created when a repository has a project assigned - repos with no project simply omit the “project_id” key on their record.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketProject): Sub-resource relationship from BitbucketProject to BitbucketWorkspace, used for cleanup scoping.
BitbucketRepository#
A Bitbucket Cloud repository.
Every repository belongs to a workspace. Repositories also belong to a project, except legacy repositories created before Bitbucket introduced projects. Per-repository permissions, pull requests, and branch restrictions aren’t ingested.
Ontology Mapping: This node uses the ontology label
CodeRepository.
Properties#
Field |
Index |
Description |
|---|---|---|
id |
Yes |
Bitbucket repository UUID. |
firstseen |
Timestamp when a sync job first created this node. |
|
lastupdated |
Yes |
Timestamp of the last sync that observed this node. |
clone_https |
HTTPS clone URL for the repository. |
|
clone_ssh |
SSH clone URL for the repository. |
|
created_on |
Timestamp when Bitbucket created the repository. |
|
description |
Human-readable description of the repository. |
|
full_name |
Yes |
Repository full name, in the form workspace/repo_slug. |
is_private |
Whether the repository is private. |
|
language |
Primary programming language detected by Bitbucket. |
|
link_html |
URL for viewing the repository in Bitbucket. |
|
mainbranch_name |
Name of the repository’s main branch. |
|
name |
Yes |
Display name of the repository. |
project_key |
Key of the Bitbucket project this repository belongs to, if any. |
|
scm |
Source control system used by the repository, e.g. git. |
|
size |
Repository size in bytes. |
|
slug |
Yes |
URL-friendly repository identifier. |
updated_on |
Timestamp of the repository’s most recent update. |
Relationships#
(:BitbucketProject)-[:CONTAINS]->(:BitbucketRepository): Relationship from BitbucketRepository to BitbucketProject via CONTAINS. Only created when a repository has a project assigned - repos with no project simply omit the “project_id” key on their record.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketRepository): Sub-resource relationship from BitbucketRepository to BitbucketWorkspace. Repositories always belong to a workspace, even without a project, so the workspace is the cleanup-scoping root.
BitbucketUser#
A current member of a Bitbucket Cloud workspace.
id is the Atlassian account ID, so a user who belongs to several synced
workspaces is one node with a RESOURCE relationship from each workspace.
Cartography doesn’t map which users can access which repositories.
If Cartography can’t list the members of any workspace in a run, it skips
BitbucketUser cleanup for every workspace in that run. Sync all of your
workspaces in a single run: when workspaces sync in separate runs, removing
a user from one workspace also removes the node and its other workspace
memberships until those workspaces sync again.
Ontology Mapping: This node uses the ontology label
UserAccount.
Properties#
Field |
Index |
Description |
|---|---|---|
id |
Yes |
Stable Atlassian account ID for the user. |
firstseen |
Timestamp when a sync job first created this node. |
|
lastupdated |
Yes |
Timestamp of the last sync that observed this node. |
avatar_url |
URL of the user’s avatar image. |
|
display_name |
Yes |
Display name of the user. |
link_html |
URL for viewing the user’s profile in Bitbucket. |
|
nickname |
Nickname of the user. |
|
uuid |
Yes |
Bitbucket user UUID. |
Relationships#
(:User)-[:HAS_ACCOUNT]->(:BitbucketUser): generated by analysis jobOntology - UserAccount HAS_ACCOUNT User linking by normalized email.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketUser): Sub-resource relationship from BitbucketUser to BitbucketWorkspace, used for cleanup scoping.
BitbucketWorkspace#
A Bitbucket Cloud workspace, the tenant boundary for projects, repositories, and members.
Cartography syncs only the workspaces listed in --bitbucket-workspaces.
If you remove a workspace from that list, its node and children stay in
the graph.
Ontology Mapping: This node uses the ontology label
Tenant.
Properties#
Field |
Index |
Description |
|---|---|---|
id |
Yes |
Bitbucket workspace UUID. |
firstseen |
Timestamp when a sync job first created this node. |
|
lastupdated |
Yes |
Timestamp of the last sync that observed this node. |
created_on |
Timestamp when Bitbucket created the workspace. |
|
is_private |
Whether the workspace is private. |
|
link_html |
URL for viewing the workspace in Bitbucket. |
|
name |
Yes |
Display name of the workspace. |
slug |
Yes |
URL-friendly workspace identifier. |
Relationships#
(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketProject): Sub-resource relationship from BitbucketProject to BitbucketWorkspace, used for cleanup scoping.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketRepository): Sub-resource relationship from BitbucketRepository to BitbucketWorkspace. Repositories always belong to a workspace, even without a project, so the workspace is the cleanup-scoping root.(:BitbucketWorkspace)-[:RESOURCE]->(:BitbucketUser): Sub-resource relationship from BitbucketUser to BitbucketWorkspace, used for cleanup scoping.