ibm-cloud-sdk-core 4.2.5 → 4.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (166) hide show
  1. package/.secrets.baseline +17 -17
  2. package/CHANGELOG.md +14 -0
  3. package/auth/token-managers/container-token-manager.d.ts +1 -1
  4. package/auth/token-managers/container-token-manager.js +3 -1
  5. package/auth/token-managers/cp4d-token-manager.d.ts +1 -1
  6. package/auth/token-managers/cp4d-token-manager.js +4 -1
  7. package/auth/token-managers/iam-request-based-token-manager.js +2 -1
  8. package/auth/token-managers/iam-token-manager.d.ts +1 -1
  9. package/auth/token-managers/iam-token-manager.js +3 -1
  10. package/auth/token-managers/mcsp-token-manager.d.ts +1 -1
  11. package/auth/token-managers/mcsp-token-manager.js +4 -1
  12. package/auth/token-managers/token-manager.d.ts +1 -0
  13. package/auth/token-managers/vpc-instance-token-manager.js +4 -0
  14. package/auth/utils/file-reading-helpers.d.ts +1 -1
  15. package/auth/utils/file-reading-helpers.js +1 -1
  16. package/auth/utils/read-external-sources.js +4 -4
  17. package/build/docs/ibm-cloud-sdk-core.atleastone.md +48 -4
  18. package/build/docs/ibm-cloud-sdk-core.atmostone.md +48 -4
  19. package/build/docs/ibm-cloud-sdk-core.authenticator.authenticate.md +32 -3
  20. package/build/docs/ibm-cloud-sdk-core.authenticator.md +270 -18
  21. package/build/docs/ibm-cloud-sdk-core.authenticatorinterface.authenticate.md +32 -3
  22. package/build/docs/ibm-cloud-sdk-core.authenticatorinterface.md +33 -4
  23. package/build/docs/ibm-cloud-sdk-core.baseservice._constructor_.md +32 -3
  24. package/build/docs/ibm-cloud-sdk-core.baseservice.configureservice.md +32 -3
  25. package/build/docs/ibm-cloud-sdk-core.baseservice.convertmodel.md +64 -5
  26. package/build/docs/ibm-cloud-sdk-core.baseservice.createrequest.md +32 -3
  27. package/build/docs/ibm-cloud-sdk-core.baseservice.createrequestanddeserializeresponse.md +64 -5
  28. package/build/docs/ibm-cloud-sdk-core.baseservice.enableretries.md +32 -3
  29. package/build/docs/ibm-cloud-sdk-core.baseservice.md +288 -21
  30. package/build/docs/ibm-cloud-sdk-core.baseservice.setdefaultheaders.md +32 -3
  31. package/build/docs/ibm-cloud-sdk-core.baseservice.setenablegzipcompression.md +32 -3
  32. package/build/docs/ibm-cloud-sdk-core.baseservice.setserviceurl.md +32 -3
  33. package/build/docs/ibm-cloud-sdk-core.basicauthenticator._constructor_.md +33 -3
  34. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.authenticate.md +32 -3
  35. package/build/docs/ibm-cloud-sdk-core.basicauthenticator.md +137 -11
  36. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator._constructor_.md +33 -3
  37. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.authenticate.md +32 -3
  38. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.md +132 -11
  39. package/build/docs/ibm-cloud-sdk-core.bearertokenauthenticator.setbearertoken.md +32 -3
  40. package/build/docs/ibm-cloud-sdk-core.buildrequestfileobject.md +32 -3
  41. package/build/docs/ibm-cloud-sdk-core.checkcredentials.md +48 -4
  42. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator._constructor_.md +33 -3
  43. package/build/docs/ibm-cloud-sdk-core.cloudpakfordataauthenticator.md +121 -10
  44. package/build/docs/ibm-cloud-sdk-core.computebasicauthheader.md +48 -4
  45. package/build/docs/ibm-cloud-sdk-core.constructfilepath.md +30 -3
  46. package/build/docs/ibm-cloud-sdk-core.constructserviceurl.md +64 -5
  47. package/build/docs/ibm-cloud-sdk-core.containerauthenticator._constructor_.md +33 -3
  48. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.md +144 -12
  49. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.setcrtokenfilename.md +32 -3
  50. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.setiamprofileid.md +32 -3
  51. package/build/docs/ibm-cloud-sdk-core.containerauthenticator.setiamprofilename.md +32 -3
  52. package/build/docs/ibm-cloud-sdk-core.containertokenmanager._constructor_.md +33 -3
  53. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.md +121 -10
  54. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.setcrtokenfilename.md +32 -3
  55. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.setiamprofileid.md +32 -3
  56. package/build/docs/ibm-cloud-sdk-core.containertokenmanager.setiamprofilename.md +32 -3
  57. package/build/docs/ibm-cloud-sdk-core.cp4dtokenmanager._constructor_.md +33 -3
  58. package/build/docs/ibm-cloud-sdk-core.cp4dtokenmanager.md +102 -9
  59. package/build/docs/ibm-cloud-sdk-core.fileexistsatpath.md +30 -3
  60. package/build/docs/ibm-cloud-sdk-core.fileobject.md +57 -4
  61. package/build/docs/ibm-cloud-sdk-core.fileoptions.md +59 -4
  62. package/build/docs/ibm-cloud-sdk-core.filestream.md +38 -3
  63. package/build/docs/ibm-cloud-sdk-core.filewithmetadata.md +72 -5
  64. package/build/docs/ibm-cloud-sdk-core.getauthenticatorfromenvironment.md +32 -3
  65. package/build/docs/ibm-cloud-sdk-core.getcontenttype.md +32 -3
  66. package/build/docs/ibm-cloud-sdk-core.getformat.md +46 -4
  67. package/build/docs/ibm-cloud-sdk-core.getmissingparams.md +48 -4
  68. package/build/docs/ibm-cloud-sdk-core.getnewlogger.md +32 -3
  69. package/build/docs/ibm-cloud-sdk-core.getqueryparam.md +48 -4
  70. package/build/docs/ibm-cloud-sdk-core.iamauthenticator._constructor_.md +33 -3
  71. package/build/docs/ibm-cloud-sdk-core.iamauthenticator.md +121 -10
  72. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator._constructor_.md +33 -3
  73. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.md +187 -14
  74. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.setclientidandsecret.md +48 -4
  75. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedauthenticator.setscope.md +32 -3
  76. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager._constructor_.md +33 -3
  77. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.md +197 -15
  78. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.savetokeninfo.md +32 -3
  79. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.setclientidandsecret.md +48 -4
  80. package/build/docs/ibm-cloud-sdk-core.iamrequestbasedtokenmanager.setscope.md +32 -3
  81. package/build/docs/ibm-cloud-sdk-core.iamrequestoptions.md +78 -5
  82. package/build/docs/ibm-cloud-sdk-core.iamtokenmanager._constructor_.md +33 -3
  83. package/build/docs/ibm-cloud-sdk-core.iamtokenmanager.md +71 -6
  84. package/build/docs/ibm-cloud-sdk-core.isemptyobject.md +30 -3
  85. package/build/docs/ibm-cloud-sdk-core.isfiledata.md +30 -3
  86. package/build/docs/ibm-cloud-sdk-core.isfilewithmetadata.md +30 -3
  87. package/build/docs/ibm-cloud-sdk-core.ishtml.md +32 -3
  88. package/build/docs/ibm-cloud-sdk-core.isjsonmimetype.md +32 -3
  89. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager._constructor_.md +32 -3
  90. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.md +139 -11
  91. package/build/docs/ibm-cloud-sdk-core.jwttokenmanager.savetokeninfo.md +32 -3
  92. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator._constructor_.md +33 -3
  93. package/build/docs/ibm-cloud-sdk-core.mcspauthenticator.md +121 -10
  94. package/build/docs/ibm-cloud-sdk-core.mcsptokenmanager._constructor_.md +33 -3
  95. package/build/docs/ibm-cloud-sdk-core.mcsptokenmanager.md +102 -9
  96. package/build/docs/ibm-cloud-sdk-core.md +794 -75
  97. package/build/docs/ibm-cloud-sdk-core.noauthauthenticator.authenticate.md +30 -3
  98. package/build/docs/ibm-cloud-sdk-core.noauthauthenticator.md +42 -4
  99. package/build/docs/ibm-cloud-sdk-core.onlyone.md +48 -4
  100. package/build/docs/ibm-cloud-sdk-core.readcrtokenfile.md +30 -3
  101. package/build/docs/ibm-cloud-sdk-core.readexternalsources.md +32 -3
  102. package/build/docs/ibm-cloud-sdk-core.removesuffix.md +48 -4
  103. package/build/docs/ibm-cloud-sdk-core.sdklogger.md +106 -7
  104. package/build/docs/ibm-cloud-sdk-core.streamtopromise.md +32 -3
  105. package/build/docs/ibm-cloud-sdk-core.striptrailingslash.md +32 -3
  106. package/build/docs/ibm-cloud-sdk-core.tokenmanager._constructor_.md +32 -3
  107. package/build/docs/ibm-cloud-sdk-core.tokenmanager.md +329 -21
  108. package/build/docs/ibm-cloud-sdk-core.tokenmanager.savetokeninfo.md +32 -3
  109. package/build/docs/ibm-cloud-sdk-core.tokenmanager.setdisablesslverification.md +32 -3
  110. package/build/docs/ibm-cloud-sdk-core.tokenmanager.setheaders.md +32 -3
  111. package/build/docs/ibm-cloud-sdk-core.tokenmanager.useragent.md +11 -0
  112. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator._constructor_.md +32 -3
  113. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.authenticate.md +32 -3
  114. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.md +189 -14
  115. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.setdisablesslverification.md +32 -3
  116. package/build/docs/ibm-cloud-sdk-core.tokenrequestbasedauthenticator.setheaders.md +32 -3
  117. package/build/docs/ibm-cloud-sdk-core.tolowerkeys.md +32 -3
  118. package/build/docs/ibm-cloud-sdk-core.unittestutils.checkforsuccessfulexecution.md +32 -3
  119. package/build/docs/ibm-cloud-sdk-core.unittestutils.checkmediaheaders.md +64 -5
  120. package/build/docs/ibm-cloud-sdk-core.unittestutils.checkurlandmethod.md +64 -5
  121. package/build/docs/ibm-cloud-sdk-core.unittestutils.checkuserheader.md +64 -5
  122. package/build/docs/ibm-cloud-sdk-core.unittestutils.expecttobepromise.md +32 -3
  123. package/build/docs/ibm-cloud-sdk-core.unittestutils.getoptions.md +32 -3
  124. package/build/docs/ibm-cloud-sdk-core.unittestutils.md +77 -8
  125. package/build/docs/ibm-cloud-sdk-core.useroptions.md +154 -9
  126. package/build/docs/ibm-cloud-sdk-core.validateinput.md +48 -4
  127. package/build/docs/ibm-cloud-sdk-core.validateparams.md +64 -5
  128. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator._constructor_.md +33 -3
  129. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.md +130 -11
  130. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.setiamprofilecrn.md +32 -3
  131. package/build/docs/ibm-cloud-sdk-core.vpcinstanceauthenticator.setiamprofileid.md +32 -3
  132. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager._constructor_.md +33 -3
  133. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.md +105 -9
  134. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.setiamprofilecrn.md +32 -3
  135. package/build/docs/ibm-cloud-sdk-core.vpcinstancetokenmanager.setiamprofileid.md +32 -3
  136. package/build/docs/index.md +20 -3
  137. package/docs/ibm-cloud-sdk-core.api.json +31 -1
  138. package/es/auth/token-managers/container-token-manager.d.ts +1 -1
  139. package/es/auth/token-managers/container-token-manager.js +3 -1
  140. package/es/auth/token-managers/cp4d-token-manager.d.ts +1 -1
  141. package/es/auth/token-managers/cp4d-token-manager.js +4 -1
  142. package/es/auth/token-managers/iam-request-based-token-manager.js +2 -1
  143. package/es/auth/token-managers/iam-token-manager.d.ts +1 -1
  144. package/es/auth/token-managers/iam-token-manager.js +3 -1
  145. package/es/auth/token-managers/mcsp-token-manager.d.ts +1 -1
  146. package/es/auth/token-managers/mcsp-token-manager.js +4 -1
  147. package/es/auth/token-managers/token-manager.d.ts +1 -0
  148. package/es/auth/token-managers/vpc-instance-token-manager.js +4 -0
  149. package/es/auth/utils/file-reading-helpers.d.ts +1 -1
  150. package/es/auth/utils/file-reading-helpers.js +1 -1
  151. package/es/auth/utils/read-external-sources.js +4 -4
  152. package/es/lib/base-service.d.ts +2 -1
  153. package/es/lib/base-service.js +9 -1
  154. package/es/lib/build-user-agent.d.ts +21 -0
  155. package/es/lib/build-user-agent.js +27 -0
  156. package/es/tsdoc-metadata.json +1 -1
  157. package/etc/ibm-cloud-sdk-core.api.md +2 -0
  158. package/ibm-cloud-sdk-core.d.ts +3 -1
  159. package/lib/base-service.d.ts +2 -1
  160. package/lib/base-service.js +9 -1
  161. package/lib/build-user-agent.d.ts +21 -0
  162. package/lib/build-user-agent.js +32 -0
  163. package/package.json +9 -10
  164. package/temp/ibm-cloud-sdk-core.api.json +31 -1
  165. package/temp/ibm-cloud-sdk-core.api.md +2 -0
  166. package/.nvmrc +0 -1
