Esta página descreve como visualizar detalhes, atualizar configurações e excluir pastas usando o Google Cloud console, a Google Cloud CLI ou a API. Saiba como modificar os nomes de exibição das pastas e gerenciar o posicionamento delas na hierarquia da organização.
Listar pastas e visualizar detalhes
Para listar pastas ou visualizar metadados de uma pasta específica, como nome de exibição, ID pai e estado do ciclo de vida, é necessário ter o papel de Leitor de pastas (roles/resourcemanager.folderViewer) ou Leitor da organização (roles/resourcemanager.organizationViewer).
Console
No Google Cloud console, abra a página Gerenciar recursos.
A lista de recursos mostra sua hierarquia como uma tabela. Selecione o recurso da organização.
Clique na seta ao lado do nome da organização para expandir a visualização em árvore e conferir as pastas filhas.
Para realizar ações, como mover, excluir ou visualizar configurações, clique em Ações no final de a linha do recurso específico.
Use a barra Filtrar na parte de cima da lista de recursos para pesquisar recursos por nome, ID ou rótulo.
Usar o seletor de projetos
O seletor de projetos está localizado na barra de navegação e não faz parte da interface principal da página do Resource Manager. Use-o para mudar o contexto global ativo para um projeto ou pasta específica.
Clique no seletor de projetos. Na caixa de diálogo exibida, selecione a organização no menu suspenso para filtrar os resultados.
Navegue pela hierarquia ou pesquise o projeto ou a pasta que você quer mudar. Clicar em um recurso nesse seletor muda o contexto global, afetando quais recursos ficam visíveis em outras páginas de serviço (como Compute Engine ou Cloud Storage).
gcloud
Para conferir detalhes de uma pasta, use o comando resource-manager folders describe.
gcloud resource-manager folders describe FOLDER_ID
Substitua FOLDER_ID pelo ID da pasta que você quer visualizar.
Para listar as pastas filhas de um recurso da organização, use o comando resource-manager folders list.
gcloud resource-manager folders list \
--organization ORGANIZATION_ID
Substitua ORGANIZATION_ID pelo ID do recurso da organização que contém as pastas filhas que você quer listar.
Para listar as pastas filhas de um recurso de pasta, use o comando resource-manager folders list.
gcloud resource-manager folders list \
--folder FOLDER_ID
Substitua FOLDER_ID pelo ID do recurso de pasta que contém as pastas filhas que você quer listar.
Para listar os projetos em um recurso de organização ou pasta, use o comando projects list com o argumento filter.
gcloud projects list \
--filter=" parent.id: 'RESOURCE_ID' "
Substitua RESOURCE_ID pelo ID do recurso da organização ou pasta que contém os projetos filhos que você quer listar.
REST
A solicitação curl para receber pastas:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/FOLDER_ID
Substitua FOLDER_NAME pelo nome da pasta, como folders/123.
A solicitação curl para listar pastas:
curl -X GET -H "Content-Type: application/json" \
-H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/folders?parent=PARENT_NAME
Substitua PARENT_NAME pelo nome do recurso pai em que você está criando a pasta, como organizations/123 ou folders/123.
Atualizar pastas
Para atualizar o nome de exibição de uma pasta, é necessário ter o papel de Editor de pastas (roles/resourcemanager.folderEditor) ou Administrador de pastas (roles/resourcemanager.folderAdmin) na pasta.
Console
No Google Cloud console, abra a página Gerenciar recursos.
Clique na seta ao lado do nome da organização para expandir a visualização em árvore e conferir as pastas filhas.
Na linha da pasta que você quer atualizar, clique no Ações menu no final de a linha e em Configurações.
Insira o novo nome da pasta e clique em Salvar.
gcloud
Para atualizar o nome de exibição de uma pasta:
gcloud resource-manager folders update FOLDER_ID --display-name="NEW_DISPLAY_NAME"
Substitua:
FOLDER_ID: o ID da pasta que você quer atualizar.NEW_DISPLAY_NAME: o novo nome de exibição da pasta.
REST
Antes de usar os dados da solicitação abaixo, faça estas substituições:
- FOLDER_ID: o Google Cloud ID da pasta
- NEW_DISPLAY_NAME: o novo nome de exibição da pasta
Método HTTP e URL:
PATCH https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID?updateMask=displayName
Corpo JSON da solicitação:
{
"displayName": "NEW_DISPLAY_NAME"
}
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:
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
Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:
$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
Você receberá uma resposta JSON semelhante a esta:
{
"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
}
Mover uma pasta para outra
Para mover uma pasta para outra, é necessário ter a permissão resourcemanager.folders.move para as pastas de origem e de destino.
Console
O processo de transferência de uma pasta para outras pastas no console é semelhante ao de projetos.
- No Google Cloud console, abra a página Gerenciar recursos.
- Selecione o recurso da organização na lista suspensa Organização no canto superior esquerdo da página.
- Clique na linha da pasta para selecioná-la na lista de projetos e pastas.
- Clique no menu de opções (as reticências verticais) da linha e clique em Mover.
- Clique em Procurar para selecionar a pasta para que você quer mover a pasta.
- Clique em Mover.
gcloud
Para mover uma pasta no recurso da organização, execute o seguinte comando na Google Cloud CLI:
gcloud resource-manager folders move FOLDER_ID \ --organization=PARENT_ID
Substitua:
FOLDER_ID: o ID da pasta que você quer mover.PARENT_ID: o ID do recurso da organização pai.
Para mover uma pasta para outra pasta:
gcloud resource-manager folders move FOLDER_ID \ --folder=PARENT_ID
Substitua:
FOLDER_ID: o ID da pasta que você quer mover.PARENT_ID: o ID do recurso da organização ou pasta pai.
REST
A solicitação JSON:
request_json= '{
destinationParent: "folders/DESTINATION_FOLDER_ID"
}'
A solicitação curl Mover pasta:
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
Substitua:
- DESTINATION_FOLDER_ID: o ID da pasta para onde você está
movendo outra pasta. Por exemplo,
98765. - DISPLAY_NAME: o nome de exibição da pasta que está sendo movida. Por exemplo, "Minha pasta maravilhosa".
A resposta Mover pasta:
{
"name": "operations/fm.1234567890",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperation",
"displayName": "DISPLAY_NAME",
"operationType": "MOVE"
}
}
A solicitação curl Receber operação:
curl -H "Authorization: Bearer ${bearer_token}" \
https://cloudresourcemanager.googleapis.com/v3/operations/fm.1234567890
A resposta Receber operação:
{
"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"
}
}
Excluir pastas
Para excluir uma pasta, é necessário ter o papel de Editor de pastas (roles/resourcemanager.folderEditor) ou Administrador de pastas (roles/resourcemanager.folderAdmin) na pasta.
Console
No Google Cloud console, abra a página Gerenciar recursos.
No Google Cloud console, acesse a página Gerenciar recursos.Clique na seta ao lado do nome da organização para expandir a visualização em árvore e conferir as pastas filhas.
Na linha da pasta que você quer excluir, clique no menu Ações no final de linha e em Excluir.
Na caixa de diálogo de confirmação, digite o ID ou o nome da pasta para confirmar e clique em Excluir.
gcloud
Para excluir uma pasta, execute o seguinte comando:
gcloud resource-manager folders delete FOLDER_ID
Substitua:
FOLDER_ID: o ID da pasta que você quer excluir.
REST
Antes de usar os dados da solicitação abaixo, faça estas substituições:
- FOLDER_ID: o Google Cloud ID da pasta
Método HTTP e URL:
DELETE https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID
Para enviar a solicitação, escolha uma destas opções:
curl
Execute o seguinte comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://cloudresourcemanager.googleapis.com/v3/folders/FOLDER_ID"
PowerShell
Execute o seguinte comando:
$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
Você receberá uma resposta JSON semelhante a esta:
{
"name": "operations/fc.1234567890abcdef",
"metadata": {
"@type": "type.googleapis.com/google.cloud.resourcemanager.v3.FolderOperationMetadata",
"operationType": "DELETE",
"resourceName": "folders/FOLDER_ID"
},
"done": false
}
Informações adicionais
Quando você exclui uma pasta, ela entra em um estado de exclusão temporária por um período de retenção de 30 dias antes de ser excluída permanentemente.
Estado de exclusão temporária: durante o período de armazenamento de 30 dias, a pasta é marcada para exclusão e não fica mais ativa. Não é possível criar novos projetos ou subpastas em uma pasta excluída temporariamente.
Estado de exclusão permanente: após 30 dias, Google Cloud remove permanentemente a pasta e os metadados dela. Essa ação é irreversível.
Cancelar a exclusão: se você excluir uma pasta por engano, poderá restaurá-la na janela de
30 dias usando o comando gcloud resource-manager folders undelete ou
a API.
Pré-requisitos e restrições
- A pasta precisa estar vazia: não é possível excluir uma pasta que ainda contenha projetos ou subpastas ativos. Primeiro, é necessário mover ou excluir todos os recursos filhos.
- Permissões necessárias: para excluir ou cancelar a exclusão de uma pasta, é necessário ter o papel de Editor de pastas (
roles/resourcemanager.folderEditor) ou Administrador de pastas (roles/resourcemanager.folderAdmin).
Pesquisar
Para pesquisar pastas que correspondam à consulta especificada, use gcloud alpha resource-manager
folders search, transmitindo a condição na flag --query. O escopo da pesquisa são todas as pastas para as quais o usuário tem permissão de visualização.
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>
Todas as pastas para as quais o usuário tem permissão de visualização podem ser mostradas usando o comando gcloud folders search.
gcloud folders search
<table output showing all viewable folders>
A seguir
- Saiba como gerenciar projetos em pastas.
- Saiba mais sobre papéis e permissões para pastas.