Route53Profiles / Client / update_profile_association

update_profile_association

Route53Profiles.Client.update_profile_association(**kwargs)

Updates the name or priority of the specified Route 53 Profile association with a VPC. Route 53 VPC Resolver evaluates the Profile associations for a VPC in priority order, starting with the lowest value. Only the account that created the association can update it.

When you change the priority, the association status is UPDATING until the change propagates, and then COMPLETE. While the status is UPDATING, Route 53 VPC Resolver might still use the previous priority for some queries. When the status is COMPLETE, the new priority applies to all queries from the VPC.

The request fails with a ValidationException if another Profile association for the VPC already uses the priority that you specify, or if the priority is outside the range 100–9900.

You can update an association whose status is CREATING, UPDATING, or COMPLETE. The request fails with a ConflictException if the association status is DELETING, DELETED, or FAILED, or if the account that owns the association is inactive.

See also: AWS API Documentation

Request Syntax

response = client.update_profile_association(
    ProfileAssociationId='string',
    Name='string',
    Priority=123
)
Parameters:

  • ProfileAssociationId (string) –

    [REQUIRED]

    The ID of the Profile association to update.

  • Name (string) – The name of the Profile association.

  • Priority (integer) –

    The new priority of the Profile association. Route 53 VPC Resolver evaluates the Profile associations for a VPC in priority order, starting with the lowest value.

    The priority must be unique among the Profile associations for the VPC.

Return type:

dict

Returns:

Response Syntax

{
    'ProfileAssociation': {
        'Id': 'string',
        'Name': 'string',
        'OwnerId': 'string',
        'ProfileId': 'string',
        'ResourceId': 'string',
        'Status': 'COMPLETE'|'DELETING'|'UPDATING'|'CREATING'|'DELETED'|'FAILED',
        'StatusMessage': 'string',
        'CreationTime': datetime(2015, 1, 1),
        'ModificationTime': datetime(2015, 1, 1),
        'Priority': 123
    }
}

Response Structure

  • (dict) –

    • ProfileAssociation (dict) –

      Information about the UpdateProfileAssociation request, including a status message.

      • Id (string) –

        ID of the Profile association.

      • Name (string) –

        Name of the Profile association.

      • OwnerId (string) –

        Amazon Web Services account ID of the Profile association owner.

      • ProfileId (string) –

        ID of the Profile.

      • ResourceId (string) –

        The Amazon Resource Name (ARN) of the VPC.

      • Status (string) –

        Status of the Profile association.

      • StatusMessage (string) –

        Additional information about the Profile association.

      • CreationTime (datetime) –

        The date and time that the Profile association was created, in Unix time format and Coordinated Universal Time (UTC).

      • ModificationTime (datetime) –

        The date and time that the Profile association was modified, in Unix time format and Coordinated Universal Time (UTC).

      • Priority (integer) –

        The priority of the Profile association. Route 53 VPC Resolver evaluates the Profile associations for a VPC in priority order, starting with the lowest value. Associations created without a priority have priority 100.

Exceptions