Questo documento spiega come visualizzare i criteri di posizionamento. In particolare, spiega come visualizzare i criteri di posizionamento disponibili in un progetto specificato o come visualizzare i dettagli di configurazione di uno di questi criteri.
Prima di iniziare
- Consulta le limitazioni per i criteri di posizionamento.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:
gcloud
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Imposta una regione e una zona predefinite.
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 initialize eseguendo questo comando:
gcloud init
-
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per visualizzare o eliminare i criteri di posizionamento, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1
) per il progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare o eliminare i criteri di posizionamento. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per visualizzare o eliminare i criteri di posizionamento, sono necessarie le seguenti autorizzazioni:
-
Per visualizzare un elenco dei criteri di posizionamento:
compute.resourcePolicies.list
sul progetto -
Per visualizzare i dettagli di un criterio di posizionamento:
compute.resourcePolicies.get
sul progetto
Potresti anche essere in grado di 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 specificato, seleziona uno dei seguenti metodi:
Per vedere tutti i criteri di posizionamento, 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.
Visualizza un elenco dei criteri di posizionamento
Puoi visualizzare un elenco di tutti i criteri di posizionamento in un progetto specificato utilizzando gcloud CLI e REST.
gcloud
Per visualizzare un elenco dei 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: policy-1
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:10:51.958-08:00
NAME: policy-2
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:11:16.826-08: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 dei criteri di posizionamento che si trovano in una regione specifica,
effettua 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": "637231102400797797",
"creationTimestamp": "2023-07-28T04:12:11.072-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-1",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "policy-1",
"groupPlacementPolicy": {
"collocation": "COLLOCATED"
},
"status": "READY"
},
{
"kind": "compute#resourcePolicy",
"id": "1228789480840827204",
"creationTimestamp": "2023-07-15T02:10:51.958-08:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-2",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "policy-2",
"groupPlacementPolicy": {
"availabilityDomainCount": 2
},
"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 mediante la codifica degli URL, consulta il parametro di query filter
.
Visualizzare i dettagli di un criterio di posizionamento
Puoi visualizzare i dettagli di un criterio di posizionamento in un progetto specificato utilizzando gcloud CLI e REST.
gcloud
Per visualizzare i dettagli di un criterio di posizionamento, usa il comando gcloud compute resource-policies describe
.
gcloud compute resource-policies describe POLICY_NAME \
--region=REGION
Sostituisci quanto segue:
POLICY_NAME
: il nome di un criterio di posizionamento esistente.REGION
: la regione in cui si trova il criterio di posizionamento.
L'output è simile al seguente:
creationTimestamp: '2023-07-15T02:10:51.958-08:00'
groupPlacementPolicy:
availabilityDomainCount: 2
id: '1228789480840827204'
kind: compute#resourcePolicy
name: pp2
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-policy
status: READY
REST
Per visualizzare i dettagli di un criterio di posizionamento, effettua 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 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.
L'output è simile al seguente:
{
"kind": "compute#resourcePolicy",
"id": "637231102400797797",
"creationTimestamp": "2023-07-28T04:12:11.072-07:00",
"selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy",
"region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
"name": "policy-1",
"groupPlacementPolicy": {
"availabilityDomainCount": 2
},
"status": "READY"
}
Che cosa succede dopo?
Scopri come sostituire, rimuovere o eliminare i criteri di posizionamento.
Scopri come applicare un criterio di posizionamento: