index.md

page_title	subcategory	description
xenorchestra Provider

XENORCHESTRA Provider

The Xen Orchestra provider is used to interact with the resources supported by Xen Orchestra. The provider needs to be configured with the proper credentials before it can be used.

Requirements

• Terraform 0.12+
• Xen Orchestra 5.50.1

Example Usage

# Instruct terraform to download the provider on `terraform init`
terraform {
  required_providers {
    xenorchestra = {
      source = "vatesfr/xenorchestra"
    }
    xenorchestra_token_auth = {
      source = "vatesfr/xenorchestra"
    }
  }
}

# Configure the XenServer Provider
provider "xenorchestra" {
  # Must be ws or wss
  url      = "ws://hostname-of-server" # Or set XOA_URL environment variable
  username = "<username>"              # Or set XOA_USER environment variable
  password = "<password>"              # Or set XOA_PASSWORD environment variable

  # This is false by default and
  # will disable ssl verification if true.
  # This is useful if your deployment uses
  # a self signed certificate but should be
  # used sparingly!
  insecure = <false|true>              # Or set XOA_INSECURE environment variable to any value
}

provider "xenorchestra_token_auth" {
  # XOA_USER and XOA_PASSWORD cannot be set, nor can their arguments
  token = "<token from XO>" # or set XOA_TOKEN environment variable
}

Schema

Required

• url (String) Hostname of the xoa router. Can be set via the XOA_URL environment variable.

Optional

• insecure (Boolean) Whether SSL should be verified or not. Can be set via the XOA_INSECURE environment variable.
• password (String) Password for xoa api. Can be set via the XOA_PASSWORD environment variable.
• retry_max_time (String) If retry_mode is set, this specifies the duration for which the backoff method will continue retries. Can be set via the XOA_RETRY_MAX_TIME environment variable
• retry_mode (String) Specifies if retries should be attempted for requests that require eventual . Can be set via the XOA_RETRY_MODE environment variable.
• token (String) Password for xoa api. Can be set via the XOA_TOKEN environment variable.
• username (String) User account for xoa api. Can be set via the XOA_USER environment variable.