![Introducing Enhanced Alert Actions and Triage Functionality](https://cdn.sanity.io/images/cgdhsj6q/production/fe71306d515f85de6139b46745ea7180362324f0-2530x946.png?w=800&fit=max&auto=format)
Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
atlas-api-client
Advanced tools
Swagger description of the MongoDB Atlas API: https://docs.atlas.mongodb.com/reference/api-resources/. Used to generate client code to interact with the API.
Readme
atlas-api-client client library.
Request status log is used to to output the status of a request returned by the client.
atlas-api-client client library.
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Promise
Error
Error
Error
Error
atlas-api-client client
Create a new client object.
Param | Type | Default | Description |
---|---|---|---|
options | Object | Options for constructing a client object. | |
[options.address] | string | URL where the server is located. Must provide this or the discovery argument | |
[options.discovery] | bool | Use clever-discovery to locate the server. Must provide this or the address argument | |
[options.timeout] | number | The timeout to use for all client requests, in milliseconds. This can be overridden on a per-request basis. Default is 5000ms. | |
[options.retryPolicy] | RetryPolicies | RetryPolicies.Single | The logic to determine which requests to retry, as well as how many times to retry. |
[options.logger] | module:kayvee.Logger | logger.New("atlas-api-client-wagclient") | The Kayvee logger to use in the client. |
[options.circuit] | Object | Options for constructing the client's circuit breaker. | |
[options.circuit.forceClosed] | bool | When set to true the circuit will always be closed. Default: true. | |
[options.circuit.maxConcurrentRequests] | number | the maximum number of concurrent requests the client can make at the same time. Default: 100. | |
[options.circuit.requestVolumeThreshold] | number | The minimum number of requests needed before a circuit can be tripped due to health. Default: 20. | |
[options.circuit.sleepWindow] | number | how long, in milliseconds, to wait after a circuit opens before testing for recovery. Default: 5000. | |
[options.circuit.errorPercentThreshold] | number | the threshold to place on the rolling error rate. Once the error rate exceeds this percentage, the circuit opens. Default: 90. |
Promise
Get All Clusters
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
groupID | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Create a Cluster
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.createOrUpdateClusterRequest | ||
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Deletes a cluster
Kind: instance method of AtlasAPIClient
Fulfill: undefined
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.clusterName | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Gets a cluster
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.clusterName | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Update a Cluster
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.clusterName | string | |
params.createOrUpdateClusterRequest | ||
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get All DatabaseUsers
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
groupID | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Create a DatabaseUser
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.createDatabaseUserRequest | ||
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Deletes a DatabaseUser
Kind: instance method of AtlasAPIClient
Fulfill: undefined
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.username | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Gets a database user
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.username | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Update a DatabaseUser
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.username | string | |
params.updateDatabaseUserRequest | ||
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get All Processes
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
groupID | string | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get the available databases for a Atlas MongoDB Process
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.host | string | |
params.port | number | |
[params.pageNum] | number | |
[params.itemsPerPage] | number | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get the measurements of the specified database for a Atlas MongoDB process.
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.host | string | |
params.port | number | |
params.databaseID | string | |
params.granularity | string | |
[params.period] | string | |
[params.start] | string | |
[params.end] | string | |
[params.m] | Array.<string> | |
[params.pageNum] | number | |
[params.itemsPerPage] | number | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get the available disks for a Atlas MongoDB Process
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.host | string | |
params.port | number | |
[params.pageNum] | number | |
[params.itemsPerPage] | number | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get the measurements of the specified disk for a Atlas MongoDB process.
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.host | string | |
params.port | number | |
params.diskName | string | |
params.granularity | string | |
[params.period] | string | |
[params.start] | string | |
[params.end] | string | |
[params.m] | Array.<string> | |
[params.pageNum] | number | |
[params.itemsPerPage] | number | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Promise
Get measurements for a specific Atlas MongoDB process (mongod or mongos).
Kind: instance method of AtlasAPIClient
Fulfill: Object
Reject: BadRequest
Reject: Unauthorized
Reject: NotFound
Reject: InternalError
Reject: Error
Param | Type | Description |
---|---|---|
params | Object | |
params.groupID | string | |
params.host | string | |
params.port | number | |
params.granularity | string | |
[params.period] | string | |
[params.start] | string | |
[params.end] | string | |
[params.m] | Array.<string> | |
[params.pageNum] | number | |
[params.itemsPerPage] | number | |
[options] | object | |
[options.timeout] | number | A request specific timeout |
[options.span] | Span | An OpenTracing span - For example from the parent request |
[options.retryPolicy] | RetryPolicies | A request specific retryPolicy |
[cb] | function |
Retry policies available to use.
Kind: static property of AtlasAPIClient
The exponential retry policy will retry five times with an exponential backoff.
Kind: static constant of RetryPolicies
Use this retry policy to retry a request once.
Kind: static constant of RetryPolicies
Use this retry policy to turn off retries.
Kind: static constant of RetryPolicies
Errors returned by methods.
Kind: static property of AtlasAPIClient
Error
Error
Error
Error
Error
BadRequest
Kind: static class of Errors
Extends: Error
Properties
Name | Type |
---|---|
detail | string |
error | number |
message | string |
reason | string |
Error
Unauthorized
Kind: static class of Errors
Extends: Error
Properties
Name | Type |
---|---|
detail | string |
error | number |
message | string |
reason | string |
Error
NotFound
Kind: static class of Errors
Extends: Error
Properties
Name | Type |
---|---|
detail | string |
error | number |
message | string |
reason | string |
Error
InternalError
Kind: static class of Errors
Extends: Error
Properties
Name | Type |
---|---|
detail | string |
error | number |
message | string |
reason | string |
Default circuit breaker options.
Kind: static constant of AtlasAPIClient
Request status log is used to to output the status of a request returned by the client.
Kind: global function
FAQs
Swagger description of the MongoDB Atlas API: https://docs.atlas.mongodb.com/reference/api-resources/. Used to generate client code to interact with the API.
The npm package atlas-api-client receives a total of 0 weekly downloads. As such, atlas-api-client popularity was classified as not popular.
We found that atlas-api-client demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.