Допуски масел по api: НОВЫЕ КЛАССЫ МОТОРНЫХ МАСЕЛ API SP И ILSAC GF-6

Содержание

Моторное масло API SG и др. виды масел для двигателей категории S

Содержание:

Классификация материалов API была представлена в 1947 году. Это было необходимо, чтобы разделить масла в соответствии с их основными свойствами и характеристиками. Кроме того, такая классификация позволила ввести новые стандарты и требования, соответствующие американскому рынку. Эти условные обозначения используются до сих пор, позволяя выбирать подходящие разновидности моторных масел с учетом особенностей автомобильных двигателей. Чтобы понять, какой класс материала представлен, обратите внимание на первую букву: S подойдет для бензиновых двигателей, С – для дизельных. Вторая буква обозначает срок выпуска и качество материала. Универсальные варианты маркируются двумя символами, которые позволяют использовать материал для различных типов мотора.

Классификация API для бензиновых двигателей

Категория масел S подходит для всех разновидностей бензиновых движков.

С 1947-го и по настоящее время это наиболее крупный список. Например, в 2018 году появился стандарт спецификации API SN, который затем получил дополнительную маркировку Plus. Основные категории качества, которые встречаются на рынке, выглядят следующим образом:

SN. Актуальны для самых новых авто с двигателями, выпущенными после 2010 года. Подходят как для иномарок, так и для отечественных машин. Масла этой категории имеют отличные эксплуатационные характеристики, обеспечивают надежную защиту от коррозии и износа.

SM. Масла для моторов старше 2010 года. Подходят для отечественных и иностранных моделей авто, включая пассажирские и спортивные разновидности. Преимуществом материала является его низкая окислительная способность и снижение высокотемпературных отложений.

SL. Созданы специально для моторов старше 2004 года. Обеспечивают длительную защиту мотора от температурных отложений и коррозии. Обладают хорошими моющими свойствами, снижают износ.

SJ. Подойдут для двигателей старше 2001 года. Отличаются лучшей степенью защиты от окисления (по сравнению с категорией SH). Однако не подходят для больших бензиновых двигателей моложе 1996 года, так как не могут обеспечить им необходимых уровень защиты от окисления и износа.

SH. Вариант для двигателей старше 1996 года. Обладают хорошими защитными свойствами, снижают износ. Однако не подходят для большинства бензиновых двигателей, выпущенных после 1996 года. Причины те же самые, что у масла классом повыше: не справляются с отложениями.

SG. Моторное масло API SG лучше защищает двигатель, чем материал предшествующего класса. Они снижают процент окисления и образования шлама. Однако для автомобилей моложе 1996 года применяются редко, так как не подходят для большинства моделей. Все остальные категории смазочных материалов считаются устаревшими и больше не используются.

Классификация API для дизельных двигателей

При выборе масла для моторов такого типа необходимо следовать рекомендациям производителя автомобилей. Некоторые категории API на сегодняшний день признаны недействительными. Например, стандарты CD с успехом заменяют варианты CК-4, FA-4, CJ-4. SINTEС предлагает использовать моторные масла с высококачественными присадками, которые соответствуют требованиям API CD и SG.

Предложения SINTEC

В каталоге компании представлен широкий ассортимент моторных масел для современных и подержанных автомобилей с бензиновым или дизельным двигателем. Мы рекомендуем обратить внимание на следующие варианты.

  • SINTEC СУПЕР SAE 10W-40

    Полусинтетическое моторное масло создано с использованием высококачественных базовых масел и присадок. Может применяться как для бензиновых, так и для дизельных двигателей. Подходит для грузовых, легковых и спортивных авто от любых производителей. Главное преимущество материала заключается в его увеличенном сроке службы и низким расходом «на угар».

  • SINTEC СУПЕР 15W-40

    Всесезонное минеральное моторное масло соответствует стандартам масла API SG|CD. Подходит для отечественных и иностранных автомобилей, обладает отличными характеристиками и подходит для использования в любое время года.

Допуск api sn cf

API (American Petroleum Institute) — Американский Институт Топлива. Организация, которая сертифицирует и лицензирует моторные масла. Также API занимается разработкой современных новейших спецификаций и определяет минимальный набор стандартов качества моторных масел для бензиновых и дизельных двигателей, а также для базовых масел.

API классы для бензина и дизеля

С 1947 не без помощи ученных института API было принято (и действует до сих пор) разделение моторных масел по API классификации на бензиновые — S, и дизельные — C. Со временем качество масел совершенствовалось, требования — повышались, что непосредственно отзывалось в маркировке масел. API Service SA, SB, SC, SD, SE, SF, SG, SH, SJ, SL, SM, SN — это все о моторных маслах для бензинового двигателя. API СA, СB, СC, СD, СD-II, СE, СF, СF-2, СF-4, СG-4, СH-4, CI, CI-4, СJ-4 — разумеется, моторные масла для дизельных двигателей. Каждая следующая (по алфавиту) буква в классификации API означает следующий виток развития масляной индустрии, и более жесткие требования к качеству.

Замещение классов в API-классификации

Для себя надо отметить, что каждый следующий класс подразумевает замещение предыдущего, для дизелей с учетом «тактности» ( в классе СF-2 — двойка означает «для двухтактных дизельных двигателей», а в классе СJ-4 — «моторное масло для четырехтактных дизельных двигателей»). Так как большинство моторных масел можно с одинаковым успехом применять и в бензиновых и в дизельных двигателях, применяется такая маркировка API CJ-4, CI-4, CH-4, CG-4/SM. Класс, прописанный первым, является основным, т.е. — моторное масло для дизельных двигателей, но возможно применение в бензиновых двигателях, соответствующих классификации API SM.

Дополнения к API-классификации

На одном разделении моторных масел на бензиновые и дизельные API не остановились. С совершенствованием технологий производства современных двигателей повышались и требования, предъявляемые к моторным маслам. Поэтому API создают новые стандарты и спецификации, а также организации, которые лицензируют производителей моторных масел и сертифицируют их продукцию. Как пример: ILSAC GF или Energy Conserving (EC). Данные спецификации являются новейшими в API классификации.

API SM. Требования

Главные требования, предъявляемые для моторных масел класса API SM, во многом совпадают с требованиями ILSAC GF-4. Потому принято считать, что классификация API SM соответствует ILSAC GF-4. Требования, выполнение которых обязывает классификация API SM ILSAC GF-4 по сравнению с предыдущим классом API SL, выражаются приблизительно так:

класс API SM ужесточает требования к обеспечению износостойкости двигателя
моторные масла, соответствующие API SM, должны иметь увеличенный интервал замены
API SM подразумевает стабильность заявленных качеств моторного масла на протяжении всего срока эксплуатации
API SM «контролирует» стойкость масел к окислению («старению») и защиту от отложений
API SM повышает стандарты «морозоустойчивости» моторных масел
API SM.

В каких моторах применять

Итак. Моторное масло, удовлетворяющее требования классификации API SM ILSAC GF-4, может применяться в бензиновых двигателях автомобилей, выпущенных после 2004 года. Если производителем не указаны дополнительные требования, вполне возможно применение масел API SM ILSAC GF-4 и в более старых моделях двигателей.

API SN классификация

Главной причиной появления класса API SN является необходимость совершенствования моторных масел вообще. Производители двигателей с каждым днем «наворачивают» моторы все больше и больше. Само собой разумеется, масла для таких моторов нельзя оставлять без изменений. Отсюда явление миру API SN. Моторные масла, сертифицированные как соответствующие API SN, подразумевают возможность применения во всех бензиновых двигателях современного поколения (не забывайте о допусках производителя, определенных для Вашего авто).

Требования API SN

Важным в появлении класса API SN классификации API можно отметить введение следующих требований

моторные масла, лицензированные API SN, можно применять в двигателях, использующих биотопливо
класс API SN обязывает моторные масла быть энергосберегающими
API SN предъявляет дополнительные требования к обеспечению износостойкости двигателя
моторные масла API SN должны обеспечивать «долгую и счастливую жизнь» системам контроля эмиссии и «экологически чистый» выхлоп 🙂
Отличительной чертой API SN (по сравнению с API SМ) является совместимость с уплотнительными элементами двигателя. Еще совсем недавно классификация API не особо заботилась о сохранении сальников и прокладок. Теперь все по-другому. API SN подразумевает контроль за РТИ двигателя.

Интересное о API SN

Последние интересные факты о классе API SN. На стенде, который непосредственно отвечает за испытания моторных масел (тот самый стенд, через который должны пройти все моторные масла, борющиеся за «почетное звание» — API Service), сменили тестовый двигатель! Вместо V-образной фордовской восьмерки объемом 4.6 литра 1993 года (царя Гороха выпуска 🙂 ) была введена 3.6-литровая V-образная шестерка 2008 года от General Motors. Это, конечно, новость! А вот то, что API SN может заменить все предыдущие классы API (API SМ, API SL и т.д. и т.п.) — пожалуй, не новость, но — факт.

Продолжая тему «API классификация» разберем класс API SL. API SL введен в июле 2001 года для многоклапанных турбированных двигателей, оборудованных системами контроля и нейтрализации выхлопа. S — означает принадлежность к бензиновому классу, L — принадлежность к ужесточенным в 2001 году требованиям по экологичности и энергосберегающим свойствам моторных масел.
API SL подразумевает следующие совершенствования моторных масел

пониженную токсичность выхлопа
защиту систем контроля и нейтрализации выхлопа
повышенную защиту от износа
усиленная защита отвысокотемпературных отложений
удлиненный интервал замены
Конечно, все эти улучшения были относительно API SJ, предыдущего класса API. API SL был новым, современным классом API в начале нового тысячелетия. API SL включал моторные масла для двигателей 2000 года выпуска и действовал до 2004 года, передав эстафету следующему классу API SM.

«Соседство» API SL вместе с CF на этикетке (часто встречается API SL CF) — это возможность применения масла и в дизельных двигателях (подробнее о API CF). Никак не умаляя «бензиновых» свойств, моторное масло API SL CF готово к применению в дизельном двигателе, даже с применением топлива с высоким содержанием серы (высокосернистым 0,5% и более). Относится к дизелям 1994 года и позже.

API SL ILSAC GF-3

Масла API SL (в смысле, соответствующие API SL) могут быть сертифицированны по категории ILSAC GF-3, что говорит о экономии топлива и сохранение этой экономии на весь срок эксплуатации масла.

Cистема классификации моторных масел API (Американского Нефтяного Института ) была создана в 1969 году.По системе API установлены три эксплуатационные категории (три ряда) назначения и качества моторных масел:
S (Service) – состоит из категорий качества моторных масел для бензиновых двигателей, идущих в хронологическом порядке.
C (Commercial) – состоит из категорий качества и назначения масел для дизельных двигателей, идущих в хронологическом порядке.
EC (Energy Conserving) – энергосберегающие масла. Новый ряд высококачественных масел, состоящий из маловязких, легкотекущих масел, уменьшающих расход топлива по результатам тестов на бензиновых двигателях.

Для каждого нового класса присваивается дополнительная буква по алфавиту. Универсальные масла для бензиновых и для дизельных двигателей обозначаются двумя символами соответствующих категорий: первый символ является основным, а второй указывает на возможность применения этого масла для двигателя другого типа. Пример: API SM/CF.

Классы качества API для бензиновых моторов


Класс API SN – утвержден в 1 октября 2010 года.
Основное отличие API SN от предыдущих классификаций API в ограничении содержания фосфора для совместимости с современными системами нейтрализации выхлопных газов, а также комплексное энергосбережение. То есть, масла, классифицируемые по API SN, будут приблизительно соответствовать АСЕА С2, С3, С4, без поправки на высокотемпературную вязкость.

Класс API SM – утвержден 30 ноября 2004 года.
Моторные масла для современных бензиновых (многоклапанных, турбированных) двигателей. По сравнению с классом SL моторные масла, соответствующие требованиям API SM должны обладать более высокими показателями защиты от окисления и преждевременного износа деталей двигателя. Кроме того, повышены стандарты относительно свойств масла при низких температурах. Моторные масла этого класса могут быть сертифицированы по классу энергосбережения ILSAC
Моторные масла, соответствующие требованиям API SL, SM могут применяться в случаях, когда производителем автомобиля рекомендуется класс SJ или более ранние.

Класс API SL – моторные масла для двигателей машин, выпущенных после 2000 года.
В соответствии с требованиями производителей автомобилей, автомасла этого класса применяются в многоклапанных, турбированных моторах, работающих на обеднённых смесях топлива, соответствующих современным повышенным требованиям по экологии, а также энергосбережению. Автомасла, соответствующие требованиям API SL могут использоваться в случаях, когда автопроизводителем рекомендуется класс SJ или более ранние.

Класс API SJ – моторные масла для использования в бензиновых моторах начиная с 1996 года выпуска.
Данный класс описывает автомасла, которые используются в бензиновых двигателях, начиная с 1996 года выпуска. Моторные масла этого класса предназначены для использования в бензиновых моторах легковых и спортивных машин, микроавтобусов и легких грузовых машин, которые обслуживаются в соответствии с требованиями производителей автомобилей. SJ предусматривает такие же минимальные стандарты, как и SH, а также дополнительные требования к нагарообразованию и работе при низких температурах. Моторные масла, удовлетворяющие требованиям API SJ, могут применяться в тех случаях, когда производителем автомобиля рекомендуется класс SH или более ранние.

