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