Storage Insights 데이터 세트 사용

이 페이지에서는 Storage Insights 데이터 세트 및 데이터 세트 구성을 만들고 관리하는 방법을 보여줍니다. Storage Insights 데이터 세트에 대해 자세히 알아보세요.

시작하기 전에

데이터 세트 및 데이터 세트 구성을 만들고 관리하기 전에 다음 하위 섹션의 안내를 따르세요.

필요한 역할 가져오기

데이터 세트를 만들고 관리하는 데 필요한 권한을 얻으려면 관리자에게 소스 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 데이터 세트를 만들고 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

데이터 세트를 만들고 관리하려면 다음 권한이 필요합니다.

  • 데이터 세트 구성 만들기: storageinsights.datasetConfigs.create
  • 데이터 세트 구성 보기:
    • storageinsights.datasetConfigs.get
    • storageinsights.datasetConfigs.list
  • 데이터 세트 구성 관리:
    • storageinsights.datasetConfigs.update
    • storageinsights.datasetConfigs.delete
  • BigQuery 데이터 세트 링크: storageinsights.datasetConfigs.linkDataset
  • BigQuery 데이터 세트 연결 해제: storageinsights.datasetConfigs.unlinkDataset
  • BigQuery 연결 데이터 세트 쿼리: bigquery.jobs.create or bigquery.jobs.*

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

Storage Insights API 사용 설정

콘솔

storageinsights.googleapis.com API 사용 설정

명령줄

현재 프로젝트에서 Storage Insights API를 사용 설정하려면 다음 명령어를 실행합니다.

gcloud services enable storageinsights.googleapis.com

Google Cloud 프로젝트의 서비스를 사용 설정하는 방법에 관한 자세한 내용은 서비스 사용 설정 및 중지를 참고하세요.

Storage Intelligence 구성

데이터 세트로 분석하려는 프로젝트, 폴더 또는 조직에서 저장소 인텔리전스가 구성되어 있는지 확인합니다.

데이터 세트 구성 만들기

