Skip to content

Commit

Permalink
deploy pc resource docs and pc details data sources docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Haroon-Dweikat-Ntx committed Dec 23, 2024
1 parent e309ab8 commit 1fa9f20
Show file tree
Hide file tree
Showing 3 changed files with 503 additions and 0 deletions.
158 changes: 158 additions & 0 deletions website/docs/d/pc_v2.html.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
---
layout: "nutanix"
page_title: "NUTANIX: nutanix_pc_v2 "
sidebar_current: "docs-nutanix-pc-v2"
description: |-
Get the requested domain manager (Prism Central) entity
---

# nutanix_pc_v2

Fetches the attributes associated with the domain manager (Prism Central) resource based on the provided external identifier. It includes attributes like config, network, node and other information such as size, environment and resource specifications.

## Example Usage

```hcl
data "nutanix_pc_v2" "pc"{
ext_id = "<pc_external_id>"
}
```

## Argument Reference
The following arguments are supported:

* `ext_id`: - The external identifier of the domain manager (Prism Central) entity.

## Attributes Reference
The following attributes are exported:

* `tenant_id`: - A globally unique identifier that represents the tenant that owns this entity. The system automatically assigns it, and it and is immutable from an API consumer perspective (some use cases may cause this Id to change - For instance, a use case may require the transfer of ownership of the entity, but these cases are handled automatically on the server).
* `ext_id`: - A globally unique identifier of an instance that is suitable for external consumption.
* `links`: - A HATEOAS style link for the response. Each link contains a user-friendly name identifying the link and an address for retrieving the particular resource.
* `config`: - Domain manager (Prism Central) cluster configuration details.
* `is_registered_with_hosting_cluster`: - Boolean value indicating if the domain manager (Prism Central) is registered with the hosting cluster, that is, Prism Element.
* `network`: - Domain manager (Prism Central) network configuration details.
* `hosting_cluster_ext_id`: - The external identifier of the cluster hosting the domain manager (Prism Central) instance.
* `should_enable_high_availability`: - This configuration enables Prism Central to be deployed in scale-out mode.
* `node_ext_ids`: - Domain manager (Prism Central) nodes external identifier.

### Config
The config argument supports the following :

* `should_enable_lockdown_mode`: - A boolean value indicating whether to enable lockdown mode for a cluster.
* `build_info`: -Currently representing the build information to be used for the cluster creation.
* `name`: - Name of the domain manager (Prism Central).
* `size`: - Domain manager (Prism Central) size is an enumeration of starter, small, large, or extra large starter values. possible values are:
* `SMALL` : Domain manager (Prism Central) of size small.
* `LARGE` : Domain manager (Prism Central) of size large.
* `EXTRALARGE` : Domain manager (Prism Central) of size extra large.
* `STARTER` : Domain manager (Prism Central) of size starter.
* `bootstrap_config`: - Bootstrap configuration details for the domain manager (Prism Central).
* `resource_config`: - This configuration is used to provide the resource-related details like container external identifiers, number of VCPUs, memory size, data disk size of the domain manager (Prism Central). In the case of a multi-node setup, the sum of resources like number of VCPUs, memory size and data disk size are provided.

#### Build Info
The `build_info` argument supports the following:

* `version`: - Software version.

#### Bootstrap Config
The `bootstrap_config` argument supports the following:

* `environment_info`: - Environment information for the domain manager (Prism Central) cluster.

##### Environment Info
The `environment_info` argument supports the following:

* `type`: - Enums denoting the environment type of the PC, that is, on-prem PC or cloud PC.
Following are the supported entity types:
* `ONPREM` : On-prem environment.
* `NTNX_CLOUD` : Nutanix cloud environment.
* `provider_type`: - Enums denoting the provider type of the PC, that is, AHV or ESXi.
Following are the supported provider types:
* `VSPHERE` : Vsphere cloud provider.
* `AZURE` : Azure cloud provider.
* `NTNX` : Nutanix cloud provider.
* `GCP` : GCP cloud provider.
* `AWS` : AWS cloud provider.
* `provisioning_type`: - Enums denoting the instance type of the cloud PC. It indicates whether the PC is created on bare-metal or on a cloud-provisioned VM. Hence, it supports two possible values:
* `NTNX` : Nutanix instance.
* `NATIVE` : Native instance.

#### Resource Config
The `resource_config` argument supports the following:

* `num_vcpus`: - This property is used for readOnly purposes to display Prism Central number of VCPUs allocation.
* `memory_size_bytes`: - This property is used for readOnly purposes to display Prism Central RAM allocation at the cluster level.
* `data_disk_size_bytes`: - This property is used for readOnly purposes to display Prism Central data disk size allocation at a cluster level.
* `container_ext_ids`: - The external identifier of the container that will be used to create the domain manager (Prism Central) cluster.