Класс API SH – моторные масла для бензиновых моторов начиная с 1994 года выпуска.
Класс принят в 1992 году для моторных масел, рекомендуемых с 1993 г. Этот класс характеризуется более высокими требованиями по сравнению с классом SG, и был разработан, как заменитель последнего, для улучшения антинагарных, противоокислительных, антиизносных свойств масел и повышенной защиты от коррозии. Моторные масла этого класса предназначены для использования в бензиновых моторах легковых машин, микроавтобусов и легких грузовых автомобилей, в соответствии с рекомендациями их производителей. Моторные масла данного класса тестировались в соответствии с требованиями Ассоциации производителей химической продукции (СМА). Моторные масла этого класса могут использоваться в тех случаях, когда производителем автомобиля рекомендуется класс SG или более ранний.

Класс API SG – моторные масла для бензиновых моторов начиная с 1989 года выпуска.
Предназначены для использования в бензиновых моторах легковых машин, микроавтобусов и легких грузовиков. Моторные масла этого класса обладают свойствами, обеспечивающими улучшенную защиту от нагара, окисления автомасла и износа мотора, в сравнении с предыдущими классами, а также содержат присадки, защищающие от ржавления и коррозии внутренних деталей двигателя. Моторные масла класса SG соответствуют требованиям к моторным маслам для дизельных моторов API CC и могут использоваться там, где рекомендуются классы SF, SE, SF/CC или же SE/CC.

Класс API SF – моторные масла для бензиновых моторов начиная с 1980 года выпуска (устаревший класс).
Эти моторные масла применялись в бензиновых моторах 1980-1989 годов выпуска, при условии наличия рекомендаций и инструкций производителя двигателя. Обеспечивают усиленную устойчивость к окислению, улучшенную защиту от износа деталей, в сравнении базовыми характеристиками автомасел SE, а также более надежную защиту от нагара, ржавления и коррозии. Моторные масла класса SF могли применяться, как заменители предыдущих классов SE, SD или SC.

Класс API SE – моторные масла бензиновых моторов выпуска с 1972 года (устаревший класс). Эти моторные масла применялись в бензиновых моторах моделей выпуска 1972-79 годов, а также некоторых моделях 1971 г. Дополнительная защита в сравнении с автомаслами SC и SD и могут использоваться, как заменители этих категорий.

Класс API SD – моторные масла для использования в бензиновых моторах с 1968 г. (устаревший класс). Автомасла этого класса использовались в бензиновых моторах легковых машин и некоторых грузовых выпуска 1968-70 годов, а также некоторых моделей 1971 г. и позднее. Улучшенная защита по сравнению с моторными маслами SC, применялись также исключительно при наличии рекомендации производителя двигателя.

Класс API SC – моторные масла для бензиновых моторов, начиная с 1964 г. выпуска (устаревший класс). Обычно применялись в моторах легковых машин и некоторых грузовиков выпуска 1964-1967 годов. Уменьшают высоко- и низкотемпературный нагар, износ, а также защищают от коррозии.

Класс API SB – моторные масла для маломощных бензиновых моторов (устаревший класс). Моторные масла 30-х годов 20-го века, обеспечивавших достаточно легкую защиту от износа и окисления, а также антикоррозийную защиту подшипников в моторах, которые эксплуатируются в легких нагрузочных режимах. Моторные масла этого класса могут применяться только, если они специально рекомендованы производителем двигателя.

Класс API SA – моторные масла для бензиновых и дизельных моторов. Устаревший класс масел для использования в старых моторах, работающих в таких условиях и режимах, при которых защита деталей с помощью присадок не нужна. Моторные масла этой класса могут применяться только, если они рекомендованы производителем двигателя.

Классы качества API для дизельных моторов

Класс API СJ-4 – действует с 1 октября 2006.
Данный класс разработан специально для тяжелонагруженных двигателей. Отвечает ключевым требованиям по нормам выбросов NOx и твердых частиц для двигателей 2007 года выпуска. На масла CJ-4 вводятся лимиты по некоторым показателям: зольность меньше чем 1,0 %, сера 0,4%, фосфор 0,12%.
Новая классификация вмещает требования более ранних категорий API CI-4 PLUS, CI-4, но несет значительные изменения требования в ответ на потребности новых двигателей, которые отвечают новым экологическим стандартам 2007 и более поздних моделей.

Класс API CI-4 (CI-4 PLUS) – новый эксплуатационный класс моторных масел для дизельных двигателей. По сравнению с API CI-4 повышены требования к удельному содержанию сажи, а также испаряемости и высокотемпературному окислению. При сертификации в данной классификации моторное масло должно тестироваться в семнадцати моторных тестах.

Класс API CI-4 – класс введен в 2002 году.
Эти моторные масла применяются в современных дизельных двигателях с различными видами впрыска и наддува. Моторное масло, соответствующее данному классу, должно содержать соответствующие моюще-диспергирующие присадки и имеет, в сравнении с классом CH-4, повышенную устойчивость к термическому окислению, а также более высокие диспергирующие свойства. Кроме того, такие автомасла обеспечивают существенное уменьшение угара моторного масла за счет снижения летучести и уменьшения испарения при рабочей температуре до 370°C, под воздействием газов. Усилены также требования относительно холодной прокачиваемости, увеличен ресурс зазоров, допусков и уплотнений мотора за счет улучшения текучести автомасла.
Класс API CI-4 введен в связи с появлением новых, более жестких требований по экологии и токсичности выхлопных газов, которые предъявляются к двигателям выпускаемым с 1 октября 2002 г.

Класс API CH-4 – действует с 1 декабря 1998 года.
Моторные масла данного класса применяются в четырехтактных дизельных двигателях, которые эксплуатируются в высокоскоростных режимах и соответствуют требованиям норм и стандартов по токсичности выхлопных газов, принятых в 1998 году.
Автомасла API CH-4 соответствуют достаточно жестким требованиям как американских, так и европейских производителей дизельных двигателей. Требования класса специально разработаны для использования в моторах, работающих на высококачественном топливе с удельным содержанием серы до 0,5%. При этом, в отличие от класса API CG-4, ресурс этих моторных масел менее чувствителен к использованию дизельного топлива с содержанием серы более 0,5%, что особенно актуально для стран Южной Америки, Азии, Африки.
Моторные масла API CH-4 соответствуют повышенным требованиям и должны содержать присадки, более эффективно предотвращающие износ клапанов и образование нагара на внутренних поверхностях. Могут применяться, как заменители моторных масел API CD, API CE, API CF-4 и API CG-4 в соответствии с рекомендациями производителя двигателя.

Класс API CG-4 – класс представлен в 1995 году.
Моторные масла этого класса рекомендуются для четырехтактных дизельных двигателей автобусов, грузовых машин и тягачей магистрального и немагистрального типа, которые эксплуатируются в режимах повышенных нагрузок, а также высокоскоростных режимах. Моторное масло API CG-4 подходит для двигателей, в которых используется высококачественное топливо с удельным содержанием серы не более 0,05%, а также в моторах, для которых не выдвигается особых требований к качеству топлива (удельное содержание серы может достигать 0,5%).
Автомасла, сертифицированные по классу API CG-4, должны более эффективно предотвращать износ внутренних деталей двигателя, образование нагара на внутренних поверхностях и поршнях, окисление, пенообразование, образование сажи (эти свойства особенно нужны для двигателей современных магистральных автобусов и тягачей).
Класс API CG-4 создан в связи с утверждением в США новых требований и стандартов по экологии и токсичности выхлопных газов (редакция 1994 года). Моторные масла этого класса могут применяться в двигателях, для которых рекомендуются классы API CD, API CE и API CF-4. Основной недостаток, ограничивающий массовое использование автомасел данного класса, например в восточной Европе и Азии, это существенная зависимость ресурса автомасла от качества используемого топлива.

Класс API CF-2 (CF-II) – автомасла, предназначенные для применения в двухтактных дизельных моторах, которые эксплуатируются в тяжелых условиях.
Класс введен в 1994 году. Моторные масла этого класса обычно используются в двухтактных дизельных двигателях, которые работают в условиях повышенной нагруженности. Масла API CF-2 должны содержать присадки, которые обеспечивают защиту повышенной эффективности от износа внутренних деталей двигателя, например цилиндров и колец. Кроме того, эти автомасла должны предотвращать накопление отложений на внутренних поверхностях мотора (улучшенная функция очистки).
Моторное масло, сертифицированное по классу API CF-2 обладает улучшенными свойствами и может использоваться вместо более ранних аналогичных масел при условии наличия рекомендации производителя.

Класс API CF-4 – моторные масла для использования в четырехтактных дизельных моторах, начиная с 1990 года выпуска.
Моторные масла данного класса могут использоваться в четырехтактных дизельных двигателях, условия эксплуатации которых связаны с высокоскоростными режимами. Для таких условий требования к качеству масел превышают возможности класса СЕ, поэтому моторные масла CF-4 могут использоваться вместо масел класса СЕ (при наличии соответствующих рекомендаций производителя двигателя).
Автомасла API CF-4 должны содержать соответствующие присадки, которые обеспечивают снижение угара автомасла, а также защиту от нагара в поршневой группе. Основное предназначение моторных масел данного класса – применение в дизельных двигателях сверхмощных тягачей и других автомобилей, которые используются для дальних поездок по автомагистралям.
Кроме того, таким моторным маслам иногда присваивается сдвоенный класс API CF-4/S. В таком случае, при условии наличия соответствующих рекомендаций производителя двигателя, эти автомасла могут применяться и в бензиновых двигателях.

Класс API CF (CF-2, CF-4) – моторные масла для дизельных двигателей с непрямым впрыском. Классы введены начиная с 1990-го и по 1994-й года. Цифра через дефис означает двух- или четырехтактный двигатель.
Класс CF описывает моторные масла рекомендованные к применению в дизельных двигателях с непрямым впрыском, а также других видах дизельных двигателей, которые работают на топливе различного качества, в том числе и с повышенным содержанием серы (например, больше 0,5% от общей массы).
Моторные масла, сертифицированные по классу CF, содержат присадки, способствующие более эффективному предотвращению отложений на поршне, износа и коррозии медных (с содержанием меди) подшипников, что имеет большое значение для двигателей этих видов, и могут прокачиваться обычным способом, а также с помощью турбонагнетателя или компрессора. Моторные масла этого класса могут использоваться там, где рекомендуется класс качества CD.

Класс API СЕ – моторные масла для использования в дизельных моторах, начиная с 1983 года выпуска (устаревший класс).
Автомасла данного класса предназначались для использования в некоторых сверхмощных турбированных моторах, характеризующихся существенно повышенной рабочей компрессией. Применение таких масел допускалось для двигателей как с низкой, так и с высокой частотой вращения вала.
Моторные масла API СЕ рекомендовались для низко- и высокооборотистых дизельных двигателей, выпущенных, начиная с 1983 года, которые эксплуатировались в режимах повышенной нагрузки. При условии наличия соответствующих рекомендаций производителя двигателя, эти автомасла могли быть использованы также в моторах, для которых рекомендовались моторные масла класса CD.

Класс API CD-II – моторные масла для использования в сверхмощных дизелях с двухтактным рпабочим циклом (устаревший класс).
Класс введен в 1985 году для использования в двухтактных дизельных моторах и является, по сути, эволюционным развитием предыдущего класса API CD. Основным предназначением использования таких автомасел являлось применение в тяжелых мощных дизельных двигателях, которые устанавливались, в основном на сельскохозяйственную технику. Моторные масла этого класса соответствуют всем рабочим стандартам предыдущего класса CD, кроме этого существенно повышены требования относительно высокоэффективной защиты двигателя от нагара и износа.

Класс API CD – моторные масла для дизельных двигателей повышенной мощности, которые использовались в сельскохозяйственной технике (устаревший класс). Класс введен в 1955 году для обычного использования в некоторых дизельных моторах, как атмосферных, так и турбированных, с увеличенной компрессией в цилиндрах, где крайне важна эффективная защита от нагара и износа. Моторные масла этого класса могли использоваться в случаях, когда производителем двигателя не выдвигались дополнительные требования к качеству топлива (включая топливо с повышенным содержанием серы).
Автомасла API CD должны были, по сравнению с предыдущими классами, обеспечивать повышенную защиту от коррозии подшипников и высокотемпературного нагара в дизельных моторах. Нередко моторные масла этого класса называли «Caterpillar серия 3», благодаря тому, что они соответствовали требованиям сертификации Superior Lubricants (Series 3), разработанной тракторной компанией Катерпиллар.

Класс API СС – моторные масла для дизельных двигателей, которые эксплуатируются в средних режимах нагрузки (устаревший класс).
Класс введен в 1961 году для использования в некоторых моторах, как атмосферных, так и турбированных, которые характеризовались повышенной компрессией. Моторные масла этого класса рекомендовались для двигателей, которые эксплуатировались в режимах умеренной и высокой нагрузки.
Кроме того, при условии наличия рекомендаций производителя двигателя, такие автомасла могли использоваться в некоторых мощных бензиновых моторах.
По сравнению с более ранними классами, моторные масла API СС должны были обеспечивать более высокий уровень защиты от высокотемпературного нагара и коррозии подшипников в дизельных моторах, а также от ржавления, коррозии и низкотемпературного нагара в бензиновых моторах.

Класс API СВ – моторные масла для дизельных двигателей, работающих со средней нагрузкой (устаревший класс).
Класс утвержден в 1949 г., как эволюционное развитие класса СА при использовании топлива с повышенным содержанием серы без особых требований к качеству. Автомасла API СВ предназначались также для использования в моторах с наддувом, которые эксплуатировались в легком и умеренном режимах. Часто этот класс называли «Моторные масла «Приложение 1», тем самым, подчеркивая соответствие военному предписанию MIL-L-2104A Приложение 1.

