drs / Client / describe_job_log_items

describe_job_log_items

drs.Client.describe_job_log_items(**kwargs)

Retrieves a detailed Job log with pagination.

See also: AWS API Documentation

Request Syntax

response = client.describe_job_log_items(
    jobID='string',
    maxResults=123,
    nextToken='string'
)

Parameters:

• jobID (string) –

  [REQUIRED]

  The ID of the Job for which Job log items will be retrieved.

• maxResults (integer) – Maximum number of Job log items to retrieve.

• nextToken (string) – The token of the next Job log items to retrieve.

Return type:

dict

Returns:

Response Syntax

{
    'items': [
        {
            'event': 'JOB_START'|'SERVER_SKIPPED'|'CLEANUP_START'|'CLEANUP_END'|'CLEANUP_FAIL'|'SNAPSHOT_START'|'SNAPSHOT_END'|'SNAPSHOT_FAIL'|'USING_PREVIOUS_SNAPSHOT'|'USING_PREVIOUS_SNAPSHOT_FAILED'|'CONVERSION_START'|'CONVERSION_END'|'CONVERSION_FAIL'|'LAUNCH_START'|'LAUNCH_FAILED'|'JOB_CANCEL'|'JOB_END',
            'eventData': {
                'conversionProperties': {
                    'dataTimestamp': 'string',
                    'forceUefi': True|False,
                    'rootVolumeName': 'string',
                    'volumeToConversionMap': {
                        'string': {
                            'string': 'string'
                        }
                    },
                    'volumeToVolumeSize': {
                        'string': 123
                    }
                },
                'conversionServerID': 'string',
                'rawError': 'string',
                'sourceServerID': 'string',
                'targetInstanceID': 'string'
            },
            'logDateTime': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  • items (list) –

    An array of Job log items.

    • (dict) –

      A log outputted by a Job.

      • event (string) –

        The event represents the type of a log.

      • eventData (dict) –

        Metadata associated with a Job log.

        • conversionProperties (dict) –

          Properties of a conversion job

          • dataTimestamp (string) –

            The timestamp of when the snapshot being converted was taken

          • forceUefi (boolean) –

            Whether the volume being converted uses UEFI or not

          • rootVolumeName (string) –

            The root volume name of a conversion job

          • volumeToConversionMap (dict) –

            A mapping between the volumes being converted and the converted snapshot ids

            • (string) –

              • (dict) –

                • (string) –

                  • (string) –

          • volumeToVolumeSize (dict) –

            A mapping between the volumes and their sizes

            • (string) –

              • (integer) –

        • conversionServerID (string) –

          The ID of a conversion server.

        • rawError (string) –

          A string representing a job error.

        • sourceServerID (string) –

          The ID of a Source Server.

        • targetInstanceID (string) –

          The ID of a Recovery Instance.

      • logDateTime (string) –

        The date and time the log was taken.

  • nextToken (string) –

    The token of the next Job log items to retrieve.

Exceptions

• drs.Client.exceptions.InternalServerException

• drs.Client.exceptions.ThrottlingException

• drs.Client.exceptions.ValidationException

• drs.Client.exceptions.UninitializedAccountException