### Network
the `network` argument supports the following:

* `external_address`: - An unique address that identifies a device on the internet or a local network in IPv4 or IPv6 format.
* `name_servers`: - List of name servers on a cluster. This is part of payload for both cluster create & update operations. For create operation, only ipv4 address / fqdn values are supported currently.
* `ntp_servers`: - List of NTP servers on a cluster. This is part of payload for both cluster create & update operations. For create operation, only ipv4 address / fqdn values are supported currently.
* `fqdn`: - Cluster fully qualified domain name. This is part of payload for cluster update operation only.
* `external_networks`: - This configuration is used to manage Prism Central.

#### External Address
The `external_address` argument supports the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.

#### Name Servers, NTP Servers
The `name_servers` and `ntp_servers` arguments support the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.
* `fqdn`: - A fully qualified domain name that specifies its exact location in the tree hierarchy of the Domain Name System.

#### Internal Networks
The `internal_networks` and `external_networks` arguments support the following:

* `default_gateway`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `subnet_mask`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `ip_ranges`: - Range of IPs used for Prism Central network setup.

#### External Networks
The `external_networks` argument supports the following:

* `default_gateway`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `subnet_mask`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `ip_ranges`: - Range of IPs used for Prism Central network setup.
* `network_ext_id`: - The network external identifier to which Domain Manager (Prism Central) is to be deployed or is already configured.

#### Default Gateway, Subnet Mask
The `default_gateway`and `subnet_mask` arguments support the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.
* `fqdn`: - A fully qualified domain name that specifies its exact location in the tree hierarchy of the Domain Name System.

#### IP Ranges
The `ip_ranges` argument supports the following:

* `begin`: - The beginning IP address of the range.
* `end`: - The ending IP address of the range.

#### begin, end
The `begin` and `end` arguments support the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.

#### IpV4, IpV6
The `ipv4` and `ipv6` arguments support the following:

* `value`: - The IPv4/IPv6 address of the host.
* `prefix_length`: - The prefix length of the network to which this host IPv4/IPv6 address belongs.

#### FQDN
The `fqdn` argument supports the following:

* `value`: - The fully qualified domain name of the host.

