Questo documento descrive come visualizzare le norme relative al 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 un criterio di posizionamento specifico.
Prima di iniziare
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API. Google Cloud
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:
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
-
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
) nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare i criteri di posizionamento. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per visualizzare i criteri di posizionamento sono necessarie le seguenti autorizzazioni:
-
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
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Visualizzare i tuoi criteri di posizionamento
Per visualizzare i criteri di posizionamento disponibili in un progetto, seleziona uno dei seguenti metodi descritti in questo documento:
Per visualizzare tutti i criteri di posizionamento esistenti in un progetto, visualizza un elenco dei tuoi criteri di posizionamento.
Per visualizzare i dettagli di configurazione di un criterio di posizionamento, visualizza i dettagli di un criterio di posizionamento.
Visualizzare un elenco dei criteri di posizionamento
Per visualizzare un elenco di tutti i criteri di posizionamento nel progetto, seleziona una delle seguenti opzioni:
Per visualizzare un elenco di criteri di posizionamento, utilizza il
comando gcloud compute resource-policies list
con il flag --filter
impostato su groupPlacementPolicy:*
.
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
.
Per visualizzare un elenco di criteri di posizionamento in una regione specifica,
invia una richiesta GET
al
metodo resourcePolicies.list
.
Nell'URL della richiesta, includi il parametro di query filter
e impostalo su
groupPlacementPolicy%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 criteri di posizionamento.REGION
: la regione in cui si trovano uno o più criteri 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 ulteriori informazioni sull'utilizzo di espressioni di filtro per restringere un elenco di criteri delle risorse mediante la codifica URL, consulta il parametro di query filter
.
Visualizzare i dettagli di un criterio di posizionamento
Per visualizzare i dettagli di un criterio di posizionamento, seleziona una delle seguenti opzioni:
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:
POLICY_NAME
: il nome di una strategia di posizionamento esistente.REGION
: la regione in cui si trova la norma di posizionamento.
L'output è simile al seguente:
Se stai visualizzando i dettagli di una norma 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 norma 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
Per visualizzare i dettagli di un criterio di posizionamento, invia una richiesta GET
al
metodo resourcePolicies.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 il regolamento relativo al posizionamento di cui vuoi visualizzare i dettagli.REGION
: la regione in cui si trova la norma di posizionamento.POLICY_NAME
: il nome di una strategia di posizionamento esistente.
L'output è simile al seguente:
Se stai visualizzando i dettagli di una norma 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 norma 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 i criteri di posizionamento.
Scopri come applicare una norma di posizionamento:
Scopri come verificare la posizione delle VM che utilizzano i criteri di posizionamento compatto.