bitbucket_pull_info – Get information about pull requests on Bitbucket Server

Synopsis

Manages repository pull requests on Bitbucket Server.

Authentication can be done with token or with username and password.

Parameters

url (False, str, None)

Bitbucket Server URL.

username (False, str, None)

Username used for authentication.

This is only needed when not using token.

Required when password is provided.

password (False, str, None)

Password used for authentication.

This is only needed when not using token.

Required when username is provided.

token (False, str, None)

Token parameter for authentication.

This is only needed when not using username and password.

repository (True, str, None)

Repository name.

project_key (True, str, None)

Bitbucket project key.

state (False, str, present)

Whether the pull should exist or not.

return_content (optional, bool, True)

Whether or not to return the body of the response as a “content” key in the dictionary result no matter it succeeded or failed.

validate_certs (optional, bool, True)

If no, SSL certificates will not be validated.

This should only set to no used on personally controlled sites using self-signed certificates.

use_proxy (optional, bool, True)

If no, it will not use a proxy, even if one is defined in an environment variable on the target hosts.

sleep (optional, int, 5)

Number of seconds to sleep between API retries.

retries (optional, int, 3)

Number of retries to call Bitbucket API URL before failure.

Notes

Note

  • Bitbucket Access Token can be obtained from Bitbucket profile -> Manage Account -> Personal Access Tokens.

  • Supports check_mode.

Examples

- name: Get information about pulls
  esp.bitbucket.bitbucket_pull_info:
    username: jsmith
    password: secrect
    repository: bar
    project_key: FOO
    validate_certs: no
    state: present

Return Values

name (success, str, bar)

Bitbucket repository name (if state=present).

project (success, dict, )

Information about Bitbucket project (if state=present).

id (success, int, 200)

Project ID.

key (success, str, FOO)

Bitbucket project key.

name (success, str, FOO project)

Bitbucket project name.

public (success, bool, False)

Whether or not the project is public.

type (success, str, NORMAL)

Bitbucket project type.

self (success, list, None)

Links to Bitbucket project.

state (success, str, AVAILABLE)

Bitbucket repository state, after execution (if state=present).

statusMessage (success, str, Available)

Bitbucket repository state message, after execution (if state=present).

context (success, str, None)

Context (if state=absent).

exceptionName (success, str, None)

Exception Name (if state=absent).

json (success, array, )

Information about pulls

author (, any, )

fromRef (, any, )

pull_id (, any, )

title (, any, )

toRef (, any, )

version (, any, )

Status

Authors

  • Pawel Smolarz