ibm-cloud-sdk-core 5.1.0 → 5.1.2

package/build/docs/ibm-cloud-sdk-core.baseservice.createrequestanddeserializeresponse.md

@@ -0,0 +1,87 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [createRequestAndDeserializeResponse](./ibm-cloud-sdk-core.baseservice.createrequestanddeserializeresponse.md)
+
+## BaseService.createRequestAndDeserializeResponse() method
+
+Wrapper around `createRequest` that enforces arrived response to be deserialized.
+
+**Signature:**
+
+```typescript
+protected createRequestAndDeserializeResponse(parameters: any, deserializerFn: (any: any) => any, isMap?: boolean): Promise<any>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+parameters
+
+
+</td><td>
+
+any
+
+
+</td><td>
+
+see `parameters` in `createRequest`
+
+
+</td></tr>
+<tr><td>
+
+deserializerFn
+
+
+</td><td>
+
+(any: any) =&gt; any
+
+
+</td><td>
+
+the deserializer function that is applied on the response object
+
+
+</td></tr>
+<tr><td>
+
+isMap
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+_(Optional)_ is `true` when the response object should be handled as a map
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+Promise&lt;any&gt;
+
+a Promise
+

package/build/docs/ibm-cloud-sdk-core.baseservice.default_service_name.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [DEFAULT\_SERVICE\_NAME](./ibm-cloud-sdk-core.baseservice.default_service_name.md)
+
+## BaseService.DEFAULT\_SERVICE\_NAME property
+
+**Signature:**
+
+```typescript
+static DEFAULT_SERVICE_NAME: string;
+```

package/build/docs/ibm-cloud-sdk-core.baseservice.default_service_url.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [DEFAULT\_SERVICE\_URL](./ibm-cloud-sdk-core.baseservice.default_service_url.md)
+
+## BaseService.DEFAULT\_SERVICE\_URL property
+
+**Signature:**
+
+```typescript
+static DEFAULT_SERVICE_URL: string;
+```

package/build/docs/ibm-cloud-sdk-core.baseservice.disableretries.md

@@ -0,0 +1,17 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [disableRetries](./ibm-cloud-sdk-core.baseservice.disableretries.md)
+
+## BaseService.disableRetries() method
+
+Disables retries.
+
+**Signature:**
+
+```typescript
+disableRetries(): void;
+```
+**Returns:**
+
+void
+

package/build/docs/ibm-cloud-sdk-core.baseservice.enableretries.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [enableRetries](./ibm-cloud-sdk-core.baseservice.enableretries.md)
+
+## BaseService.enableRetries() method
+
+Enable retries for unfulfilled requests.
+
+**Signature:**
+
+```typescript
+enableRetries(retryOptions?: RetryOptions): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+retryOptions
+
+
+</td><td>
+
+RetryOptions
+
+
+</td><td>
+
+_(Optional)_ the configuration for retries
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/build/docs/ibm-cloud-sdk-core.baseservice.getauthenticator.md

@@ -0,0 +1,19 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [getAuthenticator](./ibm-cloud-sdk-core.baseservice.getauthenticator.md)
+
+## BaseService.getAuthenticator() method
+
+Get the instance of the authenticator set on the service.
+
+**Signature:**
+
+```typescript
+getAuthenticator(): any;
+```
+**Returns:**
+
+any
+
+the Authenticator instance
+

package/build/docs/ibm-cloud-sdk-core.baseservice.gethttpclient.md

@@ -0,0 +1,17 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [getHttpClient](./ibm-cloud-sdk-core.baseservice.gethttpclient.md)
+
+## BaseService.getHttpClient() method
+
+Get the Axios instance set on the service. All requests will be made using this instance.
+
+**Signature:**
+
+```typescript
+getHttpClient(): import("axios").AxiosInstance;
+```
+**Returns:**
+
+import("axios").AxiosInstance
+

package/build/docs/ibm-cloud-sdk-core.baseservice.md

