NOTE:Please consider using Terraform IonosCloud Provider v6 releases that are using IONOS Cloud API Version 6, the latest stable API version. New features and improvements will be integrated in IONOS Cloud API Version 6.
Overview
The Terraform IonosCloud Provider provides you with access to the IONOS Cloud. The provider supports both simple and complex requests. It is designed for devops engineers and developers who are building their infrastructure in the IONOS Cloud . The provider wraps the IONOS Cloud GO SDK. All operations are performed over SSL and authenticated using your IONOS Cloud portal credentials. The provider can be used within an instance running in IONOS Cloud or directly over the Internet from any application that can send an HTTPS request and receive an HTTPS response.
Getting Started
An IONOS account is required for access to the Ionos Cloud via the ionoscloud terraform provider; credentials from your registration are used to authenticate against the IONOS Cloud API.
Installation
Terraform is needed to operate the ionoscloud provider:
NOTE: In order to use a speciffic version of this provider, please include the following block at the beginning of your terraform config files details:
1
provider "ionoscloud" {
2
version = "~> 5.0.4"
3
}
Copied!
Authentication
The username, password and optionally the api endpoint can be manually specified when initializing the provider
1
provider "ionoscloud" {
2
username = var.ionos_username
3
password = var.ionos_password
4
endpoint = var.ionos_api_endpoint
5
}
Copied!
Environment variables can also be used; the provider uses the following variables:
IONOS_USERNAME - to specify the username used to login
IONOS_PASSWORD - to specify the password
IONOS_API_URL - to specify the Ionos Cloud API endpoint (to be used for development/testing purposes only)
Warning: Make sure to follow the Information Security Best Practices when using credentials within your terraform configuration files.