Accede a las APIs regionales de Google a través de extremos

Console

1. En la consola de Google Cloud , ve a la página Private Service Connect.

   Ir a Private Service Connect

2. Haz clic en Conectar extremo.

3. En Destino, selecciona API de Google.

4. En la lista Alcance, selecciona Regional.

5. En la lista Región, selecciona la región que deseas usar.

6. En la lista Servicio de destino, selecciona el servicio al que deseas acceder.

7. En Nombre del extremo, ingresa un nombre para el extremo.

8. En Red, selecciona una red.

9. En Subred, selecciona una subred.

10. En Dirección IP, realiza una de las siguientes acciones para configurar una dirección IP:

    • Selecciona Asignación automática para asignar y reservar automáticamente una nueva dirección IP estática.
    • Selecciona una dirección IP estática de la lista.
    • Haz clic en Crear dirección IP para reservar una dirección IP estática nueva.

11. Opcional: Para que el extremo esté disponible desde todas las regiones de la red de VPC, selecciona Habilitar el acceso global.

12. Haz clic en Agregar extremo.

gcloud

Usa el comando gcloud network-connectivity regional-endpoints create para crear el extremo.

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

Si deseas que el extremo esté disponible para los recursos en otras regiones, agrega la marca --enable-global-access.

Reemplaza lo siguiente:

• ENDPOINT_NAME: un nombre para el extremo.

• REGION: región en la que deseas crear el extremo.

• ADDRESS: Es la dirección IPv4 o IPv6 que deseas usar para el extremo. Si se omite, se asigna una dirección IPv4 de la subred. Usa uno de los siguientes formatos:

  • Dirección IPv4, por ejemplo, 10.0.0.2.
  • Es el URI del recurso de dirección IPv4 o IPv6, por ejemplo, projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME.

• PROJECT_ID: Es el proyecto en el que crearás el extremo.

• NETWORK_NAME: nombre de la red de VPC para el extremo.

• SUBNET_NAME: Es la subred a la que conectas el extremo.

• REP_DNS_NAME: Es el nombre de host del extremo del servicio regional al que te conectas. Por ejemplo, spanner.me-central2.rep.googleapis.com.

API

Usa el método projects.locations.regionalEndpoints.create para crear el extremo.

Método HTTP y 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"
  }
  

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto del extremo.
• REGION: Es la región en la que deseas crear el extremo.
• ENDPOINT_NAME: un nombre para el extremo.
• ADDRESS: Es la dirección IPv4 o IPv6 que deseas usar para el extremo. Si se omite, se asigna una dirección IPv4 de la subred. Usa uno de los siguientes formatos:
  • Dirección IPv4, por ejemplo, 10.0.0.2.
  • Es el URI del recurso de dirección IPv4 o IPv6, por ejemplo, projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME.
• NETWORK_NAME: Es el nombre de la red de VPC para el extremo.
• SUBNET_NAME: Es el nombre de la subred a la que deseas conectar el extremo.
• REP_DNS_NAME: Es el nombre de host del extremo del servicio regional al que deseas conectarte. Por ejemplo:spanner.me-central2.rep.googleapis.com

gcloud

1. Reserva una dirección IP estática para usarla en el extremo regional con el comando gcloud compute addresses create. El uso de una dirección IP estática es opcional para IPv4 y obligatorio para IPv6.

   Crea el recurso de dirección en el proyecto de servicio y especifica una subred en el proyecto 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
   

   Reemplaza lo siguiente:

   • ADDRESS_NAME: Es el nombre que se asignará a la dirección IP reservada.
   • REGION: Es la región de la dirección IP del extremo. Debe ser la misma región que contiene el adjunto del servicio del productor de servicios.
   • HOST_PROJECT: el ID del proyecto host.
   • HOST_SUBNET: Es el nombre de la subred para la dirección IP del extremo.
   • IP_VERSION: La versión de IP de la dirección IP, que puede ser IPV4 o IPV6. IPV4 es la configuración predeterminada. Para especificar IPV6, la dirección IP debe estar conectada a una subred con un rango de direcciones IPv6 interno.
   • SERVICE_PROJECT: el ID del proyecto de servicio

