Метод get

Возвращает указанный ресурс Folder.

Чтобы получить список доступных ресурсов Folder, используйте запрос list.

HTTP-запрос

GET https://resource-manager.api.cloud.yandex.net/resource-manager/v1/folders/{folderId}

Path-параметры

Параметр Описание
folderId Обязательное поле. Идентификатор запрашиваемого ресурса Folder. Чтобы получить идентификатор каталога, используйте запрос list. Максимальная длина строки в символах — 50.

Ответ

HTTP Code: 200 - OK

{
  "id": "string",
  "cloudId": "string",
  "createdAt": "string",
  "name": "string",
  "description": "string",
  "labels": "object",
  "status": "string"
}

Ресурс Folder. Дополнительные сведения см. в разделе Каталог как ресурс Яндекс.Облака.

Поле Описание
id string

Идентификатор каталога.

cloudId string

Идентификатор облака, которому принадлежит каталог.

createdAt string (date-time)

Время создания.

Строка в формате RFC3339.

name string

Имя каталога. Имя должно быть уникальным в облаке. Длина имени должна быть от 3 до 63 символов.

description string

Описание каталога. Длина описания должна быть от 0 до 256 символов.

labels object

Метки ресурса в формате key:value. Максимум 64 на ресурс.

status string

Статус каталога.

  • ACTIVE: Каталог доступен.
  • DELETING: Каталог удаляется.