Класс API СА – моторные масла для малонагруженных дизельных двигателей (устаревший класс).
Автомасла этого класса предназначены для использования в дизельных моторах, работающих в легких и умеренных режимах на качественном дизельном топливе. В соответствии с рекомендациями производителей автомобилей, могут применяться и в некоторых бензиновых моторах, которые эксплуатируются в умеренных режимах.
Класс широко использовался в 40-х и 50-х годах прошлого века и не может использоваться в современных условиях, если это не предусмотрено требованиями производителя двигателя.
Моторные масла API СА должны обладать свойствами, обеспечивающими защиту от нагара на поршневых кольцах, а также от коррозии подшипников в моторах с наддувом, для которых не предусмотрены особые требования к качеству топлива, которое используется.

В классификация масел включается важная спецификация API SN, которая имеет расшифровку. Знание этой классификации жизненно необходимо каждому автомобилисту, так как она напрямую влияет на длительность срока службы мотора.

Что означает класс api sn?

Спецификация api sn – это признак того, что перед вами продукт наивысшей категории, отвечающий самым высоким требованиям и стандартам.

Масло api sn проходит тестирование на новейших двигателях. Такой допуск позволяет использовать его на всех бензиновых моторах без исключения. Другими словами, он способен заменить все аналоги предыдущего поколения.

В разработке этого класса приняло участие три крупных организации, спецификация которых связана с автомобильной промышленностью и продуктами нефтепереработки. Специалисты этих организаций сконцентрировали усилия на создании инновационного продукта, который бы позволил соответствовать требованиям современного мира.

Так, к обязательным характеристикам разрабатываемого продукта было причислено энергосбережение, соответствие другим классификациям, совместимость с системами нейтрализации выхлопных газов и биотопливом.

Естественно, в основу инновационного продукта вошли предыдущие разработки американского института топлива. Однако при этом были учтены и исключены недостатки этих разработок. Например, защита от износа и антикоррозийный эффект у масел класса api sn значительно выше.

Система классификации

Американский институт топлива (api) – это учреждение, которое занимается классифицированием масел, определением минимального перечня требований к ним, выдачей соответствующих сертификатов производителям данной продукции.

Классификация api включает в себя обозначения «S», «C» и «EC» с последующими цифровыми и буквенными обозначениями. Расшифровка символа «S» указывает на продукт, пригодный для применения в бензиновом двигателе, а «C» — в дизельном. Допуск «EC» присваивается энергосберегающим маслам, область применения которых пока ограничена бензиновыми моторами.

К каждому из указанных символов добавляются латинские буквы в алфавитном порядке. Чем дальше буква от начала алфавита, тем более высоким классом отличается продукт. Например, стандарт api sn был введен в 2010 году и на данный момент является самым высоким среди классификации масел для бензиновых двигателей.

Преимущества спецификации API SN

Класс api sn, как уже было сказано выше, отличается соответствием высоким требованиям. Такой продукт идеально подходит для современных моторов, требующих особого подхода, и устаревших моделей двигателей. Последние, впрочем, совершенно не обязательно обслуживать с помощью такого рода продукта. Это мало повлияет на характеристики мотора, но существенно увеличит стоимость его обслуживания.

В чем же состоит особенность данного продукта?

В преимущества продукции класса СН входит:

  • снижение расхода топлива;
  • совместимость с системами нейтрализации выхлопных газов и биотопливом;
  • сохранение качественных характеристик на протяжении заявленного срока эксплуатации;
  • повышенная защита от износа и высокий антикоррозийный эффект;
  • устойчивость к низким и высоким температурам с сохранением свойств;
  • экологичность.

Таким образом, данный продукт не только защищает основной агрегат автомобиля от износа, но и экономит топливо, а кроме того не вредит атмосфере.

Универсальные масла

Допуск АПИ СН указывает на область его применения в сфере бензиновых агрегатов и биотоплива. Однако владельцам дизельных авто не стоит отчаиваться. Обозначение «SN/CF» на упаковке моторного масла указывает на возможность его использования в дизельных двигателях. Естественно, это касается не всех моделей дизельных моторов. Поэтому перед применением такого продукта следует тщательно изучить инструкцию к нему. В ней будет подробно изложен перечень агрегатов, с которыми данный продукт совместим.

Аналог АПИ СН для дизельного двигателя

Если допуск «SN/CF» не подходит для модели двигателя вашего авто, значит стоит присмотреться к специализированной продукции. Для дизельных двигателей нового поколения существует категория «СJ-4», в полной мере удовлетворяющая потребности дизельных агрегатов.

Чтобы разобраться, подойдет ли продукция такой категории к автомобилю, необходимо разобраться в указанных обозначениях. Итак, символ «С» указывает на дизельную группу моторов, а символ «J» — на инновационность продукта. Цифра «4» в данном случае указывает на то, что данный продукт разработан для четырехтактных двигателей.

Преимущества этой категории частично совпадают с преимуществами категории «SN». Так, данной продукции свойственна экологичность, совместимость с системами нейтрализации выхлопных газов, стабильность сохранения свойств в течение заявленного периода эксплуатации. Кроме того, он также снижает расход топлива, повышая экономичность эксплуатации авто.

Если же необходимо подобрать масло для двухтактного мотора, следует обратить внимание на более ранние поколения данного продукта. Например, хорошими характеристиками отличаются продукты, имеющие допуск «CF-2».

Американский институт топлива рекомендует «CF-2» для использования в дизельных моторах с непрямым впрыском. Кроме того, его можно использовать и в других двухтактных моделях дизельных двигателей.

Особенность данной категории состоит в особом составе продукта, в который входят омывающие присадки. Такой продукт снижает коррозию и повышает износостойкость главного агрегата автомобиля. Кроме того, его термостойкость также соответствует необходимым требованиям.

Заключение

Ежегодно автомобильные концерны мирового уровня производят новые модели автомобилей. Они отличаются повышенной мощностью, улучшенными техническими характеристиками, ярким дизайном. Естественно, модернизация касается всех агрегатов автомобиля, но особенно – двигателя.

Использование соответствующего моторного масла обеспечивает длительный срок эксплуатации двигателя и всего автомобиля в целом. Поэтому необходимо знать обозначение классификации данного продукта и свойства каждой категории.

Допуски по классификации API для моторного масла TOTACHI Eco Gasoline 5W-30.

Cсообщаем вам о том, что полусинтетическое моторное масло TOTACHI Eco Gasoline 5W-30 получило новые допуски SN и Resource Conserving по классификации API.

TOTACHI Eco Gasoline 5W-30 теперь отвечает самым современным европейским требованиям категории ACEA C2 для двигателей последних экологических стандартов Euro 5 и Euro 6.

Это важная спецификация для использования масел в современных автомобилях японского и американского производства, для которых наличие допуска ILSAC GF-5 и категории SN является определяющим требованием при подборе моторного масла.

Мы обновили паспорт продукт TOTACHI Eco Gasoline 5W-30.

Дополнительно необходимо отметить, что выполнение требований категории ILSAC GF-5 – гарантирует надежную защиту двигателя и экономию топлива при эксплуатации автомобиля с маслом TOTACHI Eco Gasoline 5W-30 не менее 2,5%. Обновленное масло полностью совместимо с другими моторными маслами, отвечающими требованиям как категории API SN, так и более ранних категорий API SM или SL.

Коды продуктов

Фасовка
Старый код продукта
Новый код продукта
1 л
4562374690349
4589904934858
4 л
4562374690356
4589904934865
20 л
4562374690363
4589904934872
60 л
4562374690998
4589904934889
200 л
4562374690370
4589904934896
 По всем интересующим вас вопросам обращайтесь к авторизованному дистрибьютору на территории РФ, компанию «МСМ ГРУПП» (ИП Тунгусов Д.
Г.).

Назад к списку новостей

Стандарт API CK4 | Lubritech

19.12.2018 г.

В 2016 году специалистами Американского института топлива были представлены новые спецификации стандарта API, касающиеся моторных масел для дизельных двигателей. Такое решение стало итогом развития допуска CJ-4, на смену которому пришли сразу же две спецификации FA-4 и CK-4. Масла с допуском CK-4, ярким представителем которых является продукция Petro-Canada серии Duron, могут спокойно применяться совместно с высокосернистым топливом (содержание серы до 500 ppm), при этом будет соблюдено самое важное условие – сокращение межсервисных интервалов.

 

Что предлагает Petro-Canada?
Обширный перечень масел для дизельных ДВС, эксплуатируемых в тяжелых условиях. Испытания показали, что серия Duron превосходит требования ACEA E6, Е7 и E9, и при этом полностью соответствует API CK-4. Выбор поистине велик:

Cерия Duron HP (High Performance): Cерия Duron SHP (Super High Performance): Cерия Duron UHP (Ultra High Performance):
  • 0W-30;
  • 0W-40;
  • 5W-30;
  • 5W-40;
  • 10W-40.

Отличия стандартов CK-4 от CJ-4
Новая категория CK-4 полностью основана на предыдущей CJ-4, при этом было добавлено два новых моторных теста (на окисление и аэрацию) и ужесточен один лабораторный (с уменьшением минимальных отклонений). В результате были получены следующие результаты:

Защита двигателя:
  • Уменьшено истирание толкателя на 41%;
  • Снижено истирание выступов кулачков на 51%.
Срок эксплуатации:
  • Снижено образование сажи на 12%;
  • Повышена периодичность замены на 19%;
  • Улучшена устойчивость на сдвиг на 33%.
Экстремальные температуры:
  • Запуск двигателя при -20 ˚C;
  • Обеспечена стабильная вязкость.

Преимущества API CK-4

  • Повышенная устойчивость к окислению и отличный контроль аэрации;
  • Снижение износа подшипниковых узлов и цилиндров;
  • Увеличенный интервал замены;
  • Защита от появления отложений;
  • Полная совместимость с доочистителями выхлопных газов.

Допуски производителей для моторного масла | Страница 5

Начнём тогда.

Вот это категории API

категория API SH (устаревшая):

лицензированная категория, утвержденная в 1992 году. На сегодняшний день категория является условно действующей и может быть сертифицирована только как дополнительная к категориям API C (например API AF-4/SH). По требованиям соответствует категории ILSAC GF-1, но без обязательного энергосбережения. Масла данной категории предназначены для бензиновых двигателей моделей 1996 года и старше. При проведении сертификации на энергосбережение, в зависимости от степени экономии топлива присваивались категории API SH/EC и API SH/ECII.

категория API SJ (действующая):

категория утверждена 06.11.1995, лицензии стали выдаваться с 15.10.1996. Масла данной категории предназначены для всех используемых в настоящее время бензиновых двигателей и полностью заменяют масла всех существовавших ранее категорий в более старых моделях двигателей. Максимальных уровень эксплуатационных свойств. Возможность сертификации по категории энергосбережения API SJ/EC.

категория API SL (действующая):

Новая спецификация API SL для бензиновых двигателей является лицензионной категорией с 1 июля 2001г.
Появление этой категории обеспечило улучшение качества по нескольким ключевым параметрам по сравнению со спецификацией API SJ:
-Улучшение экономии топлива и сохранение более низкого уровня потребления топлива на период использования (степени GF-3).
-Более низкий уровень токсичности выхлопов.
-Защита систем контроля и нейтрализации выхлопов.
-Более совершенная защита от высокотемпературных отложений.
-Более совершенная защита от износа.

API SM (действующая):

Категория введена в 2004 г. Моторные масла категории API SM предназначены для бензиновых двигателей и по сравнению с продуктами класса SL обладают повышенной стойкостью к окислению, лучшей защитой от отложений и износа, оптимизированными низкотемпературными свойствами, увеличенным интервалом замены и сохраняют стабильность вышеперечисленных характеристик на протяжении более длительного срока эксплуатации. Масла этой категории преимущественно соответствуют последней спецификации ILSAC и являются энергосберегающими (Energy Conserving).
Категория SM рекомендуется для всех автомобильных двигателей используемых в настоящее время. Поэтому если инструкция производителя предписывает использование масла, соответствующего по API категории SJ или SL, то использование масла категории SM будет полностью удовлетворять предъявляемым требованиям и дополнительно уменьшит потребление топлива.

Энергосберегающая классификация ILSAC

Нажмите, чтобы раскрыть…

Почитай внимательно попробуй вникнуть в суть написанного

Потом почитай внимательно этот бред

А/В: моторные масла для бензиновых двигателей и дизелей легковых автомобилей, фургонов, микроавтобусов
A1/В1 Стойкие к механической деструкции масла, предназначенные для применения с увеличенными интервалами замены в бензиновых и дизельных двигателях легковых и легких грузовых транспортных средств, разработанных для применения маловязких масел, снижающих трение, с динамической вязкостью при высокой температуре и высокой скорости сдвига (HTHS) 2,6 мПа•с для SAE xW-20 и от 2,9 до 3,5 мПа•с для прочих классов вязкости. Эти масла могут быть не пригодны для смазывания некоторых двигателей. Необходимо руководствоваться инструкцией по эксплуатации и справочниками.
А3/В3 Стойкие к механической деструкции масла с высокими эксплуатационными свойствами, предназначенные для применения в высокофорсированных бензиновых и дизельных двигателях легковых и легких грузовых транспортных средств и/или для применения с увеличенными интервалами между сменами масла в соответствии с рекомендациями производителей двигателей, и/или для всесезонного применения маловязких масел, и/или всесезонного применения в особо тяжелых условиях эксплуатации.
А3/В4 Стойкие к механической деструкции масла с высокими эксплуатационными свойствами, предназначенные для применения в высокофорсированных бензиновых и дизельных двигателях с непосредственным впрыском топлива, также пригодные для применения согласно спецификации А3/В3.
А5/В5 Стойкие к механической деструкции масла, предназначенные для применения с увеличенными интервалами замены масла в высокофорсированных бензиновых и дизельных двигателях легких транспортных средств, в которых возможно использование маловязких масел, снижающих трение, с динамической вязкостью при высокой температуре и высокой скорости сдвига (HTHS) от 2,9 до 3,5 мПа•с. Эти масла могут быть не пригодны для смазывания некоторых двигателей. Необходимо руководствоваться инструкцией по эксплуатации и справочниками.

