Ver informações da instância

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

   As seguintes informações são exibidas sobre instâncias do Cloud SQL que têm o Private Service Connect habilitado:

   • Método de conexão interna: se o Private Service Connect ou o acesso a serviços privados é usado para conectar-se à instância
   • Endereço IP privado: os endereços IP dos pontos de extremidade do Private Service Connect na rede VPC que se conectam ao anexo de serviço da instância
   • Nome DNS: o nome DNS da instância

2. Para ver o estado atual da instância, mantenha o ponteiro do mouse sobre o ícone de status ao lado do nome da instância.

   Se a instância estiver em um estado FAILED ou MAINTENANCE , você poderá recuperá-la selecionando um momento do passado e restaurando a instância ao seu estado naquele momento.

3. Para abrir a página Visão geral de uma instância, clique no nome da instância.

   No cartão Conectar a esta instância , as seguintes informações adicionais aparecem sobre instâncias do Cloud SQL com o Private Service Connect habilitado:

   • Conectividade IP privada: o status é Habilitado porque a instância deve ter um endereço IP interno
   • Projetos permitidos: esses projetos permitem conexões de pontos de extremidade do Private Service Connect à instância
   • Anexo de serviço: o anexo de serviço da instância
   • Conectividade IP pública: o status é Desativado porque as conexões IP externas não são suportadas

4. Para ver informações de conectividade sobre a instância, incluindo se um endereço IP interno ou externo foi adicionado à instância, quaisquer redes autorizadas associadas à instância e se outras Google Cloud serviços, como o BigQuery, podem acessar dados no Cloud SQL e fazer consultas nesses dados por meio de uma conexão interna, clique na guia Conexões .

   Para obter mais informações sobre esta guia, consulte Sobre as opções de conexão .

5. Clique na aba Rede . As seguintes informações são exibidas sobre instâncias que têm o Private Service Connect habilitado:

   • A caixa de seleção IP privado está marcada, mas desativada. A instância deve ter um endereço IP interno, e essa configuração não pode ser alterada.
   • Os projetos permitidos para a instância.
   • A caixa de seleção IP público está selecionada, mas desativada.
   • O campo Redes autorizadas está desativado porque a instância usa o Private Service Connect, que não oferece suporte a esse recurso.

gcloud

Para obter informações sobre como instalar e começar a usar a CLI do gcloud, consulte Instalar a CLI do gcloud . Para obter informações sobre como iniciar o Cloud Shell, consulte Usar o Cloud Shell .

1. Para visualizar informações resumidas sobre uma instância, use o comando gcloud sql instances describe :

   gcloud sql instances describe INSTANCE_NAME \
   --project=PROJECT_ID

   Faça as seguintes substituições:

   • INSTANCE_NAME : o nome da instância do Cloud SQL. Se o Private Service Connect estiver habilitado para essa instância, os endpoints do Private Service Connect em redes VPC poderão se conectar a ela.
   • PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância.

   Aqui está um exemplo da saída para executar 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 visualizar informações mais detalhadas sobre instâncias que têm o Private Service Connect habilitado, adicione os seguintes parâmetros:

Contexto	Parâmetro	Notas
Nome DNS	dnsName	O nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e o aponte para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.
Anexo de serviço	pscServiceAttachmentLink	O URI que aponta para o anexo de serviço da instância. Use este URI para criar o endpoint do Private Service Connect.
Projetos de consumo permitidos	allowedConsumerProjects	Uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect a partir de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
Habilitando o Private Service Connect	pscEnabled	Se uma instância tem o Private Service Connect habilitado para ela.

Terraform

Para criar uma instância, use um recurso do 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 as alterações

Para aplicar sua configuração do Terraform em um Google Cloud projeto, conclua as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell .

2. Defina o padrão Google Cloud projeto onde você deseja aplicar suas configurações do Terraform.

   Você só precisa executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variáveis ​​de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform deve ter seu próprio diretório (também chamado de módulo raiz ).

1. No Cloud Shell , crie um diretório e um novo arquivo dentro dele. O nome do arquivo deve ter a extensão .tf — por exemplo, main.tf Neste tutorial, o arquivo será chamado de main.tf

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

2. Se estiver seguindo um tutorial, você pode copiar o código de exemplo em cada seção ou etapa.

   Copie o código de exemplo no main.tf recém-criado.

   Opcionalmente, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução completa.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve suas alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade :

   terraform init -upgrade

Aplicar as alterações

1. Revise a configuração e verifique se os recursos que o Terraform irá criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça correções na configuração conforme necessário.

