1. Packages
  2. Packages
  3. Ionoscloud
  4. API Docs
  5. getContracts
Viewing docs for IonosCloud v0.3.0
published on Wednesday, Apr 15, 2026 by ionos-cloud
Schema (JSON)
ionos-cloud/pulumi-ionoscloud

ionoscloud.getContracts

ionoscloud logo
Viewing docs for IonosCloud v0.3.0
published on Wednesday, Apr 15, 2026 by ionos-cloud
Schema (JSON)
ionos-cloud/pulumi-ionoscloud

    The contracts data source provides information about the contracts available in your IONOS Cloud account, including resource limits and other contract details.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@ionos-cloud/sdk-pulumi";

const example = ionoscloud.getContracts({});
export const contracts = example.then(example => example.contracts);

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_contracts()
pulumi.export("contracts", example.contracts)

    package main

import (
	"github.com/ionos-cloud/pulumi-ionoscloud/sdk/go/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := ionoscloud.GetContracts(ctx, map[string]interface{}{}, nil)
		if err != nil {
			return err
		}
		ctx.Export("contracts", example.Contracts)
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Ionoscloud.Pulumi.Ionoscloud;

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.Index.GetContracts.Invoke();

    return new Dictionary<string, object?>
    {
        ["contracts"] = example.Apply(getContractsResult => getContractsResult.Contracts),
    };
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = IonoscloudFunctions.getContracts(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference);

        ctx.export("contracts", example.contracts());
    }
}

    variables:
  example:
    fn::invoke:
      function: ionoscloud:getContracts
      arguments: {}
outputs:
  contracts: ${example.contracts}

    Example coming soon!

    The following attributes are returned by the datasource:

    Sure! Here’s the list of attributes formatted as requested:

    • contracts
      • contractNumber - The contract number.
      • owner - The contract owner’s user name.
      • status - The contract status.
      • regDomain - The registration domain of the contract.
      • resourceLimits
        • coresPerServer - The maximum number of cores per server.
        • ramPerServer - The maximum RAM per server in MB.
        • ramPerContract - The maximum RAM per contract in MB.
        • coresPerContract - The maximum number of cores per contract.
        • coresProvisioned - The number of cores provisioned.
        • dasVolumeProvisioned - The DAS volume provisioned.
        • hddLimitPerContract - The HDD limit per contract.
        • hddLimitPerVolume - The HDD limit per volume.
        • hddVolumeProvisioned - The HDD volume provisioned.
        • k8sClusterLimitTotal - The total Kubernetes cluster limit.
        • k8sClustersProvisioned - The number of Kubernetes clusters provisioned.
        • natGatewayLimitTotal - The total NAT gateway limit.
        • natGatewayProvisioned - The number of NAT gateways provisioned.
        • nlbLimitTotal - The total NLB limit.
        • nlbProvisioned - The number of NLBs provisioned.
        • ramProvisioned - The RAM provisioned.
        • reservableIps - The number of reservable IPs.
        • reservedIpsInUse - The number of reserved IPs in use.
        • reservedIpsOnContract - The number of reserved IPs on the contract.
        • ssdLimitPerContract - The SSD limit per contract.
        • ssdLimitPerVolume - The SSD limit per volume.
        • ssdVolumeProvisioned - The SSD volume provisioned.
        • securityGroupsPerVdc - The number of security groups per VDC.
        • securityGroupsPerResource - The number of security groups per resource.
        • rulesPerSecurityGroup - The number of rules per security group.

    Using getContracts

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getContracts(opts?: InvokeOptions): Promise<GetContractsResult>
function getContractsOutput(opts?: InvokeOptions): Output<GetContractsResult>
    def get_contracts(opts: Optional[InvokeOptions] = None) -> GetContractsResult
def get_contracts_output(opts: Optional[InvokeOptions] = None) -> Output[GetContractsResult]
    func GetContracts(ctx *Context, opts ...InvokeOption) (*GetContractsResult, error)
func GetContractsOutput(ctx *Context, opts ...InvokeOption) GetContractsResultOutput

    > Note: This function is named GetContracts in the Go SDK.

    public static class GetContracts 
{
    public static Task<GetContractsResult> InvokeAsync(InvokeOptions? opts = null)
    public static Output<GetContractsResult> Invoke(InvokeOptions? opts = null)
}
    public static CompletableFuture<GetContractsResult> getContracts(InvokeOptions options)