Нажмите, чтобы раскрыть…

А что такое Лонг Лайф ты вообще нигде не найдёшь.Об этом только знают те,что продают сертификаты соответствия этому самому Лонг Лайфу.И скорее всего это вообще ничего не значит.Это просто маркетинговый ход для получения денег с производителя масла ,а в итоге с потребителя.

А теперь обрати внимание на вот такую систему сертификации моторных масел.ГОСТ называется

Какая система более информативна в части качественных параметров масел?

И что вообще можно узнать о качестве масла из первых двух???

Пройдёмте далее.

Обозначения API для бензиновых моторов:
SC – автомобили, разработки до 1964 годов
SD – автомобили, разработки 1964-1968 годов
SE – автомобили, разработки 1969-1972 годов
SF – автомобили, разработки 1973-1988 годов
SG – автомобили, разработки 1989-1994 годов, для жестких условий эксплуатации
SH – автомобили, разработки 1995-1996 годов, для жестких условий эксплуатации
SJ – автомобили, разработки 1997-2000 годов, лучше энергосберегающие свойства
SL – автомобили, разработки 2001-2003 годов, увеличенный срок эксплуатации
SM – автомобили разработки с 2004 года, SL+повышенная стойкость к окислению

Нажмите, чтобы раскрыть. ..

То есть 95-96 год делались моторы из одних сплавов и допусками,а в 97-2000 годах уже совсем из других сплавов и совсем других допусков?

Не бредятина ли это чистой воды? Если почитаешь выше описание,то заметишь,что каждая последующая группа масел ЕЩЁ более стойкая и ещё более экономная,энергосберегающая,чем прежняя. Но при этом заявленная экономия топлива всё те же ДО 1.5%. Может кто не понимает,но погрешность при измерении среднего расхода топлива будет составлять гораздо больше чем заявленные 1.5%.То есть Вам просто на просто ДУЮТ в уши,как Бора в Новороссийске.

Можно и дальше находит обоснования БРЕДОВОСТИ всех этих сертификаций.Самое яркое подтерждение этого является пример нашего товарища Оооййееессс (Oyez!) на счёт заклинивания кучи моторов гарантийных автомобилей.А ведь они обслуживались у дилера.Наливали самое совершенное масло(с точки зрения надписей на этикетках). Только он и такие как он могут поверить,что это произошло из-за превышения в нашем топливе содержания Серы на 0,00000000000. …%

 

Утверждения

— Список — REST API (выпуск Azure DevOps)

Получить список согласований

В этой статье

  GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/release/approvals?api-version=6.0  

С дополнительными параметрами:

  GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/release/approvals?assignedToFilter={assignedToFilter}&statusFilter={statusFilter}&releaseIdsFilter={releaseIdsFilter}&typeFilter}&typeFilter}&typeFilter}&typeFilter}&typeFilter}&typeFilter = {top} & continuationToken = {continueToken} & queryOrder = {queryOrder} & includeMyGroupApprovals = {includeMyGroupApprovals} & api-version = 6.0  

Параметры URI

Имя В Требуется Тип Описание

организация

путь Правда

Название организации Azure DevOps.

проект

путь Правда

Идентификатор проекта или название проекта

api-версия

запрос Правда

Версия используемого API.Для использования этой версии API необходимо установить значение «6.0».

присвоено ToFilter

запрос

Разрешения, выданные этому пользователю.

продолжение Токен

запрос int32

Получает утверждения после предоставленного маркера продолжения.

включает MyGroup Одобрения

запрос

«true», чтобы включить утверждения моей группы. По умолчанию — «ложь».

запрос заказ

запрос

Получает результаты в определенном порядке созданных утверждений. По умолчанию — «по убыванию».

выпуск идентификаторы фильтр

запрос массив (int32)

Утверждения для идентификаторов выпуска, указанных в фильтре. Можно указать несколько выпусков, разделив их знаком «,» например releaseIdsFilter = 1,2,3,4.

статус Фильтр

запрос

Одобрения с этим статусом.По умолчанию «ожидает».

верх

запрос int32

Количество разрешений, которые необходимо получить. По умолчанию — 50.

тип Фильтр

запрос

Сертификат данного типа.

Ответы

Безопасность

oauth3

Тип: oauth3
Поток: accessCode
URL авторизации: https: // app.vssps. visualstudio.com/oauth3/authorize&response_type=Assertion
URL-адрес токена: https://app.vssps.visualstudio.com/oauth3/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt- предъявитель

Прицелы
Имя Описание
vso.release Предоставляет возможность читать артефакты выпуска, включая папки, выпуски, определения выпуска и среду выпуска.

Примеры

В ожидании конкретной версии

Образец запроса
  ПОЛУЧИТЬ https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/release/approvals?releaseIdsFilter=14&continuationToken=0&api-version=6.0  
Пример ответа
  {
  «count»: 1,
  "значение": [
    {
      "id": 134,
      «редакция»: 1,
      "подтверждающий": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Чак Рейнхарт",
        "uniqueName": "fabfiber @ outlook. com ",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
      },
      "Тип утверждения": "предварительное развертывание",
      "createdOn": "2017-06-01T09: 42: 16.053Z",
      "modifiedOn": "2017-06-01T09: 42: 16.053Z",
      "Статус: ожидание",
      "Комментарии": "",
      "isAutomated": ложь,
      "isNotificationOn": правда,
      "trialNumber": 1,
      «попытка»: 1,
      «ранг»: 1,
      "релиз": {
        "id": 14,
        "name": "Релиз-14",
        "url": "https: // vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/releases/14 ",
        "_links": {}
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {}
      },
      "releaseEnvironment": {
        "id": 53,
        "name": "Dev",
        "_links": {}
      },
      "url": "https://vsrm. dev.azure.com/fabrikam/MyFirstProject/_apis/Release/approvals/134"
    }
  ]
}  

В ожидании для конкретного пользователя

Образец запроса
  ПОЛУЧИТЬ https: // vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/release/approvals?assignedToFilter=Chuck Reinhart & continuationToken = 0 & api-version = 6.0  
Пример ответа
  {
  «count»: 2,
  "значение": [
    {
      "id": 2,
      «редакция»: 1,
      "подтверждающий": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Чак Рейнхарт",
        "uniqueName": "[email protected]",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https: // dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227 "
      },
      "Тип утверждения": "предварительное развертывание",
      "createdOn": "2017-05-31T16: 40: 14. 47Z",
      "modifiedOn": "2017-05-31T16: 40: 14.47Z",
      "Статус: ожидание",
      "Комментарии": "",
      "isAutomated": ложь,
      "isNotificationOn": правда,
      "trialNumber": 1,
      «попытка»: 1,
      «ранг»: 1,
      "релиз": {
        "id": 2,
        "name": "Релиз-2",
        "url": "https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/releases/2",
        "_links": {}
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {}
      },
      "releaseEnvironment": {
        "id": 5,
        "name": "Dev",
        "_links": {}
      },
      "url": "https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/approvals/2"
    },
    {
      "id": 1,
      «редакция»: 1,
      "подтверждающий": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Чак Рейнхарт",
        "uniqueName": "fabfiber @ outlook. com ",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
      },
      "Тип утверждения": "предварительное развертывание",
      "createdOn": "2017-05-31T16: 40: 04.577Z",
      "modifiedOn": "2017-05-31T16: 40: 04.577Z",
      "Статус: ожидание",
      "Комментарии": "",
      "isAutomated": ложь,
      "isNotificationOn": правда,
      "trialNumber": 1,
      «попытка»: 1,
      «ранг»: 1,
      "релиз": {
        "id": 1,
        "name": "Релиз-1",
        "url": "https: // vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/releases/1 ",
        "_links": {}
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {}
      },
      "releaseEnvironment": {
        "id": 1,
        "name": "Dev",
        "_links": {}
      },
      "url": "https://vsrm. dev.azure.com/fabrikam/MyFirstProject/_apis/Release/approvals/1"
    }
  ]
}  

На рассмотрении для всех пользователей

Образец запроса
  ПОЛУЧИТЬ https: // vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/release/approvals?continuationToken=0&api-version=6.0  
Пример ответа
  {
  «count»: 2,
  "значение": [
    {
      "id": 2,
      «редакция»: 1,
      "подтверждающий": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Чак Рейнхарт",
        "uniqueName": "[email protected]",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https: // dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227 "
      },
      "Тип утверждения": "предварительное развертывание",
      "createdOn": "2017-05-31T16: 40: 14.47Z",
      "modifiedOn": "2017-05-31T16: 40: 14. 47Z",
      "Статус: ожидание",
      "Комментарии": "",
      "isAutomated": ложь,
      "isNotificationOn": правда,
      "trialNumber": 1,
      «попытка»: 1,
      «ранг»: 1,
      "релиз": {
        "id": 2,
        "name": "Релиз-2",
        "url": "https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/releases/2",
        "_links": {}
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {}
      },
      "releaseEnvironment": {
        "id": 5,
        "name": "Dev",
        "_links": {}
      },
      "url": "https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/approvals/2"
    },
    {
      "id": 1,
      «редакция»: 1,
      "подтверждающий": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Чак Рейнхарт",
        "uniqueName": "fabfiber @ outlook.com ",
        "url": "https://vssps. dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
      },
      "Тип утверждения": "предварительное развертывание",
      "createdOn": "2017-05-31T16: 40: 04.577Z",
      "modifiedOn": "2017-05-31T16: 40: 04.577Z",
      "Статус: ожидание",
      "Комментарии": "",
      "isAutomated": ложь,
      "isNotificationOn": правда,
      "trialNumber": 1,
      «попытка»: 1,
      «ранг»: 1,
      "релиз": {
        "id": 1,
        "name": "Релиз-1",
        "url": "https: // vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/Release/releases/1 ",
        "_links": {}
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {}
      },
      "releaseEnvironment": {
        "id": 1,
        "name": "Dev",
        "_links": {}
      },
      "url": "https://vsrm. dev.azure.com/fabrikam/MyFirstProject/_apis/Release/approvals/1"
    }
  ]
}  

Определения

Статус утверждения

Получает или задает статус утверждения.

Имя Тип Описание
одобренный

Указывает, что утверждение утверждено.

отменен

Указывает, что утверждение отменено.

в ожидании

Указывает, что ожидается утверждение.

переназначен

Указывает, что утверждение переназначено.

отклоненный

Указывает, что утверждение отклонено.

пропущено

Указывает, что утверждение пропущено.

неопределенный

Указывает, что для утверждения не установлен статус.

Тип сертификата

Получает или задает тип утверждения.

Имя Тип Описание
все

Обозначает все разрешения.

postDeploy

Указывает утверждения, выполненные после развертывания.

предварительное развертывание

Указывает утверждения, выполненные перед развертыванием.

неопределенный

Указывает, что тип утверждения не установлен.

IdentityRef

Имя Тип Описание
_links

Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки могут быть вызваны для получения дополнительных взаимосвязей или более подробной информации об этом предмете графа.

дескриптор

Дескриптор — это основной способ ссылки на объект графа во время работы системы. Это поле будет однозначно идентифицировать одну и ту же тему графика как для учетных записей, так и для организаций.

directoryAlias

Устарело — может быть получено путем запроса пользователя Graph, указанного в записи «self» словаря IdentityRef «_links»

отображаемое имя

Это неуникальное отображаемое имя объекта графика.Чтобы изменить это поле, вы должны изменить его значение в исходном поставщике.

я бы
URL изображения

Устарело — доступно в записи «avatar» словаря IdentityRef «_links»

неактивный

Устарело — можно получить, запросив состояние членства в Graph, указанное в записи «membersState» словаря GraphUser «_links»

isAadIdentity

Устарело — может быть выведено из типа субъекта дескриптора (Descriptor. IsAadUserType / Descriptor.IsAadGroupType)

isContainer

Устарело — может быть выведено из типа субъекта дескриптора (Descriptor.IsGroupType)

isDeletedInOrigin
ссылка на профиль

Устарело — не используется в большинстве ранее существовавших реализаций ToIdentityRef

уникальное имя

Устарело — используйте Domain + PrincipalName вместо

url

Этот URL-адрес является полным маршрутом к исходному ресурсу данной темы графа.

Ссылка на проект

Имя Тип Описание
я бы

Получает уникальный идентификатор этого поля.

название

Получает имя проекта.

Ссылки

Класс, представляющий коллекцию ссылочных ссылок REST.

Имя Тип Описание
ссылки

Просмотр ссылок только для чтения. Поскольку ссылочные ссылки доступны только для чтения, мы хотим сделать их доступными только для чтения.

Разрешение на выпуск

Имя Тип Описание
ApprovalType

Получает или задает тип утверждения.

одобрено

Получает удостоверение личности, утвердившего.

утверждающий

Получает или задает личность, которая должна утверждать.

пытаться

Возвращает или задает попытку, которая указывает, к какой попытке развертывания она относится.

Комментарии

Получает или задает комментарии для утверждения.

создано на

Получает дату создания.

история

Получает историю, в которой указаны все утверждения, связанные с этим утверждением.

я бы

Получает уникальный идентификатор этого поля.

isAutomated

Получает или задает, является ли утверждение автоматическим или нет.

модифицировано

Получает дату изменения.

классифицировать

Получает или задает ранг, определяющий порядок утверждения. например Одинаковый ранг означает параллельное одобрение.

