SSMIncidents / Client / update_related_items

update_related_items

SSMIncidents.Client.update_related_items(**kwargs)

Add or remove related items from the related items tab of an incident record.

See also: AWS API Documentation

Request Syntax

response = client.update_related_items(
    clientToken='string',
    incidentRecordArn='string',
    relatedItemsUpdate={
        'itemToAdd': {
            'generatedId': 'string',
            'identifier': {
                'type': 'ANALYSIS'|'INCIDENT'|'METRIC'|'PARENT'|'ATTACHMENT'|'OTHER'|'AUTOMATION'|'INVOLVED_RESOURCE'|'TASK',
                'value': {
                    'arn': 'string',
                    'metricDefinition': 'string',
                    'pagerDutyIncidentDetail': {
                        'autoResolve': True|False,
                        'id': 'string',
                        'secretId': 'string'
                    },
                    'url': 'string'
                }
            },
            'title': 'string'
        },
        'itemToRemove': {
            'type': 'ANALYSIS'|'INCIDENT'|'METRIC'|'PARENT'|'ATTACHMENT'|'OTHER'|'AUTOMATION'|'INVOLVED_RESOURCE'|'TASK',
            'value': {
                'arn': 'string',
                'metricDefinition': 'string',
                'pagerDutyIncidentDetail': {
                    'autoResolve': True|False,
                    'id': 'string',
                    'secretId': 'string'
                },
                'url': 'string'
            }
        }
    }
)

Parameters:

• clientToken (string) –

  A token that ensures that a client calls the operation only once with the specified details.

  This field is autopopulated if not provided.

• incidentRecordArn (string) –

  [REQUIRED]

  The Amazon Resource Name (ARN) of the incident record that contains the related items that you update.

• relatedItemsUpdate (dict) –

  [REQUIRED]

  Details about the item that you are add to, or delete from, an incident.

  Note

  This is a Tagged Union structure. Only one of the following top level keys can be set: itemToAdd, itemToRemove.

  • itemToAdd (dict) –

    Details about the related item you’re adding.

    • generatedId (string) –

      A unique ID for a RelatedItem.

      Warning

      Don’t specify this parameter when you add a RelatedItem by using the UpdateRelatedItems API action.

    • identifier (dict) – [REQUIRED]

      Details about the related item.

      • type (string) – [REQUIRED]

        The type of related item.

      • value (dict) – [REQUIRED]

        Details about the related item.

        Note

        This is a Tagged Union structure. Only one of the following top level keys can be set: arn, metricDefinition, pagerDutyIncidentDetail, url.

        • arn (string) –

          The Amazon Resource Name (ARN) of the related item, if the related item is an Amazon resource.

        • metricDefinition (string) –

          The metric definition, if the related item is a metric in Amazon CloudWatch.

        • pagerDutyIncidentDetail (dict) –

          Details about an incident that is associated with a PagerDuty incident.

          • autoResolve (boolean) –

            Indicates whether to resolve the PagerDuty incident when you resolve the associated Incident Manager incident.

          • id (string) – [REQUIRED]

            The ID of the incident associated with the PagerDuty service for the response plan.

          • secretId (string) –

            The ID of the Amazon Web Services Secrets Manager secret that stores your PagerDuty key, either a General Access REST API Key or User Token REST API Key, and other user credentials.

        • url (string) –

          The URL, if the related item is a non-Amazon Web Services resource.

    • title (string) –

      The title of the related item.

  • itemToRemove (dict) –

    Details about the related item you’re deleting.

    • type (string) – [REQUIRED]

      The type of related item.

    • value (dict) – [REQUIRED]

      Details about the related item.

      Note

      This is a Tagged Union structure. Only one of the following top level keys can be set: arn, metricDefinition, pagerDutyIncidentDetail, url.

      • arn (string) –

        The Amazon Resource Name (ARN) of the related item, if the related item is an Amazon resource.

      • metricDefinition (string) –

        The metric definition, if the related item is a metric in Amazon CloudWatch.

      • pagerDutyIncidentDetail (dict) –

        Details about an incident that is associated with a PagerDuty incident.

        • autoResolve (boolean) –

          Indicates whether to resolve the PagerDuty incident when you resolve the associated Incident Manager incident.

        • id (string) – [REQUIRED]

          The ID of the incident associated with the PagerDuty service for the response plan.

        • secretId (string) –

          The ID of the Amazon Web Services Secrets Manager secret that stores your PagerDuty key, either a General Access REST API Key or User Token REST API Key, and other user credentials.

      • url (string) –

        The URL, if the related item is a non-Amazon Web Services resource.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

• (dict) –

Exceptions

• SSMIncidents.Client.exceptions.ThrottlingException

• SSMIncidents.Client.exceptions.ResourceNotFoundException

• SSMIncidents.Client.exceptions.AccessDeniedException

• SSMIncidents.Client.exceptions.ValidationException

• SSMIncidents.Client.exceptions.ConflictException

• SSMIncidents.Client.exceptions.InternalServerException