@@ -15,28 +15,280 @@ export declare class Authenticator implements AuthenticatorInterface
15
15
 
16
16
  ## Constructors
17
17
 
18
- | Constructor | Modifiers | Description |
19
- | --- | --- | --- |
20
- | [(constructor)()](./ibm-cloud-sdk-core.authenticator._constructor_.md) | | Create a new Authenticator instance. |
18
+ <table><thead><tr><th>
19
+
20
+ Constructor
21
+
22
+
23
+ </th><th>
24
+
25
+ Modifiers
26
+
27
+
28
+ </th><th>
29
+
30
+ Description
31
+
32
+
33
+ </th></tr></thead>
34
+ <tbody><tr><td>
35
+
36
+ [(constructor)()](./ibm-cloud-sdk-core.authenticator._constructor_.md)
37
+
38
+
39
+ </td><td>
40
+
41
+
42
+ </td><td>
43
+
44
+ Create a new Authenticator instance.
45
+
46
+
47
+ </td></tr>
48
+ </tbody></table>
21
49
 
22
50
  ## Properties
23
51
 
24
- | Property | Modifiers | Type | Description |
25
- | --- | --- | --- | --- |
26
- | [AUTHTYPE\_BASIC](./ibm-cloud-sdk-core.authenticator.authtype_basic.md) | <code>static</code> | string | Constants that define the various authenticator types. |
27
- | [AUTHTYPE\_BEARERTOKEN](./ibm-cloud-sdk-core.authenticator.authtype_bearertoken.md) | <code>static</code> | string | |
28
- | [AUTHTYPE\_CONTAINER](./ibm-cloud-sdk-core.authenticator.authtype_container.md) | <code>static</code> | string | |
29
- | [AUTHTYPE\_CP4D](./ibm-cloud-sdk-core.authenticator.authtype_cp4d.md) | <code>static</code> | string | |
30
- | [AUTHTYPE\_IAM](./ibm-cloud-sdk-core.authenticator.authtype_iam.md) | <code>static</code> | string | |
31
- | [AUTHTYPE\_MCSP](./ibm-cloud-sdk-core.authenticator.authtype_mcsp.md) | <code>static</code> | string | |
32
- | [AUTHTYPE\_NOAUTH](./ibm-cloud-sdk-core.authenticator.authtype_noauth.md) | <code>static</code> | string | |
33
- | [AUTHTYPE\_UNKNOWN](./ibm-cloud-sdk-core.authenticator.authtype_unknown.md) | <code>static</code> | string | |
34
- | [AUTHTYPE\_VPC](./ibm-cloud-sdk-core.authenticator.authtype_vpc.md) | <code>static</code> | string | |
52
+ <table><thead><tr><th>
53
+
54
+ Property
55
+
56
+
57
+ </th><th>
58
+
59
+ Modifiers
60
+
61
+
62
+ </th><th>
63
+
64
+ Type
65
+
66
+
67
+ </th><th>
68
+
69
+ Description
70
+
71
+
72
+ </th></tr></thead>
73
+ <tbody><tr><td>
74
+
75
+ [AUTHTYPE\_BASIC](./ibm-cloud-sdk-core.authenticator.authtype_basic.md)
76
+
77
+
78
+ </td><td>
79
+
80
+ `static`
81
+
82
+
83
+ </td><td>
84
+
85
+ string
86
+
87
+
88
+ </td><td>
89
+
90
+ Constants that define the various authenticator types.
91
+
92
+
93
+ </td></tr>
94
+ <tr><td>
95
+
96
+ [AUTHTYPE\_BEARERTOKEN](./ibm-cloud-sdk-core.authenticator.authtype_bearertoken.md)
97
+
98
+
99
+ </td><td>
100
+
101
+ `static`
102
+
103
+
104
+ </td><td>
105
+
106
+ string
107
+
108
+
109
+ </td><td>
110
+
111
+
112
+ </td></tr>
113
+ <tr><td>
114
+
115
+ [AUTHTYPE\_CONTAINER](./ibm-cloud-sdk-core.authenticator.authtype_container.md)
116
+
117
+
118
+ </td><td>
119
+
120
+ `static`
121
+
122
+
123
+ </td><td>
124
+
125
+ string
126
+
127
+
128
+ </td><td>
129
+
130
+
131
+ </td></tr>
132
+ <tr><td>
133
+
134
+ [AUTHTYPE\_CP4D](./ibm-cloud-sdk-core.authenticator.authtype_cp4d.md)
135
+
136
+
137
+ </td><td>
138
+
139
+ `static`
140
+
141
+
142
+ </td><td>
143
+
144
+ string
145
+
146
+
147
+ </td><td>
148
+
149
+
150
+ </td></tr>
151
+ <tr><td>
152
+
153
+ [AUTHTYPE\_IAM](./ibm-cloud-sdk-core.authenticator.authtype_iam.md)
154
+
155
+
156
+ </td><td>
157
+
158
+ `static`
159
+
160
+
161
+ </td><td>
162
+
163
+ string
164
+
165
+
166
+ </td><td>
167
+
168
+
169
+ </td></tr>
170
+ <tr><td>
171
+
172
+ [AUTHTYPE\_MCSP](./ibm-cloud-sdk-core.authenticator.authtype_mcsp.md)
173
+
174
+
175
+ </td><td>
176
+
177
+ `static`
178
+
179
+
180
+ </td><td>
181
+
182
+ string
183
+
184
+
185
+ </td><td>
186
+
187
+
188
+ </td></tr>
189
+ <tr><td>
190
+
191
+ [AUTHTYPE\_NOAUTH](./ibm-cloud-sdk-core.authenticator.authtype_noauth.md)
192
+
193
+
194
+ </td><td>
195
+
196
+ `static`
197
+
198
+
199
+ </td><td>
200
+
201
+ string
202
+
203
+
204
+ </td><td>
205
+
206
+
207
+ </td></tr>
208
+ <tr><td>
209
+
210
+ [AUTHTYPE\_UNKNOWN](./ibm-cloud-sdk-core.authenticator.authtype_unknown.md)
211
+
212
+
213
+ </td><td>
214
+
215
+ `static`
216
+
217
+
218
+ </td><td>
219
+
220
+ string
221
+
222
+
223
+ </td><td>
224
+
225
+
226
+ </td></tr>
227
+ <tr><td>
228
+
229
+ [AUTHTYPE\_VPC](./ibm-cloud-sdk-core.authenticator.authtype_vpc.md)
230
+
231
+
232
+ </td><td>
233
+
234
+ `static`
235
+
236
+
237
+ </td><td>
238
+
239
+ string
240
+
241
+
242
+ </td><td>
243
+
244
+
245
+ </td></tr>
246
+ </tbody></table>
35
247
 
