트리거 업데이트

PUT /groups/{groupId}/apps/{appId}/triggers/{triggerId}

tokenAuth

애플리케이션에서 기존 트리거를 수정합니다.

경로 매개변수

groupId 문자열 필수 사항

Atlas 프로젝트/그룹 ID입니다.
appId 문자열 필수 사항

애플리케이션의 ObjectID입니다. App Services API 프로젝트 및 애플리케이션 ID 섹션은 이 값을 찾는 방법을 보여줍니다.
triggerId 문자열 필수 사항

트리거의 고유한 _id 값입니다.

application/json

body 객체 필수 사항

업데이트된 트리거 구성입니다.

_id 문자열

트리거의 고유 ID입니다.
이름 문자열 필수 사항

트리거의 이름입니다.
유형 문자열 필수 사항

트리거 유형입니다. 데이터베이스 트리거의 경우 이 값은 항상 "DATABASE"입니다.

값은 DATABASE입니다.
비활성화 부울

true인 경우 트리거가 비활성화되고 이벤트를 수신하거나 실행되지 않습니다.

기본값은 false 입니다.
config 객체 필수 사항

트리거에 대한 구성 값을 정의하는 객체입니다.
구성 속성 숨기기 구성 속성 표시 객체
- service_id 문자열 필수 사항
  
  감시된 컬렉션 포함하는 연결된 MongoDB 데이터 소스 의 _id 값입니다.
  
  모든 서비스 가져오기 엔드포인트를 사용하여 서비스를 나열할 수 있습니다.
  
  데이터 소스는 type 이 'mongodb-atlas'인 서비스입니다. 트리거하다 에 연결하려는 데이터 소스 에 대해 _id 값을 사용합니다.
- database 문자열
  
  연결된 데이터 소스 에 있는 데이터베이스 의 이름입니다. 이 매개변수를 생략하면 소스 유형이 '배포'로 변경됩니다. 그러나 공유 계층 인프라는 배포서버 변경 스트림을 지원 하지 않습니다. ' 데이터베이스' 매개 변수를 생략하면 ' 배포서버 변경 스트림은 공유 계층 클러스터에서 지원되지 않습니다' 오류가 발생합니다. 이 오류를 해결하려면 데이터베이스 매개변수를 제공하세요.
- 컬렉션 문자열
  
  지정된 데이터베이스 에 있는 컬렉션 의 이름입니다. 트리거하다 이 컬렉션 에서 이벤트를 수신 대기합니다. 이 매개변수를 생략하면 소스 유형이 '데이터베이스'로 변경됩니다.
- operation_types array[string] 필수 사항
  트리거하다 수신 대기하는 MongoDB 변경 이벤트 의 유형입니다.
  
  모든 트리거에 유효한 작업 유형은 다음과 같습니다.
  
  "INSERT"
  
  "UPDATE"
  
  "REPLACE"
  
  "DELETE"
  
  데이터베이스 및 배포서버 트리거에 유효한 추가 작업 유형은 다음과 같습니다.
  
  "CREATE_COLLECTION"
  
  "MODIFY_COLLECTION"
  
  "RENAME_COLLECTION"
  
  "DROP_COLLECTION"
  
  "SHARD_COLLECTION"
  
  "RESHARD_COLLECTION"
  
  "REFINE_COLLECTION_SHARD_KEY"
  
  배포서버 트리거에 유효한 추가 작업 유형은 다음과 같습니다.
  
  "DROP_DATABASE"
  
  자세한 내용은 트리거하다 구성을 참조하세요.
  요소가 1 개 이상이어야 합니다.
- match 객체
  
  $match 표현식 변경 이벤트를 필터링합니다. 트리거하다 지정된 변경 이벤트 에 대해 표현식 true로 평가되는 경우에만 실행됩니다.
- 프로젝트 객체
  
  $ 프로젝트 표현식 지정된 필드만 반환합니다. 특정 필드를 포함 또는 제외하거나 새로 계산된 필드를 포함할 수 있습니다.
- full_document 부울
  
  인 경우 true UPDATE 변경 이벤트에 필드 에 있는 수정된 문서 의 최신 과반수 커밋 버전이 포함되어야 함을 나타냅니다.fullDocument
  
  기본값은 false 입니다.
