Se usó la API de Cloud Translation para traducir esta página.

Configura el acceso privado a los servicios y Private Service Connect

En esta página, se describe cómo configurar el acceso privado a servicios y Private Service Connect.

Si configuras el acceso a servicios privados, puedes asignar un rango de direcciones IP y crear una conexión de servicio privada para la red de nube privada virtual (VPC) en tu proyecto de Google Cloud. Esto permite que los recursos de la red de VPC se conecten a tus instancias de Cloud SQL.

Si configuras Private Service Connect, puedes conectarte a una instancia principal de Cloud SQL o a cualquiera de sus réplicas de lectura desde varias redes de VPC que pertenezcan a organizaciones, grupos, equipos o proyectos diferentes.

Crea una instancia que admita el acceso a servicios privados y Private Service Connect

Si creas una instancia de Cloud SQL que admita el acceso a servicios privados y Private Service Connect, obtendrás los beneficios de ambos servicios. Para obtener más información, consulta Opciones de conexión para instancias.

Con Private Service Connect, puedes conectarte a una instancia de Cloud SQL desde varias redes de VPC que pertenezcan a organizaciones, grupos, equipos o proyectos diferentes.

Puedes crear una instancia de Cloud SQL que admita el acceso a servicios privados y Private Service Connect con gcloud CLI o la API.

gcloud

Para crear una instancia que admita el acceso a servicios privados y Private Service Connect, usa el comando gcloud beta sql instances create:

gcloud beta 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 \
--allocated-ip-range-name=RANGE_NAME \
--database-version=DATABASE_VERSION \
--cpu=NUMBER_OF_vCPUs \
--memory=MEMORY_SIZE \
--root-password=ROOT_PASSWORD \
--network=VPC_NETWORK_NAME \
--psc-auto-connections=network=VPC_NETWORK_PATH,project=SERVICE_PROJECT

Realiza los siguientes reemplazos:

INSTANCE_NAME: El nombre de la instancia.
PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
REGION_NAME: el nombre de la región para la instancia.
ALLOWED_PROJECTS: Una lista de IDs o números de proyectos permitidos, separados por comas. Si un proyecto no aparece en esta lista, no puedes crear extremos de Private Service Connect en el proyecto para conectarte a la instancia.
AVAILABILITY_TYPE: Habilita la alta disponibilidad en la instancia. Para este parámetro, especifica uno de los siguientes valores:
- REGIONAL: habilita la alta disponibilidad y se recomienda para las instancias de producción. La instancia se conmuta por error a otra zona dentro de la región que seleccionaste.
- ZONAL: no proporciona capacidad de conmutación por error. Este es el valor predeterminado.
Para obtener más información sobre cómo configurar y quitar la alta disponibilidad de las instancias, consulta las secciones Configura una instancia existente para alta disponibilidad y Desactiva la alta disponibilidad para una instancia.
RANGE_NAME: Para este parámetro opcional, establece un nombre de rango para el que se asigna un rango de IP. El nombre del rango debe cumplir con RFC 1035 y contener de 1 a 63 caracteres.
DATABASE_VERSION: la versión de la base de datos para la instancia (por ejemplo, SQLSERVER_2019_STANDARD).
NUMBER_OF_vCPUs: la cantidad de núcleos para la instancia.
MEMORY_SIZE: la cantidad de memoria para la instancia.
ROOT_PASSWORD: la contraseña del usuario root de Cloud SQL.
VPC_NETWORK_NAME: El nombre y la ruta de acceso de la red de VPC a la que se conecta la instancia (por ejemplo, "projects/PROJECT_ID/global/networks/default").
VPC_NETWORK_PATH: Es la ruta de acceso a la red de VPC desde la que se debe crear el extremo de Private Service Connect. Por ejemplo:
projects/my-host-project/global/networks/default.
SERVICE_PROJECT: El proyecto en el que se crea el extremo de Private Service Connect. Si la red de VPC no es una VPC compartida, este solo puede ser el proyecto host de la red. Si se trata de una VPC compartida, puede ser el proyecto host o el proyecto de servicio.

Los proyectos que especifiques en los parámetros de conexión automática se agregarán a los proyectos permitidos automáticamente.

