How do I use
VMware Aria Suite Lifecycle
in VCF Aware Mode

As a VMware Cloud Foundation (VCF) user, you can use SDDC Manager to automate the deployment of
VMware Aria Suite Lifecycle
in VCF aware mode so that SDDC Manager understands which
VMware Aria Suite
products have been deployed.
Running
VMware Aria Suite Lifecycle
in VCF aware mode allows bidirectional communication and ensures that the VCF user deploys
VMware Aria Suite
products in accordance with VMware Validated Design.

Running API Operations as a VCF Administrator

As a VCF administrator with the user name vcfadmin@local, you can use any of the
VMware Aria Suite Lifecycle
public REST APIs, but restrictions and requirements apply to the following operations when
VMware Aria Suite Lifecycle
is in VCF aware mode. No restrictions or requirements apply to the
VMware Aria Suite Lifecycle
administrator with the user name admin@local.
Operations with Restrictions or Requirements
Operation
Endpoint
Restriction or Requirement
Update product admin password
PUT /lcm/lcops/api/v2/environments/{environmentId}/products/{productId}/admin-password
You are not allowed to update password references in VCF enabled environments. To update a product admin password, use the following example request body instead:
{ "adminPassword": "locker:password:26005893-319a-4711-93a1-8eea7c3eecd4:CommonPassword", "currentAdminPassword": "locker:password:3b4b1c1d-bc20-4ed8-8b3c-d4540663c5fc:ConfigAdminPwdTest" }
Update Product Node Password
PUT /lcm/lcops/api/v2/environments/{environmentId}/products/{productId}/nodes/{nodeType}
You are not allowed to update password references in VCF enabled environments. To update a product node password, use the following example request body instead:
{ "currentPassword": "locker:password:3b4b1c1d-bc20-4ed8-8b3c-d4540663c5fc:ConfigAdminPwdTest", "hostName": "wsa-1.vrack.vsphere.local", "newPassword": "locker:password:26005893-319a-4711-93a1-8eea7c3eecd4:CommonPassword", "userNameToUpdate": "root" }
Validate an Environment
POST /lcm/lcops/api/v2/environments/pre-validate
When you validate an environment before you create an environment, the request payload must include
vcfProperties
as an infrastructure property.
vcfProperties
identifies if the environment is VCF enabled. For example:
"infrastructure": { "properties": { ... "vcfProperties": { "vcfEnabled":true, "sddcManagerDetails":[{ "sddcManagerHostName":"sddc-manager.vrack.vsphere.local", "sddcManagerName":"default", "sddcManagerVmid":"default" }] } vcfProperties ... } }
Create an Environment
POST /lcm/lcops/api/v2/environments
When you create an environment, the request payload for deployment must include:
  • vcfProperties
    as an infrastructure property.
    vcfProperties
    identifies if the environment is VCF enabled.
  • clusterVIP
    as a product.
    clusterVIP
    identifies Load Balancer details for vRA, vROps, vRLI, and
    Workspace ONE Access
    . If deploying
    Workspace ONE Access
    with a single node, leave the
    clusterVIP
    field empty.
