Conectarse a una instancia mediante Conexión de servicio privado

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Consola

1. En el Google Cloud consola, vaya a la página Conectar servicio privado .

   Ir a Conexión de Servicio Privado

2. Haga clic en la pestaña Políticas de conexión .

3. Haga clic en Crear política de conexión .

4. Introduzca un nombre para la política de conexión.

5. Especifique la clase de servicio haciendo lo siguiente:

   1. Para la clase de servicio de origen , seleccione Servicios de Google .
   2. En el menú de clase Servicio , seleccione google-cloud-sql porque Cloud SQL es el servicio administrado para la política de conexión.

6. En la sección Alcance de los puntos finales de destino , seleccione una red y una región a las que se aplica esta política.

7. En la sección Política , seleccione una o más subredes del menú Subredes . Las subredes se utilizan para asignar direcciones IP a los endpoints.

8. Opcional: Especifique un límite de conexión para la política. Este límite determina cuántos puntos finales se pueden crear con esta política de conexión. Si no especifica un límite de conexión, no hay límite.

9. Haga clic en Crear política .

nube g

Para crear una política de conexión de servicio, utilice el comando service-connection-policies create .

gcloud network-connectivity service-connection-policies create POLICY_NAME \
    --network=NETWORK \
    --project=PROJECT_ID \
    --region=REGION \
    --service-class=SERVICE_CLASS \
    --subnets=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks/SUBNETS \
    --psc-connection-limit=LIMIT \
    --description="DESCRIPTION" \
    --producer-instance-location=PRODUCER_INSTANCE_LOCATION \
    --allowed-google-producers-resource-hierarchy-level=RESOURCE_HIERARCHY_LEVEL

Reemplace lo siguiente:

• POLICY_NAME : el nombre de su política de conexión de servicio.
• NETWORK : la red a la que se aplica esta política.
• PROJECT_ID : ID o número de proyecto de la red de VPC. Para redes de VPC compartidas, debe implementar políticas de conexión de servicio en el proyecto host, ya que estas políticas no son compatibles con los proyectos de servicio.
• REGION : la región a la que se aplica esta política. La misma política debe existir para cada región donde se desee automatizar la conectividad del servicio.
• SERVICE_CLASS : el identificador de recurso proporcionado por el productor para la clase de servicio. Para Cloud SQL, la clase de servicio es google-cloud-sql .
• SUBNETS : una o más subredes de consumidor habituales que se utilizan para asignar direcciones IP a los endpoints de Conexión de Servicio Privado. Estas direcciones IP se asignan automáticamente y se devuelven al grupo de subredes a medida que se crean y eliminan instancias de servicio administradas. Las subredes deben estar en la misma región que la política de conexión de servicio. Si varias políticas de conexión comparten la misma región, puede reutilizar la misma subred en ellas. Puede introducir varias subredes en una lista separada por comas.
• LIMIT : el número máximo de endpoints que se pueden crear con esta política. Si no se especifica un límite, no hay límite.
• DESCRIPTION : una descripción opcional de la política de conexión del servicio.

• PRODUCER_INSTANCE_LOCATION : Use este indicador opcional para especificar si se autoriza una jerarquía personalizada de ubicaciones para una instancia de Cloud SQL. Puede establecer el valor de PRODUCER_INSTANCE_LOCATION en solo uno de los siguientes:

  • custom-resource-hierarchy-levels : la instancia debe estar ubicada en uno de los proyectos, carpetas u organizaciones que proporcione como valor para el parámetro allowed-google-producers-resource-hierarchy-level .
  • none : la instancia está en el mismo proyecto que la política de conexión del servicio.

• RESOURCE_HIERARCHY_LEVEL : lista de proyectos, carpetas u organizaciones donde se encuentra la instancia. Esta lista tiene el formato projects/ PROJECT_ID , folders/ FOLDER_ID u organizations/ ORGANIZATION_ID .

Por ejemplo, el siguiente comando crea una política de conexión de servicio para el
Clase de servicio google-cloud-sql que asigna direcciones IP desde la subred managed-services . Se puede crear un máximo de 10 puntos de conexión de servicio privado con esta política. Los puntos de conexión deben crearse en proyectos que pertenezcan a la misma organización que la instancia de servicio administrado. La instancia de Cloud SQL se encuentra en el proyecto myproject .

gcloud network-connectivity service-connection-policies create cloud-sql-policy \
    --network=default \
    --project=my-project \
    --region=us-central1 \
    --service-class=google-cloud-sql \
    --subnets=managed-service-subnet \
    --psc-connection-limit=10 \
    --producer-instance-location=custom-resource-hierarchy-levels \
    --allowed-google-producers-resource-hierarchy-level=projects/myproject

