폴더 보기, 업데이트, 삭제

이 페이지에서는 콘솔, Google Cloud CLI 또는 API를 사용하여 폴더 세부정보를 보고, 폴더 설정을 업데이트하고, 폴더를 삭제하는 방법을 설명합니다. Google Cloud 폴더 표시 이름을 수정하고 조직의 계층 구조 내에서 폴더 배치를 관리하는 방법을 알아보세요.

폴더 나열 및 폴더 세부정보 보기

폴더를 나열하거나 표시 이름, 상위 ID, 수명 주기 상태와 같은 특정 폴더의 메타데이터를 보려면 폴더 뷰어 역할 (roles/resourcemanager.folderViewer) 또는 조직 뷰어 역할 (roles/resourcemanager.organizationViewer)이 있어야 합니다.

콘솔

콘솔에서 리소스 관리 페이지를 엽니다. Google Cloud
리소스 관리 페이지 열기
리소스 목록에 계층 구조가 표로 표시됩니다. 조직 리소스를 선택합니다.
조직 이름 옆에 있는 화살표를 클릭하여 트리 뷰를 펼치고 하위 폴더를 확인합니다.
이동, 삭제, 설정 보기와 같은 작업을 실행하려면 특정 리소스의 행 끝에 있는 작업 을 클릭합니다.
리소스 목록 상단의 필터 표시줄을 사용하여 이름, ID 또는 라벨로 리소스를 검색합니다.

프로젝트 선택기 사용

상단 탐색 메뉴의 프로젝트 선택기를 사용하여 활성 컨텍스트를 특정 프로젝트 또는 폴더로 전환합니다.

콘솔의 상단 탐색 메뉴에서 프로젝트 선택기를 클릭합니다. Google Cloud Google Cloud 로고 옆에 있는 드롭다운 메뉴입니다.
표시된 대화상자에서 드롭다운에서 조직을 선택하여 결과를 필터링합니다.
계층 구조를 탐색하거나 전환하려는 프로젝트 또는 폴더를 검색합니다. 이 선택기에서 리소스를 클릭하면 전역 컨텍스트가 변경되어 Compute Engine 또는 Cloud Storage와 같은 다른 서비스 페이지에 표시되는 리소스에 영향을 미칩니다.

참고: 프로젝트 선택기에 리소스를 최대 4,000개까지 표시할 수 있습니다. 표시되어야 하는 리소스가 표시되지 않으면 리소스 관리 페이지로 이동하고 리소스 이름을 사용하여 목록을 필터링하세요.

gcloud

폴더 하나의 세부정보를 가져오려면 resource-manager folders describe 명령어를 사용합니다.

gcloud resource-manager folders describe FOLDER_ID

FOLDER_ID를 보려는 폴더의 ID로 바꿉니다.

조직 리소스의 하위 폴더를 나열하려면 resource-manager folders list 명령어를 사용합니다.

gcloud resource-manager folders list \
    --organization ORGANIZATION_ID

ORGANIZATION_ID를 하위 폴더 목록을 보려는 조직 리소스의 ID로 바꿉니다.

폴더 리소스의 하위 폴더를 나열하려면 resource-manager folders list 명령어를 사용합니다.

gcloud resource-manager folders list \
    --folder FOLDER_ID

FOLDER_ID를 하위 폴더 목록을 보려는 폴더 리소스의 ID로 바꿉니다.

조직, 폴더 리소스 또는 폴더에 속한 프로젝트를 나열하려면 projects list 명령어와 filter 인수를 사용합니다.

gcloud projects list \
    --filter=" parent.id: 'RESOURCE_ID' "

RESOURCE_ID를 하위 프로젝트 목록을 보려는 조직 또는 폴더 리소스의 ID로 바꿉니다.

REST

폴더를 가져오기 위한 curl 요청:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID

FOLDER_NAME을 폴더 이름으로 바꿉니다(예: folders/123).

폴더를 나열하기 위한 curl 요청:

curl -X GET -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${bearer_token}" \
  https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME

PARENT_NAME을 폴더 생성 시의 상위 리소스 이름으로 바꿉니다(예: organizations/123 또는 folders/123).

