Modificando la configurazione del motore per suggerimenti IAM, puoi personalizzare il modo in cui vengono generati i suggerimenti per i ruoli. Questa pagina spiega come modificare la configurazione per cambiare la velocità di generazione dei suggerimenti per il progetto.
Sebbene il motore per suggerimenti IAM generi suggerimenti sui ruoli per una serie di risorse, puoi modificare solo il modo in cui vengono generati i suggerimenti sui ruoli per i progetti.
Prima di iniziare
-
Attiva l'API Recommender.
- Scopri in che modo il motore per suggerimenti IAM genera suggerimenti sui ruoli.
- Installa Google Cloud CLI.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare i suggerimenti sui ruoli IAM, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto di cui vuoi configurare il motore per suggerimenti IAM:
- Visualizza i dettagli di configurazione: Visualizzatore motore per suggerimenti IAM (roles/recommendationer.iamViewer)
- Modifica la configurazione: Amministratore motore per suggerimenti IAM (roles/recommendationer.iamAdmin)
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per configurare i suggerimenti sui ruoli IAM. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per configurare i suggerimenti sui ruoli IAM sono necessarie le seguenti autorizzazioni:
-
Visualizza i dettagli di configurazione:
recommender.iamPolicyRecommenderConfig.get
-
Modifica la configurazione:
recommender.iamPolicyRecommenderConfig.get
Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.
Visualizzare la configurazione attuale
Visualizza la configurazione attuale per vedere quanti giorni di dati sull'utilizzo delle autorizzazioni sono in attesa dal motore per suggerimenti IAM prima di generare i suggerimenti sui ruoli.
Puoi visualizzare la configurazione utilizzando gcloud CLI o l'API REST.
gcloud
Per ottenere la configurazione del motore per suggerimenti IAM, utilizza il comando gcloud beta recommender recommender-config describe
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche comemy-project
.
Esegui il comando gcloud beta recommendationser recommendationser-config describe:
Linux, macOS o Cloud Shell
gcloud beta recommender recommender-config describe \ google.iam.policy.Recommender \ --project="PROJECT_ID" \ --location="global"
Windows (PowerShell)
gcloud beta recommender recommender-config describe ` google.iam.policy.Recommender ` --project="PROJECT_ID" ` --location="global"
Windows (cmd.exe)
gcloud beta recommender recommender-config describe ^ google.iam.policy.Recommender ^ --project="PROJECT_ID" ^ --location="global"
La risposta contiene la configurazione del motore per suggerimenti IAM. Ad esempio, potrebbe avere il seguente aspetto:
etag: '"d3e779ee3f34f276"' name: projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config recommenderGenerationConfig: params: minimum_observation_period: P90D revisionId: DEFAULT updateTime: '2022-10-02T22:57:33Z'
REST
Per ottenere la configurazione del motore per suggerimenti IAM, utilizza il metodo projects.locations.recommenders.getConfig
dell'API Recommender.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: l'ID numerico del tuo progetto Google Cloud.PROJECT_ID
: l'ID del tuo progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche comemy-project
.
Metodo HTTP e URL:
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config
Per inviare la richiesta, espandi una di queste opzioni:
La risposta contiene la configurazione del motore per suggerimenti IAM. Ad esempio, potrebbe avere il seguente aspetto:
{ "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config", "recommenderGenerationConfig": { "params": { "minimum_observation_period": "P90D" } }, "etag": "\"d3e779ee3f34f276\"", "updateTime": "2022-10-02T22:57:33Z", "revisionId": "DEFAULT" }
Comprendere i dettagli di configurazione
I contenuti di una configurazione dipendono dal motore per suggerimenti per la configurazione. Le configurazioni del motore per suggerimenti IAM hanno i seguenti componenti, non necessariamente in questo ordine:
name
: l'identificatore della configurazione, nel moduloprojects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config
.recommenderGenerationConfig
: i parametri utilizzati dal motore per suggerimenti IAM durante la generazione dei suggerimenti. Questo campo contiene i seguenti parametri:minimum_observation_period
: il numero di giorni di dati sull'utilizzo delle autorizzazioni necessari per il motore per suggerimenti IAM per iniziare a generare suggerimenti sui ruoli.
etag
: un identificatore dello stato attuale di una configurazione, utilizzato per impedire aggiornamenti simultanei. Ogni volta che la configurazione cambia, viene assegnato un nuovo valore ETag.updateTime
: il timestamp dell'ultimo aggiornamento della configurazione, in formato UTC (RFC 3339).revisionId
: solo output. Identificatore per la revisione corrente della configurazione. Questo valore viene aggiornato ogni volta che la configurazione viene modificata.
Modifica la configurazione
Modifica la configurazione per cambiare la velocità con cui vengono generati i suggerimenti per il progetto.
gcloud
Per modificare la configurazione del motore per suggerimenti IAM, utilizza il comando gcloud beta recommender recommender-config update
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
-
OBSERVATION_PERIOD
: il periodo di osservazione minimo che vuoi impostare. Utilizza uno dei seguenti valori:P30D
(30 giorni),P60D
(60 giorni) oP90D
(90 giorni). -
ETAG
: l'ETag attuale della configurazione, che puoi trovare recuperando la configurazione attuale e copiando il valore del campoetag
della risposta. PROJECT_ID
: l'ID del tuo progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche comemy-project
.
Salva i seguenti contenuti in un file denominato request.json
:
{ "params": { "minimum_observation_period": "OBSERVATION_PERIOD" } }
Esegui il comando gcloud beta recommendationser recommendationser-config update:
Linux, macOS o Cloud Shell
gcloud beta recommender recommender-config update \ google.iam.policy.Recommender \ --etag="ETAG" \ --project="PROJECT_ID" \ --location="global" \ --config-file="request.json"
Windows (PowerShell)
gcloud beta recommender recommender-config update ` google.iam.policy.Recommender ` --etag="ETAG" ` --project="PROJECT_ID" ` --location="global" ` --config-file="request.json"
Windows (cmd.exe)
gcloud beta recommender recommender-config update ^ google.iam.policy.Recommender ^ --etag="ETAG" ^ --project="PROJECT_ID" ^ --location="global" ^ --config-file="request.json"
La risposta contiene la configurazione aggiornata. Ad esempio, potrebbe avere il seguente aspetto:
etag: '"2549af0942332910"' name: projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config recommenderGenerationConfig: params: minimum_observation_period: P60D revisionId: 288c60eb updateTime: '2022-10-05T21:42:21.069170Z'
REST
Per modificare la configurazione del motore per suggerimenti IAM, utilizza il metodo projects.locations.recommenders.updateConfig
dell'API Recommender.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_NUMBER
: l'ID numerico del tuo progetto Google Cloud.-
OBSERVATION_PERIOD
: il periodo di osservazione minimo che vuoi impostare. Utilizza uno dei seguenti valori:P30D
(30 giorni),P60D
(60 giorni) oP90D
(90 giorni). -
ETAG
: l'ETag attuale della configurazione, che puoi trovare recuperando la configurazione attuale e copiando il valore del campoetag
della risposta. Utilizza le barre rovesciate per dare un'interpretazione letterale alle virgolette, ad esempio"\"df7308cca9719dcc\""
. PROJECT_ID
: l'ID del tuo progetto Google Cloud. Gli ID progetto sono stringhe alfanumeriche comemy-project
.
Metodo HTTP e URL:
PATCH https://recommender.googleapis.com/v1beta1/projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config
Corpo JSON della richiesta:
{ "name": "projects/PROJECT_NUMBER/locations/global/recommenders/google.iam.policy.Recommender/config", "recommenderGenerationConfig": { "params": { "minimum_observation_period": "OBSERVATION_PERIOD" } }, "etag": "ETAG" }
Per inviare la richiesta, espandi una di queste opzioni:
La risposta contiene la configurazione aggiornata. Ad esempio, potrebbe avere il seguente aspetto:
{ "name": "projects/123456789012/locations/global/recommenders/google.iam.policy.Recommender/config", "recommenderGenerationConfig": { "params": { "minimum_observation_period": "P60D" } }, "etag": "\"2549af0942332910\"", "updateTime": "2022-10-05T21:26:52.127512Z", "revisionId": "b5fc0053" }
Passaggi successivi
- Esaminare e applicare i suggerimenti sui ruoli per progetti, cartelle e organizzazioni.
- Esamina e applica i suggerimenti sui ruoli per i bucket Cloud Storage
- Scopri di più sul motore per suggerimenti.