DESCANSAR

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID de su proyecto.
• REGION : la región de su política de conexión de servicio.
• POLICY_NAME : el nombre de su política de conexión de servicio.
• DESCRIPTION : una descripción opcional de su política de conexión de servicio.
• NETWORK : la red de su política de conexión de servicio.
• LIMIT : el número máximo de endpoints que se pueden crear con esta política. Si no se especifica un límite, no hay límite.
• SUBNETS : una o más subredes de consumidor habituales que se utilizan para asignar direcciones IP a los endpoints de Conexión de Servicio Privado. Estas direcciones IP se asignan automáticamente y se devuelven al grupo de subredes a medida que se crean y eliminan instancias de servicio administradas. Las subredes deben estar en la misma región que la política de conexión de servicio. Si varias políticas de conexión comparten la misma región, puede reutilizar la misma subred en ellas. Puede introducir varias subredes en una lista separada por comas.
• SERVICE_CLASS : el identificador de recurso proporcionado por el productor de la clase de servicio.

Método HTTP y URL:

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/serviceConnectionPolicies?serviceConnectionPolicyId=POLICY_NAME

Cuerpo JSON de la solicitud:

{
  "description": "DESCRIPTION",
  "network": "projects/PROJECT_ID/global/networks/NETWORK",
  "pscConfig": {
    "limit": "LIMIT",
    "subnetworks": [
      "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET"
    ]
  },
  "serviceClass": "SERVICE_CLASS"
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/serviceConnectionPolicies?serviceConnectionPolicyId=POLICY_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/serviceConnectionPolicies?serviceConnectionPolicyId=POLICY_NAME" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.networkconnectivity.v1.OperationMetadata",
    "createTime": "2023-08-15T16:59:29.236110917Z",
    "target": "projects/PROJECT_ID/locations/REGION/serviceConnectionPolicies/POLICY_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

nube g

Para crear una instancia con Private Service Connect habilitado para la instancia, use el comando gcloud sql instances create :

gcloud sql instances create INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip \
--tier=MACHINE_TYPE \
--database-version=DATABASE_VERSION \
--psc-auto-connections=network=CONSUMER_NETWORK,project=CONSUMER_PROJECT

Realice las siguientes sustituciones:

• INSTANCE_NAME : el nombre de la instancia.
• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.
• REGION_NAME : el nombre de la región para la instancia.

• ALLOWED_PROJECTS : una lista separada por comas de ID o números de proyectos permitidos desde donde los puntos finales de Private Service Connect pueden conectarse a instancias de Cloud SQL.

  Si un proyecto no está incluido en esta lista, no podrás crear puntos finales de conexión de servicio privado en el proyecto para conectarte a la instancia.

• AVAILABILITY_TYPE : habilita la alta disponibilidad para la instancia. Para este parámetro, especifique uno de los siguientes valores:
  • REGIONAL : Permite alta disponibilidad y se recomienda para instancias de producción. La instancia conmuta por error a otra zona dentro de la región seleccionada.
  • ZONAL : no ofrece conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y eliminar la alta disponibilidad para instancias, consulte Configurar una instancia existente para alta disponibilidad y Desactivar la alta disponibilidad para una instancia .

• MACHINE_TYPE : el tipo de máquina para la instancia.
• DATABASE_VERSION : la versión de la base de datos para la instancia (por ejemplo, POSTGRES_13 ).
• CONSUMER_NETWORK : la ruta a la red VPC desde donde se deben crear los puntos de conexión de Private Service Connect. Por ejemplo:
  projects/my-host-project/global/networks/default .

• CONSUMER_PROJECT : el proyecto donde se crea el punto de conexión de servicio privado. Si utiliza una red VPC compartida, puede ser el proyecto host o el proyecto de servicio.

  Los proyectos que especifique en los parámetros de conexión automática se añadirán automáticamente a sus proyectos permitidos. Opcionalmente, puede añadir los proyectos para los que desee crear puntos de conexión de servicio privado manualmente a su lista de proyectos permitidos.

DESCANSAR

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.
• INSTANCE_NAME : el nombre de la instancia.
• REGION_NAME : el nombre de la región para la instancia.
• AVAILABILITY_TYPE : habilita la alta disponibilidad para la instancia. Para este parámetro, especifique uno de los siguientes valores:
  • REGIONAL : Permite alta disponibilidad y se recomienda para instancias de producción. La instancia conmuta por error a otra zona dentro de la región seleccionada.
  • ZONAL : no ofrece conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y eliminar la alta disponibilidad para instancias, consulte Configurar una instancia existente para alta disponibilidad y Desactivar la alta disponibilidad para una instancia .

• ALLOWED_PROJECTS : una lista separada por comas de ID o números de proyectos permitidos desde donde los puntos finales de Private Service Connect pueden conectarse a instancias de Cloud SQL.

  Si un proyecto no está incluido en esta lista, no podrás crear puntos finales de conexión de servicio privado en el proyecto para conectarte a la instancia.

• MACHINE_TYPE : el tipo de máquina para la instancia.
• CONSUMER_NETWORK : la red VPC donde desea permitir la creación automática de puntos finales de conexión de servicio privado.
• PARENT_PROJECT : el proyecto que contiene la red CONSUMER_NETWORK . Si no se especifica otro proyecto en CONSUMER_PROJECT , los puntos finales se crean automáticamente en PARENT_PROJECT

  CONSUMER_PROJECT : Opcional. Especifique esto solo si CONSUMER_NETWORK es una red de VPC compartida y desea permitir la creación automática de puntos de conexión de servicio privado en un proyecto de servicio.

  Los proyectos que especifique en los parámetros de conexión automática se añadirán automáticamente a sus proyectos permitidos. Opcionalmente, puede añadir los proyectos para los que desee crear puntos de conexión de servicio privado manualmente a su lista de proyectos permitidos.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Cuerpo JSON de la solicitud:

{
  "name": "INSTANCE_NAME",
  "project": PROJECT_ID",
  "region": "REGION_NAME",
  "databaseVersion": "POSTGRES_13",
  "kind": "sql#instance",
  "settings": {
    "availabilityType": "AVAILABILITY_TYPE",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscAutoConnections": [
          {
            "consumerProject":"CONSUMER_PROJECT",
            "consumerNetwork":"projects/PARENT_PROJECT/global/networks/CONSUMER_NETWORK"
          }
        ],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "RUNNING",
  "user": "[email protected]",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

nube g

Para ver información sobre una instancia, incluida la dirección IP que es el punto final de conexión de servicio privado para la instancia, use el comando gcloud sql instances describe :

gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID \
--format='json(settings.ipConfiguration.pscConfig.pscAutoConnections)'

Realice las siguientes sustituciones:

• INSTANCE_NAME : el nombre de la instancia de Cloud SQL. Si esta instancia tiene habilitada la Conexión de Servicio Privado , los puntos de conexión de la Conexión de Servicio Privado en redes VPC podrán conectarse a ella.
• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.

En la respuesta, observe el valor que aparece junto al campo pscConfig:pscAutoConnections:ipAddress . Este valor corresponde a la dirección IP interna que también es el punto final de Private Service Connect para la instancia.

DESCANSAR

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.
• INSTANCE_NAME : el nombre de la instancia de Cloud SQL. Si esta instancia tiene habilitada la Conexión de Servicio Privado , los puntos de conexión de la Conexión de Servicio Privado en redes VPC podrán conectarse a ella.

Método HTTP y URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar su solicitud, expanda una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
      "pscAutoConnections": {
        consumerNetwork:"projects/PARENT_PROJECT/global/networks/CONSUMER_NETWORK",
        consumerNetworkStatus:"CONSUMER_NETWORK_STATUS",
        consumerProject:"CONSUMER_PROJECT",
        ipAddress:"IP_ADDRESS",
        status:"STATUS"
        },
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
}

Los siguientes campos existen para las instancias que tienen habilitada la Conexión de servicio privado:

• allowedConsumerProjects : lista de los proyectos permitidos para la instancia. Puede crear puntos de conexión de servicio privado desde cualquier red de VPC de estos proyectos hasta la conexión de servicio de la instancia.
• pscAutoConnections : la red VPC permitida, el estado de la política de conexión del servicio y el estado de la dirección IP que es el punto final de la instancia.
• pscEnabled : si una instancia tiene habilitada la Conexión de servicio privado.

Para ver cómo construir la solicitud de API REST subyacente para esta tarea, consulte la página instancias:get .

nube g

Para crear una instancia con Private Service Connect habilitado para la instancia, use el comando gcloud sql instances create :

gcloud sql instances create INSTANCE_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--availability-type=AVAILABILITY_TYPE \
--no-assign-ip \
--tier=MACHINE_TYPE \
--database-version=DATABASE_VERSION

Realice las siguientes sustituciones:

• INSTANCE_NAME : el nombre de la instancia.
• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.
• REGION_NAME : el nombre de la región para la instancia.

• ALLOWED_PROJECTS : una lista separada por comas de ID o números de proyectos permitidos desde donde los puntos finales de Private Service Connect pueden conectarse a instancias de Cloud SQL.

  Si un proyecto no está incluido en esta lista, no podrás crear puntos finales de conexión de servicio privado en el proyecto para conectarte a la instancia.

• AVAILABILITY_TYPE : habilita la alta disponibilidad para la instancia. Para este parámetro, especifique uno de los siguientes valores:
  • REGIONAL : Permite alta disponibilidad y se recomienda para instancias de producción. La instancia conmuta por error a otra zona dentro de la región seleccionada.
  • ZONAL : no ofrece conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y eliminar la alta disponibilidad para instancias, consulte Configurar una instancia existente para alta disponibilidad y Desactivar la alta disponibilidad para una instancia .

• MACHINE_TYPE : el tipo de máquina para la instancia.
• DATABASE_VERSION : la versión de la base de datos para la instancia (por ejemplo, POSTGRES_13 ).

Terraformar

Para crear una instancia con Private Service Connect habilitado para la instancia, use el recurso de Terraform google_sql_database_instance .

resource "google_sql_database_instance" "default" {
  name             = "postgres-instance"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier              = "db-custom-2-7680"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled = true
    }
    ip_configuration {
      psc_config {
        psc_enabled               = true
        allowed_consumer_projects = []
      }
      ipv4_enabled = false
    }
  }
}