- full_document_before_change 부울
  
  true인 경우 UPDATE 변경 이벤트에 업데이트 적용되기 직전에 수정된 문서 의 스냅샷 포함되어야 함을 나타냅니다.
  
  이러한 스냅샷을 포함하려면 클러스터에 대한 문서 사전 이미지를 활성화 해야 합니다.
  
  기본값은 false 입니다.
- skip_catchup_events 부울
  
  true인 경우, 트리거하다 비활성화한 후 활성화하면 트리거하다 비활성화된 동안 발생한 이벤트가 호출되지 않습니다.
  
  기본값은 false 입니다.
- tolerate_resume_errors 부울
  
  true인 경우 클러스터의 oplog 에서 이 트리거의 재개 토큰을 찾을 수 없는 경우 트리거하다 다음번 관련 변경 스트림 이벤트 에서 이벤트 처리 자동으로 재개합니다. 트리거하다 일시 중단된 시점부터 트리거하다 다시 실행될 때까지의 모든 변경 스트림 이벤트에는 트리거하다 실행되지 않습니다.
  
  기본값은 false 입니다.
- maximum_throughput 부울
  
  true인 경우 트리거하다 처리량 최대화 옵션을 사용합니다.
  
  기본값은 false 입니다.
- 순서 지정되지 않음 부울
  
  true인 경우 이벤트 순서 지정이 비활성화되고 이 트리거하다 이벤트를 병렬로 프로세스 할 수 있습니다. false인 경우 이벤트 순서 지정이 활성화되고 트리거하다 이벤트를 순차적으로 실행합니다.
  
  기본값은 false 입니다.
function_id 문자열

트리거가 실행될 때 호출하는 함수의 ID입니다.

이 값은 event_processors.FUNCTION.function_id와 동일합니다. 여기 또는 event_processors.FUNCTION.function_id에 값을 정의할 수 있습니다. App Services 백엔드는 정의하지 않은 구성 위치에 값을 복제합니다.

예를 들어, function_id를 정의하면 백엔드는 이를 event_processors.FUNCTION.function_id에 복제합니다.

function_id을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_id 또는 event_processors 중 하나를 제공해야 합니다.
function_name 문자열

트리거가 실행될 때 호출하는 함수의 이름입니다. 즉, function_id에서 설명된 함수입니다.

이 값은 event_processors.FUNCTION.function_name와 동일합니다. 여기 또는 event_processors.FUNCTION.function_name에 값을 정의할 수 있습니다. App Services 백엔드는 정의하지 않은 구성 위치에 값을 복제합니다.

예를 들어, function_name를 정의하면 백엔드는 이를 event_processors.FUNCTION.function_name에 복제합니다.

function_name을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_name 또는 event_processors 중 하나를 제공해야 합니다.
event_processors 객체 필수 사항

객체의 각 필드 이름이 이벤트 프로세서 ID이고 각 값이 해당 이벤트 프로세서를 구성하는 객체입니다. 구성 객체 예시는 AWS EventBridge에 트리거 이벤트 전송을 참조하세요.
event_processors 속성 숨기기 event_processors 속성 표시 객체
- 기능 객체
  FUNCTION 속성 숨기기 FUNCTION 속성 표시 객체
  
  config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  function_id 문자열
  
  트리거가 실행될 때 호출하는 함수의 ID입니다.
  
  이 값은 루트 수준 function_id와 동일합니다. 여기 또는 function_id에서 값을 정의할 수 있습니다. App Services 백엔드 정의하지 않은 구성 위치 에 값을 복제합니다.
  
  예를 들어, event_processors.FUNCTION.function_id를 정의하면 백엔드는 이를 function_id에 복제합니다.
  
  function_id을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_id 또는 event_processors 중 하나를 제공해야 합니다.
  
  function_name 문자열
  
  트리거가 실행될 때 호출하는 함수의 이름입니다. 즉, function_id에서 설명된 함수입니다.
  
  이 값은 루트 수준 function_name와 동일합니다. 여기 또는 function_name에서 값을 정의할 수 있습니다. App Services 백엔드 정의하지 않은 구성 위치 에 값을 복제합니다.
  
  예를 들어, event_processors.FUNCTION.function_name를 정의하면 백엔드는 이를 function_name에 복제합니다.
  
  function_name을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_name 또는 event_processors 중 하나를 제공해야 합니다.
- AWS_EVENTBRIDGE 객체
  AWS_EVENTBRIDGE 속성 숨기기 AWS_EVENTBRIDGE 속성 표시 객체
  
  config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  account_id 문자열
  
  Amazon Web Services 계정 ID.
  
  리전 문자열
  
  AWS 리전입니다.
  
  Extended_json_enabled 부울
  
  true인 경우 이벤트 객체가 EJSON을 사용하여 직렬화됩니다.
  
  기본값은 false 입니다.
Error_Handler 객체

AWS EventBridge 트리거에 대한 사용자 지정 오류 처리를 정의하는 객체입니다. "AWS_EVENTBRIDGE" 이벤트 프로세서가 있는 Atlas Triggers 유형 "DATABASE" 에만 유효합니다.
error_handler 속성 숨기기 error_handler 속성 표시 객체
- config 객체
  구성 속성 숨기기 구성 속성 표시 객체
  
  활성화됨 부울
  
  'true'이면 AWS Eventbridge 트리거하다 에 대해 사용자 지정 오류 처리가 활성화됩니다.
  
  function_id 문자열
  
  AWS Eventbridge 트리거하다 실패하여 성공적으로 재시도할 수 없을 때 호출되는 함수의 ID .

_id 문자열

트리거의 고유 ID입니다.
이름 문자열 필수 사항

트리거의 이름입니다.
유형 문자열 필수 사항

트리거하다 유형입니다. 인증 트리거의 경우 이 값은 항상 "AUTHENTICATION"입니다.

값은 AUTHENTICATION입니다.
비활성화 부울

true인 경우 트리거가 비활성화되고 이벤트를 수신하거나 실행되지 않습니다.

기본값은 false 입니다.
config 객체 필수 사항

트리거에 대한 구성 값을 정의하는 객체입니다.
구성 속성 숨기기 구성 속성 표시 객체
- operation_type 문자열 필수 사항
  
  트리거하다 수신 대기하는 인증 이벤트 의 유형입니다.
  
  값은 LOGIN, CREATE 또는 DELETE입니다.
- providers 문자열 필수 사항
  
  트리거하다 수신 대기하는 인증 제공자 의 유형입니다.
  
  값은 anon-user, api-key, custom-token, custom-function, local-userpass, oauth2-apple, oauth2-facebook 또는 oauth2-google입니다.
function_id 문자열

트리거가 실행될 때 호출하는 함수의 ID입니다.

이 값은 event_processors.FUNCTION.function_id와 동일합니다. 여기 또는 event_processors.FUNCTION.function_id에 값을 정의할 수 있습니다. App Services 백엔드는 정의하지 않은 구성 위치에 값을 복제합니다.

예를 들어, function_id를 정의하면 백엔드는 이를 event_processors.FUNCTION.function_id에 복제합니다.

function_id을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_id 또는 event_processors 중 하나를 제공해야 합니다.
function_name 문자열

트리거가 실행될 때 호출하는 함수의 이름입니다. 즉, function_id에서 설명된 함수입니다.

이 값은 event_processors.FUNCTION.function_name와 동일합니다. 여기 또는 event_processors.FUNCTION.function_name에 값을 정의할 수 있습니다. App Services 백엔드는 정의하지 않은 구성 위치에 값을 복제합니다.

예를 들어, function_name를 정의하면 백엔드는 이를 event_processors.FUNCTION.function_name에 복제합니다.

function_name을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_name 또는 event_processors 중 하나를 제공해야 합니다.
event_processors 객체 필수 사항

