翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AddApplicationOutput
<a name="API_AddApplicationOutput"></a>

SQL ベースの Kinesis Data Analytics アプリケーションに外部送信先を追加します。

Kinesis Data Analytics で、データをアプリケーションのアプリケーション内ストリームから外部送信先 (Kinesis Data Streams、Kinesis Data Firehose の配信ストリーム、Amazon Lambda 関数など) に配信するように設定する場合は、このオペレーションを使用して関連する構成をアプリケーションに追加します。アプリケーションに対して 1 つ以上の出力を設定できます。各出力構成により、アプリケーション内ストリームと外部送信先がマッピングされます。

 いずれかの出力構成を使用して、データをアプリケーション内エラーストリームから外部送信先に配信できます。これにより、エラーの分析が可能になります。

 このオペレーションを使用したストリーミングソースの追加などのすべての構成の更新により、アプリケーションの新しいバージョンになります。[DescribeApplication](API_DescribeApplication.md) オペレーションを使用して、現在のアプリケーションバージョンを見つけることができます。

## リクエストの構文
<a name="API_AddApplicationOutput_RequestSyntax"></a>

```
{
   "ApplicationName": "string",
   "CurrentApplicationVersionId": number,
   "Output": { 
      "DestinationSchema": { 
         "RecordFormatType": "string"
      },
      "KinesisFirehoseOutput": { 
         "ResourceARN": "string"
      },
      "KinesisStreamsOutput": { 
         "ResourceARN": "string"
      },
      "LambdaOutput": { 
         "ResourceARN": "string"
      },
      "Name": "string"
   }
}
```

## リクエストパラメーター
<a name="API_AddApplicationOutput_RequestParameters"></a>

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [ApplicationName](#API_AddApplicationOutput_RequestSyntax) **   <a name="APIReference-AddApplicationOutput-request-ApplicationName"></a>
出力設定を追加するアプリケーションの名前です。  
タイプ: 文字列  
長さの制限: 最小長は 1 です。最大長は 128 です。  
パターン: `[a-zA-Z0-9_.-]+`   
必須: はい

 ** [CurrentApplicationVersionId](#API_AddApplicationOutput_RequestSyntax) **   <a name="APIReference-AddApplicationOutput-request-CurrentApplicationVersionId"></a>
出力設定を追加するアプリケーションのバージョン。[DescribeApplication](API_DescribeApplication.md) オペレーションを使用して、現在のアプリケーションバージョンを見つけることができます。指定したバージョンが現在のバージョンでない場合は、`ConcurrentModificationException` が返されます。  
タイプ: Long  
有効範囲: 最小値は 1 です。最大値は 999999999 です。  
必須: はい

 ** [Output](#API_AddApplicationOutput_RequestSyntax) **   <a name="APIReference-AddApplicationOutput-request-Output"></a>
それぞれが 1 つの出力構成を記述するオブジェクトの配列です。出力構成では、アプリケーション内ストリームの名前、送信先 (つまり、Kinesis データストリーム、Kinesis Data Firehose 配信ストリーム、または Amazon Lambda 関数) を指定し、送信先に書き込むときに使用するフォーメーションを記録します。  
型: [Output](API_Output.md) オブジェクト  
必須: はい

## レスポンスの構文
<a name="API_AddApplicationOutput_ResponseSyntax"></a>

```
{
   "ApplicationARN": "string",
   "ApplicationVersionId": number,
   "OutputDescriptions": [ 
      { 
         "DestinationSchema": { 
            "RecordFormatType": "string"
         },
         "KinesisFirehoseOutputDescription": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "KinesisStreamsOutputDescription": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "LambdaOutputDescription": { 
            "ResourceARN": "string",
            "RoleARN": "string"
         },
         "Name": "string",
         "OutputId": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_AddApplicationOutput_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [ApplicationARN](#API_AddApplicationOutput_ResponseSyntax) **   <a name="APIReference-AddApplicationOutput-response-ApplicationARN"></a>
アプリケーションの Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 2,048 です。  
パターン: `arn:.*` 

 ** [ApplicationVersionId](#API_AddApplicationOutput_ResponseSyntax) **   <a name="APIReference-AddApplicationOutput-response-ApplicationVersionId"></a>
更新されたアプリケーションバージョン ID。Kinesis Data Analytics は、アプリケーションが更新されると、この ID を増分します。  
タイプ: Long  
有効範囲: 最小値は 1 です。最大値は 999999999 です。

 ** [OutputDescriptions](#API_AddApplicationOutput_ResponseSyntax) **   <a name="APIReference-AddApplicationOutput-response-OutputDescriptions"></a>
アプリケーション出力の設定を記述します。詳細については、「[アプリケーション出力の設定](https://docs.aws.amazon.com/kinesisanalytics/latest/dev/how-it-works-output.html)」を参照してください。  
型: [OutputDescription](API_OutputDescription.md) オブジェクトの配列

## エラー
<a name="API_AddApplicationOutput_Errors"></a>

 ** ConcurrentModificationException **   
アプリケーションへの同時変更の結果としてスローされる例外。このエラーは、現在のアプリケーション ID を使用せずにアプリケーションを変更しようとしたことが原因である可能性があります。  
HTTP ステータスコード: 400

 ** InvalidArgumentException **   
指定された入力パラメータ値が無効です。  
HTTP ステータスコード: 400

 ** InvalidRequestException **   
要求された JSON はオペレーションに対して無効です。  
HTTP ステータスコード: 400

 ** ResourceInUseException **   
このオペレーションではアプリケーションを使用できません。  
HTTP ステータスコード: 400

 ** ResourceNotFoundException **   
指定されたアプリケーションが見つかりません。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_AddApplicationOutput_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisanalyticsv2-2018-05-23/AddApplicationOutput)