36
248
  ## Methods
37
249
 
38
- | Method | Modifiers | Description |
39
- | --- | --- | --- |
40
- | [authenticate(requestOptions)](./ibm-cloud-sdk-core.authenticator.authenticate.md) | | Augment the request with authentication information. |
41
- | [authenticationType()](./ibm-cloud-sdk-core.authenticator.authenticationtype.md) | | Retrieves the authenticator's type. The returned value will be the same string that is used when configuring an instance of the authenticator with the &lt;<!-- -->service\_name<!-- -->&gt;<!-- -->\_AUTH\_TYPE configuration property (e.g. "basic", "iam", etc.). This function should be overridden in each authenticator implementation class that extends this class. |
250
+ <table><thead><tr><th>
251
+
252
+ Method
253
+
254
+
255
+ </th><th>
256
+
257
+ Modifiers
258
+
259
+
260
+ </th><th>
261
+
262
+ Description
263
+
264
+
265
+ </th></tr></thead>
266
+ <tbody><tr><td>
267
+
268
+ [authenticate(requestOptions)](./ibm-cloud-sdk-core.authenticator.authenticate.md)
269
+
270
+
271
+ </td><td>
272
+
273
+
274
+ </td><td>
275
+
276
+ Augment the request with authentication information.
277
+
278
+
279
+ </td></tr>
280
+ <tr><td>
281
+
282
+ [authenticationType()](./ibm-cloud-sdk-core.authenticator.authenticationtype.md)
283
+
284
+
285
+ </td><td>
286
+
287
+
288
+ </td><td>
289
+
290
+ Retrieves the authenticator's type. The returned value will be the same string that is used when configuring an instance of the authenticator with the &lt;<!-- -->service\_name<!-- -->&gt;<!-- -->\_AUTH\_TYPE configuration property (e.g. "basic", "iam", etc.). This function should be overridden in each authenticator implementation class that extends this class.
291
+
42
292
 
