> For the complete documentation index, see [llms.txt](https://docs.ionos.com/puppet-v6/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/puppet-v6/types/user-management/ionoscloud_group.md).

# ionoscloud\_group

Type representing a IonosCloud group.

## Parameters:

| Name | Required | Description     |
| ---- | :------: | --------------- |
| name |   true   | The group name. |

## Properties:

| Name                              | Required | Description                                                                                                                                                                                                         |
| --------------------------------- | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ensure                            |    No    | The basic property that the resource should be in. Valid values are `present`, `absent`.                                                                                                                            |
| create\_data\_center              |    No    | Indicates if the group is allowed to create virtual data centers. Valid values are `true`, `false`.                                                                                                                 |
| create\_snapshot                  |    No    | Indicates if the group is allowed to create snapshots. Valid values are `true`, `false`.                                                                                                                            |
| reserve\_ip                       |    No    | Indicates if the group is allowed to reserve IP addresses. Valid values are `true`, `false`.                                                                                                                        |
| access\_activity\_log             |    No    | Indicates if the group is allowed to access the activity log. Valid values are `true`, `false`.                                                                                                                     |
| s3\_privilege                     |    No    | Indicates if the group is allowed is allowed to manage S3. Valid values are `true`, `false`.                                                                                                                        |
| create\_backup\_unit              |    No    | Indicates if the group is allowed to manage backup units. Valid values are `true`, `false`.                                                                                                                         |
| create\_internet\_access          |    No    | Indicates if the group is allowed to create internet access. Valid values are `true`, `false`.                                                                                                                      |
| create\_k8s\_cluster              |    No    | Indicates if the group is allowed to create kubernetes cluster. Valid values are `true`, `false`.                                                                                                                   |
| create\_pcc                       |    No    | Indicates if the group is allowed to create pcc. Valid values are `true`, `false`.                                                                                                                                  |
| create\_flow\_log                 |    No    | Indicates if the group is allowed to create Flow Logs. Valid values are `true`, `false`.                                                                                                                            |
| access\_and\_manage\_monitoring   |    No    | Indicates if the group is allowed to access and manage monitoring related functionality (access metrics, CRUD on alarms, alarm-actions etc) using Monotoring-as-a-Service (MaaS). Valid values are `true`, `false`. |
| access\_and\_manage\_certificates |    No    | Indicates if the group is allowed to access and manage certificates. Valid values are `true`, `false`.                                                                                                              |
| members                           |    No    | The ionoscloud users associated with the group.                                                                                                                                                                     |
| id                                |    No    | The group ID.                                                                                                                                                                                                       |
| \*\*\*                            |          |                                                                                                                                                                                                                     |

### Changeable properties:

* create\_data\_center
* create\_snapshot
* reserve\_ip
* access\_activity\_log
* s3\_privilege
* create\_backup\_unit
* create\_internet\_access
* create\_k8s\_cluster
* create\_pcc
* members

## Examples

### To list resources:

```bash
puppet resource ionoscloud_group
```

> ***NOTE:*** If two resources have the same name only one of them will be shown.

### To create, update or delete a resource:

```ruby
ionoscloud_group { 'Puppet Test' :
  ensure              => present,
  create_data_center  => false,
  create_snapshot     => false,
  reserve_ip          => true,
  access_activity_log => true,
  members             => []
}
```

> ***NOTE:*** If two resources with the same name ar found an error will be thrown, this only applies to cases where the resource cannot be identified. Example: an error is thrown for two servers with the same name in the same datacenter, not for two servers with the same name, but in different datacenters.