Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Accedere alle API di Google regionali tramite endpoint

Questo documento spiega come utilizzare gli endpoint Private Service Connect per connettersi agli endpoint regionali delle API di Google supportate.

Per informazioni su altre configurazioni di Private Service Connect, consulta Private Service Connect.

Ruoli obbligatori

Se crei l'endpoint nello stesso progetto della subnet a cui lo connetti, consulta Ruoli richiesti per il progetto.

Se utilizzi il VPC condiviso e crei l'endpoint in un progetto di servizio, collegandolo a una subnet nel progetto host, devi disporre dei seguenti ruoli:

Ruoli richiesti per il tuo progetto concessi nel progetto di servizio
Ruoli aggiuntivi richiesti per le configurazioni VPC condiviso concessi nel progetto host

Ruoli richiesti per il progetto

Per ottenere le autorizzazioni necessarie per gestire gli endpoint Private Service Connect che accedono agli endpoint regionali, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Crea, visualizza ed elimina endpoint: Compute Network Admin (roles/compute.networkAdmin) sul tuo progetto
Configura le voci DNS per un endpoint: DNS Administrator (roles/dns.admin) nel tuo progetto

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Ruoli aggiuntivi richiesti per le configurazioni VPC condiviso

Se crei un endpoint in un progetto di servizio che utilizza un indirizzo IP di una subnet del progetto host, devi disporre delle seguenti autorizzazioni oltre ai ruoli per il tuo progetto (il progetto di servizio).

Sia tu che l'account di servizio Network Connectivity Service dovete disporre delle autorizzazioni per il progetto host.

Ruoli da concedere al tuo account utente

Per ottenere le autorizzazioni necessarie per gestire gli endpoint Private Service Connect che accedono agli endpoint regionali per le API di Google, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Crea, visualizza ed elimina endpoint che utilizzano un indirizzo IP del progetto host:
- Compute Network Admin (roles/compute.networkAdmin) sul progetto di servizio
- Compute Network User (roles/compute.networkUser) sul progetto host

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire gli endpoint Private Service Connect che accedono agli endpoint regionali per le API di Google. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire gli endpoint Private Service Connect che accedono agli endpoint regionali per le API di Google, sono richieste le seguenti autorizzazioni:

Per creare, visualizzare ed eliminare endpoint che utilizzano un indirizzo IP del progetto host:
- compute.networks.use sul progetto host
- compute.subnetworks.use sul progetto host

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Ruoli da concedere al service account Network Connectivity

Per assicurarti che service-PROJECT_NUMBER@gcp-sa-networkconnectivity.iam.gserviceaccount.com disponga delle autorizzazioni necessarie per gestire gli endpoint Private Service Connect che accedono agli endpoint regionali per le API di Google, chiedi all'amministratore di concedere a service-PROJECT_NUMBER@gcp-sa-networkconnectivity.iam.gserviceaccount.com i seguenti ruoli IAM:

Importante: devi concedere questi ruoli a service-PROJECT_NUMBER@gcp-sa-networkconnectivity.iam.gserviceaccount.com, non al tuo account utente. La mancata concessione dei ruoli all'entità corretta potrebbe comportare errori di autorizzazione.

Crea, visualizza ed elimina endpoint che utilizzano un indirizzo IP del progetto host: Compute Network User (roles/compute.networkUser) sul progetto host

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Autorizzazioni obbligatorie

Per gestire gli endpoint Private Service Connect che accedono agli endpoint regionali per le API di Google, sono richieste le seguenti autorizzazioni:

Per creare, visualizzare ed eliminare endpoint che utilizzano un indirizzo IP del progetto host:
- compute.networks.get sul progetto host
- compute.networks.use sul progetto host
- compute.subnetworks.get sul progetto host
- compute.subnetworks.use sul progetto host

L'amministratore potrebbe anche essere in grado di concedere a service-PROJECT_NUMBER@gcp-sa-networkconnectivity.iam.gserviceaccount.com queste autorizzazioni tramite ruoli personalizzati o altri ruoli predefiniti.

Prima di iniziare

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
```
$ gcloud init
```
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
Abilita le API Compute Engine, Network Connectivity Center e Cloud DNS.
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.
Abilita le API
Inoltre, abilita l'API per il servizio di destinazione a cui vuoi accedere tramite l'endpoint Private Service Connect. Ad esempio, se vuoi accedere a spanner.me-central2.rep.googleapis.com, abilita l'API Cloud Spanner. Private Service Connect non abilita automaticamente alcuna API.
Assicurati che le regole firewall in uscita consentano il traffico verso l'endpoint. La configurazione firewall predefinita per una rete VPC consente questo traffico perché contiene una regola di autorizzazione in uscita implicita. Verifica di non aver creato una regola di uscita con priorità più elevata che blocca il traffico.