public static Output<GetContractsResult> getContracts(InvokeOptions options)

    fn::invoke:
  function: ionoscloud:index/getContracts:getContracts
  arguments:
    # arguments dictionary
    data "ionoscloud_getcontracts" "name" {
    # arguments
}

    getContracts Result

    The following output properties are available:

    Contracts List<Ionoscloud.GetContractsContract>
    Id string
    The provider-assigned unique ID for this managed resource.
    Contracts []GetContractsContract
    Id string
    The provider-assigned unique ID for this managed resource.
    contracts list(object)
    id string
    The provider-assigned unique ID for this managed resource.
    contracts List<GetContractsContract>
    id String
    The provider-assigned unique ID for this managed resource.
    contracts GetContractsContract[]
    id string
    The provider-assigned unique ID for this managed resource.
    contracts Sequence[GetContractsContract]
    id str
    The provider-assigned unique ID for this managed resource.
    contracts List<Property Map>
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    GetContractsContract

    ContractNumber int
    The contract number.
    Owner string
    The contract owner's user name.
    RegDomain string
    The registration domain of the contract.
    ResourceLimits Ionoscloud.GetContractsContractResourceLimits
    The resource limits of the contract.
    Status string
    The contract status.
    ContractNumber int
    The contract number.
    Owner string
    The contract owner's user name.
    RegDomain string
    The registration domain of the contract.
    ResourceLimits GetContractsContractResourceLimits
    The resource limits of the contract.
    Status string
    The contract status.
    contract_number number
    The contract number.
    owner string
    The contract owner's user name.
    reg_domain string
    The registration domain of the contract.
    resource_limits object
    The resource limits of the contract.
    status string
    The contract status.
    contractNumber Integer
    The contract number.
    owner String
    The contract owner's user name.
    regDomain String
    The registration domain of the contract.
    resourceLimits GetContractsContractResourceLimits
    The resource limits of the contract.
    status String
    The contract status.
    contractNumber number
    The contract number.
    owner string
    The contract owner's user name.
    regDomain string
    The registration domain of the contract.
    resourceLimits GetContractsContractResourceLimits
    The resource limits of the contract.
    status string
    The contract status.
    contract_number int
    The contract number.
    owner str
    The contract owner's user name.
    reg_domain str
    The registration domain of the contract.
    resource_limits GetContractsContractResourceLimits
    The resource limits of the contract.
    status str
    The contract status.
    contractNumber Number
    The contract number.
    owner String
    The contract owner's user name.
    regDomain String
    The registration domain of the contract.
    resourceLimits Property Map
    The resource limits of the contract.
    status String
    The contract status.

    GetContractsContractResourceLimits

    CoresPerContract int
    The maximum number of cores per contract.
    CoresPerServer int
    The maximum number of cores per server.
    CoresProvisioned int
    The number of cores provisioned.
    DasVolumeProvisioned int
    The DAS volume provisioned.
    HddLimitPerContract int
    The HDD limit per contract.
    HddLimitPerVolume int
    The HDD limit per volume.
    HddVolumeProvisioned int
    The HDD volume provisioned.
    K8sClusterLimitTotal int
    The total Kubernetes cluster limit.
    K8sClustersProvisioned int
    The number of Kubernetes clusters provisioned.
    NatGatewayLimitTotal int
    The total NAT gateway limit.
    NatGatewayProvisioned int
    The number of NAT gateways provisioned.
    NlbLimitTotal int
    The total NLB limit.
    NlbProvisioned int
    The number of NLBs provisioned.
    RamPerContract int
    The maximum RAM per contract in MB.
    RamPerServer int
    The maximum RAM per server in MB.
    RamProvisioned int
    The RAM provisioned.
    ReservableIps int
    The number of reservable IPs.
    ReservedIpsInUse int
    The number of reserved IPs in use.
    ReservedIpsOnContract int
    The number of reserved IPs on the contract.
    RulesPerSecurityGroup int
    The number of rules per security group.
    SecurityGroupsPerResource int
    The number of security groups per resource.
    SecurityGroupsPerVdc int
    The number of security groups per VDC.
    SsdLimitPerContract int
    The SSD limit per contract.
    SsdLimitPerVolume int
    The SSD limit per volume.
    SsdVolumeProvisioned int
    The SSD volume provisioned.
    CoresPerContract int
    The maximum number of cores per contract.
    CoresPerServer int
    The maximum number of cores per server.
    CoresProvisioned int
    The number of cores provisioned.
    DasVolumeProvisioned int
    The DAS volume provisioned.
    HddLimitPerContract int
    The HDD limit per contract.
    HddLimitPerVolume int
    The HDD limit per volume.
    HddVolumeProvisioned int
    The HDD volume provisioned.
    K8sClusterLimitTotal int
    The total Kubernetes cluster limit.
    K8sClustersProvisioned int
    The number of Kubernetes clusters provisioned.
    NatGatewayLimitTotal int
    The total NAT gateway limit.
    NatGatewayProvisioned int
    The number of NAT gateways provisioned.
    NlbLimitTotal int
    The total NLB limit.
    NlbProvisioned int
    The number of NLBs provisioned.
    RamPerContract int
    The maximum RAM per contract in MB.
    RamPerServer int
    The maximum RAM per server in MB.
    RamProvisioned int
    The RAM provisioned.
    ReservableIps int
    The number of reservable IPs.
    ReservedIpsInUse int
    The number of reserved IPs in use.
    ReservedIpsOnContract int
    The number of reserved IPs on the contract.
    RulesPerSecurityGroup int
    The number of rules per security group.
    SecurityGroupsPerResource int
    The number of security groups per resource.
    SecurityGroupsPerVdc int
    The number of security groups per VDC.
    SsdLimitPerContract int
    The SSD limit per contract.
    SsdLimitPerVolume int
    The SSD limit per volume.
    SsdVolumeProvisioned int
    The SSD volume provisioned.
    cores_per_contract number
    The maximum number of cores per contract.
    cores_per_server number
    The maximum number of cores per server.
    cores_provisioned number
    The number of cores provisioned.
    das_volume_provisioned number
    The DAS volume provisioned.
    hdd_limit_per_contract number
    The HDD limit per contract.
    hdd_limit_per_volume number
    The HDD limit per volume.
    hdd_volume_provisioned number
    The HDD volume provisioned.
    k8s_cluster_limit_total number
    The total Kubernetes cluster limit.
    k8s_clusters_provisioned number
    The number of Kubernetes clusters provisioned.
    nat_gateway_limit_total number
    The total NAT gateway limit.
    nat_gateway_provisioned number
    The number of NAT gateways provisioned.
    nlb_limit_total number
    The total NLB limit.
    nlb_provisioned number
    The number of NLBs provisioned.
    ram_per_contract number
    The maximum RAM per contract in MB.
    ram_per_server number
    The maximum RAM per server in MB.
    ram_provisioned number
    The RAM provisioned.
    reservable_ips number
    The number of reservable IPs.
    reserved_ips_in_use number
    The number of reserved IPs in use.
    reserved_ips_on_contract number
    The number of reserved IPs on the contract.
    rules_per_security_group number
    The number of rules per security group.
    security_groups_per_resource number
    The number of security groups per resource.
    security_groups_per_vdc number
    The number of security groups per VDC.
    ssd_limit_per_contract number
    The SSD limit per contract.
    ssd_limit_per_volume number
    The SSD limit per volume.
    ssd_volume_provisioned number
    The SSD volume provisioned.
    coresPerContract Integer
    The maximum number of cores per contract.
    coresPerServer Integer
    The maximum number of cores per server.
    coresProvisioned Integer
    The number of cores provisioned.
    dasVolumeProvisioned Integer
    The DAS volume provisioned.
    hddLimitPerContract Integer
    The HDD limit per contract.
    hddLimitPerVolume Integer
    The HDD limit per volume.
    hddVolumeProvisioned Integer
    The HDD volume provisioned.
    k8sClusterLimitTotal Integer
    The total Kubernetes cluster limit.
    k8sClustersProvisioned Integer
    The number of Kubernetes clusters provisioned.
    natGatewayLimitTotal Integer
    The total NAT gateway limit.
    natGatewayProvisioned Integer
    The number of NAT gateways provisioned.
    nlbLimitTotal Integer
    The total NLB limit.
    nlbProvisioned Integer
    The number of NLBs provisioned.
    ramPerContract Integer
    The maximum RAM per contract in MB.
    ramPerServer Integer
    The maximum RAM per server in MB.
    ramProvisioned Integer
    The RAM provisioned.
    reservableIps Integer
    The number of reservable IPs.
    reservedIpsInUse Integer
    The number of reserved IPs in use.
    reservedIpsOnContract Integer
    The number of reserved IPs on the contract.
    rulesPerSecurityGroup Integer
    The number of rules per security group.
    securityGroupsPerResource Integer
    The number of security groups per resource.
    securityGroupsPerVdc Integer
    The number of security groups per VDC.
    ssdLimitPerContract Integer
    The SSD limit per contract.
    ssdLimitPerVolume Integer
    The SSD limit per volume.
    ssdVolumeProvisioned Integer
    The SSD volume provisioned.
    coresPerContract number
    The maximum number of cores per contract.
    coresPerServer number
    The maximum number of cores per server.
    coresProvisioned number
    The number of cores provisioned.
    dasVolumeProvisioned number
    The DAS volume provisioned.
    hddLimitPerContract number
    The HDD limit per contract.
    hddLimitPerVolume number
    The HDD limit per volume.
    hddVolumeProvisioned number
    The HDD volume provisioned.
    k8sClusterLimitTotal number
    The total Kubernetes cluster limit.
    k8sClustersProvisioned number
    The number of Kubernetes clusters provisioned.
    natGatewayLimitTotal number
    The total NAT gateway limit.
    natGatewayProvisioned number
    The number of NAT gateways provisioned.
    nlbLimitTotal number
    The total NLB limit.
    nlbProvisioned number
    The number of NLBs provisioned.
    ramPerContract number
    The maximum RAM per contract in MB.
    ramPerServer number
    The maximum RAM per server in MB.
    ramProvisioned number
    The RAM provisioned.
    reservableIps number
    The number of reservable IPs.
    reservedIpsInUse number
    The number of reserved IPs in use.
    reservedIpsOnContract number
    The number of reserved IPs on the contract.
    rulesPerSecurityGroup number
    The number of rules per security group.
    securityGroupsPerResource number
    The number of security groups per resource.
    securityGroupsPerVdc number
    The number of security groups per VDC.
    ssdLimitPerContract number
    The SSD limit per contract.
    ssdLimitPerVolume number
    The SSD limit per volume.
    ssdVolumeProvisioned number
    The SSD volume provisioned.
    cores_per_contract int
    The maximum number of cores per contract.
    cores_per_server int
    The maximum number of cores per server.
    cores_provisioned int
    The number of cores provisioned.
    das_volume_provisioned int
    The DAS volume provisioned.
    hdd_limit_per_contract int
    The HDD limit per contract.
    hdd_limit_per_volume int
    The HDD limit per volume.
    hdd_volume_provisioned int
    The HDD volume provisioned.
    k8s_cluster_limit_total int
    The total Kubernetes cluster limit.
    k8s_clusters_provisioned int
    The number of Kubernetes clusters provisioned.
    nat_gateway_limit_total int
    The total NAT gateway limit.
    nat_gateway_provisioned int
    The number of NAT gateways provisioned.
    nlb_limit_total int
    The total NLB limit.
    nlb_provisioned int
    The number of NLBs provisioned.
    ram_per_contract int
    The maximum RAM per contract in MB.
    ram_per_server int
    The maximum RAM per server in MB.
    ram_provisioned int
    The RAM provisioned.
    reservable_ips int
    The number of reservable IPs.
    reserved_ips_in_use int
    The number of reserved IPs in use.
    reserved_ips_on_contract int
    The number of reserved IPs on the contract.
    rules_per_security_group int
    The number of rules per security group.
    security_groups_per_resource int
    The number of security groups per resource.
    security_groups_per_vdc int
    The number of security groups per VDC.
    ssd_limit_per_contract int
    The SSD limit per contract.
    ssd_limit_per_volume int
    The SSD limit per volume.
    ssd_volume_provisioned int
    The SSD volume provisioned.
    coresPerContract Number
    The maximum number of cores per contract.
    coresPerServer Number
    The maximum number of cores per server.
    coresProvisioned Number
    The number of cores provisioned.
    dasVolumeProvisioned Number
    The DAS volume provisioned.
    hddLimitPerContract Number
    The HDD limit per contract.
    hddLimitPerVolume Number
    The HDD limit per volume.
    hddVolumeProvisioned Number
    The HDD volume provisioned.
    k8sClusterLimitTotal Number
    The total Kubernetes cluster limit.
    k8sClustersProvisioned Number
    The number of Kubernetes clusters provisioned.
    natGatewayLimitTotal Number
    The total NAT gateway limit.
    natGatewayProvisioned Number
    The number of NAT gateways provisioned.
    nlbLimitTotal Number
    The total NLB limit.
    nlbProvisioned Number
    The number of NLBs provisioned.
    ramPerContract Number
    The maximum RAM per contract in MB.
    ramPerServer Number
    The maximum RAM per server in MB.
    ramProvisioned Number
    The RAM provisioned.
    reservableIps Number
    The number of reservable IPs.
    reservedIpsInUse Number
    The number of reserved IPs in use.
    reservedIpsOnContract Number
    The number of reserved IPs on the contract.
    rulesPerSecurityGroup Number
    The number of rules per security group.
    securityGroupsPerResource Number
    The number of security groups per resource.
    securityGroupsPerVdc Number
    The number of security groups per VDC.
    ssdLimitPerContract Number
    The SSD limit per contract.
    ssdLimitPerVolume Number
    The SSD limit per volume.
    ssdVolumeProvisioned Number
    The SSD volume provisioned.

    Package Details

    Repository
    ionoscloud ionos-cloud/pulumi-ionoscloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    Viewing docs for IonosCloud v0.3.0
    published on Wednesday, Apr 15, 2026 by ionos-cloud
    Schema (JSON)
    ionos-cloud/pulumi-ionoscloud
      Try Pulumi Cloud free. Your team will thank you.