Expectation Incidents

An ExpectationIncident groups ongoing failure behavior for an Expectation over time.

List Expectation Incidents

SDK Method

expectationincident.List()

Return Object

[]*ExpectationIncident

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

Additional Arguments

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    expectation_incident "github.com/Files-com/files-sdk-go/v3/expectationincident"
)

expectationIncidentIterator, err := expectation_incident.List(files_sdk.ExpectationIncidentListParams{})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

for expectationIncidentIterator.Next() {
    expectationIncident := expectationIncidentIterator.expectationIncident()
}
err = expectationIncidentIterator.Err()
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Show Expectation Incident

SDK Method

expectationincident.Find()

Return Object

ExpectationIncident

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

ExpectationIncidentFindParams Fields

FieldDescription
Id
int64
Required		Expectation Incident ID.

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    expectation_incident "github.com/Files-com/files-sdk-go/v3/expectationincident"
)

expectationIncident, err := expectation_incident.Find(files_sdk.ExpectationIncidentFindParams{Id: 1})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Resolve an expectation incident

SDK Method

expectationincident.Resolve()

Return Object

ExpectationIncident

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

ExpectationIncidentResolveParams Fields

FieldDescription
Id
int64
Required		Expectation Incident ID.

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    expectation_incident "github.com/Files-com/files-sdk-go/v3/expectationincident"
)

expectationIncident, err := expectation_incident.Resolve(files_sdk.ExpectationIncidentResolveParams{Id: 1})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Snooze an expectation incident until a specified time

SDK Method

expectationincident.Snooze()

Return Object

ExpectationIncident

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

ExpectationIncidentSnoozeParams Fields

FieldDescription
Id
int64
Required		Expectation Incident ID.
SnoozedUntil
string
Required		Time until which the incident should remain snoozed.

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    expectation_incident "github.com/Files-com/files-sdk-go/v3/expectationincident"
)

expectationIncident, err := expectation_incident.Snooze(files_sdk.ExpectationIncidentSnoozeParams{
  Id: 1,
  SnoozedUntil: "snoozed_until"
})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

Acknowledge an expectation incident

SDK Method

expectationincident.Acknowledge()

Return Object

ExpectationIncident

Authorization Requirement

Requires either a Site-Wide API key or User API key or session from a User with Site Admin permissions.

ExpectationIncidentAcknowledgeParams Fields

FieldDescription
Id
int64
Required		Expectation Incident ID.

Example Request

import (
    "fmt"
    "errors"

    files_sdk "github.com/Files-com/files-sdk-go/v3"
    expectation_incident "github.com/Files-com/files-sdk-go/v3/expectationincident"
)

expectationIncident, err := expectation_incident.Acknowledge(files_sdk.ExpectationIncidentAcknowledgeParams{Id: 1})
if err != nil {
    var respErr files_sdk.ResponseError
    if errors.As(err, &respErr) {
        fmt.Println("Response Error Occurred (" + respErr.Type + "): " + respErr.ErrorMessage)
    } else {
        fmt.Printf("Unexpected Error: %s\n", err.Error())
    }
}

The ExpectationIncident Object

Some of the methods above return a ExpectationIncident object. The attributes of this object are listed below.

AttributeDescription
Id
int64		Expectation Incident ID
WorkspaceId
int64		Workspace ID. 0 means the default workspace.
ExpectationId
int64		Expectation ID.
Status
string		Incident status.
Possible values: open, acknowledged, snoozed, resolved
OpenedAt
date-time		When the incident was opened.
LastFailedAt
date-time		When the most recent failing evaluation contributing to the incident occurred.
AcknowledgedAt
date-time		When the incident was acknowledged.
SnoozedUntil
date-time		When the current snooze expires.
ResolvedAt
date-time		When the incident was resolved.
OpenedByEvaluationId
int64		Evaluation that first opened the incident.
LastEvaluationId
int64		Most recent evaluation linked to the incident.
ResolvedByEvaluationId
int64		Evaluation that resolved the incident.
Summary
object		Compact incident summary payload.
CreatedAt
date-time		Creation time.
UpdatedAt
date-time		Last update time.