Available parent projects
Содержит список проектов, которые могут стать родительскими для другого проекта. Возвращаются только подходящие кандидаты. Например, проект не может стать родительским для самого себя или своих дочерних объектов.
Чтобы указать проект, для которого запрашивается родительский объект, можно указать параметр of. Если параметр of
не указан, предполагается, что это новый проект. Тогда проверка на иерархию не выполняется, поскольку новый проект еще не может быть
частью иерархии.
Кандидаты могут быть отфильтрованы. Чаще всего требуется выполнить фильтрацию по имени или идентификатору.
Вы можете сделать это с помощью параметра filters, который работает так же, как индекс рабочего пакета.
Например, чтобы найти всех кандидатов-родителей с "rollout" в названии.:
?filters=[{"name_and_identifier":{"operator":"~","values":["rollout"]}}]
JSON, задающий условия фильтрации.
[{ "ancestor": { "operator": "=", "values": ['1'] }" }]Идентификатор проекта, для которого определен родительский кандидат
123JSON, указывающий критерии сортировки. Принимает тот же формат, который возвращается конечной точкой запросы, и разрешает все фильтры и сортировку, поддерживаемые конечной точкой списка проектов.
[["id", "asc"]]OK
{"_links":{"self":{"href":"/api/v3/projects/available_parent_projects?of=123"}},"_type":"Collection","total":2,"count":2,"_embedded":{"elements":[{"_type":"Project","_links":{"self":{"href":"/api/v3/projects/6","title":"A project"},"createWorkPackage":{"href":"/api/v3/projects/6/work_packages/form","method":"post"},"createWorkPackageImmediate":{"href":"/api/v3/projects/6/work_packages","method":"post"},"categories":{"href":"/api/v3/projects/6/categories"},"versions":{"href":"/api/v3/projects/6/versions"},"status":{"href":"/api/v3/project_statuses/on_track","title":"On track"}},"id":6,"identifier":"a_project","name":"A project","active":true,"statusExplanation":{"format":"markdown","raw":"Everything **fine**","html":"<p>Everything <strong>fine</strong></p>"},"public":false,"description":{"format":"markdown","raw":"Lorem **ipsum** dolor sit amet","html":"<p>Lorem <strong>ipsum</strong> dolor sit amet</p>"},"createdAt":"2015-07-06T13:28:14+00:00","updatedAt":"2015-10-01T09:55:02+00:00","type":"Customer Project"},{"_type":"Project","_links":{"self":{"href":"/api/v3/projects/14","title":"Another project"},"createWorkPackage":{"href":"/api/v3/projects/14/work_packages/form","method":"post"},"createWorkPackageImmediate":{"href":"/api/v3/projects/14/work_packages","method":"post"},"categories":{"href":"/api/v3/projects/14/categories"},"versions":{"href":"/api/v3/projects/14/versions"},"status":{"href":"/api/v3/project_statuses/on_track","title":"On track"}},"id":14,"identifier":"another_project","name":"Another project","active":true,"statusExplanation":{"format":"markdown","raw":"Everything super **fine**","html":"<p>Everything super <strong>fine</strong></p>"},"public":true,"description":{"format":"markdown","raw":"","html":""},"createdAt":"2016-02-29T12:50:20+00:00","updatedAt":"2016-02-29T12:50:20+00:00","type":null}]}}Returned if the client does not have sufficient permissions.
Required permission: edit project in a project or the global add project permission