ObjectConditions

전송되는 객체를 결정하는 조건입니다. S3, Azure, Cloud Storage와 같은 Cloud 데이터 소스에만 적용됩니다.

'마지막 수정 시간'은 객체의 콘텐츠 또는 메타데이터가 마지막으로 변경된 시간을 나타냅니다. 구체적으로 Cloud Storage 객체의 updated 속성, S3 객체의 LastModified 필드, Azure blob의 Last-Modified 헤더입니다.

S3 객체의 경우 LastModified 값은 객체 업로드가 시작된 시간입니다. 객체가 '마지막 수정 시간' 기준을 충족하지만 업로드가 완료되지 않은 경우 객체가 전송되지 않습니다. 자세한 내용은 Amazon S3에서 Cloud Storage로 전송을 참고하세요.

PosixFilesystem 소스 또는 대상이 있는 전송은 ObjectConditions를 지원하지 않습니다.

JSON 표현 
{
  "minTimeElapsedSinceLastModification": string,
  "maxTimeElapsedSinceLastModification": string,
  "includePrefixes": [
    string
  ],
  "excludePrefixes": [
    string
  ],
  "lastModifiedSince": string,
  "lastModifiedBefore": string
}
필드
minTimeElapsedSinceLastModification

string (Duration format)

'최종 수정 시간' 후 특정 최소 시간이 경과할 때까지 객체가 전송되지 않도록 합니다. TransferOperation가 시작되면 '마지막 수정 시간'이 있는 객체는 TransferOperation의 startTime과 객체의 '마지막 수정 시간' 간의 경과 시간이 minTimeElapsedSinceLastModification` 값보다 크거나 같은 경우에만 전송됩니다. '마지막 수정 시간'이 없는 객체도 전송됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
maxTimeElapsedSinceLastModification

string (Duration format)

'마지막 수정 시간' 이후 특정 최대 시간이 경과하면 객체가 전송되지 않도록 합니다. TransferOperation가 시작되면 '마지막 수정 시간'이 있는 객체는 TransferOperation의 startTime과 객체의 '마지막 수정 시간' 간에 경과된 시간이 maxTimeElapsedSinceLastModification` 값보다 작은 경우에만 전송됩니다. '마지막 수정 시간'이 없는 객체도 전송됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
includePrefixes[]

string

includePrefixes를 지정하면 Storage Transfer Service는 includePrefixes 배열의 항목을 사용하여 전송에 포함할 객체를 결정합니다. 객체가 이전에 포함되려면 일치하는 includePrefixes 중 하나로 시작해야 합니다. excludePrefixes가 지정된 경우 객체는 전송에 포함되도록 지정된 excludePrefixes로 시작해서는 안 됩니다.

includePrefixes의 요구사항은 다음과 같습니다.

  • 각 include-prefix는 UTF8로 인코딩된 경우 최대 길이가 1,024바이트인 임의의 유니코드 문자 시퀀스를 포함할 수 있으며 캐리지 리턴 문자나 줄바꿈 문자를 포함해서는 안 됩니다. 와일드 카드 일치 및 정규 표현식 일치는 지원되지 않습니다.

  • 각 include-prefix는 선행 슬래시를 생략해야 합니다. 예를 들어 s3://my-aws-bucket/logs/y=2015/requests.gz 객체를 포함하려면 include-prefix를 logs/y=2015/requests.gz로 지정합니다.

  • 지정된 경우 include-prefix 값은 모두 비워서는 안 됩니다.

  • 각 include-prefix에는 객체 네임스페이스의 고유한 부분이 포함되어야 합니다. include-prefix는 다른 include-prefix의 프리픽스가 될 수 없습니다.

includePrefixes의 최대 크기는 1,000입니다.

자세한 내용은 전송에서 객체 필터링을 참고하세요.
excludePrefixes[]

string

excludePrefixes를 지정하면 Storage Transfer Service는 excludePrefixes 배열의 항목을 사용하여 전송에서 제외할 객체를 결정합니다. 객체가 전송에 포함되려면 일치하는 excludePrefixes 중 하나로 시작해서는 안 됩니다.

excludePrefixes의 요구사항은 다음과 같습니다.

  • 각 exclude-prefix는 UTF8로 인코딩된 경우 최대 1,024바이트 길이의 임의의 유니코드 문자 시퀀스를 포함할 수 있으며 캐리지 리턴 또는 줄바꿈 문자를 포함해서는 안 됩니다. 와일드 카드 일치 및 정규 표현식 일치는 지원되지 않습니다.

  • 각 exclude-prefix는 선행 슬래시를 생략해야 합니다. 예를 들어 s3://my-aws-bucket/logs/y=2015/requests.gz 객체를 제외하려면 제외 프리픽스를 logs/y=2015/requests.gz로 지정합니다.

  • 지정된 경우 exclude-prefix 값은 모두 비워 둘 수 없습니다.

  • 각 제외 접두사는 객체 네임스페이스의 고유한 부분을 제외해야 합니다. 제외 프리픽스는 다른 제외 프리픽스의 프리픽스가 될 수 없습니다.

  • includePrefixes가 지정되면 각 제외 프리픽스는 includePrefixes에 의해 명시적으로 포함된 경로의 값으로 시작해야 합니다.

excludePrefixes의 최대 크기는 1,000입니다.

자세한 내용은 전송에서 객체 필터링을 참고하세요.
lastModifiedSince

string (Timestamp format)

지정된 경우 이 타임스탬프 이후의 '최종 수정 시간'이 있는 객체와 '최종 수정 시간'이 없는 객체만 전송됩니다.

lastModifiedSince 및 lastModifiedBefore 필드는 청크 데이터 처리에 함께 사용할 수 있습니다. 예를 들어 매일 하루 분량의 데이터를 처리하는 스크립트를 생각해 보세요. 이렇게 하려면 각 필드를 다음과 같이 설정합니다.

  • lastModifiedSince부터 하루의 시작까지

  • lastModifiedBefore(오늘 종료)

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
lastModifiedBefore

string (Timestamp format)

지정된 경우 이 타임스탬프 이전의 '마지막 수정 시간'이 있는 객체와 '마지막 수정 시간'이 없는 객체만 전송됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.