REST API - duplicate

appliance configuration desired state: duplicate

duplicate a new software profile from the current desired state. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Request:

HTTP request

POST https://{server}/api/appliance/configuration/desiredstate/{profile}

{
"name" : "string",
"description" : "string"
}

Path Parameters

Name	Type	Description
Required
profile	string	Identifier of the profile.

Body Parameters:

Name	Type	Description
bold = required
-	create_spec	Specification to create the profil.
-.description	string	Description of the profile. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Optional. If unset, the description will be empty.
-.name	string	Name of the profile. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Response:

HTTP Status Code: 200

Response Body Structure:

{
    "creation_time" : "2015-01-01T22:13:05.651Z",
    "owner" : "string",
    "profile" : "obj-103",
    "name" : "string",
    "description" : "string",
    "version" : "obj-103"
}

Headers:

None

Type:

Name	Type	Description
bold = required
-	profile_info	Information about the desired Profile.
-.profile	string	Unique Profile identifier. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: `com.vmware.appliance.configuration.profile`. When operations return a value of this structure as a result, the field will be an identifier for the resource type: `com.vmware.appliance.configuration.profile`.
-.name	string	Name of the profile. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
-.version	string	Unique working profile configuration identifier. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: `com.vmware.appliance.configuration.profile.version`. When operations return a value of this structure as a result, the field will be an identifier for the resource type: `com.vmware.appliance.configuration.profile.version`.
-.creation_time	date_time	Creation time of the profile desired configuration. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
-.owner	string	Owner of the profile, the one who created. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
-.description	string	Custom description provided by the user. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Optional. If unset description will be empty.

Errors:

HTTP Status Code	Type	Description
400	already_exists	If there is already a profile created by the same profile name.
404	not_found	If there is no profile associated with `profile`
500	error	If there is unknown internal error. The accompanying error message will give more details about the failure.
503	service_unavailable	If the service is not available.
401	unauthenticated	If the caller is not authenticated.