Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。

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

# UpdateTable
<a name="API_UpdateTable"></a>

Timestream テーブルのメモリストアとマグネティックストアの保持期間を変更します。保持期間の変更は即時に有効になることに注意してください。例えば、メモリストアの保持期間が最初に 2 時間に設定され、その後 24 時間に変更された場合、メモリストアは 24 時間分のデータを保持できますが、この変更が行われた 22 時間後に 24 時間分のデータが入力されます。Timestream は、メモリストアに入力するためにマグネティックストアからデータを取得しません。

詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html)を参照してください。

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

```
{
   "DatabaseName": "string",
   "MagneticStoreWriteProperties": { 
      "EnableMagneticStoreWrites": boolean,
      "MagneticStoreRejectedDataLocation": { 
         "S3Configuration": { 
            "BucketName": "string",
            "EncryptionOption": "string",
            "KmsKeyId": "string",
            "ObjectKeyPrefix": "string"
         }
      }
   },
   "RetentionProperties": { 
      "MagneticStoreRetentionPeriodInDays": number,
      "MemoryStoreRetentionPeriodInHours": number
   },
   "Schema": { 
      "CompositePartitionKey": [ 
         { 
            "EnforcementInRecord": "string",
            "Name": "string",
            "Type": "string"
         }
      ]
   },
   "TableName": "string"
}
```

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

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

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

 ** [DatabaseName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-DatabaseName"></a>
Timestream データベースの名前。  
タイプ: 文字列  
長さの制約: 最小長は 3 です。最大長は 256 です。  
必須: はい

 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-MagneticStoreWriteProperties"></a>
磁気ストアの書き込みを有効にするときに表に設定するプロパティが含まれます。  
型: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) オブジェクト  
必須: いいえ

 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-RetentionProperties"></a>
メモリストアとマグネティックストアの保持期間。  
型: [RetentionProperties](API_RetentionProperties.md) オブジェクト  
必須: いいえ

 ** [Schema](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-Schema"></a>
 テーブルのスキーマ。  
型: [Schema](API_Schema.md) オブジェクト  
必須: いいえ

 ** [TableName](#API_UpdateTable_RequestSyntax) **   <a name="timestream-UpdateTable-request-TableName"></a>
Timestream テーブルの名前。  
タイプ: 文字列  
長さの制約: 最小長は 3 です。最大長は 256 です。  
必須: はい

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

```
{
   "Table": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "LastUpdatedTime": number,
      "MagneticStoreWriteProperties": { 
         "EnableMagneticStoreWrites": boolean,
         "MagneticStoreRejectedDataLocation": { 
            "S3Configuration": { 
               "BucketName": "string",
               "EncryptionOption": "string",
               "KmsKeyId": "string",
               "ObjectKeyPrefix": "string"
            }
         }
      },
      "RetentionProperties": { 
         "MagneticStoreRetentionPeriodInDays": number,
         "MemoryStoreRetentionPeriodInHours": number
      },
      "Schema": { 
         "CompositePartitionKey": [ 
            { 
               "EnforcementInRecord": "string",
               "Name": "string",
               "Type": "string"
            }
         ]
      },
      "TableName": "string",
      "TableStatus": "string"
   }
}
```

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

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

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

 ** [Table](#API_UpdateTable_ResponseSyntax) **   <a name="timestream-UpdateTable-response-Table"></a>
更新された Timestream テーブル。  
型: [Table](API_Table.md) オブジェクト

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

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
このアクションを実行する権限がありません。  
HTTP ステータスコード: 400

 ** InternalServerException **   
 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。  
HTTP ステータスコード: 500

 ** InvalidEndpointException **   
リクエストされたエンドポイントが有効ではありませんでした。  
HTTP ステータスコード: 400

 ** ResourceNotFoundException **   
オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。  
HTTP ステータスコード: 400

 ** ThrottlingException **   
 ユーザーによるリクエストが多すぎたため、サービスクォータを超過しました。リクエストがスロットリングされました。  
HTTP ステータスコード: 400

 ** ValidationException **   
 リクエストが無効であるか、形式が正しくありません。  
HTTP ステータスコード: 400

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

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