релиз

Получает releaseReference, который указывает ссылку на выпуск, с которым связано это утверждение.

releaseDefinition

Получает releaseDefinitionReference, который указывает ссылку на определение выпуска, с которым связано это утверждение.

releaseEnvironment

Получает releaseEnvironmentReference, который указывает ссылку на среду выпуска, с которой связано это утверждение.

пересмотр

Получает номер редакции.

статус

Получает или задает статус утверждения.

url

Получает URL-адрес для доступа к утверждению.

Выпуск Разрешение История

Имя Тип Описание
утверждающий

Личность утверждающего.

изменено

Идентификационные данные объекта, изменившего утверждение.

Комментарии

Комментарии к истории одобрений.

создано на

Время создания этого утверждения.

модифицировано

Время изменения данного утверждения.

пересмотр

Ревизия истории одобрений.

ReleaseDefinitionShallowReference

Имя Тип Описание
_links

Получает ссылки на связанные ресурсы, API и представления для определения выпуска.

я бы

Получает уникальный идентификатор определения выпуска.

название

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

дорожка

Получает или задает путь определения выпуска.

проектСсылка

Получает или задает ссылку на проект.

url

Получает URL-адрес REST API для доступа к определению выпуска.

ReleaseEnvironmentShallow Ссылка

Имя Тип Описание
_links

Получает ссылки на связанные ресурсы, API и представления для среды выпуска.

я бы

Получает уникальный идентификатор среды выпуска.

название

Получает или задает имя среды выпуска.

url

Получает URL-адрес REST API для доступа к среде выпуска.

ReleaseQueryOrder

Получает результаты в определенном порядке созданных утверждений. По умолчанию — «по убыванию».

Имя Тип Описание
по возрастанию

Возвращает результаты в порядке возрастания.

нисходящий

Возвращает результаты в порядке убывания.

ReleaseShallow Ссылка

Имя Тип Описание
_links

Получает ссылки на связанные ресурсы, API и представления для выпуска.

я бы

Получает уникальный идентификатор выпуска.

название

Получает или задает имя выпуска.

url

Получает URL-адрес REST API для доступа к выпуску.

Сертификаты — Разъемы | Документы Microsoft

Разрешает утверждения в рабочих процессах.

В этой статье

Этот разъем доступен в следующих продуктах и ​​регионах:

Метаданные разъема
Издатель Microsoft

Известные проблемы и ограничения

  • Временные метки утверждения всегда будут отображаться в формате UTC.
  • Создатель потока будет всегда отображаться в деталях утверждения (содержимое электронной почты и все клиенты). Это для предотвращения подделки идентификационных данных отправителя утверждения.

Формат получателя разрешения

Поле AssignedTo может принимать идентификаторы пользователей в форме:

  • Адрес электронной почты (не только основной)
  • Основное имя пользователя (UPN)
  • Идентификатор пользователя AAD (в формате XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX)

Чтобы указать нескольких пользователей, используйте точку с запятой (;) для разделения идентификаторов пользователей.Типы пользователей могут быть смешанными.

Пример:

[email protected]; 3b3ba145-7da5-414d-b84f-a9835eb71f3b; [email protected]

Сведения об утверждении

Синтаксис

Markdown поддерживается для настраиваемого стиля в поле сведений о согласованиях. См. Раздел Поддержка Markdown для документации

.

Общие ограничения

Имя Значение
Подключений на счет 1

Пределы дросселирования

Имя Звонки Период продления
Запросы без получения на соединение 300 3600 секунд

Действия

Создание утверждения

Запускает автоматический процесс утверждения, но не ждет его завершения.Утверждение может быть отменено.

Параметры
Сертификат
Имя Ключ Требуется Тип Описание

Тип сертификата

Тип Правда нить

Выберите тип утверждения.

Утверждение Создание Вход

Утверждение Создание Вход Правда динамичный

Динамический ввод для создания утверждения указанного типа.

Возврат

Результаты этой операции динамические.

Запускаем и ждем одобрения

Запускает автоматический процесс утверждения и ожидает его завершения. Утверждение может быть отменено.

Параметры
Сертификат
Имя Ключ Требуется Тип Описание

Тип сертификата

Тип Правда нить

Выберите тип утверждения.

WebhookApprovalCreationInput

WebhookApprovalCreationInput Правда динамичный

Динамический вход веб-перехватчика для создания утверждения указанного типа.

Возврат

Результаты этой операции динамические.

Запуск и ожидание утверждения [УСТАРЕЛО]

Это действие устарело.Вместо этого используйте Пуск и дождитесь утверждения.

Запускает автоматический процесс утверждения и ожидает его завершения. Утверждение отменяется только по истечении времени ожидания. (Устарело)

Параметры
Сертификат
Имя Ключ Требуется Тип Описание

Тип сертификата

Тип Правда нить

Выберите тип утверждения.

Утверждение Создание Вход

Утверждение Создание Вход Правда динамичный

Динамический ввод для создания утверждения указанного типа.

Возврат

Результаты этой операции динамические.

Начать и дождаться утверждения или отклонения — первый ответит утверждение [УСТАРЕЛО]

Это действие устарело.Вместо этого используйте Пуск и дождитесь утверждения.

Запускает автоматический процесс утверждения и ожидает его завершения. Утверждение отменяется только по истечении времени ожидания. (Устарело)

Параметры
Имя Ключ Требуется Тип Описание

Название

название Правда нить

Укажите название утверждения.

Детали

детали нить

Укажите детали запроса на утверждение. Поддерживается синтаксис Markdown, дополнительную информацию см. На https://aka.ms/approvaldetails.

Ссылка на предмет

товар Ссылка нить

Укажите ссылку на элемент для утверждения.

Элемент Ссылка Описание

товар Ссылка Описание нить

Укажите описание элемента для утверждения.

Назначено на

назначено на Правда электронное письмо

Укажите, кому должно быть назначено утверждение.Это должен быть набор разделенных точкой с запятой (;) адресов электронной почты, UPN или идентификаторов пользователей AAD.

Возврат

Ждать одобрения

Ожидает завершения указанного утверждения.

Параметры
Сертификат
Имя Ключ Требуется Тип Описание

Сертификат ID

Наименование Правда нить

Идентификатор утверждения.

Утверждение Подписка Вход

Утверждение Подписка Вход Правда динамичный

Динамический ввод для подписки на утверждение.

Возврат

Результаты этой операции динамические.

Определения

Утверждение Создание Выход V0

Имя Путь Тип Описание

Название

название нить

Название утверждения.

Детали

детали нить

Подробная информация о запросе на утверждение. Поддерживается синтаксис Markdown, дополнительную информацию см. На https://aka.ms/approvaldetails.

Ссылка на предмет

товар Ссылка нить

Ссылка на элемент для утверждения.

Ответчик

ответчик Ответчик

Пользователь, предоставивший ответ.

Ответ

ответ нить

Ответ об утверждении: «Утвердить» или «Отклонить».

Комментарии

комментария нить

Комментарии предоставлены утверждающим.

Главный ответчик

Пользователь, предоставивший ответ.

Имя Путь Тип Описание

Идентификатор утверждающего

id нить

Идентификатор утверждающего.

Имя утверждающего

displayName нить

Имя утверждающего.

Электронная почта утверждающего

электронная почта нить

Электронный адрес утверждающего лица.

Утверждающий идентификатор арендатора

tenantId нить

Идентификатор арендатора утверждающего.

Имя участника-утверждающего пользователя

userPrincipalName нить

Основное имя утверждающего.

API утверждения мерж-реквестов | GitLab

Конфигурация для утверждения по всем запросам на слияние в проекте.Должен быть аутентифицирован для всех конечных точек.

Утверждения MR на уровне проекта

Получить конфигурацию

История версий
  • Представлено в GitLab 10.6.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете запросить информацию о конфигурации утверждения проекта, используя следующая конечная точка:

  GET / projects /: id / согласования
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
  {
  "Approvalvals_before_merge": 2,
  "reset_approvals_on_push": правда,
  "disable_overriding_approvers_per_merge_request": ложь,
  "merge_requests_author_approval": правда,
  "merge_requests_disable_committers_approval": ложь,
  "require_password_to_approve": true
}
  

Изменить конфигурацию

История версий
  • Представлено в GitLab 10.6.
  • Перемещен на GitLab Premium в версии 13.9.

Если у вас есть разрешение, вы можете изменить конфигурацию утверждения, используя следующие конечная точка:

  POST / projects /: id / согласования
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
согласования_перед_мердж целое число нет Сколько разрешений необходимо для объединения MR.Устарело в версии 12.0 в пользу API правил утверждения.
reset_approvals_on_push логическое нет Сброс разрешений на новый толкатель
disable_overriding_approvers_per_merge_request логическое нет Разрешить / запретить переопределение утверждающих согласно MR
merge_requests_author_approval логическое нет Разрешить / запретить авторам самостоятельно утверждать запросы на слияние; true означает, что авторы могут самостоятельно утверждать
merge_requests_disable_committers_approval логическое нет Разрешить / запретить коммиттерам самостоятельно утверждать запросы на слияние
require_password_to_approve логическое нет Требовать от утверждающего ввести пароль для аутентификации перед добавлением утверждения
  {
  "Approvalvals_before_merge": 2,
  "reset_approvals_on_push": правда,
  "disable_overriding_approvers_per_merge_request": ложь,
  "merge_requests_author_approval": ложь,
  "merge_requests_disable_committers_approval": ложь,
  "require_password_to_approve": true
}
  

Получить правила на уровне проекта

Вы можете запросить информацию о правилах утверждения проекта, используя следующую конечную точку:

  GET / projects /: id / Approval_rules
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
  [
  {
    "id": 1,
    "имя": "безопасность",
    "rule_type": "обычный",
    "подходящие_апроверы": [
      {
        "id": 5,
        "name": "Джон Доу",
        "имя пользователя": "jdoe",
        "состояние": "активный",
        "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
        "web_url": "http: // localhost / jdoe"
      },
      {
        "id": 50,
        "name": "Член группы 1",
        "имя пользователя": "член_группы_1",
        "состояние": "активный",
        "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
        "web_url": "http: // localhost / group_member_1"
      }
    ],
    "Approvalvals_required": 3,
    "пользователи": [
      {
        "id": 5,
        "name": "Джон Доу",
        "имя пользователя": "jdoe",
        "состояние": "активный",
        "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
        "web_url": "http: // localhost / jdoe"
      }
    ],
    "группы": [
      {
        "id": 5,
        "имя": "группа1",
        "путь": "группа1",
        "описание": "",
        "видимость": "общедоступная",
        "lfs_enabled": ложь,
        "avatar_url": null,
        "web_url": "http: // localhost / groups / group1",
        "request_access_enabled": ложь,
        "полное_имя": "группа1",
        "full_path": "группа1",
        "parent_id": ноль,
        "ldap_cn": ноль,
        "ldap_access": ноль
      }
    ],
    "protected_branches": [
      {
        "id": 1,
        "имя": "хозяин",
        "push_access_levels": [
          {
            "access_level": 30,
            "access_level_description": "Разработчики + сопровождающие"
          }
        ],
        "merge_access_levels": [
          {
            "access_level": 30,
            "access_level_description": "Разработчики + сопровождающие"
          }
        ],
        "unprotect_access_levels": [
          {
            "access_level": 40,
            "access_level_description": "Сопровождающие"
          }
        ],
        "code_owner_approval_required": "false"
      }
    ],
    "contains_hidden_groups": ложь
  }
]
  

Получите единое правило уровня проекта

Вы можете запросить информацию о правилах утверждения одного проекта, используя следующую конечную точку:

  GET / projects /: id / Approval_rules /: Approve_rule_id
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
ID_правила_ одобрения целое число да Идентификатор правила утверждения
  {
  "id": 1,
  "имя": "безопасность",
  "rule_type": "обычный",
  "подходящие_апроверы": [
    {
      "id": 5,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    },
    {
      "id": 50,
      "name": "Член группы 1",
      "имя пользователя": "член_группы_1",
      "состояние": "активный",
      "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
      "web_url": "http: // localhost / group_member_1"
    }
  ],
  "Approvalvals_required": 3,
  "пользователи": [
    {
      "id": 5,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    }
  ],
  "группы": [
    {
      "id": 5,
      "имя": "группа1",
      "путь": "группа1",
      "описание": "",
      "видимость": "общедоступная",
      "lfs_enabled": ложь,
      "avatar_url": null,
      "web_url": "http: // localhost / groups / group1",
      "request_access_enabled": ложь,
      "полное_имя": "группа1",
      "full_path": "группа1",
      "parent_id": ноль,
      "ldap_cn": ноль,
      "ldap_access": ноль
    }
  ],
  "protected_branches": [
    {
      "id": 1,
      "имя": "хозяин",
      "push_access_levels": [
        {
          "access_level": 30,
          "access_level_description": "Разработчики + сопровождающие"
        }
      ],
      "merge_access_levels": [
        {
          "access_level": 30,
          "access_level_description": "Разработчики + сопровождающие"
        }
      ],
      "unprotect_access_levels": [
        {
          "access_level": 40,
          "access_level_description": "Сопровождающие"
        }
      ],
      "code_owner_approval_required": "false"
    }
  ],
  "contains_hidden_groups": ложь
}
  

