update_public_key

CloudFront.Client.update_public_key(**kwargs)

Update public key information. Note that the only value you can change is the comment.

See also: AWS API Documentation

Request Syntax

response = client.update_public_key(
    PublicKeyConfig={
        'CallerReference': 'string',
        'Name': 'string',
        'EncodedKey': 'string',
        'Comment': 'string'
    },
    Id='string',
    IfMatch='string'
)
Parameters
  • PublicKeyConfig (dict) --

    [REQUIRED]

    A public key configuration.

    • CallerReference (string) -- [REQUIRED]

      A string included in the request to help make sure that the request can't be replayed.

    • Name (string) -- [REQUIRED]

      A name to help identify the public key.

    • EncodedKey (string) -- [REQUIRED]

      The public key that you can use with signed URLs and signed cookies, or with field-level encryption.

    • Comment (string) --

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

  • Id (string) --

    [REQUIRED]

    The identifier of the public key that you are updating.

  • IfMatch (string) -- The value of the ETag header that you received when retrieving the public key to update. For example: E2QWRUHAPOMQZL .
Return type

dict

Returns

Response Syntax

{
    'PublicKey': {
        'Id': 'string',
        'CreatedTime': datetime(2015, 1, 1),
        'PublicKeyConfig': {
            'CallerReference': 'string',
            'Name': 'string',
            'EncodedKey': 'string',
            'Comment': 'string'
        }
    },
    'ETag': 'string'
}

Response Structure

  • (dict) --

    • PublicKey (dict) --

      The public key.

      • Id (string) --

        The identifier of the public key.

      • CreatedTime (datetime) --

        The date and time when the public key was uploaded.

      • PublicKeyConfig (dict) --

        Configuration information about a public key that you can use with signed URLs and signed cookies, or with field-level encryption.

        • CallerReference (string) --

          A string included in the request to help make sure that the request can't be replayed.

        • Name (string) --

          A name to help identify the public key.

        • EncodedKey (string) --

          The public key that you can use with signed URLs and signed cookies, or with field-level encryption.

        • Comment (string) --

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

    • ETag (string) --

      The identifier of the current version of the public key.

Exceptions

  • CloudFront.Client.exceptions.AccessDenied
  • CloudFront.Client.exceptions.CannotChangeImmutablePublicKeyFields
  • CloudFront.Client.exceptions.InvalidArgument
  • CloudFront.Client.exceptions.InvalidIfMatchVersion
  • CloudFront.Client.exceptions.IllegalUpdate
  • CloudFront.Client.exceptions.NoSuchPublicKey
  • CloudFront.Client.exceptions.PreconditionFailed