esp_sdk 2.0.0 → 2.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (148) hide show
  1. checksums.yaml +4 -4
  2. data/.travis.yml +1 -0
  3. data/CHANGELOG.md +6 -1
  4. data/Gemfile.lock +11 -1
  5. data/README.md +287 -28
  6. data/bin/esp +15 -0
  7. data/esp_sdk.gemspec +2 -0
  8. data/lib/esp/aws_clients.rb +60 -0
  9. data/lib/esp/commands/add_external_account.rb +57 -0
  10. data/lib/esp/commands/commands_tasks.rb +106 -0
  11. data/lib/esp/commands/console.rb +68 -0
  12. data/lib/esp/extensions/active_resource/formats/json_api_format.rb +12 -4
  13. data/lib/esp/extensions/active_resource/paginated_collection.rb +5 -5
  14. data/lib/esp/extensions/active_resource/validations.rb +1 -1
  15. data/lib/esp/external_account_creator.rb +77 -0
  16. data/lib/esp/resources/alert.rb +30 -34
  17. data/lib/esp/resources/cloud_trail_event.rb +5 -0
  18. data/lib/esp/resources/contact_request.rb +6 -5
  19. data/lib/esp/resources/custom_signature.rb +32 -56
  20. data/lib/esp/resources/dashboard.rb +8 -1
  21. data/lib/esp/resources/external_account.rb +27 -19
  22. data/lib/esp/resources/organization.rb +27 -3
  23. data/lib/esp/resources/region.rb +15 -3
  24. data/lib/esp/resources/report.rb +28 -24
  25. data/lib/esp/resources/resource.rb +26 -10
  26. data/lib/esp/resources/service.rb +5 -0
  27. data/lib/esp/resources/signature.rb +28 -12
  28. data/lib/esp/resources/stat.rb +21 -2
  29. data/lib/esp/resources/stat_custom_signature.rb +30 -4
  30. data/lib/esp/resources/stat_region.rb +29 -3
  31. data/lib/esp/resources/stat_service.rb +29 -3
  32. data/lib/esp/resources/stat_signature.rb +29 -3
  33. data/lib/esp/resources/sub_organization.rb +27 -3
  34. data/lib/esp/resources/suppression/region.rb +14 -32
  35. data/lib/esp/resources/suppression/signature.rb +14 -40
  36. data/lib/esp/resources/suppression/unique_identifier.rb +8 -6
  37. data/lib/esp/resources/suppression.rb +43 -5
  38. data/lib/esp/resources/tag.rb +5 -0
  39. data/lib/esp/resources/team.rb +33 -9
  40. data/lib/esp/resources/user.rb +29 -3
  41. data/lib/esp/version.rb +1 -1
  42. data/lib/esp.rb +25 -5
  43. data/test/esp/aws_clients_test.rb +101 -0
  44. data/test/esp/extensions/active_resource/formats/json_api_format_test.rb +26 -12
  45. data/test/esp/extensions/active_resource/paginated_collection_test.rb +93 -72
  46. data/test/esp/extensions/active_resource/validations_test.rb +2 -12
  47. data/test/esp/external_account_creator_test.rb +153 -0
  48. data/test/esp/resources/alert_test.rb +71 -33
  49. data/test/esp/resources/cloud_trail_event_test.rb +9 -1
  50. data/test/esp/resources/contact_request_test.rb +8 -0
  51. data/test/esp/resources/custom_signature_test.rb +8 -0
  52. data/test/esp/resources/dashboard_test.rb +8 -0
  53. data/test/esp/resources/external_account_test.rb +8 -0
  54. data/test/esp/resources/metadata_test.rb +1 -1
  55. data/test/esp/resources/organization_test.rb +8 -0
  56. data/test/esp/resources/region_test.rb +12 -4
  57. data/test/esp/resources/report_test.rb +13 -4
  58. data/test/esp/resources/resource_test.rb +208 -64
  59. data/test/esp/resources/service_test.rb +8 -0
  60. data/test/esp/resources/signature_test.rb +15 -9
  61. data/test/esp/resources/stat_custom_signature_test.rb +9 -1
  62. data/test/esp/resources/stat_region_test.rb +23 -1
  63. data/test/esp/resources/stat_service_test.rb +23 -1
  64. data/test/esp/resources/stat_signature_test.rb +23 -1
  65. data/test/esp/resources/stat_test.rb +52 -8
  66. data/test/esp/resources/sub_organization_test.rb +8 -0
  67. data/test/esp/resources/suppression/region_test.rb +10 -2
  68. data/test/esp/resources/suppression/signature_test.rb +10 -2
  69. data/test/esp/resources/suppression/unique_identifier_test.rb +10 -2
  70. data/test/esp/resources/suppression_test.rb +74 -14
  71. data/test/esp/resources/tag_test.rb +9 -1
  72. data/test/esp/resources/team_test.rb +8 -0
  73. data/test/esp/resources/user_test.rb +49 -19
  74. data/test/esp_test.rb +19 -1
  75. data/test/factories/alerts.rb +70 -0
  76. data/test/factories/organizations.rb +2 -2
  77. data/test/factories/regions.rb +1 -1
  78. data/test/factories/sub_organizations.rb +1 -1
  79. data/test/factories/suppressions.rb +109 -3
  80. data/test/factories/users.rb +65 -2
  81. data/test/test_helper.rb +9 -8
  82. metadata +41 -69
  83. data/bin/esp_console +0 -67
  84. data/rdoc/ActiveResource/Formats.html +0 -178
  85. data/rdoc/ActiveResource/PaginatedCollection.html +0 -912
  86. data/rdoc/ActiveResource.html +0 -182
  87. data/rdoc/ESP/Alert.html +0 -808
  88. data/rdoc/ESP/CloudTrailEvent.html +0 -377
  89. data/rdoc/ESP/ContactRequest.html +0 -368
  90. data/rdoc/ESP/CustomSignature.html +0 -748
  91. data/rdoc/ESP/Dashboard.html +0 -357
  92. data/rdoc/ESP/ExternalAccount.html +0 -567
  93. data/rdoc/ESP/Metadata.html +0 -411
  94. data/rdoc/ESP/Organization.html +0 -592
  95. data/rdoc/ESP/Region.html +0 -401
  96. data/rdoc/ESP/Report.html +0 -624
  97. data/rdoc/ESP/Service.html +0 -382
  98. data/rdoc/ESP/Signature.html +0 -557
  99. data/rdoc/ESP/Stat.html +0 -1780
  100. data/rdoc/ESP/StatCustomSignature.html +0 -1601
  101. data/rdoc/ESP/StatRegion.html +0 -1600
  102. data/rdoc/ESP/StatService.html +0 -1600
  103. data/rdoc/ESP/StatSignature.html +0 -1600
  104. data/rdoc/ESP/SubOrganization.html +0 -542
  105. data/rdoc/ESP/Suppression/Region.html +0 -456
  106. data/rdoc/ESP/Suppression/Signature.html +0 -472
  107. data/rdoc/ESP/Suppression/UniqueIdentifier.html +0 -419
  108. data/rdoc/ESP/Suppression.html +0 -651
  109. data/rdoc/ESP/Tag.html +0 -373
  110. data/rdoc/ESP/Team.html +0 -586
  111. data/rdoc/ESP/User.html +0 -485
  112. data/rdoc/ESP.html +0 -549
  113. data/rdoc/README_md.html +0 -503
  114. data/rdoc/created.rid +0 -31
  115. data/rdoc/images/add.png +0 -0
  116. data/rdoc/images/arrow_up.png +0 -0
  117. data/rdoc/images/brick.png +0 -0
  118. data/rdoc/images/brick_link.png +0 -0
  119. data/rdoc/images/bug.png +0 -0
  120. data/rdoc/images/bullet_black.png +0 -0
  121. data/rdoc/images/bullet_toggle_minus.png +0 -0
  122. data/rdoc/images/bullet_toggle_plus.png +0 -0
  123. data/rdoc/images/date.png +0 -0
  124. data/rdoc/images/delete.png +0 -0
  125. data/rdoc/images/find.png +0 -0
  126. data/rdoc/images/loadingAnimation.gif +0 -0
  127. data/rdoc/images/macFFBgHack.png +0 -0
  128. data/rdoc/images/package.png +0 -0
  129. data/rdoc/images/page_green.png +0 -0
  130. data/rdoc/images/page_white_text.png +0 -0
  131. data/rdoc/images/page_white_width.png +0 -0
  132. data/rdoc/images/plugin.png +0 -0
  133. data/rdoc/images/ruby.png +0 -0
  134. data/rdoc/images/tag_blue.png +0 -0
  135. data/rdoc/images/tag_green.png +0 -0
  136. data/rdoc/images/transparent.png +0 -0
  137. data/rdoc/images/wrench.png +0 -0
  138. data/rdoc/images/wrench_orange.png +0 -0
  139. data/rdoc/images/zoom.png +0 -0
  140. data/rdoc/index.html +0 -136
  141. data/rdoc/js/darkfish.js +0 -155
  142. data/rdoc/js/jquery.js +0 -4
  143. data/rdoc/js/navigation.js +0 -142
  144. data/rdoc/js/search.js +0 -94
  145. data/rdoc/js/search_index.js +0 -1
  146. data/rdoc/js/searcher.js +0 -228
  147. data/rdoc/rdoc.css +0 -595
  148. data/rdoc/table_of_contents.html +0 -942
