NSX-T Data Center REST API

Configure backup

Configure file server and timers for automated backup.
If secret fields are omitted (password, passphrase)
then use the previously set value.

Request:

Method:

PUT

URI Path(s):

/policy/api/v1/cluster/backups/config
/api/v1/cluster/backups/config

Request Headers:

n/a

Query Parameters:

BackupFrameRequestParameters+

BackupFrameRequestParameters (schema)

Name	Description	Type	Notes
frame_type	Frame type This attribute is used to indicate the service on current site or other site for which backup is handled in a frame. LOCAL_LOCAL_MANAGER corresponds to local LM of the site. LOCAL_MANAGER cprresponds to LM of other site.	string	Readonly Enum: GLOBAL_MANAGER, LOCAL_MANAGER, LOCAL_LOCAL_MANAGER, NSX_INTELLIGENCE Default: "LOCAL_LOCAL_MANAGER"
site_id	Site ID Site ID of LM site, which will be supported in a frame	string	Default: "localhost"

Request Body:

BackupConfiguration+

BackupConfiguration (schema)

Name	Description	Type	Notes
after_inventory_update_interval	A number of seconds after a last backup, that needs to pass, before a topology change will trigger a generation of a new cluster/node backups. If parameter is not provided, then changes in a topology will not trigger a generation of cluster/node backups.	integer	Minimum: 300 Maximum: 86400
backup_enabled	true if automated backup is enabled	boolean	Default: "False"
backup_schedule	Set when backups should be taken - on a weekly schedule or at regular intervals.	BackupSchedule (Abstract type: pass one of the following concrete types) IntervalBackupSchedule WeeklyBackupSchedule
inventory_summary_interval	The minimum number of seconds between each upload of the inventory summary to backup server.	integer	Minimum: 30 Maximum: 3600 Default: "240"
passphrase	Passphrase used to encrypt backup files. Passphrase used to encrypt backup files. The passphrase specified must be at least 8 characters in length and must contain at least one lowercase, one uppercase, one numeric character and one special character (any other non-space character).	secure_string
remote_file_server	The server to which backups will be sent.	RemoteFileServer

Example Request:

