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 enablecom 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-projectFOLDER_IDé o ID da pasta Google Cloud . Os IDs das pastas são numéricos, por exemplo,123456789012ORGANIZATION_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
cURLpara 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-projectUPDATE_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
cURLpara 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,123456789012UPDATE_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
cURLpara 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,79293024087UPDATE_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 describecom 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
cURLpara 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
cURLpara 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
cURLpara 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 parentou 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 updatecom 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-projectFOLDER_IDé o Google Cloud ID da pasta. Os IDs das pastas são numéricos, por exemplo,123456789012ORGANIZATION_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
cURLpara 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
cURLpara 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-projectUPDATE_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,123456789012UPDATE_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
cURLpara 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,79293024087UPDATE_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 disablecom 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
cURLpara 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
cURLpara 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
cURLpara 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.