Options
All
  • Public
  • Public/Protected
  • All
Menu

NoSQL database based on Apache CouchDB

Hierarchy

  • CloudantBaseService
    • export=

Index

Constructors

Properties

Methods

Constructors

constructor

  • new export=(options: UserOptions): export=
  • Construct a CloudantV1 object.

    Parameters

    • options: UserOptions

      Options for the service.

    Returns export=

Properties

Static DEFAULT_SERVICE_NAME

DEFAULT_SERVICE_NAME: string = 'cloudant'

Static DEFAULT_SERVICE_URL

DEFAULT_SERVICE_URL: string = 'http://localhost:5984'

Methods

Protected configureService

  • configureService(serviceName: string): void
  • Configure the service using external configuration Cloudant specific extensions:

    • Apply the new base service options on CouchdbSessionAuthenticator.

    Parameters

    • serviceName: string

      The name of the service. Will be used to read from external configuration.

    Returns void

Protected createRequest

  • createRequest(parameters: any): Promise<any>
  • Extend createRequest to handle document and attachment validation.

    Parameters

    • parameters: any

    Returns Promise<any>

deleteAttachment

deleteDatabase

  • Delete a database.

    Deletes the specified database and all documents and attachments contained within it. To avoid deleting a database, the server responds with a 400 HTTP status code when the request URL includes a ?rev= parameter. This response suggests that a user wanted to delete a document but forgot to add the document ID to the URL.

    Parameters

    Returns Promise<export=.Response<export=.Ok>>

deleteDesignDocument

  • Delete a design document.

    Marks the specified design document as deleted by adding a _deleted field with the value true. Documents with this field are not returned with requests but stay in the database. You must supply the current (latest) revision, either by using the rev parameter or by using the If-Match header to specify the revision.

    Parameters

    Returns Promise<export=.Response<export=.DocumentResult>>

deleteDocument

  • Delete a document.

    Marks the specified document as deleted by adding a _deleted field with the value true. Documents with this field are not returned within requests anymore but stay in the database. You must supply the current (latest) revision, either by using the rev parameter or by using the If-Match header to specify the revision.

    Parameters

    Returns Promise<export=.Response<export=.DocumentResult>>

deleteIndex

deleteLocalDocument

deleteReplicationDocument

getActiveTasks

  • Retrieve list of running tasks.

    Lists running tasks, including the task type, name, status, and process ID. The result includes a JSON array of the currently running tasks, with each task described as a single object. Depending on the operation type, the set of response object fields might be different.

    Parameters

    Returns Promise<export=.Response<export=.ActiveTask[]>>

getActivityTrackerEvents

getAllDbs

getAttachment

  • Retrieve an attachment.

    Returns the file attachment that is associated with the document. The raw data of the associated attachment is returned, just as if you were accessing a static file. The returned Content-Type header is the same as the content type set when the document attachment was submitted to the database.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

getCapacityThroughputInformation

getCorsInformation

getCurrentThroughputInformation

getDatabaseInformation

getDbUpdates

  • Retrieve change events for all databases.

    Lists changes to databases, like a global changes feed. Types of changes include updating the database and creating or deleting a database. Like the changes feed, the feed is not guaranteed to return changes in the correct order and might repeat changes. Polling modes for this method work like polling modes for the changes feed. Note: This endpoint requires _admin or _db_updates role and is only available on dedicated clusters..

    Parameters

    Returns Promise<export=.Response<export=.DbUpdates>>

getDesignDocument

getDesignDocumentInformation

getDocument

getDocumentAsMixed

  • Retrieve a document as mixed.

    Returns document with the specified doc_id from the specified database. Unless you request a specific revision, the latest revision of the document is always returned.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

getDocumentAsRelated

  • Retrieve a document as related.

    Returns document with the specified doc_id from the specified database. Unless you request a specific revision, the latest revision of the document is always returned.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

getDocumentAsStream

  • Retrieve a document as stream.

    Returns document with the specified doc_id from the specified database. Unless you request a specific revision, the latest revision of the document is always returned.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

getDocumentShardsInfo

getGeo

getGeoAsStream

getGeoIndexInformation

getIndexesInformation

  • Retrieve information about all indexes.

    When you make a GET request to /db/_index, you get a list of all indexes used by Cloudant Query in the database, including the primary index. In addition to the information available through this API, indexes are also stored in the indexes property of design documents.

    Parameters

    Returns Promise<export=.Response<export=.IndexesInformation>>

getLocalDocument

getMembershipInformation

getPartitionInformation

getReplicationDocument

getSchedulerDocs

getSchedulerDocument

getSchedulerJob

