amazonka-forecast-2.0: Amazon Forecast Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.Forecast.ListDatasetImportJobs

Description

Returns a list of dataset import jobs created using the CreateDatasetImportJob operation. For each import job, this operation returns a summary of its properties, including its Amazon Resource Name (ARN). You can retrieve the complete set of properties by using the ARN with the DescribeDatasetImportJob operation. You can filter the list by providing an array of Filter objects.

This operation returns paginated results.

Synopsis

Creating a Request

data ListDatasetImportJobs Source #

See: newListDatasetImportJobs smart constructor.

Constructors

ListDatasetImportJobs' 

Fields

  • filters :: Maybe [Filter]

    An array of filters. For each filter, you provide a condition and a match statement. The condition is either IS or IS_NOT, which specifies whether to include or exclude the datasets that match the statement from the list, respectively. The match statement consists of a key and a value.

    Filter properties

    • Condition - The condition to apply. Valid values are IS and IS_NOT. To include the datasets that match the statement, specify IS. To exclude matching datasets, specify IS_NOT.
    • Key - The name of the parameter to filter on. Valid values are DatasetArn and Status.
    • Value - The value to match.

    For example, to list all dataset import jobs whose status is ACTIVE, you specify the following filter:

    "Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]
  • maxResults :: Maybe Natural

    The number of items to return in the response.

  • nextToken :: Maybe Text

    If the result of the previous request was truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.

Instances

Instances details
ToJSON ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

ToHeaders ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

ToPath ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

ToQuery ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

AWSPager ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

AWSRequest ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Associated Types

type AWSResponse ListDatasetImportJobs #

Generic ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Associated Types

type Rep ListDatasetImportJobs :: Type -> Type #

Read ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Show ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

NFData ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Methods

rnf :: ListDatasetImportJobs -> () #

Eq ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Hashable ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

type AWSResponse ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

type Rep ListDatasetImportJobs Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

type Rep ListDatasetImportJobs = D1 ('MetaData "ListDatasetImportJobs" "Amazonka.Forecast.ListDatasetImportJobs" "amazonka-forecast-2.0-HHvJwvxGrDPBJtUcnmLBqf" 'False) (C1 ('MetaCons "ListDatasetImportJobs'" 'PrefixI 'True) (S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter])) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))

newListDatasetImportJobs :: ListDatasetImportJobs Source #

Create a value of ListDatasetImportJobs with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:filters:ListDatasetImportJobs', listDatasetImportJobs_filters - An array of filters. For each filter, you provide a condition and a match statement. The condition is either IS or IS_NOT, which specifies whether to include or exclude the datasets that match the statement from the list, respectively. The match statement consists of a key and a value.

Filter properties

  • Condition - The condition to apply. Valid values are IS and IS_NOT. To include the datasets that match the statement, specify IS. To exclude matching datasets, specify IS_NOT.
  • Key - The name of the parameter to filter on. Valid values are DatasetArn and Status.
  • Value - The value to match.

For example, to list all dataset import jobs whose status is ACTIVE, you specify the following filter:

"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]

$sel:maxResults:ListDatasetImportJobs', listDatasetImportJobs_maxResults - The number of items to return in the response.

ListDatasetImportJobs, listDatasetImportJobs_nextToken - If the result of the previous request was truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.

Request Lenses

listDatasetImportJobs_filters :: Lens' ListDatasetImportJobs (Maybe [Filter]) Source #

An array of filters. For each filter, you provide a condition and a match statement. The condition is either IS or IS_NOT, which specifies whether to include or exclude the datasets that match the statement from the list, respectively. The match statement consists of a key and a value.

Filter properties

  • Condition - The condition to apply. Valid values are IS and IS_NOT. To include the datasets that match the statement, specify IS. To exclude matching datasets, specify IS_NOT.
  • Key - The name of the parameter to filter on. Valid values are DatasetArn and Status.
  • Value - The value to match.

For example, to list all dataset import jobs whose status is ACTIVE, you specify the following filter:

"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]

listDatasetImportJobs_maxResults :: Lens' ListDatasetImportJobs (Maybe Natural) Source #

The number of items to return in the response.

listDatasetImportJobs_nextToken :: Lens' ListDatasetImportJobs (Maybe Text) Source #

If the result of the previous request was truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.

Destructuring the Response

data ListDatasetImportJobsResponse Source #

See: newListDatasetImportJobsResponse smart constructor.

Constructors

ListDatasetImportJobsResponse' 

Fields

Instances

Instances details
Generic ListDatasetImportJobsResponse Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Associated Types

type Rep ListDatasetImportJobsResponse :: Type -> Type #

Read ListDatasetImportJobsResponse Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Show ListDatasetImportJobsResponse Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

NFData ListDatasetImportJobsResponse Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

Eq ListDatasetImportJobsResponse Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

type Rep ListDatasetImportJobsResponse Source # 
Instance details

Defined in Amazonka.Forecast.ListDatasetImportJobs

type Rep ListDatasetImportJobsResponse = D1 ('MetaData "ListDatasetImportJobsResponse" "Amazonka.Forecast.ListDatasetImportJobs" "amazonka-forecast-2.0-HHvJwvxGrDPBJtUcnmLBqf" 'False) (C1 ('MetaCons "ListDatasetImportJobsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "datasetImportJobs") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [DatasetImportJobSummary])) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newListDatasetImportJobsResponse Source #

Create a value of ListDatasetImportJobsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:datasetImportJobs:ListDatasetImportJobsResponse', listDatasetImportJobsResponse_datasetImportJobs - An array of objects that summarize each dataset import job's properties.

ListDatasetImportJobs, listDatasetImportJobsResponse_nextToken - If the response is truncated, Amazon Forecast returns this token. To retrieve the next set of results, use the token in the next request.

$sel:httpStatus:ListDatasetImportJobsResponse', listDatasetImportJobsResponse_httpStatus - The response's http status code.

Response Lenses

listDatasetImportJobsResponse_datasetImportJobs :: Lens' ListDatasetImportJobsResponse (Maybe [DatasetImportJobSummary]) Source #

An array of objects that summarize each dataset import job's properties.

listDatasetImportJobsResponse_nextToken :: Lens' ListDatasetImportJobsResponse (Maybe Text) Source #

If the response is truncated, Amazon Forecast returns this token. To retrieve the next set of results, use the token in the next request.