put_object

put_object(**kwargs)

Upload object that can store object metadata String and data blob in single API call using inline chunk field.

See also: AWS API Documentation

Request Syntax

response = client.put_object(
    BackupJobId='string',
    ObjectName='string',
    MetadataString='string',
    InlineChunk=b'bytes'|file,
    InlineChunkLength=123,
    InlineChunkChecksum='string',
    InlineChunkChecksumAlgorithm='string',
    ObjectChecksum='string',
    ObjectChecksumAlgorithm='SUMMARY',
    ThrowOnDuplicate=True|False
)

Parameters

• BackupJobId (string) -- [REQUIRED] Backup job Id for the in-progress backup.
• ObjectName (string) -- [REQUIRED] The name of the Object to be uploaded.
• MetadataString (string) -- Store user defined metadata like backup checksum, disk ids, restore metadata etc.
• InlineChunk (bytes or seekable file-like object) -- Inline chunk data to be uploaded.
• InlineChunkLength (integer) -- Length of the inline chunk data.
• InlineChunkChecksum (string) -- Inline chunk checksum
• InlineChunkChecksumAlgorithm (string) -- Inline chunk checksum algorithm
• ObjectChecksum (string) -- object checksum
• ObjectChecksumAlgorithm (string) -- object checksum algorithm
• ThrowOnDuplicate (boolean) -- Throw an exception if Object name is already exist.

Return type

dict

Returns

Response Syntax

{
    'InlineChunkChecksum': 'string',
    'InlineChunkChecksumAlgorithm': 'SHA256',
    'ObjectChecksum': 'string',
    'ObjectChecksumAlgorithm': 'SUMMARY'
}

Response Structure

• (dict) --
  • InlineChunkChecksum (string) -- Inline chunk checksum
  • InlineChunkChecksumAlgorithm (string) -- Inline chunk checksum algorithm
  • ObjectChecksum (string) -- object checksum
  • ObjectChecksumAlgorithm (string) -- object checksum algorithm

Exceptions

• BackupStorage.Client.exceptions.ServiceUnavailableException
• BackupStorage.Client.exceptions.ServiceInternalException
• BackupStorage.Client.exceptions.NotReadableInputStreamException
• BackupStorage.Client.exceptions.RetryableException
• BackupStorage.Client.exceptions.IllegalArgumentException
• BackupStorage.Client.exceptions.ThrottlingException
• BackupStorage.Client.exceptions.KMSInvalidKeyUsageException
• BackupStorage.Client.exceptions.AccessDeniedException