{ "backup_enabled" : true, "backup_schedule":{ "resource_type": "WeeklyBackupSchedule", "days_of_week":[ 1, 3, 5 ], "hour_of_day":0, "minute_of_day":0 }, "remote_file_server":{ "server":"10.1.2.3", "port":22, "protocol":{ "protocol_name":"sftp", "ssh_fingerprint":"SHA256:w2NgXhG2Nm76q9PL/bXWKkLbDS31uMLYttUe9eajPaA", "authentication_scheme":{ "scheme_name":"PASSWORD", "username":"admin", "password":"default" } }, "directory_path":"/nsx-backups" }, "passphrase":"swordfish", "inventory_summary_interval":300 }| { "backup_enabled" : true, "backup_schedule":{ "resource_type": "IntervalBackupSchedule", "seconds_between_backups":3600 }, "remote_file_server":{ "server":"10.1.2.3", "port":22, "protocol":{ "protocol_name":"sftp", "ssh_fingerprint":"SHA256:w2NgXhG2Nm76q9PL/bXWKkLbDS31uMLYttUe9eajPaA", "authentication_scheme":{ "scheme_name":"KEY", "username":"admin", "identity_file":"-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAQCfJGCSdJx+qKxt\nE4vmwdLYbFjeuYMNqC3YfB+6sWcqkkZc708zlIyl7Z3F4PE3THDWBo6gCCa3vi6E\nL8HRHUcl8HM4iZxUt352MEJkUuUtkn5tMI5phm9r6bZS736w+AsyYawcOpI24253\nuqPWRXv1VzFJBwk+lgBlzEuarcH7krimBfC1pJdyG7KsfPhTiwtgXA7b2Hz6p9Ub\nuozZ9A1OigyR6QbFKJ/Fl0EsmUinRsPFkeiijF3uQuTUPl0lhty+UY99GmmRQ0+v\nH2wKUbyh6+T4vmhBhVrBTqhCfIJrD6ZJin20AYJUxiu9SSdLq7HzMR4LnEe78/0T \nlGG7yP0jAgMBAAECggEAG94+bRcvmnyGKVm9a4zwk8axb1tUKE2Vra3azpIna0yP\nNtIPcAxo7tuj/9Vq2FCyB8DBNCQJR67trWdBjRGP9oRbYQC0GB/D7QV5cuETUf4v\n1oYkwjTxCRg1veNDr9DYARwajBzzotoD68KK00h6sxVwQ4YQZ93Ttv/mE3GvIRMj\nQN1s6VbFe7jUpEzfJO6/Mg4aRKrFEIp/5q7NRT4jwY4UBJlEC0I9zhrs4rnyIjWR\nLpazAmugcMQ4Uj8xaIDg4rb/KfjdiitivW+6AhXd49RLm6GXncXv1hwN6wZ1Punb\nxV8+xwt9BS5gwBuNASokjwOTswj+bxYXTsaxHPfjvQKBgQDMhsssUOhLJrohcGdR\n3dF/jeJZ6a+GMydBhiVdWHAhx1prEcjH65o0jpWefpk3XiJVcTtdhHtU8Qamm0xV\nVxaVd8W9LJZBRmjJ0VAzghBWzq4je3pw6JAIhVYL3bWzR74xVa9NiFXu8ZqLsJjw\nNlEPQ9vZQZwIDUOs1p9as7PUFQKBgQDHMY+8x/YyyYRhLCsqgdynV3Lc2J5Hk9bN \nqo604uhEAJTbHTZ7WwRAT9QNbIBJwx7j5z1m4MEUq0RFe+MDyW+ACxz+oIGrgmMe\nVcNdvlzQHGywo3BC5CvygU1RrSnu1pqeLk9Vo5KXTz3rAr59Icw54rw7BC7b2RqY\nSnmQUCTCVwKBgBjJ0YAagjzxgaeh3vPeJZEHGkL5fquOMZjQcGDi4hxF9CB79FC+ \nrl7mVR3zjBBY2WJvqdlIwEXoPH0e316MgpE1BgNKjx90MCkdtFG51s8el553Tby3\ngxV1S5t+kJIdBOEn2GpWNswR/kAl9DNQ8fweplurhwS2ztf43zF4DDiNAoGARpo1\nhUcm53dv2XVrU2S2DgY76zVIXLx07W7fqBOpGblPCZ8AGZb4GcdxtNRZYEutnj/v \nDpDpPuc5iptPqp7yS2MlAsdnTqAne7AQUCDSCt2YVL+JYdw4C3tzKVkEPOiJ4zks\n24Dfy4vFuY++buHU3kuURiLEbR41g/cZwWH2tX8CgYAaXJvi9UkNlYfcIzsTqnkC\nmEJt1keFgoD6U0VK2SWL65EL24s5bC81cVtQo6cuVRiAbKKyvcI0/qwnDqIRa9/J\nuakA4piJcmbae9qSNRdloIYdYKT4k7DRHoh45eB7ZKdCu76gUUllOAdr8DGF6xBr\nzHPHeBNiX4ORwTewAEf+VA==\n-----END PRIVATE KEY-----" } }, "directory_path":"/nsx-backups" }, "passphrase":"swordfish", "inventory_summary_interval":300 }| { "backup_enabled" : true, "backup_schedule":{ "resource_type": "IntervalBackupSchedule", "seconds_between_backups":3600 }, "remote_file_server":{ "server":"10.1.2.3", "port":22, "protocol":{ "protocol_name":"sftp", "ssh_fingerprint":"SHA256:w2NgXhG2Nm76q9PL/bXWKkLbDS31uMLYttUe9eajPaA", "authentication_scheme":{ "scheme_name":"KEY", "username":"admin", "identity_file":"-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkqhkiG9w0BAQEFAASCBKYwggSiAgEAQCfJGCSdJx+qKxt\nE4vmwdLYbFjeuYMNqC3YfB+6sWcqkkZc708zlIyl7Z3F4PE3THDWBo6gCCa3vi6E\nL8HRHUcl8HM4iZxUt352MEJkUuUtkn5tMI5phm9r6bZS736w+AsyYawcOpI24253\nuqPWRXv1VzFJBwk+lgBlzEuarcH7krimBfC1pJdyG7KsfPhTiwtgXA7b2Hz6p9Ub\nuozZ9A1OigyR6QbFKJ/Fl0EsmUinRsPFkeiijF3uQuTUPl0lhty+UY99GmmRQ0+v\nH2wKUbyh6+T4vmhBhVrBTqhCfIJrD6ZJin20AYJUxiu9SSdLq7HzMR4LnEe78/0T \nlGG7yP0jAgMBAAECggEAG94+bRcvmnyGKVm9a4zwk8axb1tUKE2Vra3azpIna0yP\nNtIPcAxo7tuj/9Vq2FCyB8DBNCQJR67trWdBjRGP9oRbYQC0GB/D7QV5cuETUf4v\n1oYkwjTxCRg1veNDr9DYARwajBzzotoD68KK00h6sxVwQ4YQZ93Ttv/mE3GvIRMj\nQN1s6VbFe7jUpEzfJO6/Mg4aRKrFEIp/5q7NRT4jwY4UBJlEC0I9zhrs4rnyIjWR\nLpazAmugcMQ4Uj8xaIDg4rb/KfjdiitivW+6AhXd49RLm6GXncXv1hwN6wZ1Punb\nxV8+xwt9BS5gwBuNASokjwOTswj+bxYXTsaxHPfjvQKBgQDMhsssUOhLJrohcGdR\n3dF/jeJZ6a+GMydBhiVdWHAhx1prEcjH65o0jpWefpk3XiJVcTtdhHtU8Qamm0xV\nVxaVd8W9LJZBRmjJ0VAzghBWzq4je3pw6JAIhVYL3bWzR74xVa9NiFXu8ZqLsJjw\nNlEPQ9vZQZwIDUOs1p9as7PUFQKBgQDHMY+8x/YyyYRhLCsqgdynV3Lc2J5Hk9bN \nqo604uhEAJTbHTZ7WwRAT9QNbIBJwx7j5z1m4MEUq0RFe+MDyW+ACxz+oIGrgmMe\nVcNdvlzQHGywo3BC5CvygU1RrSnu1pqeLk9Vo5KXTz3rAr59Icw54rw7BC7b2RqY\nSnmQUCTCVwKBgBjJ0YAagjzxgaeh3vPeJZEHGkL5fquOMZjQcGDi4hxF9CB79FC+ \nrl7mVR3zjBBY2WJvqdlIwEXoPH0e316MgpE1BgNKjx90MCkdtFG51s8el553Tby3\ngxV1S5t+kJIdBOEn2GpWNswR/kAl9DNQ8fweplurhwS2ztf43zF4DDiNAoGARpo1\nhUcm53dv2XVrU2S2DgY76zVIXLx07W7fqBOpGblPCZ8AGZb4GcdxtNRZYEutnj/v \nDpDpPuc5iptPqp7yS2MlAsdnTqAne7AQUCDSCt2YVL+JYdw4C3tzKVkEPOiJ4zks\n24Dfy4vFuY++buHU3kuURiLEbR41g/cZwWH2tX8CgYAaXJvi9UkNlYfcIzsTqnkC\nmEJt1keFgoD6U0VK2SWL65EL24s5bC81cVtQo6cuVRiAbKKyvcI0/qwnDqIRa9/J\nuakA4piJcmbae9qSNRdloIYdYKT4k7DRHoh45eB7ZKdCu76gUUllOAdr8DGF6xBr\nzHPHeBNiX4ORwTewAEf+VA==\n-----END PRIVATE KEY-----" } }, "directory_path":"/nsx-backups" }, "passphrase":"swordfish", "inventory_summary_interval":300 }

