/AWS1/CL_FSXCOMPLETIONREPORT¶
Provides a report detailing the data repository task results of the files processed that match the criteria specified in the report Scope parameter.
FSx delivers the report to the file system's linked data repository in Amazon S3,
using the path specified in the report Path parameter.
You can specify whether or not a report gets generated for a task using the Enabled parameter.
CONSTRUCTOR¶
IMPORTING¶
Required arguments:¶
iv_enabled TYPE /AWS1/FSXFLAG /AWS1/FSXFLAG¶
Set
EnabledtoTrueto generate aCompletionReportwhen the task completes. If set totrue, then you need to provide a reportScope,Path, andFormat. SetEnabledtoFalseif you do not want aCompletionReportgenerated when the task completes.
Optional arguments:¶
iv_path TYPE /AWS1/FSXARCHIVEPATH /AWS1/FSXARCHIVEPATH¶
Required if
Enabledis set totrue. Specifies the location of the report on the file system's linked S3 data repository. An absolute path that defines where the completion report will be stored in the destination location. ThePathyou provide must be located within the file system’s ExportPath. An examplePathvalue is "s3://amzn-s3-demo-bucket/myExportPath/optionalPrefix". The report provides the following information for each file in the report: FilePath, FileStatus, and ErrorCode.
iv_format TYPE /AWS1/FSXREPORTFORMAT /AWS1/FSXREPORTFORMAT¶
Required if
Enabledis set totrue. Specifies the format of theCompletionReport.REPORT_CSV_20191124is the only format currently supported. WhenFormatis set toREPORT_CSV_20191124, theCompletionReportis provided in CSV format, and is delivered to{path}/task-{id}/failures.csv.
iv_scope TYPE /AWS1/FSXREPORTSCOPE /AWS1/FSXREPORTSCOPE¶
Required if
Enabledis set totrue. Specifies the scope of theCompletionReport;FAILED_FILES_ONLYis the only scope currently supported. WhenScopeis set toFAILED_FILES_ONLY, theCompletionReportonly contains information about files that the data repository task failed to process.
Queryable Attributes¶
Enabled¶
Set
EnabledtoTrueto generate aCompletionReportwhen the task completes. If set totrue, then you need to provide a reportScope,Path, andFormat. SetEnabledtoFalseif you do not want aCompletionReportgenerated when the task completes.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ENABLED() |
Getter for ENABLED, with configurable default |
ASK_ENABLED() |
Getter for ENABLED w/ exceptions if field has no value |
HAS_ENABLED() |
Determine if ENABLED has a value |
Path¶
Required if
Enabledis set totrue. Specifies the location of the report on the file system's linked S3 data repository. An absolute path that defines where the completion report will be stored in the destination location. ThePathyou provide must be located within the file system’s ExportPath. An examplePathvalue is "s3://amzn-s3-demo-bucket/myExportPath/optionalPrefix". The report provides the following information for each file in the report: FilePath, FileStatus, and ErrorCode.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PATH() |
Getter for PATH, with configurable default |
ASK_PATH() |
Getter for PATH w/ exceptions if field has no value |
HAS_PATH() |
Determine if PATH has a value |
Format¶
Required if
Enabledis set totrue. Specifies the format of theCompletionReport.REPORT_CSV_20191124is the only format currently supported. WhenFormatis set toREPORT_CSV_20191124, theCompletionReportis provided in CSV format, and is delivered to{path}/task-{id}/failures.csv.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FORMAT() |
Getter for FORMAT, with configurable default |
ASK_FORMAT() |
Getter for FORMAT w/ exceptions if field has no value |
HAS_FORMAT() |
Determine if FORMAT has a value |
Scope¶
Required if
Enabledis set totrue. Specifies the scope of theCompletionReport;FAILED_FILES_ONLYis the only scope currently supported. WhenScopeis set toFAILED_FILES_ONLY, theCompletionReportonly contains information about files that the data repository task failed to process.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SCOPE() |
Getter for SCOPE, with configurable default |
ASK_SCOPE() |
Getter for SCOPE w/ exceptions if field has no value |
HAS_SCOPE() |
Determine if SCOPE has a value |