ProjectSource

필터를 충족하는 객체가 변환될 프로젝트 소스를 설명합니다.

JSON 표현
{
  "project": string,
  "insightsDatasetConfig": string,
  "bucketFilters": {
    object (Expr)
  },
  "objectFilters": {
    object (Expr)
  },
  "dryRunJobId": string,
  "targetLocations": {
    object (TargetLocations)
  },
  "snapshotTime": string
}
필드
project

string

필수 항목입니다. 변환할 객체의 프로젝트 이름입니다(예: projects/my-project 또는 projects/123456).

insightsDatasetConfig

string

필수 항목입니다. Storage Insights 데이터 세트 구성의 리소스 식별자입니다. 스토리지 일괄 작업은 이 데이터 세트의 최신 스냅샷을 소스로 사용하여 대상 객체를 나열하고 필터링합니다. 형식은 projects/{projectId}/locations/{location}/datasetConfigs/{dataset_config}입니다.

bucketFilters

object (Expr)

(선택사항) 변환할 객체가 있는 버킷을 식별하기 위해 버킷에 적용할 Common Expression Language (CEL)로 표현된 필터입니다.

objectFilters

object (Expr)

(선택사항) 변환할 객체를 식별하기 위해 객체에 적용할 Common Expression Language (CEL)로 표현된 필터입니다.

dryRunJobId

string

(선택사항) 현재 작업의 기준선으로 사용할 드라이 런 작업의 고유 식별자입니다.

이 ID를 지정하면 드라이 런 중에 검증된 동일한 객체 집합에 대해 작업이 실행됩니다. 값은 리소스 이름의 {jobId} 세그먼트(projects/{projectId}/locations/{location}/jobs/{jobId})에 해당합니다.

targetLocations

object (TargetLocations)

(선택사항) 작업에 포함할 Cloud Storage 위치를 지정합니다. 제공된 경우 insightsDatasetConfig에 구성된 대로 Storage Insights 데이터 세트에서 이러한 위치 내의 버킷과 객체만 검색됩니다. 생략하면 작업에서 insightsDatasetConfig에 구성된 모든 위치의 버킷과 객체를 검색합니다.

snapshotTime

string (Timestamp format)

출력 전용입니다. 작업에서 버킷 및 객체 검색을 위해 Storage Insights 데이터 세트를 읽는 데 사용하는 스냅샷 시간입니다. 이 필드는 서비스에서 채우고 사용된 데이터 세트 스냅샷의 정확한 타임스탬프를 반영합니다.

생성된 출력은 항상 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"입니다.

Expr

Common Expression Language(CEL) 문법으로 된 텍스트 표현식을 나타냅니다. CEL은 C와 같은 표현식 언어입니다. CEL의 문법과 시맨틱스는 https://github.com/google/cel-spec에 설명되어 있습니다.

예시(비교):

title: "Summary size limit"
description: "Determines if a summary is less than 100 chars"
expression: "document.summary.size() < 100"

예시(균등):

title: "Requestor is owner"
description: "Determines if requestor is the document owner"
expression: "document.owner == request.auth.claims.email"

예시(로직):

title: "Public documents"
description: "Determine whether the document should be publicly visible"
expression: "document.type != 'private' && document.type != 'internal'"

예시(데이터 조작):

title: "Notification string"
description: "Create a notification string with a timestamp."
expression: "'New message received at ' + string(document.create_time)"

표현식 내에서 참조할 수 있는 정확한 변수와 함수는 이를 계산하는 서비스에 의해 결정됩니다. 자세한 내용은 서비스 문서를 참조하세요.

JSON 표현
{
  "expression": string,
  "title": string,
  "description": string,
  "location": string
}
필드
expression

string

Common Expression Language 문법으로 된 표현식의 텍스트 표현입니다.

title

string

선택사항. 표현식의 제목으로, 목적을 설명하는 짧은 문자열입니다. 표현식을 입력할 수 있는 UI 등에 사용할 수 있습니다.

description

string

선택사항. 표현식에 대한 설명입니다. 표현식을 설명하는 더 긴 텍스트입니다. 예를 들어 UI에서 마우스를 가져갈 때 표시할 수 있습니다.

location

string

선택사항. 오류 보고를 위해 표현식의 위치를 나타내는 문자열입니다. 예를 들어 파일 이름 및 파일 내 위치일 수 있습니다.

TargetLocations

ProjectSource 작업에 포함할 Cloud Storage 위치를 설명합니다.

JSON 표현
{
  "locations": [
    string
  ],
  "snapshotTime": string
}
필드
locations[]

string

필수 항목입니다. 작업에 포함할 Cloud Storage 위치 목록입니다 (예: us-central1).

snapshotTime을 생략하면 작업은 지정된 모든 위치에서 object_attributes_viewbucket_attributes_view 모두에 성공적으로 채워진 최신 스냅샷 타임스탬프를 자동으로 기본값으로 사용합니다.

Storage Insights 데이터 세트 스냅샷 및 뷰에 대한 자세한 내용은 Storage Insights 데이터 세트 테이블 및 스키마를 참조하세요.

snapshotTime

string (Timestamp format)

(선택사항) RFC 3339 형식과 호환되는 작업에 사용할 정확한 Storage Insights 데이터 세트 스냅샷 타임스탬프입니다 (예: 2024-01-02T03:04:05Z).

지정된 경우 이 정확한 스냅샷은 locations에 나열된 모든 위치의 object_attributes_viewbucket_attributes_view 모두에 있어야 합니다. 스냅샷이 위치의 뷰 중 하나에 없으면 작업이 실패합니다.

생성된 출력은 항상 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"입니다.