293
+ </td></tr>
294
+ </tbody></table>
@@ -14,10 +14,39 @@ authenticate(requestOptions: AuthenticateOptions): Promise<void>;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | requestOptions | AuthenticateOptions | The request to which authentication information is added (in the headers field). |
17
+ <table><thead><tr><th>
20
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ requestOptions
36
+
37
+
38
+ </td><td>
39
+
40
+ AuthenticateOptions
41
+
42
+
43
+ </td><td>
44
+
45
+ The request to which authentication information is added (in the headers field).
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
21
50
  **Returns:**
22
51
 
23
52
  Promise&lt;void&gt;
@@ -14,8 +14,37 @@ export interface AuthenticatorInterface
14
14
 
15
15
  ## Methods
16
16
 
17
- | Method | Description |
18
- | --- | --- |
19
- | [authenticate(requestOptions)](./ibm-cloud-sdk-core.authenticatorinterface.authenticate.md) | Add authentication information to the specified request. |
20
- | [authenticationType()](./ibm-cloud-sdk-core.authenticatorinterface.authenticationtype.md) | Returns a string that indicates the authentication type. |
17
+ <table><thead><tr><th>
21
18
 
19
+ Method
20
+
21
+
22
+ </th><th>
23
+
24
+ Description
25
+
26
+
27
+ </th></tr></thead>
28
+ <tbody><tr><td>
29
+
30
+ [authenticate(requestOptions)](./ibm-cloud-sdk-core.authenticatorinterface.authenticate.md)
31
+
32
+
33
+ </td><td>
34
+
35
+ Add authentication information to the specified request.
36
+
37
+
38
+ </td></tr>
39
+ <tr><td>
40
+
41
+ [authenticationType()](./ibm-cloud-sdk-core.authenticatorinterface.authenticationtype.md)
42
+
43
+
44
+ </td><td>
45
+
46
+ Returns a string that indicates the authentication type.
47
+
48
+
49
+ </td></tr>
50
+ </tbody></table>
@@ -14,7 +14,36 @@ constructor(userOptions: UserOptions);
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | userOptions | [UserOptions](./ibm-cloud-sdk-core.useroptions.md) | the configuration options to set on the service instance. This should be an object with the following fields: - authenticator: (required) an Object used to authenticate requests to the service. - serviceUrl: (optional) the base url to use when contacting the service. The base url may differ between IBM Cloud regions. - headers: (optional) a set of HTTP headers that should be included with every request sent to the service - disableSslVerification: (optional) a flag that indicates whether verification of the server's SSL certificate should be disabled or not. |
17
+ <table><thead><tr><th>
20
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ userOptions
36
+
37
+
38
+ </td><td>
39
+
40
+ [UserOptions](./ibm-cloud-sdk-core.useroptions.md)
41
+
42
+
43
+ </td><td>
44
+
45
+ the configuration options to set on the service instance. This should be an object with the following fields: - authenticator: (required) an Object used to authenticate requests to the service. - serviceUrl: (optional) the base url to use when contacting the service. The base url may differ between IBM Cloud regions. - headers: (optional) a set of HTTP headers that should be included with every request sent to the service - disableSslVerification: (optional) a flag that indicates whether verification of the server's SSL certificate should be disabled or not.
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
@@ -14,10 +14,39 @@ protected configureService(serviceName: string): void;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | serviceName | string | the name of the service. This will be used to read from external configuration. |
17
+ <table><thead><tr><th>
20
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ serviceName
36
+
37
+
38
+ </td><td>
39
+
40
+ string
41
+
42
+
43
+ </td><td>
44
+
45
+ the name of the service. This will be used to read from external configuration.
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
21
50
  **Returns:**
