Configurar e gerenciar o Storage Intelligence

Esta página descreve como configurar, visualizar, atualizar e desativar a Storage Intelligence em um recurso.

Configurar o Storage Intelligence

Esta seção descreve como configurar o Storage Intelligence para um recurso.

Console

  1. No console do Google Cloud, acesse a página Configurações do Cloud Storage.

    Acesse configurações

  2. Clique em Configurar o Storage Intelligence.

  3. Na caixa de diálogo Configurar Storage Intelligence, selecione o recurso que você quer configurar para o Storage Intelligence.

  4. Clique em Continuar.

  5. Opcional: para incluir ou excluir buckets específicos na configuração do Storage Intelligence, faça o seguinte:

    1. Para selecionar buckets de um local específico, use o menu tipo de filtro. Para incluir ou excluir buckets, selecione o local no menu local. Para mais informações, consulte Filtrar por local.

    2. Para selecionar buckets do Cloud Storage por nome, use o menu tipo de filtro. Para incluir ou excluir buckets, especifique a expressão regular do nome do bucket e clique em Adicionar expressão regular. Para mais informações, consulte Filtrar por nome de bucket.

  6. Clique em Ativar essa configuração.

Linha de comando

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Para configurar o Storage Intelligence, use o comando gcloud alpha storage intelligence-configs enable com uma das seguintes flags:

    • --project: configurar o Storage Intelligence para um projeto. O valor é um ID do projeto. Por exemplo, my-project.

    • --sub-folder: configurar o Storage Intelligence para uma pasta. O valor é um ID de pasta. Por exemplo, 1234567890.

    • --organization: configurar o Storage Intelligence para uma organização. O valor é um ID da organização. Por exemplo, 9876546738.

      Por exemplo, o comando a seguir configura o Storage Intelligence para um projeto chamado my-project:

      gcloud alpha storage intelligence-configs enable --project=PROJECT_ID

      em que PROJECT_ID é o ID de um projeto.

    Para incluir ou excluir buckets específicos na configuração do Storage Intelligence, use qualquer uma das seguintes flags:

    • --exclude-bucket-regexes: lista de expressões regulares de ID de bucket a serem excluídas da configuração do Storage Intelligence.
    • --include-bucket-regexes: lista de expressões regulares de ID de bucket a serem incluídas na configuração do Storage Intelligence.

    Por exemplo, para excluir todos os buckets que contêm colddata nos nomes, use o seguinte comando:

    gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata.*

    Por exemplo, para excluir os buckets chamados colddata, use o seguinte comando:

    gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata

    Por exemplo, para excluir os buckets 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 buckets com base na localização na configuração do Storage Intelligence, use qualquer uma das seguintes flags:

    • --exclude-locations: lista de locais a serem excluídos da configuração do Storage Intelligence.
    • --include-locations: lista de locais a serem incluídos na configuração do Storage Intelligence.

    Exemplo:

    gcloud alpha storage intelligence-configs enable --sub-folder=123456 --include-locations=us-east1,us-west1

APIs REST

API JSON

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Crie um arquivo JSON com os seguintes detalhes:

    1. name: o nome da configuração do Storage Intelligence. Use 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

      Em que:

      • PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project
      • FOLDER_ID é o ID da pasta Google Cloud . Os IDs de pastas são numéricos, por exemplo, 123456789012
      • ORGANIZATION_ID é o ID da Google Cloud organização. Os IDs de organização são numéricos, por exemplo, 123456789012
    2. Configure o campo editionConfig. Para mais informações, consulte Configuração de edição.
    3. Opcional: configure o objeto filter. É possível incluir ou excluir buckets com base em locais do Cloud Storage e expressões regulares de ID de bucket.
        {
      "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",
                ...]
        }
      }
    }

    Em que:

    • PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto 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 quais IDs de bucket incluir. É possível especificar uma ou várias expressões regulares como uma lista.
    • Opcional: EXCLUDED_BUCKET_ID_REGEX é uma expressão regular que especifica quais IDs de bucket devem ser excluídos. É possível especificar uma ou várias expressões regulares como uma lista.
    • Opcional: INCLUDED_BUCKET_LOCATION é o local em que você quer incluir buckets na configuração do Storage Intelligence. É possível especificar um ou vários locais como uma lista.
    • Opcional: EXCLUDED_BUCKET_LOCATION é o local em que você quer excluir os buckets da configuração do Storage Intelligence. É possível especificar um ou vários locais como uma lista.

  3. As seções a seguir descrevem como configurar o Storage Intelligence para um projeto, pasta ou organização. Configure a Storage Intelligence usando qualquer um dos métodos a seguir.

    Configurar o Storage Intelligence para um projeto

    Use cURL para chamar a API JSON com uma solicitação para configurar o Storage Intelligence 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"

    Em que:

    • PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project
    • UPDATE_MASK é a lista separada por vírgulas de nomes de campos que esta solicitação atualiza. Os campos usam o formato FieldMask e fazem parte do recurso IntelligenceConfig.

    Configurar o Storage Intelligence para uma pasta

    Use cURL para chamar a API JSON com uma solicitação para configurar o Storage Intelligence 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"

    Em que:

    • FOLDER_ID é o ID da pasta Google Cloud . Os IDs de pastas são numéricos, por exemplo, 123456789012
    • UPDATE_MASK é a lista separada por vírgulas de nomes de campos que esta solicitação atualiza. Os campos usam o formato FieldMask e fazem parte do recurso IntelligenceConfig.

    Configurar o Storage Intelligence para uma organização

    Use cURL para chamar a API JSON com uma solicitação para configurar o Storage Intelligence 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"

    Em que:

    • ORGANIZATION_ID é o ID da Google Cloud organização. Os IDs de organização são numéricos, por exemplo, 79293024087
    • UPDATE_MASK é a lista separada por vírgulas de nomes de campos que esta solicitação atualiza. Os campos usam o formato FieldMask e fazem parte do recurso IntelligenceConfig.

