xcsh_discovery (Data Source)

Retrieves information about a Discovery resource in F5 Distributed Cloud for api to create discovery object for a site or virtual site in system namespace. configuration. This is a read-only data source.

~> Note: For more information, see the F5 Distributed Cloud API documentation.

Example Usage

# Discovery Data Source Example

terraform {
  required_version = ">= 1.0"

  required_providers {
    xcsh = {
      source  = "f5-sales-demo/xcsh"
      version = ">= 0.1.0"
    }
  }
}

# Look up an existing Discovery by name
data "xcsh_discovery" "example" {
  name      = "example-discovery"
  namespace = "staging"
}

output "discovery_id" {
  value = data.xcsh_discovery.example.id
}

Argument Reference

-> Syntax Rule: This provider uses OneOf groups for mutually exclusive options. Fields documented as “Optional Block” use block syntax field_name { ... }. Empty OneOf object attributes use field_name = {}; conditional selection uses condition ? {} : null. Boolean attributes (such as add_hsts and http_redirect) use = true or = false.

🔶 High Risk Operations — Some operations on this resource have high danger level. Destructive operations may require confirmation.

Metadata Argument Reference

• name - Required String
Name of the Discovery

• namespace - Required String
Namespace where the Discovery exists

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• annotations - Optional Map
Annotations applied to this resource

• cluster_id - Optional String Specified in endpoint object to discover only from this discovery object
Specify identifier for discovery cluster. This identifier can be

• description - Optional String
Description of the Discovery

• discovery_consul - Optional String
Discovery configuration for Hashicorp Consul

• discovery_k8s - Optional String
Configuration parameter for discovery K8S

• id - Optional String
Unique identifier for the resource

• labels - Optional Map
Labels applied to this resource

• no_cluster_id - Optional Object
Enable this option

• where - Optional String
NetworkSiteRefSelector defines a union of reference to site or reference to virtual_network or reference to virtual_site It is used to determine virtual network using following rules * Direct reference to virtual_network object * Site local network when referring to site object * All site local

• access_info - Optional String
Hashicorp Consul API server information

• publish_info - Optional String
Configuration parameter for publish info

• connection_info - Optional String
Configuration details to access discovery service REST API

• http_basic_auth_info - Optional String
Authentication parameters to access Hashicorp Consul

• api_server - Optional String
API server must be a fully qualified domain string and port specified as host:port pair

• tls_info - Optional String
TLS config for client of discovery service

• certificate - Optional String
Client certificate is PEM-encoded certificate or certificate-chain

• key_url - Optional String
SecretType is used in an object to indicate a sensitive/confidential field

• server_name - Optional String
ServerName is passed to the server for SNI and is used in the client to check server certificates against. If ServerName is empty, the hostname used to contact the server is used

• trusted_ca_url - Optional String
The URL or value for trusted Server CA certificate or certificate chain Certificates in PEM format including the PEM headers

• blindfold_secret_info - Optional String
BlindfoldSecretInfoType specifies information about the Secret managed by F5XC Secret Management

• clear_secret_info - Optional String
ClearSecretInfoType specifies information about the Secret that is not encrypted

• decryption_provider - Optional String
Name of the Secret Management Access object that contains information about the backend Secret Management service

• location - Optional String
Location is the uri_ref. It could be in URL format for string:/// Or it could be a path if the store provider is an HTTP/HTTPS location

• store_provider - Optional String
Name of the Secret Management Access object that contains information about the store to GET encrypted bytes This field needs to be provided only if the URL scheme is not string:///

• provider_ref - Optional String
Name of the Secret Management Access object that contains information about the store to GET encrypted bytes This field needs to be provided only if the URL scheme is not string:///

• url - Optional String
URL of the secret. Currently supported URL schemes is string:///. For string:/// scheme, Secret needs to be encoded Base64 format. When asked for this secret, caller will GET Secret bytes after Base64 decoding

• passwd_url - Optional String
SecretType is used in an object to indicate a sensitive/confidential field

• user_name - Optional String
username. Username in consul

• blindfold_secret_info - Optional String
BlindfoldSecretInfoType specifies information about the Secret managed by F5XC Secret Management

• clear_secret_info - Optional String
ClearSecretInfoType specifies information about the Secret that is not encrypted

• decryption_provider - Optional String
Name of the Secret Management Access object that contains information about the backend Secret Management service

• location - Optional String
Location is the uri_ref. It could be in URL format for string:/// Or it could be a path if the store provider is an HTTP/HTTPS location

• disable_spec - Optional Object
Enable this option

• publish - Optional Object
Enable this option

• access_info - Optional String
Configuration parameter for access info

• default_all - Optional Object
Configuration parameter for default all

• namespace_mapping - Optional String
Select the mapping between K8S namespaces from which services will be discovered and App Namespace to which the discovered services will be shared

• publish_info - Optional String
Configuration parameter for publish info

• connection_info - Optional String
Configuration details to access discovery service REST API

• isolated - Optional Object
Enable this option

• kubeconfig_url - Optional String
SecretType is used in an object to indicate a sensitive/confidential field

• reachable - Optional Object
Enable this option