객체의 각 필드 이름이 이벤트 프로세서 ID이고 각 값이 해당 이벤트 프로세서를 구성하는 객체입니다. 구성 객체 예시는 AWS EventBridge에 트리거 이벤트 전송을 참조하세요.
event_processors 속성 숨기기 event_processors 속성 표시 객체
- 기능 객체
  FUNCTION 속성 숨기기 FUNCTION 속성 표시 객체
  
  config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  function_id 문자열
  
  트리거가 실행될 때 호출하는 함수의 ID입니다.
  
  이 값은 루트 수준 function_id와 동일합니다. 여기 또는 function_id에서 값을 정의할 수 있습니다. App Services 백엔드 정의하지 않은 구성 위치 에 값을 복제합니다.
  
  예를 들어, event_processors.FUNCTION.function_id를 정의하면 백엔드는 이를 function_id에 복제합니다.
  
  function_id을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_id 또는 event_processors 중 하나를 제공해야 합니다.
  
  function_name 문자열
  
  트리거가 실행될 때 호출하는 함수의 이름입니다. 즉, function_id에서 설명된 함수입니다.
  
  이 값은 루트 수준 function_name와 동일합니다. 여기 또는 function_name에서 값을 정의할 수 있습니다. App Services 백엔드 정의하지 않은 구성 위치 에 값을 복제합니다.
  
  예를 들어, event_processors.FUNCTION.function_name를 정의하면 백엔드는 이를 function_name에 복제합니다.
  
  function_name을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_name 또는 event_processors 중 하나를 제공해야 합니다.
- AWS_EVENTBRIDGE 객체
  AWS_EVENTBRIDGE 속성 숨기기 AWS_EVENTBRIDGE 속성 표시 객체
  
  config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  account_id 문자열
  
  Amazon Web Services 계정 ID.
  
  리전 문자열
  
  AWS 리전입니다.
  
  Extended_json_enabled 부울
  
  true인 경우 이벤트 객체가 EJSON을 사용하여 직렬화됩니다.
  
  기본값은 false 입니다.

_id 문자열

트리거의 고유 ID입니다.
이름 문자열 필수 사항

트리거의 이름입니다.
유형 문자열 필수 사항

트리거하다 유형입니다. 예약된 트리거의 경우 이 값은 항상 "SCHEDULED"입니다.

값은 SCHEDULED입니다.
비활성화 부울

true인 경우 트리거가 비활성화되고 이벤트를 수신하거나 실행되지 않습니다.

기본값은 false 입니다.
config 객체 필수 사항

트리거에 대한 구성 값을 정의하는 객체입니다.
구성 속성 숨기기 구성 속성 표시 객체
- 예정 문자열 필수 사항
  
  트리거 하다 실행되는 시점을 지정하는 크론 표현식 입니다.
- skip_catchup_events 부울
  
  true인 경우, 트리거하다 비활성화한 후 활성화하면 트리거하다 비활성화된 동안 발생한 이벤트가 호출되지 않습니다.
function_id 문자열

트리거가 실행될 때 호출하는 함수의 ID입니다.

이 값은 event_processors.FUNCTION.function_id와 동일합니다. 여기 또는 event_processors.FUNCTION.function_id에 값을 정의할 수 있습니다. App Services 백엔드는 정의하지 않은 구성 위치에 값을 복제합니다.

예를 들어, function_id를 정의하면 백엔드는 이를 event_processors.FUNCTION.function_id에 복제합니다.

function_id을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_id 또는 event_processors 중 하나를 제공해야 합니다.
function_name 문자열

트리거가 실행될 때 호출하는 함수의 이름입니다. 즉, function_id에서 설명된 함수입니다.

이 값은 event_processors.FUNCTION.function_name와 동일합니다. 여기 또는 event_processors.FUNCTION.function_name에 값을 정의할 수 있습니다. App Services 백엔드는 정의하지 않은 구성 위치에 값을 복제합니다.

예를 들어, function_name를 정의하면 백엔드는 이를 event_processors.FUNCTION.function_name에 복제합니다.

function_name을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_name 또는 event_processors 중 하나를 제공해야 합니다.
event_processors 객체 필수 사항