Google Cloud

폴더 업데이트

폴더의 표시 이름을 업데이트하려면 폴더에 폴더 편집자 역할 (roles/resourcemanager.folderEditor) 또는 폴더 관리자 역할 (roles/resourcemanager.folderAdmin)이 있어야 합니다.

콘솔

콘솔에서 리소스 관리 페이지를 엽니다. Google Cloud
리소스 관리 페이지 열기
조직 이름 옆에 있는 화살표를 클릭하여 트리 뷰를 펼치고 하위 폴더를 확인합니다.
업데이트하려는 폴더의 행에서 행 끝에 있는 작업 메뉴를 클릭하고 설정을 클릭합니다.
새 폴더 이름을 입력하고 저장 을 클릭합니다.

gcloud

폴더의 표시 이름을 업데이트하려면 다음 단계를 따르세요.

gcloud resource-manager folders update FOLDER_ID --display-name="NEW_DISPLAY_NAME"

다음을 바꿉니다.

FOLDER_ID: 업데이트하려는 폴더의 ID입니다.
NEW_DISPLAY_NAME: 폴더의 새 표시 이름입니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

FOLDER_ID: Google Cloud 폴더 ID
NEW_DISPLAY_NAME: 폴더의 새 표시 이름

HTTP 메서드 및 URL:

PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName

JSON 요청 본문:

{
  "displayName": "NEW_DISPLAY_NAME"
}

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName"

PowerShell

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "displayName": "NEW_DISPLAY_NAME",
    "operationType": "UPDATE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

다른 폴더로 폴더 이동

폴더를 다른 폴더로 이동하려면 소스 폴더와 대상 폴더 모두에 resourcemanager.folders.move 권한이 있어야 합니다.

콘솔

콘솔에서 폴더를 다른 폴더로 이동하는 과정은 프로젝트를 이동하는 과정과 유사합니다.

콘솔에서 리소스 관리 페이지를 엽니다. Google Cloud
콘솔 Google Cloud 열기
페이지 왼쪽 상단의 조직 드롭다운에서 조직 리소스를 선택합니다.
프로젝트 및 폴더 목록에서 폴더의 행을 클릭하여 폴더를 선택합니다.
행에서 옵션 메뉴(세로 생략 기호)를 클릭하고 이동을 클릭합니다.
찾아보기를 클릭하고 폴더를 이동할 대상 폴더를 선택합니다.
이동을 클릭합니다.

gcloud

폴더를 조직 리소스로 이동하려면 Google Cloud CLI에서 다음 명령어를 실행합니다.

gcloud resource-manager folders move FOLDER_ID \
    --organization=PARENT_ID

다음을 바꿉니다.

FOLDER_ID: 이동하려는 폴더의 ID입니다.
PARENT_ID: 상위 조직 리소스의 ID입니다.

폴더를 다른 폴더로 이동하는 명령어는 다음과 같습니다.

gcloud resource-manager folders move FOLDER_ID \
    --folder=PARENT_ID

다음을 바꿉니다.

FOLDER_ID: 이동하려는 폴더의 ID입니다.
PARENT_ID: 상위 조직 리소스 또는 폴더의 ID입니다.

REST

요청 JSON:

request_json= '{
   destinationParent: "folders/DESTINATION_FOLDER_ID"
}'

폴더 이동 curl 요청:

curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token} \
-d "$request_json" \
https://cloudresourcemanager.googleapis.com/v3/folders/DISPLAY_NAME:move

다음을 바꿉니다.

DESTINATION_FOLDER_ID: 다른 폴더를 이동하는 폴더의 ID입니다(예: 98765).
DISPLAY_NAME: 이동 중인 폴더의 표시 이름입니다(예: "내 멋진 폴더").

폴더 이동 응답:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  }
}

작업 가져오기 curl 요청:

curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890

작업 가져오기 응답:

{
  "name": "operations/fm.1234567890",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
    "displayName": "DISPLAY_NAME",
    "operationType": "MOVE"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.Folder",
    "name": "folders/12345",
    "parent": "folders/98765",
    "displayName": "DISPLAY_NAME",
    "lifecycleState": "ACTIVE",
    "createTime": "2017-07-19T23:29:26.018Z",
    "updateTime": "2017-07-20T00:54:44.295Z"
  }
}

