Ver el valor de capacidad de rendimiento suministrada actual y de destino

Utilice GET para el punto final de /_api/v2/user/capacity/throughput para ver qué cantidad de capacidad de rendimiento suministrada se asigna a la instancia de IBM Cloudant y cuál es la capacidad de rendimiento suministrada de destino. Cuando cambia la capacidad de destino, la capacidad actual cambia de forma asíncrona para ajustarse a la capacidad de destino. El tamaño del cambio de capacidad y la cantidad de datos que se almacenan en la instancia de IBM Cloudant determinan el tiempo que se tarda para que coincidan las capacidades actual y de destino. El cambio de capacidad se ha completado cuando la capacidad actual coincide con la de destino.

Método

GET

Vía de acceso

/_api/v2/user/capacity/throughput

Respuesta

El valor de capacidad actual y de destino. Cada uno incluye el número de bloques de capacidad y el total de lecturas/segundo, escrituras/segundo y consultas globales/segundo de la capacidad de rendimiento.

Consulte la siguiente solicitud de ejemplo para recuperar la capacidad actual y de destino mediante HTTP:

GET /_api/v2/user/capacity/throughput

Consulte la siguiente solicitud de ejemplo para recuperar la capacidad actual y de destino:

curl "$SERVICE_URL/_api/v2/user/capacity/throughput"

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.CapacityThroughputInformation;

Cloudant service = Cloudant.newInstance();

CapacityThroughputInformation response =
service.getCapacityThroughputInformation().execute().getResult();

System.out.println(response);

const { CloudantV1 } = require('@ibm-cloud/cloudant');

const service = CloudantV1.newInstance({});

