민감한 데이터 감지 API

민감한 데이터 탐지 API는 정형 데이터의 열과 행에서 민감한 데이터를 탐지하는 데 사용되는 API를 설명합니다.

데이터 유형

• CustomEntityType 구조

CustomEntityType 구조

정형 데이터의 열과 행에서 민감한 데이터를 감지하기 위한 사용자 정의 패턴을 나타내는 객체입니다.

필드

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  나중에 검색하거나 삭제할 수 있는 사용자 정의 패턴의 이름입니다. 이 이름은 AWS 계정별로 고유해야 합니다.

• RegexString – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  사용자 정의 패턴에서 민감한 데이터를 감지하는 데 사용되는 정규식 문자열입니다.

• ContextWords – UTF-8 문자열의 배열입니다(1~20개 문자열).

  컨텍스트 단어 목록입니다. 이러한 컨텍스트 단어가 정규식 주변에서 발견되지 않으면 데이터는 민감한 데이터로 감지되지 않습니다.

  컨텍스트 단어가 전달되지 않으면 정규식만 검사됩니다.

작업

• CreateCustomEntityType 작업(Python: create_custom_entity_type)

• DeleteCustomEntityType 작업(Python: delete_custom_entity_type)

• GetCustomEntityType 작업(Python: get_custom_entity_type)

• BatchGetCustomEntityTypes 작업(Python: batch_get_custom_entity_types)

• ListCustomEntityTypes 작업(Python: list_custom_entity_types)

CreateCustomEntityType 작업(Python: create_custom_entity_type)

정형 데이터의 열과 행에서 민감한 데이터를 감지하는 데 사용되는 사용자 정의 패턴을 생성합니다.

생성하는 각 사용자 정의 패턴은 정규식과 컨텍스트 단어의 선택적 목록을 지정합니다. 컨텍스트 단어가 전달되지 않으면 정규식만 검사됩니다.

요청

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  나중에 검색하거나 삭제할 수 있는 사용자 정의 패턴의 이름입니다. 이 이름은 AWS 계정별로 고유해야 합니다.

• RegexString – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  사용자 정의 패턴에서 민감한 데이터를 감지하는 데 사용되는 정규식 문자열입니다.

• ContextWords – UTF-8 문자열의 배열입니다(1~20개 문자열).

  컨텍스트 단어 목록입니다. 이러한 컨텍스트 단어가 정규식 주변에서 발견되지 않으면 데이터는 민감한 데이터로 감지되지 않습니다.

  컨텍스트 단어가 전달되지 않으면 정규식만 검사됩니다.

• Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

  사용자 지정 엔터티 유형에 적용되는 태그 목록입니다.

응답

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  생성한 사용자 정의 패턴의 이름입니다.

오류

• AccessDeniedException

• AlreadyExistsException

• IdempotentParameterMismatchException

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

• ResourceNumberLimitExceededException

DeleteCustomEntityType 작업(Python: delete_custom_entity_type)

이름을 지정하여 사용자 정의 패턴을 삭제합니다.

요청

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  삭제할 사용자 정의 패턴의 이름입니다.

응답

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  삭제한 사용자 정의 패턴의 이름입니다.

오류

• EntityNotFoundException

• AccessDeniedException

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

GetCustomEntityType 작업(Python: get_custom_entity_type)

이름을 지정하여 사용자 패턴의 세부 정보를 검색합니다.

요청

• Name – 필수(Required): Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  검색할 사용자 정의 패턴의 이름입니다.

응답

• Name – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  검색한 사용자 정의 패턴의 이름입니다.

• RegexString – Single-line string pattern과(와) 일치하는 1~255바이트 길이의 UTF-8 문자열입니다.

  사용자 정의 패턴에서 민감한 데이터를 감지하는 데 사용되는 정규식 문자열입니다.

• ContextWords – UTF-8 문자열의 배열입니다(1~20개 문자열).

  사용자 정의 패턴을 생성할 때 지정된 경우 컨텍스트 단어 목록입니다. 이러한 컨텍스트 단어가 정규식 주변에서 발견되지 않으면 데이터는 민감한 데이터로 감지되지 않습니다.

오류

• EntityNotFoundException

• AccessDeniedException

• InternalServiceException

• InvalidInputException

• OperationTimeoutException

BatchGetCustomEntityTypes 작업(Python: batch_get_custom_entity_types)

이름 목록으로 지정된 사용자 정의 패턴에 대한 세부 정보를 검색합니다.

요청

• Names – 필수(Required): 1~50개 문자열의 UTF-8 문자열의 배열입니다.

  검색할 사용자 정의 패턴의 이름 목록입니다.

응답

• CustomEntityTypes – CustomEntityType 객체의 배열입니다.

  생성된 사용자 정의 패턴을 나타내는 CustomEntityType 객체의 목록입니다.

• CustomEntityTypesNotFound – UTF-8 문자열의 배열입니다(1~50개 문자열).

  찾을 수 없는 사용자 정의 패턴의 이름 목록입니다.

오류

• InvalidInputException

• InternalServiceException

• OperationTimeoutException

ListCustomEntityTypes 작업(Python: list_custom_entity_types)

생성된 모든 사용자 정의 패턴을 나열합니다.

요청

• NextToken – UTF-8 문자열입니다.

  결과를 오프셋하기 위한 페이지 매김 토큰입니다.

• MaxResults – 1~1,000의 숫자(정수)입니다.

  반환할 최대 결과 수입니다.

• Tags – 50개 이하의 페어로 구성된 키-값 페어의 맵 배열입니다.

  각 키는 길이가 1~128바이트인 UTF-8 문자열입니다.

  각 값은 256 바이트 이하 길이의 UTF-8 문자열입니다.

  키-값 페어 태그의 목록입니다.

응답

• CustomEntityTypes – CustomEntityType 객체의 배열입니다.

  사용자 정의 패턴을 나타내는 CustomEntityType 객체의 목록입니다.

• NextToken – UTF-8 문자열입니다.

  추가 결과를 사용할 수 있는 경우 페이지 매김 토큰입니다.

오류

• InvalidInputException

• OperationTimeoutException

• InternalServiceException