借助 Google Cloud NetApp Volumes,您可以通过 Google Cloud 代理提交操作,从而管理 ONTAP 模式存储池中的 ONTAP 资源。
出于安全和日志记录原因,NetApp Volumes 不允许直接连接到 ONTAP 管理 LIF,因此您无法直接使用 SystemManager 或 SSH 等工具。您可以改为使用以下方法向 ONTAP 模式存储池提交 ONTAP 操作:
Terraform 等管理工具使用 Google API 代理来管理 ONTAP 资源。
准备工作
您的 Google Cloud CLI 版本必须至少为 559.0.0,才能管理 ONTAP 模式存储池的 ONTAP 操作。如果您的版本较旧,Google Cloud CLI 会返回错误,指出未定义命令或标志。
使用 Google Cloud CLI ONTAP CLI 代理
虽然无法直接通过 SSH 访问 ONTAP CLI,但您可以使用 Google Cloud CLI 向存储池发送 ONTAP CLI 命令。
gcloud
运行 ONTAP 命令:
gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \ --location=LOCATION
替换以下信息:
POOL-NAME:Flex Unified ONTAP 模式存储池的名称。ONTAP-COMMAND:您要在集群或存储池上运行的 ONTAP 命令。PROJECT:您的项目 ID。LOCATION:存储池的位置。
使用 Google 代理 API 进行 ONTAP REST API 调用
NetApp Volumes 为每个 Flex Unified ONTAP 模式存储池提供一个 Google API 端点,以便您向底层 ONTAP 集群发送 ONTAP REST API 调用。这样,您就可以使用 API 控制 ONTAP 功能。
对 ONTAP 代理的调用必须使用以下网址格式:
https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
此网址由以下元素组成:
基准网址:
https://netapp.googleapis.com/v1存储池的 Google URN:/projects/
PROJECT/locations/LOCATION/storagePools/POOL_NAME替换以下信息:
PROJECT:您的项目 ID 或编号。LOCATION:可用区级池的可用区名称或区域级池的区域。POOL_NAME:池的名称。
ONTAP REST API 路径:/ontap/
ONTAP_REST_URL。 如需了解详情,请参阅 ONTAP REST API 参考文档。
列出存储池的所有卷
以下示例显示了用于列出项目 myproject 中 us-central1-a 内存储池 mypool 的所有卷的完整网址。
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes
与所有 Google API 调用一样,此调用必须经过身份验证。以下 CLI 示例会提取 API 令牌,然后使用 curl 调用网址以列出池中的所有卷:
TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
列出卷的所有快照
以下示例显示了用于列出项目 myproject 中 us-central1-a 内存储池 mypool 和卷 volume-uuid 的所有快照的完整网址。
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots
与所有 Google API 调用一样,此调用必须经过身份验证。以下 CLI 示例会提取 API 令牌,然后使用 curl 调用该网址,以列出该卷的所有快照:
TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
创建卷
本部分介绍了如何使用 ONTAP REST API 在现有 Flex Unified ONTAP 模式存储池(由 URN /projects/myproject/locations/us-central1-a/storagePools/mypool 标识)中创建名为 myvolume 的卷。
如需创建卷,请参阅 ONTAP REST API 在线文档。在文档中,前往存储部分,然后展开管理存储卷。本部分提供了几个示例。
按照以下说明创建卷。
确定 ONTAP REST API 端点。
使用 NetApp Volumes 中的基本示例,所需的 ONTAP API 端点为
/api/storage/volumes。此端点会创建以下网址:https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes。构建请求载荷。
使用 ONTAP 文档中的示例载荷来匹配您的特定环境。例如:
{ "name": "vol1", "aggregates": [ { "name": "aggr1" } ], "svm": { "name": "vs1" } }创建卷时,请使用
name字段分配卷名称。卷创建载荷需要使用在 ONTAP 模式池创建期间由 NetApp Volumes 分配的聚合和存储虚拟机 (SVM) 的名称。在 ONTAP 模式下,每个存储池都有一个 SVM 和一个存储聚合。您可以通过查询 ONTAP 所有 SVM 来检索此信息。如需检索 SVM 和聚合名称,请执行以下操作:
使用
ontap_fields进行字段选择:在 NetApp Volumes ONTAP 模式池中,使用查询参数ontap_fields=而不是标准 ONTAPfields=参数来指定请求的字段。可选:使用
jq提取字段:以下示例使用 jq 开源工具从 JSON 响应中提取name(SVM 名称)和aggregates,这对于在 shell 脚本中进行处理非常有用。TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/svm/svms?ontap_fields=name,aggregates' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json" | jq '.rawResponse.records[] | {name: .name, aggregates: .aggregates[].name}'示例响应:
{ "name": "gcnv-7cf6ee41c1a94f0-svm-01", "aggregates": "aggr1" }
执行卷创建 API 调用。
使用聚合名称 (
aggr1) 和 SVM 名称 (gcnv-7cf6ee41c1a94f0-svm-01) 创建最终的卷创建载荷,并提交 API 调用。请注意,ONTAP API 载荷必须封装在 NetApp Volumes 的body: {}封装容器中。以下示例创建了一个名为
myvolume且大小为 2 GB 的卷:curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json" \ --data '{ "body": { "name": "myvolume", "aggregates": [ { "name": "aggr1" } ], "svm": { "name": "gcnv-7cf6ee41c1a94f0-svm-01" }, "size": "2GB" } }'卷创建支持许多可选参数,例如
size。例如,载荷指定了 2 GB 的大小。资源的文档页面会列出所有可用参数,包括必需参数和可选参数。它还提供了载荷和响应正文的详细示例。如需在 ONTAP REST API 中配置自动分层,请在请求正文中添加
tieringJSON 对象:如需将卷的分层政策设置为
all,请使用"tiering": {"policy": "all"}。可选:如需配置冷却天数,请使用
"tiering": {"policy": "auto", "min_cooling_days": 31}。您可以在
min_cooling_days字段中指定 2 到 183 天之间的冷却阈值。默认冷却阈值为 31 天。
如需绕过热层,直接将数据写入读写 (RW) 卷上的云层,请使用具有高级权限的 Google Cloud CLI ONTAP CLI 代理:
set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
监控 ONTAP 作业。
大多数 ONTAP API 调用(例如创建或更新资源的
POST或PATCH操作)不会同步运行。这些调用会返回 ONTAP 作业资源,如卷创建示例所示。作业响应示例:
{ "body": { "job": { "_links": { "self": { "href": "curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"" } }, "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c" } } }如需检查作业的状态,请使用返回的
uuid查询作业资源:curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
示例响应:
{ "rawResponse": { "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c", "description": "POST /api/storage/volumes/15be0ad9-fd2c-11f0-b3c2-7f15697be61c", "state": "success", "message": "success", "code": 0, "start_time": "2026-01-29T16:03:43+00:00", "end_time": "2026-01-29T16:03:44+00:00", "svm": { "name": "gcnv-7cf6ee41c1a94f0-svm-01", "uuid": "8a29c15d-fb31-11f0-ab03-03e1bb49206d" } } }如果
state为success,则系统会创建卷。此样本工作流将引导您在 ONTAP REST API 文档中查一查 ONTAP 操作。此外,还介绍了如何创建所需的载荷格式,并使用 Google API 将其提交到存储池。最后,它演示了如何监控 ONTAP 作业,直到资源创建完成。通过这种方法,您可以控制存储池的大多数 ONTAP 设置。
使用 Terraform 管理 ONTAP 模式
您可以使用 CLI 代理管理 ONTAP 模式资源。CLI 代理对于交互式使用非常有效,但自动化可能更复杂。Terraform 可一致地管理云资源的生命周期,您可以使用它来管理 NetApp Volumes 和 ONTAP 资源。
使用功能管理概览表可帮助您确定要使用的提供商。
Google 提供程序通过 NetApp Volumes API 管理资源。
NetApp-ONTAP 提供程序通过 ONTAP REST API 管理资源。
例如,您可以使用 Google 提供程序(7.27.0 版或更高版本)创建 ONTAP 模式存储池。然后,如需在该 ONTAP 模式池中创建卷,您需要使用 NetApp-ONTAP 提供程序 2.6.0 或更高版本。
如需详细了解设置和示例,请参阅 NetApp-ONTAP 提供商文档。
允许的 ONTAP 操作
通过 API 或 CLI 代理访问 ONTAP 模式池时,您没有完整权限,无法运行所有 ONTAP 命令。此限制有助于保护系统完整性,并防止对服务管理的底层物理资源进行更改。
对于某些 API,系统会过滤 API 请求和响应载荷。例如,由于 NetApp Volumes 按逻辑容量计费,因此系统会屏蔽用于配置物理容量的参数。如果您发送了不允许的参数,API 会返回错误。
如需详细了解我们的结算方式,请参阅结算:逻辑容量与物理容量。
支持的 ONTAP 命令
您可以使用 Google Cloud CLI ONTAP CLI 代理提交 ONTAP 命令,从而管理 ONTAP 模式。NetApp Volumes 支持大多数用于管理 SVM、LUN、卷和 ONTAP 功能的命令。某些命令会被屏蔽,以保护系统完整性,或者因为它们管理与代管式服务(例如 NetApp Volumes)无关的物理资源。
您可以在 ONTAP 管理员权限级别运行命令。如需将权限级别切换为高级,请在命令开头添加 set advanced; 或 set -privilege advanced;。部分命令还支持诊断 (diag) 权限级别,您可以通过在命令开头添加 set diag; 来访问该级别。这些权限变更不是永久性的。
由于代理不是交互式 shell,因此您一次只能运行一个命令。此限制意味着代理不支持请求其他信息的交互式命令。例如,您无法创建需要 Active Directory 管理员凭据的 CIFS 或 SMB vserver (SVM)。CLI 代理也不支持集群对等互连,因为它是交互式命令。如需执行这些操作,您必须使用 ONTAP REST API。
下表列出了 ONTAP CLI 代理支持的命令系列、命令和限制:
| 命令系列 | 用途 | 支持的命令 | 备注 |
|---|---|---|---|
| 集群 | SnapMirror、FlexCache 的对等集群,并显示有关集群的特定信息 | cluster peer - 完整访问权限cluster show、identity show、date show、ha show、statistics show 和 time-service ntp server show - 只读 |
CLI 代理不支持交互式 cluster peer create 命令;请改用 REST API。您可以使用其他 cluster peer 命令,例如 show。 |
| 调试 | 支持数据包跟踪 (tcpdump)、LUN 和锁定问题排查 | debug network tcpdump、debug san lun和debug lock persistence - 完整访问权限 |
所有允许的调试命令都需要 diag 权限级别。这些是常见的调试命令。 |
| 事件 | 创建过滤条件,将感兴趣的 ONTAP 事件发送到 SMTP 或 syslog 目标 | event catalog show 和 event log show - 只读event config、event filter 和 event notification - 完整访问权限 |
让您能够将事件记录到自定义目标位置。您可以使用 event log show 按时间或类型显示日志事件。 |
| 作业 | 在节点和集群级别管理 ONTAP 作业 | job show、job schedule、job private、job stop 和 job resume - 完整访问权限 |
|
| LUN | 创建和管理 LUN 和发起方组,以及导入外部 LUN | lun create、lun bind和igroup - 完整访问权限 |
虽然允许使用 lun import,但无法将外部磁盘连接到 ONTAP 模式系统。 |
| 网络 | 显示网络端口、接口、路由和 ipspace 配置,对外部 IP 地址运行 ping 和 traceroute,并按协议显示客户端连接 | network ping、network traceroute、network port interface、network ipspace和network connections - 只读 |
|
| 服务质量 (QoS) | 创建和管理 QoS 政策组 (QPG),并将其分配给卷。存储池的总吞吐量和 IOPS 决定了整体上限。 | qos policy-group create、qos policy-group modify 和 qos policy-group delete - 完全访问权限qos policy-group show - 只读volume create -qos-policy-group 和 volume modify -qos-policy-group - 将卷挂接到 QPG、将其移至其他 QPG 或使用 none 将其分离 |
|
| 安全 | 显示审核配置、启用防勒索软件功能,以及创建和安装证书 | security audit - 只读security anti-ransomware volume和 security certificate - 完整访问权限 |
您可以在创建卷时设置防勒索软件参数。您只能创建服务器和客户端证书。 |
| SnapLock | 管理 SnapLock 时钟和日志,并控制 SnapLock 基于事件的保留和诉讼保全操作 | snaplock compliance-clock和snaplock log - 完整访问权限 |
使用 volume snaplock modify 命令在各个卷上配置 SnapLock。您只能使用 ONTAP REST API 管理 SnapLock 命令 snaplock event-retention 和 snaplock legal-hold。 |
| SnapMirror | 创建和管理 SnapMirror 关系 | snapmirror create、snapmirror initialize、snapmirror break 和 snapmirror resync - 完整访问权限 |
|
| 统计信息 | 显示定期系统统计信息或创建特定统计信息的样本 | statistics samples、statistics start、statistics stop 和 statistics show-periodic - 完全访问权限statistics volume、statistics lun、statistics aggregate、statistics qtree 和 statistics SVM - 只读 |
许多命令都需要高级模式来指定其参数。 |
| 系统 | 通常不支持系统命令,但可以调用 AutoSupport 和性能归档传输 | system node autosupport invoke和system node autosupport invoke-performance-archive - 完整访问权限 |
AutoSupport 文件可供 NetApp 支持团队使用。 |
| 音量 | 创建和管理卷 | volume create、volume delete、volume modify、volume clone、volume expand (FlexGroup)、volume flexcache、volume flexgroup、qtree、quota、snaplock 和 snapshot - 完整访问权限 |
某些卷功能(例如逻辑空间报告/强制执行和空间保证 [无])由系统自动管理。将卷分层政策设置为使用在池级层设置的自动分层。 |
| Vserver | 管理 SVM (vserver),以便通过文件(SMB、NFS)、块(iSCSI、NVMe)和对象 (S3) 访问卷。 管理用于卷的政策,例如 NFS 的导出政策。 启用 SVM 功能,例如审核日志记录(文件访问)、一致性组、政策、名称服务(DNS、LDAP)和防病毒 (vscan)。 为 SnapMirror 和 FlexCache 对等互连 SVM。 |
vserver cifs create(加入 Active Directory 网域)、vserver nfs create、vserver iscsi create 和 vserver nvme create - 完整访问权限vserver object-store-server - 完整访问权限 |
使用 vserver modify 命令为所有卷设置默认语言、安全样式以及快照和配额政策。目前不支持 vserver create。密码更改命令无法以交互方式运行,必须使用命令参数或 REST API 指定。 |
| 旧版命令 | timezone和version - 完整访问权限 |
删除 ONTAP 模式池
如需删除 ONTAP 模式池,您必须先删除该池中的所有卷。