bulkSetAgentKeypairPolicy

Add public key pins for server hosts to agents in bulk

This command requests a set of agents to 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.

Format

udclient [global-args...] [global-flags...]
  bulkSetAgentKeypairPolicy [JSON file]

Parameters

None.

Template

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 REST command: Add public key pins for server hosts to agents in bulk.