Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

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

Google Cloud 콘솔, Google Cloud CLI 또는 Cloud Resource Manager API를 사용하여 폴더 세부정보를 보고, 표시 이름을 업데이트하고, 폴더를 이동하고, 불필요한 폴더를 삭제할 수 있습니다. 폴더를 관리하면 프로젝트와 팀이 발전함에 따라 리소스를 구성하고 Google Cloud 리소스 계층 구조를 유지할 수 있습니다.

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

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

콘솔

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

리소스 관리 페이지에서 폴더 및 프로젝트의 마지막 액세스 타임스탬프를 계산하는 방법은 마지막 액세스 타임스탬프 이해를 참조하세요.

프로젝트 선택 도구 사용

프로젝트 선택기는 탐색 메뉴에 있으며 기본 Resource Manager 페이지 인터페이스의 일부가 아닙니다. 활성 전역 컨텍스트를 특정 프로젝트 또는 폴더로 전환하는 데 사용합니다.

프로젝트 선택 도구를 클릭합니다. 표시된 대화상자의 드롭다운에서 조직을 선택하여 결과를 필터링합니다.
계층 구조를 둘러보거나 전환하려는 프로젝트 또는 폴더를 검색합니다. 이 선택 도구에서 리소스를 클릭하면 전역 컨텍스트가 변경되어 다른 서비스 페이지 (예: Compute Engine 또는 Cloud Storage)에 표시되는 리소스가 영향을 받습니다.

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

gcloud

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

gcloud resource-manager folders describe FOLDER_ID

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

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

gcloud resource-manager folders list \
    --organization=ORGANIZATION_ID

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

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

gcloud resource-manager folders list \
    --folder=FOLDER_ID

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

조직 또는 폴더 리소스에 속한 프로젝트를 나열하려면 gcloud 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).

폴더 업데이트

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

콘솔

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

gcloud

폴더의 표시 이름을 업데이트하려면 gcloud resource-manager folders update 명령어를 사용합니다.

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: 이동할 폴더의 표시 이름입니다(예: 'My Awesome Folder').

폴더 이동 응답:

{
  "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 에서 폴더와 해당 메타데이터를 영구적으로 삭제합니다. 이 작업은 되돌릴 수 없습니다.

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

기본 요건 및 제약조건

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

검색

특정 쿼리와 일치하는 폴더를 검색하려면 gcloud alpha resource-manager folders search 명령어를 사용하고 --query 플래그에 검색 조건을 전달합니다. 검색 범위에는 보기 권한이 있는 모든 폴더가 포함됩니다.

예를 들어 표시 이름이 vij로 시작하는 폴더(예: vijeta 또는 vijay-folder)를 검색하려면 다음 명령어를 실행합니다.

gcloud alpha resource-manager folders search --query="displayName:vij*"

삭제 대기 중인 폴더를 검색하려면 다음 명령어를 실행합니다.

gcloud alpha resource-manager folders search --query="state:DELETE_REQUESTED"

보기 권한이 있는 모든 폴더를 반환하려면 --query 플래그 없이 gcloud alpha resource-manager folders search 명령어를 실행합니다.

gcloud alpha resource-manager folders search

다음 단계

폴더 내 프로젝트 관리에 대해 알아봅니다.
폴더의 역할 및 권한에 대해 알아봅니다.

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

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

콘솔

gcloud

REST

폴더 업데이트

콘솔

gcloud

REST

curl

PowerShell

다른 폴더로 폴더 이동

콘솔

gcloud

REST

폴더 삭제

콘솔

gcloud

REST

curl

PowerShell

추가 정보

검색

다음 단계

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