Create Snapshot

Method

POST

Syntax

 
/grs/v1/tenant/{tenantId}/package/{packageId}/snapshot

Request Body

 
{   
  "name":"Snap 01",
  "comment":"Create prior to QA",
}

Response Body

 
{   
   "snapshotId", "dcc4a39b-3442-4408-a907-b85c44663681",
 "name":"Snap 01",
  "comment":"Create prior to QA",
  "createDate":30949200000,
}

HTTP Status Codes

• 201 - Created - Response body provided
• 401 - Unauthorized - APIToken not valid
• 403 - Forbidden - User does not have permission for the specified tenant, or does not have proper permission to perform this operation.
• 422 - Unprocessable Entity - Field Validation Error

 
{
  "message": "Validation Failed",
  "errors": [
    {
       "code" : "1000",
       "field" : "name",
       "message": "snapshot name is not valid"
}
]
}

• 422 - Unprocessable Entity - Rules in package do not validate

 
{
"message": "Package Validation Failed",
  "errors": [
    {
      "message": "Validation error 1"
    },
    {
      "message": "Validation error 2"
    }
  ]
}

Notes

User must have SNAPSHOT_CREATE permission.

• name—Snapshot name cannot contain special characters such as: { } [ ] . * | / : < > ' & due to internal restrictions.