데이터 세트 구성을 만들고 데이터 세트를 생성하려면 다음 단계를 따르세요. 데이터 세트 구성을 만들 때 지정할 수 있는 필드에 관한 자세한 내용은 데이터 세트 구성 속성을 참고하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

  2. 데이터 세트 구성을 클릭합니다.

  3. 데이터 세트 이름 지정 섹션에서 데이터 세트 이름을 입력합니다. 원하는 경우 데이터 세트에 대한 설명을 입력합니다.

  4. 데이터 세트 범위 정의 섹션에서 다음을 수행합니다.

    • 다음 옵션 중 하나를 선택합니다.

      • 현재 조직의 모든 프로젝트에 대한 스토리지 메타데이터를 가져오려면 조직 포함을 선택합니다.

      • 선택한 폴더의 모든 프로젝트에 대한 스토리지 메타데이터를 가져오려면 폴더(하위 조직/부서) 포함을 선택합니다. 폴더 ID를 가져오는 방법에 대한 자세한 내용은 폴더 및 프로젝트 보기 또는 나열을 참고하세요. 폴더를 추가하려면 다음 단계를 따르세요.

        1. 폴더 1 입력란에 폴더 ID를 입력합니다.
        2. 원하는 경우 폴더 ID를 여러 개 추가하려면 + 폴더 추가를 클릭합니다.

      • 선택한 프로젝트의 스토리지 메타데이터를 가져오려면 프로젝트 번호를 제공하여 프로젝트 포함을 선택합니다. 프로젝트 번호를 찾는 방법은 프로젝트 이름, 번호, ID 찾기를 참고하세요. 프로젝트를 추가하려면 다음 단계를 따르세요.

        1. Project 1(프로젝트 1) 필드에 프로젝트 번호를 입력합니다.
        2. 원하는 경우 프로젝트 번호를 여러 개 추가하려면 + 프로젝트 추가를 클릭합니다.

      • 프로젝트 또는 폴더를 일괄 추가하려면 CSV 파일을 통해 프로젝트 /폴더 목록 업로드를 선택합니다. CSV 파일에는 데이터 세트에 포함할 프로젝트 번호 또는 폴더 ID가 포함되어야 합니다.

    • 선택한 리소스에 향후 버킷을 자동으로 포함할지 지정합니다.

    • 원하는 경우 리전 및 버킷 접두사를 기준으로 버킷에 필터를 지정하려면 필터 (선택사항) 섹션을 펼칩니다. 필터는 버킷에 추가적으로 적용됩니다.

      특정 리전의 버킷을 포함하거나 제외할 수 있습니다. 예를 들어 me-central1 및 me-central2 리전에 있는 버킷을 제외할 수 있습니다. 접두사로 버킷을 포함하거나 제외할 수도 있습니다. 예를 들어 my-bucket로 시작하는 버킷을 제외하려면 my-bucket* 접두사를 입력합니다.

  5. 계속을 클릭합니다.

  6. 보관 기간 선택 섹션에서 데이터 세트의 데이터에 대한 보관 기간을 선택합니다.

  7. 구성된 데이터 세트를 저장할 위치 선택 섹션에서 데이터 세트 및 데이터 세트 구성을 저장할 위치를 선택합니다.

  8. 서비스 계정 유형 선택 섹션에서 데이터 세트의 서비스 에이전트 유형을 선택합니다. 이 서비스 에이전트는 데이터 세트 구성을 만들 때 사용자를 대신하여 생성됩니다. 다음 서비스 상담사 중 하나를 선택할 수 있습니다.

    • 구성 범위 서비스 계정: 이 서비스 에이전트는 특정 데이터 세트 구성에서 생성된 데이터 세트에만 액세스하고 이를 쓸 수 있습니다.
    • 프로젝트 범위 서비스 계정: 이 서비스 에이전트는 프로젝트의 모든 데이터 세트 구성에서 생성된 데이터 세트에 액세스하고 이를 작성할 수 있습니다.

    서비스 에이전트를 만들 때 서비스 에이전트에 필수 권한을 부여해야 합니다. 이러한 서비스 에이전트에 관한 자세한 내용은 데이터 세트 구성 속성을 참고하세요.

  9. 구성을 클릭합니다.

명령줄

  1. 데이터 세트 구성을 만들려면 필요한 플래그와 함께 gcloud storage insights dataset-configs create 명령어를 실행합니다.

    gcloud storage insights dataset-configs create DATASET_CONFG_ID \
  --source-projects=SOURCE_PROJECT_NUMBERS \
  --location=LOCATION \
  --retention-period-days=RETENTION_PERIOD_DAYS \
  --organization=ORGANIZATION_ID

    다음과 같이 바꿉니다.

    • DATASET_CONFIG_ID을 데이터 세트 구성에 지정할 이름으로 바꿉니다. 이름은 데이터 세트 구성의 식별자로 사용되며 변경 가능합니다. 이름에는 문자, 숫자, 밑줄을 사용하여 최대 128자(영문 기준)를 포함할 수 있습니다.

    • SOURCE_PROJECT_NUMBERS를 데이터 세트에 포함할 프로젝트의 번호로 바꿉니다. 예를 들면 464036093014입니다. 프로젝트는 하나 이상 지정할 수 있습니다. 프로젝트 번호를 찾는 방법은 프로젝트 이름, 번호, ID 찾기를 참고하세요.

      --source-projects 플래그를 사용하는 대신 --source-projects-file=FILE_PATH 플래그를 사용할 수 있습니다. 이 플래그를 사용하면 프로젝트 번호가 포함된 파일을 업로드하여 한 번에 여러 프로젝트 번호를 지정할 수 있습니다. 파일은 CSV 형식이어야 하며 Cloud Storage에 업로드해야 합니다.

    • LOCATION을 데이터 세트 구성 및 데이터 세트가 저장될 위치로 바꿉니다.

    • RETENTION_PERIOD_DAYS: 데이터 세트의 데이터 보관 기간

    • 소스 프로젝트가 속한 조직의 리소스 ID로 ORGANIZATION_ID를 바꿉니다. 지정된 위치 외부의 소스 프로젝트는 데이터 세트 구성에서 제외됩니다. 조직 ID를 찾는 방법은 조직 리소스 ID 가져오기를 참고하세요.

    원하는 경우 추가 플래그를 사용하여 데이터 세트를 세부적으로 구성할 수 있습니다.

    • --include-buckets=BUCKET_NAMES_OR_REGEX를 사용하여 이름 또는 정규 표현식으로 특정 버킷을 포함합니다. 이 플래그를 사용하는 경우 --exclude-buckets를 사용할 수 없습니다.

    • --exclude-buckets=BUCKET_NAMES_OR_REGEX를 사용하여 이름 또는 정규 표현식으로 특정 버킷을 제외합니다. 이 플래그를 사용하는 경우 --include-buckets를 사용할 수 없습니다.

    • --project=DESTINATION_PROJECT_ID를 사용하여 데이터 세트 구성 및 생성된 데이터 세트를 저장하는 데 사용할 프로젝트를 지정합니다. 이 플래그를 사용하지 않으면 대상 프로젝트가 활성 프로젝트가 됩니다. 프로젝트 ID에 관한 자세한 내용은 프로젝트 만들기 및 관리를 참고하세요.

    • --auto-add-new-buckets를 사용하여 향후 소스 프로젝트에 추가되는 모든 버킷을 자동으로 포함합니다.

    • --skip-verification를 사용하여 필수 IAM 권한 확인을 비롯한 인증 프로세스의 확인 및 실패를 건너뜁니다. 이 필터를 사용하면 일부 또는 모든 버킷이 데이터 세트에서 제외될 수 있습니다.

    • --identity=IDENTITY_TYPE를 사용하여 데이터 세트 구성과 함께 생성되는 서비스 에이전트의 유형을 지정합니다. 값은 IDENTITY_TYPE_PER_CONFIG 또는 IDENTITY_TYPE_PER_PROJECT입니다. 지정하지 않으면 기본값은 IDENTITY_TYPE_PER_CONFIG입니다.

    • --description=DESCRIPTION를 사용하여 데이터 세트 구성에 관한 설명을 작성합니다.

REST API

JSON API

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. 다음 정보를 포함하는 JSON 파일을 만듭니다.

    {
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": ["PROJECT_NUMBERS", ...]
  },
  "retention_period_days": "RETENTION_PERIOD_DAYS",
  "identity": {
    "type": "IDENTITY_TYPE"
  }
}

    다음과 같이 바꿉니다.

    • ORGANIZATION_ID를 소스 프로젝트가 속한 조직의 리소스 ID로 바꿉니다. 조직 ID를 찾는 방법은 조직 리소스 ID 가져오기를 참고하세요.

    • PROJECT_NUMBERS를 데이터 세트에 포함할 프로젝트 번호로 바꿉니다. 프로젝트는 하나 이상 지정할 수 있습니다. 프로젝트는 문자열 목록으로 지정해야 합니다.

    • RETENTION_PERIOD_DAYS: 데이터 세트 스냅샷에 캡처할 데이터 일 수입니다. 예를 들면 90입니다.

    • IDENTITY_TYPE: 데이터 세트 구성과 함께 생성되는 서비스 계정의 유형입니다. 값은 IDENTITY_TYPE_PER_CONFIG 또는 IDENTITY_TYPE_PER_PROJECT입니다.

  3. 데이터 세트 구성을 만들려면 cURL을 사용하여 Create DatasetConfig 요청으로 JSON API를 호출합니다.

    curl -X POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs?datasetConfigId=DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json"

    다음과 같이 바꿉니다.

    • JSON_FILE_NAME을 이전 단계에서 만든 JSON 파일 경로로 바꿉니다. 또는 요청 본문에 DatasetConfig 인스턴스를 전달할 수 있습니다.

    • 데이터 세트 구성 및 데이터 세트가 속할 프로젝트의 ID를 사용하여 PROJECT_ID

    • LOCATION을 데이터 세트 및 데이터 세트 구성이 상주할 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • DATASET_CONFIG_ID을 데이터 세트 구성에 지정할 이름으로 바꿉니다. 이름은 데이터 세트 구성의 식별자로 사용되며 변경할 수 없습니다. 이름에는 문자, 숫자, 밑줄을 사용하여 최대 128자(영문 기준)를 포함할 수 있습니다. 이름은 문자로 시작해야 합니다.

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

