PartnerCentralAccountAPI / Client / start_qualifications_association_task

start_qualifications_association_task

PartnerCentralAccountAPI.Client.start_qualifications_association_task(**kwargs)

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

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

  • Catalog (string) –

    [REQUIRED]

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

  • Identifier (string) –

    [REQUIRED]

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

  • ClientToken (string) –

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

    This field is autopopulated if not provided.

  • PrimaryPartner (dict) –

    [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.

Return type:

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.

Exceptions