REST Resource: projects.locations.datasetConfigs

리소스: DatasetConfig

데이터 세트 구성 속성을 설명하는 메시지입니다. 자세한 내용은 데이터 세트 구성 속성을 참조하세요.

JSON 표현 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "uid": string,
  "organizationNumber": string,
  "includeNewlyCreatedBuckets": boolean,
  "retentionPeriodDays": integer,
  "link": {
    object (Link)
  },
  "identity": {
    object (Identity)
  },
  "status": {
    object (Status)
  },
  "datasetConfigState": enum (ConfigState),
  "description": string,

  // Union field source_options can be only one of the following:
  "sourceProjects": {
    object (SourceProjects)
  },
  "sourceFolders": {
    object (SourceFolders)
  },
  "organizationScope": boolean,
  "cloudStorageObjectPath": string
  // End of list of possible types for union field source_options.

  // Union field cloud_storage_locations can be only one of the following:
  "includeCloudStorageLocations": {
    object (CloudStorageLocations)
  },
  "excludeCloudStorageLocations": {
    object (CloudStorageLocations)
  }
  // End of list of possible types for union field cloud_storage_locations.

  // Union field cloud_storage_buckets can be only one of the following:
  "includeCloudStorageBuckets": {
    object (CloudStorageBuckets)
  },
  "excludeCloudStorageBuckets": {
    object (CloudStorageBuckets)
  }
  // End of list of possible types for union field cloud_storage_buckets.
}
필드
name

string

식별자. 리소스의 이름
createTime

string (Timestamp format)

출력 전용입니다. 데이터 세트 구성이 생성된 UTC 시간입니다. 자동으로 채워집니다.

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

string (Timestamp format)

출력 전용입니다. 데이터 세트 구성이 마지막으로 업데이트된 UTC 시간입니다. 자동으로 채워집니다.

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

map (key: string, value: string)

키-값 쌍인 라벨입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

출력 전용입니다. 시스템에서 생성한 리소스의 고유 식별자입니다.
organizationNumber

string (int64 format)

(선택사항) 소스 프로젝트가 속해야 하는 조직 리소스 ID입니다. 제공된 조직에 속하지 않는 프로젝트는 데이터 세트를 만들 때 고려되지 않습니다.
includeNewlyCreatedBuckets

boolean

true로 설정하면 요청에 포함 및 제외 규칙을 충족하는 데이터 세트의 새로 생성된 모든 버킷이 포함됩니다.
retentionPeriodDays

integer

보관해야 하는 기록 일수입니다.
identity

object (Identity)

이 datasetConfig에서 사용되는 ID입니다.
status

object (Status)

출력 전용입니다. datasetConfig의 상태입니다.
datasetConfigState

enum (ConfigState)

출력 전용입니다. datasetConfig의 상태입니다.
description

string

(선택사항) 데이터 세트 구성에 대해 사용자가 제공한 설명입니다.

최대 길이: 256자(영문 기준)
통합 필드 source_options. 데이터 세트에 소스 식별자를 제공하는 옵션을 정의합니다. source_options은 다음 중 하나여야 합니다.
sourceProjects

object (SourceProjects)

데이터 세트의 소스 프로젝트를 제공하는 옵션을 정의합니다.
sourceFolders

object (SourceFolders)

데이터 세트의 소스 폴더를 제공하는 옵션을 정의합니다.
organizationScope

boolean

데이터 세트의 소스 조직을 제공하는 옵션을 정의합니다.
cloudStorageObjectPath

string

입력 전용입니다. 데이터 세트에 포함할 프로젝트 또는 폴더 번호 목록이 포함된 Cloud Storage 객체 경로입니다. 프로젝트와 폴더가 혼합되어 포함될 수는 없습니다.

객체는 각 줄에 다음 항목 중 하나가 있는 텍스트 파일이어야 합니다.

  • 프로젝트 번호입니다. projects/{projectNumber} 형식으로 지정됩니다(예: projects/1234567890).
  • folders/{folder_number} 형식의 폴더 식별자(예: folders/9876543210) 경로는 gs://{bucketName}/{objectName} 형식이어야 합니다.
통합 필드 cloud_storage_locations. 포함하거나 제외할 Cloud Storage 위치입니다. cloud_storage_locations은 다음 중 하나여야 합니다.
includeCloudStorageLocations