Para aplicar su configuración de Terraform en un Google Cloud proyecto, complete los pasos de las siguientes secciones.

Preparar Cloud Shell

1. Inicie Cloud Shell .

2. Establecer el valor predeterminado Google Cloud Proyecto donde desea aplicar sus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si establece valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz ).

1. En Cloud Shell , cree un directorio y un nuevo archivo dentro de él. El nombre del archivo debe tener la extensión .tf ; por ejemplo, main.tf En este tutorial, el archivo se denomina main.tf

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si está siguiendo un tutorial, puede copiar el código de muestra en cada sección o paso.

   Copie el código de muestra en el main.tf recién creado.

   Opcionalmente, copie el código de GitHub. Esto se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

3. Revise y modifique los parámetros de muestra para aplicarlos a su entorno.
4. Guarde sus cambios.
5. Inicialice Terraform. Solo necesita hacerlo una vez por directorio.

   terraform init

   Opcionalmente, para utilizar la última versión del proveedor de Google, incluya la opción -upgrade :

   terraform init -upgrade

Aplicar los cambios

1. Revise la configuración y verifique que los recursos que Terraform va a crear o actualizar coincidan con sus expectativas:

   terraform plan

   Realice correcciones en la configuración según sea necesario.

2. Aplique la configuración de Terraform ejecutando el siguiente comando e ingresando yes en el indicador:

   terraform apply

   Espere hasta que Terraform muestre el mensaje "¡Aplicación completada!"

