本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
AddApplicationCloudWatchLoggingOption
添加 Amazon CloudWatch 日志流以监控应用程序配置错误。
请求语法
{
"ApplicationName": "string
",
"CloudWatchLoggingOption": {
"LogStreamARN": "string
"
},
"ConditionalToken": "string
",
"CurrentApplicationVersionId": number
}
请求参数
请求接受采用 JSON 格式的以下数据。
- ApplicationName
-
Kinesis Data Analytics 应用程序的名称。
类型:字符串
长度限制:长度下限为 1。长度上限为 128。
模式:
[a-zA-Z0-9_.-]+
必需:是
- CloudWatchLoggingOption
-
提供亚马逊 CloudWatch 日志流亚马逊资源名称 (ARN)。
类型:CloudWatchLoggingOption 对象
必需:是
- ConditionalToken
-
用于实现应用程序更新强并发性的值。您必须提供
CurrentApplicationVersionId
或ConditionalToken
。使用 DescribeApplication 获得应用程序的当前ConditionalToken
。要获得更理想的并发支持,请使用ConditionalToken
参数代替CurrentApplicationVersionId
。类型:字符串
长度限制:长度下限为 1。最大长度为 512。
模式:
[a-zA-Z0-9-_+/=]+
必需:否
- CurrentApplicationVersionId
-
基于 SQL 的 Kinesis Data Analytics 应用程序的版本 ID。您必须提供
CurrentApplicationVersionId
或ConditionalToken
。您可以使用 DescribeApplication 检索应用程序版本 ID。要获得更理想的并发支持,请使用ConditionalToken
参数代替CurrentApplicationVersionId
。类型:长整型
有效范围:最小值为 1。最大值为 999999999。
必需:否
响应语法
{
"ApplicationARN": "string",
"ApplicationVersionId": number,
"CloudWatchLoggingOptionDescriptions": [
{
"CloudWatchLoggingOptionId": "string",
"LogStreamARN": "string",
"RoleARN": "string"
}
],
"OperationId": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- ApplicationARN
-
应用程序的 ARN。
类型:字符串
长度限制:最小长度为 0。最大长度为 2048。
模式:
arn:.*
- ApplicationVersionId
-
基于 SQL 的 Kinesis Data Analytics 应用程序的新版本 ID。每次您更改 CloudWatch 日志选项时,Kinesis Data Analytics 都会更新
ApplicationVersionId
。类型:长整型
有效范围:最小值为 1。最大值为 999999999。
- CloudWatchLoggingOptionDescriptions
-
基于 SQL 的 Kinesis Data Analytics 应用程序的当前 CloudWatch 日志记录选项的描述。
- OperationId
-
可用于跟踪请求的操作 ID。
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
错误
- ConcurrentModificationException
-
由于对应用程序进行并发修改而引发的异常。此错误可能是由于在未使用当前应用程序 ID 的情况下尝试修改应用程序所致。
HTTP 状态代码:400
- InvalidApplicationConfigurationException
-
用户提供的应用程序配置无效。
HTTP 状态代码:400
- InvalidArgumentException
-
指定的输入参数值无效。
HTTP 状态代码:400
- InvalidRequestException
-
操作的请求 JSON 无效。
HTTP 状态代码:400
- ResourceInUseException
-
该应用程序不可用于此操作。
HTTP 状态代码:400
- ResourceNotFoundException
-
无法找到指定的应用程序。
HTTP 状态代码:400
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: