Compute Cloud API, REST: DiskPlacementGroup.get
Returns the specified placement group.
HTTP request
GET https://compute.api.il.nebius.cloud/compute/v1/diskPlacementGroups/{diskPlacementGroupId}
Path parameters
| Parameter | Description |
|---|---|
| diskPlacementGroupId | Required. ID of the placement group to return. To get the placement group ID, use list request. The maximum string length in characters is 50. |
Response
HTTP Code: 200 - OK
{
"id": "string",
"folderId": "string",
"createdAt": "string",
"name": "string",
"description": "string",
"labels": "object",
"zoneId": "string",
"status": "string",
// 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. |
| folderId | string ID of the folder that the placement group belongs to. |
| createdAt | string (date-time) Creation timestamp in RFC3339 text format. 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. |
| labels | object Resource labels as |
| zoneId | string ID of the availability zone where the placement group resides. |
| status | string Current status of the placement group |
| spreadPlacementStrategy | object Distribute disks over distinct failure domains. includes only one of the fields spreadPlacementStrategy, partitionPlacementStrategy |
| partitionPlacementStrategy | object Distribute disks over partitions. includes only one of the fields spreadPlacementStrategy, partitionPlacementStrategy |
| partitionPlacementStrategy. partitions |
string (int64) |