com.amazonaws.services.route53

インタフェース AmazonRoute53

既知のサブインタフェースのリスト:

AmazonRoute53Async

既知の実装クラスのリスト:

AmazonRoute53AsyncClient, AmazonRoute53Client

public interface AmazonRoute53

AmazonRoute53 へアクセスするためのインターフェース

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
ChangeResourceRecordSetsResult	changeResourceRecordSets(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest) 信頼できる DNS 情報の作成、または変更をするためにはこのアクションを使ってください。
CreateHealthCheckResult	createHealthCheck(CreateHealthCheckRequest createHealthCheckRequest) 新しいヘルスチェックを作成するアクションです。
CreateHostedZoneResult	createHostedZone(CreateHostedZoneRequest createHostedZoneRequest) 新しい Hosted Zone を作成するアクションです。
DeleteHealthCheckResult	deleteHealthCheck(DeleteHealthCheckRequest deleteHealthCheckRequest) これはヘルスチェックを削除するアクションです。
DeleteHostedZoneResult	deleteHostedZone(DeleteHostedZoneRequest deleteHostedZoneRequest) これは Hosted Zone を削除するアクションです。
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) 以前実行されて成功したリクエストの追加のメタデータを返します。
GetChangeResult	getChange(GetChangeRequest getChangeRequest) 変更したバッチリクエストの現在のステータスを返すアクションです。
GetHealthCheckResult	getHealthCheck(GetHealthCheckRequest getHealthCheckRequest) ヘルスチェックを取得するには、 2012-12-12/healthcheck/health check ID に GET リクエストを送信してください。
GetHostedZoneResult	getHostedZone(GetHostedZoneRequest getHostedZoneRequest) Hosted Zone のデリゲーションセットを取得するには、 2012-12-12/hostedzone/hosted zone ID に GET リクエストを送信してください。
ListHealthChecksResult	listHealthChecks() ヘルスチェックのリストを取得するためには、 2012-12-12/healthcheck に GET リクエストを送信する必要があります。
ListHealthChecksResult	listHealthChecks(ListHealthChecksRequest listHealthChecksRequest) ヘルスチェックのリストを取得するためには、 2012-12-12/healthcheck に GET リクエストを送信する必要があります。
ListHostedZonesResult	listHostedZones() Hosted Zone のリストを取得するためには、 2012-12-12/hostedzone に GET リクエストを送信する必要があります。
ListHostedZonesResult	listHostedZones(ListHostedZonesRequest listHostedZonesRequest) Hosted Zone を取得するには、 2012-12-12/hostedzone に GET リクエストを送信してください。
ListResourceRecordSetsResult	listResourceRecordSets(ListResourceRecordSetsRequest listResourceRecordSetsRequest) あるゾーンのすべてのリソースレコードセットが並んでいるところを思い浮かべてください。
void	setEndpoint(java.lang.String endpoint) このクライアントのデフォルトのエンドポイント("https://route53.amazonaws.com")を変更します。
void	setRegion(Region region) setEndpoint(String) の代わりに、このクライアントのサービスコールのためのエンドポイント領域を設定します。
void	shutdown() 開いたままのリソースを解放し、クライアントのオブジェクトをシャットダウンします。

メソッドの詳細

setEndpoint

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

このクライアントのデフォルトのエンドポイント("https://route53.amazonaws.com")を変更します。 どの AWS リージョンで処理を実行するのかを制御するためにこのメソッドを使用します。

引数にはエンドポイントのみ (例 : "route53.amazonaws.com" ) を渡すか、プロトコルを含めたURL全体 ( 例: "https://route53.amazonaws.com" ) を渡すことができます。 プロトコルが指定していなければ、デフォルトのプロトコルはこのクライアントの ClientConfiguration の設定値が使われます。 設定値のデフォルトは HTTPS です。

AWS SDK for Java で AWS リージョンを扱うための詳細情報および、全ての AWS サーバための利用可能なエンドポイントのリストは以下を参照してください。 http://developer.amazonwebservices.com/connect/entry.jspa?externalID=3912

このメソッドはスレッドセーフではありまん。 クライアントが作成され、サービスリクエストが行われる前段階で、エンドポイントは設定されていなければなりません。 リクエストを行った後にエンドポイントを変更すると、転送中やリトライ中のリクエストは競合状態に陥ります。

パラメータ:

