Delete Profile Resource
A delete_profile resource can optionally be associated with streams. The GroveStream's system will periodically delete stream intervals for streams matching the delete_profile associated with them. A delete_profile is defined by choosing a range type and the number of range types.Delete Range Types:
- MINUTE
- HOUR
- DAY
- WEEK
- MONTH
- YEAR
If you would like to only store one month of stream interval data then create a delete profile that has a deleteRangeType="MONTH" and numRangeTypes=1 and associate it with the streams you wish to apply it to.
Note that when intervals are deleted by the automatic GroveStreams Delete Profile logic it is similar to calling DELETE feed: all roll-up values derived from the intervals being deleted will be recalculated.
GET delete_profile
Returns
a list of delete_profile resources. |
Resource Information | |
Rate Limited? | Yes | |
session, oauth and org tokens compatible? | Yes | |
api_key token token compatible? | Yes | |
Resource URL
http://grovestreams.com/api/delete_profile
Parameters
none |
Example Requests
/delete_profile <Response Body
{
"message": "",
"totalCount":
2,
"delete_profile": [
{
"deleteRangeType": "MONTH",
"uid":
"090cde83-a59e-4656-aa3f-61a8d9f56d2f",
"numRangeTypes": 2,
"description": "This delete profile
will delete any intervals older than two months.",
"name": "Retain two months"
},
{
"deleteRangeType": "YEAR",
"uid":
"68c527dd-ba99-405e-ab49-8c39e513773d",
"numRangeTypes": 1,
"description": "Retains one year of
stream intervals",
"name":
"Retain one year"
}
],
"success": true
}
GET delete_profile/{delete_profileUid}
Returns
a delete_profile with the specified uid. |
Resource Information | |
Rate Limited? | Yes | |
session, oauth and org tokens compatible? | Yes | |
api_key token compatible? | Yes | |
Resource URL
http://grovestreams.com/api/delete_profile/{delete_profileUid}
Parameters
none |
Example Requests
/delete_profile/090cde83-a59e-4656-aa3f-61a8d9f56d2f
Response
Body
{
"message": "",
"delete_profile": {
"deleteRangeType": "MONTH",
"uid": "090cde83-a59e-4656-aa3f-61a8d9f56d2f",
"numRangeTypes": 2,
"description": "This delete profile will delete any intervals
older than two months.",
"name": "Retain
two months"
},
"success": true
}
GET delete_profile/new
Returns
a default delete_profile with a unique UID. Does not persist the
new delete_profile in the store. It's the callers responsibility
to PUT the new delete_profile and register it. |
Resource Information | |
Rate Limited? | Yes | |
session, oauth and org tokens compatible? | Yes | |
api_key token compatible | Yes | |
Resource URL
http://grovestreams.com/api/delete_profile/new
Parameters
none |
Example Requests
/delete_profile/newResponse Body
{
"message": "",
"delete_profile": {
"deleteRangeType": "MONTH",
"uid": "090cde83-a59e-4656-aa3f-61a8d9f56d2f",
"numRangeTypes": 2,
"description": "This delete profile will delete any intervals
older than two months.",
"name": "Retain
two months"
},
"success": true
}
PUT delete_profile
Inserts
a new delete_profile. The uid of the delete_profile can be blank. If it is blank a uid will be created on the server and the response body will contain the new uid. |
Resource Information | |
Rate Limited? | Yes | |
session, oauth and org tokens compatible? | Yes | |
api_key token compatible |
Yes | |
org token required? | Yes |
Resource URL
http://grovestreams.com/api/delete_profile
Parameters
parentFolderUid | optional |
The UID of the tools content repository folder to place this new delete_profile into.
The new delete_profile will be placed into the root folder if
this parameter is missing. |
Example Requests
/delete_profileRequest Body
{
"message": "",
"delete_profile": {
"uid":
"090cde83-a59e-4656-aa3f-61a8d9f56d2f",
"deleteRangeType": "MONTH",
"numRangeTypes": "2",
"description":
"This delete profile will delete any intervals older than two
months.",
"name": "Retain two months"
},
"success": true
}
POST delete_profile
Used
to update an existing delete_profile. |
Resource Information | |
Rate Limited? | Yes | |
session, oauth and org tokens compatible? | Yes | |
api_key token compatible | Yes | |
Resource URL
http://grovestreams.com/api/delete_profile
Parameters
none |
Example Requests
/delete_profileRequest Body
{
"message": "",
"delete_profile": {
"uid":
"090cde83-a59e-4656-aa3f-61a8d9f56d2f",
"deleteRangeType": "MONTH",
"numRangeTypes": "2",
"description":
"This delete profile will delete any intervals older than two
months.",
"name": "Retain two months"
},
"success": true
}
DELETE delete_profile/{delete_profileUid}
Deletes
a delete_profile. Any streams that are referencing this
delete_profile will no longer reference a delete_profile. |
Resource Information | |
Rate Limited? | Yes | |
session, oauth and org tokens compatible? | Yes | |
api_key token compatible | Yes | |
Resource URL
http://grovestreams.com/api/delete_profile/{delete_profileUid}
Parameters
none |
Example Requests
/delete_profile/d251a8f2-f7b9-4df7-886d-b24c7f4929d4
Response
Body
{
"message" : "Deleted delete_profile with uid
'd251a8f2-f7b9-4df7-886d-b24c7f4929d4
'",
"success" : true
}