Conferir a configuração do Storage Intelligence

Esta seção descreve como visualizar a configuração do Storage Intelligence para um recurso.

Console

  1. No console do Google Cloud, acesse a página Configurações do Cloud Storage.

    Acesse configurações

  2. Selecione o seletor de projetos na parte superior da página.

  3. Na caixa de diálogo Selecionar um recurso, selecione o recurso em que você quer ver a configuração do Storage Intelligence.

Se um recurso tiver o Storage Intelligence configurado, o campo Status vai mostrar Enabled. Para recursos que não têm o Storage Intelligence configurado, o botão Configurar o Storage Intelligence aparece.

Linha de comando

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Para conferir a configuração do Storage Intelligence de um recurso, use o comando gcloud alpha storage intelligence-configs describe com uma das seguintes flags:

    • --project: confira a configuração do Storage Intelligence para um projeto. O valor é um ID do projeto. Por exemplo, my-project.

    • --sub-folder: visualizar a configuração do Storage Intelligence para uma pasta. O valor é um ID de pasta. Por exemplo, 1234567890.

    • --organization: conferir a configuração do Storage Intelligence para uma organização. O valor é um ID da organização. Por exemplo, 9876546738.

      Por exemplo, o comando a seguir mostra a configuração do Storage Intelligence para um projeto chamado my-project:

      gcloud alpha storage intelligence-configs describe --project=PROJECT_ID

      em que PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project.

APIs REST

API JSON

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Os métodos para visualizar a configuração do Storage Intelligence de um recurso são detalhados nas seções a seguir.

    Conferir a configuração do Storage Intelligence de um projeto

    Use cURL para chamar a API JSON com uma solicitação para visualizar a configuração do 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"

    Em que:

    PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project.

    Conferir a configuração do Storage Intelligence para uma pasta

    Use cURL para chamar a API JSON com uma solicitação para visualizar a configuração do 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"

    Em que:

    FOLDER_ID é o ID da pasta Google Cloud . Os IDs de pastas são numéricos, por exemplo, 123456789012.

    Conferir a configuração do Storage Intelligence para uma organização

    Use cURL para chamar a API JSON com uma solicitação para visualizar a configuração do Storage Intelligence de 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"

    Em que:

    ORGANIZATION_ID é o ID da Google Cloud organização. Os IDs da organização são numéricos, por exemplo, 79293024087.

Atualizar a configuração do Storage Intelligence

Esta seção descreve como atualizar a configuração do Storage Intelligence para um recurso.

Console

  1. No console do Google Cloud, acesse a página Configurações do Cloud Storage.

    Acesse configurações

  2. Selecione o seletor de projetos na parte superior da página.

  3. Na caixa de diálogo Selecionar um recurso, selecione o recurso que você quer atualizar a configuração do Storage Intelligence.

  4. Na seção Visão geral, modifique qualquer uma das opções de configuração editáveis para atender às suas necessidades. Por exemplo, é possível desativar o Storage Intelligence para um recurso ou mudar a configuração de edição para Inherit from parent ou alterar os filtros de bucket.

Linha de comando

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Para atualizar a configuração do Storage Intelligence de um recurso, use o comando gcloud alpha storage intelligence-configs update com uma das seguintes flags:

    • --project: atualizar a configuração do Storage Intelligence para um projeto. O valor é um ID do projeto. Por exemplo, my-project.

    • --sub-folder: atualizar a configuração do Storage Intelligence para uma pasta. O valor é um ID de pasta. Por exemplo, 1234567890.

    • --organization: atualizar a configuração do Storage Intelligence para uma organização. O valor é um ID da organização. Por exemplo, 9876546738.

      Por exemplo, o comando a seguir atualiza a configuração do Storage Intelligence para um projeto chamado my-project:

      gcloud alpha storage intelligence-configs update --project=PROJECT_ID

      em que PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project.

APIs REST