endpoint - The endpoint (ex: "route53.amazonaws.com") or a full URL, including the protocol (ex: "https://route53.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

setEndpoint(String) の代わりに、このクライアントのサービスコールのためのエンドポイント領域を設定します。 どの AWS リージョンを用いて操作するのかを制御するために、このメソッドを用いることができます。

デフォルトでは、リージュン内のすべてのサービスエンドポイントは https プロトコルを用いています。 http を代わりに用いるためには、生成時に ClientConfiguration を指定してください。

このメソッドはスレッドセーフではありまん。 クライアントが作成され、サービスリクエストが行われる前段階で、リージュンが設定されていなければなりません。 リクエストを行った後にリージュンを変更すると、転送中やリトライ中のリクエストは競合状態に陥ります。

パラメータ:

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)

listResourceRecordSets

ListResourceRecordSetsResult listResourceRecordSets(ListResourceRecordSetsRequest listResourceRecordSetsRequest)
                                                    throws AmazonServiceException,
                                                           AmazonClientException

あるゾーンのすべてのリソースレコードセットが並んでいるところを思い浮かべてください。 レコードはまず DNS 名 (例えば "com.amazon.www" のようにラベルを逆順にしたもの) を辞書順に並べられ、 次にレコードのタイプの辞書順に並べられているとします。 この操作によって、指定した名前、タイプの位置から始まる最大で MaxItems のリソースレコードセットを取得することができます。

• 名前やタイプを省略した場合、 HostedZone の最初の RRSET の位置から取得を始めます。
• 名前は指定され、タイプが省略されている場合は、名前が等しいリストの中から最初の RRSET の位置から結果が返されます。
• もし名前とタイプがどちらも指定されている場合、名前が等しくタイプが等しいリストの中から最初の RRSET の位置から結果が返されます。
• タイプは指定され、名前のみ指定されていない場合はエラーとなります。

既知のレコードセットを1つ取得するためには名前とタイプのを指定し、 MaxItems = 1 に設定して ListResourceRecordSets を使ってください。

HostedZone 内のすべてのレコードを取得するためには、最初に ChangeResourceRecordSet を呼び出しているすべてのプロセスを一時停止させてください。 まず、名前とタイプを指定せずに ListResourceRecordSets を呼び出し、レコードセットの最初のページを取得します。 それ以降は、先のレスポンスによって返された NextName と NextType を指定して呼び出してください。

並行して ChangeResourceRecordSets を呼び出していると、一連の ListResourceRecordSets の結果の間に一貫性がなくなります。 ゾーンの中のすべての RRSET の一貫性のあるマルチページのスナップショットを取得する唯一の方法は、ページネーションを行っている間に変更をしないことです。

しかしながら、 ListResourceRecordSets の結果はページの中では一貫性を保持しています。 もし、 MakeChange 呼び出しが同時に配置された場合、一方の結果は完全に表示され、もう一方は全く表示されません。 一部、もしくは最終的に成功していない変更は表示されません。(これは MakeChange がアトミックを持つため)

ListResourceRecordSets による結果は ChangeResourceRecordSets と強い一貫性を持ちます。 正確に言うと、もし単一プロセスが ChangeResourceRecordSets を行い、正常な結果が返ってきた場合、 その変更の影響は、以降のそのプロセスによる ListResourceRecordSets 呼び出し内で表示されます。

パラメータ:

listResourceRecordSetsRequest - Container for the necessary parameters to execute the ListResourceRecordSets service method on AmazonRoute53.

戻り値:

The response from the ListResourceRecordSets service method, as returned by AmazonRoute53.

例外:

InvalidInputException

NoSuchHostedZoneException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

changeResourceRecordSets

ChangeResourceRecordSetsResult changeResourceRecordSets(ChangeResourceRecordSetsRequest changeResourceRecordSetsRequest)
                                                        throws AmazonServiceException,
                                                               AmazonClientException

信頼できる DNS 情報の作成、または変更をするためにはこのアクションを使ってください。 このアクションを使うためには、 2012-12-12/hostedzone/hosted Zone ID/rrset 情報へ POST リクエストを送信します。 そのリクエスト内には ChangeResourceRecordSetsRequest 要素を含む XML ドキュメントを含めなければなりません。

変更は変更項目のリストであり、トランザクションとしてみなされます。 変更バッチとして知られる、トランザクション変更の詳細については Amazon Route 53 Developer Guide の Creating、Changing、Deleting を参照して下さい。

重要：トランザクション変更の性質により、単一の変更バッチ内で複数回設定された同じリソースのレコードを削除できません。 複数回設定された変更バッチを削除した場合、 Route 53 は InvalidChangeBatch エラーを返します。

