Esta página descreve como configurar, ver, atualizar e desativar a inteligência de armazenamento para um recurso.
Funções necessárias
Para receber as autorizações de que
precisa para configurar e gerir a inteligência de armazenamento,
peça ao seu administrador para lhe conceder a
função do IAM Administrador de armazenamento (roles/storage.admin
)
no projeto, na pasta ou na organização.
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Esta função predefinida contém as autorizações necessárias para configurar e gerir a inteligência de armazenamento. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para configurar e gerir a inteligência de armazenamento:
-
Configure a inteligência de armazenamento:
storage.intelligenceConfigs.update
-
Veja uma configuração da inteligência de armazenamento:
storage.intelligenceConfigs.get
-
Atualize uma configuração de inteligência de armazenamento:
storage.intelligenceConfigs.update
-
Desative a inteligência de armazenamento:
storage.intelligenceConfigs.update
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Configure a inteligência de armazenamento
Consola
Na Google Cloud consola, aceda à página Configuração do Storage Intelligence.
Clique em Ativar inteligência de armazenamento.
Na caixa de diálogo Configurar inteligência de armazenamento, selecione o recurso para o qual quer configurar a inteligência de armazenamento.
Clique em Continuar.
Opcional: para incluir ou excluir segmentos específicos na configuração da inteligência de armazenamento, faça o seguinte:
Para selecionar grupos de dados de localizações específicas, use o menu Tipo de filtro. Para incluir ou excluir grupos, selecione a localização no menu localização. Para mais informações, consulte o artigo Filtre por localização.
Para selecionar contentores do Cloud Storage por nome, use o menu Tipo de filtro. Para incluir ou excluir contentores, especifique a expressão regular do nome do contentor e clique em Adicionar expressão regular. Para mais informações, consulte o artigo Filtrar por nome do contentor.
Clique em Ativar esta configuração.
Linha de comandos
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para configurar a inteligência de armazenamento, use o comando
gcloud alpha storage intelligence-configs enable
com uma das seguintes flags:--project
: configure a inteligência de armazenamento para um projeto. O valor é um ID do projeto. Por exemplo,my-project
.--sub-folder
: configurar a inteligência de armazenamento para uma pasta. O valor é um ID da pasta. Por exemplo,1234567890
.--organization
: configure a inteligência de armazenamento para uma organização. O valor é um ID da organização. Por exemplo,9876546738
.Por exemplo, o comando seguinte configura o Storage Intelligence para um projeto denominado
my-project
:gcloud alpha storage intelligence-configs enable --project=PROJECT_ID
Em que PROJECT_ID é um ID do projeto.
Para incluir ou excluir contentores específicos na configuração da análise inteligente de armazenamento, use qualquer uma das seguintes flags:
--exclude-bucket-regexes
: lista de expressões regulares de IDs de contentores a excluir da configuração da inteligência de armazenamento.--include-bucket-regexes
: lista de expressões regulares de IDs de contentores a incluir na configuração da inteligência de armazenamento.
Por exemplo, para excluir todos os contentores que contenham colddata nos respetivos nomes, use o seguinte comando:
gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata.*
Por exemplo, para excluir contentores com o nome colddata, use o seguinte comando:
gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata
Por exemplo, para excluir contentores com os nomes colour ou color, use o seguinte comando:
gcloud alpha storage intelligence-configs enable --organization=my-org --exclude-bucket-regexes=colou?r
Para incluir ou excluir contentores com base na respetiva localização na configuração da análise inteligente de armazenamento, use qualquer uma das seguintes flags:
--exclude-locations
: lista de localizações a excluir da configuração da inteligência de armazenamento.--include-locations
: lista de localizações a incluir na configuração da inteligência de armazenamento.
Por exemplo:
gcloud alpha storage intelligence-configs enable --sub-folder=123456 --include-locations=us-east1,us-west1
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro JSON com os seguintes detalhes:
name
: o nome da configuração da inteligência de armazenamento. Use qualquer um dos seguintes formatos:- Projeto:
projects/PROJECT_ID/locations/global/intelligenceConfig
- Pasta:
folders/FOLDER_ID/locations/global/intelligenceConfig
- Organização:
organizations/ORGANIZATION_ID/locations/global/intelligenceConfig
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
FOLDER_ID
é o ID da pasta Google Cloud . Os IDs das pastas são numéricos, por exemplo,123456789012
ORGANIZATION_ID
é o Google Cloud ID da organização. Os IDs das organizações são numéricos, por exemplo,123456789012
- Projeto:
- Configure o campo
editionConfig
. Para mais informações, consulte o artigo Configuração da edição. - Opcional: configure o objeto
filter
. Pode incluir ou excluir contentores com base nas localizações do Cloud Storage e nas expressões regulares do ID do contentor.
{ "name":"projects/PROJECT_ID/locations/global/intelligenceConfig", "editionConfig":"EDITION_CONFIGURATION", "filter":{ "includedCloudStorageBuckets":{ "bucketIdRegexes":[ "INCLUDED_BUCKET_ID_REGEX", ...] }, "excludedCloudStorageBuckets":{ "bucketIdRegexes":[ "EXCLUDED_BUCKET_ID_REGEX", ...] }, "includedCloudStorageLocations":{ "locations":[ "INCLUDED_BUCKET_LOCATION", ...] }, "excludedCloudStorageLocations":{ "locations":[ "EXCLUDED_BUCKET_LOCATION", ...] } } }
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
.EDITION_CONFIGURATION
é a configuração da edição do Storage Intelligence.- Opcional:
INCLUDED_BUCKET_ID_REGEX
é uma expressão regular que especifica os IDs dos contentores a incluir. Pode especificar uma ou várias expressões regulares como uma lista. - Opcional:
EXCLUDED_BUCKET_ID_REGEX
é uma expressão regular que especifica os IDs de grupos a excluir. Pode especificar uma ou várias expressões regulares como uma lista. - Opcional:
INCLUDED_BUCKET_LOCATION
é a localização onde quer incluir contentores na configuração da inteligência de armazenamento. Pode especificar uma ou várias localizações como uma lista. - Opcional:
EXCLUDED_BUCKET_LOCATION
é a localização onde quer excluir os contentores da configuração da inteligência de armazenamento. Pode especificar uma ou várias localizações como uma lista.
As secções seguintes descrevem como configurar a inteligência de armazenamento para um projeto, uma pasta ou uma organização através da API REST. Também pode usar a API REST para configurar a avaliação introdutória de 30 dias do Storage Intelligence. Configure a inteligência de armazenamento ou a avaliação introdutória de 30 dias da inteligência de armazenamento através de qualquer um dos seguintes métodos.
Configure a inteligência de armazenamento para um projeto
Use
cURL
para chamar a API JSON com um pedido para configurar a inteligência de armazenamento para um projeto.curl -X POST \ --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
UPDATE_MASK
é a lista separada por vírgulas dos nomes dos campos que este pedido atualiza. Os campos usam o formato FieldMask e fazem parte do recursoIntelligenceConfig
.
Configure a inteligência de armazenamento para uma pasta
Use
cURL
para chamar a API JSON com um pedido para configurar a inteligência de armazenamento para uma pasta.curl -X POST \ --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"
Onde:
FOLDER_ID
é o ID da pasta Google Cloud . Os IDs das pastas são numéricos, por exemplo,123456789012
UPDATE_MASK
é a lista separada por vírgulas dos nomes dos campos que este pedido atualiza. Os campos usam o formato FieldMask e fazem parte do recursoIntelligenceConfig
.
Configure a inteligência de armazenamento para uma organização
Use
cURL
para chamar a API JSON com um pedido para configurar a inteligência de armazenamento para uma organização.curl -X POST \ --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"
Onde:
ORGANIZATION_ID
é o Google Cloud ID da organização. Os IDs das organizações são numéricos, por exemplo,79293024087
UPDATE_MASK
é a lista separada por vírgulas dos nomes dos campos que este pedido atualiza. Os campos usam o formato FieldMask e fazem parte do recursoIntelligenceConfig
.
APIs REST
API JSON
Veja uma configuração da funcionalidade de inteligência de armazenamento
Consola
Na Google Cloud consola, aceda à página Configuração do Storage Intelligence.
Selecione o selecionador de projetos na parte superior da página.
Na caixa de diálogo Selecionar um recurso, selecione o recurso para o qual quer ver a configuração da inteligência de armazenamento.
Se um recurso tiver a funcionalidade de inteligência de armazenamento configurada, o campo Estado apresenta Enabled
. Para recursos que não têm a funcionalidade de estatísticas de armazenamento configurada, é apresentado o botão Configurar estatísticas de armazenamento.
Linha de comandos
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para ver a configuração da inteligência de armazenamento de um recurso, use o comando
gcloud alpha storage intelligence-configs describe
com uma das seguintes flags:--project
: veja a configuração da inteligência de armazenamento de um projeto. O valor é um ID do projeto. Por exemplo,my-project
.--sub-folder
: ver a configuração da funcionalidade de armazenamento inteligente para uma pasta. O valor é um ID da pasta. Por exemplo,1234567890
.--organization
: ver a configuração da inteligência de armazenamento de uma organização. O valor é um ID da organização. Por exemplo,9876546738
.Por exemplo, o comando seguinte apresenta a configuração do Storage Intelligence para um projeto denominado
my-project
:gcloud alpha storage intelligence-configs describe --project=PROJECT_ID
Em que PROJECT_ID é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,
my-project
.
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Os métodos para ver a configuração da inteligência de armazenamento de um recurso estão detalhados nas secções seguintes.
Veja a configuração da inteligência de armazenamento de um projeto
Use
cURL
para chamar a API JSON com um pedido para ver a configuração da Storage Intelligence para um projeto.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig"
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
.Veja a configuração da inteligência de armazenamento de uma pasta
Use
cURL
para chamar a API JSON com um pedido para ver a configuração da Storage Intelligence para uma pasta.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig"
Onde:
FOLDER_ID
é o Google Cloud ID da pasta. Os IDs das pastas são numéricos, por exemplo,123456789012
.Veja a configuração da inteligência de armazenamento de uma organização
Use
cURL
para chamar a API JSON com um pedido para ver a configuração da Storage Intelligence para uma organização.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig"
Onde:
ORGANIZATION_ID
é o Google Cloud ID da organização. Os IDs das organizações são numéricos, por exemplo,79293024087
.
APIs REST
API JSON
Atualize uma configuração da funcionalidade de armazenamento inteligente
Consola
Na Google Cloud consola, aceda à página Configuração do Storage Intelligence.
Selecione o selecionador de projetos na parte superior da página.
Na caixa de diálogo Selecionar um recurso, selecione o recurso para o qual quer atualizar a configuração da inteligência de armazenamento.
Na secção Vista geral, modifique qualquer uma das opções de configuração editáveis para satisfazer as suas necessidades. Por exemplo, pode desativar a inteligência de armazenamento para um recurso, alterar a configuração da edição para
Inherit from parent
ou alterar os filtros de contentores.
Linha de comandos
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para atualizar a configuração da inteligência de armazenamento de um recurso, use o comando
gcloud alpha storage intelligence-configs update
com uma das seguintes flags:--project
: atualize a configuração da inteligência de armazenamento para um projeto. O valor é um ID do projeto. Por exemplo,my-project
.--sub-folder
: atualize a configuração da análise inteligente de armazenamento para uma pasta. O valor é um ID da pasta. Por exemplo,1234567890
.--organization
: atualize a configuração da inteligência de armazenamento para uma organização. O valor é um ID da organização. Por exemplo,9876546738
.Por exemplo, o comando seguinte atualiza a configuração da Storage Intelligence para um projeto denominado
my-project
:gcloud alpha storage intelligence-configs update --project=PROJECT_ID
Em que PROJECT_ID é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,
my-project
.
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro JSON com os seguintes detalhes:
name
: o nome da configuração da inteligência de armazenamento. Use qualquer um dos seguintes formatos:- Projeto:
projects/PROJECT_ID/locations/global/intelligenceConfig
- Pasta:
folders/FOLDER_ID/locations/global/intelligenceConfig
- Organização:
organizations/ORGANIZATION_ID/locations/global/intelligenceConfig
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
FOLDER_ID
é o Google Cloud ID da pasta. Os IDs das pastas são numéricos, por exemplo,123456789012
ORGANIZATION_ID
é o Google Cloud ID da organização. Os IDs das organizações são numéricos, por exemplo,123456789012
- Projeto:
- Configure o campo
editionConfig
. Para mais informações, consulte o artigo Configuração da edição. - Opcional: configure o objeto
filter
. Pode incluir ou excluir contentores com base nas localizações do Cloud Storage e nas expressões regulares do ID do contentor.
{ "name":"projects/PROJECT_ID/locations/global/intelligenceConfig", "editionConfig":"EDITION_CONFIGURATION", "filter":{ "includedCloudStorageBuckets":{ "bucketIdRegexes":[ "INCLUDED_BUCKET_ID_REGEX", ...] }, "excludedCloudStorageBuckets":{ "bucketIdRegexes":[ "EXCLUDED_BUCKET_ID_REGEX", ...] }, "includedCloudStorageLocations":{ "locations":[ "INCLUDED_BUCKET_LOCATION", ...] }, "excludedCloudStorageLocations":{ "locations":[ "EXCLUDED_BUCKET_LOCATION", ...] } } }
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
.EDITION_CONFIGURATION
é a configuração da edição do Storage Intelligence.- Opcional:
INCLUDED_BUCKET_ID_REGEX
é uma expressão regular que especifica os IDs dos contentores a incluir. Pode especificar uma ou várias expressões regulares como uma lista. - Opcional:
EXCLUDED_BUCKET_ID_REGEX
é uma expressão regular que especifica os IDs de grupos a excluir. Pode especificar uma ou várias expressões regulares como uma lista. - Opcional:
INCLUDED_BUCKET_LOCATION
é a localização onde quer incluir contentores na configuração da inteligência de armazenamento. Pode especificar uma ou várias localizações como uma lista. - Opcional:
EXCLUDED_BUCKET_LOCATION
é a localização onde quer excluir os contentores da configuração da inteligência de armazenamento. Pode especificar uma ou várias localizações como uma lista.
As secções seguintes descrevem como atualizar a configuração da Storage Intelligence para um projeto, uma pasta ou uma organização. Atualize a configuração da inteligência de armazenamento através de um destes métodos.
Atualize a configuração da funcionalidade Storage Intelligence para um projeto
Use
cURL
para chamar a API JSON com um pedido para atualizar a configuração da Storage Intelligence para um projeto.curl -X PATCH \ --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"
Atualize a configuração da funcionalidade Storage Intelligence para uma pasta
Use
cURL
para chamar a API JSON com um pedido para atualizar a configuração da Storage Intelligence para uma pasta.Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
UPDATE_MASK
é a lista separada por vírgulas dos nomes dos campos que este pedido atualiza. Os campos usam o formato FieldMask e fazem parte do recursoIntelligenceConfig
.
curl -X PATCH \ --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"
Onde:
FOLDER_ID
é o ID da pasta Google Cloud . Os IDs das pastas são numéricos, por exemplo,123456789012
UPDATE_MASK
é a lista separada por vírgulas dos nomes dos campos que este pedido atualiza. Os campos usam o formato FieldMask e fazem parte do recursoIntelligenceConfig
.
Atualize a configuração da funcionalidade Storage Intelligence para uma organização
Use
cURL
para chamar a API JSON com um pedido para atualizar a configuração da inteligência de armazenamento de uma organização.curl -X PATCH \ --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig?updateMask=UPDATE_MASK"
Onde:
ORGANIZATION_ID
é o Google Cloud ID da organização. Os IDs das organizações são numéricos, por exemplo,79293024087
UPDATE_MASK
é a lista separada por vírgulas dos nomes dos campos que este pedido atualiza. Os campos usam o formato FieldMask e fazem parte do recursoIntelligenceConfig
.
APIs REST
API JSON
Desative a inteligência de armazenamento
Consola
Na Google Cloud consola, aceda à página Configuração do Storage Intelligence.
Selecione o selecionador de projetos na parte superior da página.
Na caixa de diálogo Selecionar um recurso, selecione o recurso para o qual quer desativar a inteligência de armazenamento.
Na secção Vista geral, clique em Ativado junto ao campo Estado.
Na caixa de diálogo apresentada, introduza Desativar e, de seguida, clique em Desativar.
Linha de comandos
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Para desativar a configuração da inteligência de armazenamento para um recurso, use o comando
gcloud alpha storage intelligence-configs disable
com uma das seguintes flags:--project
: desativar a configuração da inteligência de armazenamento para um projeto. O valor é um ID do projeto. Por exemplo,my-project
.--sub-folder
: desativar a configuração da inteligência de armazenamento para uma pasta. O valor é um ID da pasta. Por exemplo,1234567890
.--organization
: desative a configuração da inteligência de armazenamento para uma organização. O valor é um ID da organização. Por exemplo,9876546738
.Por exemplo, o comando seguinte desativa a configuração da Storage Intelligence para um projeto denominado
my-project
:gcloud alpha storage intelligence-configs disable --project=PROJECT_ID
Em que PROJECT_ID é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,
my-project
.
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Os métodos para desativar o armazenamento inteligente para um recurso estão detalhados nas secções seguintes.
Desative a inteligência de armazenamento para um projeto
Use
cURL
para chamar a API JSON com um pedido para atualizar a inteligência de armazenamento de um projeto.curl -X PATCH \ -H "Content-Type: application/json" \ -d '{ "edition_config": "DISABLED" }' \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=edition_config"
Onde:
PROJECT_ID
é o Google Cloud ID do projeto. Os IDs dos projetos são alfanuméricos, por exemplo,my-project
.Desative a inteligência de armazenamento para uma pasta
Use
cURL
para chamar a API JSON com um pedido para atualizar a inteligência de armazenamento de uma pasta.curl -X PATCH \ -H "Content-Type: application/json" \ -d '{ "edition_config": "DISABLED" }' \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig?updateMask=edition_config"
Onde:
FOLDER_ID
é o Google Cloud ID da pasta. Os IDs das pastas são numéricos, por exemplo,123456789012
.Desative a inteligência de armazenamento para uma organização
Use
cURL
para chamar a API JSON com um pedido para desativar a inteligência de armazenamento para uma organização.curl -X PATCH \ -H "Content-Type: application/json" \ -d '{ "edition_config": "DISABLED" }' \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig?updateMask=edition_config"
Onde:
ORGANIZATION_ID
é o Google Cloud ID da organização. Os IDs das organizações são numéricos, por exemplo,79293024087
.
APIs REST
API JSON
O que se segue?
- Saiba mais sobre os conjuntos de dados das estatísticas de armazenamento.
- Saiba como obter estatísticas de dados com a ajuda do Gemini.
- Saiba mais sobre os relatórios de inventário.
- Saiba mais acerca da mudança de contentores.