google.cloud.gcp_sql_instance_info 模块 – 收集 GCP 实例信息

注意

此模块是 google.cloud 集合 (版本 1.4.1) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install google.cloud。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。

要在 playbook 中使用它，请指定： google.cloud.gcp_sql_instance_info。

注意

由于违反了 Ansible 包含要求，google.cloud 集合将在 Ansible 12 中移除。该集合存在 未解决的健全性测试失败。有关更多信息，请参见 讨论主题。

概要

• 收集 GCP 实例信息

要求

执行此模块的主机需要以下要求。

• python >= 2.6

• requests >= 2.18.4

• google-auth >= 1.3.0

参数

参数	注释
access_token 字符串	如果凭据类型为 accesstoken，则为 OAuth2 访问令牌。
auth_kind 字符串 / 必需	使用的凭据类型。 选项 "application" "machineaccount" "serviceaccount" "accesstoken"
env_type 字符串	指定您在哪个 Ansible 环境中运行此模块。 除非您知道自己在做什么，否则不应设置此项。 这只会更改任何 API 请求的用户代理字符串。
project 字符串	要使用的 Google Cloud Platform 项目。
scopes 列表 / 元素=字符串	要使用的作用域数组
service_account_contents jsonarg	服务帐户 JSON 文件的内容，可以是字典或表示它的 JSON 字符串。
service_account_email 字符串	如果选择了 machineaccount 并且用户不希望使用默认电子邮件，则为可选的服务帐户电子邮件地址。
service_account_file 路径	如果选择 serviceaccount 作为类型，则为服务帐户 JSON 文件的路径。

注释

注意

• 对于身份验证，您可以使用 GCP_SERVICE_ACCOUNT_FILE 环境变量设置 service_account_file。

• 对于身份验证，您可以使用 GCP_SERVICE_ACCOUNT_CONTENTS 环境变量设置 service_account_contents。

• 对于身份验证，您可以使用 GCP_SERVICE_ACCOUNT_EMAIL 环境变量设置 service_account_email。

• 对于身份验证，您可以使用 GCP_ACCESS_TOKEN 环境变量设置 access_token。

• 对于身份验证，您可以使用 GCP_AUTH_KIND 环境变量设置 auth_kind。

• 对于身份验证，您可以使用 GCP_SCOPES 环境变量设置 scopes。

• 只有在未设置 playbook 值时，才会使用环境变量值。

• service_account_email 和 service_account_file 选项是互斥的。

示例