ChangeResourceRecordSets リクエストの結果により、 DNS データは全ての Route 53 DNS サーバ上で変更されます。 変更直後の状態は PENDING となっています。これは、変更がまだ信頼できる全ての Route 53 DNS サーバに伝達されていないことを意味しています。 変更がすべてのホストに伝えられた時、変更は INSYNC 状態を返します。

ChangeResourceRecordSets リクエストでは以下のことに注意してください。

- 一つのリクエストに100個以上の変更要素を含めることはできません。

- 一つのリクエストに1000個以上の ResourceRecord 要素を含めることはできません。

リクエスト内の全ての Value 要素の文字数(スペースを含む)の合計は、32,000字を超えることはできません。

パラメータ:

changeResourceRecordSetsRequest - Container for the necessary parameters to execute the ChangeResourceRecordSets service method on AmazonRoute53.

戻り値:

The response from the ChangeResourceRecordSets service method, as returned by AmazonRoute53.

例外:

InvalidInputException

NoSuchHostedZoneException

InvalidChangeBatchException

NoSuchHealthCheckException

PriorRequestNotCompleteException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createHostedZone

CreateHostedZoneResult createHostedZone(CreateHostedZoneRequest createHostedZoneRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

新しい Hosted Zone を作成するアクションです。

新しい Hosted Zone を作るためには、 2012-12-12/hostedzone 情報へ POST リクエストを送信します。 リクエストには CreateHostedZoneRequest 要素を含む XML ドキュメントを含めなければなりません。 結果は Hosted Zone についてのメタデータを含む CreateHostedZoneResponse 要素が返ってきます。

Route 53 は自動的にゾーンに適したデフォルトの SOA レコードと、4つの NS レコードを作成します。 Hosted Zone 内の NS レコードはレジストラがドメインを引き渡すネームサーバです。 SOA と NS レコードについての詳細は Amazon Route 53 Developer Guide 内の Route 53 Hosted Zone に適するように作る NS と SOA レコード を参照してください。

ゾーンを作成すると、ステータスはまず PENDING になります。 これはすべての DNS サーバがまだ利用可能ではないという事を意味しています。 NS と SOA レコードがすべての Route 53 DNS サーバで利用可能になったとき、ゾーンのステータスは INSYNC に変わります。

パラメータ:

createHostedZoneRequest - Container for the necessary parameters to execute the CreateHostedZone service method on AmazonRoute53.

戻り値:

The response from the CreateHostedZone service method, as returned by AmazonRoute53.

例外:

HostedZoneAlreadyExistsException

InvalidInputException

InvalidDomainNameException

TooManyHostedZonesException

DelegationSetNotAvailableException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHealthCheck

GetHealthCheckResult getHealthCheck(GetHealthCheckRequest getHealthCheckRequest)
                                    throws AmazonServiceException,
                                           AmazonClientException

ヘルスチェックを取得するには、 2012-12-12/healthcheck/health check ID に GET リクエストを送信してください。

パラメータ:

getHealthCheckRequest - Container for the necessary parameters to execute the GetHealthCheck service method on AmazonRoute53.

戻り値:

The response from the GetHealthCheck service method, as returned by AmazonRoute53.

例外:

InvalidInputException

NoSuchHealthCheckException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

createHealthCheck

CreateHealthCheckResult createHealthCheck(CreateHealthCheckRequest createHealthCheckRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

新しいヘルスチェックを作成するアクションです。

新しいヘルスチェックを作成するには、 2012-12-12/healthcheck に 　POST リクエストを送信してください。 リクエストには、 CreateHealthCheckRequest 要素を含む XML ドキュメントを含める必要があります。 結果は、ヘルスチェックについてのメタデータを含む CreateHealthCheckResponse 要素を返します。

パラメータ:

createHealthCheckRequest - Container for the necessary parameters to execute the CreateHealthCheck service method on AmazonRoute53.

戻り値:

The response from the CreateHealthCheck service method, as returned by AmazonRoute53.

例外:

InvalidInputException

HealthCheckAlreadyExistsException

TooManyHealthChecksException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getChange

GetChangeResult getChange(GetChangeRequest getChangeRequest)
                          throws AmazonServiceException,
                                 AmazonClientException

変更したバッチリクエストの現在のステータスを返すアクションです。 ステータスは次のどれかです。

- PENDING リクエスト内での変更が全ての Route 53 DNS サーバに複製されてはいない状態を意味しています。 これはすべての変更したバッチリクエストにおける最初のステータスです。

- INSYNC 変更がすべての Amazon Route 53 DNS サーバに複製されたことを意味しています。

パラメータ:

getChangeRequest - Container for the necessary parameters to execute the GetChange service method on AmazonRoute53.

戻り値:

The response from the GetChange service method, as returned by AmazonRoute53.

例外:

NoSuchChangeException

InvalidInputException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteHealthCheck

DeleteHealthCheckResult deleteHealthCheck(DeleteHealthCheckRequest deleteHealthCheckRequest)
                                          throws AmazonServiceException,
                                                 AmazonClientException

これはヘルスチェックを削除するアクションです。 ヘルスチェックを削除するためには、 2012-12-12/healthcheck/health　check ID に DELETE リクエストを送信してください。

重要： このヘルスチェックと関連付けられたリソースレコードセットが存在しない時に限り、ヘルスチェックを削除することができます。 ヘルスチェックとリソースレコードセットが関連付けされている場合、ヘルスチェックを削除する前にヘルスチェックの関連付を解除しなければなりません。 リソースレコードセットと関連付けられているヘルスチェックを削除しようとした場合、 Route 53 は HealthCheckInUse error を表示し、リクエストを拒否します。 ヘルスチェックからレコードの関連付けを解除する方法については ChangeResourceRecordSets を参照してください。

パラメータ:

deleteHealthCheckRequest - Container for the necessary parameters to execute the DeleteHealthCheck service method on AmazonRoute53.

戻り値:

The response from the DeleteHealthCheck service method, as returned by AmazonRoute53.

例外:

InvalidInputException

HealthCheckInUseException

NoSuchHealthCheckException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

getHostedZone

GetHostedZoneResult getHostedZone(GetHostedZoneRequest getHostedZoneRequest)
                                  throws AmazonServiceException,
                                         AmazonClientException

Hosted Zone のデリゲーションセットを取得するには、 2012-12-12/hostedzone/hosted zone ID に GET リクエストを送信してください。 デリゲーションセットは、あなたが Hosted Zone を作成する際に Hosted Zone に割り当てた 4つの Route 53 ネームサーバを意味しています。

パラメータ:

getHostedZoneRequest - Container for the necessary parameters to execute the GetHostedZone service method on AmazonRoute53.

戻り値:

The response from the GetHostedZone service method, as returned by AmazonRoute53.

例外:

InvalidInputException

NoSuchHostedZoneException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHostedZones

ListHostedZonesResult listHostedZones(ListHostedZonesRequest listHostedZonesRequest)
                                      throws AmazonServiceException,
                                             AmazonClientException

Hosted Zone を取得するには、 2012-12-12/hostedzone に GET リクエストを送信してください。 結果は0,1,もしくは複数個の HostedZones の子要素を含めた HostedZones の要素が含まれるリクエストです。 デフォルトでは Hosted Zone は単一ページに表示されます。 MaxItems パラメータを操作することによって、表示するページの長さを調整することができます。 Marker パラメータを使うことで Hosted Zone のリストの開始位置を調整することもできます。

注意： Amazon Route 53 では、最大100個の項目を返します。 MaxItems に100以上の値を設定した場合、 Amazon Route 53 は最初の100のみを返します。

パラメータ:

listHostedZonesRequest - Container for the necessary parameters to execute the ListHostedZones service method on AmazonRoute53.

戻り値:

The response from the ListHostedZones service method, as returned by AmazonRoute53.

例外:

InvalidInputException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

deleteHostedZone

DeleteHostedZoneResult deleteHostedZone(DeleteHostedZoneRequest deleteHostedZoneRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

これは Hosted Zone を削除するアクションです。 Hosted Zone を削除するためには、 2012-12-12/hostedzone/hosted zone ID に DELETE リクエストを送信する必要があります。

より詳しい内容については、 Amazon Route 53 Developer Guide 内の Hosted Zone の削除 を参照してください。

重要： デフォルトの SOA レコードセットと NS リソースレコードセット以外のリソースレコードセットが存在しない時に限り、 Hosted Zone を削除することができます。 Hosted Zone に他のリソースレコードセットが含まれている場合、 Hosted Zone を削除する前にそれらのリソースレコードを削除しなければなりません。 他のリソースレコードセットが含まれている状態で Hosted Zone を消去しようとすると、 Route 53 は HostedZoneNotEmpty エラーを表示し、リクエストを拒否します。 Hosted Zone からのレコードの削除については、 ChangeResourceRecordSets を参照してください。

パラメータ:

deleteHostedZoneRequest - Container for the necessary parameters to execute the DeleteHostedZone service method on AmazonRoute53.

戻り値:

The response from the DeleteHostedZone service method, as returned by AmazonRoute53.

例外:

HostedZoneNotEmptyException

InvalidInputException

NoSuchHostedZoneException

PriorRequestNotCompleteException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHealthChecks

ListHealthChecksResult listHealthChecks(ListHealthChecksRequest listHealthChecksRequest)
                                        throws AmazonServiceException,
                                               AmazonClientException

ヘルスチェックのリストを取得するためには、 2012-12-12/healthcheck に GET リクエストを送信する必要があります。 結果には、0,1,または複数個の HealthCheck の子要素を含めた HealthChecks 要素 が含まれています。 デフォルトでは、ヘルスチェックのリストは単一ページに表示されます。 MaxItems パラメータを操作することによって、表示するページの長さを調整することができます。 Marker パラメータを使うことで、ヘルスチェックのリストの開始位置を調整することもできます。

注意： Amazon Route 53 では、最大100個の項目を返します。 MaxItems に100個以上の値を設定した場合、 Amazon Route 53 は最初の100個のみを返します。

パラメータ:

listHealthChecksRequest - Container for the necessary parameters to execute the ListHealthChecks service method on AmazonRoute53.

戻り値:

The response from the ListHealthChecks service method, as returned by AmazonRoute53.

例外:

InvalidInputException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHostedZones

ListHostedZonesResult listHostedZones()
                                      throws AmazonServiceException,
                                             AmazonClientException

Hosted Zone のリストを取得するためには、 2012-12-12/hostedzone に GET リクエストを送信する必要があります。 結果には、0,1,または複数個の HostedZone の子要素を含む HostedZones 要素 が 含まれています。 デフォルトでは Hosted Zone のリストは単一ページに表示されます。 MaxItems パラメータを操作することによって、表示するページの長さを調整することができます。 Marker パラメータを使うことで、 Hosted Zone のリストの開始位置を調整することもできます。

注意： Amazon Route 53 では、最大100個の項目を返します。 MaxItems に100個以上の値を設定した場合、 Amazon Route 53 は最初の100個のみを返します。

戻り値:

The response from the ListHostedZones service method, as returned by AmazonRoute53.

例外:

InvalidInputException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

listHealthChecks

ListHealthChecksResult listHealthChecks()
                                        throws AmazonServiceException,
                                               AmazonClientException

ヘルスチェックのリストを取得するためには、 2012-12-12/healthcheck に GET リクエストを送信する必要があります。 結果は、0,1,もしくは複数個の HealthChecks の子要素を含む、 HealthChecks の要素が 含まれてます。 デフォルトではヘルスチェックのリストは単一ページに表示されます。 MaxItems パラメータを操作することによって、表示するページの長さを調整することができます。 Marker パラメータを使うことで、ヘルスチェックのリストの開始位置を調整することもできます。

注意： Amazon Route 53 では、最大100個の項目を返します。 MaxItems に100個以上の値を設定した場合、 Amazon Route 53 は最初の100個のみを返します。

戻り値:

The response from the ListHealthChecks service method, as returned by AmazonRoute53.

例外:

InvalidInputException

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 AmazonRoute53 indicating either a problem with the data in the request, or a server side issue.

shutdown

void shutdown()

開いたままのリソースを解放し、クライアントのオブジェクトをシャットダウンします。 これは任意のメソッドです。発信者は、明示的に開かれているすべてのリソースを解放したい場合それを用いることができます。 いったんクライアントがシャットダウンされると、そのクライアントを用いたリクエストを作成してはいけません。

getCachedResponseMetadata

ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

以前実行されて成功したリクエストの追加のメタデータを返します。これは通常、期待通りのサービスが動作しない問題をデバッグするために使用されます。 このデータはオペレーションによるデータの結果の一部であるとは見なされていないので、個々の診断インターフェースを介して利用することができます。

応答メタデータは限られた時間内でのみキャッシュされるので、実行要求のため過度に診断情報にアクセスしようとする場合、 リクエストを実行した直後にリクエストを取得するためには、このメソッドを使用する必要があります。

パラメータ:

request - The originally executed request.

戻り値:

The response metadata for the specified request, or null if none is available.