Compute Cloud API, REST: PlacementGroup.get
Returns the specified placement group.
To get the list of all available placement groups, make a list request.
HTTP request
GET https://compute.api.il.nebius.cloud/compute/v1/placementGroups/{placementGroupId}
Path parameters
Parameter | Description |
---|---|
placementGroupId | ID of the placement group to return. To get a placement group ID make a list request. |
Response
HTTP Code: 200 - OK
{
"id": "string",
"folderId": "string",
"createdAt": "string",
"name": "string",
"description": "string",
"labels": "object",
// includes only one of the fields `spreadPlacementStrategy`, `partitionPlacementStrategy`
"spreadPlacementStrategy": {},
"partitionPlacementStrategy": {
"partitions": "string"
},
// end of the list of possible fields
}
Field | Description |
---|---|
id | string ID of the placement group. Generated at creation time. |
folderId | string ID of the folder that the placement group belongs to. |
createdAt | string (date-time) Creation timestamp. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). |
name | string Name of the placement group. The name is unique within the folder. |
description | string Description of the placement group. 0-256 characters long. |
labels | object Placement group labels as |
spreadPlacementStrategy | object Anti-affinity placement strategy ( spread ). Instances are distributed over distinct failure domains. includes only one of the fields spreadPlacementStrategy , partitionPlacementStrategy |
partitionPlacementStrategy | object includes only one of the fields spreadPlacementStrategy , partitionPlacementStrategy |
partitionPlacementStrategy. partitions |
string (int64) Acceptable values are 2 to 5, inclusive. |