3. Abre tu Google Cloud proyecto para ver los resultados. En el Google Cloud consola, navegue a sus recursos en la interfaz de usuario para asegurarse de que Terraform los haya creado o actualizado.

DESCANSAR

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.
• INSTANCE_NAME : el nombre de la instancia.
• REGION_NAME : el nombre de la región para la instancia.
• AVAILABILITY_TYPE : habilita la alta disponibilidad para la instancia. Para este parámetro, especifique uno de los siguientes valores:
  • REGIONAL : Permite alta disponibilidad y se recomienda para instancias de producción. La instancia conmuta por error a otra zona dentro de la región seleccionada.
  • ZONAL : no ofrece conmutación por error. Este es el valor predeterminado.

  Para obtener más información sobre cómo configurar y eliminar la alta disponibilidad para instancias, consulte Configurar una instancia existente para alta disponibilidad y Desactivar la alta disponibilidad para una instancia .

• ALLOWED_PROJECTS : una lista separada por comas de ID o números de proyectos permitidos desde donde los puntos finales de Private Service Connect pueden conectarse a instancias de Cloud SQL.

  Si un proyecto no está incluido en esta lista, no podrás crear puntos finales de conexión de servicio privado en el proyecto para conectarte a la instancia.

• MACHINE_TYPE : el tipo de máquina para la instancia.

Método HTTP y URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Cuerpo JSON de la solicitud:

{
  "name": "INSTANCE_NAME",
  "project": PROJECT_ID",
  "region": "REGION_NAME",
  "databaseVersion": "POSTGRES_13",
  "kind": "sql#instance",
  "settings": {
    "availabilityType": "AVAILABILITY_TYPE",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "RUNNING",
  "user": "[email protected]",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "2023-06-14T18:48:35.499Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

nube g

Para ver información resumida sobre una instancia con Conexión de servicio privado habilitada, como el campo pscServiceAttachmentLink que muestra el URI que apunta a la conexión de servicio de la instancia, use el comando gcloud sql instances describe :

gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID

Realice las siguientes sustituciones:

• INSTANCE_NAME : el nombre de la instancia de Cloud SQL a la que se pueden conectar los puntos finales de Private Service Connect en redes VPC
• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia

El siguiente ejemplo muestra una muestra de salida para este comando:

gcloud sql instances describe myinstance \
--project=12345

...
pscServiceAttachmentLink: projects/45678/regions/myregion/serviceAttachments/myserviceattachment

Terraformar

Para obtener la URI de conexión del servicio, utilice el recurso Terraform google_compute_address .

resource "google_compute_address" "default" {
  name         = "psc-compute-address"
  region       = "us-central1"
  address_type = "INTERNAL"
  subnetwork   = "default"     # Replace value with the name of the subnet here.
  address      = "10.128.0.42" # Replace value with the IP address to reserve.
}

data "google_sql_database_instance" "default" {
  name = resource.google_sql_database_instance.default.name
}

resource "google_compute_forwarding_rule" "default" {
  name                  = "psc-forwarding-rule-${google_sql_database_instance.default.name}"
  region                = "us-central1"
  network               = "default"
  ip_address            = google_compute_address.default.self_link
  load_balancing_scheme = ""
  target                = data.google_sql_database_instance.default.psc_service_attachment_link
}

Para aplicar su configuración de Terraform en un Google Cloud proyecto, complete los pasos de las siguientes secciones.

Preparar Cloud Shell

1. Inicie Cloud Shell .

2. Establecer el valor predeterminado Google Cloud Proyecto donde desea aplicar sus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si establece valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz ).

1. En Cloud Shell , cree un directorio y un nuevo archivo dentro de él. El nombre del archivo debe tener la extensión .tf ; por ejemplo, main.tf En este tutorial, el archivo se denomina main.tf

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si está siguiendo un tutorial, puede copiar el código de muestra en cada sección o paso.

   Copie el código de muestra en el main.tf recién creado.

   Opcionalmente, copie el código de GitHub. Esto se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

3. Revise y modifique los parámetros de muestra para aplicarlos a su entorno.
4. Guarde sus cambios.
5. Inicialice Terraform. Solo necesita hacerlo una vez por directorio.

   terraform init

   Opcionalmente, para utilizar la última versión del proveedor de Google, incluya la opción -upgrade :

   terraform init -upgrade

Aplicar los cambios

1. Revise la configuración y verifique que los recursos que Terraform va a crear o actualizar coincidan con sus expectativas:

   terraform plan

   Realice correcciones en la configuración según sea necesario.

2. Aplique la configuración de Terraform ejecutando el siguiente comando e ingresando yes en el indicador:

   terraform apply

   Espere hasta que Terraform muestre el mensaje "¡Aplicación completada!"

3. Abre tu Google Cloud proyecto para ver los resultados. En el Google Cloud consola, navegue a sus recursos en la interfaz de usuario para asegurarse de que Terraform los haya creado o actualizado.

DESCANSAR

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia
• INSTANCE_NAME : el nombre de la instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar su solicitud, expanda una de estas opciones:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  ...
  pscServiceAttachmentLink: "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_NAME"
}