22
51
 
23
52
  void
@@ -14,12 +14,71 @@ static convertModel(input: any, converterFn: any, isMap?: boolean): any;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | input | any | the input model object |
20
- | converterFn | any | the function that is applied on the input object |
21
- | isMap | boolean | _(Optional)_ is <code>true</code> when the input object should be handled as a map |
17
+ <table><thead><tr><th>
22
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ input
36
+
37
+
38
+ </td><td>
39
+
40
+ any
41
+
42
+
43
+ </td><td>
44
+
45
+ the input model object
46
+
47
+
48
+ </td></tr>
49
+ <tr><td>
50
+
51
+ converterFn
52
+
53
+
54
+ </td><td>
55
+
56
+ any
57
+
58
+
59
+ </td><td>
60
+
61
+ the function that is applied on the input object
62
+
63
+
64
+ </td></tr>
65
+ <tr><td>
66
+
67
+ isMap
68
+
69
+
70
+ </td><td>
71
+
72
+ boolean
73
+
74
+
75
+ </td><td>
76
+
77
+ _(Optional)_ is `true` when the input object should be handled as a map
78
+
79
+
80
+ </td></tr>
81
+ </tbody></table>
23
82
  **Returns:**
24
83
 
25
84
  any
@@ -14,10 +14,39 @@ protected createRequest(parameters: any): Promise<any>;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | parameters | any | Service request options passed in by user. This should be an object with the following fields: - options.method: the http method - options.url: the path portion of the URL to be appended to the serviceUrl - options.path: the path parameters to be inserted into the URL - options.qs: the querystring to be included in the URL - options.body: the data to be sent as the request body - options.form: an object containing the key/value pairs for a www-form-urlencoded request. - options.formData: an object containing the contents for a multipart/form-data request The following processing is performed on formData values: - string: no special processing -- the value is sent as is - object: the value is converted to a JSON string before insertion into the form body - NodeJS.ReadableStream\|Buffer\|FileWithMetadata: sent as a file, with any associated metadata - array: each element of the array is sent as a separate form part using any special processing as described above - defaultOptions.serviceUrl: the base URL of the service - defaultOptions.headers: additional HTTP headers to be sent with the request |
17
+ <table><thead><tr><th>
20
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ parameters
36
+
37
+
38
+ </td><td>
39
+
40
+ any
41
+
42
+
43
+ </td><td>
44
+
45
+ Service request options passed in by user. This should be an object with the following fields: - options.method: the http method - options.url: the path portion of the URL to be appended to the serviceUrl - options.path: the path parameters to be inserted into the URL - options.qs: the querystring to be included in the URL - options.body: the data to be sent as the request body - options.form: an object containing the key/value pairs for a www-form-urlencoded request. - options.formData: an object containing the contents for a multipart/form-data request The following processing is performed on formData values: - string: no special processing -- the value is sent as is - object: the value is converted to a JSON string before insertion into the form body - NodeJS.ReadableStream\|Buffer\|FileWithMetadata: sent as a file, with any associated metadata - array: each element of the array is sent as a separate form part using any special processing as described above - defaultOptions.serviceUrl: the base URL of the service - defaultOptions.headers: additional HTTP headers to be sent with the request
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
21
50
  **Returns:**
