REST API - set
  1. Operations
  2. appliance
  3. vcenter
  4. settings
  5. v1
  6. config

appliance vcenter settings v1 config: set

Updates the configuration of the currently created profile. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Request:

HTTP request

PUT https://{server}/api/appliance/vcenter/settings/v1/config
{
    "name" : "string",
    "description" : "string",
    "desired_state" : {
        "authmgmt" : {
            "global_permission_list" : [
                {
                    "principal" : {
                        "name" : "string",
                        "group" : true
                    },
                    "propagate" : true,
                    "role_ids" : [
                        1,
                        1
                    ]
                },
                {
                    "principal" : {
                        "name" : "string",
                        "group" : true
                    },
                    "propagate" : true,
                    "role_ids" : [
                        1,
                        1
                    ]
                }
            ],
            "token_policy" : {
                "clock_tolerance" : 1,
                "token_delegation" : 1,
                "token_renewal" : 1,
                "bearer_refresh" : 1,
                "hok_refresh" : 1
            },
            "lockout_policy" : {
                "failed_login_attempts" : 1,
                "failure_interval" : 1,
                "unlock_time" : 1
            },
            "password_policy" : {
                "uppercase_chars" : 1,
                "min_length" : 1,
                "alpha_chars" : 1,
                "max_life" : 1,
                "special_chars" : 1,
                "lowercase_chars" : 1,
                "numeric_chars" : 1,
                "adj_identical_chars" : 1,
                "password_reuse" : 1,
                "max_length" : 1
            },
            "role_list" : [
                {
                    "privilege_id" : [
                        "string",
                        "string"
                    ],
                    "name" : "string",
                    "description" : "string",
                    "id" : 1
                },
                {
                    "privilege_id" : [
                        "string",
                        "string"
                    ],
                    "name" : "string",
                    "description" : "string",
                    "id" : 1
                }
            ],
            "privileges_list" : [
                {
                    "is_on_parent" : true,
                    "description" : "string",
                    "id" : "string",
                    "group" : "string"
                },
                {
                    "is_on_parent" : true,
                    "description" : "string",
                    "id" : "string",
                    "group" : "string"
                }
            ]
        },
        "appliance" : {
            "software_update_policy" : {
                "password" : "secret string",
                "auto_stage" : "DISABLED",
                "certificate_check" : true,
                "default_URL" : "string",
                "check_schedule" : {
                    "hour" : "string",
                    "day" : "MONDAY",
                    "minute" : "string"
                },
                "custom_URL" : "string",
                "username" : "string"
            },
            "time_sync" : {
                "mode" : "DISABLED"
            },
            "smtp" : {
                "relay_port" : "string",
                "mail_server" : "string"
            },
            "ssh" : {
                "enabled" : true
            },
            "local_accounts_policy" : {
                "warn_days" : 1,
                "max_days" : 1,
                "min_days" : 1
            },
            "console_cli" : {
                "enabled" : true
            },
            "ntp" : {
                "servers" : [
                    "string",
                    "string"
                ]
            },
            "syslog" : [
                {
                    "hostname" : "string",
                    "protocol" : "TLS",
                    "port" : 1
                },
                {
                    "hostname" : "string",
                    "protocol" : "TLS",
                    "port" : 1
                }
            ],
            "time_zone" : {
                "name" : "string"
            },
            "network" : {
                "dns_server_configuration" : {
                    "mode" : "DHCP",
                    "servers" : [
                        "string",
                        "string"
                    ]
                },
                "firewall_rule_policies" : [
                    {
                        "address" : "string",
                        "prefix" : 1,
                        "interface_name" : "string",
                        "policy" : "IGNORE"
                    },
                    {
                        "address" : "string",
                        "prefix" : 1,
                        "interface_name" : "string",
                        "policy" : "IGNORE"
                    }
                ],
                "proxy_configuration" : [
                    {
                        "server" : "string",
                        "protocol" : "HTTP",
                        "password" : "secret string",
                        "port" : 1,
                        "enabled" : true,
                        "username" : "string"
                    },
                    {
                        "server" : "string",
                        "protocol" : "HTTP",
                        "password" : "secret string",
                        "port" : 1,
                        "enabled" : true,
                        "username" : "string"
                    }
                ]
            },
            "backup_schedules" : [
                {
                    "recurrence_info" : {
                        "hour" : 1,
                        "days" : [
                            "MONDAY",
                            "MONDAY"
                        ],
                        "minute" : 1
                    },
                    "backup_password" : "secret string",
                    "enable" : true,
                    "parts" : [
                        "string",
                        "string"
                    ],
                    "location" : "http://myurl.com",
                    "location_password" : "secret string",
                    "schedule_id" : "string",
                    "location_user" : "string",
                    "retention_info" : {
                        "max_count" : 1
                    }
                },
                {
                    "recurrence_info" : {
                        "hour" : 1,
                        "days" : [
                            "MONDAY",
                            "MONDAY"
                        ],
                        "minute" : 1
                    },
                    "backup_password" : "secret string",
                    "enable" : true,
                    "parts" : [
                        "string",
                        "string"
                    ],
                    "location" : "http://myurl.com",
                    "location_password" : "secret string",
                    "schedule_id" : "string",
                    "location_user" : "string",
                    "retention_info" : {
                        "max_count" : 1
                    }
                }
            ],
            "shell" : {
                "enabled" : true,
                "timeout" : 1
            },
            "root_local_account" : {
                "warn_days_before_password_expiration" : 1,
                "password" : "secret string",
                "min_days_between_password_change" : 1,
                "roles" : [
                    "string",
                    "string"
                ],
                "password_expires_at" : "2015-01-01T22:13:05.651Z",
                "fullname" : "string",
                "last_password_change" : "2015-01-01T22:13:05.651Z",
                "enabled" : true,
                "email" : "string",
                "has_password" : true,
                "max_days_between_password_change" : 1
            },
            "dcui" : {
                "enabled" : true
            }
        }
    }
}

Body Parameters:

Name Type Description
bold = required
- set_spec Specification to update the desired state.
-.name string Name of the profile. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional.

-.description string Description of the profile. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Optional. If unset, the description will be empty.
-.desired_state desired_state Defines the desired state. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
-.desired_state.appliance appliance_management Appliance Management component desired spec. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Optional.

-.desired_state.appliance.software_update_policy software_update_policy Policy to update vCenter.

Optional. Only set if the SoftwareUpdatePolicy is set inside vCenter.
-.desired_state.appliance.software_update_policy.custom_URL string Current appliance update repository URL. Enter "default" to reset the url to the default url.

Optional. Only set if custom URL required.

-.desired_state.appliance.software_update_policy.default_URL string Default appliance update repository URL.

Optional. Only set if default URL required.

-.desired_state.appliance.software_update_policy.auto_stage string Check for update at the pre-configured repository URL.

Defines state for automatic update notification. auto_update_notification enumerated type Value is one of:
DISABLED: Automatic update notification is disabled. Disable periodically query the configured url for updates.
ENABLED: Automatic update notification is enabled. Enable periodically query the configured url for updates.Only set if auto stage is enable.
-.desired_state.appliance.software_update_policy.check_schedule time The time structure defines day and time the automatic check for new updates will be run.

Optional. Only set if Time required.
-.desired_state.appliance.software_update_policy.check_schedule.hour string Time to query for updates Format: HH:MM:SS Military (24 hour) Time Format

Optional. Only set if hour is present in SoftwareUpdatePolicy.

-.desired_state.appliance.software_update_policy.check_schedule.minute string Time to query for updates Format: HH:MM:SS Military (24 hour) Time Format

Optional. Only set if minute is present in SoftwareUpdatePolicy.

-.desired_state.appliance.software_update_policy.check_schedule.day string Day to query for updates