El campo pscServiceAttachmentLink muestra la URI que apunta al servicio adjunto de la instancia.

nube g

1. Para reservar una dirección IP interna para el punto final de Private Service Connect, utilice el
   Comando gcloud compute addresses create :

   gcloud compute addresses create ADDRESS_NAME \
   --project=PROJECT_ID \
   --region=REGION_NAME \
   --subnet=SUBNET_NAME \
   --addresses=INTERNAL_IP_ADDRESS

   Realice las siguientes sustituciones:

   • ADDRESS_NAME : el nombre de la dirección IP interna.
   • PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto para el punto final.
   • REGION_NAME : el nombre de la región para el punto final.
   • SUBNET_NAME : el nombre de la subred para la dirección IP.
   • INTERNAL_IP_ADDRESS : La dirección IP que se reservará. Esta dirección IP debe estar dentro del rango IP principal de la subred. Puede ser una dirección RFC 1918 o una subred con rangos no RFC.

2. Para verificar que la dirección IP esté reservada, utilice el comando gcloud compute addresses list :

   gcloud compute addresses list ADDRESS_NAME \
   --project=PROJECT_ID

   En la respuesta, verifique que aparezca el estado RESERVED para la dirección IP.

3. Para crear el punto final de conexión de servicio privado y apuntarlo al adjunto del servicio Cloud SQL, utilice el comando gcloud compute forwarding-rules create :

   gcloud compute forwarding-rules create ENDPOINT_NAME \
   --address=ADDRESS_NAME \
   --project=PROJECT_ID \
   --region=REGION_NAME \
   --network=NETWORK_NAME \
   --target-service-attachment=SERVICE_ATTACHMENT_URI \
   --allow-psc-global-access

   Realice las siguientes sustituciones:

   • ENDPOINT_NAME : el nombre del punto final
   • NETWORK_NAME : el nombre de la red VPC para el punto final
   • SERVICE_ATTACHMENT_URI : el URI del archivo adjunto de servicio

4. Para verificar que el archivo adjunto del servicio acepta el punto final, utilice el
   gcloud compute forwarding-rules describe :

   gcloud compute forwarding-rules describe ENDPOINT_NAME \
   --project=PROJECT_ID \
   --region=REGION_NAME

   En la respuesta, verifique que el campo pscConnectionStatus tenga el estado " ACCEPTED ". El punto final puede conectarse al servicio adjunto.

Terraformar

Para crear un punto final de conexión de servicio privado, utilice el recurso de Terraform google_sql_database_instance .

resource "google_compute_address" "default" {
  name         = "psc-compute-address"
  region       = "us-central1"
  address_type = "INTERNAL"
  subnetwork   = "default"     # Replace value with the name of the subnet here.
  address      = "10.128.0.42" # Replace value with the IP address to reserve.
}

data "google_sql_database_instance" "default" {
  name = resource.google_sql_database_instance.default.name
}

resource "google_compute_forwarding_rule" "default" {
  name                  = "psc-forwarding-rule-${google_sql_database_instance.default.name}"
  region                = "us-central1"
  network               = "default"
  ip_address            = google_compute_address.default.self_link
  load_balancing_scheme = ""
  target                = data.google_sql_database_instance.default.psc_service_attachment_link
}

Para aplicar su configuración de Terraform en un Google Cloud proyecto, complete los pasos de las siguientes secciones.

Preparar Cloud Shell

1. Inicie Cloud Shell .

2. Establecer el valor predeterminado Google Cloud Proyecto donde desea aplicar sus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si establece valores explícitos en el archivo de configuración de Terraform.

Preparar el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz ).

