Questo documento descrive come visualizzare le policy di posizionamento.
La visualizzazione delle policy di posizionamento è utile per vedere tutte le policy di posizionamento esistenti in un progetto o verificare i dettagli di configurazione di una policy di posizionamento specifica.
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è
il processo di verifica dell'identità per poter accedere a Trusted Cloud by S3NS servizi e API.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su
Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
gcloud
-
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
- Set a default region and zone.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare le policy di posizionamento, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy di posizionamento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per visualizzare le policy di posizionamento sono necessarie le seguenti autorizzazioni:
-
Per visualizzare un elenco delle tue policy di posizionamento:
compute.resourcePolicies.list
on the project -
Per visualizzare i dettagli di una policy di posizionamento:
compute.resourcePolicies.get
on the project
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Visualizzare le policy di posizionamento
Per visualizzare le policy di posizionamento disponibili in un progetto, seleziona uno dei seguenti metodi descritti in questo documento:
Per visualizzare tutte le policy di posizionamento esistenti in un progetto, visualizza un elenco delle tue policy di posizionamento.
Per visualizzare i dettagli di configurazione di una policy di posizionamento, visualizza i dettagli di una policy di posizionamento.
Visualizzare un elenco delle policy di posizionamento
Per visualizzare un elenco di tutte le policy di posizionamento nel tuo progetto, seleziona una delle seguenti opzioni:
gcloud
Per visualizzare un elenco di policy di posizionamento, utilizza il comando
gcloud compute resource-policies list
con il flag--filter
impostato sugroupPlacementPolicy:*
.gcloud compute resource-policies list \ --filter="groupPlacementPolicy:*"
L'output è simile al seguente:
NAME: example-compact-policy DESCRIPTION: REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00 NAME: example-spread-policy DESCRIPTION: REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07:00
Per ulteriori informazioni sull'utilizzo delle espressioni di filtro per restringere un elenco di risorse Compute Engine, consulta il comando
gcloud topic filters
.REST
Per visualizzare un elenco di policy di posizionamento che si trovano in una regione specifica, invia una richiesta
GET
al metodoresourcePolicies.list
. Nell'URL della richiesta, includi il parametro di queryfilter
e impostalo sugroupPlacementPolicy%3A*
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=groupPlacementPolicy%3A*
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui vuoi visualizzare un elenco di policy di posizionamento.REGION
: la regione in cui si trovano una o più policy di posizionamento.
L'output è simile al seguente:
{ "kind": "compute#resourcePolicyList", "id": "projects/example-project/regions/us-central1/resourcePolicies", "items": [ { "kind": "compute#resourcePolicy", "id": "5587673659722509355", "creationTimestamp": "2024-05-09T02:09:24.588-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-compact-policy", "groupPlacementPolicy": { "collocation": "COLLOCATED" }, "status": "READY" }, { "kind": "compute#resourcePolicy", "id": "5970772604948130963", "creationTimestamp": "2024-05-09T02:08:13.404-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-spread-policy", "groupPlacementPolicy": { "availabilityDomainCount": 5 }, "status": "READY" } ], "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies", "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis=" }
Per saperne di più sull'utilizzo delle espressioni di filtro per restringere un elenco di norme relative alle risorse utilizzando la codifica URL, consulta il parametro di query
filter
.Visualizzare i dettagli di una policy di posizionamento
Per visualizzare i dettagli di una policy di posizionamento, seleziona una delle seguenti opzioni:
gcloud
Per visualizzare i dettagli di una policy di posizionamento, utilizza il comando
gcloud compute resource-policies describe
.gcloud compute resource-policies describe POLICY_NAME \ --region=REGION
Sostituisci quanto segue:
POLICY_NAME
: il nome di una policy di posizionamento esistente.REGION
: la regione in cui si trova la policy di posizionamento.
L'output è simile al seguente:
Se stai visualizzando i dettagli di una policy di posizionamento compatto:
creationTimestamp: '2024-05-09T02:09:24.588-07:00' groupPlacementPolicy: collocation: COLLOCATED id: '5587673659722509355' kind: compute#resourcePolicy name: example-compact-policy region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy status: READY
Se stai visualizzando i dettagli di una policy di posizionamento distribuito:
creationTimestamp: '2024-05-09T02:08:13.404-07:00' groupPlacementPolicy: availabilityDomainCount: 5 id: '5970772604948130963' kind: compute#resourcePolicy name: example-spread-policy region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1 selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy status: READY
REST
Per visualizzare i dettagli di una policy di posizionamento, invia una richiesta
GET
al metodoresourcePolicies.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la policy di posizionamento di cui vuoi visualizzare i dettagli.REGION
: la regione in cui si trova la policy di posizionamento.POLICY_NAME
: il nome di una policy di posizionamento esistente.
L'output è simile al seguente:
Se stai visualizzando i dettagli di una policy di posizionamento compatto:
{ "kind": "compute#resourcePolicy", "id": "5587673659722509355", "creationTimestamp": "2024-05-09T02:09:24.588-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-compact-policy", "groupPlacementPolicy": { "collocation": "COLLOCATED" }, "status": "READY" }
Se stai visualizzando i dettagli di una policy di posizionamento distribuito:
{ "kind": "compute#resourcePolicy", "id": "5970772604948130963", "creationTimestamp": "2024-05-09T02:08:13.404-07:00", "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy", "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1", "name": "example-spread-policy", "groupPlacementPolicy": { "availabilityDomainCount": 5 }, "status": "READY" }
Passaggi successivi
Scopri come sostituire, rimuovere o eliminare le policy di posizionamento.
Scopri come applicare una policy di posizionamento:
Scopri come verificare la posizione delle VM che utilizzano policy di posizionamento compatto.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-18 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-18 UTC."],[[["This document guides you through the process of viewing existing placement policies within a project, including how to check specific configurations."],["To list all placement policies, use the `gcloud compute resource-policies list` command with the `--filter` flag or make a `GET` request to the `resourcePolicies.list` method in REST API, filtering with `groupPlacementPolicy:*`."],["To view detailed information about a specific placement policy, utilize the `gcloud compute resource-policies describe` command or make a `GET` request to the `resourcePolicies.get` method in REST API, specifying the policy name and region."],["Ensure you have the necessary permissions, specifically the Compute Instance Admin (v1) role, or the `compute.resourcePolicies.list` and `compute.resourcePolicies.get` permissions, to view placement policies."],["Instructions are given to authenticate using the gcloud CLI and the REST API, and there are further resources to learn about the replacing, removing, deleting, and applying of placement policies."]]],[]] -