update_key_group

CloudFront.Client.update_key_group(**kwargs)

Updates a key group.

When you update a key group, all the fields are updated with the values provided in the request. You cannot update some fields independent of others. To update a key group:

• Get the current key group with GetKeyGroup or GetKeyGroupConfig .
• Locally modify the fields in the key group that you want to update. For example, add or remove public key IDs.
• Call UpdateKeyGroup with the entire key group object, including the fields that you modified and those that you didn't.

See also: AWS API Documentation

Request Syntax

response = client.update_key_group(
    KeyGroupConfig={
        'Name': 'string',
        'Items': [
            'string',
        ],
        'Comment': 'string'
    },
    Id='string',
    IfMatch='string'
)

Parameters

• KeyGroupConfig (dict) --

  [REQUIRED]

  The key group configuration.

  • Name (string) -- [REQUIRED]

    A name to identify the key group.

  • Items (list) -- [REQUIRED]

    A list of the identifiers of the public keys in the key group.

    • (string) --
  • Comment (string) --

    A comment to describe the key group. The comment cannot be longer than 128 characters.

• Id (string) --

  [REQUIRED]

  The identifier of the key group that you are updating.

• IfMatch (string) -- The version of the key group that you are updating. The version is the key group's ETag value.

Return type

dict

Returns

Response Syntax

{
    'KeyGroup': {
        'Id': 'string',
        'LastModifiedTime': datetime(2015, 1, 1),
        'KeyGroupConfig': {
            'Name': 'string',
            'Items': [
                'string',
            ],
            'Comment': 'string'
        }
    },
    'ETag': 'string'
}

Response Structure

• (dict) --

  • KeyGroup (dict) --

    The key group that was just updated.

    • Id (string) --

      The identifier for the key group.

    • LastModifiedTime (datetime) --

      The date and time when the key group was last modified.

    • KeyGroupConfig (dict) --

      The key group configuration.

      • Name (string) --

        A name to identify the key group.

      • Items (list) --

        A list of the identifiers of the public keys in the key group.

        • (string) --

      • Comment (string) --

        A comment to describe the key group. The comment cannot be longer than 128 characters.

  • ETag (string) --

    The identifier for this version of the key group.

Exceptions

• CloudFront.Client.exceptions.InvalidIfMatchVersion
• CloudFront.Client.exceptions.NoSuchResource
• CloudFront.Client.exceptions.PreconditionFailed
• CloudFront.Client.exceptions.KeyGroupAlreadyExists
• CloudFront.Client.exceptions.InvalidArgument
• CloudFront.Client.exceptions.TooManyPublicKeysInKeyGroup