BareMetal API, gRPC: ServerService.Reinstall
Reinstalls the specified server.
gRPC request
rpc Reinstall (ReinstallServerRequest) returns (operation.Operation)
ReinstallServerRequest
{
"server_id": "string",
"os_settings_spec": {
"image_id": "string",
"storages": [
{
"partitions": [
{
"type": "StoragePartitionType",
"size_gib": "int64",
"mount_point": "string"
}
],
// Includes only one of the fields `disk`, `raid`
"disk": {
"id": "string",
"type": "DiskDriveType",
"size_gib": "int64"
},
"raid": {
"type": "RaidType",
"disks": [
{
"id": "string",
"type": "DiskDriveType",
"size_gib": "int64"
}
]
}
// end of the list of possible fields
}
],
// Includes only one of the fields `ssh_public_key`, `user_ssh_id`
"ssh_public_key": "string",
"user_ssh_id": "string",
// end of the list of possible fields
// Includes only one of the fields `password_plain_text`, `password_lockbox_secret`
"password_plain_text": "string",
"password_lockbox_secret": {
"secret_id": "string",
"version_id": "string",
"key": "string"
}
// end of the list of possible fields
}
}
|
Field |
Description |
|
server_id |
string ID of the server to reinstall. To get the server ID, use a ServerService.List request. |
|
os_settings_spec |
Operating system specific settings for provisioning the server. |
OsSettingsSpec
|
Field |
Description |
|
image_id |
string ID of the image that the server was created from. |
|
storages[] |
List of storages to be created on the server. If not specified, the default value based on the |
|
ssh_public_key |
string Public SSH key for the server. Includes only one of the fields Root user SSH key. |
|
user_ssh_id |
string ID of the user SSH key to use for the server. To get the user SSH key ID, use a yandex.cloud.organizationmanager.v1.UserSshKeyService.List request. Includes only one of the fields Root user SSH key. |
|
password_plain_text |
string Raw password. Includes only one of the fields Password for the server. |
|
password_lockbox_secret |
Reference to the Lockbox secret used to obtain the password. Includes only one of the fields Password for the server. |
Storage
Storage, a OS-level storage entity used for creating partitions. For example, this could
represent a plain disk or a software RAID of disks.
|
Field |
Description |
|
partitions[] |
Array of partitions created on the storage. |
|
disk |
Disk storage. Includes only one of the fields Storage type. |
|
raid |
RAID storage. Includes only one of the fields Storage type. |
StoragePartition
|
Field |
Description |
|
type |
enum StoragePartitionType Partition type.
|
|
size_gib |
int64 Size of the storage partition in gibibytes (2^30 bytes). |
|
mount_point |
string Storage mount point. |
Disk
Disk.
|
Field |
Description |
|
id |
string ID of the disk. |
|
type |
enum DiskDriveType Type of the disk drive.
|
|
size_gib |
int64 Size of the disk in gibibytes (2^30 bytes). |
Raid
RAID storage.
|
Field |
Description |
|
type |
enum RaidType RAID type.
|
|
disks[] |
Array of disks in the RAID configuration. |
LockboxSecret
|
Field |
Description |
|
secret_id |
string Required field. The unique identifier for the lockbox secret that contains the user password. |
|
version_id |
string The unique identifier for the lockbox version. |
|
key |
string Required field. The key used to access a specific secret entry. |
operation.Operation
{
"id": "string",
"description": "string",
"created_at": "google.protobuf.Timestamp",
"created_by": "string",
"modified_at": "google.protobuf.Timestamp",
"done": "bool",
"metadata": {
"server_id": "string"
},
// Includes only one of the fields `error`, `response`
"error": "google.rpc.Status",
"response": "google.protobuf.Empty"
// 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 |
Creation timestamp. |
|
created_by |
string ID of the user or service account who initiated the operation. |
|
modified_at |
The time when the Operation resource was last modified. |
|
done |
bool If the value is |
|
metadata |
Service-specific metadata associated with the operation. |
|
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
|
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
ReinstallServerMetadata
|
Field |
Description |
|
server_id |
string ID of the Server resource that is being reinstalled. |