1. Packages
  2. Ionoscloud Provider
  3. API Docs
  4. getContracts
ionoscloud 6.7.7 published on Tuesday, May 20, 2025 by ionos-cloud

ionoscloud.getContracts

Explore with Pulumi AI

ionoscloud logo
ionoscloud 6.7.7 published on Tuesday, May 20, 2025 by ionos-cloud

    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 "@pulumi/ionoscloud";
    
    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/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/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 = Pulumi.Ionoscloud;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Ionoscloud.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();
    
            ctx.export("contracts", example.applyValue(getContractsResult -> getContractsResult.contracts()));
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: ionoscloud:getContracts
          arguments: {}
    outputs:
      contracts: ${example.contracts}
    

    The following attributes are returned by the datasource:

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

    • contracts
      • contract_number - The contract number.
      • owner - The contract owner’s user name.
      • status - The contract status.
      • reg_domain - The registration domain of the contract.
      • resource_limits
        • cores_per_server - The maximum number of cores per server.
        • ram_per_server - The maximum RAM per server in MB.
        • ram_per_contract - The maximum RAM per contract in MB.
        • cores_per_contract - The maximum number of cores per contract.
        • cores_provisioned - The number of cores provisioned.
        • das_volume_provisioned - The DAS volume provisioned.
        • hdd_limit_per_contract - The HDD limit per contract.
        • hdd_limit_per_volume - The HDD limit per volume.
        • hdd_volume_provisioned - The HDD volume provisioned.
        • k8s_cluster_limit_total - The total Kubernetes cluster limit.
        • k8s_clusters_provisioned - The number of Kubernetes clusters provisioned.
        • nat_gateway_limit_total - The total NAT gateway limit.
        • nat_gateway_provisioned - The number of NAT gateways provisioned.
        • nlb_limit_total - The total NLB limit.
        • nlb_provisioned - The number of NLBs provisioned.
        • ram_provisioned - The RAM provisioned.
        • reservable_ips - The number of reservable IPs.
        • reserved_ips_in_use - The number of reserved IPs in use.
        • reserved_ips_on_contract - The number of reserved IPs on the contract.
        • ssd_limit_per_contract - The SSD limit per contract.
        • ssd_limit_per_volume - The SSD limit per volume.
        • ssd_volume_provisioned - The SSD volume provisioned.
        • security_groups_per_vdc - The number of security groups per VDC.
        • security_groups_per_resource - The number of security groups per resource.
        • rules_per_security_group - 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

    getContracts Result

    The following output properties are available:

    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 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 double
    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 float64
    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 Double
    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 float
    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 double
    The maximum number of cores per contract.
    CoresPerServer double
    The maximum number of cores per server.
    CoresProvisioned double
    The number of cores provisioned.
    DasVolumeProvisioned double
    The DAS volume provisioned.
    HddLimitPerContract double
    The HDD limit per contract.
    HddLimitPerVolume double
    The HDD limit per volume.
    HddVolumeProvisioned double
    The HDD volume provisioned.
    K8sClusterLimitTotal double
    The total Kubernetes cluster limit.
    K8sClustersProvisioned double
    The number of Kubernetes clusters provisioned.
    NatGatewayLimitTotal double
    The total NAT gateway limit.
    NatGatewayProvisioned double
    The number of NAT gateways provisioned.
    NlbLimitTotal double
    The total NLB limit.
    NlbProvisioned double
    The number of NLBs provisioned.
    RamPerContract double
    The maximum RAM per contract in MB.
    RamPerServer double
    The maximum RAM per server in MB.
    RamProvisioned double
    The RAM provisioned.
    ReservableIps double
    The number of reservable IPs.
    ReservedIpsInUse double
    The number of reserved IPs in use.
    ReservedIpsOnContract double
    The number of reserved IPs on the contract.
    RulesPerSecurityGroup double
    The number of rules per security group.
    SecurityGroupsPerResource double
    The number of security groups per resource.
    SecurityGroupsPerVdc double
    The number of security groups per VDC.
    SsdLimitPerContract double
    The SSD limit per contract.
    SsdLimitPerVolume double
    The SSD limit per volume.
    SsdVolumeProvisioned double
    The SSD volume provisioned.
    CoresPerContract float64
    The maximum number of cores per contract.
    CoresPerServer float64
    The maximum number of cores per server.
    CoresProvisioned float64
    The number of cores provisioned.
    DasVolumeProvisioned float64
    The DAS volume provisioned.
    HddLimitPerContract float64
    The HDD limit per contract.
    HddLimitPerVolume float64
    The HDD limit per volume.
    HddVolumeProvisioned float64
    The HDD volume provisioned.
    K8sClusterLimitTotal float64
    The total Kubernetes cluster limit.
    K8sClustersProvisioned float64
    The number of Kubernetes clusters provisioned.
    NatGatewayLimitTotal float64
    The total NAT gateway limit.
    NatGatewayProvisioned float64
    The number of NAT gateways provisioned.
    NlbLimitTotal float64
    The total NLB limit.
    NlbProvisioned float64
    The number of NLBs provisioned.
    RamPerContract float64
    The maximum RAM per contract in MB.
    RamPerServer float64
    The maximum RAM per server in MB.
    RamProvisioned float64
    The RAM provisioned.
    ReservableIps float64
    The number of reservable IPs.
    ReservedIpsInUse float64
    The number of reserved IPs in use.
    ReservedIpsOnContract float64
    The number of reserved IPs on the contract.
    RulesPerSecurityGroup float64
    The number of rules per security group.
    SecurityGroupsPerResource float64
    The number of security groups per resource.
    SecurityGroupsPerVdc float64
    The number of security groups per VDC.
    SsdLimitPerContract float64
    The SSD limit per contract.
    SsdLimitPerVolume float64
    The SSD limit per volume.
    SsdVolumeProvisioned float64
    The SSD volume provisioned.
    coresPerContract Double
    The maximum number of cores per contract.
    coresPerServer Double
    The maximum number of cores per server.
    coresProvisioned Double
    The number of cores provisioned.
    dasVolumeProvisioned Double
    The DAS volume provisioned.
    hddLimitPerContract Double
    The HDD limit per contract.
    hddLimitPerVolume Double
    The HDD limit per volume.
    hddVolumeProvisioned Double
    The HDD volume provisioned.
    k8sClusterLimitTotal Double
    The total Kubernetes cluster limit.
    k8sClustersProvisioned Double
    The number of Kubernetes clusters provisioned.
    natGatewayLimitTotal Double
    The total NAT gateway limit.
    natGatewayProvisioned Double
    The number of NAT gateways provisioned.
    nlbLimitTotal Double
    The total NLB limit.
    nlbProvisioned Double
    The number of NLBs provisioned.
    ramPerContract Double
    The maximum RAM per contract in MB.
    ramPerServer Double
    The maximum RAM per server in MB.
    ramProvisioned Double
    The RAM provisioned.
    reservableIps Double
    The number of reservable IPs.
    reservedIpsInUse Double
    The number of reserved IPs in use.
    reservedIpsOnContract Double
    The number of reserved IPs on the contract.
    rulesPerSecurityGroup Double
    The number of rules per security group.
    securityGroupsPerResource Double
    The number of security groups per resource.
    securityGroupsPerVdc Double
    The number of security groups per VDC.
    ssdLimitPerContract Double
    The SSD limit per contract.
    ssdLimitPerVolume Double
    The SSD limit per volume.
    ssdVolumeProvisioned Double
    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 float
    The maximum number of cores per contract.
    cores_per_server float
    The maximum number of cores per server.
    cores_provisioned float
    The number of cores provisioned.
    das_volume_provisioned float
    The DAS volume provisioned.
    hdd_limit_per_contract float
    The HDD limit per contract.
    hdd_limit_per_volume float
    The HDD limit per volume.
    hdd_volume_provisioned float
    The HDD volume provisioned.
    k8s_cluster_limit_total float
    The total Kubernetes cluster limit.
    k8s_clusters_provisioned float
    The number of Kubernetes clusters provisioned.
    nat_gateway_limit_total float
    The total NAT gateway limit.
    nat_gateway_provisioned float
    The number of NAT gateways provisioned.
    nlb_limit_total float
    The total NLB limit.
    nlb_provisioned float
    The number of NLBs provisioned.
    ram_per_contract float
    The maximum RAM per contract in MB.
    ram_per_server float
    The maximum RAM per server in MB.
    ram_provisioned float
    The RAM provisioned.
    reservable_ips float
    The number of reservable IPs.
    reserved_ips_in_use float
    The number of reserved IPs in use.
    reserved_ips_on_contract float
    The number of reserved IPs on the contract.
    rules_per_security_group float
    The number of rules per security group.
    security_groups_per_resource float
    The number of security groups per resource.
    security_groups_per_vdc float
    The number of security groups per VDC.
    ssd_limit_per_contract float
    The SSD limit per contract.
    ssd_limit_per_volume float
    The SSD limit per volume.
    ssd_volume_provisioned float
    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/terraform-provider-ionoscloud
    License
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    ionoscloud 6.7.7 published on Tuesday, May 20, 2025 by ionos-cloud