netapp.cloudmanager.na_cloudmanager_connector_gcp 模块 – NetApp Cloud Manager GCP 连接器。

注意

此模块是 netapp.cloudmanager 集合 (版本 21.24.0) 的一部分。

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

要安装它，请使用： ansible-galaxy collection install netapp.cloudmanager。

要在 playbook 中使用它，请指定： netapp.cloudmanager.na_cloudmanager_connector_gcp。

netapp.cloudmanager 21.4.0 中的新增功能

概要 

创建或删除 GCP 的 Cloud Manager 连接器。

参数 

参数	注释
account_id 字符串	连接器将关联到的 NetApp 帐户 ID。如果未提供，Cloud Manager 将使用第一个帐户。如果不存在帐户，Cloud Manager 将创建一个新帐户。您可以在 Cloud Manager 的帐户选项卡中找到帐户 ID，网址为 [https://cloudmanager.netapp.com](https://cloudmanager.netapp.com）。
associate_public_ip 布尔值	指示是否将公共 IP 地址关联到虚拟机。选项 `false` `true` ← (默认)
client_id 字符串	Cloud Manager 连接器的客户端 ID。连接器 ID。如果 state 为 absent，则 client_id 用于标识代理并将其删除。如果 state 为 absent 且未设置此参数，则将删除与 `name` 关联的所有代理。当 state 为 present 时忽略。
company 字符串 / 必需	用户的公司名称。
environment 字符串 netapp.cloudmanager 21.8.0 中新增	NetApp Cloud Manager API 操作的环境。选项 `"prod"` ← (默认) `"stage"`
feature_flags 字典 netapp.cloudmanager 21.11.0 中新增	启用或禁用新功能。这可用于启用实验性功能或禁用破坏向后兼容性的新功能。支持的键和值可能会在未经通知的情况下更改。未知键将被忽略。
firewall_tags 布尔值	指示是否将 firewall_tags 添加到连接器 VM（HTTP 和 HTTP）。选项 `false` `true` ← (默认)
gcp_service_account_email 别名：service_account_email 字符串 / 必需 netapp.cloudmanager 21.7.0 中新增	连接器实例的服务帐户的电子邮件地址。此服务帐户用于允许连接器创建 Cloud Volume ONTAP。
gcp_service_account_path 别名：service_account_path 字符串 netapp.cloudmanager 21.7.0 中新增	用于 GCP 授权目的的服务帐户 JSON 文件的本地路径。此服务帐户用于在 GCP 中创建连接器。
machine_type 字符串	连接器 VM 的机器类型。默认值： `"n2-standard-4"`
name 字符串 / 必需	要管理的 GCP Cloud Manager 连接器的名称。
network_project_id 字符串	与子网关联的 GCP 项目 ID。如果未提供，则假定子网位于先前指定的项目 ID 中。
project_id 字符串 / 必需	将在其中创建连接器的 GCP project_id。
proxy_certificates 列表 / 元素=字符串	代理证书。证书文件名列表。
proxy_password 字符串	如果使用代理连接到互联网，则为代理密码。
proxy_url 字符串	如果使用代理连接到互联网，则为代理 URL。
proxy_user_name 字符串	如果使用代理连接到互联网，则为代理用户名。
refresh_token 字符串	NetApp Cloud Manager API 操作的刷新令牌。
sa_client_id 字符串	NetApp Cloud Manager API 操作的服务帐户密钥客户端 ID。
sa_secret_key 字符串	NetApp Cloud Manager API 操作的服务帐户密钥。
state 字符串	指定的 GCP Cloud Manager 连接器是否存在。选项 `"present"` ← (默认) `"absent"`
subnet_id 字符串	虚拟机的子网名称。默认值： `"default"`
zone 字符串 / 必需	将在其中创建连接器的 GCP 区域。

备注 

注意

以 na_cloudmanager 为前缀的模块用于管理 AWS/GCP/Azure 云中的 CloudManager 和 CVO 部署。
如果提供 sa_client_id 和 sa_secret_key，则操作将使用服务帐户。refresh_token 将被忽略。

示例 

- name: Create NetApp Cloud Manager connector for GCP
  netapp.cloudmanager.na_cloudmanager_connector_gcp:
    state: present
    name: ansible-occm-gcp
    project_id: xxxxxxx-support
    zone: us-east4-b
    company: NetApp
    gcp_service_account_email: xxxxxxxx@xxxxxxx-support.iam.gserviceaccount.com
    gcp_service_account_path: gcp_creds.json
    proxy_user_name: test
    proxy_password: test
    proxy_url: http://abcdefg.com
    proxy_certificates: ["D-TRUST_Root_Class_3_CA_2_2009.crt", "DigiCertGlobalRootCA.crt", "DigiCertGlobalRootG2.crt"]
    account_id: account-xxxxXXXX
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"

- name: Delete NetApp Cloud Manager connector for GCP
  netapp.cloudmanager.na_cloudmanager_connector_gcp:
    state: absent
    name: ansible-occm-gcp
    refresh_token: "{{ xxxxxxxxxxxxxxx }}"
    client_id: "{{ wwwwwwwwww }}"
    project_id: xxxxxxx-support
    zone: us-east4-b
    company: NetApp
    gcp_service_account_email: xxxxxxxx@xxxxxxx-support.iam.gserviceaccount.com
    gcp_service_account_path: gcp_creds.json
    account_id: account-xxxxXXXX

返回值 

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

键	描述
client_id 字符串	Cloud Manager 上新创建的 GCP 连接器 ID。返回：成功示例： `"FDQE8SwrbjVS6mqUgZoOHQmu2DvBNRRW"`
client_ids 列表 / 元素=字符串	如果连接器已存在，则为与名称和提供程序匹配的客户端 ID 列表。理想情况下，列表应为空，或包含与 client_id 匹配的单个元素。返回：成功示例： `["FDQE8SwrbjVS6mqUgZoOHQmu2DvBNRRW"]`

作者

NetApp Ansible 团队 (@carchi8py)