Crea un endpoint Private Service Connect regionale

Puoi creare un endpoint Private Service Connect regionale per inviare richieste a un endpoint regionale per un'API di Google di destinazione.

Per un elenco degli endpoint regionali supportati, consulta Endpoint di servizio regionali.

Console

Nella console Google Cloud , vai alla pagina Private Service Connect.

Vai a Private Service Connect
Fai clic su Connetti endpoint.
In Target, seleziona API Google.
Nell'elenco Ambito, seleziona A livello di regione.
Nell'elenco Regione, seleziona la regione che vuoi utilizzare.
Nell'elenco Servizio di destinazione, seleziona il servizio a cui vuoi accedere.
In Nome endpoint, inserisci un nome per l'endpoint.
In Rete, seleziona una rete.
In Subnet, seleziona una subnet.
In Indirizzo IP, esegui una delle seguenti operazioni per configurare un indirizzo IP:
- Seleziona Allocazione automatica per allocare e prenotare automaticamente un nuovo indirizzo IP statico.
- Seleziona un indirizzo IP statico dall'elenco.
- Fai clic su Crea indirizzo IP per prenotare un nuovo indirizzo IP statico.
(Facoltativo) Per rendere disponibile l'endpoint da tutte le regioni della rete VPC, seleziona Abilita accesso globale.
Fai clic su Aggiungi endpoint.

gcloud

Utilizza il comando gcloud network-connectivity regional-endpoints create per creare l'endpoint.

gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
    --region=REGION \
    --address=ADDRESS \
    --network=projects/PROJECT_ID/global/networks/NETWORK_NAME \
    --subnetwork=projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \
    --target-google-api=REP_DNS_NAME

Se vuoi rendere l'endpoint disponibile per le risorse in altre regioni, aggiungi il flag --enable-global-access.

Sostituisci quanto segue:

ENDPOINT_NAME: un nome per l'endpoint.
REGION: la regione in cui vuoi creare l'endpoint.
ADDRESS: l'indirizzo IPv4 o IPv6 che vuoi utilizzare per l'endpoint. Se omesso, viene allocato un indirizzo IPv4 dalla subnet. Utilizza uno dei seguenti formati:
- Indirizzo IPv4, ad esempio 10.0.0.2.
- URI della risorsa indirizzo IPv4 o IPv6, ad esempio projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME.
PROJECT_ID: il progetto in cui stai creando l'endpoint.
NETWORK_NAME: il nome della rete VPC per l'endpoint.
SUBNET_NAME: la subnet a cui stai connettendo l'endpoint.
REP_DNS_NAME: il nome host dell'endpoint del servizio regionale a cui ti stai connettendo. Ad esempio, spanner.me-central2.rep.googleapis.com.

API

Utilizza il metodo projects.locations.regionalEndpoints.create per creare l'endpoint.

Metodo HTTP e URL:

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints?regionalEndpointId=ENDPOINT_NAME

  {
    "accessType": "REGIONAL",
    "address": "ADDRESS",
    "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
    "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
    "targetGoogleApi": "REP_DNS_NAME"
  }

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto dell'endpoint.
REGION: la regione in cui vuoi creare l'endpoint.
ENDPOINT_NAME: un nome per l'endpoint.
ADDRESS: l'indirizzo IPv4 o IPv6 che vuoi utilizzare per l'endpoint. Se omesso, viene allocato un indirizzo IPv4 dalla subnet. Utilizza uno dei seguenti formati:
- Indirizzo IPv4, ad esempio 10.0.0.2.
- URI della risorsa indirizzo IPv4 o IPv6, ad esempio projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME.
NETWORK_NAME: il nome della rete VPC per l'endpoint.
SUBNET_NAME: il nome della subnet a cui vuoi connettere l'endpoint.
REP_DNS_NAME: il nome host dell'endpoint del servizio regionale a cui vuoi connetterti. Ad esempio, spanner.me-central2.rep.googleapis.com.

Crea un endpoint Private Service Connect regionale in un progetto di servizio con VPC condiviso

Se utilizzi un VPC condiviso, puoi creare un endpoint in un progetto di servizio che utilizza un indirizzo IP di una subnet in un progetto host. Non puoi utilizzare la console Google Cloud per creare questa configurazione. Devi utilizzare gcloud CLI o l'API.

