Add support for placement groups

Author: rkosegi

src/main/java/cloud/dnation/hetznerclient/GetPlacementGroupByIdResponse.java

@@ -0,0 +1,25 @@
+/*
+ *     Copyright 2022 https://dnation.cloud
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *          http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package cloud.dnation.hetznerclient;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+
+@Data
+public class GetPlacementGroupByIdResponse {
+    @SerializedName("placement_group")
+    private PlacementGroupDetail placementGroup;
+}

src/main/java/cloud/dnation/hetznerclient/GetPlacementGroupsResponse.java

@@ -0,0 +1,30 @@
+/*
+ *     Copyright 2022 https://dnation.cloud
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *          http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package cloud.dnation.hetznerclient;
+
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@EqualsAndHashCode(callSuper = true)
+@Data
+public class GetPlacementGroupsResponse extends AbstractSearchResponse {
+    @SerializedName("placement_groups")
+    private List<PlacementGroupDetail> placementGroups;
+}

src/main/java/cloud/dnation/hetznerclient/HetznerApi.java

@@ -182,6 +182,27 @@ Call<GetServersBySelectorResponse> getServersBySelector(@Query("label_selector")
     @GET("/v1/networks/{id}")
     Call<GetNetworkByIdResponse> getNetworkById(@Path("id") int id);
 
+    /**
+     * Get placement groups, optionally filtered using label expression.
+     *
+     * @param selector Can be used to filter resources by labels.
+     *                 The response will only contain resources matching the label selector.
+     * @return  returns matching placement groups.
+     * see <a href="https://docs.hetzner.cloud/#placement-groups-get-all-placementgroups">API reference</a>
+     */
+    @GET("/v1/placement_groups")
+    Call<GetPlacementGroupsResponse> getPlacementGroups(@Query("label_selector") String selector);
+
+    /**
+     * Get placement group detail based on provided placement group ID.
+     *
+     * @param id placement group ID
+     * @return details of placement group
+     * see <a href="https://docs.hetzner.cloud/#placement-groups-get-a-placementgroup">API reference</a>
+     */
+    @GET("/v1/placement_groups/{id}")
+    Call<GetPlacementGroupByIdResponse> getPlacementGroupById(@Path("id") int id);
+
     /**
      * Get all Primary IP objects.
      *

src/main/java/cloud/dnation/hetznerclient/PlacementGroupDetail.java

@@ -0,0 +1,34 @@
+/*
+ *     Copyright 2022 https://dnation.cloud
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *          http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package cloud.dnation.hetznerclient;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class PlacementGroupDetail extends IdentifiableResource {
+    private String created;
+    private Map<String, String> labels = new HashMap<>();
+    private String name;
+    private List<Integer> servers = new ArrayList<>();
+    private String type = "spread";
+}