本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateExplainabilityExport
匯出作CreateExplainability業建立的無法解釋資源。匯出的檔案會匯出至亞馬遜簡易儲存服務 (Amazon S3) 儲存貯體。
您必須指定一個DataDestination物件,其中包含 Amazon S3 儲存貯體和 Amazon Forecast 可以假定存取 Amazon S3 儲存貯體的 AWS Identity and Access Management (IAM) 角色。如需詳細資訊,請參閱 設定 Amazon Forecast 的許可。
注意
匯出任務必須是,您ACTIVE
才能存取 Amazon S3 儲存貯體中的匯出。Status
若要取得狀態,請使用DescribeExplainabilityExport作業。
請求語法
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
}
},
"ExplainabilityArn": "string
",
"ExplainabilityExportName": "string
",
"Format": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
請求參數
請求接受採用 JSON 格式的下列資料。
- Destination
-
匯出工作的目的地。提供 S3 路徑、允許 Amazon Forecast 存取位置的 AWS Identity and Access Management (IAM) 角色,以及 AWS Key Management Service (KMS) 金鑰 (選用)。
類型:DataDestination 物件
必要:是
- ExplainabilityArn
-
Amazon 資源名稱(ARN)的解釋性導出。
類型:字串
長度限制:長度上限為 256。
模式:
arn:([a-z\d-]+):forecast:.*:.*:.+
必要:是
- ExplainabilityExportName
-
「無法解釋」匯出的唯一名稱。
類型:字串
長度限制:長度下限為 1。長度上限為 63。
模式:
^[a-zA-Z][a-zA-Z0-9_]*
必要:是
- Format
-
導出數據的格式,CSV 或實木複合地板。
類型:字串
長度限制:最大長度為 7。
模式:
^CSV|PARQUET$
必要:否
- Tags
-
選用的中繼資料可協助您分類和組織資源。每個標籤皆包含由您定義的一個金鑰與一個選用值。標籤鍵與值皆區分大小寫。
以下限制適用於標籤:
-
對於每個資源,每個標籤鍵必須是唯一的,並且每個標籤鍵必須有一個值。
-
每個資源的標籤數上限:50。
-
金鑰長度上限:UTF-8 中 128 個萬國碼字元。
-
最大值長度:UTF-8 中 256 個萬國碼字元。
-
接受的字元:所有字母和數字、UTF-8 中可表示的空格,以及 +-=。_:/@。 如果您的標記結構描述在其他服務和資源之間使用,則這些服務的字元限制也適用。
-
關鍵字首碼不能包含或的任何大寫或小寫組
aws:
合。AWS:
值可以有這個前綴。如果標籤值aws
作為其前綴,但鍵沒有,則 Forecast 會將其視為使用者標籤,並會計入 50 個標籤的限制。只有 key prefix 的標籤aws
不會計入每個資源限制的標籤。您無法使用此字首編輯或刪除標籤關鍵字。
類型:Tag 物件陣列
陣列成員:項目數下限為 0。項目數上限為 200。
必要:否
-
回應語法
{
"ExplainabilityExportArn": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- ExplainabilityExportArn
-
出口的 Amazon 資源名稱(ARN)。
類型:字串
長度限制:長度上限為 256。
模式:
arn:([a-z\d-]+):forecast:.*:.*:.+
錯誤
- InvalidInputException
-
我們無法處理要求,因為它包含無效值或超出有效範圍的值。
HTTP 狀態碼:400
- LimitExceededException
-
已超過每個帳號的資源數量限制。
HTTP 狀態碼:400
- ResourceAlreadyExistsException
-
已有此名稱的資源。請使用不同的名稱再試一次。
HTTP 狀態碼:400
- ResourceInUseException
-
指定的資源正在使用中。
HTTP 狀態碼:400
- ResourceNotFoundException
-
我們找不到具有該 Amazon 資源名稱(ARN)的資源。請檢查 ARN,然後再試一次。
HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: