:doc:`SSM <../../ssm>` / Client / associate_ops_item_related_item

*******************************
associate_ops_item_related_item
*******************************



.. py:method:: SSM.Client.associate_ops_item_related_item(**kwargs)

  

  Associates a related item to a Systems Manager OpsCenter OpsItem. For example, you can associate an Incident Manager incident or analysis with an OpsItem. Incident Manager and OpsCenter are tools in Amazon Web Services Systems Manager.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociateOpsItemRelatedItem>`_  


  **Request Syntax**
  ::

    response = client.associate_ops_item_related_item(
        OpsItemId='string',
        AssociationType='string',
        ResourceType='string',
        ResourceUri='string'
    )
    
  :type OpsItemId: string
  :param OpsItemId: **[REQUIRED]** 

    The ID of the OpsItem to which you want to associate a resource as a related item.

    

  
  :type AssociationType: string
  :param AssociationType: **[REQUIRED]** 

    The type of association that you want to create between an OpsItem and a resource. OpsCenter supports ``IsParentOf`` and ``RelatesTo`` association types.

    

  
  :type ResourceType: string
  :param ResourceType: **[REQUIRED]** 

    The type of resource that you want to associate with an OpsItem. OpsCenter supports the following types:

     

    ``AWS::SSMIncidents::IncidentRecord``: an Incident Manager incident.

     

    ``AWS::SSM::Document``: a Systems Manager (SSM) document.

    

  
  :type ResourceUri: string
  :param ResourceUri: **[REQUIRED]** 

    The Amazon Resource Name (ARN) of the Amazon Web Services resource that you want to associate with the OpsItem.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'AssociationId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **AssociationId** *(string) --* 

        The association ID.

        
  
  **Exceptions**
  
  *   :py:class:`SSM.Client.exceptions.InternalServerError`

  
  *   :py:class:`SSM.Client.exceptions.OpsItemNotFoundException`

  
  *   :py:class:`SSM.Client.exceptions.OpsItemLimitExceededException`

  
  *   :py:class:`SSM.Client.exceptions.OpsItemInvalidParameterException`

  
  *   :py:class:`SSM.Client.exceptions.OpsItemRelatedItemAlreadyExistsException`

  
  *   :py:class:`SSM.Client.exceptions.OpsItemConflictException`

  