Создать правило на уровне проекта

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете создать правила утверждения проекта, используя следующую конечную точку:

  POST / projects /: id / Approval_rules
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
наименование строка да Название правила утверждения
требуется согласование целое число да Количество необходимых разрешений для этого правила
user_ids Массив нет Идентификаторы пользователей в качестве подтверждающих
group_ids Массив нет Идентификаторы групп утверждающих
protected_branch_ids Массив нет Идентификаторы защищенных веток для применения правила
  {
  "id": 1,
  "имя": "безопасность",
  "rule_type": "обычный",
  "подходящие_апроверы": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    },
    {
      "id": 50,
      "name": "Член группы 1",
      "имя пользователя": "член_группы_1",
      "состояние": "активный",
      "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
      "web_url": "http: // localhost / group_member_1"
    }
  ],
  "Approvalvals_required": 1,
  "пользователи": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    }
  ],
  "группы": [
    {
      "id": 5,
      "имя": "группа1",
      "путь": "группа1",
      "описание": "",
      "видимость": "общедоступная",
      "lfs_enabled": ложь,
      "avatar_url": null,
      "web_url": "http: // localhost / groups / group1",
      "request_access_enabled": ложь,
      "полное_имя": "группа1",
      "full_path": "группа1",
      "parent_id": ноль,
      "ldap_cn": ноль,
      "ldap_access": ноль
    }
  ],
  "protected_branches": [
    {
      "id": 1,
      "имя": "хозяин",
      "push_access_levels": [
        {
          "access_level": 30,
          "access_level_description": "Разработчики + сопровождающие"
        }
      ],
      "merge_access_levels": [
        {
          "access_level": 30,
          "access_level_description": "Разработчики + сопровождающие"
        }
      ],
      "unprotect_access_levels": [
        {
          "access_level": 40,
          "access_level_description": "Сопровождающие"
        }
      ],
      "code_owner_approval_required": "false"
    }
  ],
  "contains_hidden_groups": ложь
}
  

Обновление правила уровня проекта

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете обновить правила утверждения проекта, используя следующую конечную точку:

  PUT / projects /: id / Approval_rules /: Approve_rule_id
  

Важно: Утверждающие и группы, не входящие в группу пользователей / параметров удалены

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
ID_правила_ одобрения целое число да Идентификатор правила утверждения
наименование строка да Название правила утверждения
требуется согласование целое число да Количество необходимых разрешений для этого правила
user_ids Массив нет Идентификаторы пользователей в качестве подтверждающих
group_ids Массив нет Идентификаторы групп утверждающих
protected_branch_ids Массив нет Идентификаторы защищенных веток для применения правила
  {
  "id": 1,
  "имя": "безопасность",
  "rule_type": "обычный",
  "подходящие_апроверы": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    },
    {
      "id": 50,
      "name": "Член группы 1",
      "имя пользователя": "член_группы_1",
      "состояние": "активный",
      "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
      "web_url": "http: // localhost / group_member_1"
    }
  ],
  "Approvalvals_required": 1,
  "пользователи": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    }
  ],
  "группы": [
    {
      "id": 5,
      "имя": "группа1",
      "путь": "группа1",
      "описание": "",
      "видимость": "общедоступная",
      "lfs_enabled": ложь,
      "avatar_url": null,
      "web_url": "http: // localhost / groups / group1",
      "request_access_enabled": ложь,
      "полное_имя": "группа1",
      "full_path": "группа1",
      "parent_id": ноль,
      "ldap_cn": ноль,
      "ldap_access": ноль
    }
  ],
  "protected_branches": [
    {
      "id": 1,
      "имя": "хозяин",
      "push_access_levels": [
        {
          "access_level": 30,
          "access_level_description": "Разработчики + сопровождающие"
        }
      ],
      "merge_access_levels": [
        {
          "access_level": 30,
          "access_level_description": "Разработчики + сопровождающие"
        }
      ],
      "unprotect_access_levels": [
        {
          "access_level": 40,
          "access_level_description": "Сопровождающие"
        }
      ],
      "code_owner_approval_required": "false"
    }
  ],
  "contains_hidden_groups": ложь
}
  

Удалить правило уровня проекта

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете удалить правила утверждения проекта, используя следующую конечную точку:

  УДАЛИТЬ / projects /: id / Author_rules /: Approval_rule_id
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
ID_правила_ одобрения целое число да Идентификатор правила утверждения

Внешние утверждения MR на уровне проекта

Конфигурация для утверждения конкретного запроса на слияние, который выполняет вызов внешнего HTTP-ресурса.

История версий
  • Представлено в GitLab 13.10.
  • Он развернут за флажком функции, по умолчанию отключен.
  • Он отключен на GitLab.com.
  • Не рекомендуется для промышленного использования.
  • Чтобы использовать его в самоуправляемых экземплярах GitLab, попросите администратора GitLab включить его.

Получить правила внешнего утверждения проекта

Вы можете запросить информацию о правилах внешнего утверждения проекта, используя следующую конечную точку:

  GET / projects /: id / external_approval_rules
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
  [
  {
    "id": 1,
    "name": "Проверка на соответствие",
    "project_id": 6,
    "external_url": "https: // gitlab.com / example / test.json ",
    "protected_branches": [
      {
        "id": 14,
        "project_id": 6,
        "имя": "хозяин",
        "created_at": "2020-10-12T14: 04: 50.787Z",
        "updated_at": "2020-10-12T14: 04: 50.787Z",
        "code_owner_approval_required": ложь
      }
    ]
  }
]
  

Создать правило внешнего утверждения

Вы можете создать новое правило внешнего утверждения для проекта, используя следующую конечную точку:

  POST / projects /: id / external_approval_rules
  
Атрибут Тип Требуется Описание
id целое число да ID проекта
наименование строка да Отображаемое имя правила утверждения
external_url строка да URL внешнего ресурса утверждения
protected_branch_ids массив <Целое число> нет Идентификаторы защищенных веток для применения правила

Удалить правило внешнего утверждения

Вы можете удалить правило внешнего утверждения для проекта, используя следующую конечную точку:

  УДАЛИТЬ / projects /: id / external_approval_rules /: rule_id
  
Атрибут Тип Требуется Описание
rule_id целое число да Идентификатор правила утверждения
id целое число да ID проекта

Обновление правила внешнего утверждения

Вы можете обновить существующее правило внешнего утверждения для проекта, используя следующую конечную точку:

  PUT / projects /: id / external_approval_rules /: rule_id
  
Атрибут Тип Требуется Описание
id целое число да ID проекта
rule_id целое число да Идентификатор правила внешнего утверждения
наименование строка нет Отображаемое имя правила утверждения
external_url строка нет URL внешнего ресурса утверждения
protected_branch_ids массив <Целое число> нет Идентификаторы защищенных ветвей для применения правила

Включение или отключение утверждения MR на уровне внешнего проекта

Включение или отключение внешнего утверждения MR на уровне проекта находится в стадии разработки и не готово к производственному использованию.это развернут за флагом функции , по умолчанию отключен . Администраторы GitLab с доступом к консоли GitLab Rails можно включить.

Для включения:

  # Для экземпляра
Feature.enable (: ff_compliance_approval_gates)
# Для одного проекта
Feature.enable (: ff_compliance_approval_gates, Project.find (<идентификатор проекта>))
  

Чтобы отключить:

  # Для экземпляра
Feature.disable (: ff_compliance_approval_gates)
# Для одного проекта
Характерная черта.disable (: ff_compliance_approval_gates, Project.find (<идентификатор проекта>))
  

Утверждение MR на уровне запроса на слияние

Конфигурация для утверждений по конкретному запросу на слияние. Должен быть аутентифицирован для всех конечных точек.

Получить конфигурацию

История версий
  • Введено в GitLab 8.9.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете запросить информацию о статусе утверждения мерж-реквеста, используя следующая конечная точка:

  GET / projects /: id / merge_requests /: merge_request_iid / Approval
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR
  {
  "id": 5,
  "iid": 5,
  "project_id": 1,
  "title": "API утверждений",
  "description": "Тест",
  "состояние": "открыто",
  «created_at»: «2016-06-08T00: 19: 52.638Z ",
  «updated_at»: «2016-06-08T21: 20: 42.470Z»,
  "merge_status": "cannot_be_merged",
  "Approvalvals_required": 2,
  "Approvalvals_left": 1,
  "одобрено": [
    {
      "Пользователь": {
        "name": "Администратор",
        "имя пользователя": "корень",
        "id": 1,
        "состояние": "активный",
        "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80\u0026d=identicon",
        "web_url": "http: // localhost: 3000 / root"
      }
    }
  ]
}
  

Изменить конфигурацию утверждения

История версий
  • Представлено в GitLab 10.6.
  • Перемещен на GitLab Premium в версии 13.9.

Если вам разрешено, вы можете изменить Approvalvals_required , используя следующие конечная точка:

  POST / projects /: id / merge_requests /: merge_request_iid / Approval
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR
требуется согласование целое число да Для объединения MR требуются разрешения.Устарело в версии 12.0 в пользу API правил утверждения.
  {
  "id": 5,
  "iid": 5,
  "project_id": 1,
  "title": "API утверждений",
  "description": "Тест",
  "состояние": "открыто",
  "created_at": "2016-06-08T00: 19: 52.638Z",
  «updated_at»: «2016-06-08T21: 20: 42.470Z»,
  "merge_status": "cannot_be_merged",
  "Approvalvals_required": 2,
  "Approvalvals_left": 2,
  "одобрено": []
}
  

Получить состояние утверждения запросов на слияние

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете запросить информацию о состоянии утверждения мерж-реквеста, используя следующую конечную точку:

  GET / projects /: id / merge_requests /: merge_request_iid / author_state
  

правила_подтверждения_запись равно истина , если правила уровня мерж-реквест созданы для мерж-реквеста. Если их нет, это ложь .

Сюда входит дополнительная информация о пользователях, которые уже одобрили ( authorized_by ) и утверждено ли правило ( одобрено ).

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR
  {
  "Approval_rules_overwritten": правда,
  "правила": [
    {
      "id": 1,
      "name": "Рубин",
      "rule_type": "обычный",
      "подходящие_апроверы": [
        {
          "id": 4,
          "name": "Джон Доу",
          "имя пользователя": "jdoe",
          "состояние": "активный",
          "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
          "web_url": "http: // localhost / jdoe"
        }
      ],
      "Approvalvals_required": 2,
      "пользователи": [
        {
          "id": 4,
          "name": "Джон Доу",
          "имя пользователя": "jdoe",
          "состояние": "активный",
          "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
          "web_url": "http: // localhost / jdoe"
        }
      ],
      "группы": [],
      "contains_hidden_groups": ложь,
      "одобрено": [
        {
          "id": 4,
          "name": "Джон Доу",
          "имя пользователя": "jdoe",
          "состояние": "активный",
          "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
          "web_url": "http: // localhost / jdoe"
        }
      ],
      "source_rule": ноль,
      "одобрено": правда,
      "переопределено": ложь
    }
  ]
}
  

Получить правила уровня мерж-реквеста

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете запросить информацию о правилах утверждения мерж-реквеста, используя следующую конечную точку:

  GET / projects /: id / merge_requests /: merge_request_iid / Approval_rules
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR
  [
  {
    "id": 1,
    "имя": "безопасность",
    "rule_type": "обычный",
    "подходящие_апроверы": [
      {
        "id": 5,
        "name": "Джон Доу",
        "имя пользователя": "jdoe",
        "состояние": "активный",
        "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
        "web_url": "http: // localhost / jdoe"
      },
      {
        "id": 50,
        "name": "Член группы 1",
        "имя пользователя": "член_группы_1",
        "состояние": "активный",
        "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
        "web_url": "http: // localhost / group_member_1"
      }
    ],
    "Approvalvals_required": 3,
    "source_rule": ноль,
    "пользователи": [
      {
        "id": 5,
        "name": "Джон Доу",
        "имя пользователя": "jdoe",
        "состояние": "активный",
        "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
        "web_url": "http: // localhost / jdoe"
      }
    ],
    "группы": [
      {
        "id": 5,
        "имя": "группа1",
        "путь": "группа1",
        "описание": "",
        "видимость": "общедоступная",
        "lfs_enabled": ложь,
        "avatar_url": null,
        "web_url": "http: // localhost / groups / group1",
        "request_access_enabled": ложь,
        "полное_имя": "группа1",
        "full_path": "группа1",
        "parent_id": ноль,
        "ldap_cn": ноль,
        "ldap_access": ноль
      }
    ],
    "contains_hidden_groups": ложь,
    "переопределено": ложь
  }
]
  

Создать правило уровня мерж-реквеста

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете создать правила утверждения мерж-реквестов, используя следующую конечную точку:

  POST / projects /: id / merge_requests /: merge_request_iid / Approval_rules
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR
наименование строка да Название правила утверждения
требуется согласование целое число да Количество необходимых разрешений для этого правила
идентификатор_проекта_проекта целое число нет Идентификатор правила утверждения на уровне проекта
user_ids Массив нет Идентификаторы пользователей в качестве подтверждающих
group_ids Массив нет Идентификаторы групп утверждающих

Важно: Если установлен идентификатор_проекта_проекта , имя , пользователи и групп Копируется правил уровня проекта. разрешений_требуется указано используется.

  {
  "id": 1,
  "имя": "безопасность",
  "rule_type": "обычный",
  "подходящие_апроверы": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
      "web_url": "http: // localhost / jdoe"
    },
    {
      "id": 50,
      "name": "Член группы 1",
      "имя пользователя": "член_группы_1",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / group_member_1"
    }
  ],
  "Approvalvals_required": 1,
  "source_rule": ноль,
  "пользователи": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
      "web_url": "http: // localhost / jdoe"
    }
  ],
  "группы": [
    {
      "id": 5,
      "имя": "группа1",
      "путь": "группа1",
      "описание": "",
      "видимость": "общедоступная",
      "lfs_enabled": ложь,
      "avatar_url": null,
      "web_url": "http: // localhost / groups / group1",
      "request_access_enabled": ложь,
      "полное_имя": "группа1",
      "full_path": "группа1",
      "parent_id": ноль,
      "ldap_cn": ноль,
      "ldap_access": ноль
    }
  ],
  "contains_hidden_groups": ложь,
  "переопределено": ложь
}
  