service.getCapacityThroughputInformation().then(response => {
  console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.get_capacity_throughput_information().get_result()

print(response)

getCapacityThroughputInformationOptions := service.NewGetCapacityThroughputInformationOptions()

capacityThroughputInformation, response, err := service.GetCapacityThroughputInformation(getCapacityThroughputInformationOptions)
if err != nil {
panic(err)
}

b, _ := json.MarshalIndent(capacityThroughputInformation, "", "  ")
fmt.Println(string(b))

El ejemplo Go anterior requiere el siguiente bloque de importación:

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

Todos los ejemplos de Go requieren que se inicialice el objeto service. Para obtener más información, consulte los ejemplos de la Sección de autenticación de la documentación de la API.

La estructura devuelta incluye los campos siguientes:

current

Detalla la capacidad actual asignada y muestra el número de bloques de capacidad y el desglose de las clases de solicitud de rendimiento.

target

Detalla la capacidad de destino asignada y muestra el número de bloques de capacidad y el desglose de las clases de solicitud de rendimiento.

blocks

Número de bloques de capacidad de rendimiento suministrados, donde un bloque es 100 lecturas/seg, 50 escrituras/seg y 5 consultas globales/seg.

throughput

Desglose del número específico de lecturas/seg, escrituras/seg y consultas globales/seg.

Consulte la siguiente respuesta JSON de ejemplo con la capacidad actual y de destino:

{
  "current": {
    "throughput": {
      "read": 500,
      "write": 250,
      "blocks": 5,
      "query": 25
    }
  },
  "target": {
    "throughput": {
      "read": 1000,
      "write": 500,
      "blocks": 10,
      "query": 50
    }
  }
}

Definir el valor de destino de la capacidad de rendimiento suministrada

Utilice PUT para el punto final de /_api/v2/user/capacity/throughput para establecer la capacidad de rendimiento suministrada de destino para una instancia de IBM Cloudant. Cuando cambia la capacidad de destino, la capacidad actual cambia de forma asíncrona para ajustarse a la capacidad de destino.

Método

PUT

Vía de acceso

/_api/v2/user/capacity/throughput

Respuesta

El valor de capacidad actual y de destino, incluido el número de bloques de capacidad y lecturas/seg totales, escrituras/seg y consultas globales/seg.

Consulte la solicitud de ejemplo siguiente para establecer la capacidad de destino mediante HTTP:

PUT $SERVICE_URL/_api/v2/user/capacity/throughput
Content-Type: application/json

Consulte el siguiente objeto JSON de ejemplo para establecer la capacidad de destino:

{
  "blocks": $NUMBER_OF_BLOCKS
}

Aquí un bloque consta de 100 lecturas/segundo, 50 escrituras/segundo y 5 consultas globales/segundo de capacidad de rendimiento suministrada. El campo $NUMBER_OF_BLOCKS debe ser un entero en el rango de 1 a 100. Pueden conseguir tamaños de capacidad mayores si se pone en contacto con el equipo de soporte de IBM Cloudant.

Consulte la siguiente solicitud de ejemplo para establecer la capacidad de destino:

curl -X PUT "$SERVICE_URL/_api/v2/user/capacity/throughput" -H "Content-Type: application/json" --data '{"blocks": 1}'

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.CapacityThroughputInformation;
import com.ibm.cloud.cloudant.v1.model.PutCapacityThroughputConfigurationOptions;

Cloudant service = Cloudant.newInstance();

PutCapacityThroughputConfigurationOptions options =
    new PutCapacityThroughputConfigurationOptions.Builder()
        .blocks(1)
        .build();

CapacityThroughputInformation response =
service.putCapacityThroughputConfiguration(options).execute().getResult();

System.out.println(response);

const { CloudantV1 } = require('@ibm-cloud/cloudant');

const service = CloudantV1.newInstance({});

service.putCapacityThroughputConfiguration({
  blocks: 1,
}).then(response => {
  console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.put_capacity_throughput_configuration(
  blocks=1
).get_result()

print(response)

putCapacityThroughputConfigurationOptions := service.NewPutCapacityThroughputConfigurationOptions(
  1,
)

capacityThroughputConfiguration, response, err := service.PutCapacityThroughputConfiguration(putCapacityThroughputConfigurationOptions)
if err != nil {
  panic(err)
}

b, _ := json.MarshalIndent(capacityThroughputConfiguration, "", "  ")
fmt.Println(string(b))

El ejemplo Go anterior requiere el siguiente bloque de importación:

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

La estructura devuelta incluye los campos siguientes:

current

Detalla la capacidad actual asignada y muestra tanto el número de bloques de capacidad como el desglose de las clases de solicitudes de rendimiento.

target

Detalla la capacidad de destino establecida y muestra tanto el número de bloques de capacidad como el desglose de las clases de solicitudes de rendimiento.

blocks

Número de bloques de capacidad de rendimiento suministrados, donde el bloque es 100 lecturas/seg, 50 escrituras/seg y 5 consultas globales/seg.

throughput

Desglose del número específico de lecturas/seg, escrituras/seg y consultas globales/seg.

Consulte la siguiente respuesta JSON de ejemplo con la capacidad de destino:

{
  "current": {
    "throughput": {
      "read": 500,
      "write": 250,
      "blocks": 5,
      "query": 25
    }
  },
  "target": {
    "throughput": {
      "read": 1000,
      "write": 500,
      "blocks": 10,
      "query": 50
    }
  }
}

Ver el consumo actual de la capacidad de rendimiento suministrada utilizada

Utilice un método GET para el punto final de /_api/v2/user/current/throughput para ver el consumo actual de capacidad de rendimiento suministrada para una instancia de IBM Cloudant. El consumo actual muestra las cantidades de lecturas, escrituras y consultas globales realizadas en la instancia correspondientes a un segundo determinado. Cuando se utiliza este punto final, es una buena práctica agregar estos datos continuamente a lo largo del tiempo para obtener una visión más completa de los patrones de consumo de rendimiento de una instancia IBM Cloudant.

Método

GET

Vía de acceso

/_api/v2/user/current/throughput

Respuesta

El consumo actual de la capacidad de rendimiento provisionada utilizada, desglosado por el número de lecturas, escrituras y consultas globales.

Consulte la siguiente solicitud de ejemplo para recuperar el consumo actual de capacidad mediante HTTP:

GET $SERVICE_URL/_api/v2/user/current/throughput

Consulte la siguiente solicitud de ejemplo para recuperar el consumo actual de capacidad:

curl "$SERVICE_URL/_api/v2/user/current/throughput"

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.CurrentThroughputInformation;

Cloudant service = Cloudant.newInstance();

CurrentThroughputInformation response =
service.getCurrentThroughputInformation().execute().getResult();

System.out.println(response);

const { CloudantV1 } = require('@ibm-cloud/cloudant');

const service = CloudantV1.newInstance({});

service.getCurrentThroughputInformation().then(response => {
  console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.get_current_throughput_information().get_result()

print(response)

getCurrentThroughputInformationOptions := service.NewGetCurrentThroughputInformationOptions()

currentThroughputInformation, response, err := service.GetCurrentThroughputInformation(getCurrentThroughputInformationOptions)
if err != nil {
  panic(err)
}

b, _ := json.MarshalIndent(currentThroughputInformation, "", "  ")
fmt.Println(string(b))

El ejemplo Go anterior requiere el siguiente bloque de importación:

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

La estructura devuelta incluye los campos siguientes:

• throughput- Desglose del número actual de lecturas, escrituras y consultas globales utilizadas.

Consulte la siguiente respuesta JSON de ejemplo del consumo actual de capacidad:

{
  "throughput": {
    "read": 133,
    "write": 42,
    "query": 13
  }
}