dubzland.minio.minio_bucket module – Manages Minio buckets

Note

This module is part of the dubzland.minio collection (version 1.2.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install dubzland.minio. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: dubzland.minio.minio_bucket.

Synopsis

  • When the bucket does not exist, it will be created.

  • When the bucket does exist and state=absent, the bucket will be deleted.

  • When changes are made to the bucket, the bucket will be updated.

Requirements

The below requirements are needed on the host that executes this module.

  • python >= 3.8

  • minio >= 7.1.4

Parameters

Parameter

Comments

auth

dictionary / required

Connection information for the Minio instance being managed.

access_key

string / required

Minio access key to use to authenticate with the Minio instance.

secret_key

string / required

Minio secret key used to connect to the Minio instance.

url

string / required

Minio Server URL.

name

string / required

Name of the bucket to be managed.

state

string

Indicates the desired bucket state.

present ensures the bucket is present.

absent ensures the bucket is absent.

Choices:

  • "present" ← (default)

  • "absent"

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

See Also

See also

mc mb

Documentation for the mc mb command.

Examples

- name: Add a Minio bucket
  dubzland.minio.minio_bucket:
    name: testbucket
    auth:
      url: http://minio-server:9000
      access_key: myuser
      secret_key: supersekret
    state: present
  delegate_to: localhost

Authors

  • Josh Williams (@t3hpr1m3)