Обновление правила уровня мерж-реквеста

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете обновить правила утверждения мерж-реквестов, используя следующую конечную точку:

  PUT / projects /: id / merge_requests /: merge_request_iid / Approval_rules /: Approle_rule_id
  

Важно: Утверждающие и группы, не входящие в группу пользователей / параметров удалены

Важно: Обновление правила report_approver или code_owner запрещено.Это правила, сгенерированные системой.

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да Идентификатор MR
ID_правила_ одобрения целое число да Идентификатор правила утверждения
наименование строка да Название правила утверждения
требуется согласование целое число да Количество необходимых разрешений для этого правила
user_ids Массив нет Идентификаторы пользователей в качестве подтверждающих
group_ids Массив нет Идентификаторы групп утверждающих
  {
  "id": 1,
  "имя": "безопасность",
  "rule_type": "обычный",
  "подходящие_апроверы": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    },
    {
      "id": 50,
      "name": "Член группы 1",
      "имя пользователя": "член_группы_1",
      "состояние": "активный",
      "avatar_url": "https://www.gravatar.com/avatar/0?s=80&d=identicon",
      "web_url": "http: // localhost / group_member_1"
    }
  ],
  "Approvalvals_required": 1,
  "source_rule": ноль,
  "пользователи": [
    {
      "id": 2,
      "name": "Джон Доу",
      "имя пользователя": "jdoe",
      "состояние": "активный",
      "avatar_url": "https: // www.gravatar.com/avatar/0?s=80&d=identicon ",
      "web_url": "http: // localhost / jdoe"
    }
  ],
  "группы": [
    {
      "id": 5,
      "имя": "группа1",
      "путь": "группа1",
      "описание": "",
      "видимость": "общедоступная",
      "lfs_enabled": ложь,
      "avatar_url": null,
      "web_url": "http: // localhost / groups / group1",
      "request_access_enabled": ложь,
      "полное_имя": "группа1",
      "full_path": "группа1",
      "parent_id": ноль,
      "ldap_cn": ноль,
      "ldap_access": ноль
    }
  ],
  "contains_hidden_groups": ложь,
  "переопределено": ложь
}
  

Удалить правило уровня мерж-реквеста

История версий
  • Представлен в GitLab 12.3.
  • Перемещен на GitLab Premium в версии 13.9.

Вы можете удалить правила утверждения мерж-реквестов, используя следующую конечную точку:

  УДАЛИТЬ / projects /: id / merge_requests /: merge_request_iid / Author_rules /: Approval_rule_id
  

Важно: Удаление правила report_approver или code_owner запрещено. Это правила, сгенерированные системой.

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да Идентификатор MR
ID_правила_ одобрения целое число да Идентификатор правила утверждения

Утвердить запрос на слияние

История версий
  • Введено в GitLab 8.9.
  • Перемещен на GitLab Premium в версии 13.9.

Если у вас есть разрешение, вы можете утвердить мерж-реквест, используя следующие конечная точка:

  POST / projects /: id / merge_requests /: merge_request_iid / Approve
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR
sha строка нет ГОЛОВКА MR
пароль_ одобрения строка нет Пароль текущего пользователя.Обязательно, если Требовать пароль пользователя для подтверждения включен в настройках проекта.

Параметр sha работает так же, как при принятии мерж-реквеста: если он принят, то он должен соответствовать текущему заголовку запроса на добавление утверждения. Если это не совпадает, код ответа 409 .

  {
  "id": 5,
  "iid": 5,
  "project_id": 1,
  "title": "API утверждений",
  "description": "Тест",
  "состояние": "открыто",
  «created_at»: «2016-06-08T00: 19: 52.638Z ",
  "updated_at": "2016-06-09T21: 32: 14.105Z",
  "merge_status": "can_be_merged",
  "Approvalvals_required": 2,
  "Approvalvals_left": 0,
  "одобрено": [
    {
      "Пользователь": {
        "name": "Администратор",
        "имя пользователя": "корень",
        "id": 1,
        "состояние": "активный",
        "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80\u0026d=identicon",
        "web_url": "http: // localhost: 3000 / root"
      }
    },
    {
      "Пользователь": {
        "name": "Нико Картрайт",
        "username": "ryley",
        "id": 2,
        "состояние": "активный",
        "avatar_url": "http: // www.gravatar.com/avatar/cf7ad14b34162a76d593e3affca2adca?s=80\u0026d=identicon ",
        "web_url": "http: // localhost: 3000 / ryley"
      }
    }
  ]
}
  

Отклонить запрос на слияние

История версий
  • Введено в GitLab 9.0.
  • Перемещен на GitLab Premium в версии 13.9.

Если вы утвердили запрос на слияние, вы можете отозвать его, используя следующие конечная точка:

  POST / projects /: id / merge_requests /: merge_request_iid / unapprove
  

Параметры:

Атрибут Тип Требуется Описание
id целое число да ID проекта
merge_request_iid целое число да IID MR

Управление утверждениями приложений в рабочих областях Enterprise Grid

Администратор приложение может утвердить или ограничить установку других приложений во всей организации Enterprise Grid.Приложение обрабатывает управление приложениями для каждой рабочей области в Grid-организации, заменяя процесс пользовательского интерфейса .

Конечно, это может показаться мета-машиной, которую лучше оставить научной фантастике, но приложение для утверждения других приложений может сделать жизнь администраторов намного приятнее и продуктивнее.

Будьте осторожны: когда вы устанавливаете приложение для управления утверждениями приложений в организации Grid, вы должны обрабатывать все утверждения и ограничения приложений с помощью этого приложения, а пользовательский интерфейс на уровне рабочей области Параметры управления приложениями Параметры пользовательского интерфейса будут отключены .

Если вы хотите восстановить пользовательский интерфейс App Management Setting UI, вам необходимо отозвать токен, который вы использовали для утверждения приложений, или полностью удалить приложение для управления приложениями.

Чтобы создать приложение с API для управления приложениями, читайте дальше.

Этот API может использоваться только организациями Enterprise Grid.


Обзор

Когда администратор включает настройку Approve apps в Slack, приложения запрашиваются пользователем Slack и должны быть утверждены администратором, прежде чем они будут фактически установлены для использования командой.

Процесс утверждения помогает администраторам убедиться, что каждое приложение, установленное в рабочей области, заслуживает доверия.

Однако для администраторов Enterprise Grid, обрабатывающих утверждения, запросы приложений для каждой отдельной рабочей области в организации могут отнимать много времени.

Раньше утверждение или ограничение запроса на установку приложения могло происходить только в пользовательском интерфейсе отдельно от клиента Slack.

Теперь утверждением приложений можно управлять с помощью одного приложения для всех рабочих областей .Вместо использования пользовательского интерфейса администраторы Enterprise Grid делегируют работу по утверждению приложению. Приложение может реализовать любую конкретную логику, которую пожелает администратор, например, занести приложение Google Диска в белый список в любой рабочей области.

Когда вы используете приложение для управления приложениями с помощью этого API, оно заменяет пользовательский интерфейс управления приложениями. Параметр Утверждать приложения автоматически включается для каждого рабочего пространства.

Этот API может использоваться только организациями Enterprise Grid.

Перейдите к более подробному описанию управления приложениями.


Установка с прицелами

Две области позволяют приложению управлять утверждениями установки приложений в организации Enterprise Grid: admin.apps: читать и admin.apps: писать .

Все области admin. * получены с использованием обычного потока OAuth, но есть несколько дополнительных требований. Установка OAuth должна быть инициирована администратором Enterprise Grid или владельцем . Кроме того, установка должна происходить в организации Enterprise Grid, а не в отдельном рабочем пространстве с использованием переключателя рабочего пространства во время процесса установки.

См. Дополнительную информацию в документации по применению.


Прослушивание с событием

app_requested

Теперь, когда у вас есть приложение для управления, начинайте прислушиваться к запросам на установку приложения. Событие app_requested из API событий уведомляет ваше приложение именно об этих запросах. Он запускается каждый раз, когда пользователь из любой команды вашей грид-организации запрашивает установку приложения.

Подпишитесь на событие app_requested , перейдя на страницу своего приложения и щелкнув Event Subscriptions на левой боковой панели.Кнопка Добавить событие рабочей области приведет вас к событию app_requested . Чтобы подписка вступила в силу, вам необходимо переустановить приложение.

Вот усеченная форма события app_requested :

  {
  "type": "app_requested",
  "app_request": {
      'id': строка,
      'приложение': {
        'id': строка,
        'имя': строка,
        'описание': строка,
        'help_url': строка,
        'privacy_policy_url': строка,
        'app_homepage_url': строка,
        'app_directory_url': строка,
        'is_app_directory_approved': логическое,
        'is_internal': логическое,
        'дополнительная_инфо':? строка
      },
      ...
  }
}
  

В дополнение к полю app , содержащему информацию о запрошенном приложении, вы также увидите некоторые другие полезные поля, некоторые из которых не всегда появляются, если они не актуальны:

  • previous_resolution дает информацию о том, было ли приложение одобрено или ограничено ранее.
  • пользователь предоставляет информацию о пользователе, запросившем установку.
  • team предоставляет информацию о команде, для которой пользователь запросил установку.
  • scopes предоставляет информацию об областях, которые запрошенная установка предоставит для вашей рабочей области.

Полный пример полезной нагрузки события app_requested см. На странице app_requested .

Когда вы внимательно прислушаетесь к запросам на установку приложений, читайте дальше, чтобы узнать, как реагировать.


Управление с помощью

утверждать и ограничивать методов

Утвердить запрос на установку приложения

Подтвердите запрос приложения с помощью метода Утвердить :

  curl -F токен = xoxp-... -F team_id = T9876 -F request_id = 1234 https://slack.com/api/admin.apps.approve
  

Токен, конечно, необходим, и он должен быть наполнен областью admin.apps: напишите . Следуйте инструкциям в документации по для получения административной области.

Вы можете использовать request_id или app_id , чтобы определить, какое приложение одобрять. Либо можно получить непосредственно из события app_requested , описанного выше, либо из метода list , описанного ниже.Также требуется team_id : он указывает, для какой рабочей области приложение должно быть одобрено.

Вы получите ответ "ok": true , когда ваше одобрение будет успешным.

Ограничить запрос на установку приложения

Аналогичным образом ограничьте (другими словами, запретите) установку приложения с помощью метода restrict :

  curl -F token = xoxp -... -F request_id = 1234 https://slack.com/api/admin.apps.restrict
  

Как и выше, токен является обязательным и должен быть прописан администратором .приложения: напишите область . Следуйте инструкциям в документации по для получения административной области. Либо request_id , либо app_id также требуется, чтобы определить, какое приложение следует ограничить, а также team_id .

Вы получите ответ "ok": true , когда ваше ограничение будет успешным.

Список запросов на установку приложения

Используйте метод list , чтобы просмотреть ожидающие запросы на установку приложения.Метод list показывает только те запросы, которые еще не были одобрены или ограничены вашим приложением.

  curl -F token = xoxp -... -F team_id = T9876 https://slack.com/api/admin.apps.requests.list
  

Вы получите ответ, содержащий список из app_requests , каждый из которых идентичен тому, что находится в полезной нагрузке события app_requested , описанной выше.


Пример приложения

Если вы ищете пример приложения, использующего эти методы, не ищите ничего, кроме этого приложения, созданного Slack на Github.


Напутствие

Утверждение

приложений вселяет уверенность в безопасности организации Slack. Однако управление приложениями для каждой рабочей области в грид-организации может занять время и отвлечь внимание от наиболее важных задач.

Используйте API-интерфейсы для управления приложениями, чтобы создать приложение, автоматизирующее управление приложениями, и получите душевное спокойствие без трудоемкой ручной работы. Следите за новостями, так как Slack продолжает стремиться сделать жизнь администраторов еще более приятной и продуктивной.

Разработка рабочих процессов утверждения | Slack

Варианты использования:
  • Блокировка объявлений
  • Редакционный контроль
Работает с:
  • API событий
  • Модалы
  • Внутренняя интеграция
  • Модалы

Разрешить людям публиковать объявления с ограниченным доступом время от времени, с одобрения администратора. Этот бот отправляет запросы группе администраторов на утверждение и публикует объявления от имени автора после утверждения.

Как это работает

1. Получите прямое сообщение

Чтобы узнать, когда пользователь отправляет прямые сообщения боту приложения, нам необходимо подписаться на событие бота im.message , отправляемое через API событий. API событий отправляет запрос POST на указанный URL-адрес всякий раз, когда определенные события происходят в рабочей области Slack. В случае события бота im.message Slack отправит событие, как только бот приложения получит прямое сообщение. Событие будет включать информацию как о сообщении, так и об отправившем его пользователе.

2. Откройте модальное окно

Как только пользователь отправляет боту прямое сообщение, бот отвечает кнопкой, чтобы начать новое объявление. Когда пользователь нажимает эту кнопку, бот получит запрос на свою конечную точку интерактивных компонентов. Используя trigger_id в этой полезной нагрузке, бот может позвонить в конечную точку views.open , чтобы открыть модальное окно с пользователем. Пользователь может создать свое объявление в этом модальном окне и отправить его боту. Чтобы включить интерактивные функции, такие как кнопки и модальные окна, вам необходимо включить интерактивные компоненты в настройках приложения и указать URL-адрес.

3. Просмотрите сообщение