Successful Response:

Response Code:

200 OK

Response Headers:

Content-type: application/json

Response Body:

BackupConfiguration+

BackupConfiguration (schema)

Name	Description	Type	Notes
after_inventory_update_interval	A number of seconds after a last backup, that needs to pass, before a topology change will trigger a generation of a new cluster/node backups. If parameter is not provided, then changes in a topology will not trigger a generation of cluster/node backups.	integer	Minimum: 300 Maximum: 86400
backup_enabled	true if automated backup is enabled	boolean	Default: "False"
backup_schedule	Set when backups should be taken - on a weekly schedule or at regular intervals.	BackupSchedule (Abstract type: pass one of the following concrete types) IntervalBackupSchedule WeeklyBackupSchedule
inventory_summary_interval	The minimum number of seconds between each upload of the inventory summary to backup server.	integer	Minimum: 30 Maximum: 3600 Default: "240"
passphrase	Passphrase used to encrypt backup files. Passphrase used to encrypt backup files. The passphrase specified must be at least 8 characters in length and must contain at least one lowercase, one uppercase, one numeric character and one special character (any other non-space character).	secure_string
remote_file_server	The server to which backups will be sent.	RemoteFileServer

Required Permissions:

crud

Feature:

utilities_backup

Additional Errors:

• 301 Moved Permanently
• 307 Temporary Redirect
• 400 Bad Request
• 403 Forbidden
• 409 Conflict
• 412 Precondition Failed
• 500 Internal Server Error
• 503 Service Unavailable