error_attributes_view에 로깅된 스냅샷 처리 오류를 해결하려면 Storage Insights 데이터 세트 오류를 참고하세요.

서비스 에이전트에 필요한 권한 부여

Google Cloud 는 데이터 세트 구성을 만들 때 사용자를 대신하여 구성 범위 또는 프로젝트 범위 서비스 에이전트를 만듭니다. 서비스 에이전트는 service-PROJECT_NUMBER@gcp-sa-storageinsights.iam.gserviceaccount.com 이름 지정 형식을 사용하고 Google 제공 역할 부여 포함 체크박스를 선택할 때 Google Cloud 콘솔의 IAM 페이지에 표시됩니다. JSON API를 사용하여 DatasetConfig 리소스를 확인하여 서비스 상담사의 이름을 찾을 수도 있습니다.

Storage Insights에서 데이터 세트를 생성하고 작성하도록 사용 설정하려면 관리자에게 연락해서 서비스 에이전트에 소스 프로젝트가 포함된 조직에 Storage Insights 컬렉터 서비스 역할 (roles/storage.insightsCollectorService)을 부여해 달라고 요청하세요. 이 역할은 데이터를 가져오려는 각 데이터 세트 구성에 대해 생성되는 모든 구성 범위 서비스 에이전트에 부여되어야 합니다. 프로젝트 범위의 서비스 에이전트를 사용하는 경우 서비스 에이전트가 프로젝트 내의 모든 데이터 세트 구성에 관한 데이터 세트를 읽고 쓸 수 있도록 이 역할은 한 번만 부여하면 됩니다.

프로젝트에 역할을 부여하는 방법은 액세스 관리를 참고하세요.

데이터 세트를 BigQuery에 연결하려면 다음 단계를 완료하세요.

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

  2. 연결할 데이터 세트를 생성한 데이터 세트 구성의 이름을 클릭합니다.

  3. BigQuery 연결 데이터 세트 섹션에서 데이터 세트 연결을 클릭하여 데이터 세트를 연결합니다.

  1. 데이터 세트를 BigQuery에 연결하려면 gcloud storage insights dataset-configs create-link 명령어를 실행합니다.

    gcloud storage insights dataset-configs create-link DATASET_CONFIG_ID --location=LOCATION

    다음과 같이 바꿉니다.

    • DATASET_CONFIG_ID: 연결하려는 데이터 세트를 생성한 데이터 세트 구성의 이름

    • LOCATION: 데이터 세트의 위치 예를 들면 us-central1입니다.

    DATASET_CONFIG_NAME 및 LOCATION를 지정하는 대신 전체 데이터 세트 구성 경로를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    gcloud storage insights dataset-configs create-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID_

    다음과 같이 바꿉니다.

    • DESTINATION_PROJECT_ID를 데이터 세트 구성이 포함된 프로젝트의 ID로 바꿉니다. 프로젝트 ID에 관한 자세한 내용은 프로젝트 만들기 및 관리를 참고하세요.

    • DATASET_CONFIG_ID: 연결하려는 데이터 세트를 생성한 데이터 세트 구성의 이름

    • LOCATION을 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. 다음 정보를 포함하는 JSON 파일을 만듭니다.

    {
  "name": "DATASET_NAME"
}

    다음과 같이 바꿉니다.

    • DATASET_NAME을 연결하려는 데이터 세트의 이름으로 바꿉니다. 예를 들면 my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2입니다.

  3. cURL를 사용하여 linkDataset DatasetConfig 요청으로 JSON API를 호출합니다.

    curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:linkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    다음과 같이 바꿉니다.

    • JSON_FILE_NAME을 이전 단계에서 만든 JSON 파일 경로로 바꿉니다.

    • 데이터 세트 구성이 속한 프로젝트의 ID가 포함된 PROJECT_ID

    • LOCATION을 데이터 세트 및 데이터 세트 구성이 있는 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • DATASET_CONFIG_ID를 연결하려는 데이터 세트를 생성한 데이터 세트 구성의 이름으로 바꿉니다.

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

