Questo documento descrive come visualizzare i criteri di posizionamento.
La visualizzazione dei criteri di posizionamento è utile per vedere tutti i criteri di posizionamento esistenti in un progetto o per verificare i dettagli di configurazione di uno specifico criterio di posizionamento.
Prima di iniziare
-
Se non l'hai già fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in Compute Engine come segue.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Set a default region and zone.
-
Per visualizzare un elenco dei tuoi criteri di posizionamento:
compute.resourcePolicies.list
on the project -
Per visualizzare i dettagli di un criterio di posizionamento:
compute.resourcePolicies.get
on the project Per visualizzare tutti i criteri di posizionamento esistenti in un progetto, visualizza un elenco dei tuoi criteri di posizionamento.
Per vedere i dettagli di configurazione di un criterio di posizionamento, visualizza i dettagli di un criterio di posizionamento.
PROJECT_ID
: l'ID del progetto in cui vuoi visualizzare un elenco di criteri di posizionamento.REGION
: la regione in cui si trovano uno o più criteri di posizionamento.POLICY_NAME
: il nome di un criterio di posizionamento esistente.REGION
: la regione in cui si trova il criterio di posizionamento.Se visualizzi i dettagli di un criterio 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 un criterio 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
PROJECT_ID
: l'ID del progetto in cui si trova il criterio di posizionamento di cui vuoi visualizzare i dettagli.REGION
: la regione in cui si trova il criterio di posizionamento.POLICY_NAME
: il nome di un criterio di posizionamento esistente.Se visualizzi i dettagli di un criterio 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 un criterio 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" }
Scopri come sostituire, rimuovere o eliminare i criteri di posizionamento.
Scopri come applicare un criterio di posizionamento:
Scopri come verificare la località delle VM che utilizzano criteri di posizionamento compatto.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare i criteri di posizionamento, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (
roles/compute.instanceAdmin.v1
) per il tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare i criteri di posizionamento. Per visualizzare esattamente le autorizzazioni necessarie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per visualizzare i criteri di posizionamento sono necessarie le seguenti autorizzazioni:
Potresti anche riuscire a ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.
Visualizza i criteri di posizionamento
Per visualizzare i criteri di posizionamento disponibili in un progetto, seleziona uno dei seguenti metodi descritti in questo documento:
Visualizzare un elenco dei criteri di posizionamento
Per visualizzare un elenco di tutti i criteri di posizionamento nel progetto, seleziona una delle seguenti opzioni:
gcloud
Per visualizzare un elenco dei criteri 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 criteri di posizionamento che si trovano in una regione specifica, effettua 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:
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 ulteriori informazioni sull'utilizzo delle espressioni di filtro per restringere un elenco di criteri delle risorse utilizzando la codifica degli URL, consulta il parametro di query
filter
.Visualizza i dettagli di un criterio di posizionamento
Per visualizzare i dettagli di un criterio di posizionamento, seleziona una delle seguenti opzioni:
gcloud
Per visualizzare i dettagli di un criterio di posizionamento, utilizza il comando
gcloud compute resource-policies describe
.gcloud compute resource-policies describe POLICY_NAME \ --region=REGION
Sostituisci quanto segue:
L'output è simile al seguente:
REST
Per visualizzare i dettagli di un criterio 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:
L'output è simile al seguente:
Che cosa succede dopo?
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 2024-07-12 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -