com.amazonaws.services.dynamodb

## インタフェース AmazonDynamoDB

- 既知のサブインタフェースのリスト:
    AmazonDynamoDBAsync
  既知の実装クラスのリスト:
    AmazonDynamoDBAsyncClient, AmazonDynamoDBClient

  非推奨です。

      @Deprecated
      public interface AmazonDynamoDB

  Interface for accessing AmazonDynamoDB.

  Amazon DynamoDB is a fast, highly scalable, highly available, cost-effective non-relational database service.

  Amazon DynamoDB removes traditional scalability limitations on data storage while maintaining low latency and predictable performance.

- - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `BatchGetItemResult` | `batchGetItem(BatchGetItemRequest batchGetItemRequest)` 非推奨です。 Retrieves the attributes for multiple items from multiple tables using their primary keys.
    `BatchWriteItemResult` | `batchWriteItem(BatchWriteItemRequest batchWriteItemRequest)` 非推奨です。 Allows to execute a batch of Put and/or Delete Requests for many tables in a single call.
    `CreateTableResult` | `createTable(CreateTableRequest createTableRequest)` 非推奨です。 Adds a new table to your account.
    `DeleteItemResult` | `deleteItem(DeleteItemRequest deleteItemRequest)` 非推奨です。 Deletes a single item in a table by primary key.
    `DeleteTableResult` | `deleteTable(DeleteTableRequest deleteTableRequest)` 非推奨です。 Deletes a table and all of its items.
    `DescribeTableResult` | `describeTable(DescribeTableRequest describeTableRequest)` 非推奨です。 Retrieves information about the table, including the current status of the table, the primary key schema and when the table was created.
    `ResponseMetadata` | `getCachedResponseMetadata(AmazonWebServiceRequest request)` 非推奨です。 Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
    `GetItemResult` | `getItem(GetItemRequest getItemRequest)` 非推奨です。 Retrieves a set of Attributes for an item that matches the primary key.
    `ListTablesResult` | `listTables()` 非推奨です。 Retrieves a paginated list of table names created by the AWS Account of the caller in the AWS Region (e.g.
    `ListTablesResult` | `listTables(ListTablesRequest listTablesRequest)` 非推奨です。 Retrieves a paginated list of table names created by the AWS Account of the caller in the AWS Region (e.g.
    `PutItemResult` | `putItem(PutItemRequest putItemRequest)` 非推奨です。 Creates a new item, or replaces an old item with a new item (including all the attributes).
    `QueryResult` | `query(QueryRequest queryRequest)` 非推奨です。 Gets the values of one or more items and its attributes by primary key (composite primary key, only).
    `ScanResult` | `scan(ScanRequest scanRequest)` 非推奨です。 Retrieves one or more items and its attributes by performing a full scan of a table.
    `void` | `setEndpoint(java.lang.String endpoint)` 非推奨です。 Overrides the default endpoint for this client ("http://dynamodb.us-east-1.amazonaws.com/").
    `void` | `setRegion(Region region)` 非推奨です。 An alternative to `setEndpoint(String)`, sets the regional endpoint for this client's service calls.
    `void` | `shutdown()` 非推奨です。 Shuts down this client object, releasing any resources that might be held open.
    `UpdateItemResult` | `updateItem(UpdateItemRequest updateItemRequest)` 非推奨です。 Edits an existing item's attributes.
    `UpdateTableResult` | `updateTable(UpdateTableRequest updateTableRequest)` 非推奨です。 Updates the provisioned throughput for the given table.

- - ### メソッドの詳細

    - #### setEndpoint

          void setEndpoint(java.lang.String endpoint)
                           throws java.lang.IllegalArgumentException

      非推奨です。
      Overrides the default endpoint for this client ("http://dynamodb.us-east-1.amazonaws.com/"). Callers can use this method to control which AWS region they want to work with.

      Callers can pass in just the endpoint (ex: "dynamodb.us-east-1.amazonaws.com/") or a full URL, including the protocol (ex: "http://dynamodb.us-east-1.amazonaws.com/"). If the protocol is not specified here, the default protocol from this client's `ClientConfiguration` will be used, which by default is HTTPS.

      For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912

      This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

      パラメータ:
        `endpoint` - The endpoint (ex: "dynamodb.us-east-1.amazonaws.com/") or a full URL, including the protocol (ex: "http://dynamodb.us-east-1.amazonaws.com/") of the region specific AWS endpoint this client will communicate with.
      例外:
        `java.lang.IllegalArgumentException` - If any problems are detected with the specified endpoint.

    - #### setRegion

          void setRegion(Region region)
                         throws java.lang.IllegalArgumentException

      非推奨です。
      An alternative to `setEndpoint(String)`, sets the regional endpoint for this client's service calls. Callers can use this method to control which AWS region they want to work with.

      By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the `ClientConfiguration` supplied at construction.

      This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

      パラメータ:
        `region` - The region this client will communicate with. See `Region.getRegion(com.amazonaws.regions.Regions)` for accessing a given region.
      例外:
        `java.lang.IllegalArgumentException` - If the given region is null, or if this service isn't available in the given region. See `Region.isServiceSupported(String)`
      関連項目:
        `Region.getRegion(com.amazonaws.regions.Regions)`, `Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)`

    - #### listTables

          ListTablesResult listTables(ListTablesRequest listTablesRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

      非推奨です。

      Retrieves a paginated list of table names created by the AWS Account of the caller in the AWS Region (e.g. `us-east-1` ).

      パラメータ:
        `listTablesRequest` - Container for the necessary parameters to execute the ListTables service method on AmazonDynamoDB.
      戻り値:
        The response from the ListTables service method, as returned by AmazonDynamoDB.
      例外:
        `InternalServerErrorException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### query

          QueryResult query(QueryRequest queryRequest)
                            throws AmazonServiceException,
                                   AmazonClientException

      非推奨です。

      Gets the values of one or more items and its attributes by primary key (composite primary key, only).

      Narrow the scope of the query using comparison operators on the `RangeKeyValue` of the composite key. Use the `ScanIndexForward` parameter to get results in forward or reverse order by range key.

      パラメータ:
        `queryRequest` - Container for the necessary parameters to execute the Query service method on AmazonDynamoDB.
      戻り値:
        The response from the Query service method, as returned by AmazonDynamoDB.
      例外:
        `ProvisionedThroughputExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### batchWriteItem

          BatchWriteItemResult batchWriteItem(BatchWriteItemRequest batchWriteItemRequest)
                                              throws AmazonServiceException,
                                                     AmazonClientException

      非推奨です。

      Allows to execute a batch of Put and/or Delete Requests for many tables in a single call. A total of 25 requests are allowed.

      There are no transaction guarantees provided by this API. It does not allow conditional puts nor does it support return values.

      パラメータ:
        `batchWriteItemRequest` - Container for the necessary parameters to execute the BatchWriteItem service method on AmazonDynamoDB.
      戻り値:
        The response from the BatchWriteItem service method, as returned by AmazonDynamoDB.
      例外:
        `LimitExceededException`
        `ProvisionedThroughputExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### updateItem

          UpdateItemResult updateItem(UpdateItemRequest updateItemRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

      非推奨です。

      Edits an existing item's attributes.

      You can perform a conditional update (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected attribute values).

      パラメータ:
        `updateItemRequest` - Container for the necessary parameters to execute the UpdateItem service method on AmazonDynamoDB.
      戻り値:
        The response from the UpdateItem service method, as returned by AmazonDynamoDB.
      例外:
        `LimitExceededException`
        `ProvisionedThroughputExceededException`
        `ConditionalCheckFailedException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### putItem

          PutItemResult putItem(PutItemRequest putItemRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

      非推奨です。

      Creates a new item, or replaces an old item with a new item (including all the attributes).

      If an item already exists in the specified table with the same primary key, the new item completely replaces the existing item. You can perform a conditional put (insert a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values.

      パラメータ:
        `putItemRequest` - Container for the necessary parameters to execute the PutItem service method on AmazonDynamoDB.
      戻り値:
        The response from the PutItem service method, as returned by AmazonDynamoDB.
      例外:
        `LimitExceededException`
        `ProvisionedThroughputExceededException`
        `ConditionalCheckFailedException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### describeTable

          DescribeTableResult describeTable(DescribeTableRequest describeTableRequest)
                                            throws AmazonServiceException,
                                                   AmazonClientException

      非推奨です。

      Retrieves information about the table, including the current status of the table, the primary key schema and when the table was created.

      If the table does not exist, Amazon DynamoDB returns a `ResourceNotFoundException` .

      パラメータ:
        `describeTableRequest` - Container for the necessary parameters to execute the DescribeTable service method on AmazonDynamoDB.
      戻り値:
        The response from the DescribeTable service method, as returned by AmazonDynamoDB.
      例外:
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### scan

          ScanResult scan(ScanRequest scanRequest)
                          throws AmazonServiceException,
                                 AmazonClientException

      非推奨です。

      Retrieves one or more items and its attributes by performing a full scan of a table.

      Provide a `ScanFilter` to get more specific results.

      パラメータ:
        `scanRequest` - Container for the necessary parameters to execute the Scan service method on AmazonDynamoDB.
      戻り値:
        The response from the Scan service method, as returned by AmazonDynamoDB.
      例外:
        `ProvisionedThroughputExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### createTable

          CreateTableResult createTable(CreateTableRequest createTableRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

      非推奨です。

      Adds a new table to your account.

      The table name must be unique among those associated with the AWS Account issuing the request, and the AWS Region that receives the request (e.g. `us-east-1` ).

      The `CreateTable` operation triggers an asynchronous workflow to begin creating the table. Amazon DynamoDB immediately returns the state of the table ( `CREATING` ) until the table is in the `ACTIVE` state. Once the table is in the `ACTIVE` state, you can perform data plane operations.

      パラメータ:
        `createTableRequest` - Container for the necessary parameters to execute the CreateTable service method on AmazonDynamoDB.
      戻り値:
        The response from the CreateTable service method, as returned by AmazonDynamoDB.
      例外:
        `ResourceInUseException`
        `LimitExceededException`
        `InternalServerErrorException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### updateTable

          UpdateTableResult updateTable(UpdateTableRequest updateTableRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

      非推奨です。

      Updates the provisioned throughput for the given table.

      Setting the throughput for a table helps you manage performance and is part of the Provisioned Throughput feature of Amazon DynamoDB.

      パラメータ:
        `updateTableRequest` - Container for the necessary parameters to execute the UpdateTable service method on AmazonDynamoDB.
      戻り値:
        The response from the UpdateTable service method, as returned by AmazonDynamoDB.
      例外:
        `ResourceInUseException`
        `LimitExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### deleteTable

          DeleteTableResult deleteTable(DeleteTableRequest deleteTableRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

      非推奨です。

      Deletes a table and all of its items.

      If the table is in the `ACTIVE` state, you can delete it. If a table is in `CREATING` or `UPDATING` states then Amazon DynamoDB returns a `ResourceInUseException` . If the specified table does not exist, Amazon DynamoDB returns a `ResourceNotFoundException` .

      パラメータ:
        `deleteTableRequest` - Container for the necessary parameters to execute the DeleteTable service method on AmazonDynamoDB.
      戻り値:
        The response from the DeleteTable service method, as returned by AmazonDynamoDB.
      例外:
        `ResourceInUseException`
        `LimitExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### deleteItem

          DeleteItemResult deleteItem(DeleteItemRequest deleteItemRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

      非推奨です。

      Deletes a single item in a table by primary key.

      You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.

      パラメータ:
        `deleteItemRequest` - Container for the necessary parameters to execute the DeleteItem service method on AmazonDynamoDB.
      戻り値:
        The response from the DeleteItem service method, as returned by AmazonDynamoDB.
      例外:
        `LimitExceededException`
        `ProvisionedThroughputExceededException`
        `ConditionalCheckFailedException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### getItem

          GetItemResult getItem(GetItemRequest getItemRequest)
                                throws AmazonServiceException,
                                       AmazonClientException

      非推奨です。

      Retrieves a set of Attributes for an item that matches the primary key.

      The `GetItem` operation provides an eventually-consistent read by default. If eventually-consistent reads are not acceptable for your application, use `ConsistentRead` . Although this operation might take longer than a standard read, it always returns the last updated value.

      パラメータ:
        `getItemRequest` - Container for the necessary parameters to execute the GetItem service method on AmazonDynamoDB.
      戻り値:
        The response from the GetItem service method, as returned by AmazonDynamoDB.
      例外:
        `ProvisionedThroughputExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### batchGetItem

          BatchGetItemResult batchGetItem(BatchGetItemRequest batchGetItemRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

      非推奨です。

      Retrieves the attributes for multiple items from multiple tables using their primary keys.

      The maximum number of item attributes that can be retrieved for a single operation is 100. Also, the number of items retrieved is constrained by a 1 MB the size limit. If the response size limit is exceeded or a partial result is returned due to an internal processing failure, Amazon DynamoDB returns an `UnprocessedKeys` value so you can retry the operation starting with the next item to get.

      Amazon DynamoDB automatically adjusts the number of items returned per page to enforce this limit. For example, even if you ask to retrieve 100 items, but each individual item is 50k in size, the system returns 20 items and an appropriate `UnprocessedKeys` value so you can get the next page of results. If necessary, your application needs its own logic to assemble the pages of results into one set.

      パラメータ:
        `batchGetItemRequest` - Container for the necessary parameters to execute the BatchGetItem service method on AmazonDynamoDB.
      戻り値:
        The response from the BatchGetItem service method, as returned by AmazonDynamoDB.
      例外:
        `ProvisionedThroughputExceededException`
        `InternalServerErrorException`
        `ResourceNotFoundException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### listTables

          ListTablesResult listTables()
                                      throws AmazonServiceException,
                                             AmazonClientException

      非推奨です。

      Retrieves a paginated list of table names created by the AWS Account of the caller in the AWS Region (e.g. `us-east-1` ).

      戻り値:
        The response from the ListTables service method, as returned by AmazonDynamoDB.
      例外:
        `InternalServerErrorException`
        `AmazonClientException` - If any internal errors are encountered inside the client while attempting to make the request or handle the response. For example if a network connection is not available.
        `AmazonServiceException` - If an error response is returned by AmazonDynamoDB indicating either a problem with the data in the request, or a server side issue.

    - #### shutdown

          void shutdown()

      非推奨です。
      Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.

    - #### getCachedResponseMetadata

          ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

      非推奨です。
      Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

      Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

      パラメータ:
        `request` - The originally executed request.
      戻り値:
        The response metadata for the specified request, or null if none is available.