연결된 데이터 세트 보기 및 쿼리

연결된 데이터 세트를 보고 쿼리하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

    프로젝트에서 생성된 데이터 세트 구성 목록이 표시됩니다.

  2. 확인하려는 데이터 세트 구성의 BigQuery 연결 데이터 세트를 클릭합니다.

    BigQuery 연결된 데이터 세트가 Google Cloud 콘솔에 표시됩니다. 메타데이터의 데이터 세트 스키마에 대한 자세한 내용은 메타데이터의 데이터 세트 스키마를 참고하세요.

  3. 다른 BigQuery 테이블을 쿼리할 때와 동일한 방식으로 연결된 데이터 세트의 테이블과 뷰를 쿼리할 수 있습니다.

데이터 세트 구성이 BigQuery 데이터 세트에 게시되지 않도록 하려면 데이터 세트의 연결을 해제합니다. 데이터 세트의 연결을 해제하려면 다음 단계를 완료하세요.

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

  2. 연결을 해제하려는 데이터 세트를 생성한 데이터 세트 구성의 이름을 클릭합니다.

  3. BigQuery 연결 데이터 세트 섹션에서 데이터 세트 연결 해제를 클릭하여 데이터 세트의 연결을 해제합니다.

  1. 데이터 세트의 연결을 해제하려면 gcloud storage insights dataset-configs delete-link 명령어를 실행합니다.

    gcloud storage insights dataset-configs delete-link DATASET_CONFIG_ID --location=LOCATION

    다음과 같이 바꿉니다.

    • DATASET_CONFIG_ID: 연결 해제하려는 데이터 세트를 생성한 데이터 세트 구성의 이름입니다.

    • LOCATION을 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    DATASET_CONFIG_NAME 및 LOCATION를 지정하는 대신 전체 데이터 세트 구성 경로를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    gcloud storage insights dataset-configs delete-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

    다음과 같이 바꿉니다.

    • DESTINATION_PROJECT_ID를 데이터 세트 구성이 포함된 프로젝트의 ID로 바꿉니다. 프로젝트 ID에 관한 자세한 내용은 프로젝트 만들기 및 관리를 참고하세요.

    • DATASET_CONFIG_ID: 연결 해제하려는 데이터 세트를 생성한 데이터 세트 구성의 이름입니다.

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. 다음 정보를 포함하는 JSON 파일을 만듭니다.

    {
  "name": "DATASET_NAME"
}

    다음과 같이 바꿉니다.

    • DATASET_NAME: 연결을 해제하려는 데이터 세트의 이름 예를 들면 my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2입니다.

  3. cURL를 사용하여 unlinkDataset DatasetConfig 요청으로 JSON API를 호출합니다.

    curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:unlinkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    다음과 같이 바꿉니다.

    • JSON_FILE_NAME을 이전 단계에서 만든 JSON 파일 경로로 바꿉니다.

    • 데이터 세트 구성이 속한 프로젝트의 ID가 포함된 PROJECT_ID

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • DATASET_CONFIG_ID을 연결 해제하려는 데이터 세트를 생성한 데이터 세트 구성의 이름으로 바꿉니다.

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

데이터 세트 구성 보기

데이터 세트 구성을 보려면 다음 단계를 완료하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

  2. 보려는 데이터 세트 구성의 이름을 클릭합니다.

    데이터 세트 구성 세부정보가 표시됩니다.

