Copy a resource into a new parent#

To update a resource's parent with this command, you must specify, at a minimum, the resource path or id, and optionally provide info for the resource template, blueprint, and application.


PUT https://{hostname}:{port}
Accept: application/json

Parameter Type Required Description
resource string true Path to the resource, such as /ResourceGroup/Agents/Agent1
parent string true The path or id of the new parent
template string false Name or ID of the resource template (Optional)
blueprintId string false Name or ID of the blueprint (Optional)
application string false Name or ID of the application (Required to look up blueprint by name)
Parameter Type Required Description
Accept application/json true  

This command takes a JSON request string or file. Use the following template for the request:

  "agent": "Name or ID of an agent to use for automation 
  "agentPool": "Name or ID of an agent pool to use for 
  automation (Optional)",
  "component": "Name or ID of a component to associate 
  with the resource (Optional)",
  "componentTag": "Name or ID of a component tag to 
  associate with the resource; any components with that tag 
  can be deployed to this resource (Optional)",
  "description": "Description",
  "impersonationForce": "Specify true to prevent children 
  or steps from specifying their own impersonation settings 
  "impersonationGroup": "Group for default impersonation 
  "impersonationPassword": "Password for default 
  impersonation (Optional)",
  "impersonationUseSudo": "Specify true to use the sudo 
  command for impersonation (Optional)",
  "impersonationUser": "User name for default 
  impersonation (Optional)",
  "name": "Name for the new resource; leave blank to 
  inherit the name from an agent, pool, or role",
  "parent": "ID or path to parent resource; leave blank to 
  create a root resource (Optional)",
  "role": "Name or ID of a resource role to associate with 
  the agent; if this resource is for a component, specify 
  the component name instead (Optional)",
  "roleProperties": {"Property name": "Property value 

Related CLI command: copyResource.

Parent topic: resource resource