2. Aplique a configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Aplicação concluída!".

3. Abra seu Google Cloud projeto para visualizar os resultados. No Google Cloud console, navegue até seus recursos na interface do usuário para garantir que o Terraform os criou ou atualizou.

Excluir as alterações

Para excluir suas alterações, faça o seguinte:

1. Para desabilitar a proteção contra exclusão, no seu arquivo de configuração do Terraform defina o argumento deletion_protection como false .

   deletion_protection =  "false"

2. Aplique a configuração atualizada do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

3. Remova os recursos aplicados anteriormente com sua configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform destroy

REST v1

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância.
• INSTANCE_NAME : o nome da instância do Cloud SQL. Se o Private Service Connect estiver habilitado para essa instância, os endpoints do Private Service Connect em redes VPC poderão se conectar a ela.

Método HTTP e URL:

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

Para enviar sua solicitação, expanda uma destas opções:

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

Você deve receber uma resposta JSON semelhante à seguinte:

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

Os seguintes campos existem para instâncias que têm o Private Service Connect habilitado para elas:

• allowedConsumerProjects : uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect a partir de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
• pscEnabled : se uma instância tem o Private Service Connect habilitado para ela.
• pscServiceAttachmentLink : o URI que aponta para o anexo de serviço da instância. Use este URI para criar o endpoint do Private Service Connect.
• dnsName : o nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e o aponte para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.

Para ver como construir a solicitação da API REST subjacente para esta tarefa, consulte a página instances:get .

REST v1beta4

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância.
• INSTANCE_NAME : o nome da instância do Cloud SQL. Se o Private Service Connect estiver habilitado para essa instância, os endpoints do Private Service Connect em redes VPC poderão se conectar a ela.

Método HTTP e URL:

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

Para enviar sua solicitação, expanda uma destas opções:

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

Você deve receber uma resposta JSON semelhante à seguinte:

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

Os seguintes campos existem para instâncias que têm o Private Service Connect habilitado para elas:

• allowedConsumerProjects : uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect a partir de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
• pscEnabled : se uma instância tem o Private Service Connect habilitado para ela.
• pscServiceAttachmentLink : o URI que aponta para o anexo de serviço da instância. Use este URI para criar o endpoint do Private Service Connect.
• dnsName : o nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e o aponte para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.

Console

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

   As seguintes informações são exibidas sobre instâncias do Cloud SQL que têm o Private Service Connect habilitado:

   • Método de conexão interna: se o Private Service Connect ou o acesso a serviços privados é usado para conectar-se à instância
   • Endereço IP privado: os endereços IP dos pontos de extremidade do Private Service Connect na rede VPC que se conectam ao anexo de serviço da instância
   • Nome DNS: o nome DNS da instância

2. Para ver o estado atual da instância, mantenha o ponteiro do mouse sobre o ícone de status ao lado do nome da instância.

   Se a instância estiver em um estado FAILED ou MAINTENANCE , você poderá recuperá-la selecionando um momento do passado e restaurando a instância ao seu estado naquele momento.

3. Para abrir a página Visão geral de uma instância, clique no nome da instância.

   No cartão Conectar a esta instância , as seguintes informações adicionais aparecem sobre instâncias do Cloud SQL com o Private Service Connect habilitado:

   • Conectividade IP privada: o status é Habilitado porque a instância deve ter um endereço IP interno
   • Projetos permitidos: esses projetos permitem conexões de pontos de extremidade do Private Service Connect à instância
   • Anexo de serviço: o anexo de serviço da instância
   • Conectividade IP pública: o status é Desativado porque as conexões IP externas não são suportadas

4. Para ver informações de conectividade sobre a instância, incluindo se um endereço IP interno ou externo foi adicionado à instância, quaisquer redes autorizadas associadas à instância e se outras Google Cloud serviços, como o BigQuery, podem acessar dados no Cloud SQL e fazer consultas nesses dados por meio de uma conexão interna, clique na guia Conexões .

   Para obter mais informações sobre esta guia, consulte Sobre as opções de conexão .

5. Clique na aba Rede . As seguintes informações são exibidas sobre instâncias que têm o Private Service Connect habilitado:

   • A caixa de seleção IP privado está marcada, mas desativada. A instância deve ter um endereço IP interno, e essa configuração não pode ser alterada.
   • Os projetos permitidos para a instância.
   • A caixa de seleção IP público está selecionada, mas desativada.
   • O campo Redes autorizadas está desativado porque a instância usa o Private Service Connect, que não oferece suporte a esse recurso.

gcloud