gcloud

Prenota un indirizzo IP statico da utilizzare per l'endpoint regionale utilizzando il comando gcloud compute addresses create. L'utilizzo di un indirizzo IP statico è facoltativo per IPv4 e obbligatorio per IPv6.

Crea la risorsa indirizzo nel progetto di servizio, specificando una subnet nel progetto host.
```
gcloud compute addresses create ADDRESS_NAME \
    --region=REGION \
    --subnet=projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET \
    --ip-version=IP_VERSION \
    --project=SERVICE_PROJECT
```
Sostituisci quanto segue:
- ADDRESS_NAME: il nome da assegnare all'indirizzo IP riservato.
- REGION: la regione per l'indirizzo IP dell'endpoint. Deve essere la stessa regione che contiene il collegamento al servizio del producer di servizi.
- HOST_PROJECT: l'ID progetto del progetto host.
- HOST_SUBNET: il nome della subnet per l'indirizzo IP dell'endpoint.
- IP_VERSION: la versione IP dell'indirizzo IP, che può essere IPV4 o IPV6. IPV4 è il valore predefinito. Per specificare IPV6, l'indirizzo IP deve essere connesso a una subnet con un intervallo di indirizzi IPv6 interni.
- SERVICE_PROJECT: l'ID progetto del progetto di servizio
Utilizza il comando gcloud network-connectivity regional-endpoints create per creare l'endpoint regionale nel progetto di servizio.
```
gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
    --region=REGION \
    --address=ADDRESS \
    --network=projects/HOST_PROJECT/global/networks/HOST_NETWORK \
    --subnetwork=projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET \
    --target-google-api=REP_DNS_NAME \
    --project=SERVICE_PROJECT
    
```
Se vuoi rendere l'endpoint disponibile per le risorse in altre regioni, aggiungi il flag --enable-global-access.

Sostituisci quanto segue:
- ENDPOINT_NAME: un nome per l'endpoint.
- REGION: la regione in cui vuoi creare l'endpoint.
- ADDRESS: l'indirizzo IPv4 o IPv6 che vuoi utilizzare per l'endpoint. Se omesso, viene allocato un indirizzo IPv4 dalla subnet. Utilizza uno dei seguenti formati:
  - Indirizzo IPv4, ad esempio 10.0.0.2.
  - URI della risorsa indirizzo IPv4 o IPv6. La risorsa indirizzo deve essere creata nel progetto di servizio, non nel progetto host. Ad esempio, projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME.
  - HOST_PROJECT: l'ID del progetto host.
- HOST_NETWORK: il nome della rete VPC nel progetto host.
- HOST_SUBNET: la subnet nel progetto host a cui colleghi l'endpoint.
- REP_DNS_NAME: il nome host dell'endpoint del servizio regionale a cui ti stai connettendo. Ad esempio, spanner.me-central2.rep.googleapis.com.
- SERVICE_PROJECT: l'ID progetto del progetto di servizio

API

Prenota un indirizzo IP statico da utilizzare per l'endpoint regionale. L'utilizzo di un indirizzo IP statico è facoltativo per IPv4 e obbligatorio per IPv6.

Crea la risorsa indirizzo nel progetto di servizio, specificando una subnet nel progetto host.
```
POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT/regions/REGION/addresses
```
```
{
    "name": "ADDRESS_NAME",
    "addressType": "INTERNAL",
    "subnetwork": "projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET",
    "ipVersion": "IP_VERSION"
}
```
Sostituisci quanto segue:
- SERVICE_PROJECT: l'ID del progetto di servizio.
- REGION: la regione dell'endpoint. Deve trovarsi nella stessa regione dell'endpoint regionale a cui vuoi connetterti.
- ADDRESS_NAME: il nome da assegnare all'indirizzo IP statico.
- HOST_PROJECT: l'ID del progetto host.
- HOST_SUBNET: la subnet nella rete VPC condiviso da cui riservare l'indirizzo IP.
- IP_VERSION: la versione IP dell'indirizzo IP, che può essere IPV4 o IPV6. IPV4 è il valore predefinito. Per specificare IPV6, l'indirizzo IP deve essere connesso a una subnet con un intervallo di indirizzi IPv6 interni.
Crea l'endpoint Private Service Connect utilizzando il metodo projects.locations.regionalEndpoints.create.

