Crea una rete VMware Engine

Le reti VMware Engine gestiscono le connessioni da e verso i cloud privati in base a un criterio di rete che definisci separatamente.

Prima di iniziare

Requisiti per Google Cloud CLI e API

Per utilizzare lo strumento a riga di comando gcloud o l'API per gestire le risorse VMware Engine, ti consigliamo di configurare gli strumenti come descritto di seguito.

gcloud

Imposta l'ID progetto predefinito:
```
gcloud config set project PROJECT_ID
```

Imposta una regione e/o una zona predefinite:

gcloud config set compute/region REGION

gcloud config set compute/zone ZONE

Per ulteriori informazioni sullo strumento gcloud vmware, consulta la documentazione di riferimento di Cloud SDK.

API

Gli esempi di API in questo set di documentazione utilizzano lo strumento a riga di comando cURL per eseguire query sull'API. È necessario un token di accesso valido come parte della richiesta cURL. Esistono molti modi per ottenere un token di accesso valido; i passaggi seguenti utilizzano lo strumento gcloud per generare un token di accesso:

Accedi a Google Cloud
```
gcloud auth login
```

Genera token di accesso ed esporta in TOKEN

export TOKEN=`gcloud auth print-access-token`

Verifica che TOKEN sia impostato correttamente
```
echo $TOKEN

Output:
TOKEN
```

Ora utilizza il token di autorizzazione nelle richieste all'API. Ad esempio:

curl -X GET -H "Authorization: Bearer \"$TOKEN\""  -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations

Python

Gli esempi di codice Python in questa documentazione utilizzano la libreria VMware Engine per comunicare con l'API. Per poter utilizzare questo approccio, è necessario installare la libreria e configurare le Credenziali predefinite dell'applicazione.

Scarica e installa la libreria Python
```
 pip install google-cloud-vmwareengine
```
Configura le informazioni dell'ADC eseguendo questi comandi nella shell
```
  gcloud auth application-default login
```
o utilizzare un file di chiavi dell'account di servizio
```
  export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
```

Per maggiori informazioni sulla libreria, visita la pagina di riferimento o visualizza gli esempi di codice su GitHub.

Crea una rete VMware Engine utilizzando gcloud CLI o l'API VMware Engine:

gcloud

Per creare una rete VMware Engine utilizzando gcloud CLI:

Esegui il comando gcloud vmware networks create:
```
gcloud vmware networks create NETWORK_ID \
  --type=STANDARD \
  --description="DESCRIPTION"
```
Sostituisci quanto segue:
- NETWORK_ID: il nome della rete per questa richiesta
- DESCRIPTION: una descrizione per questa rete
(Facoltativo) Se vuoi elencare tutte le reti VMware Engine per confermare la creazione della nuova rete, utilizza il comando gcloud vmware networks list:
```
gcloud vmware networks list \
  --location=global
```

API

Per creare una rete VMware Engine utilizzando l'API VMware Engine:

Per creare una rete VMware Engine, effettua una richiesta POST:
```
POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks?vmware_engine_network_id=NETWORKD_ID"

'{
  "type": "standard",
  "description": "DESCRIPTION"
}'
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto per questa richiesta.
- NETWORK_ID: il nome della rete per questa richiesta.
- DESCRIPTION: una descrizione per questa rete.
(Facoltativo) Per elencare tutte le reti VMware Engine per confermare la creazione della nuova rete, effettua una richiesta GET. Sostituisci PROJECT_ID con l'ID progetto per questa richiesta.
```
GET https://vmwareengine.googleapis.com/v1/projects//locations/global/vmwareEngineNetworks
```

Aggiorna una rete VMware Engine

Aggiorna una rete VMware Engine utilizzando gcloud CLI o l'API VMware Engine:

gcloud

Per aggiornare una rete VMware Engine utilizzando gcloud CLI, segui questi passaggi:

Aggiorna la descrizione di una rete VMware Engine eseguendo il comando gcloud vmware networks update:
```
gcloud vmware networks update NETWORK_ID \
  --description='DESCRIPTION'
```
Sostituisci quanto segue:
- NETWORK_ID: il nome della rete per questa richiesta.
- DESCRIPTION: una descrizione aggiornata per questa rete.
(Facoltativo) Se vuoi visualizzare l'attributo aggiornato, utilizza il comando gcloud vmware networks describe:
```
gcloud vmware networks describe NETWORK_ID
```
Sostituisci NETWORK_ID con il nome della rete per questa richiesta.

API

Per aggiornare una rete VMware Engine utilizzando l'API VMware Engine, segui questi passaggi:

Per aggiornare la descrizione di una rete VMware Engine, effettua una richiesta PATCH:
```
PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/vmwareEngineNetworks/NETWORK_ID?update_mask=description"

'{
  "description":"DESCRIPTION"
}'
```
Sostituisci quanto segue:
- PROJECT_ID: il progetto per questa richiesta
- LOCATION: la località della rete, ovvero global per le reti precedenti o la regione per le reti standard
- NETWORK_ID: il nome della rete per questa richiesta
- DESCRIPTION: una descrizione aggiornata per questa rete

(Facoltativo) Per visualizzare l'attributo aggiornato, effettua una richiesta GET:

GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks/NETWORK_ID"

Crea una rete VMware Engine

Prima di iniziare

Requisiti per Google Cloud CLI e API

gcloud

API

Python