PartnerCentralAccountAPI / Client / get_connection

get_connection

PartnerCentralAccountAPI.Client.get_connection(**kwargs)

Retrieves detailed information about a specific connection between partners.

See also: AWS API Documentation

Request Syntax

response = client.get_connection(
    Catalog='string',
    Identifier='string'
)

Parameters:

• Catalog (string) –

  [REQUIRED]

  The catalog identifier where the connection exists.

• Identifier (string) –

  [REQUIRED]

  The unique identifier of the connection to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'Catalog': 'string',
    'Id': 'string',
    'Arn': 'string',
    'OtherParticipantAccountId': 'string',
    'UpdatedAt': datetime(2015, 1, 1),
    'ConnectionTypes': {
        'string': {
            'CreatedAt': datetime(2015, 1, 1),
            'InviterEmail': 'string',
            'InviterName': 'string',
            'Status': 'ACTIVE'|'CANCELED',
            'CanceledAt': datetime(2015, 1, 1),
            'CanceledBy': 'string',
            'OtherParticipant': {
                'PartnerProfile': {
                    'Id': 'string',
                    'Name': 'string'
                },
                'SellerProfile': {
                    'Id': 'string',
                    'Name': 'string'
                },
                'Account': {
                    'Name': 'string'
                }
            }
        }
    }
}

Response Structure

• (dict) –

  • Catalog (string) –

    The catalog identifier where the connection exists.

  • Id (string) –

    The unique identifier of the connection.

  • Arn (string) –

    The Amazon Resource Name (ARN) of the connection.

  • OtherParticipantAccountId (string) –

    The AWS account ID of the other participant in the connection.

  • UpdatedAt (datetime) –

    The timestamp when the connection was last updated.

  • ConnectionTypes (dict) –

    The list of connection types active between the partners.

    • (string) –

      • (dict) –

        Detailed information about a specific connection type within a connection.

        • CreatedAt (datetime) –

          The timestamp when this connection type was created.

        • InviterEmail (string) –

          The email address of the person who initiated this connection type.

        • InviterName (string) –

          The name of the person who initiated this connection type.

        • Status (string) –

          The current status of this connection type.

        • CanceledAt (datetime) –

          The timestamp when this connection type was cancelled, if applicable.

        • CanceledBy (string) –

          The AWS account ID of the participant who cancelled this connection type.

        • OtherParticipant (dict) –

          Information about the other participant in this connection type.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: PartnerProfile, SellerProfile, Account. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          

          • PartnerProfile (dict) –

            The partner profile information for the participant.

            • Id (string) –

              The unique identifier of the partner profile.

            • Name (string) –

              The display name of the partner.

          • SellerProfile (dict) –

            The seller profile information for the participant.

            • Id (string) –

              The unique identifier of the seller profile.

            • Name (string) –

              The display name of the seller.

          • Account (dict) –

            The AWS account information for the participant.

            • Name (string) –

              The name associated with the AWS account.

Exceptions

• PartnerCentralAccountAPI.Client.exceptions.ResourceNotFoundException

• PartnerCentralAccountAPI.Client.exceptions.AccessDeniedException

• PartnerCentralAccountAPI.Client.exceptions.ThrottlingException

• PartnerCentralAccountAPI.Client.exceptions.ValidationException

• PartnerCentralAccountAPI.Client.exceptions.InternalServerException