1. En Cloud Shell , cree un directorio y un nuevo archivo dentro de él. El nombre del archivo debe tener la extensión .tf ; por ejemplo, main.tf En este tutorial, el archivo se denomina main.tf

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Si está siguiendo un tutorial, puede copiar el código de muestra en cada sección o paso.

   Copie el código de muestra en el main.tf recién creado.

   Opcionalmente, copie el código de GitHub. Esto se recomienda cuando el fragmento de Terraform forma parte de una solución integral.

3. Revise y modifique los parámetros de muestra para aplicarlos a su entorno.
4. Guarde sus cambios.
5. Inicialice Terraform. Solo necesita hacerlo una vez por directorio.

   terraform init

   Opcionalmente, para utilizar la última versión del proveedor de Google, incluya la opción -upgrade :

   terraform init -upgrade

Aplicar los cambios

1. Revise la configuración y verifique que los recursos que Terraform va a crear o actualizar coincidan con sus expectativas:

   terraform plan

   Realice correcciones en la configuración según sea necesario.

2. Aplique la configuración de Terraform ejecutando el siguiente comando e ingresando yes en el indicador:

   terraform apply

   Espere hasta que Terraform muestre el mensaje "¡Aplicación completada!"

3. Abre tu Google Cloud proyecto para ver los resultados. En el Google Cloud consola, navegue a sus recursos en la interfaz de usuario para asegurarse de que Terraform los haya creado o actualizado.

DESCANSAR

1. Reserve una dirección IP interna para el punto final de Private Service Connect.

2. Verifique que la dirección IP esté reservada.

   Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

   • PROJECT_ID : el ID o número de proyecto del Google Cloud Proyecto que contiene el punto final de conexión de servicio privado
   • REGION_NAME : el nombre de la región
   • ADDRESS_NAME : el nombre de la dirección IP

   Método HTTP y URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/addresses/ADDRESS_NAME

   Para enviar su solicitud, expanda una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Ejecute el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/addresses/ADDRESS_NAME"

   PowerShell (Windows)

   Ejecute el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/addresses/ADDRESS_NAME" | Select-Object -Expand Content

   Debería recibir una respuesta JSON similar a la siguiente:

   {
     "kind": "compute#address",
     "id": "ADDRESS_ID",
     "creationTimestamp": "2024-05-09T11:20:50.114-07:00",
     "name": "ADDRESS_NAME",
     "description": "This is the name of the internal IP address.",
     "address": "IP_ADDRESS",
     "status": "RESERVED",
     "region": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/addresses/ADDRESS_NAME",
     "networkTier": "PREMIUM",
     "labelFingerprint": "LABEL_FINGERPRINT_ID",
     "addressType": "EXTERNAL"
   }
   

   En la respuesta, verifique que aparezca el estado RESERVED para la dirección IP.

3. Cree el punto final de conexión de servicio privado y apúntelo al archivo adjunto del servicio Cloud SQL.

4. Verifique que el archivo adjunto del servicio acepte el punto final.

   Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

   • PROJECT_ID : el ID o número de proyecto del Google Cloud Proyecto que contiene el punto final de conexión de servicio privado
   • REGION_NAME : el nombre de la región
   • ENDPOINT_NAME : el nombre del punto final

   Método HTTP y URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME

   Para enviar su solicitud, expanda una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Ejecute el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME"

   PowerShell (Windows)

   Ejecute el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME" | Select-Object -Expand Content

   Debería recibir una respuesta JSON similar a la siguiente:

   {
     "kind": "compute#forwardingRule",
     "id": "ENDPOINT_ID",
     "creationTimestamp": "2024-05-09T12:03:21.383-07:00",
     "name": "ENDPOINT_NAME",
     "region": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME",
     "IPAddress": "IP_ADDRESS",
     "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_NAME",
     "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME",
     "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
     "serviceDirectoryRegistrations": [
       {
         "namespace": "goog-psc-default"
       }
     ],
     "networkTier": "PREMIUM",
     "labelFingerprint": "LABEL_FINGERPRINT_ID",
     "fingerprint": "FINGERPRINT_ID",
     "pscConnectionId": "CONNECTION_ID",
     "pscConnectionStatus": "ACCEPTED",
     "allowPscGlobalAccess": true
   }
   

   En la respuesta, verifique que el campo pscConnectionStatus tenga el estado " ACCEPTED ". El punto final puede conectarse al servicio adjunto.

nube g

1. Para ver información resumida sobre una instancia de Cloud SQL, incluido el nombre DNS de la instancia, utilice el comando gcloud sql instances describe :

   gcloud sql instances describe INSTANCE_NAME \
   --project=PROJECT_ID

   Realice las siguientes sustituciones:

   • INSTANCE_NAME : el nombre de la instancia de Cloud SQL
   • PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia

   En la respuesta, verifique que aparezca el nombre DNS. Este nombre tiene el siguiente patrón: INSTANCE_UID . PROJECT_DNS_LABEL . REGION_NAME .sql.goog. . Por ejemplo: 1a23b4cd5e67.1a2b345c6d27.us-central1.sql.goog.

   Si desea usar un nombre DNS personalizado para conectarse a una instancia de Cloud SQL en lugar del nombre DNS predefinido en esta sección, configure el nombre alternativo del sujeto (SAN) personalizado al crear la instancia. El nombre DNS personalizado que inserte en el SAN personalizado se añadirá al campo SAN del certificado de servidor de la instancia. Esto le permite usar el nombre DNS personalizado con la validación del nombre de host de forma segura.

   Para obtener más información sobre cómo configurar la configuración SAN personalizada, consulte Crear instancias .