Когда бот получит модальное сообщение, бот ответит на прямое сообщение с предварительным просмотром того, что это объявление хочет, используя метод chat.postMessage . Приложение также добавит к сообщению кнопку «отправить запрос». Пользователь может нажать эту кнопку, чтобы отправить запрос администратору на утверждение.

4. Отправьте сообщение утверждающему

Когда пользователь нажимает кнопку «отправить запрос», приложение получает запрос POST в своей конечной точке интерактивного сообщения.Запрос будет включать сведения о том, кто нажал кнопку, содержимое исходного сообщения и URL-адрес ответа. URL-адрес ответа может использоваться приложением для обновления содержимого исходного сообщения с помощью HTTP-запроса с полезной нагрузкой JSON. Когда запрос действия сообщения получен, бот отправляет прямое сообщение заранее определенному утверждающему с просьбой либо «принять», либо «отклонить» сообщение с помощью кнопок сообщений. В то же время он отправляет обновление пользователю, используя URL-адрес ответа, чтобы сообщить им, что сообщение ожидает утверждения.

5. Позвольте пользователю принять окончательное решение

После утверждения объявления администратором приложение отправляет пользователю сообщение с помощью метода веб-API chat.postMessage . В сообщении отображается обновленный статус утверждения вместе с кнопками «опубликовать объявление» и «отменить».

6. Отправьте сообщение на канал

Когда пользователь готов опубликовать объявление, он может нажать кнопку «Опубликовать объявление», и объявление будет размещено в канале объявлений с использованием чата .postMessage и токен носителя установщика. Затем приложение может заменить свое собственное сообщение «опубликовать объявление» для пользователя подтверждением того, что оно было опубликовано, и, при необходимости, ссылкой на само объявление.

Чтобы публиковать сообщения в ограниченном канале, этот тип приложения должен быть установлен либо администратором группы, утверждающим, либо пользователем с разрешениями на публикацию в этом канале.

Предложения по настройке

  • Разрешить несколько утверждающих
  • Позвольте пользователю выбрать, на каком ограниченном канале он хочет публиковать сообщения
  • Разрешить пользователю выбирать из заранее определенного списка утверждающих
  • Публикация журналов утверждения в общедоступном канале

Другие варианты использования

  • Разрешить командам внутренних коммуникаций публиковать сообщения от имени руководителей
  • Другие рабочие процессы утверждения, такие как PTO, спонсорство конференций и т. Д.

Схема

Сопутствующая документация

Утверждение объявлений

Каждый раз, когда создается или редактируется объявление, оно может быть одобрено или отправлено одним или несколькими «поставщиками». Примеры продавцов:

  • И Google, и AppNexus требуют, чтобы все объявления были отправлены на проверку качества до показа
  • Beeswax будет использовать систему упреждающего сканирования вредоносных программ, чтобы убедиться, что объявления не содержат вредоносный код
  • Поставщикам средств измерения, таким как Nielsen и Comscore, необходимо зарегистрировать креативы, чтобы их можно было отслеживать.

В этом документе описывается, как работает процесс утверждения и как использовать API для проверки статуса утверждения.

Процесс утверждения объявления запускается при любом из следующих событий:

  • Сначала создается креатив со всеми ресурсами, необходимыми для его показа. Например, если объявление ожидает перекодированного видео, оно еще не будет допущено к показу.
  • Объявление creative_content каким-либо образом изменено или URL перехода по клику изменен.Поля, не относящиеся к содержанию, такие как примечания или название объявления, не будут вызывать повторного утверждения.
  • Объявление удалено
  • Активное объявление становится неактивным или неактивное становится активным

Список всех поставщиков Creative Approval доступен в таблице creative_approval_vendors , доступной с помощью GET:

cURL

  curl -X GET "http: / [path] / rest / view" -b cookies.txt -d '{"view_name": "creative_approval_vendors"}'
  

Набор поставщиков, которые будут поставлены в очередь для любого данного утверждения, зависит от creative_type объявления, от того, помечен ли поставщик как , требуется , и запрашивались ли пользователем дополнительные, необязательные поставщики:

  • Если поставщик отмечен как обязательный и creative_type соответствует объявлению (или имеет значение -1), он будет отправлен на утверждение.

Поставщики, которые не требуются, например поставщик измерений, могут быть запрошены, добавив декларацию поставщика к творческим атрибутам объявления, как показано ниже:

JSON

  {"разрешение":
 {"vendor_id":
  [1,2]
 }
}
  

Новый объект «Очередь утверждения объявлений» создается для каждого подходящего поставщика для каждого объявления, статус которого устанавливается на ноль ( NOT_SUBMITTED ).

Список доступных статусов объявлений можно найти в представлении creative_status :

cURL

  curl -X GET "http: / [path] / rest / view" -b cookies.txt -d '{"view_name": "creative_status"}'
  

Список текущей очереди одобрения объявления можно найти следующим образом:

cURL

  curl -X GET "http: / [path] / rest / creative_approval_queue" -b cookies.txt -d '{"creative_id": }
  

Запись в очереди может иметь действие, которое отражает, что отправлять поставщику. Допустимые действия включают:

  • CREATE: отправляется при первом создании объявления или при изменении содержимого
  • PAUSE: отправляется, когда объявление было ранее одобрено, но теперь установлено как неактивное
  • RESUME: отправляется, когда объявление было ранее приостановлено, но теперь активировано
  • DELETE: при удалении объявления

Эти действия необходимы, потому что поставщики вредоносного ПО, например, постоянно сканируют объявления, пока мы не прикажем им остановиться, и взимают с нас плату за сканирование.Для других поставщиков, таких как Google, единственное необходимое действие — СОЗДАТЬ.

Buzz выполняет дедупликацию запросов в случае, если пользователь выполняет несколько действий с объявлением перед отправкой утверждения поставщику. Например, если пользователь несколько раз активирует и деактивирует объявление, будет отправлено только одно сообщение «ПАУЗА» или «ВОЗОБНОВЛЕНИЕ».

Периодически запускается процесс отправки любых объектов CreativeApprovalQueue со статусом NOT_SUBMITTED в соответствующие API поставщиков утверждения.В результате этого процесса статус записей CreativeApprovalQueue устанавливается на 1, PENDING или 5, ERROR .

Другой периодический процесс проверяет статус ранее отправленных объявлений с помощью request_status из 1. Если поставщик завершил свой процесс и предоставил полезный ответ, записи CreativeApprovalQueue обновляются до состояния 2, APPROVED или 4, REJECTED и любые текстовые сообщения, относящиеся к процессу, хранятся в поле author_message объекта creative_approval_queue_history.

Некоторые источники инвентаря, такие как Google и Appnexus, не разрешают запуск Creative до тех пор, пока они не будут предварительно одобрены. В результате Buzz сохраняет статус одобрения креатива для различных источников ресурсов в поле Creative creative_attributes , и участник торгов не будет показывать эти объявления до тех пор, пока они не будут отмечены как «одобренные».

Поставщики, отмеченные как , требуется , у которых также есть заданное поле inventory_source , будут автоматически перечислены как в ожидании в атрибутах объявления всякий раз, когда создается или редактируется объявление.Например, если необходимы оба inventory_sources 1 и 2, при первом создании Creative в атрибутах creative_attributes будет записана следующая запись:

JSON

  {"утверждение": {"inventory_source": {"pending": [1,2]}}}
  

Когда CreativeApprovalQueue помечен как APPROVED или REJECTED , если поставщик, которому принадлежит запись очереди, имеет связанный inventory_source , тогда атрибут поставщика утверждения для этого источника обновляется со следующим синтаксисом:

JSON

  {"утверждение": {"inventory_source": {"Approved": [], "rejected": []}}}
  

При изменении объявления, которое ранее было одобрено для данного источника инвентаря, статус в атрибуте объявления снова меняется на PENDING .

Объект Creative включает поле creative_status_id , которое доступно только для чтения для пользователей. Поле creative_status_id интерпретируется участником торгов как «допущено к показу», где 0 = не допущено, а 1 = допущено. Это переопределяет активный флаг, поэтому креатив с активным = 1 и creative_status_id = 0 не будет отображаться.

По умолчанию Живая лента устанавливает для creative_status_id значение 1 для всех объявлений.

Если сканирование вредоносных программ устанавливает для утверждения объявления статус 10, ПОДОЗРЕНИЕ , creative_status_id будет иметь значение 0, что означает, что он не может быть показан.Невозможно установить для creative_status_id значение 1 без помощи администратора, что приведет к невозможности показа или редактирования объявления с помощью пользовательского интерфейса или API.

Объект CreativeApprovalQueue содержит текущий активный запрос и / или ответ на утверждение. Если пользователь меняет объявление несколько раз, может быть полезно просмотреть историю запросов на одобрение. Второй объект, creative_approval_queue_history, содержит эти данные и доступен только для чтения. Чтобы ПОЛУЧИТЬ историю отдельного объявления:

cURL

  curl -X GET "http: / [path] / rest / creative_approval_queue_history" -b cookies.txt -d '{"creative_id": }
  

API для установки глобальных напоминаний и политик эскалации для утверждения запросов на доступ

Если утверждающий, назначенный для запроса доступа, не предпринял с ним действий, вам потребуется возможность автоматически напоминать ему, что требуется его проверка. Если прошло слишком много времени, вы должны иметь возможность обострить проблему, отправив информацию тому, кто может обеспечить соблюдение вашей политики утверждения.

В этом документе описывается, как настроить эти напоминания и эскалации глобально для вашего сайта IdentityNow.

ПРИМЕЧАНИЯ :

  • По умолчанию напоминания и эскалации не отправляются.
  • Если вы выполняете эти вызовы API, вам необходимо использовать один из поддерживаемых нами методов аутентификации. SailPoint рекомендует использовать OAuth 2. Подробную информацию см. В разделе Метод аутентификации для вызовов API.
  • Конечная точка, которую вы используете, должна быть немного изменена в зависимости от метода аутентификации. Инструкции см. В разделе URL-адреса конечных точек на основе метода аутентификации.

СОДЕРЖАНИЕ :

API

Вызов API для установки политики напоминаний и эскалации:

PATCH / v2 / org

Должен быть включен следующий JSON:

  • daysTillEscalation — количество дней с момента создания запроса до начала процесса напоминания / эскалации.
  • daysBetweenReminders — количество дней между напоминаниями или эскалациями.
  • maxReminders — максимальное количество напоминаний, отправленных до начала процесса эскалации.
  • fallbackApprover — Псевдоним удостоверения, которое будет проверять запрос, если его никто не проверяет. Обычно это имя пользователя удостоверения SailPoint, но в некоторых случаях может потребоваться предоставить UID. Чтобы определить правильное значение для любого конкретного идентификатора, используйте описанный здесь API идентификаторов.

Задача выполняется в фоновом режиме ежедневно в 12 часов утра по всемирному координированному времени, чтобы определить, соответствуют ли какие-либо утверждения критериям для отправки напоминания или эскалации.

Например:

{

«ApprovalConfig»: {

«daysTillEscalation»: 3,

«daysBetweenReminders»: 2,

«maxReminders»: 2,

«fallbackApprover»: «support»

}

}

После успешного звонка вы увидите следующие результаты:

ВАЖНО : указание значения 0 для любого из этих параметров политики эскалации приведет к следующим результатам:

дней Напоминание не будет отправлено и эскалация не будет.
дней между напоминанием После первого напоминания дополнительные напоминания отправляться не будут и эскалация не будет.
max Напоминания Перед эскалацией напоминание не будет отправлено

Модель эскалации

Когда критерии эскалации выполнены, электронное письмо с эскалацией отправляется следующим людям в системе по порядку:

  • Утверждающий 2 — Менеджер первоначального утверждающего
  • Утверждающий 3 — руководитель 2-го уровня первоначального утверждающего
  • Подтверждающий резерв — лицо, назначенное этим API для выполнения запроса, если все предыдущие утверждающие не уложились в срок

ПРИМЕЧАНИЕ: Если вы определите политику эскалации для принудительного утверждения в IdentityNow, это может привести к уникальному рабочему процессу, в котором запрос будет передан исходному человеку, который запросил доступ (для себя или от имени другого), по существу преодоление действующего ограничения, чтобы этого не произошло.

Пример ответа системы

При следующих настройках политики вы увидите напоминания, созданные по расписанию, указанному в таблице ниже.

«ApprovalConfig»: {

«daysTillEscalation»: 3,

«daysBetweenReminders»: 1,

«maxReminders»: 3,

«fallbackApprover»: «support»

График напоминаний и эскалации

, утверждающему отправляется электронное письмо.
День Действие Эскалация или напоминание
0 Создается исходное электронное письмо с просьбой к назначенному утверждающему проверить запрос NA
3 По истечении периода, определенного daysTillEscalation Первое напоминание
4 Утверждающему отправлено электронное письмо Второе напоминание
5 Утверждающему отправлено электронное письмо Последнее напоминание
6 Утверждающему 2 отправлено сообщение об эскалации. Первое сообщение
7 Письмо отправлено утверждающему 2 Первое напоминание
8 Письмо отправлено утверждающему 2 Второе напоминание
9 Письмо отправлено утверждающему 2 Последнее напоминание
10 Утверждающему 3 отправлено электронное письмо с запросом на эскалацию. Вторая эскалация
11 Сообщение отправлено утверждающему 3 Первое напоминание
12 Сообщение отправлено утверждающему 3 Второе напоминание
13 Сообщение отправлено утверждающему 3 Последнее напоминание
14 Сообщение об эскалации отправлено лицу, утверждающему запасной вариант Окончательная эскалация

Никакие дополнительные электронные письма после этого момента не отправляются, и утверждение продолжает ждать Подтверждающего резервирования неопределенное время.

Автор: alexxlab

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *