REST API - add-task

vcenter hlm community: add-task

Adds the target node to the community. By default, the first member of the community id the local node. Usage beyond VMware Cloud on AWS is not supported. 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

POST https://{server}/rest/vcenter/hlm/community?vmw-task=true&action=add

Request Body Structure:

{
    "spec" : {
        "hostname" : "string",
        "port" : "string",
        "ssl_thumbprint" : "string",
        "ssl_verify" : true,
        "token" : "string",
        "admin_groups" : [
            "string",
            "string"
        ]
    }
}

Request Body Parameters:

Name	Type	Description
bold = required
spec	add_spec	Specification for adding a node to the community.
spec.hostname	string	The hostname for the target node. 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.
spec.port	string	The HTTPS port of the target node. 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 443 will be used as default.
spec.token	string	The base64 encoded authentication token usable in the target node's domain and issued by its Security Token Service service. The token should be prefixed with a type. Currently, only saml tokens are supported. For example: "sign=LKJSDLKDJ..." where prefix is "sign=" for a saml token. 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.
spec.ssl_thumbprint	string	The SHA-256 thumbprint of the SSL certificate of the target node. 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. This field is only relevant if `ssl_verify` is set and has the value true.
spec.ssl_verify	boolean	SSL verification should be enabled or disabled. 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, verification will be enabled.
spec.admin_groups	string[]	The list of groups to be added to which administrator access should be granted. Group names should be un UPN format. 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 no groups will have administrator access.

Response:

HTTP Status Code: 200

Representation:

{
"value" : "obj-103"
}

Response Type:

Name	Type	Description
bold = required
value	string

Errors:

HTTP Status Code	Type	Description
400	already_exists	If the local and target machines are already in the same community.
400	invalid_argument	If an argument is not valid.
401	unauthenticated	If unable to authenticate to target node.
403	unauthorized	If the caller is not authorized.
400	unverified_peer	If the SSL certificate of the target node cannot be validated by comparing with the thumbprint provided in vcenter.hlm.community.add_spec.ssl_thumbprint or if vcenter.hlm.community.add_spec.ssl_thumbprint is unset and vcenter.hlm.community.add_spec.ssl_verify is true. The value of the {@link UnverifiedPeer#data) field will be a structure that contains all the fields defined in vcenter.hlm.community.certificate_info.
500	error	If the system reports an error while responding to the request.