Ver información de la instancia

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 Instancias de Cloud SQL .

   Ir a Instancias de Cloud SQL

   La siguiente información aparece sobre las instancias de Cloud SQL que tienen habilitada la Conexión de servicio privado :

   • Método de conexión interna: si se utiliza Conexión de servicio privado o acceso a servicios privados para conectarse a la instancia
   • Dirección IP privada: las direcciones IP de los puntos finales de conexión de servicio privado en la red VPC que se conectan al adjunto de servicio de la instancia
   • Nombre DNS: el nombre DNS de la instancia

2. Para ver el estado actual de la instancia, mantenga el puntero sobre el ícono de estado junto al nombre de una instancia.

   Si la instancia está en un estado FAILED o MAINTENANCE , puede recuperarla seleccionando un momento del pasado y restaurándola a su estado en ese momento.

3. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.

   En la tarjeta Conectarse a esta instancia , aparece la siguiente información adicional sobre las instancias de Cloud SQL con Conexión de servicio privado habilitada:

   • Conectividad IP privada: el estado es Habilitado porque la instancia debe tener una dirección IP interna
   • Proyectos permitidos: estos proyectos permiten conexiones desde puntos finales de Private Service Connect a la instancia
   • Adjunto de servicio: el adjunto de servicio de la instancia
   • Conectividad de IP pública: el estado está Deshabilitado porque no se admiten conexiones de IP externas

4. Para ver información de conectividad sobre la instancia, incluso si se agregó una dirección IP interna o externa a la instancia, cualquier red autorizada asociada con la instancia y si otras Google Cloud Los servicios, como BigQuery, pueden acceder a los datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión interna; haga clic en la pestaña Conexiones .

   Para obtener más información sobre esta pestaña, consulte Acerca de las opciones de conexión .

5. Haga clic en la pestaña Redes . Aparecerá la siguiente información sobre las instancias que tienen habilitada la Conexión de Servicio Privado:

   • La casilla "IP privada" está seleccionada, pero desactivada. La instancia debe tener una dirección IP interna y esta configuración no se puede modificar.
   • Los proyectos permitidos para la instancia.
   • La casilla de verificación IP pública está seleccionada, pero desactivada.
   • El campo Redes autorizadas está desactivado porque la instancia utiliza Conexión de servicio privado, que no admite esta función.

nube g

Para obtener información sobre la instalación y los primeros pasos con la CLI de gcloud, consulte Instalar la CLI de gcloud . Para obtener información sobre cómo iniciar Cloud Shell, consulte Usar Cloud Shell .

1. Para ver información resumida sobre una 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. 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.

   A continuación se muestra un ejemplo del resultado al ejecutar este comando:

   gcloud sql instances describe myinstance \
   --project=12345
   ...
   dnsName: mydnsname
   ...
   pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment
   ...
    settings:
     ...
     ipConfiguration:
     ipv4Enabled: false
     pscConfig:
       allowedConsumerProjects:
         - projects/23456
         - projects/34567
       pscEnabled: true

2. Para ver información más detallada sobre las instancias que tienen habilitada la Conexión de servicio privado, agregue los siguientes parámetros:

Configuración	Parámetro	Notas
Nombre DNS	dnsName	El nombre DNS de la instancia. Recomendamos crear un registro DNS con este nombre y apuntarlo a la dirección IP del punto final de Private Service Connect. También recomendamos usar este nombre para conectarse a la instancia.
Adjunto de servicio	pscServiceAttachmentLink	El URI que apunta a la conexión de servicio de la instancia. Use este URI para crear el punto de conexión de servicio privado.
Proyectos de consumidores permitidos	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.
Habilitación de la conexión de servicio privado	pscEnabled	Si una instancia tiene habilitada la Conexión de servicio privado.

Terraformar

Para crear una instancia, utilice un recurso Terraform .

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Aplicar los cambios

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.

Eliminar los cambios

Para eliminar sus cambios, haga lo siguiente:

1. Para deshabilitar la protección contra eliminación, en el archivo de configuración de Terraform configure el argumento deletion_protection en false .

   deletion_protection =  "false"

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

   terraform apply

3. Elimine los recursos aplicados previamente con su configuración de Terraform ejecutando el siguiente comando e ingresando yes en el mensaje:

   terraform destroy

REST versión 1

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"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

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.
• pscEnabled : si una instancia tiene habilitada la Conexión de servicio privado.
• pscServiceAttachmentLink : el URI que apunta al servicio adjunto de la instancia. Use este URI para crear el punto de conexión de servicio privado.
• dnsName : el nombre DNS de la instancia. Recomendamos crear un registro DNS con este nombre y apuntarlo a la dirección IP del punto final de Private Service Connect. También recomendamos usar este nombre para conectarse a la instancia.

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

REST v1beta4

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/sql/v1beta4/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/v1beta4/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/v1beta4/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"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

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.
• pscEnabled : si una instancia tiene habilitada la Conexión de servicio privado.
• pscServiceAttachmentLink : el URI que apunta al servicio adjunto de la instancia. Use este URI para crear el punto de conexión de servicio privado.
• dnsName : el nombre DNS de la instancia. Recomendamos crear un registro DNS con este nombre y apuntarlo a la dirección IP del punto final de Private Service Connect. También recomendamos usar este nombre para conectarse a la instancia.

Consola

