update-metric-set¶

Description¶

Updates a dataset.

Synopsis¶

  update-metric-set
--metric-set-arn <value>
[--metric-set-description <value>]
[--metric-list <value>]
[--offset <value>]
[--timestamp-column <value>]
[--dimension-list <value>]
[--metric-set-frequency <value>]
[--metric-source <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options¶

--metric-set-arn (string)

The ARN of the dataset to update.

--metric-set-description (string)

The dataset’s description.

--metric-list (list)

The metric list.

(structure)

A calculation made by contrasting a measure and a dimension from your source data.

MetricName -> (string)

The name of the metric.

AggregationFunction -> (string)

The function with which the metric is calculated.

Namespace -> (string)

The namespace for the metric.

Shorthand Syntax:

MetricName=string,AggregationFunction=string,Namespace=string ...

JSON Syntax:

[
  {
    "MetricName": "string",
    "AggregationFunction": "AVG"|"SUM",
    "Namespace": "string"
  }
  ...
]

--offset (integer)

After an interval ends, the amount of seconds that the detector waits before importing data. Offset is only supported for S3 and Redshift datasources.

--timestamp-column (structure)

The timestamp column.

ColumnName -> (string)

The name of the timestamp column.

ColumnFormat -> (string)

The format of the timestamp column.

Shorthand Syntax:

ColumnName=string,ColumnFormat=string

JSON Syntax:

{
  "ColumnName": "string",
  "ColumnFormat": "string"
}

--dimension-list (list)

The dimension list.

(string)

Syntax:

"string" "string" ...

--metric-set-frequency (string)

The dataset’s interval.

Possible values:

P1D

PT1H

PT10M

PT5M

--metric-source (structure)

Contains information about source data used to generate metrics.

S3SourceConfig -> (structure)

Contains information about the configuration of the S3 bucket that contains source files.

RoleArn -> (string)

The ARN of an IAM role that has read and write access permissions to the source S3 bucket.

TemplatedPathList -> (list)

A list of templated paths to the source files.

(string)

HistoricalDataPathList -> (list)

A list of paths to the historical data files.

(string)

FileFormatDescriptor -> (structure)

Contains information about a source file’s formatting.

CsvFormatDescriptor -> (structure)

Contains information about how a source CSV data file should be analyzed.

FileCompression -> (string)

The level of compression of the source CSV file.

Charset -> (string)

The character set in which the source CSV file is written.

ContainsHeader -> (boolean)

Whether or not the source CSV file contains a header.

Delimiter -> (string)

The character used to delimit the source CSV file.

HeaderList -> (list)

A list of the source CSV file’s headers, if any.

(string)

QuoteSymbol -> (string)

The character used as a quote character.

JsonFormatDescriptor -> (structure)

Contains information about how a source JSON data file should be analyzed.

FileCompression -> (string)

The level of compression of the source CSV file.

Charset -> (string)

The character set in which the source JSON file is written.

AppFlowConfig -> (structure)

Details about an AppFlow datasource.

RoleArn -> (string)

An IAM role that gives Amazon Lookout for Metrics permission to access the flow.

FlowName -> (string)

name of the flow.

CloudWatchConfig -> (structure)

Details about an Amazon CloudWatch monitoring datasource.

RoleArn -> (string)

An IAM role that gives Amazon Lookout for Metrics permission to access data in Amazon CloudWatch.

BackTestConfiguration -> (structure)

Settings for backtest mode.

RunBackTestMode -> (boolean)

Run a backtest instead of monitoring new data.

RDSSourceConfig -> (structure)

Details about an Amazon Relational Database Service (RDS) datasource.

DBInstanceIdentifier -> (string)

A string identifying the database instance.

DatabaseHost -> (string)

The host name of the database.

DatabasePort -> (integer)

The port number where the database can be accessed.

SecretManagerArn -> (string)

The Amazon Resource Name (ARN) of the AWS Secrets Manager role.

DatabaseName -> (string)

The name of the RDS database.

TableName -> (string)

The name of the table in the database.

RoleArn -> (string)

The Amazon Resource Name (ARN) of the role.

VpcConfiguration -> (structure)

An object containing information about the Amazon Virtual Private Cloud (VPC) configuration.

SubnetIdList -> (list)

An array of strings containing the Amazon VPC subnet IDs (e.g., subnet-0bb1c79de3EXAMPLE .

(string)

SecurityGroupIdList -> (list)

An array of strings containing the list of security groups.

(string)

RedshiftSourceConfig -> (structure)

Details about an Amazon Redshift database datasource.

ClusterIdentifier -> (string)

A string identifying the Redshift cluster.

DatabaseHost -> (string)

The name of the database host.

DatabasePort -> (integer)

The port number where the database can be accessed.

SecretManagerArn -> (string)

The Amazon Resource Name (ARN) of the AWS Secrets Manager role.

DatabaseName -> (string)

The Redshift database name.

TableName -> (string)

The table name of the Redshift database.

RoleArn -> (string)

The Amazon Resource Name (ARN) of the role providing access to the database.

VpcConfiguration -> (structure)

Contains information about the Amazon Virtual Private Cloud (VPC) configuration.

SubnetIdList -> (list)

An array of strings containing the Amazon VPC subnet IDs (e.g., subnet-0bb1c79de3EXAMPLE .

(string)

SecurityGroupIdList -> (list)

An array of strings containing the list of security groups.

(string)

AthenaSourceConfig -> (structure)

Details about an Amazon Athena datasource.

RoleArn -> (string)

An IAM role that gives Amazon Lookout for Metrics permission to access the data.

DatabaseName -> (string)

The database’s name.

DataCatalog -> (string)

The database’s data catalog.

TableName -> (string)

The database’s table name.

WorkGroupName -> (string)

The database’s work group name.

S3ResultsPath -> (string)

The database’s results path.

BackTestConfiguration -> (structure)

Settings for backtest mode.

RunBackTestMode -> (boolean)

Run a backtest instead of monitoring new data.

JSON Syntax:

{
  "S3SourceConfig": {
    "RoleArn": "string",
    "TemplatedPathList": ["string", ...],
    "HistoricalDataPathList": ["string", ...],
    "FileFormatDescriptor": {
      "CsvFormatDescriptor": {
        "FileCompression": "NONE"|"GZIP",
        "Charset": "string",
        "ContainsHeader": true|false,
        "Delimiter": "string",
        "HeaderList": ["string", ...],
        "QuoteSymbol": "string"
      },
      "JsonFormatDescriptor": {
        "FileCompression": "NONE"|"GZIP",
        "Charset": "string"
      }
    }
  },
  "AppFlowConfig": {
    "RoleArn": "string",
    "FlowName": "string"
  },
  "CloudWatchConfig": {
    "RoleArn": "string",
    "BackTestConfiguration": {
      "RunBackTestMode": true|false
    }
  },
  "RDSSourceConfig": {
    "DBInstanceIdentifier": "string",
    "DatabaseHost": "string",
    "DatabasePort": integer,
    "SecretManagerArn": "string",
    "DatabaseName": "string",
    "TableName": "string",
    "RoleArn": "string",
    "VpcConfiguration": {
      "SubnetIdList": ["string", ...],
      "SecurityGroupIdList": ["string", ...]
    }
  },
  "RedshiftSourceConfig": {
    "ClusterIdentifier": "string",
    "DatabaseHost": "string",
    "DatabasePort": integer,
    "SecretManagerArn": "string",
    "DatabaseName": "string",
    "TableName": "string",
    "RoleArn": "string",
    "VpcConfiguration": {
      "SubnetIdList": ["string", ...],
      "SecurityGroupIdList": ["string", ...]
    }
  },
  "AthenaSourceConfig": {
    "RoleArn": "string",
    "DatabaseName": "string",
    "DataCatalog": "string",
    "TableName": "string",
    "WorkGroupName": "string",
    "S3ResultsPath": "string",
    "BackTestConfiguration": {
      "RunBackTestMode": true|false
    }
  }
}

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output¶

MetricSetArn -> (string)

The ARN of the dataset.

Table of Contents

Feedback

User Guide

update-metric-set¶

Description¶

Synopsis¶

Options¶

Output¶