Class: AWS::Core::Response

Inherits:
Object
  • Object
show all
Includes:
AsyncHandle
Defined in:
lib/aws/core/response.rb

Overview

Response

Each Service has a Client class. There is one method per service operation defined on the client. These methods all return a Response object.

In addition to the response data, these responses provide metadata about the HTTP request made and the HTTP response received.

Response Data

You can access the response data for a client request using the #data method or the #[] method. Response data is a hash and #[] is a shortcut for accessing this hash.

# make a request to describe one instance
ec2 = AWS::EC2.new
response = ec2.client.describe_instances(:instance_ids => ['i-12345678'])

# find the instance in the response data (2 ways to get the data)
instance = response[:reservation_set].first[:instance_set].first
instance = response.data[:reservation_set].first[:instance_set].first

instance[:status] #=> 'running'

Response Metadata

In addition to the response data, there is additional information available with the response, including:

Given the example and response object from above:

response.request_type #=> :describe_instances
response.request_options #=> { :instance_ids => ['i-12345678'] }
response.http_request #=> #<AWS::Core::Http::Request>
response.http_response #=> #<AWS::Core::Http::Response>

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from AsyncHandle

#on_complete, #on_failure, #on_success, #signal_failure, #signal_success

Constructor Details

#initialize(http_request = nil, http_response = nil, &block) ⇒ Response

Returns a new instance of Response.

Parameters:



101
102
103
104
105
106
107
108
109
 
# File 'lib/aws/core/response.rb', line 101

def initialize http_request = nil, http_response = nil, &block
  @http_request = http_request
  @http_response = http_response
  @request_builder = block
  @data = {}
  @retry_count = 0
  @duration = 0
  build_request if @request_builder && !http_request
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(*args, &block) ⇒ Object (protected)

Note:

The prefered method to get as response data is to use #[].

This provides a backwards-compat layer to the old response objects where each response value had a method extended onto this object. Now all response data is accessible as a hash.

See Also:



180
181
182
 
# File 'lib/aws/core/response.rb', line 180

def method_missing *args, &block
  Core::Data.new(data).send(*args, &block)
end

Instance Attribute Details

#cached ⇒ Boolean Also known as: cached?

Returns true if the response was generated from a another cached response.

Returns:

  • (Boolean) —

    true if the response was generated from a another cached response.



82
83
84
 
# File 'lib/aws/core/response.rb', line 82

def cached
  @cached
end

#data ⇒ Hash

Returns the response data as a hash.

Returns:

  • (Hash) —

    Returns the response data as a hash.



64
65
66
 
# File 'lib/aws/core/response.rb', line 64

def data
  @data
end

#duration ⇒ Float

Returns The total number of seconds taken to make the request and return the response.

Returns:

  • (Float) —

    The total number of seconds taken to make the request and return the response.



97
98
99
 
# File 'lib/aws/core/response.rb', line 97

def duration
  @duration
end

#error ⇒ AWS::Error?

Returns nil unless the request failed. Normally this will be nil unless you are using the Asynchronous interface.

Returns:

  • (AWS::Error, nil) —

    Returns nil unless the request failed. Normally this will be nil unless you are using the Asynchronous interface.



89
90
91
 
# File 'lib/aws/core/response.rb', line 89

def error
  @error
end

#http_request ⇒ Core::Http::Request

Returns:



75
76
77
 
# File 'lib/aws/core/response.rb', line 75

def http_request
  @http_request
end

#http_response ⇒ Core::Http::Response

Returns:



78
79
80
 
# File 'lib/aws/core/response.rb', line 78

def http_response
  @http_response
end

#request_options ⇒ Hash

Returns the hash of options passed to the client request method that generated this response.

Returns:

  • (Hash) —

    Returns the hash of options passed to the client request method that generated this response.



72
73
74
 
# File 'lib/aws/core/response.rb', line 72

def request_options
  @request_options
end

#request_type ⇒ Symbol

The name of the client request method that returned this response.

Returns:

  • (Symbol) —

    The name of the client request method that returned this response.



68
69
70
 
# File 'lib/aws/core/response.rb', line 68

def request_type
  @request_type
end

#retry_count ⇒ Integer

Returns the number of times the request was retried.

Returns:

  • (Integer) —

    Returns the number of times the request was retried.



93
94
95
 
# File 'lib/aws/core/response.rb', line 93

def retry_count
  @retry_count
end

Instance Method Details

#[](key) ⇒ Hash?

Provides access to the response data. This is a short-cut for calling response.data[key].

Parameters:

  • key (Symbol, String)

Returns:

  • (Hash, nil) 


116
117
118
 
# File 'lib/aws/core/response.rb', line 116

def [] key
  data[key]
end

#network_error? ⇒ Boolean

Returns true if the http request failed due to a networking issue.

Returns:

  • (Boolean) —

    Returns true if the http request failed due to a networking issue.



127
128
129
 
# File 'lib/aws/core/response.rb', line 127

def network_error?
  http_response.network_error?
end

#safe_to_retry? ⇒ Boolean

Returns false if it is not safe to retry a request. This happens when the http request body is an IO object that can not be rewound and re-streamed.

Returns:

  • (Boolean) —

    Returns false if it is not safe to retry a request. This happens when the http request body is an IO object that can not be rewound and re-streamed.



160
161
162
163
 
# File 'lib/aws/core/response.rb', line 160

def safe_to_retry?
  @http_request.body_stream.nil? or
  @http_request.body_stream.respond_to?(:rewind)
end

#successful? ⇒ Boolean

Returns true if there is no response error.

Returns:

  • (Boolean) —

    Returns true if there is no response error.



121
122
123
 
# File 'lib/aws/core/response.rb', line 121

def successful?
  error.nil?
end