22
51
 
23
52
  Promise&lt;any&gt;
@@ -14,12 +14,71 @@ protected createRequestAndDeserializeResponse(parameters: any, deserializerFn: (
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | parameters | any | see <code>parameters</code> in <code>createRequest</code> |
20
- | deserializerFn | (any: any) =&gt; any | the deserializer function that is applied on the response object |
21
- | isMap | boolean | _(Optional)_ is <code>true</code> when the response object should be handled as a map |
17
+ <table><thead><tr><th>
22
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ parameters
36
+
37
+
38
+ </td><td>
39
+
40
+ any
41
+
42
+
43
+ </td><td>
44
+
45
+ see `parameters` in `createRequest`
46
+
47
+
48
+ </td></tr>
49
+ <tr><td>
50
+
51
+ deserializerFn
52
+
53
+
54
+ </td><td>
55
+
56
+ (any: any) =&gt; any
57
+
58
+
59
+ </td><td>
60
+
61
+ the deserializer function that is applied on the response object
62
+
63
+
64
+ </td></tr>
65
+ <tr><td>
66
+
67
+ isMap
68
+
69
+
70
+ </td><td>
71
+
72
+ boolean
73
+
74
+
75
+ </td><td>
76
+
77
+ _(Optional)_ is `true` when the response object should be handled as a map
78
+
79
+
80
+ </td></tr>
81
+ </tbody></table>
23
82
  **Returns:**
24
83
 
25
84
  Promise&lt;any&gt;
@@ -14,10 +14,39 @@ enableRetries(retryOptions?: RetryOptions): void;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | retryOptions | RetryOptions | _(Optional)_ the configuration for retries |
17
+ <table><thead><tr><th>
20
18
 
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ retryOptions
36
+
37
+
38
+ </td><td>
39
+
40
+ RetryOptions
41
+
42
+
43
+ </td><td>
44
+
45
+ _(Optional)_ the configuration for retries
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
21
50
  **Returns:**
22
51
 
23
52
  void