/ /

Administración de copias de seguridad

Daemon de copias de seguridad

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Administración de copias de seguridad

Daemon de copias de seguridad

Crear una configuración de daemon de copias de seguridad

Configura un nuevo(a) daemon de copias de seguridad.

Nota

Utilice este endpoint cuando configure un daemon de copias de seguridad por primera vez. Asegúrate de que el proceso daemon de copias de seguridad esté en ejecución antes de configurarlo mediante este endpoint.

Si ya ha configurado el daemon de copias de seguridad, actualícelo usando la Actualizar un punto de configuración del daemon de copias de seguridad.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup

Resource

PUT /daemon/configs/{MACHINE}

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.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonito

booleano

Opcional

Indicador que señala si el cuerpo de respuesta debe estar en un prettyprint formato.

false

envelope

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar este problema, configure envelope=true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre	Descripción
`status`	Código de respuesta HTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Necesidad	Descripción
`assignmentEnabled`	booleano	Opcional	Indicador que señala si este daemon de copias de seguridad puede recibir asignaciones de tareas de copias de seguridad.
`backupJobsEnabled`	booleano	Opcional	Indicador que indica si este daemon de copias de seguridad puede utilizarse para respaldar bases de datos.
`configured`	booleano	Opcional	Indicador que señala si este daemon de copias de seguridad está listo para su uso.
`garbageCollectionEnabled`	booleano	Opcional	Indicador que muestra si este daemon de copias de seguridad tiene configurada la recolección de basura.
`headDiskType`	string	Opcional	Tipo de disco utilizado para almacenar el directorio principal. Los valores aceptados para esta opción son: `HDD` `SSD`
`labels`	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.
`machine`	Objeto	Requerido	Anfitrión de daemon de copias de seguridad y sus directorios principales.
`machine.headRootDirectory`	string	Opcional	Ruta relativa a la raíz del directorio principal en este host del daemon de copias de seguridad. This directory must end with a slash (`/`). (Este directorio debe terminar con una barra diagonal ().) If you omit the slash, the daemon de copias de seguridad generates a Java Exception error.
`machine.machine`	string	Requerido	Nombre de host o dirección IP del host del daemon de copias de seguridad.
`numWorkers`	Número	Opcional	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.
`resourceUsageEnabled`	booleano	Opcional	Indicador que señala si se supervisa el uso de recursos de este daemon de copias de seguridad.
`restoreQueryableJobsEnabled`	booleano	Opcional	Indicador que señala si este daemon de copias de seguridad puede realizar restauraciones consultables.

Respuesta

Nombre	Tipo	Descripción
`assignmentEnabled`	booleano	Indicador que señala si este daemon de copias de seguridad puede recibir asignaciones de tareas de copias de seguridad.
`backupJobsEnabled`	booleano	Indicador que indica si este daemon de copias de seguridad puede utilizarse para respaldar bases de datos.
`configured`	booleano	Indicador que señala si este daemon de copias de seguridad está listo para su uso.
`garbageCollectionEnabled`	booleano	Indicador que muestra si este daemon de copias de seguridad tiene configurada la recolección de basura.
`headDiskType`	string	Tipo de disco utilizado para almacenar el directorio principal. Los valores aceptados para esta opción son: `HDD` `SSD`
`id`	string	Identificador único de este daemon de copias de seguridad.
`labels`	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.
`links`	objeto arreglo	Uno o más enlaces a subrecursos o recursos relacionados. Todos los arreglos `links` en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre las URLse explican en la Especificación de enlace web.
`machine`	Objeto	Anfitrión de daemon de copias de seguridad y sus directorios principales.
`machine.headRootDirectory`	string	Ruta relativa al directorio principal del directorio principal en este daemon de copias de seguridad host.
`machine.machine`	string	Nombre de host o dirección IP del host del daemon de copias de seguridad.
`numWorkers`	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.
`resourceUsageEnabled`	booleano	Indicador que señala si se supervisa el uso de recursos de este daemon de copias de seguridad.
`restoreQueryableJobsEnabled`	booleano	Indicador que señala si este daemon de copias de seguridad puede realizar restauraciones consultables.

Solicitud de ejemplo

1 curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
2      --header 'Accept: application/json' \
3      --header 'Content-Type: application/json' \
4      --include \
5      --request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/daemon/configs/{MACHINE}/?pretty=true' \
6      --data '{
7        "assignmentEnabled" : true,
8        "backupJobsEnabled" : false,
9        "configured" : true,
10        "garbageCollectionEnabled" : true,
11        "headDiskType" : "SSD",
12        "labels" : [ "l1", "l2" ],
13        "machine" : {
14          "headRootDirectory" : "/data/backup/",
15          "machine" : "localhost"
16        },
17        "numWorkers" : 50,
18        "resourceUsageEnabled" : true,
19        "restoreQueryableJobsEnabled" : true
20      }'

Respuesta de ejemplo

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Respuesta del cuerpo

1 {
2   "assignmentEnabled" : true,
3   "backupJobsEnabled" : false,
4   "configured" : true,
5   "garbageCollectionEnabled" : true,
6   "headDiskType" : "SSD",
7   "id" : "{BACKUP-DAEMON-ID}",
8   "labels" : [ "l1", "l2" ],
9   "links" : [ {
10     "href" : "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/daemon/configs/{MACHINE}/<machine.headRootDirectory>",
11     "rel" : "self"
12   }],
13   "machine" : {
14     "headRootDirectory" : "/data/backup/",
15     "machine" : "localhost"
16   },
17   "numWorkers" : 50,
18   "resourceUsageEnabled" : true,
19   "restoreQueryableJobsEnabled" : true
20 }

Volver

Obtener todo

Update

1	curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
2	--header 'Accept: application/json' \
3	--header 'Content-Type: application/json' \
4	--include \
5	--request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/daemon/configs/{MACHINE}/?pretty=true' \
6	--data '{
7	"assignmentEnabled" : true,
8	"backupJobsEnabled" : false,
9	"configured" : true,
10	"garbageCollectionEnabled" : true,
11	"headDiskType" : "SSD",
12	"labels" : [ "l1", "l2" ],
13	"machine" : {
14	"headRootDirectory" : "/data/backup/",
15	"machine" : "localhost"
16	},
17	"numWorkers" : 50,
18	"resourceUsageEnabled" : true,
19	"restoreQueryableJobsEnabled" : true
20	}'