Metodo HTTP e URL:
```
POST https://networkconnectivity.googleapis.com/v1/projects/SERVICE_PROJECT/locations/REGION/regionalEndpoints?regionalEndpointId=ENDPOINT_NAME
```
```
{
  "accessType": "REGIONAL",
  "address": "ADDRESS",
  "network": "projects/HOST_PROJECT/global/networks/HOST_NETWORK",
  "subnetwork": "projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET",
  "targetGoogleApi": "REP_DNS_NAME"
}
```
Sostituisci quanto segue:
- SERVICE_PROJECT: l'ID del progetto di servizio.
- REGION: la regione in cui vuoi creare l'endpoint.
- ENDPOINT_NAME: un nome per l'endpoint.
- ADDRESS: l'indirizzo IPv4 o IPv6 che vuoi utilizzare per l'endpoint. Se omesso, viene allocato un indirizzo IPv4 dalla subnet. Utilizza uno dei seguenti formati:
  - Indirizzo IPv4, ad esempio 10.0.0.2.
  - URI della risorsa indirizzo IPv4 o IPv6, ad esempio projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME.
- HOST_PROJECT: l'ID del progetto host.
- HOST_NETWORK: il nome della rete nel progetto host.
- HOST_SUBNET: il nome della subnet nel progetto host a cui vuoi connettere l'endpoint.
- REP_DNS_NAME: il nome host dell'endpoint di servizio regionale a cui vuoi connetterti. Ad esempio, spanner.me-central2.rep.googleapis.com.

Elenca endpoint

Puoi elencare tutti gli endpoint configurati.

Console

Nella console Google Cloud , vai alla pagina Private Service Connect.

Vai a Private Service Connect
Fai clic sulla scheda Endpoint connessi.

Vengono visualizzati tutti gli endpoint, inclusi quelli con target endpoint regionali.

gcloud

Utilizza il comando gcloud network-connectivity regional-endpoints list.

gcloud network-connectivity regional-endpoints list \
    --region=REGION

Sostituisci REGION con la regione degli endpoint che vuoi elencare.

API

Utilizza il metodo projects.locations.regionalEndpoints.list.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto dell'endpoint.
REGION: la regione degli endpoint che vuoi elencare.

Verificare che l'endpoint funzioni

Crea un'istanza di macchina virtuale (VM) nella rete VPC e nella regione in cui è configurato l'endpoint. Esegui questo comando sulla VM per verificare che l'endpoint Private Service Connect funzioni. Gli endpoint non rispondono alle richieste ping (ICMP).

Per verificare un endpoint IPv4:

curl --connect-to REP_DNS_NAME:443:ADDRESS:443 \
'https://REP_DNS_NAME/PATH'

Per verificare un endpoint IPv6:

curl -6 --connect-to REP_DNS_NAME:443:[ADDRESS]:443 \
'https://REP_DNS_NAME/PATH'

Sostituisci quanto segue:

REP_DNS_NAME: il nome DNS pubblico dell'endpoint regionale di destinazione, ad esempio spanner.me-central2.rep.googleapis.com.
ADDRESS: l'indirizzo IP dell'endpoint.
PATH: il percorso di una risorsa pubblicata da questo servizio. Ad esempio, molti servizi offrono un documento di rilevamento con il percorso $discovery/rest?version=v1.

La seguente richiesta di esempio verifica che un endpoint con indirizzo IP 192.168.1.100 possa richiedere il documento di rilevamento dell'API Cloud Spanner dall'endpoint regionale in me-central2.

curl --connect-to spanner.me-central2.rep.googleapis.com:443:192.168.1.100:443 \
'https://spanner.me-central2.rep.googleapis.com/$discovery/rest?version=v1'

Crea una voce DNS privata per l'endpoint

Devi creare voci DNS private in modo che i client possano indirizzare le richieste al tuo endpoint Private Service Connect.

Ti consigliamo di creare una zona privata che utilizzi lo stesso nome host dell'endpoint regionale di destinazione: SERVICE.REGION.rep.DOMAIN e di creare un record apex in quella zona.

Ad esempio, se l'endpoint Private Service Connect ha una destinazione spanner.me-central2.rep.googleapis.com, crea una zona privata per spanner.me-central2.rep.googleapis.com che contenga un record apex per spanner.me-central2.rep.googleapis.com. La creazione di record nell'apex del dominio significa che puoi accedere al nome host pubblico di altri endpoint regionali, ad esempio logging.me-central2.rep.googleapis.com.