The following payload example snippet includes property and product values for a vRA 8.3 deployment.
"infrastructure": { "properties": { ... "vcfProperties": { "vcfEnabled":true, "sddcManagerDetails":[{ "sddcManagerHostName":"sddc-manager.vrack.vsphere.local", "sddcManagerName":"default", "sddcManagerVmid":"default" }] } vcfProperties ... } }, "products": [ { "id": "vra", "version": "8.3.0", "patchHistory": null, "snapshotHistory": null, "logHistory": null, "clusterVIP": { "clusterVips": [ { "type": "vra-va", "properties": { "hostName": "vra-lb.vrack.vsphere.local" } } ] },
When you create an environment, the request payload for import must include:
  • vcfProperties
    as an infrastructure property.
    vcfProperties
    identifies if the environment is VCF enabled.
  • clusterFqdn
    as a product property.
    clusterFqdn
    specifies the load balancer FQDN.
The following payload example includes property and product values for a vROps 8.3 import that includes
Workspace ONE Access
with a single node.
"infrastructure": { "properties": { ... "vcfProperties": { "vcfEnabled":true, "sddcManagerDetails":[{ "sddcManagerHostName":"sddc-manager.vrack.vsphere.local", "sddcManagerName":"default", "sddcManagerVmid":"default" }] } vcfProperties ... } }, "products": [ { "id": "vrops", "version": "8.3.0", "properties": { "vropsMasterNodeIP": "vrops-master.vrack.vsphere.local", ... "clusterFqdn": "vrops-lb.vrack.vsphere.local" }, "clusterVIP": { "clusterVips": [] }, "nodes": []
Add Product to an Environment
POST /lcm/lcops/api/v2/environments/{environmentId}/products
When you add a product to an existing environment, the request payload must include:
  • vcfProperties
    as an infrastructure property.
    vcfProperties
    identifies if the environment is VCF enabled.
  • clusterVIP
    as a product.
    clusterVIP
    identifies Load Balancer details for vRA, vROps, vRLI, and
    Workspace ONE Access
    . If deploying
    Workspace ONE Access
    with a single node, leave the
    clusterVIP
    field empty
The following payload example includes product values for adding vRA 8.3.
"infrastructure": { "properties": { ... "vcfProperties": { "vcfEnabled":true, "sddcManagerDetails":[{ "sddcManagerHostName":"sddc-manager.vrack.vsphere.local", "sddcManagerName":"default", "sddcManagerVmid":"default" }] } vcfProperties ... } }, "products": [ { "id": "vra", "version": "8.3.0", "patchHistory": null, "snapshotHistory": null, "logHistory": null, "clusterVIP": { "clusterVips": [ { "type": "vra-va", "properties": { "hostName": "vra-lb.vrack.vsphere.local" } } ] },
When you import a product into an existing environment, the request payload must include:
  • vcfProperties
    as an infrastructure property.
    vcfProperties
    identifies if the environment is VCF enabled.
  • clusterFqdn
    as a product property.
    clusterFqdn
    specifies the load balancer FQDN.
The following payload example includes product values for a vROps 8.3 import that includes
Workspace ONE Access
with a single node.
"infrastructure": { "properties": { ... "vcfProperties": { "vcfEnabled":true, "sddcManagerDetails":[{ "sddcManagerHostName":"sddc-manager.vrack.vsphere.local", "sddcManagerName":"default", "sddcManagerVmid":"default" }] } vcfProperties ... } }, "products": [ { "id": "vrops", "version": "8.3.0", "properties": { "vropsMasterNodeIP": "vrops-master.vrack.vsphere.local", ... "clusterFqdn": "vrops-lb.vrack.vsphere.local" }, "clusterVIP": { "clusterVips": [] }, "nodes": []
Add Node to a Product
POST /lcm/lcops/api/v2/environments/{environmentId}/products/{productId}/nodes
When you scale out
Workspace ONE Access
, the request payload must include:
  • vcfProperties
    as an infrastructure property.
    vcfProperties
    identifies if the environment is VCF enabled.
  • clusterVIP
    as a product.
    clusterVIP
    provides the load balancer details.
The following payload example includes product values for scaling out
Workspace ONE Access
.
"infrastructure": { "properties": { ... "vcfProperties": { "vcfEnabled":true, "sddcManagerDetails":[{ "sddcManagerHostName":"sddc-manager.vrack.vsphere.local", "sddcManagerName":"default", "sddcManagerVmid":"default" }] } vcfProperties ... } ,} "products": [ { "id": "vidm", "version": "3.3.3", "patchHistory": null, "snapshotHistory": null, "logHistory": null, "clusterVIP": { "clusterVips": [ { "type": "vidm-lb", "properties": { "hostName": "wsa-lb.vrack.vsphere.local" } }, { "type": "vidm-delegate", "properties": { "ip": "10.196.31.26" } } ] }, "nodes": [ { "type": "vidm-secondary", "properties": { "vmName": "vidm-secondary-1", "hostName": "wsa-2.vrack.vsphere.local", "ip": "192.168.31.24" } }, { "type": "vidm-secondary", "properties": { "vmName": "vidm-secondary-2", "hostName": "wsa-3.vrack.vsphere.local", "ip": "192.168.31.25" } } ],