data/rdoc/ESP/Alert.html DELETED
@@ -1,808 +0,0 @@
1
- <!DOCTYPE html>
2
-
3
- <html>
4
- <head>
5
- <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
6
-
7
- <title>class ESP::Alert - ESPSDK</title>
8
-
9
- <link type="text/css" media="screen" href="../rdoc.css" rel="stylesheet">
10
-
11
- <script type="text/javascript">
12
- var rdoc_rel_prefix = "../";
13
- </script>
14
-
15
- <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
16
- <script type="text/javascript" charset="utf-8" src="../js/navigation.js"></script>
17
- <script type="text/javascript" charset="utf-8" src="../js/search_index.js"></script>
18
- <script type="text/javascript" charset="utf-8" src="../js/search.js"></script>
19
- <script type="text/javascript" charset="utf-8" src="../js/searcher.js"></script>
20
- <script type="text/javascript" charset="utf-8" src="../js/darkfish.js"></script>
21
-
22
-
23
- <body id="top" class="class">
24
- <nav id="metadata">
25
- <nav id="home-section" class="section">
26
- <h3 class="section-header">
27
- <a href="../index.html">Home</a>
28
- <a href="../table_of_contents.html#classes">Classes</a>
29
- <a href="../table_of_contents.html#methods">Methods</a>
30
- </h3>
31
- </nav>
32
-
33
-
34
- <nav id="search-section" class="section project-section" class="initially-hidden">
35
- <form action="#" method="get" accept-charset="utf-8">
36
- <h3 class="section-header">
37
- <input type="text" name="search" placeholder="Search" id="search-field"
38
- title="Type to search, Up and Down to navigate, Enter to load">
39
- </h3>
40
- </form>
41
-
42
- <ul id="search-results" class="initially-hidden"></ul>
43
- </nav>
44
-
45
-
46
-
47
-
48
- <div id="file-metadata">
49
- <nav id="file-list-section" class="section">
50
- <h3 class="section-header">Defined In</h3>
51
- <ul>
52
- <li>lib/esp/resources/alert.rb
53
- </ul>
54
- </nav>
55
-
56
-
57
- </div>
58
-
59
- <div id="class-metadata">
60
-
61
- <nav id="parent-class-section" class="section">
62
- <h3 class="section-header">Parent</h3>
63
-
64
- <p class="link">ESP::Resource
65
-
66
- </nav>
67
-
68
-
69
-
70
- <!-- Method Quickref -->
71
- <nav id="method-list-section" class="section">
72
- <h3 class="section-header">Methods</h3>
73
-
74
- <ul class="link-list">
75
-
76
- <li class="calls-super" ><a href="#method-c-find">::find</a>
77
-
78
- <li ><a href="#method-c-for_report">::for_report</a>
79
-
80
- <li ><a href="#method-i-cloud_trail_events">#cloud_trail_events</a>
81
-
82
- <li ><a href="#method-i-custom_signature">#custom_signature</a>
83
-
84
- <li ><a href="#method-i-destroy">#destroy</a>
85
-
86
- <li ><a href="#method-i-external_account">#external_account</a>
87
-
88
- <li ><a href="#method-i-metadata">#metadata</a>
89
-
90
- <li ><a href="#method-i-region">#region</a>
91
-
92
- <li ><a href="#method-i-save">#save</a>
93
-
94
- <li ><a href="#method-i-signature">#signature</a>
95
-
96
- <li ><a href="#method-i-suppress_region">#suppress_region</a>
97
-
98
- <li ><a href="#method-i-suppress_signature">#suppress_signature</a>
99
-
100
- <li ><a href="#method-i-suppress_unique_identifier">#suppress_unique_identifier</a>
101
-
102
- <li ><a href="#method-i-suppression">#suppression</a>
103
-
104
- <li ><a href="#method-i-tags">#tags</a>
105
-
106
- </ul>
107
- </nav>
108
-
109
- </div>
110
-
111
- <div id="project-metadata">
112
- <nav id="fileindex-section" class="section project-section">
113
- <h3 class="section-header">Pages</h3>
114
-
115
- <ul>
116
-
117
- <li class="file"><a href="../README_md.html">README</a>
118
-
119
- </ul>
120
- </nav>
121
-
122
- <nav id="classindex-section" class="section project-section">
123
- <h3 class="section-header">Class and Module Index</h3>
124
-
125
- <ul class="link-list">
126
-
127
- <li><a href="../ActiveResource.html">ActiveResource</a>
128
-
129
- <li><a href="../ActiveResource/Formats.html">ActiveResource::Formats</a>
130
-
131
- <li><a href="../ActiveResource/PaginatedCollection.html">ActiveResource::PaginatedCollection</a>
132
-
133
- <li><a href="../ESP.html">ESP</a>
134
-
135
- <li><a href="../ESP/Alert.html">ESP::Alert</a>
136
-
137
- <li><a href="../ESP/CloudTrailEvent.html">ESP::CloudTrailEvent</a>
138
-
139
- <li><a href="../ESP/ContactRequest.html">ESP::ContactRequest</a>
140
-
141
- <li><a href="../ESP/CustomSignature.html">ESP::CustomSignature</a>
142
-
143
- <li><a href="../ESP/Dashboard.html">ESP::Dashboard</a>
144
-
145
- <li><a href="../ESP/ExternalAccount.html">ESP::ExternalAccount</a>
146
-
147
- <li><a href="../ESP/Metadata.html">ESP::Metadata</a>
148
-
149
- <li><a href="../ESP/Organization.html">ESP::Organization</a>
150
-
151
- <li><a href="../ESP/Region.html">ESP::Region</a>
152
-
153
- <li><a href="../ESP/Report.html">ESP::Report</a>
154
-
155
- <li><a href="../ESP/Service.html">ESP::Service</a>
156
-
157
- <li><a href="../ESP/Signature.html">ESP::Signature</a>
158
-
159
- <li><a href="../ESP/Stat.html">ESP::Stat</a>
160
-
161
- <li><a href="../ESP/StatCustomSignature.html">ESP::StatCustomSignature</a>
162
-
163
- <li><a href="../ESP/StatRegion.html">ESP::StatRegion</a>
164
-
165
- <li><a href="../ESP/StatService.html">ESP::StatService</a>
166
-
167
- <li><a href="../ESP/StatSignature.html">ESP::StatSignature</a>
168
-
169
- <li><a href="../ESP/SubOrganization.html">ESP::SubOrganization</a>
170
-
171
- <li><a href="../ESP/Suppression.html">ESP::Suppression</a>
172
-
173
- <li><a href="../ESP/Suppression/Region.html">ESP::Suppression::Region</a>
174
-
175
- <li><a href="../ESP/Suppression/Signature.html">ESP::Suppression::Signature</a>
176
-
177
- <li><a href="../ESP/Suppression/UniqueIdentifier.html">ESP::Suppression::UniqueIdentifier</a>
178
-
179
- <li><a href="../ESP/Tag.html">ESP::Tag</a>
180
-
181
- <li><a href="../ESP/Team.html">ESP::Team</a>
182
-
183
- <li><a href="../ESP/User.html">ESP::User</a>
184
-
185
- </ul>
186
- </nav>
187
-
188
- </div>
189
- </nav>
190
-
191
- <div id="documentation">
192
- <h1 class="class">class ESP::Alert</h1>
193
-
194
- <div id="description" class="description">
195
-
196
- </div><!-- description -->
197
-
198
-
199
-
200
-
201
- <section id="5Buntitled-5D" class="documentation-section">
202
-
203
-
204
-
205
-
206
-
207
-
208
-
209
-
210
- <!-- Methods -->
211
-
212
- <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
213
- <h3 class="section-header">Public Class Methods</h3>
214
-
215
-
216
- <div id="method-c-find" class="method-detail ">
217
-
218
-
219
- <div class="method-heading">
220
- <span class="method-callseq">
221
- find(id)
222
- </span>
223
-
224
- <span class="method-click-advice">click to toggle source</span>
225
-
226
- </div>
227
-
228
-
229
-
230
- <div class="method-description">
231
-
232
- <p>Find an <a href="Alert.html">Alert</a> by id</p>
233
-
234
- <h4 id="method-c-find-label-Parameter">Parameter<span><a href="#method-c-find-label-Parameter">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
235
-
236
- <p><code>id</code> | Required | The ID of the alert to retrieve</p>
237
-
238
-
239
- <div class="method-calls-super">
240
- Calls superclass method
241
-
242
- </div>
243
-
244
-
245
-
246
- <div class="method-source-code" id="find-source">
247
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 96</span>
248
- <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">find</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">arguments</span>)
249
- <span class="ruby-identifier">scope</span> = <span class="ruby-identifier">arguments</span>.<span class="ruby-identifier">slice!</span>(<span class="ruby-value">0</span>)
250
- <span class="ruby-identifier">options</span> = (<span class="ruby-identifier">arguments</span>.<span class="ruby-identifier">slice!</span>(<span class="ruby-value">0</span>) <span class="ruby-operator">||</span> {}).<span class="ruby-identifier">with_indifferent_access</span>
251
- <span class="ruby-keyword">return</span> <span class="ruby-keyword">super</span>(<span class="ruby-identifier">scope</span>, <span class="ruby-identifier">options</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">scope</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Numeric</span>) <span class="ruby-operator">||</span> <span class="ruby-identifier">options</span>[<span class="ruby-value">:from</span>].<span class="ruby-identifier">present?</span>
252
- <span class="ruby-identifier">params</span> = <span class="ruby-identifier">options</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-value">:params</span>, {}).<span class="ruby-identifier">with_indifferent_access</span>
253
- <span class="ruby-identifier">report_id</span> = <span class="ruby-identifier">params</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value">:report_id</span>)
254
- <span class="ruby-identifier">for_report</span>(<span class="ruby-identifier">report_id</span>, <span class="ruby-identifier">params</span>)
255
- <span class="ruby-keyword">end</span></pre>
256
- </div><!-- find-source -->
257
-
258
- </div>
259
-
260
-
261
-
262
-
263
- </div><!-- find-method -->
264
-
265
-
266
- <div id="method-c-for_report" class="method-detail ">
267
-
268
- <div class="method-heading">
269
- <span class="method-name">for_report</span><span
270
- class="method-args">(report_id = nil, arguments = {})</span>
271
-
272
- <span class="method-click-advice">click to toggle source</span>
273
-
274
- </div>
275
-
276
-
277
- <div class="method-description">
278
-
279
- <p>Returns a paginated collection of alerts for the given report_id
280
- Convenience method to use instead of <a
281
- href="Alert.html#method-c-find">::find</a> since a report_id is required to
282
- return alerts.</p>
283
-
284
- <h4 id="method-c-for_report-label-Parameters">Parameters<span><a href="#method-c-for_report-label-Parameters">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
285
-
286
- <p><code>report_id</code> | Required | The ID of the report to retrieve alerts
287
- for</p>
288
-
289
- <p><code>arguments</code> | Not Required | An optional hash of search criteria
290
- to filter the returned collection</p>
291
-
292
- <h5 id="method-c-for_report-label-Valid+Arguments">Valid Arguments<span><a href="#method-c-for_report-label-Valid+Arguments">&para;</a> <a href="#documentation">&uarr;</a></span></h5>
293
-
294
- <p><code>region_id</code> | Not Required | Return only alerts for this region.</p>
295
-
296
- <p><code>status</code> | Not Required | Return only alerts for the give
297
- status(es). Valid values are fail, warn, error, pass, info</p>
298
-
299
- <p><code>first_seen</code> | Not Required | Return only alerts that have
300
- started within a number of hours of the report. For example, first_seen of
301
- 3 will return alerts that started showing up within the last 3 hours of the
302
- report.</p>
303
-
304
- <p><code>suppressed</code> | Not Required | Return only suppressed alerts</p>
305
-
306
- <p><code>team_id</code> | Not Required | Return only alerts for the given
307
- team.</p>
308
-
309
- <p><code>external_account_id</code> | Not Required | Return only alerts for
310
- the given external id.</p>
311
-
312
- <p><code>service_id</code> | Not Required | Return only alerts on signatures
313
- with the given service.</p>
314
-
315
- <p><code>signature_severity</code> | Not Required | Return only alerts for
316
- signatures with the given risk_level. Valid values are Low, Medium, High</p>
317
-
318
- <p><code>signature_name</code> | Not Required | Return only alerts for
319
- signatures with the given name.</p>
320
-
321
- <p><code>resource</code> | Not Required | Return only alerts for the given
322
- resource or tag.</p>
323
-
324
- <p><code>signature_identifier</code> | Not Required | Return only alerts for
325
- signatures with the given identifier.</p>
326
-
327
- <h4 id="method-c-for_report-label-Example">Example<span><a href="#method-c-for_report-label-Example">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
328
-
329
- <pre>alerts = ESP::Alert.for_report(54, status: &#39;fail&#39;, signature_severity: &#39;High&#39;)</pre>
330
-
331
-
332
-
333
-
334
- <div class="method-source-code" id="for_report-source">
335
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 82</span>
336
- <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">for_report</span>(<span class="ruby-identifier">report_id</span> = <span class="ruby-keyword">nil</span>, <span class="ruby-identifier">arguments</span> = {})
337
- <span class="ruby-identifier">fail</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">&quot;You must supply a report id.&quot;</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">report_id</span>.<span class="ruby-identifier">present?</span>
338
- <span class="ruby-identifier">from</span> = <span class="ruby-node">&quot;#{prefix}reports/#{report_id}/alerts.json&quot;</span>
339
- <span class="ruby-identifier">all</span>(<span class="ruby-identifier">from</span><span class="ruby-operator">:</span> <span class="ruby-identifier">from</span>, <span class="ruby-identifier">params</span><span class="ruby-operator">:</span> <span class="ruby-identifier">arguments</span>)
340
- <span class="ruby-keyword">end</span></pre>
341
- </div><!-- for_report-source -->
342
-
343
- </div>
344
-
345
-
346
-
347
-
348
- </div><!-- for_report-method -->
349
-
350
-
351
- </section><!-- public-class-method-details -->
352
-
353
- <section id="public-instance-5Buntitled-5D-method-details" class="method-section section">
354
- <h3 class="section-header">Public Instance Methods</h3>
355
-
356
-
357
- <div id="method-i-cloud_trail_events" class="method-detail ">
358
-
359
- <div class="method-heading">
360
- <span class="method-name">cloud_trail_events</span><span
361
- class="method-args">()</span>
362
-
363
- <span class="method-click-advice">click to toggle source</span>
364
-
365
- </div>
366
-
367
-
368
- <div class="method-description">
369
-
370
- <p>Returns the cloud trail events associated with this alert. These may be
371
- added up to 10 minutes after the alert was created</p>
372
-
373
-
374
-
375
-
376
- <div class="method-source-code" id="cloud_trail_events-source">
377
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 25</span>
378
- <span class="ruby-identifier">has_many</span> <span class="ruby-value">:cloud_trail_events</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::CloudTrailEvent&#39;</span>
379
- </pre>
380
- </div><!-- cloud_trail_events-source -->
381
-
382
- </div>
383
-
384
-
385
-
386
-
387
- </div><!-- cloud_trail_events-method -->
388
-
389
-
390
- <div id="method-i-custom_signature" class="method-detail ">
391
-
392
- <div class="method-heading">
393
- <span class="method-name">custom_signature</span><span
394
- class="method-args">()</span>
395
-
396
- <span class="method-click-advice">click to toggle source</span>
397
-
398
- </div>
399
-
400
-
401
- <div class="method-description">
402
-
403
- <p>Returns the custom signature associated with this alert. Either a
404
- signature or custom signature but not both will be present.</p>
405
-
406
-
407
-
408
-
409
- <div class="method-source-code" id="custom_signature-source">
410
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 17</span>
411
- <span class="ruby-identifier">belongs_to</span> <span class="ruby-value">:custom_signature</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::CustomSignature&#39;</span>
412
- </pre>
413
- </div><!-- custom_signature-source -->
414
-
415
- </div>
416
-
417
-
418
-
419
-
420
- </div><!-- custom_signature-method -->
421
-
422
-
423
- <div id="method-i-destroy" class="method-detail ">
424
-
425
- <div class="method-heading">
426
- <span class="method-name">destroy</span><span
427
- class="method-args">()</span>
428
-
429
- <span class="method-click-advice">click to toggle source</span>
430
-
431
- </div>
432
-
433
-
434
- <div class="method-description">
435
-
436
- <p>Not Implemented. You cannot destroy a an <a href="Alert.html">Alert</a>.</p>
437
-
438
-
439
-
440
-
441
- <div class="method-source-code" id="destroy-source">
442
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 43</span>
443
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">destroy</span>
444
- <span class="ruby-identifier">fail</span> <span class="ruby-constant">ESP</span><span class="ruby-operator">::</span><span class="ruby-constant">NotImplementedError</span>
445
- <span class="ruby-keyword">end</span></pre>
446
- </div><!-- destroy-source -->
447
-
448
- </div>
449
-
450
-
451
-
452
-
453
- </div><!-- destroy-method -->
454
-
455
-
456
- <div id="method-i-external_account" class="method-detail ">
457
-
458
- <div class="method-heading">
459
- <span class="method-name">external_account</span><span
460
- class="method-args">()</span>
461
-
462
- <span class="method-click-advice">click to toggle source</span>
463
-
464
- </div>
465
-
466
-
467
- <div class="method-description">
468
-
469
- <p>Returns the external account associated with this alert.</p>
470
-
471
-
472
-
473
-
474
- <div class="method-source-code" id="external_account-source">
475
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 5</span>
476
- <span class="ruby-identifier">belongs_to</span> <span class="ruby-value">:external_account</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::ExternalAccount&#39;</span>
477
- </pre>
478
- </div><!-- external_account-source -->
479
-
480
- </div>
481
-
482
-
483
-
484
-
485
- </div><!-- external_account-method -->
486
-
487
-
488
- <div id="method-i-metadata" class="method-detail ">
489
-
490
- <div class="method-heading">
491
- <span class="method-name">metadata</span><span
492
- class="method-args">()</span>
493
-
494
- <span class="method-click-advice">click to toggle source</span>
495
-
496
- </div>
497
-
498
-
499
- <div class="method-description">
500
-
501
- <p>Returns the metadata associated with this alert.</p>
502
-
503
-
504
-
505
-
506
- <div class="method-source-code" id="metadata-source">
507
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 33</span>
508
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">metadata</span>
509
- <span class="ruby-constant">ESP</span><span class="ruby-operator">::</span><span class="ruby-constant">Metadata</span>.<span class="ruby-identifier">for_alert</span>(<span class="ruby-identifier">id</span>)
510
- <span class="ruby-keyword">end</span></pre>
511
- </div><!-- metadata-source -->
512
-
513
- </div>
514
-
515
-
516
-
517
-
518
- </div><!-- metadata-method -->
519
-
520
-
521
- <div id="method-i-region" class="method-detail ">
522
-
523
- <div class="method-heading">
524
- <span class="method-name">region</span><span
525
- class="method-args">()</span>
526
-
527
- <span class="method-click-advice">click to toggle source</span>
528
-
529
- </div>
530
-
531
-
532
- <div class="method-description">
533
-
534
- <p>Returns the region associated with this alert.</p>
535
-
536
-
537
-
538
-
539
- <div class="method-source-code" id="region-source">
540
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 9</span>
541
- <span class="ruby-identifier">belongs_to</span> <span class="ruby-value">:region</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::Region&#39;</span>
542
- </pre>
543
- </div><!-- region-source -->
544
-
545
- </div>
546
-
547
-
548
-
549
-
550
- </div><!-- region-method -->
551
-
552
-
553
- <div id="method-i-save" class="method-detail ">
554
-
555
- <div class="method-heading">
556
- <span class="method-name">save</span><span
557
- class="method-args">()</span>
558
-
559
- <span class="method-click-advice">click to toggle source</span>
560
-
561
- </div>
562
-
563
-
564
- <div class="method-description">
565
-
566
- <p>Not Implemented. You cannot create or update an <a
567
- href="Alert.html">Alert</a>.</p>
568
-
569
-
570
-
571
-
572
- <div class="method-source-code" id="save-source">
573
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 38</span>
574
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">save</span>
575
- <span class="ruby-identifier">fail</span> <span class="ruby-constant">ESP</span><span class="ruby-operator">::</span><span class="ruby-constant">NotImplementedError</span>
576
- <span class="ruby-keyword">end</span></pre>
577
- </div><!-- save-source -->
578
-
579
- </div>
580
-
581
-
582
-
583
-
584
- </div><!-- save-method -->
585
-
586
-
587
- <div id="method-i-signature" class="method-detail ">
588
-
589
- <div class="method-heading">
590
- <span class="method-name">signature</span><span
591
- class="method-args">()</span>
592
-
593
- <span class="method-click-advice">click to toggle source</span>
594
-
595
- </div>
596
-
597
-
598
- <div class="method-description">
599
-
600
- <p>Returns the region associated with this alert. Either a signature or
601
- custom signature but not both will be present.</p>
602
-
603
-
604
-
605
-
606
- <div class="method-source-code" id="signature-source">
607
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 13</span>
608
- <span class="ruby-identifier">belongs_to</span> <span class="ruby-value">:signature</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::Signature&#39;</span>
609
- </pre>
610
- </div><!-- signature-source -->
611
-
612
- </div>
613
-
614
-
615
-
616
-
617
- </div><!-- signature-method -->
618
-
619
-
620
- <div id="method-i-suppress_region" class="method-detail ">
621
-
622
- <div class="method-heading">
623
- <span class="method-name">suppress_region</span><span
624
- class="method-args">(reason = nil)</span>
625
-
626
- <span class="method-click-advice">click to toggle source</span>
627
-
628
- </div>
629
-
630
-
631
- <div class="method-description">
632
-
633
- <p>Suppress the region associated with this alert.</p>
634
-
635
- <h4 id="method-i-suppress_region-label-Parameter">Parameter<span><a href="#method-i-suppress_region-label-Parameter">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
636
-
637
- <p><code>reason</code> | Required | The reason for creating the suppression.</p>
638
-
639
-
640
-
641
-
642
- <div class="method-source-code" id="suppress_region-source">
643
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 117</span>
644
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">suppress_region</span>(<span class="ruby-identifier">reason</span> = <span class="ruby-keyword">nil</span>)
645
- <span class="ruby-identifier">suppress</span>(<span class="ruby-constant">Suppression</span><span class="ruby-operator">::</span><span class="ruby-constant">Region</span>, <span class="ruby-identifier">reason</span>)
646
- <span class="ruby-keyword">end</span></pre>
647
- </div><!-- suppress_region-source -->
648
-
649
- </div>
650
-
651
-
652
-
653
-
654
- </div><!-- suppress_region-method -->
655
-
656
-
657
- <div id="method-i-suppress_signature" class="method-detail ">
658
-
659
- <div class="method-heading">
660
- <span class="method-name">suppress_signature</span><span
661
- class="method-args">(reason = nil)</span>
662
-
663
- <span class="method-click-advice">click to toggle source</span>
664
-
665
- </div>
666
-
667
-
668
- <div class="method-description">
669
-
670
- <p>Suppress the signature associated with this alert.</p>
671
-
672
- <h4 id="method-i-suppress_signature-label-Parameter">Parameter<span><a href="#method-i-suppress_signature-label-Parameter">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
673
-
674
- <p><code>reason</code> | Required | The reason for creating the suppression.</p>
675
-
676
-
677
-
678
-
679
- <div class="method-source-code" id="suppress_signature-source">
680
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 109</span>
681
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">suppress_signature</span>(<span class="ruby-identifier">reason</span> = <span class="ruby-keyword">nil</span>)
682
- <span class="ruby-identifier">suppress</span>(<span class="ruby-constant">Suppression</span><span class="ruby-operator">::</span><span class="ruby-constant">Signature</span>, <span class="ruby-identifier">reason</span>)
683
- <span class="ruby-keyword">end</span></pre>
684
- </div><!-- suppress_signature-source -->
685
-
686
- </div>
687
-
688
-
689
-
690
-
691
- </div><!-- suppress_signature-method -->
692
-
693
-
694
- <div id="method-i-suppress_unique_identifier" class="method-detail ">
695
-
696
- <div class="method-heading">
697
- <span class="method-name">suppress_unique_identifier</span><span
698
- class="method-args">(reason = nil)</span>
699
-
700
- <span class="method-click-advice">click to toggle source</span>
701
-
702
- </div>
703
-
704
-
705
- <div class="method-description">
706
-
707
- <p>Suppress the unique identifier associated with this alert.</p>
708
-
709
- <h4 id="method-i-suppress_unique_identifier-label-Parameter">Parameter<span><a href="#method-i-suppress_unique_identifier-label-Parameter">&para;</a> <a href="#documentation">&uarr;</a></span></h4>
710
-
711
- <p><code>reason</code> | Required | The reason for creating the suppression.</p>
712
-
713
-
714
-
715
-
716
- <div class="method-source-code" id="suppress_unique_identifier-source">
717
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 125</span>
718
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">suppress_unique_identifier</span>(<span class="ruby-identifier">reason</span> = <span class="ruby-keyword">nil</span>)
719
- <span class="ruby-identifier">suppress</span>(<span class="ruby-constant">Suppression</span><span class="ruby-operator">::</span><span class="ruby-constant">UniqueIdentifier</span>, <span class="ruby-identifier">reason</span>)
720
- <span class="ruby-keyword">end</span></pre>
721
- </div><!-- suppress_unique_identifier-source -->
722
-
723
- </div>
724
-
725
-
726
-
727
-
728
- </div><!-- suppress_unique_identifier-method -->
729
-
730
-
731
- <div id="method-i-suppression" class="method-detail ">
732
-
733
- <div class="method-heading">
734
- <span class="method-name">suppression</span><span
735
- class="method-args">()</span>
736
-
737
- <span class="method-click-advice">click to toggle source</span>
738
-
739
- </div>
740
-
741
-
742
- <div class="method-description">
743
-
744
- <p>Returns the suppression associated with this alert. If present the alert
745
- was suppressed.</p>
746
-
747
-
748
-
749
-
750
- <div class="method-source-code" id="suppression-source">
751
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 21</span>
752
- <span class="ruby-identifier">belongs_to</span> <span class="ruby-value">:suppression</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::Suppression&#39;</span>
753
- </pre>
754
- </div><!-- suppression-source -->
755
-
756
- </div>
757
-
758
-
759
-
760
-
761
- </div><!-- suppression-method -->
762
-
763
-
764
- <div id="method-i-tags" class="method-detail ">
765
-
766
- <div class="method-heading">
767
- <span class="method-name">tags</span><span
768
- class="method-args">()</span>
769
-
770
- <span class="method-click-advice">click to toggle source</span>
771
-
772
- </div>
773
-
774
-
775
- <div class="method-description">
776
-
777
- <p>Returns the tags associated with this alert.</p>
778
-
779
-
780
-
781
-
782
- <div class="method-source-code" id="tags-source">
783
- <pre><span class="ruby-comment"># File lib/esp/resources/alert.rb, line 29</span>
784
- <span class="ruby-identifier">has_many</span> <span class="ruby-value">:tags</span>, <span class="ruby-identifier">class_name</span><span class="ruby-operator">:</span> <span class="ruby-string">&#39;ESP::Tag&#39;</span>
785
- </pre>
786
- </div><!-- tags-source -->
787
-
788
- </div>
789
-
790
-
791
-
792
-
793
- </div><!-- tags-method -->
794
-
795
-
796
- </section><!-- public-instance-method-details -->
797
-
798
- </section><!-- 5Buntitled-5D -->
799
-
800
- </div><!-- documentation -->
801
-
802
-
803
- <footer id="validator-badges">
804
- <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
805
- <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
806
- <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
807
- </footer>
808
-