Construct a CloudantV1 object.
Options for the service.
Configure the service using external configuration Cloudant specific extensions:
The name of the service. Will be used to read from external configuration.
Delete an attachment.
Deletes the attachment with the filename, {attachment_name}
, from the specified doc. You must supply the rev
query parameter or If-Match
header with the current revision to delete the attachment.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Delete an index.
The parameters to send to the service.
Delete a local document.
Deletes the specified local document. The semantics are identical to deleting a standard document in the specified database, except that the document is not replicated.
The parameters to send to the service.
Cancel a replication.
Cancels a replication by deleting the document that describes it from the _replicator
database.
The parameters to send to the service.
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.
Retrieve Activity Tracker events information.
Check event types that are being sent to IBM Cloud Activity Tracker for the IBM Cloudant instance.
Query a list of all database names in the instance.
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.
The parameters to send to the service.
Retrieve provisioned throughput capacity information.
View the amount of provisioned throughput capacity that is allocated to an IBM Cloudant instance and what is the target provisioned throughput capacity.
Retrieve CORS configuration information.
Lists all Cross-origin resource sharing (CORS) configuration. CORS defines a way in which the browser and the server interact to determine whether or not to allow the request.
Retrieve the current provisioned throughput capacity consumption.
View the current consumption of provisioned throughput capacity for an IBM Cloudant instance. The current consumption shows the quantities of reads, writes, and global queries conducted against the instance for a given second.
Retrieve information about a database.
The parameters to send to the service.
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..
Retrieve a design document.
Returns design document with the specified doc_id
from the specified database. Unless you request a specific
revision, the current revision of the design document is always returned.
The parameters to send to the service.
Retrieve information about a design document.
Retrieves information about the specified design document, including the index, index size, and current status of the design document and associated index information.
The parameters to send to the service.
Retrieve a document.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Retrieve shard information for a specific document.
Retrieves information about a specific shard where a particular document is stored, along with information about the nodes where that shard has a replica.
The parameters to send to the service.
Query a geospatial index.
Executes a query against the requested geospatial index from the specified design document.
The parameters to send to the service.
Query a geospatial index as stream.
Executes a query against the requested geospatial index from the specified design document.
The parameters to send to the service.
Retrieve information about a geospatial index.
The parameters to send to the service.
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.
The parameters to send to the service.
Retrieve a local document.
Retrieves the specified local document. The semantics are identical to accessing a standard document in the specified database, except that the document is not replicated.
The parameters to send to the service.
Retrieve cluster membership information.
Displays the nodes that are part of the cluster as cluster_nodes
. The field, all_nodes
, displays all nodes this
node knows about, including the ones that are part of the cluster. This endpoint is useful when you set up a
cluster.
Retrieve information about a database partition.
Given a partition key, return the database name, sizes, partition, doc count, and doc delete count.
The parameters to send to the service.
Retrieve a replication document.
Retrieves a replication document from the _replicator
database to view the configuration of the replication. The
status of the replication is no longer recorded in the document but can be checked via the replication scheduler.
The parameters to send to the service.
Retrieve replication scheduler documents.
Lists replication documents, including information about all documents, even the ones in a completed or failed state. For each document, the endpoint returns the document ID, database, replication ID, source and target, and other information.
Retrieve a replication scheduler document.
Retrieves information about a replication document from the replicator database. The endpoint returns the document ID, database, replication ID, source and target, and other information.
The parameters to send to the service.
Retrieve a replication scheduler job.
Retrieves the state of a single replication task based on its replication ID.
The parameters to send to the service.
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.
Retrieve information about a search index.
Retrieve search index metadata information, such as the size of the index on disk.
The parameters to send to the service.
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.
The parameters to send to the service.
Retrieve server instance information.
When you access the root of an instance, IBM Cloudant returns meta-information about the instance. The response includes a JSON structure that contains information about the server, including a welcome message and the server's version.
Retrieve current session cookie information.
Retrieves information about the authenticated user's session.
Retrieve shard information.
List each shard range and the corresponding replicas for a specified database.
The parameters to send to the service.
Retrieve information about whether the server is up.
Confirms that the server is up, running, and ready to respond to requests. If maintenance_mode
is true
or
nolb
, the endpoint returns a 404 response.
Retrieve one or more UUIDs.
Requests one or more Universally Unique Identifiers (UUIDs) from the instance. The response is a JSON object that provides a list of UUIDs.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Retrieve HTTP headers about whether the server is up.
Retrieves the HTTP headers about whether the server is up.
Modify Activity Tracker events configuration.
Configure event types that are being sent to IBM Cloud Activity Tracker for the IBM Cloudant instance.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
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.
The parameters to send to the service.
Bulk query revision information for multiple documents.
Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.
The parameters to send to the service.
Bulk query revision information for multiple documents as mixed.
Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.
The parameters to send to the service.
Bulk query revision information for multiple documents as related.
Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.
The parameters to send to the service.
Bulk query revision information for multiple documents as stream.
Fetch specific revisions or revision histories for multiple documents in bulk as replicators do.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Multi-query the list of all design documents.
This operation runs multiple view queries of all design documents in the database. This operation enables you to
request numerous queries in a single request, in place of multiple POST /{db}/_design_docs
requests.
The parameters to send to the service.
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.
The parameters to send to the service.
Retrieve information about which index is used for a query.
Shows which index is being used by the query. Parameters are the same as the _find
endpoint.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Cleanup old geospatial indexes.
Cleanup old geospatial indexes from disk that have been superseded by newer index builds.
The parameters to send to the service.
Create a new index on a database.
Create a new index on a database.
The parameters to send to the service.
Query which document revisions are missing from the database.
Given a list of document revisions, returns the document revisions that do not exist in the database.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Query a database partition index by using selector syntax (POST).
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Create or modify a replication operation.
Requests, configures, or stops a replicate operation.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Query tokenization of sample text.
Returns the results of analyzer tokenization of the provided sample text. This endpoint can be used for testing analyzer tokenization.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
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.
The parameters to send to the service.
Multi-query a MapReduce view.
This operation runs multiple specified view queries against the view function from the specified design document.
The parameters to send to the service.
Multi-query a MapReduce view as stream.
This operation runs multiple specified view queries against the view function from the specified design document.
The parameters to send to the service.
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.
The parameters to send to the service.
Update the target provisioned throughput capacity.
Sets the target provisioned throughput capacity for an IBM Cloudant instance. When target capacity is changed, the current capacity asynchronously changes to meet the target capacity.
The parameters to send to the service.
Modify only Cloudant related database permissions.
Modify only Cloudant related permissions to database. Be careful: by removing an API key from the list, you remove the API key from the list of users that have access to the database.
The parameters to send to the service.
Modify CORS configuration.
Sets the CORS configuration. The configuration applies to all databases and all account level endpoints in your account.
The parameters to send to the service.
Create a database.
The parameters to send to the service.
Create or modify a design document.
The PUT method creates a new named design document, or creates a new revision of the existing design document.
The parameters to send to the service.
Create or modify a document.
The PUT method creates a new named document, or creates a new revision of the existing document. Unlike the POST /{db}
request, you must specify the document ID in the request URL.
The parameters to send to the service.
Create or modify a local document.
Stores the specified local document. The semantics are identical to storing a standard document in the specified database, except that the document is not replicated.
The parameters to send to the service.
Start or update a replication.
Creates or modifies a document in the _replicator
database to start a new replication or to edit an existing
replication.
The parameters to send to the service.
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.
The parameters to send to the service.
Turn request body compression on or off. Cloudant specific extensions:
Will turn it on if 'true', off if 'false'.
Set the service URL to send requests to and use the new service URL for CouchDB Session Authentication to claim session token from.
The base URL for the service.
Constructs an instance of CloudantV1 with passed in options and external configuration.
Generated using TypeDoc
NoSQL database based on Apache CouchDB