Partner Central Account API

2026/07/22 - Partner Central Account API - 5 new api methods

Changes  Adds Qualifications Association APIs that enable partners to associate a subsidiary account's qualifications with a primary account. Once associated, qualifications are shared across all connected accounts and scorecards are consolidated. Partners can start and track association and disassociation.

StartQualificationsDisassociationTask (new) Link ¶

Initiates an asynchronous task to disassociate your partner qualifications from a primary account. You must currently be associated and cannot disassociate if you are the primary partner. Use GetQualificationsDisassociationTask to monitor task progress.

See also: AWS API Documentation

Request Syntax

client.start_qualifications_disassociation_task(
    Catalog='string',
    Identifier='string',
    ClientToken='string',
    AssociatedPartner={
        'ProfileId': 'string',
        'AccountId': 'string'
    }
)
type Catalog:

string

param Catalog:

[REQUIRED]

The catalog in which to perform the qualifications disassociation. Valid values: AWS, Sandbox.

type Identifier:

string

param Identifier:

[REQUIRED]

Your partner identifier. You can provide either a partner ID (for example, partner-abc123) or a partner ARN. You must own this identifier.

type ClientToken:

string

param ClientToken:

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

This field is autopopulated if not provided.

type AssociatedPartner:

dict

param AssociatedPartner:

[REQUIRED]

The primary partner's profile and account identifier that you are currently associated with and will disassociate from. You must provide at least one of ProfileId or AccountId. The specified partner must match your current primary association.

  • ProfileId (string) --

    The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

  • AccountId (string) --

    The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

rtype:

dict

returns:

Response Syntax

