OVHCloud v2.0.7 published on Wednesday, Mar 19, 2025 by OVHcloud
ovh.CloudProject.getRancher
Explore with Pulumi AI
Retrieve information about a Managed Rancher Service in the given public cloud project.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ovh from "@pulumi/ovh";
const rancher = ovh.CloudProject.getRancher({
    id: "<Rancher service ID>",
    projectId: "<public cloud project ID>",
});
import pulumi
import pulumi_ovh as ovh
rancher = ovh.CloudProject.get_rancher(id="<Rancher service ID>",
    project_id="<public cloud project ID>")
package main
import (
	"github.com/ovh/pulumi-ovh/sdk/v2/go/ovh/cloudproject"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudproject.GetRancher(ctx, &cloudproject.GetRancherArgs{
			Id:        "<Rancher service ID>",
			ProjectId: "<public cloud project ID>",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ovh = Pulumi.Ovh;
return await Deployment.RunAsync(() => 
{
    var rancher = Ovh.CloudProject.GetRancher.Invoke(new()
    {
        Id = "<Rancher service ID>",
        ProjectId = "<public cloud project ID>",
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ovh.CloudProject.CloudProjectFunctions;
import com.pulumi.ovh.CloudProject.inputs.GetRancherArgs;
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 rancher = CloudProjectFunctions.getRancher(GetRancherArgs.builder()
            .id("<Rancher service ID>")
            .projectId("<public cloud project ID>")
            .build());
    }
}
variables:
  rancher:
    fn::invoke:
      function: ovh:CloudProject:getRancher
      arguments:
        id: <Rancher service ID>
        projectId: <public cloud project ID>
Using getRancher
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 getRancher(args: GetRancherArgs, opts?: InvokeOptions): Promise<GetRancherResult>
function getRancherOutput(args: GetRancherOutputArgs, opts?: InvokeOptions): Output<GetRancherResult>def get_rancher(id: Optional[str] = None,
                project_id: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetRancherResult
def get_rancher_output(id: Optional[pulumi.Input[str]] = None,
                project_id: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetRancherResult]func GetRancher(ctx *Context, args *GetRancherArgs, opts ...InvokeOption) (*GetRancherResult, error)
func GetRancherOutput(ctx *Context, args *GetRancherOutputArgs, opts ...InvokeOption) GetRancherResultOutput> Note: This function is named GetRancher in the Go SDK.
public static class GetRancher 
{
    public static Task<GetRancherResult> InvokeAsync(GetRancherArgs args, InvokeOptions? opts = null)
    public static Output<GetRancherResult> Invoke(GetRancherInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetRancherResult> getRancher(GetRancherArgs args, InvokeOptions options)
public static Output<GetRancherResult> getRancher(GetRancherArgs args, InvokeOptions options)
fn::invoke:
  function: ovh:CloudProject/getRancher:getRancher
  arguments:
    # arguments dictionaryThe following arguments are supported:
- id str
- Unique identifier
- project_id str
- Project ID
getRancher Result
The following output properties are available:
- CreatedAt string
- Date of the managed Rancher service creation
- CurrentState GetRancher Current State 
- Current configuration applied to the managed Rancher service
- CurrentTasks List<GetRancher Current Task> 
- Asynchronous operations ongoing on the managed Rancher service
- Id string
- Unique identifier
- ProjectId string
- Project ID
- ResourceStatus string
- Reflects the readiness of the managed Rancher service. A new target specification request will be accepted only in READYstatus
- TargetSpec GetRancher Target Spec 
- Last target specification of the managed Rancher service
- UpdatedAt string
- Date of the last managed Rancher service update
- CreatedAt string
- Date of the managed Rancher service creation
- CurrentState GetRancher Current State 
- Current configuration applied to the managed Rancher service
- CurrentTasks []GetRancher Current Task 
- Asynchronous operations ongoing on the managed Rancher service
- Id string
- Unique identifier
- ProjectId string
- Project ID
- ResourceStatus string
- Reflects the readiness of the managed Rancher service. A new target specification request will be accepted only in READYstatus
- TargetSpec GetRancher Target Spec 
- Last target specification of the managed Rancher service
- UpdatedAt string
- Date of the last managed Rancher service update
- createdAt String
- Date of the managed Rancher service creation
- currentState GetRancher Current State 
- Current configuration applied to the managed Rancher service
- currentTasks List<GetRancher Current Task> 
- Asynchronous operations ongoing on the managed Rancher service
- id String
- Unique identifier
- projectId String
- Project ID
- resourceStatus String
- Reflects the readiness of the managed Rancher service. A new target specification request will be accepted only in READYstatus
- targetSpec GetRancher Target Spec 
- Last target specification of the managed Rancher service
- updatedAt String
- Date of the last managed Rancher service update
- createdAt string
- Date of the managed Rancher service creation
- currentState GetRancher Current State 
- Current configuration applied to the managed Rancher service
- currentTasks GetRancher Current Task[] 
- Asynchronous operations ongoing on the managed Rancher service
- id string
- Unique identifier
- projectId string
- Project ID
- resourceStatus string
- Reflects the readiness of the managed Rancher service. A new target specification request will be accepted only in READYstatus
- targetSpec GetRancher Target Spec 
- Last target specification of the managed Rancher service
- updatedAt string
- Date of the last managed Rancher service update
- created_at str
- Date of the managed Rancher service creation
- current_state cloudproject.Get Rancher Current State 
- Current configuration applied to the managed Rancher service
- current_tasks Sequence[cloudproject.Get Rancher Current Task] 
- Asynchronous operations ongoing on the managed Rancher service
- id str
- Unique identifier
- project_id str
- Project ID
- resource_status str
- Reflects the readiness of the managed Rancher service. A new target specification request will be accepted only in READYstatus
- target_spec cloudproject.Get Rancher Target Spec 
- Last target specification of the managed Rancher service
- updated_at str
- Date of the last managed Rancher service update
- createdAt String
- Date of the managed Rancher service creation
- currentState Property Map
- Current configuration applied to the managed Rancher service
- currentTasks List<Property Map>
- Asynchronous operations ongoing on the managed Rancher service
- id String
- Unique identifier
- projectId String
- Project ID
- resourceStatus String
- Reflects the readiness of the managed Rancher service. A new target specification request will be accepted only in READYstatus
- targetSpec Property Map
- Last target specification of the managed Rancher service
- updatedAt String
- Date of the last managed Rancher service update
Supporting Types
GetRancherCurrentState   
- BootstrapPassword string
- Bootstrap password of the managed Rancher service, returned only on creation
- IpRestrictions List<GetRancher Current State Ip Restriction> 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- Name string
- Name of the managed Rancher service
- Networking
GetRancher Current State Networking 
- Networking properties of a managed Rancher service
- Plan string
- Plan of the managed Rancher service
- Region string
- Region of the managed Rancher service
- Url string
- URL of the managed Rancher service
- Usage
GetRancher Current State Usage 
- Latest metrics regarding the usage of the managed Rancher service
- Version string
- Version of the managed Rancher service
- BootstrapPassword string
- Bootstrap password of the managed Rancher service, returned only on creation
- IpRestrictions []GetRancher Current State Ip Restriction 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- Name string
- Name of the managed Rancher service
- Networking
GetRancher Current State Networking 
- Networking properties of a managed Rancher service
- Plan string
- Plan of the managed Rancher service
- Region string
- Region of the managed Rancher service
- Url string
- URL of the managed Rancher service
- Usage
GetRancher Current State Usage 
- Latest metrics regarding the usage of the managed Rancher service
- Version string
- Version of the managed Rancher service
- bootstrapPassword String
- Bootstrap password of the managed Rancher service, returned only on creation
- ipRestrictions List<GetRancher Current State Ip Restriction> 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name String
- Name of the managed Rancher service
- networking
GetRancher Current State Networking 
- Networking properties of a managed Rancher service
- plan String
- Plan of the managed Rancher service
- region String
- Region of the managed Rancher service
- url String
- URL of the managed Rancher service
- usage
GetRancher Current State Usage 
- Latest metrics regarding the usage of the managed Rancher service
- version String
- Version of the managed Rancher service
- bootstrapPassword string
- Bootstrap password of the managed Rancher service, returned only on creation
- ipRestrictions GetRancher Current State Ip Restriction[] 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name string
- Name of the managed Rancher service
- networking
GetRancher Current State Networking 
- Networking properties of a managed Rancher service
- plan string
- Plan of the managed Rancher service
- region string
- Region of the managed Rancher service
- url string
- URL of the managed Rancher service
- usage
GetRancher Current State Usage 
- Latest metrics regarding the usage of the managed Rancher service
- version string
- Version of the managed Rancher service
- bootstrap_password str
- Bootstrap password of the managed Rancher service, returned only on creation
- ip_restrictions Sequence[cloudproject.Get Rancher Current State Ip Restriction] 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name str
- Name of the managed Rancher service
- networking
cloudproject.Get Rancher Current State Networking 
- Networking properties of a managed Rancher service
- plan str
- Plan of the managed Rancher service
- region str
- Region of the managed Rancher service
- url str
- URL of the managed Rancher service
- usage
cloudproject.Get Rancher Current State Usage 
- Latest metrics regarding the usage of the managed Rancher service
- version str
- Version of the managed Rancher service
- bootstrapPassword String
- Bootstrap password of the managed Rancher service, returned only on creation
- ipRestrictions List<Property Map>
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name String
- Name of the managed Rancher service
- networking Property Map
- Networking properties of a managed Rancher service
- plan String
- Plan of the managed Rancher service
- region String
- Region of the managed Rancher service
- url String
- URL of the managed Rancher service
- usage Property Map
- Latest metrics regarding the usage of the managed Rancher service
- version String
- Version of the managed Rancher service
GetRancherCurrentStateIpRestriction     
- CidrBlock string
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- Description string
- Description of the allowed CIDR block
- CidrBlock string
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- Description string
- Description of the allowed CIDR block
- cidrBlock String
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description String
- Description of the allowed CIDR block
- cidrBlock string
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description string
- Description of the allowed CIDR block
- cidr_block str
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description str
- Description of the allowed CIDR block
- cidrBlock String
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description String
- Description of the allowed CIDR block
GetRancherCurrentStateNetworking    
- EgressCidr List<string>Blocks 
- Specifies the CIDR ranges for egress IP addresses used by Rancher. Ensure these ranges are allowed in any IP restrictions for services that Rancher will access.
- EgressCidr []stringBlocks 
- Specifies the CIDR ranges for egress IP addresses used by Rancher. Ensure these ranges are allowed in any IP restrictions for services that Rancher will access.
- egressCidr List<String>Blocks 
- Specifies the CIDR ranges for egress IP addresses used by Rancher. Ensure these ranges are allowed in any IP restrictions for services that Rancher will access.
- egressCidr string[]Blocks 
- Specifies the CIDR ranges for egress IP addresses used by Rancher. Ensure these ranges are allowed in any IP restrictions for services that Rancher will access.
- egress_cidr_ Sequence[str]blocks 
- Specifies the CIDR ranges for egress IP addresses used by Rancher. Ensure these ranges are allowed in any IP restrictions for services that Rancher will access.
- egressCidr List<String>Blocks 
- Specifies the CIDR ranges for egress IP addresses used by Rancher. Ensure these ranges are allowed in any IP restrictions for services that Rancher will access.
GetRancherCurrentStateUsage    
- Datetime string
- Date of the sample
- OrchestratedVcpus double
- Total number of vCPUs orchestrated by the managed Rancher service through the downstream clusters
- Datetime string
- Date of the sample
- OrchestratedVcpus float64
- Total number of vCPUs orchestrated by the managed Rancher service through the downstream clusters
- datetime String
- Date of the sample
- orchestratedVcpus Double
- Total number of vCPUs orchestrated by the managed Rancher service through the downstream clusters
- datetime string
- Date of the sample
- orchestratedVcpus number
- Total number of vCPUs orchestrated by the managed Rancher service through the downstream clusters
- datetime str
- Date of the sample
- orchestrated_vcpus float
- Total number of vCPUs orchestrated by the managed Rancher service through the downstream clusters
- datetime String
- Date of the sample
- orchestratedVcpus Number
- Total number of vCPUs orchestrated by the managed Rancher service through the downstream clusters
GetRancherCurrentTask   
GetRancherTargetSpec   
- IpRestrictions List<GetRancher Target Spec Ip Restriction> 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- Name string
- Name of the managed Rancher service
- Plan string
- Plan of the managed Rancher service. Available plans for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/plan
- Version string
- Version of the managed Rancher service. Available versions for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/version
- IpRestrictions []GetRancher Target Spec Ip Restriction 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- Name string
- Name of the managed Rancher service
- Plan string
- Plan of the managed Rancher service. Available plans for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/plan
- Version string
- Version of the managed Rancher service. Available versions for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/version
- ipRestrictions List<GetRancher Target Spec Ip Restriction> 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name String
- Name of the managed Rancher service
- plan String
- Plan of the managed Rancher service. Available plans for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/plan
- version String
- Version of the managed Rancher service. Available versions for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/version
- ipRestrictions GetRancher Target Spec Ip Restriction[] 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name string
- Name of the managed Rancher service
- plan string
- Plan of the managed Rancher service. Available plans for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/plan
- version string
- Version of the managed Rancher service. Available versions for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/version
- ip_restrictions Sequence[cloudproject.Get Rancher Target Spec Ip Restriction] 
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name str
- Name of the managed Rancher service
- plan str
- Plan of the managed Rancher service. Available plans for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/plan
- version str
- Version of the managed Rancher service. Available versions for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/version
- ipRestrictions List<Property Map>
- List of allowed CIDR blocks for a managed Rancher service's IP restrictions. When empty, any IP is allowed
- name String
- Name of the managed Rancher service
- plan String
- Plan of the managed Rancher service. Available plans for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/plan
- version String
- Version of the managed Rancher service. Available versions for an existing managed Rancher can be retrieved using GET /rancher/rancherID/capabilities/version
GetRancherTargetSpecIpRestriction     
- CidrBlock string
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- Description string
- Description of the allowed CIDR block
- CidrBlock string
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- Description string
- Description of the allowed CIDR block
- cidrBlock String
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description String
- Description of the allowed CIDR block
- cidrBlock string
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description string
- Description of the allowed CIDR block
- cidr_block str
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description str
- Description of the allowed CIDR block
- cidrBlock String
- Allowed CIDR block (/subnet is optional, if unspecified then /32 will be used)
- description String
- Description of the allowed CIDR block
Package Details
- Repository
- ovh ovh/pulumi-ovh
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the ovhTerraform Provider.