After you deploy catalog items, you can run actions in Service Broker to modify and manage the resources. The available actions depend on the resource type and whether the action is supported on a particular cloud account or integrated platform.

The available actions also depend on what your administrator entitled you to run.

As an administrator or project administrator, you can set up Day 2 Actions policies. See How do I entitle deployment users to Service Broker day 2 actions using policies.

You might also see actions that are not included in the list. These are likely custom actions that your administrator configured in Cloud Assembly.

Table 1. List of possible actions
Action Applies to these resource types For these cloud accounts or integrations Description
Add Disk Machines
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere

Add additional disks to existing virtual machines.

If you add a disk to an Azure machine, the disk is deployed in the resource group that includes the machine. if it is a persistent disk, a new resource group is created.

Cancel
  • Deployments
  • Various resource types in deployments
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Cancel a deployment or a day 2 action on a deployment or a resource while the request is being processed.

You can cancel the request on the deployment card or in the deployment details. After you cancel the request, it appears as a failed request on the Deployments tab. Use the Delete action to clean up your deployment list.

Canceling a request that you think has been running too long is one method for managing deployment time. However, it is more efficient to set the Request Timeout in the projects. The default timeout is two hours. You can set if for a longer period of time if the workload deployment for a project requires more time.

Change Lease Deployments
  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere

Change the lease expiration date and time.

When a lease expires, the deployment is destroyed and the resources are reclaimed.

Lease policies are set in Service Broker.

Change Owner Deployments
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Changes to deployment owner to the selected user. The selected user must be a member of the same project that deployed the request.

If you want to assign a service administrator or project administrator as the owner, you must add them as a project member.

When a cloud template designer deploys a template, the designer is both the requester and the owner. However, a requester can make another project member the owner.

Change Security Groups Machines
  • VMware vSphere
You can associate and dissociate security groups with machine networks in a deployment. The change action applies to existing and on-demand security groups for NSX-V and NSX-T. This action is available only for single machines, not machine clusters.

To associate a security group with the machine network, the security group must be present in the deployment.

Dissociating a security group from all networks of all machines in a deployment does not remove the security group from the deployment.

These changes do not affect security groups applied as part of the network profiles.

This action changes the machine's security group configuration without recreating the machine. This is a non-destructive change.

Change security groups on a machine

  • To change the machine's security group configuration, select the machine in the topology pane, then click the Action menu in the right pane and select Change Security Groups. You can now add or remove the association on the security groups with the machine networks.
Connect to Remote Console Machines
  • VMware vSphere
Open a remote session on the selected machine.

Review the following requirements for a successful connection.

  • As a cloud administrator, verify that the ESXi host is accessible over SSL from the network that your consumers are using.
  • As a deployment consumer, verify that the provisioned machine is powered on.

If your connection attempt indicates that a connection can not be established with the host, you might be required to accept the self-signed certificate.

  1. If you receive a certificate error, click accept the certificate and use the method provided by your browser to open the URL for the VMware ESXi page.

    Opening the VMware ESXi page is sufficient to accept the certificate. You can close the ESXi page.

  2. Refresh or reopen the remote connection page that previously displayed the warning.

    The console for the target machine opens.

As an administrator, if you prefer to ensure trusted certificates, see KB2113926 to configure CA signed certificates for ESXi hosts.

Create Snapshot Machines
  • Google Cloud Platform
  • VMware vSphere
Create a snapshot of the virtual machine.

If you are allowed only two snapshots in vSphere and you already have them, this command is not available until you delete a snapshot.

Delete

Deployments

  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Destroy a deployment.

All the resources are deleted and the reclaimed.

If a delete fails, you can run the delete action on a deployment a second time. During the second attempt, you can select Ignore Delete Failures. If you select this option, the deployment is deleted, but the resources might not be reclaimed. You should check the systems on which the deployment was provisioned to ensure that all resources are removed. If they are not, you must manually delete the residual resources on those systems.

NSX Gateway
  • NSX
Delete the NAT port forwarding rules from an NSX-T or NSX-V gateway.
Machines and load balancers
  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere
  • VMware NSX
Delete a machine or load balancer from a deployment. This action might result in an unusable deployment.
Security groups
  • NSX-T
  • NSX-V