{
    'Catalog': 'string',
    'Arn': 'string',
    'Id': 'string',
    'TaskId': 'string',
    'Status': 'IN_PROGRESS'|'SUCCEEDED',
    'AssociatedPartner': {
        'ProfileId': 'string',
        'AccountId': 'string'
    },
    'StartedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Catalog (string) --

      The catalog identifier echoed from the request.

    • Arn (string) --

      The Amazon Resource Name (ARN) that uniquely identifies your partner resource.

    • Id (string) --

      Your unique partner identifier in the AWS Partner Network.

    • TaskId (string) --

      The unique identifier of the started qualifications disassociation task, in the format pqdtask-[a-z2-7]{13}.

    • Status (string) --

      The current status of the qualifications disassociation task. The initial value is IN_PROGRESS.

    • AssociatedPartner (dict) --

      The resolved primary partner's profile and account identifiers that the task is disassociating qualifications from.

      • ProfileId (string) --

        The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

      • AccountId (string) --

        The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

    • StartedAt (datetime) --

      The timestamp when the qualifications disassociation task started, in ISO 8601 format.

StartQualificationsAssociationTask (new) Link ¶

Initiates an asynchronous task to associate your partner qualifications with a primary account. You must be a subsidiary of the primary account with an active subsidiary connection. Use GetQualificationsAssociationTask to monitor task progress.

See also: AWS API Documentation

Request Syntax

client.start_qualifications_association_task(
    Catalog='string',
    Identifier='string',
    ClientToken='string',
    PrimaryPartner={
        'ProfileId': 'string',
        'AccountId': 'string'
    }
)
type Catalog:

string

param Catalog:

[REQUIRED]

The catalog in which to perform the qualifications association. Valid values: AWS, Sandbox.

type Identifier:

string

param Identifier:

[REQUIRED]

Your partner identifier. You can provide either a partner ID (for example, partner-abc123) or a partner ARN. You must own this identifier.

type ClientToken:

string

param ClientToken:

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

This field is autopopulated if not provided.

type PrimaryPartner:

dict

param PrimaryPartner:

[REQUIRED]

The primary (acquiring) partner's profile and account identifier to associate qualifications with. You must provide at least one of ProfileId or AccountId. You cannot specify yourself as the primary partner.

  • ProfileId (string) --

    The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

  • AccountId (string) --

    The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

rtype:

dict

returns:

Response Syntax

{
    'Catalog': 'string',
    'Arn': 'string',
    'Id': 'string',
    'TaskId': 'string',
    'Status': 'IN_PROGRESS'|'SUCCEEDED',
    'PrimaryPartner': {
        'ProfileId': 'string',
        'AccountId': 'string'
    },
    'StartedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Catalog (string) --

      The catalog identifier echoed from the request.

    • Arn (string) --

      The Amazon Resource Name (ARN) that uniquely identifies your partner resource.

    • Id (string) --

      Your unique partner identifier in the AWS Partner Network.

    • TaskId (string) --

      The unique identifier of the started qualifications association task, in the format pqatask-[a-z2-7]{13}.

    • Status (string) --

      The current status of the qualifications association task. The initial value is IN_PROGRESS.

    • PrimaryPartner (dict) --

      The resolved primary partner's profile and account identifiers, including both ProfileId and AccountId.

      • ProfileId (string) --

        The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

      • AccountId (string) --

        The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

    • StartedAt (datetime) --

      The timestamp when the qualifications association task started, in ISO 8601 format.

GetQualificationsAssociationTask (new) Link ¶

Retrieves the status and details of the most recent qualifications association task for your partner account. Use this operation to poll the progress of an association task initiated by StartQualificationsAssociationTask.

See also: AWS API Documentation

Request Syntax

client.get_qualifications_association_task(
    Catalog='string',
    Identifier='string'
)
type Catalog:

string

param Catalog:

[REQUIRED]

The catalog in which to look up the qualifications association task. Valid values: AWS, Sandbox.

type Identifier:

string

param Identifier:

[REQUIRED]

Your partner identifier. You can provide either a partner ID (for example, partner-abc123) or a partner ARN. You must own this identifier.

rtype:

dict

returns:

Response Syntax

{
    'Catalog': 'string',
    'Arn': 'string',
    'Id': 'string',
    'TaskId': 'string',
    'Status': 'IN_PROGRESS'|'SUCCEEDED',
    'PrimaryPartner': {
        'ProfileId': 'string',
        'AccountId': 'string'
    },
    'StartedAt': datetime(2015, 1, 1),
    'EndedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Catalog (string) --

      The catalog identifier echoed from the request.

    • Arn (string) --

      The Amazon Resource Name (ARN) that uniquely identifies your partner resource.

    • Id (string) --

      Your unique partner identifier in the AWS Partner Network.

    • TaskId (string) --

      The unique identifier of the qualifications association task, in the format pqatask-[a-z2-7]{13}.

    • Status (string) --

      The current status of the qualifications association task. Valid values: IN_PROGRESS, SUCCEEDED.

    • PrimaryPartner (dict) --

      The primary partner's profile and account identifiers that the task is associating qualifications with.

      • ProfileId (string) --

        The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

      • AccountId (string) --

        The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

    • StartedAt (datetime) --

      The timestamp when the qualifications association task started, in ISO 8601 format.

    • EndedAt (datetime) --

      The timestamp when the qualifications association task ended, in ISO 8601 format. This field is present only when the status is SUCCEEDED.

GetQualificationsAssociationDetails (new) Link ¶

Returns your current qualifications association status, the primary partner, and the full list of partners associated under the primary partner.

See also: AWS API Documentation

Request Syntax

client.get_qualifications_association_details(
    Catalog='string',
    Identifier='string'
)
type Catalog:

string

param Catalog:

[REQUIRED]

The catalog in which to look up the qualifications association. Valid values: AWS, Sandbox.

type Identifier:

string

param Identifier:

[REQUIRED]

Your partner identifier. You can provide either a partner ID (for example, partner-abc123) or a partner ARN. You must own this identifier.

rtype:

dict

returns:

Response Syntax

{
    'Catalog': 'string',
    'Arn': 'string',
    'Id': 'string',
    'Status': 'ASSOCIATED'|'NOT_ASSOCIATED',
    'PrimaryPartner': {
        'ProfileId': 'string',
        'AccountId': 'string'
    },
    'AssociatedPartners': [
        {
            'ProfileId': 'string',
            'AccountId': 'string'
        },
    ],
    'UpdatedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Catalog (string) --

      The catalog identifier echoed from the request.

    • Arn (string) --

      The Amazon Resource Name (ARN) that uniquely identifies your partner resource.

    • Id (string) --

      Your unique partner identifier in the AWS Partner Network.

    • Status (string) --

      The current qualifications association status. Valid values: ASSOCIATED (the partner is associated with a primary), NOT_ASSOCIATED (the partner has no active association).

    • PrimaryPartner (dict) --

      The primary partner's profile and account identifiers. This field is null when the status is NOT_ASSOCIATED.

      • ProfileId (string) --

        The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

      • AccountId (string) --

        The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

    • AssociatedPartners (list) --

      The list of all partner profile and account identifiers currently associated under the primary partner. This field is null when the status is NOT_ASSOCIATED.

      • (dict) --

        Identifies a partner in a qualifications association group. Contains the partner's profile identifier and AWS account identifier. In requests, provide at least one of ProfileId or AccountId. In responses, both fields are populated.

        • ProfileId (string) --

          The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

        • AccountId (string) --

          The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

    • UpdatedAt (datetime) --

      The timestamp when the qualifications association was last updated, in ISO 8601 format. This field is null when the status is NOT_ASSOCIATED.

GetQualificationsDisassociationTask (new) Link ¶

Retrieves the status and details of the most recent qualifications disassociation task for your partner account. Use this operation to poll the progress of a disassociation task initiated by StartQualificationsDisassociationTask.

See also: AWS API Documentation

Request Syntax

client.get_qualifications_disassociation_task(
    Catalog='string',
    Identifier='string'
)
type Catalog:

string

param Catalog:

[REQUIRED]

The catalog in which to look up the qualifications disassociation task. Valid values: AWS, Sandbox.

type Identifier:

string

param Identifier:

[REQUIRED]

Your partner identifier. You can provide either a partner ID (for example, partner-abc123) or a partner ARN. You must own this identifier.

rtype:

dict

returns:

Response Syntax

{
    'Catalog': 'string',
    'Arn': 'string',
    'Id': 'string',
    'TaskId': 'string',
    'Status': 'IN_PROGRESS'|'SUCCEEDED',
    'AssociatedPartner': {
        'ProfileId': 'string',
        'AccountId': 'string'
    },
    'StartedAt': datetime(2015, 1, 1),
    'EndedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • Catalog (string) --

      The catalog identifier echoed from the request.

    • Arn (string) --

      The Amazon Resource Name (ARN) that uniquely identifies your partner resource.

    • Id (string) --

      Your unique partner identifier in the AWS Partner Network.

    • TaskId (string) --

      The unique identifier of the qualifications disassociation task, in the format pqdtask-[a-z2-7]{13}.

    • Status (string) --

      The current status of the qualifications disassociation task. Valid values: IN_PROGRESS, SUCCEEDED.

    • AssociatedPartner (dict) --

      The primary partner's profile and account identifiers that the task is disassociating qualifications from.

      • ProfileId (string) --

        The unique identifier for the partner profile, in the format pprofile-*. Required in requests if AccountId is not provided.

      • AccountId (string) --

        The 12-digit AWS account ID linked to the partner profile. Required in requests if ProfileId is not provided.

    • StartedAt (datetime) --

      The timestamp when the qualifications disassociation task started, in ISO 8601 format.

    • EndedAt (datetime) --

      The timestamp when the qualifications disassociation task ended, in ISO 8601 format. This field is present only when the status is SUCCEEDED.