Add public key pins for server hosts to an agents in bulk

This command requests a set of agent add a public key pin for a server host, but does not wait for or report the results. The returned maintenance tasks can be used to query the result. Individual sub-requests may succeed or fail independently. A single request may contain up to 250 sub-requests.

Request

POST https://{hostname}:{port}
    /cli/agentCLI/bulkAddServerPin
Accept: {contentType}
Content-Type: application/json
Table 1. Header parameters
Parameter Type Required Description
Content-Type application/json true
Accept
  • application/json
  • application/yaml
true
This command takes a JSON request string or file. Use the following template for the request:
{
  "README": "See entity attribute for the template 
  description expected by this endpoint.",
  "entity": [{
    "agent": "Name or ID of an agent",
    "alias": "A keypair alias in the server keystore file 
  that holds the target public key",
    "allowUnknownHost": "If true, allow setting a pin for 
  a host not currently known to the agent (optional)",
    "host": "The host name, as it is known by the agent, 
  that will receive the public key pin"
  }]
}

Related CLI command: bulkAddAgentServerPin.