Para obter informações sobre como instalar e começar a usar a CLI do gcloud, consulte Instalar a CLI do gcloud . Para obter informações sobre como iniciar o Cloud Shell, consulte Usar o Cloud Shell .

1. Para visualizar informações resumidas sobre uma instância, use o comando gcloud sql instances describe :

   gcloud sql instances describe INSTANCE_NAME \
   --project=PROJECT_ID

   Faça as seguintes substituições:

   • INSTANCE_NAME : o nome da instância do Cloud SQL. Se o Private Service Connect estiver habilitado para essa instância, os endpoints do Private Service Connect em redes VPC poderão se conectar a ela.
   • PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância.

   Aqui está um exemplo da saída para executar 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 visualizar informações mais detalhadas sobre instâncias que têm o Private Service Connect habilitado, adicione os seguintes parâmetros:

Contexto	Parâmetro	Notas
Nome DNS	dnsName	O nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e o aponte para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.
Anexo de serviço	pscServiceAttachmentLink	O URI que aponta para o anexo de serviço da instância. Use este URI para criar o endpoint do Private Service Connect.
Projetos de consumo permitidos	allowedConsumerProjects	Uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect a partir de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
Habilitando o Private Service Connect	pscEnabled	Se uma instância tem o Private Service Connect habilitado para ela.

Terraform

Para criar uma instância, use um recurso do 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 as alterações

Para aplicar sua configuração do Terraform em um Google Cloud projeto, conclua as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell .

2. Defina o padrão Google Cloud projeto onde você deseja aplicar suas configurações do Terraform.

   Você só precisa executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variáveis ​​de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform deve ter seu próprio diretório (também chamado de módulo raiz ).

1. No Cloud Shell , crie um diretório e um novo arquivo dentro dele. O nome do arquivo deve ter a extensão .tf — por exemplo, main.tf Neste tutorial, o arquivo será chamado de main.tf

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

2. Se estiver seguindo um tutorial, você pode copiar o código de exemplo em cada seção ou etapa.

   Copie o código de exemplo no main.tf recém-criado.

   Opcionalmente, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução completa.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve suas alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade :

   terraform init -upgrade

Aplicar as alterações

1. Revise a configuração e verifique se os recursos que o Terraform irá criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça correções na configuração conforme necessário.

2. Aplique a configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Aplicação concluída!".

3. Abra seu Google Cloud projeto para visualizar os resultados. No Google Cloud console, navegue até seus recursos na interface do usuário para garantir que o Terraform os criou ou atualizou.

Excluir as alterações

Para excluir suas alterações, faça o seguinte:

1. Para desabilitar a proteção contra exclusão, no seu arquivo de configuração do Terraform defina o argumento deletion_protection como false .

   deletion_protection =  "false"

2. Aplique a configuração atualizada do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

3. Remova os recursos aplicados anteriormente com sua configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform destroy

REST v1

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância.
• INSTANCE_NAME : o nome da instância do Cloud SQL. Se o Private Service Connect estiver habilitado para essa instância, os endpoints do Private Service Connect em redes VPC poderão se conectar a ela.

Método HTTP e URL:

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

Para enviar sua solicitação, expanda uma destas opções:

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

Você deve receber uma resposta JSON semelhante à seguinte:

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

Os seguintes campos existem para instâncias que têm o Private Service Connect habilitado para elas:

• allowedConsumerProjects : uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect a partir de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
• pscEnabled : se uma instância tem o Private Service Connect habilitado para ela.
• pscServiceAttachmentLink : o URI que aponta para o anexo de serviço da instância. Use este URI para criar o endpoint do Private Service Connect.
• dnsName : o nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e o aponte para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.

Para ver como construir a solicitação da API REST subjacente para esta tarefa, consulte a página instances:get .

REST v1beta4

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância.
• INSTANCE_NAME : o nome da instância do Cloud SQL. Se o Private Service Connect estiver habilitado para essa instância, os endpoints do Private Service Connect em redes VPC poderão se conectar a ela.

Método HTTP e URL:

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

Para enviar sua solicitação, expanda uma destas opções:

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

Você deve receber uma resposta JSON semelhante à seguinte:

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

Os seguintes campos existem para instâncias que têm o Private Service Connect habilitado para elas:

• allowedConsumerProjects : uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect a partir de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
• pscEnabled : se uma instância tem o Private Service Connect habilitado para ela.
• pscServiceAttachmentLink : o URI que aponta para o anexo de serviço da instância. Use este URI para criar o endpoint do Private Service Connect.
• dnsName : o nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e o aponte para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.