2. Para crear una zona DNS privada, use el comando gcloud dns managed-zones create . Esta zona está asociada a la red de VPC que se utiliza para conectarse a la instancia de Cloud SQL a través del punto de conexión de servicio privado.

   gcloud dns managed-zones create ZONE_NAME \
   --project=PROJECT_ID \
   --description="DESCRIPTION" \
   --dns-name=DNS_NAME \
   --networks=NETWORK_NAME \
   --visibility=private

   Realice las siguientes sustituciones:

   • ZONE_NAME : el nombre de la zona DNS
   • PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la zona
   • DESCRIPTION : una descripción de la zona (por ejemplo, una zona DNS para la instancia de Cloud SQL)
   • DNS_NAME : el nombre del sufijo DNS para la zona, como REGION_NAME .sql.goog. (donde REGION_NAME es el nombre de la región de la zona)
   • NETWORK_NAME : el nombre de la red VPC

3. Después de crear el punto final de conexión de servicio privado , para crear un registro DNS en la zona, utilice el comando gcloud dns record-sets create :

   gcloud dns record-sets create DNS_RECORD \
   --project=PROJECT_ID \
   --type=RRSET_TYPE \
   --rrdatas=RR_DATA \
   --zone=ZONE_NAME

   Realice las siguientes sustituciones:

   • DNS_RECORD : el nombre del registro DNS. Este registro se establece con el nombre DNS que obtuvo de la instancia de Cloud SQL anteriormente en este procedimiento (por ejemplo, 1a23b4cd5e67.1a2b345c6d27.us-central1.sql.goog. ).
   • RRSET_TYPE : el tipo de registro de recurso del conjunto de registros DNS (por ejemplo, A ).
   • RR_DATA : la dirección IP asignada al punto final de Conexión de Servicio Privado (por ejemplo, 198.51.100.5 ). También puede introducir varios valores, como rrdata1 rrdata2 rrdata3 (por ejemplo, 10.1.2.3 10.2.3.4 10.3.4.5 ).

DESCANSAR

1. Obtenga el nombre DNS de una instancia de Cloud SQL.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia
• INSTANCE_NAME : el nombre de la instancia

Método HTTP y URL:

GET https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecute el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Ejecute el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  ...
  "dnsName": "INSTANCE_ID.PROJECT_DNS_LABEL.REGION_NAME.sql.goog."
}

El campo dnsName muestra el nombre DNS de la instancia de Cloud SQL. Los nombres DNS siempre terminan con un punto ( . ).

2. Cree una zona DNS privada. Esta zona está asociada a la red de VPC que se utiliza para conectarse a la instancia de Cloud SQL a través del punto de conexión de servicio privado.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la zona DNS
• ZONE_NAME : el nombre de la zona
• DESCRIPTION : una descripción de la zona (por ejemplo, una zona DNS para la instancia de Cloud SQL)
• DNS_NAME : el nombre del sufijo DNS para la zona, como REGION_NAME .sql.goog. (donde REGION_NAME es el nombre de la región de la zona)
• NETWORK_NAME : el nombre de la red VPC

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "name": "ZONE_NAME",
  "description": "DESCRIPTION",
  "dnsName": "DNS_NAME",
  "visibility": "private",
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME"
      }
    ]
  }
}

Para enviar su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones"

PowerShell (Windows)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "name": "ZONE_NAME",
  "dnsName": "DNS_NAME",
  "description": "DESCRIPTION",
  "id": "ID",
  "nameServers": [
    "ns-gcp-private.googledomains.com."
  ],
  "creationTime": "2024-05-10T17:05:34.607Z",
  "visibility": "private",
  "privateVisibilityConfig": {
    "networks": [
      {
        "networkUrl": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME",
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork"
      }
    ],
    "gkeClusters": [],
    "kind": "dns#managedZonePrivateVisibilityConfig"
  },
  "cloudLoggingConfig": {
    "kind": "dns#managedZoneCloudLoggingConfig"
  },
  "kind": "dns#managedZone"
}