명령줄

  1. 데이터 세트 구성을 설명하려면 gcloud storage insights dataset-configs describe 명령어를 실행합니다.

    gcloud storage insights dataset-configs describe DATASET_CONFG_ID \
  --location=LOCATION

    다음과 같이 바꿉니다.

    • DATASET_CONFIG_ID을 데이터 세트 구성의 이름으로 바꿉니다.

    • LOCATION: 데이터 세트 및 데이터 세트 구성의 위치

    DATASET_CONFIG_NAME 및 LOCATION를 지정하는 대신 전체 데이터 세트 구성 경로를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

    다음과 같이 바꿉니다.

    • DESTINATION_PROJECT_ID를 데이터 세트 구성이 포함된 프로젝트의 ID로 바꿉니다. 프로젝트 ID에 관한 자세한 내용은 프로젝트 만들기 및 관리를 참고하세요.

    • DATASET_CONFIG_ID을 보려는 데이터 세트를 생성한 데이터 세트 구성의 이름으로 바꿉니다.

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

REST API

JSON API

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. cURL를 사용하여 Get DatasetConfig 요청으로 JSON API를 호출합니다.

    curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    다음과 같이 바꿉니다.

    • 데이터 세트 구성이 속한 프로젝트의 ID가 포함된 PROJECT_ID

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • DATASET_CONFIG_ID을 데이터 세트 구성의 이름으로 바꿉니다.

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

데이터 세트 구성 나열

프로젝트의 데이터 세트 구성을 나열하려면 다음 단계를 완료하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

    데이터 세트 구성 목록이 표시됩니다.

명령줄

  1. 프로젝트의 데이터 세트 구성을 나열하려면 gcloud storage insights dataset-configs list 명령어를 실행합니다.

    gcloud storage insights dataset-configs list --location=LOCATION

    다음과 같이 바꿉니다.

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    다음과 같은 선택적 플래그를 사용하여 등록정보 호출의 동작을 지정할 수 있습니다.

    • --page-size를 사용하여 페이지당 반환할 최대 결과 수를 지정합니다.

    • --filter=FILTER를 사용하여 결과를 필터링합니다. --filter 플래그 사용 방법에 관한 자세한 내용은 gcloud topic filters를 실행하고 문서를 참고하세요.

    • --sort-by=SORT_BY_VALUE를 사용하여 정렬할 리소스 필드 키 이름을 쉼표로 구분한 목록을 지정합니다. 예를 들면 --sort-by=DATASET_CONFIG_NAME입니다.

REST API

JSON API

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. cURL를 사용하여 Get DatasetConfig 요청으로 JSON API를 호출합니다.

    curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    다음과 같이 바꿉니다.

    • 데이터 세트 구성이 속한 프로젝트의 ID가 포함된 PROJECT_ID

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

데이터 세트 구성 업데이트

데이터 세트 구성을 업데이트하려면 다음 단계를 완료하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

  2. 업데이트할 데이터 세트 구성의 이름을 클릭합니다.

  3. 표시되는 데이터 세트 구성 탭에서 수정 을 클릭하여 필드를 업데이트합니다.

명령줄

  1. 데이터 세트 구성을 업데이트하려면 gcloud storage insights dataset-configs update 명령어를 실행합니다.

    gcloud storage insights dataset-configs update DATASET_CONFG_ID \
  --location=LOCATION

    다음과 같이 바꿉니다.

    • DATASET_CONFIG_ID을 데이터 세트 구성의 이름으로 바꿉니다.

    • LOCATION: 데이터 세트 및 데이터 세트 구성의 위치

    다음 플래그를 사용하여 데이터 세트 구성의 속성을 업데이트합니다.

    • --skip-verification를 사용하여 필수 IAM 권한 확인을 비롯한 인증 프로세스의 확인 및 실패를 건너뜁니다. 이 필터를 사용하면 일부 또는 모든 버킷이 데이터 세트에서 제외될 수 있습니다.

    • --retention-period-days=DAYS를 사용하여 데이터 세트 스냅샷에 캡처할 이동 일 수를 지정합니다. 예를 들면 90입니다.

    • --description=DESCRIPTION를 사용하여 데이터 세트 구성에 관한 설명을 작성합니다.

