En esta página, se describe cómo configurar, ver, actualizar y, también, inhabilitar Storage Intelligence para un recurso.
Configura Storage Intelligence
En esta sección, se describe cómo configurar la Inteligencia de almacenamiento para un recurso.
Console
En la consola de Google Cloud, ve a la página de Configuración de Cloud Storage.
Haz clic en Configurar Storage Intelligence.
En el diálogo Configurar Storage Intelligence, selecciona el recurso para el que deseas configurar Storage Intelligence.
Haz clic en Continuar.
Opcional: Para incluir o excluir buckets específicos en la configuración de Storage Intelligence, haz lo siguiente:
Para seleccionar buckets de ubicaciones específicas, usa el menú tipo de filtro. Para incluir o excluir buckets, selecciona la ubicación en el menú Ubicación. Para obtener más información, consulta Cómo filtrar por ubicación.
Para seleccionar buckets de Cloud Storage por nombre, usa el menú tipo de filtro. Para incluir o excluir buckets, especifica la expresión regular del nombre del bucket y haz clic en Agregar expresión regular. Para obtener más información, consulta Cómo filtrar por nombre de bucket.
Haz clic en Habilitar esta configuración.
Línea 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 la Inteligencia de almacenamiento, usa el comando
gcloud alpha storage intelligence-configs enable
con una de las siguientes marcas:--project
: Configura la Inteligencia de almacenamiento para un proyecto. El valor es un ID de proyecto. Por ejemplo,my-project
.--sub-folder
: Configura la Inteligencia de almacenamiento para una carpeta. El valor es un ID de carpeta. Por ejemplo,1234567890
.--organization
: Configura Storage Intelligence para una organización. El valor es un ID de organización. Por ejemplo,9876546738
.Por ejemplo, el siguiente comando configura la Inteligencia de almacenamiento para un proyecto llamado
my-project
:gcloud alpha storage intelligence-configs enable --project=PROJECT_ID
En el ejemplo anterior, PROJECT_ID es un ID de proyecto.
Para incluir o excluir buckets específicos en la configuración de Storage Intelligence, usa cualquiera de las siguientes marcas:
--exclude-bucket-regexes
: Es la lista de regex de IDs de bucket que se excluirán de la configuración de Storage Intelligence.--include-bucket-regexes
: Es la lista de regex de IDs de bucket que se incluirán en la configuración de Storage Intelligence.
Por ejemplo, para excluir todos los buckets que contengan colddata en sus nombres, usa el siguiente comando:
gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata.*
Por ejemplo, para excluir buckets llamados colddata, usa el siguiente comando:
gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata
Por ejemplo, para excluir buckets con el nombre colour o color, usa el siguiente comando:
gcloud alpha storage intelligence-configs enable --organization=my-org --exclude-bucket-regexes=colou?r
Para incluir o excluir buckets según su ubicación en la configuración de Storage Intelligence, usa cualquiera de las siguientes marcas:
--exclude-locations
: Es una lista de ubicaciones que se excluirán de la configuración de Storage Intelligence.--include-locations
: Es la lista de ubicaciones que se incluirán en la configuración de Storage Intelligence.
Por ejemplo:
gcloud alpha storage intelligence-configs enable --sub-folder=123456 --include-locations=us-east1,us-west1
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo JSON con los siguientes detalles:
name
: Es el nombre de la configuración de Storage Intelligence. Usa cualquiera de los siguientes formatos:- Proyecto:
projects/PROJECT_ID/locations/global/intelligenceConfig
- Carpeta:
folders/FOLDER_ID/locations/global/intelligenceConfig
- Organización:
organizations/ORGANIZATION_ID/locations/global/intelligenceConfig
Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.FOLDER_ID
es el Google Cloud ID de la carpeta. Los IDs de carpeta son numéricos, por ejemplo,123456789012
.ORGANIZATION_ID
es el Google Cloud ID de la organización. Los IDs de la organización son numéricos, por ejemplo,123456789012
.
- Proyecto:
- Configura el campo
editionConfig
. Para obtener más información, consulta Configuración de la edición. - Opcional: Configura el objeto
filter
. Puedes incluir o excluir buckets según las ubicaciones de Cloud Storage y las expresiones 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", ...] } } }
Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.EDITION_CONFIGURATION
es la configuración de la edición de Storage Intelligence.- Opcional:
INCLUDED_BUCKET_ID_REGEX
es una expresión regular que especifica qué IDs de bucket se deben incluir. Puedes especificar una o varias expresiones regulares como una lista. - Opcional:
EXCLUDED_BUCKET_ID_REGEX
es una expresión regular que especifica qué IDs de bucket se deben excluir. Puedes especificar una o varias expresiones regulares como una lista. - Opcional:
INCLUDED_BUCKET_LOCATION
es la ubicación en la que deseas incluir buckets en la configuración de Storage Intelligence. Puedes especificar una o varias ubicaciones como una lista. - Opcional:
EXCLUDED_BUCKET_LOCATION
es la ubicación en la que deseas excluir los buckets de la configuración de Storage Intelligence. Puedes especificar una o varias ubicaciones como una lista.
En las siguientes secciones, se describe cómo configurar la Inteligencia de almacenamiento para un proyecto, una carpeta o una organización. Configura la Inteligencia de almacenamiento con cualquier uno de los siguientes métodos.
Configura Storage Intelligence para un proyecto
Usa
cURL
para llamar a la API de JSON con una solicitud para configurar la inteligencia de almacenamiento para un proyecto.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"
Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.UPDATE_MASK
es la lista separada por comas de los nombres de campo que actualiza esta solicitud. Los campos usan el formato FieldMask y forman parte del recursoIntelligenceConfig
.
Cómo configurar Storage Intelligence para una carpeta
Usa
cURL
para llamar a la API de JSON con una solicitud para configurar la Inteligencia de almacenamiento para una carpeta.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"
Aquí:
FOLDER_ID
es el Google Cloud ID de la carpeta. Los IDs de carpeta son numéricos, por ejemplo,123456789012
.UPDATE_MASK
es la lista separada por comas de los nombres de campo que actualiza esta solicitud. Los campos usan el formato FieldMask y forman parte del recursoIntelligenceConfig
.
Configura Storage Intelligence para una organización
Usa
cURL
para llamar a la API de JSON con una solicitud para configurar la inteligencia de almacenamiento para una organización.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"
Aquí:
ORGANIZATION_ID
es el Google Cloud ID de la organización. Los IDs de la organización son numéricos, por ejemplo,79293024087
.UPDATE_MASK
es la lista separada por comas de los nombres de campo que actualiza esta solicitud. Los campos usan el formato FieldMask y forman parte del recursoIntelligenceConfig
.
Cómo ver la configuración de Storage Intelligence
En esta sección, se describe cómo ver la configuración de Storage Intelligence de un recurso.
Console
En la consola de Google Cloud, ve a la página de Configuración de Cloud Storage.
Selecciona el selector de proyectos en la parte superior de la página.
En el diálogo Select a resource, selecciona el recurso para el que deseas ver la configuración de Storage Intelligence.
Si un recurso tiene configurada la función Storage Intelligence, el campo Estado muestra Enabled
. En el caso de los recursos que no tienen configurada la función, se muestra el botón Configurar Storage Intelligence.
Línea 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 la configuración de Storage Intelligence de un recurso, usa el comando
gcloud alpha storage intelligence-configs describe
con una de las siguientes marcas:--project
: Consulta la configuración de Storage Intelligence de un proyecto. El valor es un ID de proyecto. Por ejemplo,my-project
.--sub-folder
: Consulta la configuración de Storage Intelligence de una carpeta. El valor es un ID de carpeta. Por ejemplo,1234567890
.--organization
: Consulta la configuración de Storage Intelligence de una organización. El valor es un ID de organización. Por ejemplo,9876546738
.Por ejemplo, el siguiente comando muestra la configuración de Storage Intelligence para un proyecto llamado
my-project
:gcloud alpha storage intelligence-configs describe --project=PROJECT_ID
En el ejemplo anterior, PROJECT_ID es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,
my-project
.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.En las siguientes secciones, se detallan los métodos para ver la configuración de Storage Intelligence de un recurso.
Cómo ver la configuración de Storage Intelligence de un proyecto
Usa
cURL
para llamar a la API de JSON con una solicitud para ver la configuración de Storage Intelligence de un proyecto.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig"
Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.Cómo ver la configuración de Storage Intelligence de una carpeta
Usa
cURL
para llamar a la API de JSON con una solicitud para ver la configuración de Storage Intelligence de una carpeta.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig"
Aquí:
FOLDER_ID
es el Google Cloud ID de la carpeta. Los IDs de carpeta son numéricos, por ejemplo,123456789012
.Consulta la configuración de Storage Intelligence de una organización
Usa
cURL
para llamar a la API de JSON con una solicitud para ver la configuración de Storage Intelligence de una organización.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig"
Aquí:
ORGANIZATION_ID
es el Google Cloud ID de la organización. Los IDs de la organización son numéricos, por ejemplo,79293024087
.
Actualiza la configuración de Storage Intelligence
En esta sección, se describe cómo actualizar la configuración de Storage Intelligence de un recurso.
Console
En la consola de Google Cloud, ve a la página de Configuración de Cloud Storage.
Selecciona el selector de proyectos en la parte superior de la página.
En el cuadro de diálogo Select a resource, selecciona el recurso para el que deseas actualizar la configuración de Storage Intelligence.
En la sección Descripción general, modifica cualquiera de las opciones de configuración editables según tus necesidades. Por ejemplo, puedes inhabilitar la Inteligencia de almacenamiento para un recurso, cambiar la configuración de la edición a
Inherit from parent
o cambiar los filtros de bucket.
Línea 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 actualizar la configuración de Storage Intelligence de un recurso, usa el comando
gcloud alpha storage intelligence-configs update
con una de las siguientes marcas:--project
: Actualiza la configuración de Storage Intelligence de un proyecto. El valor es un ID de proyecto. Por ejemplo,my-project
.--sub-folder
: Actualiza la configuración de Storage Intelligence de una carpeta. El valor es un ID de carpeta. Por ejemplo,1234567890
.--organization
: Actualiza la configuración de Storage Intelligence de una organización. El valor es un ID de organización. Por ejemplo,9876546738
.Por ejemplo, el siguiente comando actualiza la configuración de Storage Intelligence para un proyecto llamado
my-project
:gcloud alpha storage intelligence-configs update --project=PROJECT_ID
En el ejemplo anterior, PROJECT_ID es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,
my-project
.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.Crea un archivo JSON con los siguientes detalles:
name
: Es el nombre de la configuración de Storage Intelligence. Usa cualquiera de los siguientes formatos:- Proyecto:
projects/PROJECT_ID/locations/global/intelligenceConfig
- Carpeta:
folders/FOLDER_ID/locations/global/intelligenceConfig
- Organización:
organizations/ORGANIZATION_ID/locations/global/intelligenceConfig
Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.FOLDER_ID
es el Google Cloud ID de la carpeta. Los IDs de carpeta son numéricos, por ejemplo,123456789012
.ORGANIZATION_ID
es el Google Cloud ID de la organización. Los IDs de la organización son numéricos, por ejemplo,123456789012
.
- Proyecto:
- Configura el campo
editionConfig
. Para obtener más información, consulta Configuración de la edición. - Opcional: Configura el objeto
filter
. Puedes incluir o excluir buckets según las ubicaciones de Cloud Storage y las expresiones 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", ...] } } }
Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.EDITION_CONFIGURATION
es la configuración de la edición de Storage Intelligence.- Opcional:
INCLUDED_BUCKET_ID_REGEX
es una expresión regular que especifica qué IDs de bucket se deben incluir. Puedes especificar una o varias expresiones regulares como una lista. - Opcional:
EXCLUDED_BUCKET_ID_REGEX
es una expresión regular que especifica qué IDs de bucket se deben excluir. Puedes especificar una o varias expresiones regulares como una lista. - Opcional:
INCLUDED_BUCKET_LOCATION
es la ubicación en la que deseas incluir buckets en la configuración de Storage Intelligence. Puedes especificar una o varias ubicaciones como una lista. - Opcional:
EXCLUDED_BUCKET_LOCATION
es la ubicación en la que deseas excluir los buckets de la configuración de Storage Intelligence. Puedes especificar una o varias ubicaciones como una lista.
En las siguientes secciones, se describe cómo actualizar la configuración de Storage Intelligence para un proyecto, una carpeta o una organización. Actualiza la configuración de Storage Intelligence con uno de estos métodos.
Actualiza la configuración de Storage Intelligence de un proyecto
Usa
cURL
para llamar a la API de JSON con una solicitud para actualizar la configuración de Storage Intelligence de un proyecto.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"
Actualiza la configuración de Storage Intelligence de una carpeta
Usa
cURL
para llamar a la API de JSON con una solicitud para actualizar la configuración de Storage Intelligence de una carpeta.Aquí:
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.UPDATE_MASK
es la lista de nombres de campos separados por comas que actualiza esta solicitud. Los campos usan el formato FieldMask y forman parte del 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"
Aquí:
FOLDER_ID
es el Google Cloud ID de la carpeta. Los IDs de carpeta son numéricos, por ejemplo,123456789012
.UPDATE_MASK
es la lista separada por comas de los nombres de campo que actualiza esta solicitud. Los campos usan el formato FieldMask y forman parte del recursoIntelligenceConfig
.
Actualiza la configuración de Storage Intelligence de una organización
Usa
cURL
para llamar a la API de JSON con una solicitud para actualizar la configuración de Storage Intelligence de una organización.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"
Aquí:
ORGANIZATION_ID
es el Google Cloud ID de la organización. Los IDs de la organización son numéricos, por ejemplo,79293024087
.UPDATE_MASK
es la lista separada por comas de los nombres de campo que actualiza esta solicitud. Los campos usan el formato FieldMask y forman parte del recursoIntelligenceConfig
.
Inhabilita Storage Intelligence
En esta sección, se describe cómo inhabilitar la Inteligencia de almacenamiento.
Console
En la consola de Google Cloud, ve a la página de Configuración de Cloud Storage.
Selecciona el selector de proyectos en la parte superior de la página.
En el diálogo Select a resource, selecciona el recurso para el que deseas inhabilitar la Inteligencia de almacenamiento.
En la sección Descripción general, haz clic en Habilitada junto al campo Estado.
En el cuadro de diálogo que aparece, ingresa Inhabilitar y, luego, haz clic en Inhabilitar.
Línea 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 inhabilitar la configuración de Storage Intelligence de un recurso, usa el comando
gcloud alpha storage intelligence-configs disable
con una de las siguientes marcas:--project
: Inhabilita la configuración de Storage Intelligence para un proyecto. El valor es un ID de proyecto. Por ejemplo,my-project
.--sub-folder
: Inhabilita la configuración de Storage Intelligence para una carpeta. El valor es un ID de carpeta. Por ejemplo,1234567890
.--organization
: Inhabilita la configuración de Storage Intelligence para una organización. El valor es un ID de organización. Por ejemplo,9876546738
.Por ejemplo, el siguiente comando inhabilita la configuración de Storage Intelligence para un proyecto llamado
my-project
:gcloud alpha storage intelligence-configs disable --project=PROJECT_ID
En el ejemplo anterior, PROJECT_ID es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,
my-project
.
API de REST
API de JSON
Tener la gcloud CLI instalada e inicializada, lo que te permite generar un token de acceso para el encabezado
Authorization
.En las siguientes secciones, se detallan los métodos para inhabilitar la Inteligencia de almacenamiento para un recurso.
Inhabilita la Inteligencia de almacenamiento para un proyecto
Usa
cURL
para llamar a la API de JSON con una solicitud para actualizar la inteligencia de almacenamiento de un proyecto.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"
En el ejemplo anterior,
PROJECT_ID
es el Google Cloud ID del proyecto. Los IDs de proyecto son alfanuméricos, por ejemplo,my-project
.Cómo inhabilitar la función de almacenamiento inteligente para una carpeta
Usa
cURL
para llamar a la API de JSON con una solicitud para actualizar la Inteligencia de almacenamiento de una carpeta.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"
Donde:
FOLDER_ID
es el Google Cloud ID de la carpeta. Los IDs de carpeta son numéricos, por ejemplo,123456789012
.Inhabilita Storage Intelligence para una organización
Usa
cURL
para llamar a la API de JSON con una solicitud para inhabilitar la Inteligencia de almacenamiento para una organización.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"
Donde:
ORGANIZATION_ID
es el Google Cloud ID de la organización. Los IDs de la organización son numéricos, por ejemplo,79293024087
.
¿Qué sigue?
- Obtén información sobre los conjuntos de datos de Storage Insights.
- Obtén información sobre los informes de inventario de Storage Insights.
- Obtén más información sobre la reubicación de buckets.