ibm.getSatelliteCluster
Explore with Pulumi AI
Retrieve information about an existing Satellite cluster. You can then reference the fields of the data source in other resources within the same configuration using interpolation syntax. For more information, about Satellite cluster, see Setting up clusters to use with Satellite Config.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ibm from "@pulumi/ibm";
const cluster = ibm.getSatelliteCluster({
name: _var.cluster,
});
import pulumi
import pulumi_ibm as ibm
cluster = ibm.get_satellite_cluster(name=var["cluster"])
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := ibm.LookupSatelliteCluster(ctx, &ibm.LookupSatelliteClusterArgs{
Name: _var.Cluster,
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;
return await Deployment.RunAsync(() =>
{
var cluster = Ibm.GetSatelliteCluster.Invoke(new()
{
Name = @var.Cluster,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IbmFunctions;
import com.pulumi.ibm.inputs.GetSatelliteClusterArgs;
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 cluster = IbmFunctions.getSatelliteCluster(GetSatelliteClusterArgs.builder()
.name(var_.cluster())
.build());
}
}
variables:
cluster:
fn::invoke:
function: ibm:getSatelliteCluster
arguments:
name: ${var.cluster}
Attributes reference
In addition to all argument references list, you can access the following attribute references after your resource is created.
id
- (String) The unique identifier of the location.location
- (String) The name or ID of the location.state
- (String) The state of cluster.status
- (String) The status of cluster.server_url
- (String) The URL of the master.health
- (String) The health of cluster master.crn
- (String) The CRN for this satellite cluster.kube_version
- (String) The Kubernetes version, including at least themajor.minor
version. To see available versions, runibmcloud ks versions
.worker_count
- (String) The number of workers that are attached to the cluster.workers
- (String) The IDs of the workers that are attached to the cluster.worker_pools
- (List) The collection of worker nodes in a cluster.infrastructure_topology
- (String) The infrastructure topology status for this cluster.Nested scheme for
worker_pools
:name
- (String) The name of the worker pool.flavor
- (String) The flavor of the worker node.worker_count
- (String) The total number of workers.isolation
- (String) The isolation for the worker node.id
- (String) The ID of the cluster.default_worker_pool_labels
- (String) The labels on the default workerpool.host_labels
- (String) The host labels of the workers.zones
- (List) A nested block describing the zones of this worker_pool.Nested scheme for
zones
:zone
- (String) The name of the zone.workercount
- (String) The number of worker nodes in the current worker pool.
ingress_hostname
- (String) The Ingress hostname.ingress_secret
- (String) The Ingress secret.private_service_endpoint_url
- (String) The private service endpoint URL.public_service_endpoint_url
- (String) The public service endpoint URL.public_service_endpoint
- (Bool) Is public service endpoint enabled to make the master publicly accessible.private_service_endpoint
- (Bool) Is private service endpoint enabled to make the master privately accessible.resource_group_id
- (String) The ID of the resource group.resource_group_name
- (String) The name of the resource group.tags
- (String) The tags associated with cluster.
Using getSatelliteCluster
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 getSatelliteCluster(args: GetSatelliteClusterArgs, opts?: InvokeOptions): Promise<GetSatelliteClusterResult>
function getSatelliteClusterOutput(args: GetSatelliteClusterOutputArgs, opts?: InvokeOptions): Output<GetSatelliteClusterResult>
def get_satellite_cluster(id: Optional[str] = None,
name: Optional[str] = None,
resource_group_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetSatelliteClusterResult
def get_satellite_cluster_output(id: Optional[pulumi.Input[str]] = None,
name: Optional[pulumi.Input[str]] = None,
resource_group_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetSatelliteClusterResult]
func LookupSatelliteCluster(ctx *Context, args *LookupSatelliteClusterArgs, opts ...InvokeOption) (*LookupSatelliteClusterResult, error)
func LookupSatelliteClusterOutput(ctx *Context, args *LookupSatelliteClusterOutputArgs, opts ...InvokeOption) LookupSatelliteClusterResultOutput
> Note: This function is named LookupSatelliteCluster
in the Go SDK.
public static class GetSatelliteCluster
{
public static Task<GetSatelliteClusterResult> InvokeAsync(GetSatelliteClusterArgs args, InvokeOptions? opts = null)
public static Output<GetSatelliteClusterResult> Invoke(GetSatelliteClusterInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetSatelliteClusterResult> getSatelliteCluster(GetSatelliteClusterArgs args, InvokeOptions options)
public static Output<GetSatelliteClusterResult> getSatelliteCluster(GetSatelliteClusterArgs args, InvokeOptions options)
fn::invoke:
function: ibm:index/getSatelliteCluster:getSatelliteCluster
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
- The name or ID of the Satellite cluster.
- Id string
- Resource
Group stringId
- Name string
- The name or ID of the Satellite cluster.
- Id string
- Resource
Group stringId
- name String
- The name or ID of the Satellite cluster.
- id String
- resource
Group StringId
- name string
- The name or ID of the Satellite cluster.
- id string
- resource
Group stringId
- name str
- The name or ID of the Satellite cluster.
- id str
- resource_
group_ strid
- name String
- The name or ID of the Satellite cluster.
- id String
- resource
Group StringId
getSatelliteCluster Result
The following output properties are available:
- Crn string
- Health string
- Id string
- Infrastructure
Topology string - Ingress
Hostname string - Ingress
Secret string - Kube
Version string - Location string
- Name string
- Private
Service boolEndpoint - Private
Service stringEndpoint Url - Public
Service boolEndpoint - Public
Service stringEndpoint Url - Resource
Group stringId - Resource
Group stringName - Server
Url string - State string
- Status string
- List<string>
- Worker
Count double - Worker
Pools List<GetSatellite Cluster Worker Pool> - Workers List<string>
- Crn string
- Health string
- Id string
- Infrastructure
Topology string - Ingress
Hostname string - Ingress
Secret string - Kube
Version string - Location string
- Name string
- Private
Service boolEndpoint - Private
Service stringEndpoint Url - Public
Service boolEndpoint - Public
Service stringEndpoint Url - Resource
Group stringId - Resource
Group stringName - Server
Url string - State string
- Status string
- []string
- Worker
Count float64 - Worker
Pools []GetSatellite Cluster Worker Pool Type - Workers []string
- crn String
- health String
- id String
- infrastructure
Topology String - ingress
Hostname String - ingress
Secret String - kube
Version String - location String
- name String
- private
Service BooleanEndpoint - private
Service StringEndpoint Url - public
Service BooleanEndpoint - public
Service StringEndpoint Url - resource
Group StringId - resource
Group StringName - server
Url String - state String
- status String
- List<String>
- worker
Count Double - worker
Pools List<GetSatellite Cluster Worker Pool> - workers List<String>
- crn string
- health string
- id string
- infrastructure
Topology string - ingress
Hostname string - ingress
Secret string - kube
Version string - location string
- name string
- private
Service booleanEndpoint - private
Service stringEndpoint Url - public
Service booleanEndpoint - public
Service stringEndpoint Url - resource
Group stringId - resource
Group stringName - server
Url string - state string
- status string
- string[]
- worker
Count number - worker
Pools GetSatellite Cluster Worker Pool[] - workers string[]
- crn str
- health str
- id str
- infrastructure_
topology str - ingress_
hostname str - ingress_
secret str - kube_
version str - location str
- name str
- private_
service_ boolendpoint - private_
service_ strendpoint_ url - public_
service_ boolendpoint - public_
service_ strendpoint_ url - resource_
group_ strid - resource_
group_ strname - server_
url str - state str
- status str
- Sequence[str]
- worker_
count float - worker_
pools Sequence[GetSatellite Cluster Worker Pool] - workers Sequence[str]
- crn String
- health String
- id String
- infrastructure
Topology String - ingress
Hostname String - ingress
Secret String - kube
Version String - location String
- name String
- private
Service BooleanEndpoint - private
Service StringEndpoint Url - public
Service BooleanEndpoint - public
Service StringEndpoint Url - resource
Group StringId - resource
Group StringName - server
Url String - state String
- status String
- List<String>
- worker
Count Number - worker
Pools List<Property Map> - workers List<String>
Supporting Types
GetSatelliteClusterWorkerPool
- Default
Worker Dictionary<string, string>Pool Labels - Flavour string
- Host
Labels Dictionary<string, string> - Id string
- Isolation string
- Name string
- The name or ID of the Satellite cluster.
- Size
Per doubleZone - State string
- Zones
List<Get
Satellite Cluster Worker Pool Zone>
- Default
Worker map[string]stringPool Labels - Flavour string
- Host
Labels map[string]string - Id string
- Isolation string
- Name string
- The name or ID of the Satellite cluster.
- Size
Per float64Zone - State string
- Zones
[]Get
Satellite Cluster Worker Pool Zone
- default
Worker Map<String,String>Pool Labels - flavour String
- host
Labels Map<String,String> - id String
- isolation String
- name String
- The name or ID of the Satellite cluster.
- size
Per DoubleZone - state String
- zones
List<Get
Satellite Cluster Worker Pool Zone>
- default
Worker {[key: string]: string}Pool Labels - flavour string
- host
Labels {[key: string]: string} - id string
- isolation string
- name string
- The name or ID of the Satellite cluster.
- size
Per numberZone - state string
- zones
Get
Satellite Cluster Worker Pool Zone[]
- default_
worker_ Mapping[str, str]pool_ labels - flavour str
- host_
labels Mapping[str, str] - id str
- isolation str
- name str
- The name or ID of the Satellite cluster.
- size_
per_ floatzone - state str
- zones
Sequence[Get
Satellite Cluster Worker Pool Zone]
- default
Worker Map<String>Pool Labels - flavour String
- host
Labels Map<String> - id String
- isolation String
- name String
- The name or ID of the Satellite cluster.
- size
Per NumberZone - state String
- zones List<Property Map>
GetSatelliteClusterWorkerPoolZone
- Worker
Count double - Zone string
- Worker
Count float64 - Zone string
- worker
Count Double - zone String
- worker
Count number - zone string
- worker_
count float - zone str
- worker
Count Number - zone String
Package Details
- Repository
- ibm ibm-cloud/terraform-provider-ibm
- License
- Notes
- This Pulumi package is based on the
ibm
Terraform Provider.