Le sezioni seguenti descrivono come utilizzare Cloud DNS per creare una zona privata e un record DNS apex.

Crea una zona privata

Console

Nella console Google Cloud , vai alla pagina Crea una zona DNS.

Vai a Crea una zona DNS
Per Tipo di zona, seleziona Privata.
In Nome zona, inserisci un nome. Ad esempio, se l'endpoint Private Service Connect punta a spanner.me-central2.rep.googleapis.com, inserisci spanner-me-central2-rep-googleapis-com.
In Nome DNS, specifica il nome host dell'endpoint regionale di destinazione seguito da un punto finale. Ad esempio, spanner.me-central2.rep.googleapis.com..
(Facoltativo) Aggiungi una descrizione.
In Opzioni, seleziona Predefinita (privata).
Seleziona le reti VPC in cui vuoi che sia visibile la zona privata. Solo le reti VPC selezionate sono autorizzate a eseguire query sui record nella zona.
Fai clic su Crea.

gcloud

Esegui il comando dns managed-zones create:

gcloud dns managed-zones create ZONE_NAME \
    --dns-name=REP_DNS_NAME. \
    --networks=VPC_NETWORK_LIST \
    --visibility=private \
    --description="Private zone for REP_DNS_NAME"

Sostituisci quanto segue:

ZONE_NAME: un nome per la zona, ad esempio spanner-me-central2-rep-googleapis.com.
DESCRIPTION: una descrizione per la zona
REP_DNS_NAME: il suffisso DNS per la zona; utilizza il nome host dell'endpoint regionale di destinazione, ad esempio spanner.me-central2.rep.googleapis.com
VPC_NETWORK_LIST: un elenco delimitato da virgole di reti VPC autorizzate a eseguire query sulla zona.

API

Invia una richiesta POST utilizzando il metodo managedZones.create:

Metodo HTTP e URL:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones

Corpo JSON della richiesta:

{
  "name": "ZONE_NAME",
  "dnsName": "REP_DNS_NAME.",
  "description": "DESCRIPTION",
  "visibility": "private",
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_1_URL"
      },
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_2_URL"
      }
    ]
  }
}

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto della zona DNS.
ZONE_NAME: il nome della zona privata che hai creato per questo endpoint regionale.
REP_DNS_NAME: il nome di dominio completo del record che stai creando; utilizza il nome host dell'endpoint regionale di destinazione, ad esempio spanner.me-central2.rep.googleapis.com.
DESCRIPTION: una descrizione per la zona DNS.
NETWORK_1_URL e NETWORK_2_URL: gli URL completi delle reti VPC autorizzate a eseguire query sulla zona, ad esempio https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME.

Aggiungere un record DNS alla zona

Console

Nella console Google Cloud , vai alla pagina delle zone Cloud DNS.

Vai alle zone Cloud DNS
Fai clic sul nome della zona gestita a cui vuoi aggiungere il record.
Nella pagina Dettagli zona, fai clic su Aggiungi standard.
Nella pagina Crea set di record, lascia vuoto il campo Nome DNS. Se lasci vuoto il campo, viene creato un record di risorse nell'apex del dominio.
In Tipo di record di risorse, seleziona A.
Nel campo Indirizzo IPv4, inserisci o seleziona l'indirizzo IP dell'endpoint Private Service Connect.
Fai clic su Crea.

gcloud

Per aggiungere un set di record di risorse, utilizza il comando gcloud dns record-sets create:

gcloud dns record-sets create REP_DNS_NAME \
    --rrdatas=ADDRESS \
    --type=RECORD_TYPE \
    --ttl=TTL \
    --zone=ZONE_NAME

Sostituisci quanto segue:

REP_DNS_NAME: il nome di dominio completo del record che stai creando; utilizza il nome host dell'endpoint regionale di destinazione, ad esempio spanner.me-central2.rep.googleapis.com.
ADDRESS: l'indirizzo IP dell'endpoint Private Service Connect.
RECORD_TYPE: il tipo di record DNS, ad esempio A per i record IPv4 o AAAA per i record IPv6.
TTL: il TTL in secondi in cui il resolver memorizza nella cache questo set di record di risorse, ad esempio 300.
ZONE_NAME: il nome della zona privata che hai creato per questo endpoint regionale.

API

Per aggiungere un set di record di risorse, utilizza il metodo resourceRecordSets.create:

Metodo HTTP e URL:

POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/ZONE_NAME/rrsets

Corpo JSON della richiesta:

