Cette page explique comment configurer, afficher, mettre à jour et désactiver Storage Intelligence pour une ressource.
Configurer Storage Intelligence
Cette section explique comment configurer Storage Intelligence pour une ressource.
Console
Dans la console Google Cloud, accédez à la page Paramètres de Cloud Storage.
Cliquez sur Configurer Storage Intelligence.
Dans la boîte de dialogue Configurer Storage Intelligence, sélectionnez la ressource pour laquelle vous souhaitez configurer Storage Intelligence.
Cliquez sur Continuer.
Facultatif: Pour inclure ou exclure des buckets spécifiques dans votre configuration Storage Intelligence, procédez comme suit:
Pour sélectionner des buckets à partir d'un emplacement spécifique, utilisez le menu Type de filtre. Pour inclure ou exclure des buckets, sélectionnez l'emplacement dans le menu Emplacement. Pour en savoir plus, consultez Filtrer par zone géographique.
Pour sélectionner des buckets Cloud Storage par nom, utilisez le menu Type de filtre. Pour inclure ou exclure des buckets, spécifiez l'expression régulière du nom du bucket, puis cliquez sur Ajouter une expression régulière. Pour en savoir plus, consultez la section Filtrer par nom de bucket.
Cliquez sur Activer cette configuration.
Ligne de commande
-
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.
Pour configurer Storage Intelligence, exécutez la commande
gcloud alpha storage intelligence-configs enable
avec l'une des options suivantes:--project
: configurez Storage Intelligence pour un projet. La valeur est un ID de projet. Par exemple,my-project
.--sub-folder
: configurer Storage Intelligence pour un dossier. La valeur est un ID de dossier. Par exemple,1234567890
.--organization
: configurer Storage Intelligence pour une organisation. La valeur est un ID d'organisation. Par exemple,9876546738
.Par exemple, la commande suivante configure Storage Intelligence pour un projet appelé
my-project
:gcloud alpha storage intelligence-configs enable --project=PROJECT_ID
où PROJECT_ID est un ID de projet.
Pour inclure ou exclure des buckets spécifiques dans votre configuration Storage Intelligence, utilisez n'importe quel des indicateurs suivants:
--exclude-bucket-regexes
: liste des expressions régulières d'ID de bucket à exclure de la configuration de Storage Intelligence.--include-bucket-regexes
: liste des expressions régulières d'ID de bucket à inclure dans la configuration de Storage Intelligence.
Par exemple, pour exclure tous les buckets dont le nom contient colddata, utilisez la commande suivante:
gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata.*
Par exemple, pour exclure les buckets nommés colddata, utilisez la commande suivante:
gcloud alpha storage intelligence-configs enable --organization=54343 --exclude-bucket-regexes=colddata
Par exemple, pour exclure les buckets nommés couleur ou color, utilisez la commande suivante:
gcloud alpha storage intelligence-configs enable --organization=my-org --exclude-bucket-regexes=colou?r
Pour inclure ou exclure des buckets en fonction de leur emplacement dans la configuration de Storage Intelligence, utilisez n'importe quel des indicateurs suivants:
--exclude-locations
: liste des emplacements à exclure de la configuration de Storage Intelligence.--include-locations
: liste des emplacements à inclure dans la configuration de Storage Intelligence.
Exemple :
gcloud alpha storage intelligence-configs enable --sub-folder=123456 --include-locations=us-east1,us-west1
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Créez un fichier JSON avec les informations suivantes:
name
: nom de la configuration Storage Intelligence. Utilisez l'un des formats suivants :- Projet :
projects/PROJECT_ID/locations/global/intelligenceConfig
- Dossier :
folders/FOLDER_ID/locations/global/intelligenceConfig
- Organisation :
organizations/ORGANIZATION_ID/locations/global/intelligenceConfig
Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques (par exemple,my-project
).FOLDER_ID
correspond à l' Google Cloud ID du dossier. Les ID de dossier sont numériques (par exemple,123456789012
).ORGANIZATION_ID
est l' Google Cloud ID de l'organisation. Les identifiants des organisations sont numériques (par exemple,123456789012
).
- Projet :
- Configurez le champ
editionConfig
. Pour en savoir plus, consultez Configuration de l'édition. - Facultatif: configurez l'objet
filter
. Vous pouvez inclure ou exclure des buckets en fonction des emplacements Cloud Storage et des expressions régulières d'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", ...] } } }
Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques, par exemplemy-project
.EDITION_CONFIGURATION
correspond à la configuration de l'édition Storage Intelligence.- Facultatif:
INCLUDED_BUCKET_ID_REGEX
est une expression régulière qui spécifie les ID de bucket à inclure. Vous pouvez spécifier une ou plusieurs expressions régulières sous la forme d'une liste. - Facultatif:
EXCLUDED_BUCKET_ID_REGEX
est une expression régulière qui spécifie les ID de bucket à exclure. Vous pouvez spécifier une ou plusieurs expressions régulières sous la forme d'une liste. - Facultatif:
INCLUDED_BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez inclure des buckets dans la configuration Storage Intelligence. Vous pouvez spécifier une ou plusieurs zones géographiques sous forme de liste. - Facultatif:
EXCLUDED_BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez exclure des buckets de la configuration Storage Intelligence. Vous pouvez spécifier une ou plusieurs zones géographiques sous forme de liste.
Les sections suivantes expliquent comment configurer Storage Intelligence pour un projet, un dossier ou une organisation. Configurez Storage Intelligence à l'aide de l'une des méthodes suivantes.
Configurer Storage Intelligence pour un projet
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à configurer Storage Intelligence pour un projet.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"
Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques (par exemple,my-project
).UPDATE_MASK
est la liste des noms de champs à mettre à jour, séparés par une virgule. Les champs utilisent le format FieldMask et font partie de la ressourceIntelligenceConfig
.
Configurer Storage Intelligence pour un dossier
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à configurer Storage Intelligence pour un dossier.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"
Où :
FOLDER_ID
correspond à l' Google Cloud ID du dossier. Les ID de dossier sont numériques (par exemple,123456789012
).UPDATE_MASK
est la liste des noms de champs à mettre à jour, séparés par une virgule. Les champs utilisent le format FieldMask et font partie de la ressourceIntelligenceConfig
.
Configurer Storage Intelligence pour une organisation
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à configurer Storage Intelligence pour une organisation.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"
Où :
ORGANIZATION_ID
est l' Google Cloud ID de l'organisation. Les identifiants des organisations sont numériques (par exemple,79293024087
).UPDATE_MASK
est la liste des noms de champs à mettre à jour, séparés par une virgule. Les champs utilisent le format FieldMask et font partie de la ressourceIntelligenceConfig
.
Afficher la configuration de Storage Intelligence
Cette section explique comment afficher la configuration de Storage Intelligence pour une ressource.
Console
Dans la console Google Cloud, accédez à la page Paramètres de Cloud Storage.
Cliquez sur le sélecteur de projets en haut de la page.
Dans la boîte de dialogue Sélectionner une ressource, sélectionnez la ressource pour laquelle vous souhaitez afficher la configuration de Storage Intelligence.
Si Storage Intelligence est configuré pour une ressource, le champ État affiche Enabled
. Pour les ressources pour lesquelles Storage Intelligence n'est pas configuré, le bouton Configurer Storage Intelligence s'affiche.
Ligne de commande
-
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.
Pour afficher la configuration de Storage Intelligence pour une ressource, exécutez la commande
gcloud alpha storage intelligence-configs describe
avec l'une des options suivantes:--project
: affichez la configuration de Storage Intelligence pour un projet. La valeur est un ID de projet. Par exemple,my-project
.--sub-folder
: afficher la configuration de Storage Intelligence pour un dossier. La valeur est un ID de dossier. Par exemple,1234567890
.--organization
: afficher la configuration de Storage Intelligence pour une organisation. La valeur est un ID d'organisation. Par exemple,9876546738
.Par exemple, la commande suivante affiche la configuration de Storage Intelligence pour un projet appelé
my-project
:gcloud alpha storage intelligence-configs describe --project=PROJECT_ID
où PROJECT_ID est l' Google Cloud ID du projet. Les ID de projet sont alphanumériques, par exemple
my-project
.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Les méthodes permettant d'afficher la configuration de Storage Intelligence pour une ressource sont détaillées dans les sections suivantes.
Afficher la configuration de Storage Intelligence pour un projet
Utilisez
cURL
pour appeler l'API JSON avec une requête afin d'afficher la configuration de Storage Intelligence pour un projet.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/projects/PROJECT_ID/locations/global/intelligenceConfig"
Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques, par exemplemy-project
.Afficher la configuration Storage Intelligence d'un dossier
Utilisez
cURL
pour appeler l'API JSON avec une requête permettant d'afficher la configuration de Storage Intelligence pour un dossier.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/folders/FOLDER_ID/locations/global/intelligenceConfig"
Où :
FOLDER_ID
correspond à l' Google Cloud ID du dossier. Les ID de dossier sont numériques (par exemple,123456789012
).Afficher la configuration de Storage Intelligence pour une organisation
Utilisez
cURL
pour appeler l'API JSON avec une requête permettant d'afficher la configuration de Storage Intelligence pour une organisation.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/v2/organizations/ORGANIZATION_ID/locations/global/intelligenceConfig"
Où :
ORGANIZATION_ID
est l' Google Cloud ID de l'organisation. Les identifiants des organisations sont numériques, par exemple79293024087
.
Mettre à jour la configuration de Storage Intelligence
Cette section explique comment mettre à jour la configuration de Storage Intelligence pour une ressource.
Console
Dans la console Google Cloud, accédez à la page Paramètres de Cloud Storage.
Cliquez sur le sélecteur de projets en haut de la page.
Dans la boîte de dialogue Sélectionner une ressource, sélectionnez la ressource pour laquelle vous souhaitez mettre à jour la configuration de Storage Intelligence.
Dans la section Vue d'ensemble, modifiez l'une des options de configuration modifiables selon vos besoins. Par exemple, vous pouvez désactiver Storage Intelligence pour une ressource, définir la configuration de l'édition sur
Inherit from parent
ou modifier les filtres de bucket.
Ligne de commande
-
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.
Pour mettre à jour la configuration de Storage Intelligence pour une ressource, utilisez la commande
gcloud alpha storage intelligence-configs update
avec l'une des options suivantes:--project
: modifiez la configuration de Storage Intelligence pour un projet. La valeur est un ID de projet. Par exemple,my-project
.--sub-folder
: met à jour la configuration de Storage Intelligence pour un dossier. La valeur est un ID de dossier. Par exemple,1234567890
.--organization
: mettez à jour la configuration de Storage Intelligence pour une organisation. La valeur est un ID d'organisation. Par exemple,9876546738
.Par exemple, la commande suivante met à jour la configuration de Storage Intelligence pour un projet appelé
my-project
:gcloud alpha storage intelligence-configs update --project=PROJECT_ID
où PROJECT_ID est l' Google Cloud ID du projet. Les ID de projet sont alphanumériques, par exemple
my-project
.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Créez un fichier JSON avec les informations suivantes:
name
: nom de la configuration Storage Intelligence. Utilisez l'un des formats suivants :- Projet :
projects/PROJECT_ID/locations/global/intelligenceConfig
- Dossier :
folders/FOLDER_ID/locations/global/intelligenceConfig
- Organisation :
organizations/ORGANIZATION_ID/locations/global/intelligenceConfig
Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques (par exemple,my-project
).FOLDER_ID
correspond à l' Google Cloud ID du dossier. Les ID de dossier sont numériques (par exemple,123456789012
).ORGANIZATION_ID
est l' Google Cloud ID de l'organisation. Les identifiants des organisations sont numériques (par exemple,123456789012
).
- Projet :
- Configurez le champ
editionConfig
. Pour en savoir plus, consultez Configuration de l'édition. - Facultatif: configurez l'objet
filter
. Vous pouvez inclure ou exclure des buckets en fonction des emplacements Cloud Storage et des expressions régulières d'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", ...] } } }
Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques, par exemplemy-project
.EDITION_CONFIGURATION
correspond à la configuration de l'édition Storage Intelligence.- Facultatif:
INCLUDED_BUCKET_ID_REGEX
est une expression régulière qui spécifie les ID de bucket à inclure. Vous pouvez spécifier une ou plusieurs expressions régulières sous la forme d'une liste. - Facultatif:
EXCLUDED_BUCKET_ID_REGEX
est une expression régulière qui spécifie les ID de bucket à exclure. Vous pouvez spécifier une ou plusieurs expressions régulières sous la forme d'une liste. - Facultatif:
INCLUDED_BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez inclure des buckets dans la configuration Storage Intelligence. Vous pouvez spécifier une ou plusieurs zones géographiques sous forme de liste. - Facultatif:
EXCLUDED_BUCKET_LOCATION
correspond à l'emplacement où vous souhaitez exclure des buckets de la configuration Storage Intelligence. Vous pouvez spécifier une ou plusieurs zones géographiques sous forme de liste.
Les sections suivantes expliquent comment mettre à jour la configuration de Storage Intelligence pour un projet, un dossier ou une organisation. Mettez à jour la configuration de Storage Intelligence à l'aide de l'une des méthodes suivantes.
Mettre à jour la configuration de Storage Intelligence pour un projet
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à mettre à jour la configuration de Storage Intelligence pour un projet.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"
Mettre à jour la configuration de Storage Intelligence pour un dossier
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à mettre à jour la configuration de Storage Intelligence pour un dossier.Où :
PROJECT_ID
est l' Google Cloud ID de projet. Les ID de projet sont alphanumériques (par exemple,my-project
).UPDATE_MASK
est la liste des noms de champs à mettre à jour, séparés par une virgule. Les champs utilisent le format FieldMask et font partie de la ressourceIntelligenceConfig
.
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"
Où :
FOLDER_ID
correspond à l' Google Cloud ID du dossier. Les ID de dossier sont numériques (par exemple,123456789012
).UPDATE_MASK
est la liste des noms de champs à mettre à jour, séparés par une virgule. Les champs utilisent le format FieldMask et font partie de la ressourceIntelligenceConfig
.
Mettre à jour la configuration de Storage Intelligence pour une organisation
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à mettre à jour la configuration de Storage Intelligence pour une organisation.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"
Où :
ORGANIZATION_ID
est l' Google Cloud ID de l'organisation. Les identifiants des organisations sont numériques (par exemple,79293024087
).UPDATE_MASK
est la liste des noms de champs à mettre à jour, séparés par une virgule. Les champs utilisent le format FieldMask et font partie de la ressourceIntelligenceConfig
.
Désactiver Storage Intelligence
Cette section explique comment désactiver Storage Intelligence.
Console
Dans la console Google Cloud, accédez à la page Paramètres de Cloud Storage.
Cliquez sur le sélecteur de projets en haut de la page.
Dans la boîte de dialogue Select a resource (Sélectionner une ressource), sélectionnez la ressource pour laquelle vous souhaitez désactiver Storage Intelligence.
Dans la section Overview (Aperçu), cliquez sur Enabled (Activé) à côté du champ Status (État).
Dans la boîte de dialogue qui s'affiche, saisissez Désactiver, puis cliquez sur Désactiver.
Ligne de commande
-
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.
Pour désactiver la configuration de Storage Intelligence pour une ressource, exécutez la commande
gcloud alpha storage intelligence-configs disable
avec l'une des options suivantes:--project
: désactivez la configuration de Storage Intelligence pour un projet. La valeur est un ID de projet. Par exemple,my-project
.--sub-folder
: désactivez la configuration de Storage Intelligence pour un dossier. La valeur est un ID de dossier. Par exemple,1234567890
.--organization
: désactivez la configuration de Storage Intelligence pour une organisation. La valeur est un ID d'organisation. Par exemple,9876546738
.Par exemple, la commande suivante désactive la configuration de Storage Intelligence pour un projet appelé
my-project
:gcloud alpha storage intelligence-configs disable --project=PROJECT_ID
où PROJECT_ID est l' Google Cloud ID du projet. Les ID de projet sont alphanumériques, par exemple
my-project
.
API REST
API JSON
Vous devez installer et initialiser gcloud CLI, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization
.Les méthodes permettant de désactiver Storage Intelligence pour une ressource sont détaillées dans les sections suivantes.
Désactiver Storage Intelligence pour un projet
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à mettre à jour Storage Intelligence pour un projet.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"
Où:
PROJECT_ID
est l' Google Cloud ID du projet. Les ID de projet sont alphanumériques, par exemplemy-project
.Désactiver l'intelligence de stockage pour un dossier
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à mettre à jour Storage Intelligence pour un dossier.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"
Où:
FOLDER_ID
correspond à l' Google Cloud ID du dossier. Les ID de dossier sont numériques (par exemple,123456789012
).Désactiver Storage Intelligence pour une organisation
Utilisez
cURL
pour appeler l'API JSON avec une requête visant à désactiver Storage Intelligence pour une organisation.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"
Où:
ORGANIZATION_ID
est l' Google Cloud ID de l'organisation. Les identifiants des organisations sont numériques, par exemple79293024087
.
Étape suivante
- En savoir plus sur les ensembles de données Storage Insights
- En savoir plus sur les rapports d'inventaire Storage Insights
- En savoir plus sur la relocalisation de buckets