Получить информацию о сервере

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Посмотрите описание команды для получения информации о сервере:

   yc baremetal server get --help
   

2. Получите информацию о сервере:

   yc baremetal server get <имя_или_идентификатор_сервера>
   

Чтобы получить информацию о сервере, воспользуйтесь методом REST API get для ресурса Server или вызовом gRPC API ServerService/Get.

curl -X GET \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer <IAM-токен>" \
 -d '{}' \
 "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>"

Где:

• <IAM-токен> — IAM-токен для аутентификации.
• <идентификатор_сервера> — идентификатор сервера.

Результат:

{
  "osSettings": {
    "storages": [
      {
        "partitions": [
          {
            "type": "EXT3",
            "sizeGib": "9",
            "mountPoint": "/boot"
          },
          {
            "type": "SWAP",
            "sizeGib": "4"
          },
          {
            "type": "EXT4",
            "mountPoint": "/"
          }
        ],
        "raid": {
          "disks": [
            {
              "id": "ly536lgz5cdo********",
              "type": "HDD",
              "sizeGib": "1862"
            },
            {
              "id": "ly55nr77qcgq********",
              "type": "HDD",
              "sizeGib": "1862"
            },
            {
              "id": "ly57e5ouat4r********",
              "type": "HDD",
              "sizeGib": "1862"
            },
            {
              "id": "ly5g77vbnavh********",
              "type": "HDD",
              "sizeGib": "1862"
            }
          ],
          "type": "RAID10"
        }
      }
    ],
    "imageId": "ly5vyzcggvci********",
    "sshPublicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMYMj0PbB7ObhwL0z3y+vN0BfNKwLm0u7DWw4D********"
  },
  "networkInterfaces": [
    {
      "privateSubnet": {
        "privateSubnetId": "ly55shvlzvy4********"
      },
      "id": "ly5j33j44gtc********",
      "macAddress": "00:25:90:e9:49:98"
    },
    {
      "publicSubnet": {
        "publicSubnetId": "ly5bss2zvuae********"
      },
      "id": "ly5rmqqchyep********",
      "macAddress": "00:25:90:e9:49:99"
    }
  ],
  "id": "ly56xpblirh4********",
  "cloudId": "b1gia87mbaom********",
  "folderId": "b1g07hj5r6i4********",
  "name": "bm-server-test",
  "zoneId": "ru-central1-m",
  "hardwarePoolId": "ru-central1-m4",
  "status": "PROVISIONING",
  "configurationId": "ly5fcdnlzp7j********",
  "createdAt": "2025-12-07T19:09:42.520760Z"
}

Где:

• id — идентификатор сервера.

• cloudId — идентификатор облака.

• folderId — идентификатор каталога.

• name — имя сервера.

  • длина — от 3 до 63 символов;
  • может содержать строчные буквы латинского алфавита, цифры и дефисы;
  • первый символ — буква, последний — не дефис.

• zoneId — идентификатор зоны доступности.

• hardwarePoolId — идентификатор пула размещения сервера.

• status — статус сервера. Возможные значения:

  • ASSEMBLING — сервер в своей конфигурации собирается в дата-центре.
  • PROVISIONING — сервер готовится к предоставлению в аренду пользователю.
  • RUNNING — сервер включен и полностью доступен пользователю.
  • STOPPING — на сервере выключается электропитание.
  • STOPPED — сервер выключен.
  • STARTING — на сервере включается электропитание.
  • RESTARTING — сервер перезагружается.
  • REINSTALLING — на сервере переустанавливается операционная система.
  • UPDATING — происходит обновление настроек сервера или сети.
  • MAINTENANCE — сервер находится на техническом обслуживании.
  • QUARANTINED — сервер в карантине и недоступен пользователю по сети и через KVM-консоль.
  • DELETING — сервер удаляется.
  • ERROR — произошла ошибка, KVM-консоль недоступна. Обратитесь в техническую поддержку.

  Подробнее в разделе Статусы серверов.

• configurationId — идентификатор конфигурации сервера.

• osSettings — (опционально) настройки операционной системы сервера. Будет пустым, если сервер создан без ОС.

• networkInterfaces — сетевые интерфейсы, подключенные к серверу.

• disks — диски, подключенные к серверу.

• createdAt — время создания в формате RFC3339.