ssmincidents function

AWS Systems Manager Incident Manager

AWS Systems Manager Incident Manager

Systems Manager Incident Manager is an incident management console designed to help users mitigate and recover from incidents affecting their Amazon Web Services-hosted applications. An incident is any unplanned interruption or reduction in quality of services.

Incident Manager increases incident resolution by notifying responders of impact, highlighting relevant troubleshooting data, and providing collaboration tools to get services back up and running. To achieve the primary goal of reducing the time-to-resolution of critical incidents, Incident Manager automates response plans and enables responder team escalation.

ssmincidents( config = list(), credentials = list(), endpoint = NULL, region = NULL )

Arguments

  • config: Optional configuration of credentials, endpoint, and/or region.

    • credentials :

      • creds :

        • access_key_id : AWS access key ID
        • secret_access_key : AWS secret access key
        • session_token : AWS temporary session token
      • profile : The name of a profile to use. If not given, then the default profile is used.

      • anonymous : Set anonymous credentials.

    • endpoint : The complete URL to use for the constructed client.

    • region : The AWS Region used in instantiating the client.

    • close_connection : Immediately close all HTTP connections.

    • timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

    • s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

    • sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

  • credentials: Optional credentials shorthand for the config parameter

    • creds :

      • access_key_id : AWS access key ID
      • secret_access_key : AWS secret access key
      • session_token : AWS temporary session token
    • profile : The name of a profile to use. If not given, then the default profile is used.

    • anonymous : Set anonymous credentials.

  • endpoint: Optional shorthand for complete URL to use for the constructed client.

  • region: Optional shorthand for AWS Region used in instantiating the client.

Returns

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- ssmincidents(
  config = list(
    credentials = list(
 creds = list(
   access_key_id = "string",
   secret_access_key = "string",
   session_token = "string"
 ),
 profile = "string",
 anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
 access_key_id = "string",
 secret_access_key = "string",
 session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

batch_get_incident_findingsRetrieves details about all specified findings for an incident, including descriptive details about each finding
create_replication_setA replication set replicates and encrypts your data to the provided Regions with the provided KMS key
create_response_planCreates a response plan that automates the initial response to incidents
create_timeline_eventCreates a custom timeline event on the incident details page of an incident record
delete_incident_recordDelete an incident record from Incident Manager
delete_replication_setDeletes all Regions in your replication set
delete_resource_policyDeletes the resource policy that Resource Access Manager uses to share your Incident Manager resource
delete_response_planDeletes the specified response plan
delete_timeline_eventDeletes a timeline event from an incident
get_incident_recordReturns the details for the specified incident record
get_replication_setRetrieve your Incident Manager replication set
get_resource_policiesRetrieves the resource policies attached to the specified response plan
get_response_planRetrieves the details of the specified response plan
get_timeline_eventRetrieves a timeline event based on its ID and incident record
list_incident_findingsRetrieves a list of the IDs of findings, plus their last modified times, that have been identified for a specified incident
list_incident_recordsLists all incident records in your account
list_related_itemsList all related items for an incident record
list_replication_setsLists details about the replication set configured in your account
list_response_plansLists all response plans in your account
list_tags_for_resourceLists the tags that are attached to the specified response plan or incident
list_timeline_eventsLists timeline events for the specified incident record
put_resource_policyAdds a resource policy to the specified response plan
start_incidentUsed to start an incident from CloudWatch alarms, EventBridge events, or manually
tag_resourceAdds a tag to a response plan
untag_resourceRemoves a tag from a resource
update_deletion_protectionUpdate deletion protection to either allow or deny deletion of the final Region in a replication set
update_incident_recordUpdate the details of an incident record
update_related_itemsAdd or remove related items from the related items tab of an incident record
update_replication_setAdd or delete Regions from your replication set
update_response_planUpdates the specified response plan
update_timeline_eventUpdates a timeline event

Examples

## Not run: svc <- ssmincidents() svc$batch_get_incident_findings( Foo = 123 ) ## End(Not run)
  • Maintainer: Dyfan Jones
  • License: Apache License (>= 2.0)
  • Last published: 2025-03-17