getSchedulerJobs

  • Retrieve replication scheduler jobs.

    Retrieves information about replications that were created via /_replicate endpoint, as well as those created from replication documents. It doesn't include replications that completed or failed to start because replication documents were malformed. Each job description includes source and target information, replication ID, history of recent events, and other information.

    Parameters

    Returns Promise<export=.Response<export=.SchedulerJobsResult>>

getSearchInfo

getSecurity

  • Retrieve database permissions information.

    See who has permission to read, write, and manage the database. The credentials you use to log in to the dashboard automatically include _admin permissions to all databases you create. Everyone and everything else, including users you share databases with and API keys you create, must be given a permission level explicitly.

    Parameters

    Returns Promise<export=.Response<export=.Security>>

getServerInformation

getSessionInformation

getShardsInformation

getUpInformation

getUuids

headAttachment

  • Retrieve the HTTP headers for an attachment.

    Returns the HTTP headers that contain a minimal amount of information about the specified attachment. This method supports the same query arguments as the GET /{db}/{doc_id}/{attachment_name} method, but only the header information (including attachment size, encoding, and the MD5 hash as an ETag), is returned.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headDatabase

  • Retrieve the HTTP headers for a database.

    Returns the HTTP headers that contain a minimal amount of information about the specified database. Since the response body is empty, using the HEAD method is a lightweight way to check if the database exists or not.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headDesignDocument

  • Retrieve the HTTP headers for a design document.

    This method supports the same query arguments as the GET /{db}/_design/{ddoc} method, but the results include only the header information (including design document size, and the revision as an ETag). The ETag header shows the current revision for the requested design document, and if you requested the design document in full, the Content-Length specifies the length of the data. If you add any of the query arguments, then the resulting HTTP headers correspond to what is returned for the equivalent GET request.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headDocument

  • Retrieve the HTTP headers for the document.

    This method supports the same query arguments as the GET /{db}/{docid} method, but only the header information (including document size and the revision as an ETag) is returned. The ETag header shows the current revision for the requested document, and the Content-Length specifies the length of the data if the document was requested in full. Add any of the query arguments, then the resulting HTTP headers that correspond to it are returned.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headLocalDocument

  • Retrieve HTTP headers for a local document.

    Retrieves the HTTP headers containing minimal amount of information about the specified local document. Since the response body is empty, using the HEAD method is a lightweight way to check if the local document exists or not.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headReplicationDocument

  • Retrieve the HTTP headers for a replication document.

    Retrieves the HTTP headers containing minimal amount of information about the specified replication document from the _replicator database. The method supports the same query arguments as the GET /_replicator/{doc_id} method, but only headers like content length and the revision (ETag header) are returned.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headSchedulerDocument

  • Retrieve HTTP headers for a replication scheduler document.

    Retrieves the HTTP headers containing minimal amount of information about the specified replication scheduler document. Since the response body is empty, using the HEAD method is a lightweight way to check if the replication scheduler document exists or not.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headSchedulerJob

  • Retrieve the HTTP headers for a replication scheduler job.

    Returns the HTTP headers that contain a minimal amount of information about the specified replication task. Only the header information is returned.

    Parameters

    Returns Promise<export=.Response<export=.Empty>>

headUpInformation

postActivityTrackerEvents

postAllDocs

  • Query a list of all documents in a database.

    Queries the primary index (all document IDs). The results that match the request body parameters are returned in a JSON object, including a list of matching documents with basic contents, such as the ID and revision. When no request body parameters are specified, results for all documents in the database are returned. Optionally, document content or additional metadata can be included in the response.

    Parameters

    Returns Promise<export=.Response<export=.AllDocsResult>>

postAllDocsAsStream

  • Query a list of all documents in a database as stream.

    Queries the primary index (all document IDs). The results that match the request body parameters are returned in a JSON object, including a list of matching documents with basic contents, such as the ID and revision. When no request body parameters are specified, results for all documents in the database are returned. Optionally, document content or additional metadata can be included in the response.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postAllDocsQueries

  • Multi-query the list of all documents in a database.

    Runs multiple queries using the primary index (all document IDs). Returns a JSON object that contains a list of result objects, one for each query, with a structure equivalent to that of a single _all_docs request. This enables you to request multiple queries in a single request, in place of multiple POST /{db}/_all_docs requests.

    Parameters

    Returns Promise<export=.Response<export=.AllDocsQueriesResult>>

postAllDocsQueriesAsStream

  • Multi-query the list of all documents in a database as stream.

    Runs multiple queries using the primary index (all document IDs). Returns a JSON object that contains a list of result objects, one for each query, with a structure equivalent to that of a single _all_docs request. This enables you to request multiple queries in a single request, in place of multiple POST /{db}/_all_docs requests.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postApiKeys

  • Generates API keys for apps or persons to enable database access.

    Generates API keys to enable database access for a person or application, but without creating a new IBM Cloudant account for that person or application. An API key is a randomly generated username and password. The key is given the wanted access permissions for a database.

    Parameters

    Returns Promise<export=.Response<export=.ApiKeysResult>>