If the security is not associated with any machine in the deployment, the process removes the security group from the deployment.
  • If the security group is on-demand, then it is destroyed on the endpoint.
  • If the security group is shared, the action fails.
Delete Snapshot Machines
  • VMware vSphere
  • Google Cloud Platform
Delete a snapshot of the virtual machine.
Edit Tags Deployments
  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere
Add or modify resource tags that are applied to individual deployment resources.
Get Terraform State Terraform Configuration
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Display the Terraform state file.

To view any changes that were made to the Terraform machines on the cloud platforms that they were deployed on and update the deployment, you first run the Refresh Terraform State action, and then run this Get Terraform State action.

When the file is displayed in a dialog box. The file is available for approximately 1 hour before you need to run a new refresh action. You can copy it if you need it for later.

You can also view the file on the deployment History tab. Select the Get Terraform State event on the Events tab, and then click Request Details. If the file is not expired, click View content. If the file is expired, run the Refresh and Get actions again.

Example of the Request Details where you can view the Terraform state file.

You can run other day 2 action on the Terraform resources that are embedded in the configuration. The available actions depend on the resource type, the cloud platform that they are deployed on, and whether you are entitled to run the actions based on a day 2 policy.

Power Off

Deployments

  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere
Power off the deployment without shutting down the guest operating systems.

Machines

  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Power off the machine without shutting down the guest operating systems.
Power On

Deployments

  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere
Power on the deployment. If the resources were suspended, normal operation resumes from the point at which they were suspended.

Machines

  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Power on the machine. If the machine was suspended, normal operation resumes from the point at which the machine was suspended.
Reboot Machines
  • Amazon Web Service
  • VMware vSphere

Reboot the guest operating system on a virtual machine.

For a vSphere machine, VMware Tools must be installed on the machine to use this action.

Reconfigure Load Balancers
  • Amazon Web Service
  • Microsoft Azure
  • VMware NSX
Change the load balancer size and logging level.

You can also add or remove routes, and change the protocol, port, health configuration, and member pool settings.

NSX Gateway port forwarding
  • NSX-T
  • NSX-V
Add, edit, or delete the NAT port forwarding rules from an NSX-T or NSX-V gateway.
Refresh Terraform State Terraform Configuration
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Retrieve the latest iteration of the Terraform state file.

To retrieve any changes that were made to the Terraform machines on the cloud platforms that they were deployed on and update the deployment, you first run this Refresh Terraform State action.

To view the file, run the Get Terraform State action on the configuration.

Use the deployment history tab to monitor the refresh process.

Remove Disk Machines
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Remove disks from existing virtual machines.
Reset Machines
  • Amazon Web Service
  • Google Cloud Platform
  • VMware vSphere

Force a virtual machine restart without shutting down the guest operating system.

Resize Machines
  • Amazon Web Service
  • Microsoft Azure
  • Google Cloud Platform
  • VMware vSphere

Increase or decrease the CPU and memory of a virtual machine.

Resize Boot Disk Machines
  • Amazon Web Service
  • Google Cloud Platform
  • Microsoft Azure
  • VMware vSphere
Increase or decrease the size of your boot disk medium.
Resize Disk Storage disk
  • Amazon Web Service
  • Google Cloud Platform

Increase the capacity of a storage disk.

Restart Machines
  • Microsoft Azure
Shut down and restart a running machine.
Revert to Snapshot Machines
  • Google Cloud Platform
  • VMware vSphere
Revert to a previous snapshot of the machine.

You must have an existing snapshot to use this action.

Run Puppet Task Managed resources
  • Puppet Enterprise
Run the selected task on machines in your deployment.

The tasks are defined in your Puppet instance. You must be able to identify the task and provide the input parameters.

Shutdown Machines
  • VMware vSphere
Shut down the guest operating system and power off the machine. VMware Tools must be installed on the machine to use this action.
Suspend Machines
  • Microsoft Azure
  • VMware vSphere
Pause the machine so that it cannot be used and does not consume any system resources other than the storage it is using.
Update Deployments
  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere
Change the deployment based on the input parameters.

For an example, see How to move a deployed machine to another network.

Update Tags Machines and disks
  • Amazon Web Service
  • Microsoft Azure
  • VMware vSphere
Add, modify, or delete a tag that is applied to an individual resource.