The resource data source can be used to search for and return any existing IonosCloud resource and optionally their group associations. You can provide a string for the resource type (datacenter,image,snapshot,ipblock) and/or resource id parameters which will be queries against available resources. If a single match is found, it will be returned. If your search results in multiple matches, an error will be generated. When this happens, please refine your search string so that it is specific enough to return only one result.

Example Usage

Argument Reference

• resource_type - (Optional) The specific type of resources to retrieve information about.

• resource_id - (Optional) The ID of the specific resource to retrieve information about.

Attributes Reference

• id - UUID of the Resource

The s3 key data source can be used to search for and return an existing s3 key. You can provide a string id which will be compared with provisioned s3 keys. If a single match is found, it will be returned.

Example Usage

Argument Reference

The following arguments are supported:

• user_id - (Required)[string] The UUID of the user owning the S3 Key.

• id - (Required) ID of the s3 key you want to search for.

Attributes Reference

The following attributes are returned by the datasource:

• id - The id of the s3 key

• active - The state of the s3 key

• user_id - The ID of the user that owns the key

Manages users and list users and groups associated with that user.

Example Usage

Argument reference

• administrator - (Required)[Boolean] The group has permission to edit privileges on this resource.

• email - (Required)[string] An e-mail address for the user.

• first_name - (Required)[string] A first name for the user.

• force_sec_auth - (Required)[Boolean] Indicates if secure (two-factor) authentication should be enabled for the user (true) or not (false).

• last_name - (Required)[string] A last name for the user.

• password - (Required)[string] A password for the user.

• sec_auth_active - (Computed) Indicates if secure authentication is active for the user or not

• s3_canonical_user_id - (Computed) Canonical (S3) id of the user for a given identity

• active - (Optional)[Boolean] Indicates if the user is active

Import

Resource User can be imported using the resource id, e.g.

The users data source can be used to search for and return existing users.

Example Usage

Argument Reference

• email - (Optional) Email of an existing user that you want to search for.

• id - (Optional) ID of the user you want to search for.

Either email or id must be provided. If none, or both are provided, the datasource will return an error.

Attributes Reference

The following attributes are returned by the datasource:

• id - The id of the LAN.

• administrator - The group has permission to edit privileges on this resource.

• email - The e-mail address for the user.

• first_name - The first name for the user.

• force_sec_auth - Indicates if secure (two-factor) authentication should be enabled for the user (true) or not (false).

• last_name - The last name for the user.

• password - The password for the user.

• sec_auth_active - Indicates if secure authentication is active for the user or not

• s3_canonical_user_id - Canonical (S3) id of the user for a given identity

• active - Indicates if the user is active

The share data source can be used to search for and return an existing share object. You need to provide the group_id and resource_id to get the group resources for the shared resource.

Example Usage

data "ionoscloud_share" "share" {
  group_id = "groupId"
  resource_id = "resourceId"
  id			= "share uuid"
}

Argument Reference

The following arguments are supported:

• group_id - (Required)The ID of the specific group containing the resource to update.

• resource_id - (Required)The ID of the specific resource to update.

• id - (Required)The uuid of the share object

id, resource_id and group_id must be provided. If any of them are missing, the datasource will return an error.

Attributes Reference

The following attributes are returned by the datasource:

• id - The id of the share resource.

• group_id - The ID of the specific group containing the resource to update.

• resource_id - The ID of the specific resource to update.

• edit_privilege - The flag that specifies if the group has permission to edit privileges on this resource.

• share_privilege - The group has permission to share this resource.

The groups data source can be used to search for and return existing groups.

Example Usage

data "ionoscloud_group" "group_example" {
  name			= "my_group"
}

Argument Reference

• name - (Optional) Name of an existing group that you want to search for.

• id - (Optional) ID of the group you want to search for.

Either name or id must be provided. If none, or both are provided, the datasource will return an error.

Attributes Reference

The following attributes are returned by the datasource:

• id - The id of the LAN.

• name - A name for the group.

• create_datacenter - The group will be allowed to create virtual data centers.

• create_snapshot - The group will be allowed to create snapshots.

• reserve_ip - The group will be allowed to reserve IP addresses.

• access_activity_log - The group will be allowed to access the activity log.

• create_pcc - The group will be allowed to create pcc privilege.

• s3_privilege - The group will have S3 privilege.

• create_backup_unit - The group will be allowed to create backup unit privilege.

• create_internet_access - The group will be allowed to create internet access privilege.

• create_k8s_cluster - The group will be allowed to create kubernetes cluster privilege.

• user_id - The ID of the specific user to add to the group.

• users - List of users in group.

Manages shares and list shares permissions granted to the group members for each shared resource.

Example Usage

resource "ionoscloud_share" "share" {
  group_id = "groupId"
  resource_id = "resourceId"
  edit_privilege = true
  share_privilege = false
}

Argument reference

• edit_privilege - (Optional)[Boolean] The group has permission to edit privileges on this resource.

• group_id - (Required)[string] The ID of the specific group containing the resource to update.

• resource_id - (Required)[string] The ID of the specific resource to update.

• share_privilege - (Optional)[Boolean] The group has permission to share this resource.

Import

Resource Share can be imported using the resource id, e.g.

terraform import ionoscloud_share.myshare {group uuid}/{resource uuid}

Manages groups and group privileges on IonosCloud.

Example Usage

resource "ionoscloud_group" "group" {
  name = "my group"
  create_datacenter = true
  create_snapshot = true
  reserve_ip = true
  access_activity_log = false
  user_id="user_id"
}

##Argument reference

• name - (Required) [string] A name for the group.

• create_datacenter - (Optional) [Boolean] The group will be allowed to create virtual data centers.

• create_snapshot - (Optional) [Boolean] The group will be allowed to create snapshots.

• reserve_ip - (Optional) [Boolean] The group will be allowed to reserve IP addresses.

• access_activity_log - (Optional) [Boolean] The group will be allowed to access the activity log.

• create_pcc - (Optional) [Boolean] The group will be allowed to create pcc privilege.

• s3_privilege - (Optional) [Boolean] The group will have S3 privilege.

• create_backup_unit - (Optional) [Boolean] The group will be allowed to create backup unit privilege.

• create_internet_access - (Optional) [Boolean] The group will be allowed to create internet access privilege.

• create_k8s_cluster - (Optional) [Boolean] The group will be allowed to create kubernetes cluster privilege.

• user_id - (Optional) [string] The ID of the specific user to add to the group.

• users - (Computed) List of users in group. See user section.

Import

Resource Group can be imported using the resource id, e.g.

terraform import ionoscloud_group.mygroup {group uuid}

Manages an S3 Key on IonosCloud.

Example Usage

resource "ionoscloud_s3_key" "demo" {
  user_id    = <user-uuid>
  active     = true
}

Argument Reference

The following arguments are supported:

• user_id - (Required)[string] The UUID of the user owning the S3 Key.

• active - (Required)[boolean] Whether the S3 is active / enabled or not - Please keep in mind this is only required on create.

• secret_key - (Computed) Whether this key should be active or not

Import

An S3 Unit resource can be imported using its user id as well as its resource id, e.g.

terraform import ionoscloud_s3_key.demo {userId}/{s3KeyId}

This can be helpful when you want to import S3 Keys which you have already created manually or using other means, outside of terraform.