3. Después de crear el punto final de Conexión de servicio privado , cree un registro DNS en la zona.

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la zona DNS.
• ZONE_NAME : el nombre de la zona.
• DNS_RECORD : el nombre del registro DNS. Este registro se establece con el nombre DNS que obtuvo de la instancia de Cloud SQL anteriormente en este procedimiento (por ejemplo, 1a23b4cd5e67.1a2b345c6d27.us-central1.sql.goog. ).
• RRSET_TYPE : el tipo del conjunto de registros (por ejemplo, A ).
• TTL : el tiempo de vida (TTL) para el conjunto de registros en número de segundos (por ejemplo, 300 ).
• RR_DATA : la dirección IP asignada al punto final de Conexión de Servicio Privado (por ejemplo, 198.51.100.5 ). También puede introducir varios valores, como rrdata1 rrdata2 rrdata3 (por ejemplo, 10.1.2.3 10.2.3.4 10.3.4.5 ).

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "deletions": []
  "additions": [
    {
      "name": "DNS_RECORD",
      "type": "RRSET_TYPE",
      "ttl": TTL,
      "rrdatas": [
        "RR_DATA"
      ]
    }
  ]
}

Para enviar su solicitud, expanda una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/ZONE_NAME"

PowerShell (Windows)

Guarde el cuerpo de la solicitud en un archivo llamado request.json y ejecute el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/ZONE_NAME" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "additions": [
    {
      "name": "DNS_RECORD",
      "type": "RRSET_TYPE",
      "ttl": TTL,
      "rrdatas": [
        "RR_DATA"
      ],
      "signatureRrdatas": [],
      "kind": "dns#resourceRecordSet"
    }
  ],
  "deletions": [],
  "startTime": "2024-05-10T17:29:44.375Z",
  "id": "CHANGE_ID",
  "status": "pending",
  "kind": "dns#change"
}

nube g

Para crear una prueba de conectividad para una instancia de Cloud SQL con Private Service Connect habilitado, use el comando gcloud network-management connectivity-tests create :

gcloud network-management connectivity-tests create CONNECTIVITY_TEST_NAME \
--source-instance=SOURCE_INSTANCE \
--destination-cloud-sql-instance=DESTINATION_CLOUD_SQL_INSTANCE \
--destination-network=DESTINATION_NETWORK \
--destination-port=DESTINATION_PORT \
--protocol=tcp

Realice las siguientes sustituciones:

• CONNECTIVITY_TEST_NAME : el nombre de la prueba de conectividad.
• SOURCE_INSTANCE : la URI de la instancia de Compute Engine donde se encuentra la dirección IP de origen (por ejemplo, projects/myproject/zones/myzone/instances/myinstance ).
• DESTINATION_CLOUD_SQL_INSTANCE : la URL de la instancia de Cloud SQL (por ejemplo, projects/myproject/instances/myinstance ).
• DESTINATION_NETWORK : la URI de la red VPC donde se encuentra la dirección IP de destino (por ejemplo, projects/myproject/global/networks/mynetwork ).
• DESTINATION_PORT : el número de puerto reservado para la instancia. Para la nube SQL para instancias PostgreSQL, el número de puerto es 5432 .

DESCANSAR

Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

• PROJECT_ID : el ID o número de proyecto del Google Cloud proyecto que contiene la instancia.
• CONNECTIVITY_TEST_NAME : el nombre de la prueba de conectividad.
• SOURCE_IP_ADDRESS : la dirección IP de la instancia de motor de computa de origen.
• SOURCE_INSTANCE : el URI para la instancia del motor de cómputo donde se encuentra la dirección IP de origen (por ejemplo, projects/myproject/zones/myzone/instances/myinstance ).
• SOURCE_NETWORK : el URI para la red VPC donde se encuentra la dirección IP de origen (por ejemplo, projects/myproject/global/networks/mynetwork ).
• DESTINATION_IP_ADDRESS : la dirección IP de la instancia SQL de Destination Cloud.
• DESTINATION_PORT : el número de puerto reservado para la instancia. Para la nube SQL para instancias PostgreSQL, el número de puerto es 5432 .
• DESTINATION_NETWORK : el URI para la red VPC donde se encuentra la dirección IP de destino (por ejemplo, projects/myproject/global/networks/mynetwork ).

Método HTTP y URL:

POST https://networkmanagement.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/connectivityTests?testId=CONNECTIVITY_TEST_NAME

Cuerpo JSON de la solicitud:

{
  "source": {
    "ipAddress": "SOURCE_IP_ADDRESS",
    "instance": "SOURCE_INSTANCE",
    "network": "SOURCE_NETWORK"
  },
  "destination": {
    "ipAddress": "DESTINATION_IP_ADDRESS",
    "port": DESTINATION_PORT,
    "network": "DESTINATION_NETWORK",
    "projectId": "PROJECT_ID"
  },
  "protocol": "TCP"
}

Para enviar su solicitud, expanda una de estas opciones:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://networkmanagement.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/connectivityTests?testId=CONNECTIVITY_TEST_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://networkmanagement.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/connectivityTests?testId=CONNECTIVITY_TEST_NAME" | Select-Object -Expand Content

Debería recibir una respuesta JSON similar a la siguiente:

{
  "name": "projects/PROJECT_ID/locations/global/operations/operation-OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.networkmanagement.v1.OperationMetadata",
    "createTime": "2024-05-23T16:43:49.313981473Z",
    "target": "projects/PROJECT_ID/locations/global/connectivityTests/CONNECTIVITY_TEST_NAME",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}