{
  "name": "REP_DNS_NAME.",
  "type": "RECORD_TYPE",
  "ttl": TTL,
  "rrdatas": [ "ADDRESS" ]
}

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto della zona DNS.
ZONE_NAME: il nome della zona privata che hai creato per questo endpoint regionale.
REP_DNS_NAME: il nome di dominio completo del record che stai creando; utilizza il nome host dell'endpoint regionale di destinazione, ad esempio spanner.me-central2.rep.googleapis.com.
RECORD_TYPE: il tipo di record DNS, ad esempio A per i record IPv4 o AAAA per i record IPv6.
TTL: il TTL in secondi in cui il resolver memorizza nella cache questo set di record di risorse, ad esempio 300.
ADDRESS: l'indirizzo IP dell'endpoint Private Service Connect.

Configura i client in modo che utilizzino il nome dell'endpoint privato

Devi configurare i client in modo che utilizzino i nomi DNS privati anziché quelli pubblici. Consulta la documentazione del client o della libreria client per informazioni sulla configurazione per l'utilizzo di endpoint personalizzati. Le pagine seguenti includono i passaggi di configurazione per alcuni client comuni:

Python: puoi configurare api_endpoint in Opzioni client.
Vai: puoi configurare WithEndpoint in ClientOptions.
.NET: puoi configurare Endpoint nella classe builder del client.
Java: puoi configurare setEndpoint nella classe delle impostazioni del client.
gcloud: puoi configurare api_endpoint_overrides in gcloud CLI.

Visualizzare informazioni dettagliate su un endpoint

Puoi visualizzare i dettagli di configurazione di un endpoint.

gcloud

Utilizza il comando gcloud network-connectivity regional-endpoints describe.

gcloud network-connectivity regional-endpoints describe \
    ENDPOINT_NAME --region=REGION

Sostituisci quanto segue:

ENDPOINT_NAME: il nome dell'endpoint.
REGION: la regione dell'endpoint.

API

Utilizza il comando projects.locations.regionalEndpoints.get.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto dell'endpoint.
REGION: la regione degli endpoint che vuoi elencare.
ENDPOINT_NAME: il nome dell'endpoint.

Aggiorna la configurazione di accesso globale

Non puoi aggiornare un endpoint Private Service Connect con una destinazione endpoint regionale. Se devi modificare l'impostazione di accesso globale per l'endpoint, elimina l'endpoint e creane uno nuovo con l'impostazione di accesso globale richiesta.

Eliminazione di un endpoint

Puoi eliminare un endpoint.

gcloud

Utilizza il comando gcloud network-connectivity regional-endpoints delete.

gcloud network-connectivity regional-endpoints delete \
    ENDPOINT_NAME --region=REGION

Sostituisci quanto segue:

ENDPOINT_NAME: il nome dell'endpoint.
REGION: la regione dell'endpoint.

API

Utilizza il comando projects.location.regionalEndpoints.delete.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto dell'endpoint.
REGION: la regione dell'endpoint.
ENDPOINT_NAME: il nome dell'endpoint.

Accedere agli endpoint dalle reti ibride

I client nelle reti connesse a Google Cloud con collegamenti VLAN per Cloud Interconnect o tunnel Cloud VPN possono raggiungere gli endpoint Private Service Connect.

Il collegamento VLAN o il tunnel Cloud VPN deve terminare nella stessa rete VPC (o rete VPC condiviso) dell'endpoint. I client nelle reti VPC in peering non possono raggiungere gli endpoint.
Il traffico client dai collegamenti VLAN o dai tunnel Cloud VPN può raggiungere gli endpoint in un'altra regione se è configurato l'accesso globale.
Sia Dataplane v1 che Dataplane v2 sono supportati per i collegamenti VLAN. Per ulteriori informazioni sulle versioni di Dataplane, consulta Dataplane v2.

Devi configurare i sistemi nell'altra rete in modo che possano eseguire query sulle tue zone DNS private.

Se hai implementato le zone DNS private utilizzando Cloud DNS, completa i seguenti passaggi:

Crea una policy dei server in entrata nella rete VPC a cui si connette l'altra rete.
Identifica gli entry point del forwarder in entrata nella regione in cui si trova il collegamento VLAN o il tunnel Cloud VPN, nella rete VPC a cui si connette l'altra rete.
Configura i sistemi e i server dei nomi DNS nell'altra rete per inoltrare i nomi DNS per l'endpoint a un punto di ingresso del forwarder in entrata nella stessa regione del collegamento VLAN o del tunnel Cloud VPN che si connette alla rete VPC.