See detailed information in [Nutanix Deploy PC Docs](https://developers.nutanix.com/api-reference?namespace=prism&version=v4.0#tag/DomainManager/operation/createDomainManager).
159 changes: 159 additions & 0 deletions website/docs/d/pcs_v2.html.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,159 @@
---
layout: "nutanix"
page_title: "NUTANIX: nutanix_pcs_v2 "
sidebar_current: "docs-nutanix-pcs-v2"
description: |-
Returns a list of elements representing the domain manager (Prism Central) instance.
---

# nutanix_pcs_v2

Returns a list of elements representing the domain manager (Prism Central) instance.

## Example Usage

```hcl
data "nutanix_pcs_v2" "pcs"{}
```

## Argument Reference
The following arguments are supported:

* `select`: - URL query parameter that allows clients to request a specific set of properties for each entity or complex type. Expression specified with the \$select must conform to the OData V4.01 URL conventions. If a \$select expression consists of a single select item that is an asterisk (i.e., *), then all properties on the matching resource will be returned. supported values are:
* `config`
* `extId`


## Attributes Reference
The following attributes are exported:

* `tenant_id`: - A globally unique identifier that represents the tenant that owns this entity. The system automatically assigns it, and it and is immutable from an API consumer perspective (some use cases may cause this Id to change - For instance, a use case may require the transfer of ownership of the entity, but these cases are handled automatically on the server).
* `ext_id`: - A globally unique identifier of an instance that is suitable for external consumption.
* `links`: - A HATEOAS style link for the response. Each link contains a user-friendly name identifying the link and an address for retrieving the particular resource.
* `config`: - Domain manager (Prism Central) cluster configuration details.
* `is_registered_with_hosting_cluster`: - Boolean value indicating if the domain manager (Prism Central) is registered with the hosting cluster, that is, Prism Element.
* `network`: - Domain manager (Prism Central) network configuration details.
* `hosting_cluster_ext_id`: - The external identifier of the cluster hosting the domain manager (Prism Central) instance.
* `should_enable_high_availability`: - This configuration enables Prism Central to be deployed in scale-out mode.
* `node_ext_ids`: - Domain manager (Prism Central) nodes external identifier.

### Config
The config argument supports the following:

* `should_enable_lockdown_mode`: - A boolean value indicating whether to enable lockdown mode for a cluster.
* `build_info`: -Currently representing the build information to be used for the cluster creation.
* `name`: - Name of the domain manager (Prism Central).
* `size`: - Domain manager (Prism Central) size is an enumeration of starter, small, large, or extra large starter values. possible values are:
* `SMALL` : Domain manager (Prism Central) of size small.
* `LARGE` : Domain manager (Prism Central) of size large.
* `EXTRALARGE` : Domain manager (Prism Central) of size extra large.
* `STARTER` : Domain manager (Prism Central) of size starter.
* `bootstrap_config`: - Bootstrap configuration details for the domain manager (Prism Central).
* `resource_config`: - This configuration is used to provide the resource-related details like container external identifiers, number of VCPUs, memory size, data disk size of the domain manager (Prism Central). In the case of a multi-node setup, the sum of resources like number of VCPUs, memory size and data disk size are provided.

#### Build Info
The `build_info` argument supports the following:

* `version`: - Software version.

#### Bootstrap Config
The `bootstrap_config` argument supports the following:

* `environment_info`: - Environment information for the domain manager (Prism Central) cluster.

##### Environment Info
The `environment_info` argument supports the following:

* `type`: - Enums denoting the environment type of the PC, that is, on-prem PC or cloud PC.
Following are the supported entity types:
* `ONPREM` : On-prem environment.
* `NTNX_CLOUD` : Nutanix cloud environment.
* `provider_type`: - Enums denoting the provider type of the PC, that is, AHV or ESXi.
Following are the supported provider types:
* `VSPHERE` : Vsphere cloud provider.
* `AZURE` : Azure cloud provider.
* `NTNX` : Nutanix cloud provider.
* `GCP` : GCP cloud provider.
* `AWS` : AWS cloud provider.
* `provisioning_type`: - Enums denoting the instance type of the cloud PC. It indicates whether the PC is created on bare-metal or on a cloud-provisioned VM. Hence, it supports two possible values:
* `NTNX` : Nutanix instance.
* `NATIVE` : Native instance.

#### Resource Config
The `resource_config` argument supports the following:

* `num_vcpus`: - This property is used for readOnly purposes to display Prism Central number of VCPUs allocation.
* `memory_size_bytes`: - This property is used for readOnly purposes to display Prism Central RAM allocation at the cluster level.
* `data_disk_size_bytes`: - This property is used for readOnly purposes to display Prism Central data disk size allocation at a cluster level.
* `container_ext_ids`: - The external identifier of the container that will be used to create the domain manager (Prism Central) cluster.

### Network
the `network` argument supports the following:

* `external_address`: - An unique address that identifies a device on the internet or a local network in IPv4 or IPv6 format.
* `name_servers`: - List of name servers on a cluster. This is part of payload for both cluster create & update operations. For create operation, only ipv4 address / fqdn values are supported currently.
* `ntp_servers`: - List of NTP servers on a cluster. This is part of payload for both cluster create & update operations. For create operation, only ipv4 address / fqdn values are supported currently.
* `fqdn`: - Cluster fully qualified domain name. This is part of payload for cluster update operation only.
* `external_networks`: - This configuration is used to manage Prism Central.

#### External Address
The `external_address` argument supports the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.

#### Name Servers, NTP Servers
The `name_servers` and `ntp_servers` arguments support the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.
* `fqdn`: - A fully qualified domain name that specifies its exact location in the tree hierarchy of the Domain Name System.

#### Internal Networks
The `internal_networks` and `external_networks` arguments support the following:

* `default_gateway`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `subnet_mask`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `ip_ranges`: - Range of IPs used for Prism Central network setup.

#### External Networks
The `external_networks` argument supports the following:

* `default_gateway`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `subnet_mask`: - An unique address that identifies a device on the internet or a local network in IPv4/IPv6 format or a Fully Qualified Domain Name.
* `ip_ranges`: - Range of IPs used for Prism Central network setup.
* `network_ext_id`: - The network external identifier to which Domain Manager (Prism Central) is to be deployed or is already configured.

#### Default Gateway, Subnet Mask
The `default_gateway`and `subnet_mask` arguments support the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.
* `fqdn`: - A fully qualified domain name that specifies its exact location in the tree hierarchy of the Domain Name System.

#### IP Ranges
The `ip_ranges` argument supports the following:

* `begin`: - The beginning IP address of the range.
* `end`: - The ending IP address of the range.

#### begin, end
The `begin` and `end` arguments support the following:

* `ipv4`: - An unique address that identifies a device on the internet or a local network in IPv4 format.
* `ipv6`: - An unique address that identifies a device on the internet or a local network in IPv6 format.

#### IpV4, IpV6
The `ipv4` and `ipv6` arguments support the following:

* `value`: - The IPv4/IPv6 address of the host.
* `prefix_length`: - The prefix length of the network to which this host IPv4/IPv6 address belongs.

#### FQDN
The `fqdn` argument supports the following:

* `value`: - The fully qualified domain name of the host.

See detailed information in [Nutanix Deploy PC Docs](https://developers.nutanix.com/api-reference?namespace=prism&version=v4.0#tag/DomainManager/operation/createDomainManager).
Loading

0 comments on commit 1fa9f20

Please sign in to comment.