You need to sign in to do that
Don't have an account?
Artem Ivashchenko
Salesforce Status/Trust Rest API questions
Hi
My questions are related to Salesforce Status Rest API.
https://api.status.salesforce.com/v1/docs/#/
0) General question:
Does incidents (with incidentImpacts and incidentEvents) and maintenance (with maintenanceImpacts) can be updated after they are initially created?
I suppose incidentEvents can be added/updated after the original incident was created. Am I right?
What about the rest incident/maintenance data?
1) metricValues API
https://api.status.salesforce.com/v1/metricValues
It seems Metric values must be per instance but currently the link with instance is broken (metric shows instanceKey=All instead of distinct instance)
Every entry in API response has such value: "instanceKey": "All"
Is this a bug? Would metricValues be linked to distinct instances?
2) GeneralMessages as part of instance/status API
https://api.status.salesforce.com/v1/instances/status
https://api.status.salesforce.com/v1/instances/status/preview
https://api.status.salesforce.com/v1/instances/[instanceKey]/status e.g. https://api.status.salesforce.com/v1/instances/NA24/status
These APIs have GeneralMessages collection/array as part of theirs response model but there is no such data in responses.
I see GeneralMessages come only with separate API without links to instances.
Is there any link between instance and generalMessage?
Would this data be present in instancces/status API responses?
3) incidents API
https://api.status.salesforce.com/v1/incidents
this API has startTime as an input parameter - [startTime].
I'm trying to figure out what filter it applies on incidents.
My guess is the following (I've tried to write it in some sort of pseudocode):
trunc([startTime] to date) <= ANY trunc("IncidentImpacts"."startTime" to date)
Am I right?
4) maintenances API
https://api.status.salesforce.com/v1/maintenances
this API has startTime as an input parameter - [startTime].
I'm trying to figure out what filter it applies on incidents.
My two guesses are as followed (I've tried to write it in some sort of pseudocode):
a) trunc([startTime] to date) <= trunc("plannedStartTime" to date)
b) trunc([startTime] to date) <= ANY trunc("MaintenanceImpacts"."startTime" to date)
Which one filter is the right one?
My questions are related to Salesforce Status Rest API.
https://api.status.salesforce.com/v1/docs/#/
0) General question:
Does incidents (with incidentImpacts and incidentEvents) and maintenance (with maintenanceImpacts) can be updated after they are initially created?
I suppose incidentEvents can be added/updated after the original incident was created. Am I right?
What about the rest incident/maintenance data?
1) metricValues API
https://api.status.salesforce.com/v1/metricValues
It seems Metric values must be per instance but currently the link with instance is broken (metric shows instanceKey=All instead of distinct instance)
Every entry in API response has such value: "instanceKey": "All"
Is this a bug? Would metricValues be linked to distinct instances?
2) GeneralMessages as part of instance/status API
https://api.status.salesforce.com/v1/instances/status
https://api.status.salesforce.com/v1/instances/status/preview
https://api.status.salesforce.com/v1/instances/[instanceKey]/status e.g. https://api.status.salesforce.com/v1/instances/NA24/status
These APIs have GeneralMessages collection/array as part of theirs response model but there is no such data in responses.
I see GeneralMessages come only with separate API without links to instances.
Is there any link between instance and generalMessage?
Would this data be present in instancces/status API responses?
3) incidents API
https://api.status.salesforce.com/v1/incidents
this API has startTime as an input parameter - [startTime].
I'm trying to figure out what filter it applies on incidents.
My guess is the following (I've tried to write it in some sort of pseudocode):
trunc([startTime] to date) <= ANY trunc("IncidentImpacts"."startTime" to date)
Am I right?
4) maintenances API
https://api.status.salesforce.com/v1/maintenances
this API has startTime as an input parameter - [startTime].
I'm trying to figure out what filter it applies on incidents.
My two guesses are as followed (I've tried to write it in some sort of pseudocode):
a) trunc([startTime] to date) <= trunc("plannedStartTime" to date)
b) trunc([startTime] to date) <= ANY trunc("MaintenanceImpacts"."startTime" to date)
Which one filter is the right one?
Hopefully this helps.
0) All fields can be edited after creation. Often times this will happen for incidents when they do a post incident analysis and find that incident times originally reported turn out to be wrong. New incidentImpacts will be added throughout the incident as it changes states (disruption > degredation). Maintenances generally don’t change but there is no guarantee that they won’t.
1) We currently only expose aggregate metrics.
2) This is a bug with the api docs and I will get it updated. We don’t include general messages with the instances endpoints because they don’t have any association with instances. The best way to get this information is to use the general messages api.
3) The start time will filter out any incidents that have an incidentImpact that starts before the startTime.
4) The start time will filter out any maintenance that have an a plannedStart that starts before the startTime.
Let me know if you have other questions or suggestions. Thanks!
All Answers
Hopefully this helps.
0) All fields can be edited after creation. Often times this will happen for incidents when they do a post incident analysis and find that incident times originally reported turn out to be wrong. New incidentImpacts will be added throughout the incident as it changes states (disruption > degredation). Maintenances generally don’t change but there is no guarantee that they won’t.
1) We currently only expose aggregate metrics.
2) This is a bug with the api docs and I will get it updated. We don’t include general messages with the instances endpoints because they don’t have any association with instances. The best way to get this information is to use the general messages api.
3) The start time will filter out any incidents that have an incidentImpact that starts before the startTime.
4) The start time will filter out any maintenance that have an a plannedStart that starts before the startTime.
Let me know if you have other questions or suggestions. Thanks!
Thank you. It was helpfull.