DescribeDataset - Amazon Forecast
請求語法請求參數回應語法回應元素錯誤另請參閱

Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用該服務。了解更多」

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

DescribeDataset

描述使用CreateDataset作業建立的 Amazon Forecast 資料集。

重要

Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用該服務。了解更多」

除了列出CreateDataset要求中指定的參數之外，此作業還包含下列資料集屬性：

  • CreationTime

  • LastModificationTime

  • Status

請求語法

{
   "DatasetArn": "string"
}

請求參數

請求接受以下JSON格式的數據。

DatasetArn

資料集的 Amazon 資源名稱 (ARN)。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):forecast:.*:.*:.+

必要：是

回應語法

{
   "CreationTime": number,
   "DataFrequency": "string",
   "DatasetArn": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "LastModificationTime": number,
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Status": "string"
}

回應元素

如果動作成功，服務會傳回 HTTP 200 回應。

服務會以JSON格式傳回下列資料。

CreationTime

建立資料集的時間。

類型：Timestamp

DataFrequency

資料收集的頻率。

有效間隔為 Y (年)、M (月)、W (週)、D (天)、H (小時)、30min (30 分鐘)、15min (15 分鐘)、10min (10 分鐘)、5min (5 分鐘) 和 1min (1 分鐘)。例如，「M」表示每個月，「30 分鐘」表示每 30 分鐘一次。

類型：字串

長度限制：長度下限為 1。最大長度為 5。

模式：^Y|M|W|D|H|30min|15min|10min|5min|1min$

DatasetArn

資料集的 Amazon 資源名稱 (ARN)。

類型：字串

長度限制：長度上限為 256。

模式：arn:([a-z\d-]+):forecast:.*:.*:.+

DatasetName

資料集的名稱。

類型：字串

長度限制：長度下限為 1。長度上限為 63。

模式：^[a-zA-Z][a-zA-Z0-9_]*

DatasetType

資料集類型。

類型：字串

有效值:TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Domain

與資料集相關聯的網域。

類型：字串

有效值:RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

EncryptionConfig

Amazon Forecast 可以承擔訪問密鑰的 AWS Identity and Access Management （IAM）鍵和（）角色。 AWS Key Management Service KMS

類型：EncryptionConfig 物件

LastModificationTime

當您建立資料集LastModificationTime時，與CreationTime. 將資料匯入資料集時，LastModificationTime是DescribeDataset呼叫的目前時間。CreateDatasetImportJob操作完成後，LastModificationTime是指導入作業完成或失敗的時間。

類型：Timestamp

Schema

指定資料集欄位的SchemaAttribute物件陣列。每個SchemaAttribute指定一個字段的名稱和數據類型。

類型：Schema 物件

Status

資料集的狀態。各州包括：

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • UPDATE_PENDING, UPDATE_IN_PROGRESS, UPDATE_FAILED

這些狀UPDATE態會在從作業呼叫匯入資料集時套用，並反映資料集匯入工CreateDatasetImportJob作的狀態。例如，當匯入工作狀態為時CREATE_IN_PROGRESS，資料集的狀態為UPDATE_IN_PROGRESS。

注意

資Status料集必須位於您可以匯入訓練資料ACTIVE之前。

類型：字串

長度限制：長度上限為 256。

錯誤

InvalidInputException

我們無法處理要求，因為它包含無效值或超出有效範圍的值。

HTTP狀態碼:

ResourceNotFoundException

我們找不到具有該 Amazon 資源名稱（ARN）的資源。檢查ARN並再試一次。

HTTP狀態碼:

另請參閱

如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：