Créer et gérer des pools de lecture
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
MySQL | PostgreSQL | SQL Server
Preview
This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section
of the Service Specific Terms .
You can process personal data for this feature as outlined in the
Cloud Data Processing
Addendum , subject to the obligations and restrictions described in the agreement under
which you access Google Cloud.
Pre-GA features are available "as is" and might have limited support.
For more information, see the
launch stage descriptions .
Cette page explique comment créer et gérer des pools de lecture pour vos charges de travail de lecture volumineuses.
Avant de commencer
Les pools de lecture contiennent des copies d'une instance principale. Si vous ne l'avez pas déjà fait, créez une instance principale de l'édition Cloud SQL Enterprise Plus .
Bien que les pools de lecture acceptent la connectivité IP publique, pour les besoins de ce guide, créez une instance principale avec une connectivité IP privée (PSA).
Pour en savoir plus sur les instances principales et la réplication, consultez la page À propos de la réplication dans Cloud SQL .
Une fois l'instance principale créée, choisissez un mot de passe pour l'utilisateur racine et exécutez la commande suivante pour définir le mot de passe sur l'instance principale.
Enregistrez ce mot de passe pour l'utiliser ultérieurement lorsque vous vous connecterez au pool de lecture.
gcloud --project= PROJECT \
sql users set-password root --host= % \
--instance= PRIMARY_INSTANCE_NAME --prompt-for-password
Assurez-vous d'utiliser gcloud
516.0.0 ou une version ultérieure.
Effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture se trouvent.
PRIMARY_INSTANCE_NAME : nom de l'instance principale.
Créer un pool de lecture
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud beta sql instances create
suivante pour créer un pool de lecture avec plusieurs nœuds de pool de lecture:
gcloud beta sql instances create READ_POOL_NAME \
--tier= TIER --edition= ENTERPRISE_PLUS \
--instance-type= READ_POOL_INSTANCE --node-count= NODE_COUNT \
--master-instance-name= PRIMARY_INSTANCE_NAME
Effectuez les remplacements suivants :
READ_POOL_NAME : nom que vous souhaitez utiliser pour le pool de lecture.
TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4
.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
PRIMARY_INSTANCE_NAME : nom de l'instance principale associée au pool de lecture, par exemple my-primary-instance
.
REST v1
Utilisez la méthode
insert
de la ressource des instances pour créer un pool de lecture avec plusieurs nœuds de pool de lecture. La propriété databaseVersion
doit être identique à celle de l'instance principale.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture se trouvent.
REGION : région du pool de lecture, par exemple us-east1
.
La région doit être la même que celle de l'instance principale.
TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4
.
PRIMARY_INSTANCE_NAME : nom de l'instance principale.
READ_POOL_NAME : nom que vous souhaitez utiliser pour le pool de lecture, par exemple my-read-pool
.
DATABASE_VERSION : version de la base de données que vous souhaitez utiliser.
Exemple :POSTGRES_16
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
FULL_NETWORK_NAME : chemin d'accès réseau complet où vous souhaitez que le pool de lecture réside, par exemple projects/vpc-host-project/global/networks/my-network-name
.
Méthode HTTP et URL :
POST https://sqladmin.googleapis.com/v1/projects/PROJECT /instances
Corps JSON de la requête :
{
"name": "READ_POOL_NAME ",
"masterInstanceName": "PRIMARY_INSTANCE_NAME ",
"project": "PROJECT ",
"databaseVersion": "DATABASE_VERSION ",
"region": "REGION ",
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT ,
"settings": {
"tier": "TIER ",
"edition": "ENTERPRISE_PLUS",
"ipConfiguration": {
"ipv4Enabled": false,
"privateNetwork": "FULL_NETWORK_NAME "
}
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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 /instances"
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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 /instances" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "CREATE_READ_POOL",
"name": "OPERATION_ID ",
"targetId": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
Utilisez la méthode
insert
de la ressource des instances pour créer un pool de lecture avec plusieurs nœuds de pool de lecture. La propriété databaseVersion
doit être identique à celle de l'instance principale.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel vous souhaitez que l'instance principale et le pool de lecture se trouvent.
REGION : région du pool de lecture, par exemple us-east1
.
La région doit être la même que celle de l'instance principale.
TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4
.
PRIMARY_INSTANCE_NAME : nom de l'instance principale.
READ_POOL_NAME : nom que vous souhaitez utiliser pour le pool de lecture, par exemple my-read-pool
.
DATABASE_VERSION : version de la base de données que vous souhaitez utiliser.
Exemple :POSTGRES_16
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
FULL_NETWORK_NAME : chemin d'accès réseau complet où vous souhaitez que le pool de lecture réside, par exemple projects/vpc-host-project/global/networks/my-network-name
.
Méthode HTTP et URL :
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances
Corps JSON de la requête :
{
"name": "READ_POOL_NAME ",
"masterInstanceName": "PRIMARY_INSTANCE_NAME ",
"project": "PROJECT ",
"databaseVersion": "DATABASE_VERSION ",
"region": "REGION ",
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT ,
"settings": {
"tier": "TIER ",
"edition": "ENTERPRISE_PLUS",
"ipConfiguration": {
"ipv4Enabled": false,
"privateNetwork": "FULL_NETWORK_NAME "
}
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/sql/v1beta4/projects/PROJECT /instances"
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/sql/v1beta4/projects/PROJECT /instances" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "CREATE_READ_POOL",
"name": "OPERATION_ID ",
"targetId": "INSTANCE_ID ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
Convertir une instance répliquée avec accès en lecture en pool de lecture
Vous pouvez convertir un réplica avec accès en lecture de l'édition Cloud SQL Enterprise Plus existante en pool de lecture en spécifiant le nombre de nœuds du pool. Au cours de ce processus de conversion, l'adresse IP du réplica devient l'adresse IP du pool de lecture (le point de terminaison de lecture), afin que les clients existants puissent se connecter au pool sans avoir à le reconfigurer.
Les nœuds du pool de lecture nouvellement créés auront le même type de machine et la même configuration que l'instance répliquée avec accès en lecture d'origine. La modification de ce type de machine ou de cette configuration nécessite une opération distincte. Cette opération n'est possible que pour les instances dupliquées avec accès en lecture zonales. Pour convertir une instance répliquée avec accès en lecture haute disponibilité (HA) en pool avec accès en lecture, vous devez d'abord la convertir en instance répliquée avec accès en lecture zonale.
Pour en savoir plus, consultez la section Modifier la configuration du pool de lecture .
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud beta sql instances patch
suivante pour convertir une instance répliquée avec accès en lecture à utiliser avec un pool avec accès en lecture:
gcloud beta sql instances patch READ_REPLICA_NAME \
--instance-type= READ_POOL_INSTANCE --node-count= NODE_COUNT
Effectuez les remplacements suivants :
READ_REPLICA_NAME : nom de l'instance répliquée avec accès en lecture que vous souhaitez convertir.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
REST v1
Utilisez la méthode
patch
de la ressource des instances pour convertir une instance dupliquée avec accès en lecture en pool avec accès en lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
READ_REPLICA_NAME : nom de l'instance répliquée avec accès en lecture que vous souhaitez convertir, par exemple my-read-replica
.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_REPLICA_NAME
Corps JSON de la requête :
{
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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 /instances/READ_REPLICA_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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 /instances/READ_REPLICA_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_REPLICA_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_REPLICA_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
Utilisez la méthode
patch
de la ressource des instances pour convertir une instance dupliquée avec accès en lecture en pool avec accès en lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
READ_REPLICA_NAME : nom de l'instance répliquée avec accès en lecture que vous souhaitez convertir, par exemple my-read-replica
.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME
Corps JSON de la requête :
{
"instanceType": "READ_POOL_INSTANCE",
"nodeCount": NODE_COUNT
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_REPLICA_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_REPLICA_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
Convertir un pool de lecture en instance répliquée avec accès en lecture
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud beta sql instances patch
suivante pour convertir une instance répliquée avec accès en lecture à utiliser avec un pool avec accès en lecture:
gcloud beta sql instances patch READ_POOL_NAME \
--instance-type= READ_REPLICA_INSTANCE
Effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture que vous souhaitez convertir.
REST v1
Utilisez la méthode
patch
de la ressource des instances pour convertir un pool avec accès en lecture en instance dupliquée avec accès en lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
Corps JSON de la requête :
{
"instanceType": "READ_REPLICA_INSTANCE"
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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 /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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 /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
Utilisez la méthode
patch
de la ressource des instances pour convertir un pool avec accès en lecture en instance dupliquée avec accès en lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
Corps JSON de la requête :
{
"instanceType": "READ_REPLICA_INSTANCE"
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
Afficher les informations sur le pool de lecture
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud beta sql instances describe
suivante pour décrire le pool de lecture:
gcloud beta sql instances describe READ_POOL_NAME
Effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture que vous souhaitez décrire.
Un exemple de réponse avec une adresse IP et des informations sur le nœud peut ressembler à ce qui suit:
...
connectionName : my-project:us-central1:read-pool
ipAddresses :
- ipAddress : 10.3.0.108
type : PRIVATE
nodeCount : 2
nodes :
- dnsName : c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
gceZone : us-central1-f
ipAddresses :
- ipAddress : 10.3.0.112
type : PRIVATE
name : read-pool-node-01
state : RUNNABLE
- dnsName : 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
gceZone : us-central1-c
ipAddresses :
- ipAddress : 10.3.0.113
type : PRIVATE
name : read-pool-node-02
state : RUNNABLE
REST v1
Utilisez la méthode
get
pour afficher les détails du pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
GET https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method GET ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
[...],
"connectionName": "my-project:us-central1:read-pool",
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.108"
}
],
"nodeCount": 2,
"nodes": [
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.112"
}
],
"name": "read-pool-node-01",
"gceZone": "us-central1-f",
"dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
},
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.113"
}
],
"name": "read-pool-node-02",
"gceZone": "us-central1-c",
"dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
}
]
}
REST v1beta4
Utilisez la méthode
get
pour afficher les détails du pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
$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 /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
{
[...],
"connectionName": "my-project:us-central1:read-pool",
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.108"
}
],
"nodeCount": 2,
"nodes": [
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.112"
}
],
"name": "read-pool-node-01",
"gceZone": "us-central1-f",
"dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
},
{
"ipAddresses": [
{
"type": "PRIVATE",
"ipAddress": "10.3.0.113"
}
],
"name": "read-pool-node-02",
"gceZone": "us-central1-c",
"dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
"state": "RUNNABLE"
}
]
}
Ajouter ou supprimer des nœuds de pool de lecture
Les étapes suivantes permettent de réduire ou d'augmenter la taille d'un pool de lecture en modifiant le nombre de nœuds du pool de lecture. Certaines restrictions d'utilisation s'appliquent. Pour en savoir plus, consultez la section Limites des pools de lecture .
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud beta sql instances patch
suivante pour faire évoluer le pool de lecture:
gcloud beta sql instances patch READ_POOL_NAME \
--node-count= NODE_COUNT
Effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
REST v1
Utilisez la méthode
patch
pour augmenter ou réduire la taille d'un pool de lecture en modifiant le nombre de nœuds du pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
Corps JSON de la requête :
{
"nodeCount": NODE_COUNT
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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 /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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 /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
Utilisez la méthode
patch
pour augmenter ou réduire la taille d'un pool de lecture en modifiant le nombre de nœuds du pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
NODE_COUNT : nombre de nœuds de pool de lecture que vous souhaitez dans le pool de lecture. Choisissez un nombre compris entre 1
et 20
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
Corps JSON de la requête :
{
"nodeCount": NODE_COUNT
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME INSTANCE_ID ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
Modifier la configuration du pool de lecture
Les étapes suivantes vous expliquent comment modifier la configuration du pool de lecture. Pour en savoir plus, consultez les pages À propos des paramètres d'instance et Modifier les instances .
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud beta sql instances patch
suivante pour faire évoluer verticalement le pool de lecture, par exemple en modifiant le type de machine:
gcloud beta sql instances patch READ_POOL_NAME \
--tier= TIER
Effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture.
TIER : type de machine que vous souhaitez appliquer à chaque nœud du pool de lecture, par exemple db-perf-optimized-N-8
.
REST v1
Utilisez la méthode
patch
pour modifier la configuration des nœuds du pool de lecture.
Les paramètres sont appliqués uniformément à tous les nœuds du pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4
.
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
Corps JSON de la requête :
{
"settings": {
"tier": "TIER "
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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 /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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 /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
Utilisez la méthode
patch
pour modifier la configuration des nœuds du pool de lecture.
Les paramètres sont appliqués uniformément à tous les nœuds du pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
TIER : type de machine que vous souhaitez utiliser pour chaque nœud du pool de lecture, par exemple db-perf-optimized-N-4
.
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
Corps JSON de la requête :
{
"settings": {
"tier": "TIER "
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "UPDATE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
Se connecter à un pool de lecture
Il existe de nombreuses façons de se connecter à un pool de lecture. Les étapes suivantes montrent une méthode, à savoir la connexion à un pool de lecture avec une adresse IP privée en créant une VM dans le même réseau VPC pour servir de source de connexion.
Pour en savoir plus sur les autres façons de configurer la connectivité à une instance Cloud SQL, consultez la page À propos des connexions Cloud SQL .
Les méthodes de connexion nécessitent généralement d'obtenir d'abord l'adresse IP ou le nom de connexion de l'instance, comme décrit dans la section Afficher les informations sur le pool de lecture .
Les pools de lecture sont compatibles avec la plupart des méthodes de connexion disponibles pour les autres instances Cloud SQL, avec certaines limites .
Si vous vous connectez à l'aide du proxy d'authentification Cloud SQL ou des connecteurs Cloud SQL, assurez-vous de passer à la dernière version. Pour la prise en charge du pool de lecture, les versions minimales requises sont les suivantes:
Proxy d'authentification Cloud SQL: version 2.15.2
Connecteur Python Cloud SQL: version 1.18.0
Connecteur Go Cloud SQL: version 1.16.0
Connecteur Cloud SQL Node: version 1.7.0
Connecteur Java Cloud SQL: version 1.24.0
Supprimer un pool de lecture
gcloud
Pour en savoir plus sur l'installation et le démarrage avec la gcloud CLI, consultez la page Installer la gcloud CLI . Pour en savoir plus sur le démarrage de Cloud Shell, consultez la page Utiliser Cloud Shell .
Utilisez la commande gcloud sql instances delete
suivante pour supprimer un pool de lecture:
gcloud sql instances delete READ_POOL_NAME
Effectuez les remplacements suivants :
READ_POOL_NAME : nom du pool de lecture que vous souhaitez supprimer.
REST v1
Utilisez la méthode
delete
pour supprimer un pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method DELETE ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
REST v1beta4
Utilisez la méthode
delete
pour supprimer un pool de lecture.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
PROJECT : nom du projet dans lequel se trouve le pool de lecture.
READ_POOL_NAME : nom du pool de lecture, par exemple my-read-pool
.
Méthode HTTP et URL :
DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME
Pour envoyer votre requête, développez l'une des options suivantes :
curl (Linux, macOS ou Cloud Shell)
Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
, ou en utilisant Cloud Shell , qui vous connecte automatiquement à la CLI gcloud
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME "
PowerShell (Windows)
Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud
avec votre compte utilisateur en exécutant la commande gcloud init
ou gcloud auth login
.
Vous pouvez exécuter la commande gcloud auth list
pour vérifier quel est le compte actuellement actif.
Exécutez la commande suivante :
$cred = gcloud auth print-access-token $headers = @{ "Authorization" = "Bearer $cred" } Invoke-WebRequest ` -Method DELETE ` -Headers $headers ` -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /instances/READ_POOL_NAME ",
"status": "PENDING",
"user": "[email protected] ",
"insertTime": "2020-01-21T22:43:37.981Z",
"operationType": "DELETE",
"name": "OPERATION_ID ",
"targetId": "READ_POOL_NAME ",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT /operations/OPERATION_ID ",
"targetProject": "PROJECT "
}
Étape suivante