Add public key pins for server hosts to agents in bulk

This command requests a set of agents set or modify their keypair policy, but does not wait for or report the results.

Note:
  • 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.
  • If the maximum age of a keypair is changed to be less than its current age, keypair rotation may begin immediately, but the outcome of the returned maintenance tasks does not depend on that.

Request

POST https://{hostname}:{port}
    /cli/agentCLIbulkSetKeypairPolicy
Accept: {contentType}
Content-Type: {contentType}
Table 1. Header parameters
Parameter Type Required Description
Content-Type
  • application/json
  • application/yaml
 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",
    "maxAgeDays": "The maximum age in days of the agent's 
  keypair, or zero to disable rotation"
  }]
}

Related CLI command: bulkSetAgentKeypairPolicy.