폴더 삭제

폴더를 삭제하려면 폴더에 폴더 편집자 역할 (roles/resourcemanager.folderEditor) 또는 폴더 관리자 역할 (roles/resourcemanager.folderAdmin)이 있어야 합니다.

콘솔

콘솔에서 리소스 관리 페이지를 엽니다. Google Cloud
리소스 관리 페이지 열기
콘솔에서 리소스 관리 페이지로 이동합니다. Google Cloud
조직 이름 옆에 있는 화살표를 클릭하여 트리 뷰를 펼치고 하위 폴더를 확인합니다.
삭제하려는 폴더의 행에서 행 끝에 있는 작업 메뉴를 클릭하고 삭제를 클릭합니다.
확인 대화상자에서 폴더 ID 또는 이름을 입력하여 확인하고 삭제 를 클릭합니다.

gcloud

폴더를 삭제하려면 다음 명령어를 실행합니다.

gcloud resource-manager folders delete FOLDER_ID

다음을 바꿉니다.

FOLDER_ID: 삭제하려는 폴더의 ID입니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

FOLDER_ID: Google Cloud 폴더 ID

HTTP 메서드 및 URL:

DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID

요청을 보내려면 다음 옵션 중 하나를 선택합니다.

curl

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"

PowerShell

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "operations/fc.1234567890abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
    "operationType": "DELETE",
    "resourceName": "folders/FOLDER_ID"
  },
  "done": false
}

추가 정보

폴더를 삭제하면 영구 삭제 또는 완전 삭제되기 전에 30일 보관 기간 동안 일시 삭제된 상태가 됩니다.

일시 삭제 상태: 30일 보관 기간 동안 폴더는 삭제 대상으로 표시되며 더 이상 활성 상태가 아닙니다. 일시 삭제된 폴더 내에서 새 프로젝트 또는 하위 폴더를 만들 수 없습니다.

완전 삭제 상태: 30일 후 Google Cloud 폴더와 메타데이터가 영구적으로 삭제됩니다. 이 작업은 되돌릴 수 없습니다.

삭제 취소: 실수로 폴더를 삭제한 경우 명령어 또는 API를 사용하여 30일 이내에 복원할 수 있습니다.gcloud resource-manager folders undelete

기본 요건 및 제약조건

폴더가 비어 있어야 함: 활성 프로젝트 또는 하위 폴더가 아직 포함된 폴더는 삭제할 수 없습니다. 먼저 모든 하위 리소스를 이동하거나 삭제해야 합니다.
필수 권한: 폴더를 삭제하거나 삭제 취소하려면 폴더 편집자 (roles/resourcemanager.folderEditor) 또는 폴더 관리자(roles/resourcemanager.folderAdmin) 역할이 있어야 합니다.

검색

지정된 쿼리와 일치하는 폴더를 검색하려면 gcloud alpha resource-manager folders search를 사용하여 --query 플래그에 조건을 전달합니다. 검색 범위는 사용자가 보기 권한을 가지고 있는 모든 폴더입니다.

gcloud alpha resource-manager folders search --query="name:vij*"
<table output showing the folders with names starting from vij eg. vijeta, vijay-folder>

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"
<table output showing folders for which delete has been requested>

사용자가 보기 권한을 가지는 모든 폴더는 gcloud folders search 명령어를 사용하여 표시할 수 있습니다.

gcloud folders search
<table output showing all viewable folders>

다음 단계

폴더 내에서 프로젝트를 관리하는 방법을 알아봅니다.
폴더의 역할 및 권한에 대해 알아봅니다.

폴더 보기, 업데이트, 삭제 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

폴더 나열 및 폴더 세부정보 보기

콘솔

gcloud

REST

폴더 업데이트

콘솔

gcloud

REST

curl

PowerShell

다른 폴더로 폴더 이동

콘솔

gcloud

REST

폴더 삭제

콘솔

gcloud

REST

curl

PowerShell

추가 정보

검색

다음 단계

폴더 보기, 업데이트, 삭제