@@ -0,0 +1,313 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md)
+
+## BaseService class
+
+Common functionality shared by generated service classes.
+
+The base service authenticates requests via its authenticator, and sends them to the service endpoint.
+
+**Signature:**
+
+```typescript
+export declare class BaseService 
+```
+
+## Constructors
+
+<table><thead><tr><th>
+
+Constructor
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[(constructor)(userOptions)](./ibm-cloud-sdk-core.baseservice._constructor_.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Configuration values for a service.
+
+
+</td></tr>
+</tbody></table>
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[baseOptions](./ibm-cloud-sdk-core.baseservice.baseoptions.md)
+
+
+</td><td>
+
+`protected`
+
+
+</td><td>
+
+BaseServiceOptions
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[DEFAULT\_SERVICE\_NAME](./ibm-cloud-sdk-core.baseservice.default_service_name.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[DEFAULT\_SERVICE\_URL](./ibm-cloud-sdk-core.baseservice.default_service_url.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[configureService(serviceName)](./ibm-cloud-sdk-core.baseservice.configureservice.md)
+
+
+</td><td>
+
+`protected`
+
+
+</td><td>
+
+Configure the service using external configuration
+
+
+</td></tr>
+<tr><td>
+
+[convertModel(input, converterFn, isMap)](./ibm-cloud-sdk-core.baseservice.convertmodel.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+Applies a given modifier function on a model object. Since the model object can be a map, or an array, or a model, these types needs different handling. Considering whether the input object is a map happens with an explicit parameter.
+
+
+</td></tr>
+<tr><td>
+
+[createRequest(parameters)](./ibm-cloud-sdk-core.baseservice.createrequest.md)
+
+
+</td><td>
+
+`protected`
+
+
+</td><td>
+
+Wrapper around `sendRequest` that enforces the request will be authenticated.
+
+
+</td></tr>
+<tr><td>
+
+[createRequestAndDeserializeResponse(parameters, deserializerFn, isMap)](./ibm-cloud-sdk-core.baseservice.createrequestanddeserializeresponse.md)
+
+
+</td><td>
+
+`protected`
+
+
+</td><td>
+
+Wrapper around `createRequest` that enforces arrived response to be deserialized.
+
+
+</td></tr>
+<tr><td>
+
+[disableRetries()](./ibm-cloud-sdk-core.baseservice.disableretries.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Disables retries.
+
+
+</td></tr>
+<tr><td>
+
+[enableRetries(retryOptions)](./ibm-cloud-sdk-core.baseservice.enableretries.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Enable retries for unfulfilled requests.
+
+
+</td></tr>
+<tr><td>
+
+[getAuthenticator()](./ibm-cloud-sdk-core.baseservice.getauthenticator.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Get the instance of the authenticator set on the service.
+
+
+</td></tr>
+<tr><td>
+
+[getHttpClient()](./ibm-cloud-sdk-core.baseservice.gethttpclient.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Get the Axios instance set on the service. All requests will be made using this instance.
+
+
+</td></tr>
+<tr><td>
+
+[setDefaultHeaders(headers)](./ibm-cloud-sdk-core.baseservice.setdefaultheaders.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Set the HTTP headers to be sent in every request.
+
+
+</td></tr>
+<tr><td>
+
+[setEnableGzipCompression(setting)](./ibm-cloud-sdk-core.baseservice.setenablegzipcompression.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Turn request body compression on or off.
+
+
+</td></tr>
+<tr><td>
+
+[setServiceUrl(url)](./ibm-cloud-sdk-core.baseservice.setserviceurl.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Set the service URL to send requests to.
+
+
+</td></tr>
+</tbody></table>

package/build/docs/ibm-cloud-sdk-core.baseservice.setdefaultheaders.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [setDefaultHeaders](./ibm-cloud-sdk-core.baseservice.setdefaultheaders.md)
+
+## BaseService.setDefaultHeaders() method
+
+Set the HTTP headers to be sent in every request.
+
+**Signature:**
+
+```typescript
+setDefaultHeaders(headers: OutgoingHttpHeaders): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+headers
+
+
+</td><td>
+
+OutgoingHttpHeaders
+
+
+</td><td>
+
+the map of headers to include in requests.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/build/docs/ibm-cloud-sdk-core.baseservice.setenablegzipcompression.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [setEnableGzipCompression](./ibm-cloud-sdk-core.baseservice.setenablegzipcompression.md)
+
+## BaseService.setEnableGzipCompression() method
+
+Turn request body compression on or off.
+
+**Signature:**
+
+```typescript
+setEnableGzipCompression(setting: boolean): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+setting
+
+
+</td><td>
+
+boolean
+
+
+</td><td>
+
+Will turn it on if 'true', off if 'false'.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+

package/build/docs/ibm-cloud-sdk-core.baseservice.setserviceurl.md

@@ -0,0 +1,53 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [ibm-cloud-sdk-core](./ibm-cloud-sdk-core.md) &gt; [BaseService](./ibm-cloud-sdk-core.baseservice.md) &gt; [setServiceUrl](./ibm-cloud-sdk-core.baseservice.setserviceurl.md)
+
+## BaseService.setServiceUrl() method
+
+Set the service URL to send requests to.
+
+**Signature:**
+
+```typescript
+setServiceUrl(url: string): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+url
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+the base URL for the service.
+
+
+</td></tr>
+</tbody></table>
+**Returns:**
+
+void
+