ForecastService / Client / describe_dataset

describe_dataset#

ForecastService.Client.describe_dataset(**kwargs)#

Describes an Amazon Forecast dataset created using the CreateDataset operation.

In addition to listing the parameters specified in the CreateDataset request, this operation includes the following dataset properties:

CreationTime
LastModificationTime
Status

Request Syntax

response = client.describe_dataset(
    DatasetArn='string'
)

Parameters:

DatasetArn (string) –

[REQUIRED]

The Amazon Resource Name (ARN) of the dataset.

Return type:

dict

Returns:

Response Syntax

{
    'DatasetArn': 'string',
    'DatasetName': 'string',
    'Domain': 'RETAIL'|'CUSTOM'|'INVENTORY_PLANNING'|'EC2_CAPACITY'|'WORK_FORCE'|'WEB_TRAFFIC'|'METRICS',
    'DatasetType': 'TARGET_TIME_SERIES'|'RELATED_TIME_SERIES'|'ITEM_METADATA',
    'DataFrequency': 'string',
    'Schema': {
        'Attributes': [
            {
                'AttributeName': 'string',
                'AttributeType': 'string'|'integer'|'float'|'timestamp'|'geolocation'
            },
        ]
    },
    'EncryptionConfig': {
        'RoleArn': 'string',
        'KMSKeyArn': 'string'
    },
    'Status': 'string',
    'CreationTime': datetime(2015, 1, 1),
    'LastModificationTime': datetime(2015, 1, 1)
}

Response Structure

(dict) –
- DatasetArn (string) –
  
  The Amazon Resource Name (ARN) of the dataset.
- DatasetName (string) –
  
  The name of the dataset.
- Domain (string) –
  
  The domain associated with the dataset.
- DatasetType (string) –
  
  The dataset type.
- DataFrequency (string) –
  
  The frequency of data collection.
  
  Valid intervals are Y (Year), M (Month), W (Week), D (Day), H (Hour), 30min (30 minutes), 15min (15 minutes), 10min (10 minutes), 5min (5 minutes), and 1min (1 minute). For example, “M” indicates every month and “30min” indicates every 30 minutes.
- Schema (dict) –
  
  An array of SchemaAttribute objects that specify the dataset fields. Each SchemaAttribute specifies the name and data type of a field.
  - Attributes (list) –
    
    An array of attributes specifying the name and type of each field in a dataset.
    - (dict) –
      
      An attribute of a schema, which defines a dataset field. A schema attribute is required for every field in a dataset. The Schema object contains an array of SchemaAttribute objects.
      - AttributeName (string) –
        
        The name of the dataset field.
      - AttributeType (string) –
        
        The data type of the field.
        
        For a related time series dataset, other than date, item_id, and forecast dimensions attributes, all attributes should be of numerical type (integer/float).
- EncryptionConfig (dict) –
  
  The Key Management Service (KMS) key and the Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key.
  - RoleArn (string) –
    
    The ARN of the IAM role that Amazon Forecast can assume to access the KMS key.
    
    Passing a role across Amazon Web Services accounts is not allowed. If you pass a role that isn’t in your account, you get an InvalidInputException error.
  - KMSKeyArn (string) –
    
    The Amazon Resource Name (ARN) of the KMS key.
- Status (string) –
  
  The status of the dataset. States include:
  - ACTIVE
  - CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED
  - DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED
  - UPDATE_PENDING, UPDATE_IN_PROGRESS, UPDATE_FAILED
  The UPDATE states apply while data is imported to the dataset from a call to the CreateDatasetImportJob operation and reflect the status of the dataset import job. For example, when the import job status is CREATE_IN_PROGRESS, the status of the dataset is UPDATE_IN_PROGRESS.
  
  Note
  The Status of the dataset must be ACTIVE before you can import training data.
- CreationTime (datetime) –
  
  When the dataset was created.
- LastModificationTime (datetime) –
  
  When you create a dataset, LastModificationTime is the same as CreationTime. While data is being imported to the dataset, LastModificationTime is the current time of the DescribeDataset call. After a CreateDatasetImportJob operation has finished, LastModificationTime is when the import job completed or failed.

Exceptions

ForecastService.Client.exceptions.InvalidInputException
ForecastService.Client.exceptions.ResourceNotFoundException