경로 매개변수

• groupId 문자열 필수 사항

  Atlas 프로젝트/그룹 ID입니다.

• appId 문자열 필수 사항

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

쿼리 매개변수

• 유형 문자열

  반환할 이벤트 구독 유형입니다.

  • DATABASE: 데이터베이스 트리거 반환
  • AUTHENTICATION: 인증 트리거 반환
  • SCHEDULED: 예정된 트리거 반환
  • SYNCTRANSLATOR: Device Sync 번역기 반환

  값은 DATABASE, AUTHENTICATION, SCHEDULED 또는 SYNCTRANSLATOR입니다.

응답

• 200 application/json

  성공하였습니다.

  변경 이벤트 스트림 에 대한 구독 .

  다음 중 하나입니다.

  객체-2 객체 객체-2 객체 객체-2 객체 SyncTranslator 객체

  속성 숨기기 속성 표시

  • _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 입니다.

  속성 숨기기 속성 표시

  • _id 문자열
  • 이름 문자열
  • 유형 문자열

    값은 SYNCTRANSLATOR입니다.

  • function_id 문자열
  • 비활성화 부울
  • config null
  • last_modified 숫자