REST API

JSON API

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. 다음의 선택적 정보가 포함된 JSON 파일을 만듭니다.

    {
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": "PROJECT_NUMBERS"
  },
  "retention_period_days": RETENTION_PERIOD"
}

    다음과 같이 바꿉니다.

    • ORGANIZATION_ID를 소스 프로젝트가 속한 조직의 리소스 ID로 바꿉니다.

    • PROJECT_NUMBERS를 데이터 세트에 포함할 프로젝트 번호로 바꿉니다. 프로젝트는 하나 이상 지정할 수 있습니다. 프로젝트는 목록 형식으로 지정해야 합니다.

    • RETENTION_PERIOD: 데이터 세트 스냅샷에 캡처할 이동 일수입니다. 예를 들면 90입니다.

  3. 데이터 세트 구성을 업데이트하려면 cURL을 사용하여 Patch DatasetConfig 요청으로 JSON API를 호출합니다.

    curl -X PATCH --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID?updateMask=RETENTION_PERIOD" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    다음과 같이 바꿉니다.

    • JSON_FILE_NAME을 이전 단계에서 만든 JSON 파일 경로로 바꿉니다.

    • 데이터 세트 구성이 속한 프로젝트의 ID가 포함된 PROJECT_ID

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • DATASET_CONFIG_ID: 업데이트하려는 데이터 세트 구성의 이름

    • RETENTION_PERIOD: 데이터 세트 스냅샷에 캡처할 이동 일수입니다. 예를 들면 90입니다.

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

데이터 세트 구성 삭제

데이터 세트 구성을 삭제하려면 다음 단계를 완료하세요.

콘솔

  1. Google Cloud 콘솔에서 Cloud Storage 저장용량 통계 페이지로 이동합니다.

    Storage Insights로 이동

  2. 삭제할 데이터 세트 구성의 이름을 클릭합니다.

  3. 삭제 를 클릭합니다.

명령줄

  1. 데이터 세트 구성을 삭제하려면 gcloud storage insights dataset-configs delete 명령어를 실행합니다.

    gcloud storage insights dataset-configs delete DATASET_CONFG_ID \
  --location=LOCATION

    다음과 같이 바꿉니다.

    • DATASET_CONFIG_ID: 삭제하려는 데이터 세트 구성의 이름

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    다음 플래그를 사용하여 데이터 세트 구성의 속성을 업데이트합니다.

    • --auto-delete-link를 사용하여 삭제하려는 데이터 세트 구성에서 생성된 데이터 세트의 연결을 해제합니다. 데이터 세트를 생성한 데이터 세트 구성을 삭제하려면 먼저 데이터 세트의 연결을 해제해야 합니다.

    • --retention-period-days=DAYS를 사용하여 데이터 세트 스냅샷에 캡처할 데이터 일 수를 지정합니다. 예를 들면 90입니다.

    DATASET_CONFIG_NAME 및 LOCATION를 지정하는 대신 전체 데이터 세트 구성 경로를 지정할 수 있습니다. 예를 들면 다음과 같습니다.

    gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID

REST API

JSON API

  1. Authorization 헤더에 대한 액세스 토큰을 생성하려면 gcloud CLI가 설치 및 초기화되어 있어야 합니다.

  2. cURL를 사용하여 Delete DatasetConfig 요청으로 JSON API를 호출합니다.

    curl -X DELETE \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \

    다음과 같이 바꿉니다.

    • 데이터 세트 구성이 속한 프로젝트의 ID가 포함된 PROJECT_ID

    • LOCATION를 데이터 세트 및 데이터 세트 구성의 위치로 바꿉니다. 예를 들면 us-central1입니다.

    • DATASET_CONFIG_ID: 삭제하려는 데이터 세트 구성의 이름

    • ACCESS_TOKEN를 Google Cloud CLI를 설치하고 초기화할 때 생성한 액세스 토큰으로 바꿉니다.

다음 단계