Optional. Only set if minute is present in SoftwareUpdatePolicy.

-.desired_state.appliance.software_update_policy.username string Username for the url update repository

Optional. Only set if SoftwareUpdatePolicy requires username.
-.desired_state.appliance.software_update_policy.password secret Password for the url update repository

Optional. Only set if SoftwareUpdatePolicy requires password.
-.desired_state.appliance.software_update_policy.certificate_check boolean Indicates whether certificates will be checked during patching.

Warning: If this field is set to false, an insecure connection is made to the update repository which can potentially put the appliance security at risk.
-.desired_state.appliance.backup_schedules backup_schedule[] Backup schedule of vCenter.

Optional. Only set if the Backup is schedule for vCenter.

-.desired_state.appliance.backup_schedules[].parts string[] List of optional parts to be backed up. Use the list operation to get information about the supported parts.

Optional. If unset all the optional parts will not be backed up.
-.desired_state.appliance.backup_schedules[].backup_password secret Password for a backup piece. The backupPassword must adhere to the following password requirements: At least 8 characters, cannot be more than 20 characters in length. At least 1 uppercase letter. At least 1 lowercase letter. At least 1 numeric digit. At least 1 special character (i.e. any character not in [0-9,a-z,A-Z]). Only visible ASCII characters (for example, no space).

Optional. If unset the backup piece will not be encrypted.
-.desired_state.appliance.backup_schedules[].location URI URL of the backup location.

Only set if URL is set in BackupSchedule.

-.desired_state.appliance.backup_schedules[].location_user string Username for the given location.

Optional. If unset authentication will not be used for the specified location.
-.desired_state.appliance.backup_schedules[].location_password secret Password for the given location.

Optional. If unset authentication will not be used for the specified location.
-.desired_state.appliance.backup_schedules[].enable boolean Enable or disable a schedule.

Optional. If unset the schedule will be enabled.
-.desired_state.appliance.backup_schedules[].recurrence_info recurrence_info Recurrence information for the schedule.

Optional. If unset backup job will not be scheduled. See appliance.vcenter.settings.v1.config.components.applmgmt.recurrence_info.

-.desired_state.appliance.backup_schedules[].recurrence_info.minute long Minute when backup should run.

Only set if minute is present in Recurrence Info of backup schedule.
-.desired_state.appliance.backup_schedules[].recurrence_info.hour long Hour when backup should run. The hour should be specified in 24-hour clock format.

Only set if hour is present in Recurrence Info of backup schedule.
-.desired_state.appliance.backup_schedules[].recurrence_info.days string[] Day of week when the backup should be run. Days can be specified as list of days.

Optional. If unset the backup will be run everyday.
-.desired_state.appliance.backup_schedules[].retention_info retention_info Retention information for the schedule.

Optional. If unset all the completed backup jobs will be retained forever. See appliance.vcenter.settings.v1.config.components.applmgmt.retention_info.

-.desired_state.appliance.backup_schedules[].retention_info.max_count long Number of backups which should be retained. If retention is not set, all the backups will be retained forever.
-.desired_state.appliance.backup_schedules[].schedule_id string Identifier of the schedule.
-.desired_state.appliance.ssh ssh Get/Set enabled state of SSH-based controlled CLI. ssh service provides operations
-.desired_state.appliance.ssh.enabled boolean Set enabled state of the SSH-based controlled CLI.
-.desired_state.appliance.dcui dcui Get/Set enabled of Direct Console User Interface (DCUI TTY2). dcui service provides operations
-.desired_state.appliance.dcui.enabled boolean Set enabled state of Direct Console User Interface (DCUI).
-.desired_state.appliance.console_cli consolecli Get/Set enabled state of the console-based controlled CLI. consolecli service provides operations
-.desired_state.appliance.console_cli.enabled boolean Set enabled state of the console-based controlled CLI (TTY1).
-.desired_state.appliance.shell shell Get/Set enabled state of BASH. shell service provides operations
-.desired_state.appliance.shell.enabled boolean Enabled can be set to true or false
-.desired_state.appliance.shell.timeout long The timeout (in seconds) specifies how long you enable the Shell access. The maximum timeout is 86400 seconds(1 day).
-.desired_state.appliance.time_zone timezone The timezone service provides operations to get and set the appliance timezone.