Nota: Si deseas que Cloud SQL creé el extremo de Private Service Connect automáticamente, debes usar la línea de código psc-auto-connections. De lo contrario, no la necesitas. Además, antes de crear tu instancia, debes crear una política de conexión de servicio.

Para obtener información sobre cómo conectarte a una instancia que tiene habilitado Private Service Connect, consulta Cómo conectarse a una instancia de Cloud SQL.

Para desactivar la IP pública, usa el parámetro --no-assign-ip.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
INSTANCE_NAME: El nombre de la instancia.
REGION_NAME: el nombre de la región para la instancia.
ROOT_PASSWORD: la contraseña del usuario root de Cloud SQL.
AVAILABILITY_TYPE: Habilita la alta disponibilidad en la instancia. Para este parámetro, especifica uno de los siguientes valores:
- REGIONAL: habilita la alta disponibilidad y se recomienda para las instancias de producción. La instancia se conmuta por error a otra zona dentro de la región que seleccionaste.
- ZONAL: no proporciona capacidad de conmutación por error. Este es el valor predeterminado.
Para obtener más información sobre cómo configurar y quitar la alta disponibilidad de las instancias, consulta las secciones Configura una instancia existente para alta disponibilidad y Desactiva la alta disponibilidad para una instancia.
VPC_NETWORK_NAME: El nombre y la ruta de acceso de la red de VPC a la que se conecta la instancia (por ejemplo, "projects/PROJECT_ID/global/networks/default").
RANGE_NAME: Para este parámetro opcional, establece un nombre de rango para el que se asigna un rango de IP. El nombre del rango debe cumplir con RFC 1035 y contener de 1 a 63 caracteres.
ALLOWED_PROJECTS: Una lista de IDs o números de proyectos permitidos, separados por comas. Si un proyecto no aparece en esta lista, no puedes crear extremos de Private Service Connect en el proyecto para conectarte a la instancia.
VPC_NETWORK_PATH: Es la ruta de acceso a la red de VPC desde la que se debe crear el extremo de Private Service Connect. Por ejemplo:
projects/my-host-project/global/networks/default.
SERVICE_PROJECT: El proyecto en el que se crea el extremo de Private Service Connect. Si la red de VPC no es una VPC compartida, este solo puede ser el proyecto host de la red. Si se trata de una VPC compartida, puede ser el proyecto host o el proyecto de servicio.

Los proyectos que especifiques en los parámetros de conexión automática se agregarán a los proyectos permitidos automáticamente.

Nota: Si deseas que Cloud SQL creé el extremo de Private Service Connect automáticamente, debes usar la sección de código pscAutoConnections. De lo contrario, no la necesitas. Además, antes de crear tu instancia, debes crear una política de conexión de servicio.

MACHINE_TYPE: un valor de string enumerado que representa el tipo de máquina para la instancia. Por ejemplo: db-custom-NUMBER_OF_vCPUs-MEMORY_SIZE, en el que NUMBER_OF_vCPUs y MEMORY_SIZE son la cantidad de núcleos y de memoria que deseas para la instancia.

Para obtener información sobre cómo conectarte a una instancia que tiene habilitado Private Service Connect, consulta Cómo conectarse a una instancia de Cloud SQL.

Estableces el parámetro ipv4Enabled en false porque tu instancia tiene una dirección IP interna.

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": "SQLSERVER_2019_STANDARD",
  "rootPassword": "ROOT_PASSWORD",
  "kind": "sql#instance",
  "settings": {
    "availabilityType": "AVAILABILITY_TYPE",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": VPC_NETWORK_NAME,
      "allocatedIpRange": "RANGE_NAME",
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscAutoConnections": [
          {
            "consumerProject":"SERVICE_PROJECT",
            "consumerNetwork":"projects/SERVICE_PROJECT/global/networks/VPC_NETWORK_PATH"
          }
        ],
        "pscEnabled": true
      }
    },
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "tier": "MACHINE_TYPE"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "RUNNING",
  "user": "user@example.com",
  "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"
}

Cómo desactivar Private Service Connect para una instancia

Puedes desactivar Private Service Connect en una instancia que tenga habilitado el acceso privado a servicios y Private Service Connect. Por motivos de seguridad, es posible que no quieras conectarte a la instancia desde varias redes de VPC que pertenezcan a organizaciones, grupos, equipos o proyectos diferentes.

