View, update, and delete folders

Console

1. In the Cloud de Confiance console, open the Manage resources page.

   Open Manage resources page

2. The resource list displays your hierarchy as a table. Select your organization resource.

3. Click the arrow next to the organization name to expand the tree view and see its child folders.

4. To perform actions, such as moving, deleting, or viewing settings, click the more_vertActions at the end of the row for that specific resource.

5. Use the Filter bar at the top of the resource list to search for resources by name, ID, or label.

Using the project picker

Use the project picker in the top navigation bar to switch your active context to a specific project or folder.

1. In the top navigation bar of the Cloud de Confiance console, click the project picker. This is the drop-down menu located next to the Cloud de Confiance by S3NS logo.

2. In the dialog that appears, select your organization from the drop-down to filter the results.

3. Browse the hierarchy or search for the project or folder you want to switch to. Clicking a resource in this picker changes your global context, affecting which resources are visible in other service pages (like Compute Engine or Cloud Storage).

gcloud

To get details of one folder, use the resource-manager folders describe command.

gcloud resource-manager folders describe FOLDER_ID

Replace FOLDER_ID with the ID of the folder you want to view.

To list the child folders of an organization resource, use the resource-manager folders list command.

gcloud resource-manager folders list \
    --organization ORGANIZATION_ID

Replace ORGANIZATION_ID with the ID of the organization resource for which you want to see a list of child folders.

To list the child folders of a folder resource, use the resource-manager folders list command.

gcloud resource-manager folders list \
    --folder FOLDER_ID

Replace FOLDER_ID with the ID of the folder resource for which you want to see a list of child folders.

To list the projects under an organization or folder resource or folder, use the projects list command with the filter argument.

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

Replace RESOURCE_ID with the ID of the organization or folder resource for which you want to see a list of child projects.

REST

The curl request to get folders:

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

Replace FOLDER_NAME with the name of the folder, such as folders/123.

The curl request to list folders:

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

Replace PARENT_NAME with the name of the parent resource under which you're creating the folder, such as organizations/123 or folders/123.

Console

1. In the Cloud de Confiance console, open the Manage resources page.

   Open Manage resources page

2. Click the arrow next to the organization name to expand the tree view and see its child folders.

3. In the row of the folder you want to update, click the more_vertActions menu at the end of the row, and click Settings.

4. Enter the new folder name and click Save.

gcloud

To update a folder's display name:

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

Replace the following:

• FOLDER_ID: the ID of the folder you want to update.
• NEW_DISPLAY_NAME: the new display name for the folder.

REST

Before using any of the request data, make the following replacements:

• FOLDER_ID: the Cloud de Confiance by S3NS folder ID
• NEW_DISPLAY_NAME: the new display name for the folder

HTTP method and URL:

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

Request JSON body:

{
  "displayName": "NEW_DISPLAY_NAME"
}

To send your request, choose one of these options:

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"

$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

You should receive a JSON response similar to the following:

{
  "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
}

Console

The process of moving folders into other folders in the console is similar to moving projects.

1. In the Cloud de Confiance console, open the Manage resources page.

   Open Cloud de Confiance console

2. Select your organization resource from the Organization drop-down on the top left of the page.
3. Click your folder's row to select your folder from the list of projects and folders.
4. Click the options menu (the vertical ellipsis) in the row and click Move.
5. Click Browse to select the folder to which you want to move the folder.
6. Click Move.

gcloud

To move a folder under the organization resource, run the following command in the Google Cloud CLI:

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

Replace the following:

• FOLDER_ID: the ID of the folder you want to move.
• PARENT_ID: the ID of the parent organization resource.

To move a folder under another folder:

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

Replace the following:

• FOLDER_ID: the ID of the folder you want to move.
• PARENT_ID: the ID of the parent organization resource or folder.

REST

The request JSON:

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

The Move Folder curl request:

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

Replace the following:

• DESTINATION_FOLDER_ID: the ID of the folder under which you're moving another folder, for example 98765.
• DISPLAY_NAME: the display name of the folder being moved, for example "My Awesome Folder."

The Move Folder response:

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

The Get Operation curl request:

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

The Get Operation response:

{
  "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"
  }
}

Console

1. In the Cloud de Confiance console, open the Manage resources page.

   Open Manage resources page

   In the Cloud de Confiance console, go to the Manage resources page.

2. Click the arrow next to the organization name to expand the tree view and see its child folders.

3. In the row of the folder you want to delete, click the more_vertActions menu at the end of the row, and click Delete.

4. In the confirmation dialog, type the folder ID or name to confirm and click Delete.

gcloud

To delete a folder, run the following command:

gcloud resource-manager folders delete FOLDER_ID

Replace the following:

• FOLDER_ID: the ID of the folder you want to delete.

REST

Before using any of the request data, make the following replacements:

• FOLDER_ID: the Cloud de Confiance by S3NS folder ID

HTTP method and URL:

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

To send your request, choose one of these options:

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

$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

You should receive a JSON response similar to the following:

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