API JSON

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Crie um arquivo JSON com os seguintes detalhes:

    1. name: o nome da configuração do Storage Intelligence. Use 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

      Em que:

      • PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project
      • FOLDER_ID é o ID da pasta Google Cloud . Os IDs de pastas são numéricos, por exemplo, 123456789012
      • ORGANIZATION_ID é o ID da Google Cloud organização. Os IDs de organização são numéricos, por exemplo, 123456789012
    2. Configure o campo editionConfig. Para mais informações, consulte Configuração de edição.
    3. Opcional: configure o objeto filter. É possível incluir ou excluir buckets com base em locais do Cloud Storage e expressões regulares de ID de bucket.
        {
      "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",
                ...]
        }
      }
    }

    Em que:

    • PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto 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 quais IDs de bucket incluir. É possível especificar uma ou várias expressões regulares como uma lista.
    • Opcional: EXCLUDED_BUCKET_ID_REGEX é uma expressão regular que especifica quais IDs de bucket devem ser excluídos. É possível especificar uma ou várias expressões regulares como uma lista.
    • Opcional: INCLUDED_BUCKET_LOCATION é o local em que você quer incluir buckets na configuração do Storage Intelligence. É possível especificar um ou vários locais como uma lista.
    • Opcional: EXCLUDED_BUCKET_LOCATION é o local em que você quer excluir os buckets da configuração do Storage Intelligence. É possível especificar um ou vários locais como uma lista.

  3. As seções a seguir descrevem como atualizar a configuração do Storage Intelligence para um projeto, pasta ou organização. Atualize a configuração da Storage Intelligence usando um destes métodos.

    Atualizar a configuração do Storage Intelligence para um projeto

    Use cURL para chamar a API JSON com uma solicitação para atualizar a configuração do 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"

    Atualizar a configuração do Storage Intelligence para uma pasta

    Use cURL para chamar a API JSON com uma solicitação para atualizar a configuração do Storage Intelligence para uma pasta.

    Em que:

    • PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project
    • UPDATE_MASK é a lista separada por vírgulas de nomes de campos que esta solicitação atualiza. Os campos usam o formato FieldMask e fazem parte do recurso IntelligenceConfig.

     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"

    Em que:

    • FOLDER_ID é o ID da pasta Google Cloud . Os IDs de pastas são numéricos, por exemplo, 123456789012
    • UPDATE_MASK é a lista separada por vírgulas de nomes de campos que esta solicitação atualiza. Os campos usam o formato FieldMask e fazem parte do recurso IntelligenceConfig.

    Atualizar a configuração do Storage Intelligence para uma organização

    Use cURL para chamar a API JSON com uma solicitação para atualizar a configuração do Storage Intelligence para 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"

    Em que:

    • ORGANIZATION_ID é o ID da Google Cloud organização. Os IDs de organização são numéricos, por exemplo, 79293024087
    • UPDATE_MASK é a lista separada por vírgulas de nomes de campos que esta solicitação atualiza. Os campos usam o formato FieldMask e fazem parte do recurso IntelligenceConfig.

Desativar o Storage Intelligence

Esta seção descreve como desativar o Storage Intelligence.

Console

  1. No console do Google Cloud, acesse a página Configurações do Cloud Storage.

    Acesse configurações

  2. Selecione o seletor de projetos na parte superior da página.

  3. Na caixa de diálogo Selecionar um recurso, selecione o recurso para o qual você quer desativar o Storage Intelligence.

  4. Na seção Informações gerais, clique em Ativado ao lado do campo Status.

  5. Na caixa de diálogo exibida, digite Desativar e clique em Desativar.

Linha de comando

  1. In the Google Cloud console, activate Cloud Shell.

    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.

  2. Para desativar a configuração do Storage Intelligence para um recurso, use o comando gcloud alpha storage intelligence-configs disable com uma das seguintes flags:

    • --project: desative a configuração do Storage Intelligence para um projeto. O valor é um ID do projeto. Por exemplo, my-project.

    • --sub-folder: desative a configuração do Storage Intelligence para uma pasta. O valor é um ID de pasta. Por exemplo, 1234567890.

    • --organization: desative a configuração do Storage Intelligence para uma organização. O valor é um ID da organização. Por exemplo, 9876546738.

      Por exemplo, o comando a seguir desativa a configuração do Storage Intelligence para um projeto chamado my-project:

      gcloud alpha storage intelligence-configs disable --project=PROJECT_ID

      em que PROJECT_ID é o ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project.

APIs REST

API JSON

  1. Ter a CLI gcloud instalada e inicializada, o que permite gerar um token de acesso para o cabeçalho Authorization.

  2. Os métodos para desativar o Storage Intelligence em um recurso são detalhados nas seções a seguir.

    Desativar a Storage Intelligence para um projeto

    Use cURL para chamar a API JSON com uma solicitação para atualizar o Storage Intelligence para 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 ID do projeto Google Cloud . Os IDs de projeto são alfanuméricos, por exemplo, my-project.

    Desativar a Storage Intelligence em uma pasta

    Use cURL para chamar a API JSON com uma solicitação para atualizar o Storage Intelligence para 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"

    Em que
    FOLDER_ID é o ID da pasta Google Cloud . Os IDs de pastas são numéricos, por exemplo, 123456789012.

    Desativar o Storage Intelligence para uma organização

    Use cURL para chamar a API JSON com uma solicitação para desativar o Storage Intelligence 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 ID da Google Cloud organização. Os IDs da organização são numéricos, por exemplo, 79293024087.

A seguir