Compute Cloud API, gRPC: ReservedInstancePoolService.Create

Статья создана

Обновлена 1 июня 2026 г.

gRPC request
CreateReservedInstancePoolRequest
ResourcesSpec
GpuSettings
BootDiskSpec
ProductIDs
NetworkSettings
operation.Operation

Creates an reserved instance pool in the specified folder.
Method starts an asynchronous operation that can be cancelled while it is in progress.

gRPC request

rpc Create (CreateReservedInstancePoolRequest) returns (operation.Operation)

CreateReservedInstancePoolRequest

{
  "name": "string",
  "description": "string",
  "labels": "map<string, string>",
  "zone_id": "string",
  "folder_id": "string",
  "platform_id": "string",
  "resources_spec": {
    "memory": "int64",
    "cores": "int64",
    "core_fraction": "int64",
    "gpus": "int64"
  },
  "gpu_settings": {
    "gpu_cluster_id": "string"
  },
  "boot_disk_spec": {
    // Includes only one of the fields `disk_id`, `image_id`, `snapshot_id`, `product_ids`
    "disk_id": "string",
    "image_id": "string",
    "snapshot_id": "string",
    "product_ids": {
      "product_ids": [
        "string"
      ]
    }
    // end of the list of possible fields
  },
  "network_settings": {
    "type": "Type"
  },
  "size": "int64",
  "allow_oversubscription": "bool"
}

Field	Description
name	string Name of the reserved instance pool. The value must match the regular expression: `\|[a-z]([-_a-z0-9]{0,61}[a-z0-9])?`.
description	string Description of the reserved instance pool. The length must be less than or equal to 256.
labels	object (map<string, string>) Resource labels as `key:value` pairs. Each map key must match the regular expression: `[a-z][-_./\\@0-9a-z]`. Each map value must match the regular expression: `[-_./\\@0-9a-z]`. The length of each map key must be between 1 and 63. The length of each map value must be less than or equal to 63. The number of elements must be less than or equal to 64.
zone_id	string ID of the availability zone where the reserved instance pool resides. To get a list of available zones, use the yandex.cloud.compute.v1.ZoneService.List request The length must be less than or equal to 50. This field is required.
folder_id	string ID of the folder to create the reserved instance pool in. To get the folder ID, use a yandex.cloud.resourcemanager.v1.FolderService.List request. The length must be less than or equal to 50. This field is required.
platform_id	string ID of the hardware platform configuration for the reserved instance pool. This field affects the available values in `resources_spec` field. For more information, see Platforms. This field is required.
resources_spec	ResourcesSpec Computing resources of the reserved instance pool instances, such as the amount of memory and number of cores. To get a list of available values, see Levels of core performance. This field is required.
gpu_settings	GpuSettings GPU settings.
boot_disk_spec	BootDiskSpec Spec is used to determine which License IDs should be allowed for instances created in the pool.
network_settings	NetworkSettings Network settings.
size	int64 Desired size of the pool (number of slots for instances in this pool). The value must be between 0 and 1048576.
allow_oversubscription	bool Allows the pool to contain more linked instances than the number of available slots (size without pending or unavailable slots). While running instances are still limited by available slots, stopped instances can exceed this limit. Warning: When this option is enabled, attempting to start more instances than the number of available slots will result in a "Not Enough Resources" error.

ResourcesSpec

Field	Description
memory	int64 The amount of memory available to the instance, specified in bytes. The value must be less than or equal to 274877906944. This field is required.
cores	int64 The number of cores available to the instance. The value must satisfy: 2,4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,40,44,48,52,56,60,64,68,72,76,80. This field is required.
core_fraction	int64 Baseline level of CPU performance with the ability to burst performance above that baseline level. This field sets baseline performance for each core. For example, if you need only 5% of the CPU performance, you can set core_fraction=5. For more information, see Levels of core performance. The value must satisfy: 0,5,20,50,100.
gpus	int64 The number of GPUs available to the instance. The value must satisfy: 0,1,2,4.

GpuSettings

Field

Description

gpu_cluster_id

string

Attach instance to specified GPU cluster.

BootDiskSpec

Specification used to determine required product_ids
You can specify product ids explicitly or use disk_id|image_id|snapshot_id to infer products ids from them.

Field	Description
disk_id	string Disk ID. Includes only one of the fields `disk_id`, `image_id`, `snapshot_id`, `product_ids`. Only one field must by specified.
image_id	string Image ID. Includes only one of the fields `disk_id`, `image_id`, `snapshot_id`, `product_ids`. Only one field must by specified.
snapshot_id	string Snapshot ID. Includes only one of the fields `disk_id`, `image_id`, `snapshot_id`, `product_ids`. Only one field must by specified.
product_ids	ProductIDs Product IDs. Includes only one of the fields `disk_id`, `image_id`, `snapshot_id`, `product_ids`. Only one field must by specified.

ProductIDs

Field

Description

product_ids[]

string

License IDs that indicate which licenses are attached to resource.
License IDs are used to calculate additional charges for the use of the virtual machine.

NetworkSettings

Field

Description

type

enum Type

Network Type

STANDARD: Standard network.
SOFTWARE_ACCELERATED: Software accelerated network.
HARDWARE_ACCELERATED: Hardware accelerated network (not available yet, reserved for future use).

operation.Operation

{
  "id": "string",
  "description": "string",
  "created_at": "google.protobuf.Timestamp",
  "created_by": "string",
  "modified_at": "google.protobuf.Timestamp",
  "done": "bool",
  "metadata": "google.protobuf.Any",
  // Includes only one of the fields `error`, `response`
  "error": "google.rpc.Status",
  "response": "google.protobuf.Any"
  // end of the list of possible fields
}

An Operation resource. For more information, see Operation.

Field	Description
id	string ID of the operation.
description	string Description of the operation. 0-256 characters long.
created_at	google.protobuf.Timestamp Creation timestamp.
created_by	string ID of the user or service account who initiated the operation.
modified_at	google.protobuf.Timestamp The time when the Operation resource was last modified.
done	bool If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
metadata	google.protobuf.Any Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any.
error	google.rpc.Status The error result of the operation in case of failure or cancellation. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.
response	google.protobuf.Any The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is google.protobuf.Empty. If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set.

Compute Cloud API, gRPC: ReservedInstancePoolService.Create

gRPC requestgRPC request

CreateReservedInstancePoolRequestCreateReservedInstancePoolRequest

ResourcesSpecResourcesSpec

GpuSettingsGpuSettings

BootDiskSpecBootDiskSpec

ProductIDsProductIDs

NetworkSettingsNetworkSettings

operation.Operationoperation.Operation

Была ли статья полезна?

gRPC request

CreateReservedInstancePoolRequest

ResourcesSpec

GpuSettings

BootDiskSpec

ProductIDs

NetworkSettings

operation.Operation