postBulkDocs

  • Bulk modify multiple documents in a database.

    The bulk document API allows you to create and update multiple documents at the same time within a single request. The basic operation is similar to creating or updating a single document, except that you batch the document structure and information.

    Parameters

    Returns Promise<export=.Response<export=.DocumentResult[]>>

postBulkGet

postBulkGetAsMixed

  • Bulk query revision information for multiple documents as mixed.

    Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postBulkGetAsRelated

  • Bulk query revision information for multiple documents as related.

    Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postBulkGetAsStream

  • Bulk query revision information for multiple documents as stream.

    Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postChanges

  • Query the database document changes feed.

    Requests the database changes feed in the same way as GET /{db}/_changes does. It is widely used with the filter query parameter because it allows one to pass more information to the filter.

    Parameters

    Returns Promise<export=.Response<export=.ChangesResult>>

postChangesAsStream

  • Query the database document changes feed as stream.

    Requests the database changes feed in the same way as GET /{db}/_changes does. It is widely used with the filter query parameter because it allows one to pass more information to the filter.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postDbsInfo

  • Query information about multiple databases.

    This operation enables you to request information about multiple databases in a single request, instead of issuing multiple GET /{db} requests. It returns a list that contains an information object for each database specified in the request.

    Parameters

    Returns Promise<export=.Response<export=.DbsInfoResult[]>>

postDesignDocs

  • Query a list of all design documents in a database.

    Queries the index of all design document IDs. The results matching the request body parameters are returned in a JSON object, including a list of matching design documents with basic contents, such as the ID and revision. When no request body parameters are specified, results for all design documents in the database are returned. Optionally, the design document content or additional metadata can be included in the response.

    Parameters

    Returns Promise<export=.Response<export=.AllDocsResult>>

postDesignDocsQueries

postDocument

  • Create or modify a document in a database.

    Creates or modifies a document in the specified database by using the supplied JSON document. If the JSON document doesn't specify an _id field, then the document is created with a new unique ID generated by the UUID algorithm that is configured for the server. If the document includes the _id field, then it is created with that _id or updated if the _id already exists, and an appropriate _rev is included in the JSON document. If the _id includes the _local or _design prefix, then this operation is used to create or modify local or design documents respectively.

    Parameters

    Returns Promise<export=.Response<export=.DocumentResult>>

postExplain

postFind

  • Query an index by using selector syntax.

    Query documents by using a declarative JSON querying syntax. Queries can use the built-in _all_docs index or custom indices, specified by using the _index endpoint.

    Parameters

    Returns Promise<export=.Response<export=.FindResult>>

postFindAsStream

  • Query an index by using selector syntax as stream.

    Query documents by using a declarative JSON querying syntax. Queries can use the built-in _all_docs index or custom indices, specified by using the _index endpoint.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postGeoCleanup

postIndex

postPartitionAllDocs

  • Query a list of all documents in a database partition.

    Queries the primary index (all document IDs). The results that match the query parameters are returned in a JSON object, including a list of matching documents with basic contents, such as the ID and revision. When no query parameters are specified, results for all documents in the database partition are returned. Optionally, document content or additional metadata can be included in the response.

    Parameters

    Returns Promise<export=.Response<export=.AllDocsResult>>

postPartitionAllDocsAsStream

  • Query a list of all documents in a database partition as stream.

    Queries the primary index (all document IDs). The results that match the query parameters are returned in a JSON object, including a list of matching documents with basic contents, such as the ID and revision. When no query parameters are specified, results for all documents in the database partition are returned. Optionally, document content or additional metadata can be included in the response.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postPartitionFind

postPartitionFindAsStream

  • Query a database partition index by using selector syntax (POST) as stream.

    Query documents by using a declarative JSON querying syntax. Queries can use the built-in _all_docs index or custom indices, specified by using the _index endpoint.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postPartitionSearch

  • Query a database partition search index.

    Partitioned Search indexes, which are defined in design documents, allow partition databases to be queried by using Lucene Query Parser Syntax. Search indexes are defined by an index function, similar to a map function in MapReduce views. The index function decides what data to index and store in the index.

    Parameters

    Returns Promise<export=.Response<export=.SearchResult>>

postPartitionSearchAsStream

  • Query a database partition search index as stream.

    Partitioned Search indexes, which are defined in design documents, allow partition databases to be queried by using Lucene Query Parser Syntax. Search indexes are defined by an index function, similar to a map function in MapReduce views. The index function decides what data to index and store in the index.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postPartitionView

  • Query a database partition MapReduce view function.

    Runs the specified view function from the specified design document. Unlike GET /{db}/_design/{ddoc}/_view/{view} for accessing views, the POST method supports the specification of explicit keys to be retrieved from the view results. The remainder of the POST view functionality is identical to the GET /{db}/_design/{ddoc}/_view/{view} API.

    Parameters

    Returns Promise<export=.Response<export=.ViewResult>>

