Update a resource's 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.
Request
PUT https://{hostname}:{port}
/cli/resource/move?{parameters}
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
(Optional)",
"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
(Optional)",
"impersonationGroup": "Group for default impersonation
(Optional)",
"impersonationPassword": "Password for default
impersonation. Agents running on Linux and Unix machines
will ignore this value (Optional)",
"impersonationUseSudo": "Specify true to use the sudo
command for impersonation. Agents running on Windows
machines will ignore this value (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
(Optional)"}
}
Example
curl -k -u jsmith:passwd
"https://myserver.example.com:8443/cli/resource/move
?resource=/container1/subfolder1a/subfolder1b&parent=/container2/subfolder2a" -X PUT
Related CLI command: moveResource.