객체의 각 필드 이름이 이벤트 프로세서 ID이고 각 값이 해당 이벤트 프로세서를 구성하는 객체입니다. 구성 객체 예시는 AWS EventBridge에 트리거 이벤트 전송을 참조하세요.
event_processors 속성 숨기기 event_processors 속성 표시 객체
- 기능 객체
  FUNCTION 속성 숨기기 FUNCTION 속성 표시 객체
  
  config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  function_id 문자열
  
  트리거가 실행될 때 호출하는 함수의 ID입니다.
  
  이 값은 루트 수준 function_id와 동일합니다. 여기 또는 function_id에서 값을 정의할 수 있습니다. App Services 백엔드 정의하지 않은 구성 위치 에 값을 복제합니다.
  
  예를 들어, event_processors.FUNCTION.function_id를 정의하면 백엔드는 이를 function_id에 복제합니다.
  
  function_id을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_id 또는 event_processors 중 하나를 제공해야 합니다.
  
  function_name 문자열
  
  트리거가 실행될 때 호출하는 함수의 이름입니다. 즉, function_id에서 설명된 함수입니다.
  
  이 값은 루트 수준 function_name와 동일합니다. 여기 또는 function_name에서 값을 정의할 수 있습니다. App Services 백엔드 정의하지 않은 구성 위치 에 값을 복제합니다.
  
  예를 들어, event_processors.FUNCTION.function_name를 정의하면 백엔드는 이를 function_name에 복제합니다.
  
  function_name을(를) 정의하는 경우 event_processors 이(가) 필요하지 않습니다. 트리거하다 업데이트할 때 function_name 또는 event_processors 중 하나를 제공해야 합니다.
- AWS_EVENTBRIDGE 객체
  AWS_EVENTBRIDGE 속성 숨기기 AWS_EVENTBRIDGE 속성 표시 객체
  
  config 객체
  
  구성 속성 숨기기 구성 속성 표시 객체
  
  account_id 문자열
  
  Amazon Web Services 계정 ID.
  
  리전 문자열
  
  AWS 리전입니다.
  
  Extended_json_enabled 부울
  
  true인 경우 이벤트 객체가 EJSON을 사용하여 직렬화됩니다.
  
  기본값은 false 입니다.

응답

204

트리거가 성공적으로 업데이트되었습니다.
409 application/json

트리거를 업데이트하는 동안 오류가 발생했습니다.
응답 속성 숨기기 응답 속성 표시 객체
- 오류 문자열
  
  오류를 설명하는 메시지입니다.
- error_code 문자열
  
  오류 유형입니다.

PUT /groups/{groupId}/apps/{appId}/triggers/{triggerId}

curl \
 --request PUT 'https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/triggers/{triggerId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"name":"onNewEmployee","type":"DATABASE","config":{"match":{},"project":{},"database":"HR","collection":"employees","service_id":"5adeb649b8b998486770ae7c","full_document":true,"operation_types":["INSERT"]},"function_id":"5eea9ca4ca0e356e2c2a148a","event_processors":{"FUNCTION":{"config":{"function_id":"6841b8d3e71dc81bed89dbba","function_name":"Atlas_Triggers_DatabaseInsert_1749137618"}}}}'

요청 예시

{
  "name": "onNewEmployee",
  "type": "DATABASE",
  "config": {
    "match": {},
    "project": {},
    "database": "HR",
    "collection": "employees",
    "service_id": "5adeb649b8b998486770ae7c",
    "full_document": true,
    "operation_types": [
      "INSERT"
    ]
  },
  "function_id": "5eea9ca4ca0e356e2c2a148a",
  "event_processors": {
    "FUNCTION": {
      "config": {
        "function_id": "6841b8d3e71dc81bed89dbba",
        "function_name": "Atlas_Triggers_DatabaseInsert_1749137618"
      }
    }
  }
}

{
  "name": "onNewApiKey",
  "type": "AUTHENTICATION",
  "config": {
    "providers": [
      "api-key"
    ],
    "operation_type": "CREATE"
  },
  "function_id": "5eea9ca4ca0e356e2c2a148a",
  "event_processors": {
    "FUNCTION": {
      "config": {
        "function_id": "6841b8d3e71dc81bed89dbba",
        "function_name": "Atlas_Triggers_Auth_Create_1749137618"
      }
    }
  }
}

{
  "name": "createDailyReport",
  "type": "SCHEDULED",
  "config": {
    "schedule": "0 8 * * *"
  },
  "function_id": "5eea9ca4ca0e356e2c2a148a",
  "event_processors": {
    "FUNCTION": {
      "config": {
        "function_id": "6841b8d3e71dc81bed89dbba",
        "function_name": "Atlas_Triggers_Monthly_1749137618"
      }
    }
  }
}

응답 예시(409)

{
  "error": "string",
  "error_code": "string"
}