Actualiza la configuración de un daemon de copias de seguridad.
Nota
Utiliza este endpoint cuando quieras actualizar un daemon de copias de seguridad que ya hayas configurado.
Si aún no has configurado el daemon de copias de seguridad, configúralo con el endpoint Crear una configuración de daemon de copias de seguridad.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup
Resource
PUT /daemon/configs/{MACHINE}/{HEAD-ROOT-DIRECTORY}Parámetros de ruta de solicitud
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
MÁQUINA | string | Requerido | Nombre de host o dirección IP de la máquina que sirve el daemon de copias de seguridad. |
HEAD-ROOT-directorio | string | Requerido | Ruta relativa a la raíz codificada en URL del directorio principal en este daemon de copias de seguridad host. Las solicitudes codifican estaches en la ruta de la URL. Por ejemplo, para las plataformas Linux, se debe agregar el directorio principal en este formato: |
Parámetros de Solicitud Query
Los siguientes parámetros de query son opcionales:
Nombre | Tipo | Necesidad | Descripción | predeterminado |
|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que muestra si el cuerpo de la respuesta está en formato pretty-print. |
|
envelope | booleano | Opcional | Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
| booleano | Opcional | Indicador que señala si este daemon de copias de seguridad puede recibir asignaciones de tareas de copias de seguridad. |
| booleano | Opcional | Indicador que indica si este daemon de copias de seguridad puede utilizarse para respaldar bases de datos. |
| booleano | Opcional | Indicador que señala si este daemon de copias de seguridad está listo para su uso. |
| booleano | Opcional | Indicador que muestra si este daemon de copias de seguridad tiene configurada la recolección de basura. |
| string | Opcional | Tipo de disco utilizado para almacenar el directorio principal. Los valores aceptados para esta opción son:
|
| Arreglo de cadenas | Opcional | Arreglo de etiquetas para gestionar a qué tareas de copia de seguridad puede asignar Ops Manager y a qué daemons de copias de seguridad. Establecer estas etiquetas limita qué tareas de copia de seguridad puede procesar este daemon de copias de seguridad. Si se omite, este Daemon de Copias de Seguridad sólo puede procesar tareas de copia de seguridad para Proyectos que no utilizan etiquetas para filtrar sus tareas. |
| Objeto | Requerido | Anfitrión de daemon de copias de seguridad y sus directorios principales. |
| string | Opcional | Ruta relativa a la raíz del directorio principal en este host de Backup Daemon . Acepta rutas con o sin barra final. Ops Manager normaliza la ruta hacia la forma canónica, con exactamente una barra final, y siempre almacena y devuelve ese formulario. Varias barras finales se colapsan a una. Por ejemplo, si envías |
| string | Requerido | Nombre de host o dirección IP del host del daemon de copias de seguridad. |
| Número | Opcional | Número de procesos de trabajo que pueden realizar tareas (es decir, hacer copia de seguridad, restaurar o arreglar) para el Daemon de Copia de Seguridad. |
| booleano | Opcional | Indicador que señala si se supervisa el uso de recursos de este daemon de copias de seguridad. |
| booleano | Opcional | Indicador que señala si este daemon de copias de seguridad puede realizar restauraciones consultables. |
Respuesta
Nombre | Tipo | Descripción |
|---|---|---|
| booleano | Indicador que señala si este daemon de copias de seguridad puede recibir asignaciones de tareas de copias de seguridad. |
| booleano | Indicador que indica si este daemon de copias de seguridad puede utilizarse para respaldar bases de datos. |
| booleano | Indicador que señala si este daemon de copias de seguridad está listo para su uso. |
| booleano | Indicador que muestra si este daemon de copias de seguridad tiene configurada la recolección de basura. |
| string | Tipo de disco utilizado para almacenar el directorio principal. Los valores aceptados para esta opción son:
|
| string | Identificador único de este daemon de copias de seguridad. |
| Arreglo de cadenas | Arreglo de etiquetas para gestionar a qué tareas de copia de seguridad puede asignar Ops Manager y a qué daemons de copias de seguridad. |
| objeto arreglo | Uno o más enlaces a subrecursos o recursos relacionados. Todos los arreglos |
| Objeto | Anfitrión de daemon de copias de seguridad y sus directorios principales. |
| string | Ruta relativa al directorio principal del directorio principal en este daemon de copias de seguridad host. |
| string | Nombre de host o dirección IP del host del daemon de copias de seguridad. |
| Número | Número de procesos de trabajo que pueden ejecutar tareas (es decir, " copia de seguridad, restauración o limpieza) para el daemon de copias de seguridad. |
| booleano | Indicador que señala si se supervisa el uso de recursos de este daemon de copias de seguridad. |
| booleano | Indicador que señala si este daemon de copias de seguridad puede realizar restauraciones consultables. |
Solicitud de ejemplo
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --include \ --request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/daemon/configs/{MACHINE}/{HEAD-ROOT-DIRECTORY}?pretty=true' \ --data '{ "assignmentEnabled" : true, "backupJobsEnabled" : false, "configured" : true, "garbageCollectionEnabled" : true, "headDiskType" : "SSD", "labels" : [ "l1", "l2" ], "machine" : { "headRootDirectory" : "/data/backup/", "machine" : "localhost" }, "numWorkers" : 50, "resourceUsageEnabled" : true, "restoreQueryableJobsEnabled" : true }'Respuesta de ejemplo
Encabezado de respuesta
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-aliveHTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}Respuesta del cuerpo
{ "assignmentEnabled" : true, "backupJobsEnabled" : false, "configured" : true, "garbageCollectionEnabled" : true, "headDiskType" : "SSD", "id" : "5991a422ad5df350005dd062", "labels" : [ "l1", "l2" ], "links" : [ { "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/daemon/configs/{MACHINE}/{HEAD-ROOT-DIRECTORY}", "rel" : "self" }], "machine" : { "headRootDirectory" : "/data/backup/", "machine" : "localhost" }, "numWorkers" : 50, "resourceUsageEnabled" : true, "restoreQueryableJobsEnabled" : true}