2. Usa el comando gcloud network-connectivity regional-endpoints create para crear el extremo regional en el proyecto de servicio.

   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
       

   Si deseas que el extremo esté disponible para los recursos en otras regiones, agrega la marca --enable-global-access.

   Reemplaza lo siguiente:

   • ENDPOINT_NAME: un nombre para el extremo.

   • REGION: región en la que deseas crear el extremo.

   • ADDRESS: Es la dirección IPv4 o IPv6 que deseas usar para el extremo. Si se omite, se asigna una dirección IPv4 de la subred. Usa uno de los siguientes formatos:

     • Dirección IPv4, por ejemplo, 10.0.0.2.
     • Es el URI del recurso de dirección IPv4 o IPv6. El recurso de dirección debe crearse en el proyecto de servicio, no en el proyecto host. Por ejemplo, projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME.
     • HOST_PROJECT: el ID del proyecto host.

   • HOST_NETWORK: Es el nombre de la red de VPC en el proyecto host.

   • HOST_SUBNET: Es la subred del proyecto host al que conectas el extremo.

   • REP_DNS_NAME: Es el nombre de host del extremo del servicio regional al que te conectas. Por ejemplo, spanner.me-central2.rep.googleapis.com.

   • SERVICE_PROJECT: el ID del proyecto de servicio

API

1. Reserva una dirección IP estática para usarla en el extremo regional. El uso de una dirección IP estática es opcional para IPv4 y obligatorio para IPv6.

   Crea el recurso de dirección en el proyecto de servicio y especifica una subred en el proyecto 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"
   }
   

   Reemplaza lo siguiente:

   • SERVICE_PROJECT: el ID del proyecto de servicio

   • REGION: Es la región para el extremo. Debe ser la misma región que el extremo regional al que deseas conectarte.

   • ADDRESS_NAME: Es el nombre que se asignará a la dirección IP estática.

   • HOST_PROJECT: el ID del proyecto host.

   • HOST_SUBNET: Es la subred de la red de VPC compartida desde la que se reservará la dirección IP.

   • IP_VERSION: La versión de IP de la dirección IP, que puede ser IPV4 o IPV6. IPV4 es la configuración predeterminada. Para especificar IPV6, la dirección IP debe estar conectada a una subred con un rango de direcciones IPv6 interno.

2. Crea el extremo de Private Service Connect con el método projects.locations.regionalEndpoints.create.

   Método HTTP y 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"
   }
   

   Reemplaza lo siguiente:

   • SERVICE_PROJECT: el ID del proyecto de servicio
   • REGION: región en la que deseas crear el extremo.
   • ENDPOINT_NAME: un nombre para el extremo.
   • ADDRESS: Es la dirección IPv4 o IPv6 que deseas usar para el extremo. Si se omite, se asigna una dirección IPv4 de la subred. Usa uno de los siguientes formatos:
     • Dirección IPv4, por ejemplo, 10.0.0.2.
     • Es el URI del recurso de dirección IPv4 o IPv6, por ejemplo, projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME.
   • HOST_PROJECT: el ID del proyecto host.
   • HOST_NETWORK: Es el nombre de la red en el proyecto host.
   • HOST_SUBNET: Es el nombre de la subred en el proyecto host al que deseas conectar el extremo.
   • REP_DNS_NAME: Es el nombre de host del extremo del servicio regional al que deseas conectarte. Por ejemplo, spanner.me-central2.rep.googleapis.com.

Console

1. En la consola de Google Cloud , ve a la página Private Service Connect.

   Ir a Private Service Connect

2. Haz clic en la pestaña Extremos conectados.

   Se muestran todos los extremos, incluidos los que tienen objetivos de extremos regionales.

gcloud

Usa el comando gcloud network-connectivity regional-endpoints list.

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

Reemplaza REGION por la región de los extremos que deseas enumerar.

API

Usa el método projects.locations.regionalEndpoints.list.

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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto del extremo.
• REGION: Es la región de los extremos que deseas enumerar.

Console

1. En la consola de Google Cloud , dirígete a la página Crea una zona del DNS.

   Ir a Crea una zona del DNS

2. En Tipo de zona, selecciona Privada.

3. En Nombre de la zona, ingresa un nombre. Por ejemplo, si tu extremo de Private Service Connect apunta a spanner.me-central2.rep.googleapis.com, ingresa spanner-me-central2-rep-googleapis-com.

4. En Nombre de DNS, especifica el nombre de host del extremo regional de destino seguido de un punto final. Por ejemplo, spanner.me-central2.rep.googleapis.com..

5. Opcional: agrega una descripción.