Puedes desactivar Private Service Connect para una instancia con gcloud CLI o la API.

gcloud

Para desactivar Private Service Connect en una instancia, usa el comando gcloud beta sql instances patch:

gcloud beta sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--no-enable-private-service-connect \
--clear-allowed-psc-projects

Realiza los siguientes reemplazos:

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

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "pscEnabled": "false",
        "allowedConsumerProjects": [{}]
      }
    },
    "kind": "sql#settings"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

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

curl -X PATCH \
     -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/INSTANCE_NAME"

PowerShell (Windows)

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

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Habilita Private Service Connect para una instancia

Puedes habilitar Private Service Connect para una instancia que ya tenga habilitado el acceso privado a servicios. Puedes usar Private Service Connect para conectarte a una instancia de Cloud SQL desde varias redes de VPC.

Puedes habilitar Private Service Connect para una instancia con gcloud CLI o la API.

gcloud

Para habilitar Private Service Connect para una instancia, usa el comando gcloud beta sql instances patch:

gcloud beta sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--enable-private-service-connect \
--allowed-psc-projects=ALLOWED_PROJECTS \
--psc-auto-connections=network=VPC_NETWORK_PATH,project=SERVICE_PROJECT

Realiza los siguientes reemplazos:

INSTANCE_NAME: Es el nombre de la instancia.
PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
ALLOWED_PROJECTS: Una lista de IDs o números de proyectos permitidos, separados por comas. Si un proyecto no aparece en esta lista, no puedes crear extremos de Private Service Connect en el proyecto para conectarte a la instancia.
VPC_NETWORK_PATH: Es la ruta de acceso a la red de VPC desde la que se crea el extremo de Private Service Connect. Por ejemplo:
projects/my-host-project/global/networks/default.
SERVICE_PROJECT: El proyecto en el que se crea el extremo de Private Service Connect. Si la red de VPC no es una VPC compartida, este solo puede ser el proyecto host de la red. Si se trata de una VPC compartida, puede ser el proyecto host o el proyecto de servicio.

Los proyectos que especifiques en los parámetros de conexión automática se agregarán a los proyectos permitidos automáticamente.

Nota: Si Cloud SQL creó el extremo de Private Service Connect automáticamente, debes usar la línea de código psc-auto-connections. De lo contrario, no es necesario.

Para obtener información sobre cómo conectarte a una instancia que tiene habilitado Private Service Connect, consulta Cómo conectarse a una instancia de Cloud SQL.

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
INSTANCE_NAME: El nombre de la instancia.
ALLOWED_PROJECTS: Una lista de IDs o números de proyectos permitidos, separados por comas. Estos proyectos anulan proyectos que ya están configurados para usar Private Service Connect. Si un proyecto no aparece en esta lista, no puedes crear extremos de Private Service Connect en el proyecto para conectarte a la instancia.
VPC_NETWORK_PATH: Es la ruta de acceso a la red de VPC desde la que se crea el extremo de Private Service Connect. Por ejemplo:
projects/my-host-project/global/networks/default.
SERVICE_PROJECT: El proyecto en el que se crea el extremo de Private Service Connect. Si la red de VPC no es una VPC compartida, este solo puede ser el proyecto host de la red. Si se trata de una VPC compartida, puede ser el proyecto host o el proyecto de servicio.

Los proyectos que especifiques en los parámetros de conexión automática se agregarán a los proyectos permitidos automáticamente.

Nota: Si Cloud SQL creó el extremo de Private Service Connect automáticamente, debes usar la sección de código pscAutoConnections. De lo contrario, no es necesario.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "pscAutoConnections": [
          {
            "consumerProject":"SERVICE_PROJECT",
            "consumerNetwork":"projects/SERVICE_PROJECT/global/networks/VPC_NETWORK_PATH"
          }
        ],
        "pscEnabled": "true",
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

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

curl -X PATCH \
     -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/INSTANCE_NAME"

PowerShell (Windows)

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

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

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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

Para obtener información sobre cómo conectarte a una instancia que tiene habilitado Private Service Connect, consulta Cómo conectarse a una instancia de Cloud SQL.