ApplicationDiscoveryService / Client / describe_export_tasks

describe_export_tasks#

ApplicationDiscoveryService.Client.describe_export_tasks(**kwargs)#

Retrieve status of one or more export tasks. You can retrieve the status of up to 100 export tasks.

See also: AWS API Documentation

Request Syntax

response = client.describe_export_tasks(
    exportIds=[
        'string',
    ],
    filters=[
        {
            'name': 'string',
            'values': [
                'string',
            ],
            'condition': 'string'
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters:
  • exportIds (list) –

    One or more unique identifiers used to query the status of an export request.

    • (string) –

  • filters (list) –

    One or more filters.

    • AgentId - ID of the agent whose collected data will be exported

    • (dict) –

      Used to select which agent’s data is to be exported. A single agent ID may be selected for export using the StartExportTask action.

      • name (string) – [REQUIRED]

        A single ExportFilter name. Supported filters: agentIds.

      • values (list) – [REQUIRED]

        A single agent ID for a Discovery Agent. An agent ID can be found using the DescribeAgents action. Typically an ADS agent ID is in the form o-0123456789abcdef0.

        • (string) –

      • condition (string) – [REQUIRED]

        Supported condition: EQUALS

  • maxResults (integer) – The maximum number of volume results returned by DescribeExportTasks in paginated output. When this parameter is used, DescribeExportTasks only returns maxResults results in a single page along with a nextToken response element.

  • nextToken (string) – The nextToken value returned from a previous paginated DescribeExportTasks request where maxResults was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the nextToken value. This value is null when there are no more results to return.

Return type:

dict

Returns:

Response Syntax

{
    'exportsInfo': [
        {
            'exportId': 'string',
            'exportStatus': 'FAILED'|'SUCCEEDED'|'IN_PROGRESS',
            'statusMessage': 'string',
            'configurationsDownloadUrl': 'string',
            'exportRequestTime': datetime(2015, 1, 1),
            'isTruncated': True|False,
            'requestedStartTime': datetime(2015, 1, 1),
            'requestedEndTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) –

    • exportsInfo (list) –

      Contains one or more sets of export request details. When the status of a request is SUCCEEDED, the response includes a URL for an Amazon S3 bucket where you can view the data in a CSV file.

      • (dict) –

        Information regarding the export status of discovered data. The value is an array of objects.

        • exportId (string) –

          A unique identifier used to query an export.

        • exportStatus (string) –

          The status of the data export job.

        • statusMessage (string) –

          A status message provided for API callers.

        • configurationsDownloadUrl (string) –

          A URL for an Amazon S3 bucket where you can review the exported data. The URL is displayed only if the export succeeded.

        • exportRequestTime (datetime) –

          The time that the data export was initiated.

        • isTruncated (boolean) –

          If true, the export of agent information exceeded the size limit for a single export and the exported data is incomplete for the requested time range. To address this, select a smaller time range for the export by using startDate and endDate.

        • requestedStartTime (datetime) –

          The value of startTime parameter in the StartExportTask request. If no startTime was requested, this result does not appear in ExportInfo.

        • requestedEndTime (datetime) –

          The endTime used in the StartExportTask request. If no endTime was requested, this result does not appear in ExportInfo.

    • nextToken (string) –

      The nextToken value to include in a future DescribeExportTasks request. When the results of a DescribeExportTasks request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.

Exceptions

  • ApplicationDiscoveryService.Client.exceptions.AuthorizationErrorException

  • ApplicationDiscoveryService.Client.exceptions.InvalidParameterException

  • ApplicationDiscoveryService.Client.exceptions.InvalidParameterValueException

  • ApplicationDiscoveryService.Client.exceptions.ServerInternalErrorException

  • ApplicationDiscoveryService.Client.exceptions.HomeRegionNotSetException