Optional. Only set if the Timezone is set in vCenter.

-.desired_state.appliance.time_zone.name string Set time zone.

Optional.

-.desired_state.appliance.time_sync timesync timesync service provides operations Performs time synchronization configuration.

Optional. Only set if the time sync mode is set in vCenter.

-.desired_state.appliance.time_sync.mode string Defines time synchronization modes Value is one of:
DISABLED: Time synchronization is disabled.
NTP: NTP-based time synchronization.
HOST: VMware Tool-based time synchronization.
-.desired_state.appliance.ntp ntp ntp service provides operations Gets NTP configuration status and tests connection to ntp servers.

Optional. Only set if the ntp server are set in vCenter.
-.desired_state.appliance.ntp.servers string[] Set NTP servers. This variable updates old NTP servers from configuration and sets the input NTP servers in the configuration.
-.desired_state.appliance.syslog log_forwarding[] The syslog service provides operations to manage forwarding of log messages to remote logging servers.

Optional. Only set if log forwarding to remote server are set in vCenter.
-.desired_state.appliance.local_accounts_policy local_accounts_policy The localAccountsPolicy service provides operations to manage local user accounts.

Optional. Only set if Password Policy is set to manage local user accounts.
-.desired_state.appliance.local_accounts_policy.max_days long Maximum number of days a password may be used. If the password is older than this, a password change will be forced.

Optional. If unset then the restriction will be ignored.
-.desired_state.appliance.local_accounts_policy.min_days long Minimum number of days allowed between password changes. Any password changes attempted sooner than this will be rejected.

Optional. If unset then the restriction will be ignored.
-.desired_state.appliance.local_accounts_policy.warn_days long Number of days warning given before a password expires. A zero means warning is given only upon the day of expiration.

Optional. If unset then no warning will be provided.
-.desired_state.appliance.root_local_account local_accounts The local_accounts service provides operations to manage local user account.

Optional.

-.desired_state.appliance.root_local_account.fullname string Full name of the user

Optional. If unset, the value was never set.
-.desired_state.appliance.root_local_account.roles string[] User roles

Optional.

-.desired_state.appliance.root_local_account.enabled boolean Flag indicating if the account is enabled
-.desired_state.appliance.root_local_account.has_password boolean Is the user password set.
-.desired_state.appliance.root_local_account.last_password_change date_time Date and time password was changed.

Optional. If unset, the password was never set.
-.desired_state.appliance.root_local_account.password_expires_at date_time Date when the account's password will expire

Optional. If unset, the password never expires.
-.desired_state.appliance.root_local_account.min_days_between_password_change long Minimum number of days between password change

Optional. If unset, pasword can be changed any time.
-.desired_state.appliance.root_local_account.max_days_between_password_change long Maximum number of days between password change

Optional. If unset, password never expires.
-.desired_state.appliance.root_local_account.warn_days_before_password_expiration long Number of days of warning before password expires

Optional. If unset, a user is never warned.
-.desired_state.appliance.root_local_account.password secret Password

Optional. If unset, value will not be changed.

-.desired_state.appliance.root_local_account.email string Email address of the local account

Optional. If unset, value will not be changed.

-.desired_state.appliance.smtp smtp The local_accounts service provides operations to manage local user account.

Optional.

-.desired_state.appliance.smtp.mail_server string Mail server IP address.

Optional. If unset then the value will be ignored.
-.desired_state.appliance.smtp.relay_port string Relay port number.

Optional. If unset then the value will be ignored.
-.desired_state.appliance.network appliance_network Network configurations to be applied.