- name: get info on an instance
  gcp_sql_instance_info:
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键	描述
resources 复杂类型	资源列表 返回：始终
backendType 字符串	* FIRST_GEN：第一代实例。仅限 MySQL。 * SECOND_GEN：第二代实例或 PostgreSQL 实例。 * EXTERNAL：不是由 Google 管理的数据库服务器。 返回：成功
connectionName 字符串	连接字符串中使用的 Cloud SQL 实例的连接名称。 返回：成功
databaseVersion 字符串	数据库引擎类型和版本。对于第一代实例，可以是 MYSQL_5_5 或 MYSQL_5_6。对于第二代实例，可以是 MYSQL_5_6 或 MYSQL_5_7。默认为 MYSQL_5_6。 PostgreSQL 实例：POSTGRES_9_6 数据库版本属性在实例创建后无法更改。 返回：成功
diskEncryptionConfiguration 复杂类型	磁盘加密设置。 返回：成功
kmsKeyName 字符串	用于加密 Cloud SQL 实例的 KMS 密钥。 返回：成功
diskEncryptionStatus 复杂类型	磁盘加密状态。 返回：成功
kmsKeyVersionName 字符串	用于加密 Cloud SQL 实例的 KMS 密钥版本。 返回：成功
failoverReplica 复杂类型	故障转移副本的名称和状态。此属性仅适用于第二代实例。 返回：成功
available 布尔值	故障转移副本的可用性状态。false 状态表示故障转移副本不同步。只有在状态为 true 时，主服务器才能故障转移到故障转移副本。 返回：成功
name 字符串	故障转移副本的名称。如果在实例创建时指定，则会为实例创建故障转移副本。名称不包含项目 ID。此属性仅适用于第二代实例。 返回：成功
gceZone 字符串	实例当前从中提供服务的 Compute Engine 区域。如果实例已故障转移到其辅助区域，则此值可能与实例创建时指定的区域不同。 返回：成功
instanceType 字符串	实例类型。可以是以下之一。 * CLOUD_SQL_INSTANCE：未从主服务器复制的 Cloud SQL 实例。 * ON_PREMISES_INSTANCE：在客户场所运行的实例。 * READ_REPLICA_INSTANCE：配置为只读副本的 Cloud SQL 实例。 返回：成功
ipAddresses 复杂类型	分配给实例的 IP 地址。 返回：成功
ipAddress 字符串	分配的 IP 地址。 返回：成功
timeToRetire 字符串	此IP的报废时间，采用RFC 3339格式，例如2012-11-15T16:19:00.094Z。只有在计划报废IP时，此字段才可用。 返回：成功
类型 字符串	此IP地址的类型。PRIMARY地址是可以接受传入连接的地址。OUTGOING地址是实例发起的连接的源地址（如果支持）。 返回：成功
ipv6Address 字符串	分配给实例的IPv6地址。此属性仅适用于第一代实例。 返回：成功
masterInstanceName 字符串	在复制设置中充当主机的实例的名称。 返回：成功
maxDiskSize 整数	实例的最大磁盘大小（以字节为单位）。 返回：成功
name 字符串	Cloud SQL实例的名称。不包括项目ID。 返回：成功
区域 字符串	地理区域。根据实例类型（第一代或第二代/PostgreSQL）默认为us-central或us-central1。 返回：成功
replicaConfiguration 复杂类型	特定于故障转移副本和只读副本的配置。 返回：成功
failoverTarget 布尔值	指定副本是否是故障转移目标。如果该字段设置为true，则该副本将被指定为故障转移副本。 如果主实例发生故障，则副本实例将被提升为新的主实例。 只能指定一个副本作为故障转移目标，并且该副本必须与主实例位于不同的区域。 返回：成功
mysqlReplicaConfiguration 复杂类型	从本地MySQL主服务器复制时，MySQL的特定配置。诸如用户名、密码、证书和密钥之类的复制配置信息不会存储在实例元数据中。配置信息仅用于设置复制连接，并由MySQL存储在数据目录中名为master.info的文件中。 返回：成功
caCertificate 字符串	受信任的CA的x509证书的PEM表示形式。 返回：成功
clientCertificate 字符串	副本的x509证书的PEM表示形式。 返回：成功
clientKey 字符串	副本的私钥的PEM表示形式。相应的公钥编码在客户端的证书中。 返回：成功
connectRetryInterval 整数	连接重试之间等待的秒数。MySQL的默认值为60秒。 返回：成功
dumpFilePath 字符串	Google Cloud Storage中SQL转储文件的路径，从中创建副本实例。URI采用gs://bucketName/fileName的形式。还支持压缩的gzip文件（.gz）。转储应该包含应该开始复制的binlog坐标。这可以通过在使用mysqldump时将–master-data设置为1来实现。 返回：成功
masterHeartbeatPeriod 整数	复制心跳之间的间隔（毫秒）。 返回：成功
password 字符串	复制连接的密码。 返回：成功
sslCipher 字符串	允许用于SSL加密的密码列表。 返回：成功
username 字符串	复制连接的用户名。 返回：成功
verifyServerCertificate 布尔值	是否检查SSL握手期间主服务器在其发送的证书中提供的通用名称值。 返回：成功
replicaNames 列表 / 元素=字符串	实例的副本。 返回：成功
serviceAccountEmailAddress 字符串	分配给实例的服务帐号电子邮件地址。此属性仅适用于第二代实例。 返回：成功
serverCaCert 复杂类型	SSL配置。 返回：成功
cert 字符串	X.509证书的PEM表示形式。 返回：成功
certSerialNumber 字符串	从证书中提取的序列号。 返回：成功
commonName 字符串	用户提供的名称。限制为[a-zA-Z.-_ ]+。 返回：成功
createTime 字符串	创建证书的时间，采用RFC 3339格式，例如2012-11-15T16:19:00.094Z。 返回：成功
expirationTime 字符串	证书过期的时间，采用RFC 3339格式，例如2012-11-15T16:19:00.094Z。 返回：成功
sha1Fingerprint 字符串	证书的SHA-1指纹。 返回：成功
settings 复杂类型	用户设置。 返回：成功
availabilityType 字符串	availabilityType 定义您的 postgres 实例是运行在区域内还是跨区域。 返回：成功
backupConfiguration 复杂类型	实例的每日备份配置。 返回：成功
binaryLogEnabled 布尔值	是否启用二进制日志。如果禁用备份配置，则也必须禁用二进制日志。仅限MySQL。 返回：成功
enabled 布尔值	为您的实例启用自动备份。 返回：成功
startTime 字符串	定义备份开始时间（UTC）（HH:MM）。 返回：成功
databaseFlags 复杂类型	启动时传递给实例的数据库标志。 返回：成功
name 字符串	标志的名称。这些标志在实例启动时传递，因此包括MySQL的服务器选项和系统变量。标志应使用下划线而不是连字符指定。 返回：成功
value 字符串	标志的值。布尔值应设置为on表示true，设置为off表示false。如果标志不接受值，则必须省略此字段。 返回：成功
ipConfiguration 复杂类型	IP管理设置。这允许启用或禁用实例IP，并管理哪些外部网络可以连接到实例。对于第二代实例，不能禁用IPv4地址。 返回：成功
authorizedNetworks 复杂类型	允许使用IP连接到实例的外部网络列表。采用CIDR表示法，也称为“斜线”表示法（例如192.168.100.0/24）。 返回：成功
expirationTime 字符串	此访问控制条目到期的日期和时间，采用RFC 3339格式，例如2012-11-15T16:19:00.094Z。 返回：成功
name 字符串	用于标识此条目的可选标签。 返回：成功
value 字符串	访问控制列表的白名单值。例如，要授予来自外部IP（IPv4或IPv6）地址或子网的客户端的访问权限，请在此处使用该地址或子网。 返回：成功
ipv4Enabled 布尔值	实例是否应该分配IP地址。 返回：成功
privateNetwork 字符串	Cloud SQL实例可用于专用IP的VPC网络的资源链接（例如/projects/myProject/global/networks/default）。 返回：成功
requireSsl 布尔值	mysqld是否应默认为“REQUIRE X509”，用于通过IP连接的用户。 返回：成功
settingsVersion 整数	实例设置的版本。这是更新方法的必填字段，用于确保正确处理并发更新。 在更新期间，请使用此实例的最新settingsVersion值，并且不要尝试更新此值。 返回：成功
tier 字符串	此实例的分层或机器类型，例如db-n1-standard-1。对于MySQL实例，此字段决定实例是第二代（推荐）还是第一代。 返回：成功
userLabels 字典	用户提供的标签，表示为字典，其中每个标签都是一个键值对。 返回：成功
状态 字符串	数据库实例的当前服务状态。 返回：成功

作者

• Google Inc. (@googlecloudplatform)

资源链接

• 问题追踪器
• 主页
• 代码库（源代码）