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

Example Usage

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.

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

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 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.