6. En Opciones, selecciona Predeterminada (privada).

7. Selecciona las redes de VPC en las que quieres que la zona privada sea visible. Solo las redes de VPC que selecciones tienen autorización para consultar registros en la zona.

8. Haz clic en Crear.

gcloud

Ejecuta el 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"

Reemplaza lo siguiente:

• ZONE_NAME: Un nombre para tu zona, por ejemplo, spanner-me-central2-rep-googleapis.com.
• DESCRIPTION: Es una descripción para tu zona.
• REP_DNS_NAME: Es el sufijo de DNS para tu zona. Usa el nombre de host del extremo regional de destino, por ejemplo, spanner.me-central2.rep.googleapis.com.
• VPC_NETWORK_LIST: Es una lista delimitada por comas de redes de VPC que están autorizadas a consultar la zona.

API

Envía una solicitud POST a través del método managedZones.create:

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "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"
      }
    ]
  }
}

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto de la zona del DNS.
• ZONE_NAME: Es el nombre de la zona privada que creaste para este extremo regional.
• REP_DNS_NAME: Es el FQDN del registro que creas. Usa el nombre de host del extremo regional de destino, por ejemplo, spanner.me-central2.rep.googleapis.com.
• DESCRIPTION: Es una descripción de la zona de DNS.
• NETWORK_1_URL y NETWORK_2_URL: Son las URLs completas de las redes de VPC que están autorizadas para consultar la zona, por ejemplo, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME.

Console

1. En la consola de Google Cloud , ve a la página Zonas de Cloud DNS.

   Ir a Zonas de Cloud DNS

2. Haz clic en el nombre de la zona administrada a la que deseas agregar el registro.

3. En la página Detalles de la zona, haz clic en Agregar estándar.

4. En la página Crear un conjunto de registros, deja el campo Nombre de DNS en blanco. Si lo dejas en blanco, se creará un registro de recursos en la parte superior del dominio.

5. En Tipo de registro del recurso, selecciona A.

6. En el campo Dirección IPv4, ingresa o selecciona la dirección IP del extremo de Private Service Connect.

7. Haz clic en Crear.

gcloud

Para agregar un conjunto de registros de recursos, usa el comando gcloud dns record-sets create:

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

Reemplaza lo siguiente:

• REP_DNS_NAME: Es el FQDN del registro que creas. Usa el nombre de host del extremo regional de destino, por ejemplo, spanner.me-central2.rep.googleapis.com.
• ADDRESS: dirección IP del extremo de Private Service Connect.
• RECORD_TYPE: Es el tipo de registro DNS, como A para registros IPv4 o AAAA para registros IPv6.
• TTL: Es el TTL en segundos que el agente de resolución almacena en caché este conjunto de registros de recursos; por ejemplo, 300.
• ZONE_NAME: Es el nombre de la zona privada que creaste para este extremo regional.

API

Para agregar un conjunto de registros de recursos, usa el método resourceRecordSets.create:

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto de la zona del DNS.
• ZONE_NAME: Es el nombre de la zona privada que creaste para este extremo regional.
• REP_DNS_NAME: Es el FQDN del registro que creas. Usa el nombre de host del extremo regional de destino, por ejemplo, spanner.me-central2.rep.googleapis.com.
• RECORD_TYPE: Es el tipo de registro DNS, como A para registros IPv4 o AAAA para registros IPv6.
• TTL: Es el TTL en segundos que el agente de resolución almacena en caché este conjunto de registros de recursos; por ejemplo, 300.
• ADDRESS: dirección IP del extremo de Private Service Connect.

gcloud

Usa el comando gcloud network-connectivity regional-endpoints describe.

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

Reemplaza lo siguiente:

• ENDPOINT_NAME: El nombre del extremo.
• REGION: la región del extremo.

API

Usa el comando projects.locations.regionalEndpoints.get.

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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto del extremo.
• REGION: Es la región de los extremos que deseas enumerar.
• ENDPOINT_NAME: El nombre del extremo.

gcloud

Usa el comando gcloud network-connectivity regional-endpoints delete.

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

Reemplaza lo siguiente:

• ENDPOINT_NAME: El nombre del extremo.
• REGION: la región del extremo.

API

Usa el comando projects.location.regionalEndpoints.delete.

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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID del proyecto del extremo.
• REGION: la región del extremo.
• ENDPOINT_NAME: El nombre del extremo.