Method Detail

• add

  @Named(value="node:add")
  @POST
  @Consumes(value="application/json")
  @Path(value="/nodes")
  Set<Node> add(Iterable<AddNode> addNodes)

  Add a new node with the configuration defined by the request.

• update

  @Named(value="node:update")
  @PUT
  @Consumes(value="application/json")
  @Path(value="/nodes/{id}")
  void update(@PathParam(value="id")
                                    int id,
                                    UpdateNode updateNode)

  Update the attributes of a node.

• list

  @Named(value="node:list")
  @GET
  @Consumes(value="application/json")
  @Path(value="/nodes")
  PagedIterable<Node> list()

  List the nodes.

• list

  @Named(value="node:list")
  @GET
  @Consumes(value="application/json")
  @Path(value="/nodes")
  IterableWithMarker<Node> list(PaginationOptions options)

  List the nodes with full control of pagination.

• get

  @Named(value="node:get")
  @GET
  @Consumes(value="application/json")
  @Path(value="/nodes/{id}")
  Node get(@PathParam(value="id")
                                 int id)

  Get a node.

• remove

  @Named(value="node:remove")
  @DELETE
  @Path(value="/nodes/{id}")
  @Consumes(value="*/*")
  void remove(@PathParam(value="id")
                                       int id)

  Remove a node from the load balancer.

• remove

  @Named(value="node:remove")
  @DELETE
  @Path(value="/nodes")
  @Consumes(value="*/*")
  void remove(@QueryParam(value="id")
                                       Iterable<Integer> ids)

  Batch remove nodes from the load balancer.

• createMetadata

  @Named(value="node:createmetadata")
  @POST
  @Consumes(value="application/json")
  @Path(value="/nodes/{id}/metadata")
  Metadata createMetadata(@PathParam(value="id")
                                                 int id,
                                                 Map<String,String> metadata)

  When a metadata item is added, it is assigned a unique identifier that can be used for mutating operations such as changing the value attribute or removing it. Key and value must be 256 characters or less. All UTF-8 characters are valid.

• getMetadata

  @Named(value="node:getmetadata")
  @GET
  @Consumes(value="application/json")
  @Path(value="/nodes/{id}/metadata")
  Metadata getMetadata(@PathParam(value="id")
                                             int lb)

  List a load balancer's metadata.

• updateMetadatum

  @Named(value="node:updatemetadatum")
  @PUT
  @Produces(value="application/json")
  @Consumes(value="*/*")
  @Path(value="/nodes/{id}/metadata/{metadatumId}")
  boolean updateMetadatum(@PathParam(value="id")
                                                         int id,
                                                         @PathParam(value="metadatumId")
                                                         int metadatumId,
                                                         String value)

  Update metadatum. Key and value must be 256 characters or less. All UTF-8 characters are valid.

  Returns:

  true on a successful update, false if the metadatum was not found

• deleteMetadatum

  @Named(value="node:deletemetadatum")
  @DELETE
  @Consumes(value="*/*")
  @Path(value="/nodes/{id}/metadata/{metadatumId}")
  boolean deleteMetadatum(@PathParam(value="id")
                                                   int id,
                                                   @PathParam(value="metadatumId")
                                                   int metadatumId)

  Delete metadatum.

  Returns:

  true on a successful removal, false if the metadatum was not found

  See Also:

  deleteMetadata(int, Iterable)

• deleteMetadata

  @Named(value="node:deletemetadata")
  @DELETE
  @Consumes(value="*/*")
  @Path(value="/nodes/{id}/metadata")
  boolean deleteMetadata(@PathParam(value="id")
                                                  int id,
                                                  @QueryParam(value="id")
                                                  Iterable<Integer> metadataIds)

  Batch delete metadata given the specified ids. The current default limit is ten ids per request. Any and all configuration data is immediately purged and is not recoverable. If one or more of the items in the list cannot be removed due to its current status, an exception is thrown along with the ids of the ones the system identified as potential failures for this request.

  Returns:

  true on a successful removal, false if the metadata was not found