postPartitionViewAsStream

  • Query a database partition MapReduce view function as stream.

    Runs the specified view function from the specified design document. Unlike GET /{db}/_design/{ddoc}/_view/{view} for accessing views, the POST method supports the specification of explicit keys to be retrieved from the view results. The remainder of the POST view functionality is identical to the GET /{db}/_design/{ddoc}/_view/{view} API.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postRevsDiff

  • Query the document revisions and possible ancestors missing from the database.

    The replicator is the primary user of this operation. After receiving a set of new revision IDs from the source database, the replicator sends this set to the destination database's _revs_diff to find out which of them already exists there. It can then avoid fetching and sending already-known document bodies.

    Parameters

    Returns Promise<export=.Response<export=.JsonObject>>

postSearch

  • Query a search index.

    Search indexes, which are defined in design documents, allow databases to be queried by using Lucene Query Parser Syntax. An index function defines a search index, similar to a map function in MapReduce views. The index function decides what data to index and what data to store in the index. The advantage of using the HTTP POST method is that the query is submitted as a JSON object in the request body. This avoids the limitations of passing query options as URL query parameters of a GET request.

    Parameters

    Returns Promise<export=.Response<export=.SearchResult>>

postSearchAnalyze

postSearchAsStream

  • Query a search index as stream.

    Search indexes, which are defined in design documents, allow databases to be queried by using Lucene Query Parser Syntax. An index function defines a search index, similar to a map function in MapReduce views. The index function decides what data to index and what data to store in the index. The advantage of using the HTTP POST method is that the query is submitted as a JSON object in the request body. This avoids the limitations of passing query options as URL query parameters of a GET request.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postView

  • Query a MapReduce view.

    This operation queries the specified MapReduce view of the specified design document. By default, the map and reduce functions of the view are run to update the view before returning the response. The advantage of using the HTTP POST method is that the query is submitted as a JSON object in the request body. This avoids the limitations of passing query options as URL query parameters of a GET request.

    Parameters

    Returns Promise<export=.Response<export=.ViewResult>>

postViewAsStream

  • Query a MapReduce view as stream.

    This operation queries the specified MapReduce view of the specified design document. By default, the map and reduce functions of the view are run to update the view before returning the response. The advantage of using the HTTP POST method is that the query is submitted as a JSON object in the request body. This avoids the limitations of passing query options as URL query parameters of a GET request.

    Parameters

    Returns Promise<export=.Response<ReadableStream | Buffer>>

postViewQueries

postViewQueriesAsStream

putAttachment

  • Create or modify an attachment.

    Uploads the supplied content as an attachment to the specified document. The attachment name that you provide must be a URL encoded string. You must supply the Content-Type header, and for an existing document, you must also supply either the rev query argument or the If-Match HTTP header. If you omit the revision, a new, otherwise empty, document is created with the provided attachment, or a conflict occurs. If the uploaded attachment uses an existing attachment name in the remote database, it updates the corresponding stored content of the database. Since you must supply the revision information to add an attachment to the document, this serves as validation to update the existing attachment.

    Parameters

    Returns Promise<export=.Response<export=.DocumentResult>>

putCapacityThroughputConfiguration

putCloudantSecurityConfiguration

putCorsConfiguration

putDatabase

putDesignDocument

putDocument

putLocalDocument

putReplicationDocument

putSecurity

  • Modify database permissions.

    Modify who has permission to read, write, or manage a database. This endpoint can be used to modify both Cloudant and CouchDB related permissions. Be careful: by removing a Cloudant API key, a member or an admin from the list of users that have access permissions, you remove it from the list of users that have access to the database.

    Parameters

    Returns Promise<export=.Response<export=.Ok>>

setEnableGzipCompression

  • setEnableGzipCompression(setting: boolean): void
  • Turn request body compression on or off. Cloudant specific extensions:

    • Apply the gzip compression option on CouchdbSessionAuthenticator.

    Parameters

    • setting: boolean

      Will turn it on if 'true', off if 'false'.

    Returns void

setServiceUrl

  • setServiceUrl(url: string): void
  • Set the service URL to send requests to and use the new service URL for CouchDB Session Authentication to claim session token from.

    Parameters

    • url: string

      The base URL for the service.

    Returns void

Static newInstance

  • newInstance(options: UserOptions): export=
  • Constructs an instance of CloudantV1 with passed in options and external configuration.

    Parameters

    • options: UserOptions

    Returns export=

Generated using TypeDoc