Optional. Only set if the network configurations are set in vCenter.
-.desired_state.appliance.network.firewall_rule_policies firewall_rule_policy[] List of Firewall Rules to be applied.

Optional. Only set if the FirewallRulePolicy is set in vCenter.
-.desired_state.appliance.network.dns_server_configuration dns_server_configuration DNS configuration to be applied.

Optional. Only set if the DnsServerConfiguration is set in vCenter.
-.desired_state.appliance.network.dns_server_configuration.mode string Define how to determine the DNS servers. Leave the servers argument empty if the mode argument is "DHCP". Set the servers argument to a comma-separated list of DNS servers if the mode argument is "static". The DNS server are assigned from the specified list.

Describes DNS Server source (DHCP,static). Value is one of:
DHCP: DNS address is automatically assigned by a DHCP server.
STATIC: DNS address is static.
-.desired_state.appliance.network.dns_server_configuration.servers string[] List of the currently used DNS servers. DNS server configuration.
-.desired_state.appliance.network.proxy_configuration proxy_configuration[] Proxy configuration to be applied.

Optional. Only set if the Proxy server configuration is set in vCenter.
-.desired_state.authmgmt authentication_management Authentication Management component desired spec. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Optional.

-.desired_state.authmgmt.privileges_list privileges[] List of Privileges.
-.desired_state.authmgmt.global_permission_list global_permission[] List of Global Permission.
-.desired_state.authmgmt.role_list roles[] List of Roles.
-.desired_state.authmgmt.password_policy password_policy Password Policy.

Optional.

-.desired_state.authmgmt.password_policy.special_chars long Minimum special characters.
-.desired_state.authmgmt.password_policy.alpha_chars long Minimum alphabetic characters.
-.desired_state.authmgmt.password_policy.uppercase_chars long Minimum uppercase characters.
-.desired_state.authmgmt.password_policy.lowercase_chars long Minimum lowercase characters.
-.desired_state.authmgmt.password_policy.numeric_chars long Minimum numeric characters.
-.desired_state.authmgmt.password_policy.adj_identical_chars long Maximum adjacent identical characters.
-.desired_state.authmgmt.password_policy.password_reuse long Previous password reuse restriction.
-.desired_state.authmgmt.password_policy.max_life long Maximum lifetime.
-.desired_state.authmgmt.password_policy.max_length long Maximum length.
-.desired_state.authmgmt.password_policy.min_length long Minimum length.
-.desired_state.authmgmt.token_policy token_policy Token Policy.

Optional.

-.desired_state.authmgmt.token_policy.clock_tolerance long Clock tolerance ms.
-.desired_state.authmgmt.token_policy.token_renewal long Maximum token renewal count.
-.desired_state.authmgmt.token_policy.token_delegation long Maximum token delegation count.
-.desired_state.authmgmt.token_policy.bearer_refresh long Maximum Bearer RefreshToken lifetime.
-.desired_state.authmgmt.token_policy.hok_refresh long Maximum HoK RefreshToken lifetime.
-.desired_state.authmgmt.lockout_policy lockout_policy Lockout Policy.

Optional.

-.desired_state.authmgmt.lockout_policy.failed_login_attempts long Maximum number of failed login attempts.
-.desired_state.authmgmt.lockout_policy.failure_interval long Time interval between failures.
-.desired_state.authmgmt.lockout_policy.unlock_time long Unlock time.

Response:

HTTP Status Code: 204

Headers:

None

Type:

None

Errors:

HTTP Status Code Type Description
500 error If there is some unknown internal error. The accompanying error message will give more details aboutthe failure.
400 invalid_argument if any of the specified parameters are invalid.
404 not_found If there is no profile associated with the parameter profile in the system.
400 not_allowed_in_current_state If there is another operation in progress.
503 service_unavailable If the service is not available.
401 unauthenticated if the caller is not authenticated.