-
Notifications
You must be signed in to change notification settings - Fork 115
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
deploy pc resource docs and pc details data sources docs
- Loading branch information
1 parent
e309ab8
commit 1fa9f20
Showing
3 changed files
with
503 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
Oops, something went wrong.