1. En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .

   Ir a Instancias de Cloud SQL

   La siguiente información aparece sobre las instancias de Cloud SQL que tienen habilitada la Conexión de servicio privado :

   • Método de conexión interna: si se utiliza Conexión de servicio privado o acceso a servicios privados para conectarse a la instancia
   • Dirección IP privada: las direcciones IP de los puntos finales de conexión de servicio privado en la red VPC que se conectan al adjunto de servicio de la instancia
   • Nombre DNS: el nombre DNS de la instancia

2. Para ver el estado actual de la instancia, mantenga el puntero sobre el ícono de estado junto al nombre de una instancia.

   Si la instancia está en un estado FAILED o MAINTENANCE , puede recuperarla seleccionando un momento del pasado y restaurándola a su estado en ese momento.

3. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.

   En la tarjeta Conectarse a esta instancia , aparece la siguiente información adicional sobre las instancias de Cloud SQL con Conexión de servicio privado habilitada:

   • Conectividad IP privada: el estado es Habilitado porque la instancia debe tener una dirección IP interna
   • Proyectos permitidos: estos proyectos permiten conexiones desde puntos finales de Private Service Connect a la instancia
   • Adjunto de servicio: el adjunto de servicio de la instancia
   • Conectividad de IP pública: el estado está Deshabilitado porque no se admiten conexiones de IP externas

4. Para ver información de conectividad sobre la instancia, incluso si se agregó una dirección IP interna o externa a la instancia, cualquier red autorizada asociada con la instancia y si otras Google Cloud Los servicios, como BigQuery, pueden acceder a los datos en Cloud SQL y realizar consultas sobre estos datos a través de una conexión interna; haga clic en la pestaña Conexiones .

   Para obtener más información sobre esta pestaña, consulte Acerca de las opciones de conexión .

5. Haga clic en la pestaña Redes . Aparecerá la siguiente información sobre las instancias que tienen habilitada la Conexión de Servicio Privado:

   • La casilla "IP privada" está seleccionada, pero desactivada. La instancia debe tener una dirección IP interna y esta configuración no se puede modificar.
   • Los proyectos permitidos para la instancia.
   • La casilla de verificación IP pública está seleccionada, pero desactivada.
   • El campo Redes autorizadas está desactivado porque la instancia utiliza Conexión de servicio privado, que no admite esta función.

nube g

Para obtener información sobre la instalación y los primeros pasos con la CLI de gcloud, consulte Instalar la CLI de gcloud . Para obtener información sobre cómo iniciar Cloud Shell, consulte Usar Cloud Shell .

1. Para ver información resumida sobre una 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. 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.

   A continuación se muestra un ejemplo del resultado al ejecutar este comando:

   gcloud sql instances describe myinstance \
   --project=12345
   ...
   dnsName: mydnsname
   ...
   pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment
   ...
    settings:
     ...
     ipConfiguration:
     ipv4Enabled: false
     pscConfig:
       allowedConsumerProjects:
         - projects/23456
         - projects/34567
       pscEnabled: true

2. Para ver información más detallada sobre las instancias que tienen habilitada la Conexión de servicio privado, agregue los siguientes parámetros:

Configuración	Parámetro	Notas
Nombre DNS	dnsName	El nombre DNS de la instancia. Recomendamos crear un registro DNS con este nombre y apuntarlo a la dirección IP del punto final de Private Service Connect. También recomendamos usar este nombre para conectarse a la instancia.
Adjunto de servicio	pscServiceAttachmentLink	El URI que apunta a la conexión de servicio de la instancia. Use este URI para crear el punto de conexión de servicio privado.
Proyectos de consumidores permitidos	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.
Habilitación de la conexión de servicio privado	pscEnabled	Si una instancia tiene habilitada la Conexión de servicio privado.

Terraformar

Para crear una instancia, utilice un recurso Terraform .

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Aplicar los cambios

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.

Eliminar los cambios

Para eliminar sus cambios, haga lo siguiente:

1. Para deshabilitar la protección contra eliminación, en el archivo de configuración de Terraform configure el argumento deletion_protection en false .

   deletion_protection =  "false"

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

   terraform apply

3. Elimine los recursos aplicados previamente con su configuración de Terraform ejecutando el siguiente comando e ingresando yes en el mensaje:

   terraform destroy

REST versión 1

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"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

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.
• pscEnabled : si una instancia tiene habilitada la Conexión de servicio privado.
• pscServiceAttachmentLink : el URI que apunta al servicio adjunto de la instancia. Use este URI para crear el punto de conexión de servicio privado.
• dnsName : el nombre DNS de la instancia. Recomendamos crear un registro DNS con este nombre y apuntarlo a la dirección IP del punto final de Private Service Connect. También recomendamos usar este nombre para conectarse a la instancia.

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

REST v1beta4

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/sql/v1beta4/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/v1beta4/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/v1beta4/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"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

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.
• pscEnabled : si una instancia tiene habilitada la Conexión de servicio privado.
• pscServiceAttachmentLink : el URI que apunta al servicio adjunto de la instancia. Use este URI para crear el punto de conexión de servicio privado.
• dnsName : el nombre DNS de la instancia. Recomendamos crear un registro DNS con este nombre y apuntarlo a la dirección IP del punto final de Private Service Connect. También recomendamos usar este nombre para conectarse a la instancia.