object (CloudStorageLocations)
excludeCloudStorageLocations

object (CloudStorageLocations)
통합 필드 cloud_storage_buckets. 포함하거나 제외할 Cloud Storage 버킷입니다. cloud_storage_buckets은 다음 중 하나여야 합니다.
includeCloudStorageBuckets

object (CloudStorageBuckets)
excludeCloudStorageBuckets

object (CloudStorageBuckets)

SourceProjects

프로젝트 번호 모음

JSON 표현 
{
  "projectNumbers": [
    string
  ]
}
필드
projectNumbers[]

string (int64 format)

SourceFolders

데이터 세트에 포함할 폴더 집합을 지정합니다.

JSON 표현 
{
  "folderNumbers": [
    string
  ]
}
필드
folderNumbers[]

string (int64 format)

(선택사항) 데이터 세트에 포함할 폴더 번호 목록입니다.

CloudStorageLocations

Cloud Storage 위치 모음입니다.

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

string

CloudStorageBuckets

Cloud Storage 버킷 모음입니다.

JSON 표현 
{
  "cloudStorageBuckets": [
    {
      object (CloudStorageBucket)
    }
  ]
}
필드
cloudStorageBuckets[]

object (CloudStorageBucket)

CloudStorageBucket

이름 또는 버킷과 일치하는 정규식 패턴으로 버킷을 정의합니다.

JSON 표현 
{

  // Union field cloud_storage_bucket can be only one of the following:
  "bucketName": string,
  "bucketPrefixRegex": string
  // End of list of possible types for union field cloud_storage_bucket.
}
필드

통합 필드 cloud_storage_bucket.

cloud_storage_bucket는 다음 중 하나여야 합니다.
bucketName

string

Cloud Storage 버킷 이름
bucketPrefixRegex

string

정규식과 일치하는 버킷 이름의 정규식 패턴입니다. 정규식은 GitHub의 google/re2에 지정된 구문을 따라야 합니다.

ID

ID를 사용하면 사용자가 사용할 ID 유형을 제공하고 IAM 정책 변경에 사용할 수 있는 ID 문자열을 출력할 수 있습니다.

JSON 표현 
{
  "name": string,
  "type": enum (IdentityType)
}
필드
name

string

출력 전용입니다. ID의 이름입니다.
type

enum (IdentityType)

datasetConfig에 사용할 ID 유형입니다.

IdentityType

데이터 세트 구성에 사용할 서비스 계정 유형입니다.

열거형
IDENTITY_TYPE_UNSPECIFIED 기본값은 지정되지 않으며 사용하면 안 됩니다.
IDENTITY_TYPE_PER_CONFIG 리소스당 Google 관리형 서비스 계정
IDENTITY_TYPE_PER_PROJECT 프로젝트당 Google 관리형 서비스 계정

ConfigState

구성의 상태입니다.

열거형
CONFIG_STATE_UNSPECIFIED 지정되지 않은 상태입니다.
CONFIG_STATE_ACTIVE 활성 구성은 구성이 데이터를 적극적으로 수집하고 있음을 나타냅니다.
CONFIG_STATE_VERIFICATION_IN_PROGRESS 이 상태에서는 다양한 권한에 대해 구성이 확인됩니다.
CONFIG_STATE_CREATED 구성 생성이 완료되었으며 추가 처리가 필요합니다.
CONFIG_STATE_PROCESSING 구성을 처리하는 중입니다.

메서드

create

 특정 위치의 특정 프로젝트에 데이터 세트 구성을 만듭니다.

delete

 특정 위치의 특정 프로젝트에 데이터 세트 구성을 삭제합니다.

get

 특정 위치의 특정 프로젝트에서 데이터 세트 구성을 가져옵니다.

linkDataset

 특정 위치의 특정 프로젝트에서 데이터 세트를 BigQuery에 연결합니다.

list

 특정 위치의 특정 프로젝트에서 데이터 세트 구성을 나열합니다.

patch

 특정 위치의 특정 프로젝트에서 데이터 세트 구성을 업데이트합니다.

unlinkDataset

 특정 위치의 특정 프로젝트에서 BigQuery의 데이터 세트를 연결 해제합니다.