Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengelola ONTAP dalam mode ONTAP

Halaman ini menjelaskan cara mengelola ONTAP dalam mode ONTAP.

Untuk alasan keamanan dan logging, NetApp Volumes tidak mengizinkan koneksi langsung ke LIF pengelolaan ONTAP. Oleh karena itu, Anda tidak dapat menggunakan alat seperti SystemManager atau SSH untuk mengelola sistem ONTAP secara langsung. Sebagai gantinya, Anda dapat mengirimkan operasi ONTAP ke pool penyimpanan mode ONTAP menggunakan metode berikut:

Proxy CLI ONTAP Google Cloud CLI
Google Proxy API untuk panggilan ONTAP REST API

Alat pengelolaan, seperti Terraform, menggunakan proxy Google API untuk mengelola resource ONTAP.

Sebelum memulai

Versi Google Cloud CLI Anda harus minimal 559.0.0 untuk mengelola operasi ONTAP bagi kumpulan penyimpanan mode ONTAP Anda. Jika versi Anda lebih lama, Google Cloud CLI akan menampilkan error bahwa perintah atau flag tidak ditentukan.

Menggunakan proxy CLI ONTAP Google Cloud CLI

Meskipun akses SSH langsung ke ONTAP CLI tidak tersedia, Anda dapat mengirim perintah ONTAP CLI ke kumpulan penyimpanan menggunakan Google Cloud CLI.

gcloud

Jalankan perintah ONTAP:

gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \
  --location=LOCATION

Ganti informasi berikut:

POOL-NAME: nama pool penyimpanan mode Flex Unified ONTAP.
ONTAP-COMMAND: perintah ONTAP yang ingin Anda jalankan di cluster atau pool penyimpanan.
PROJECT: project ID Anda.
LOCATION: lokasi pool penyimpanan Anda.

Menggunakan Google Proxy API untuk panggilan ONTAP REST API

NetApp Volumes menyediakan endpoint Google API untuk setiap kumpulan penyimpanan mode Flex Unified ONTAP, yang memungkinkan Anda mengirim panggilan ONTAP REST API ke cluster ONTAP yang mendasarinya. Dengan begitu, Anda dapat mengontrol fitur ONTAP menggunakan API.

Panggilan ke proxy ONTAP harus menggunakan format URL berikut:

  https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL

URL ini terdiri dari elemen berikut:

URL Dasar: https://netapp.googleapis.com/v1
URN Google untuk pool penyimpanan: /projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME

Ganti informasi berikut:
- PROJECT: project ID atau nomor project Anda.
- LOCATION: nama zona untuk pool zona atau region untuk pool regional.
- POOL_NAME: nama pool Anda.
Jalur ONTAP REST API: /ontap/ONTAP_REST_URL. Untuk mengetahui informasi selengkapnya, lihat referensi ONTAP REST API.

Mencantumkan semua volume kumpulan penyimpanan

Contoh berikut menunjukkan URL lengkap untuk mencantumkan semua volume untuk kumpulan penyimpanan mypool di us-central1-a dalam project myproject.

https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes

Seperti semua panggilan Google API, panggilan ini harus diautentikasi. Contoh CLI berikut mengambil token API, lalu memanggil URL menggunakan curl untuk mencantumkan semua volume dalam pool:

   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"

Mencantumkan semua snapshot volume

Contoh berikut menunjukkan URL lengkap untuk mencantumkan semua snapshot untuk pool penyimpanan mypool dan volume volume-uuid di us-central1-a dalam project myproject.

https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots

Seperti semua panggilan Google API, panggilan ini harus diautentikasi. Contoh CLI berikut mengambil token API, lalu memanggil URL menggunakan curl untuk mencantumkan semua snapshot untuk volume:

   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"

Membuat volume

Bagian ini menunjukkan cara membuat volume bernama myvolume di pool penyimpanan mode FlexUnified ONTAP yang ada, yang diidentifikasi oleh URN: /projects/myproject/locations/us-central1-a/storagePools/mypool, menggunakan ONTAP REST API.

Untuk membuat volume, lihat dokumentasi online ONTAP REST API. Dalam dokumentasi, buka bagian Storage, lalu luaskan Manage storage volumes. Bagian ini memberikan beberapa contoh.

Gunakan petunjuk berikut untuk membuat volume.

Tentukan endpoint ONTAP REST API.

Dengan menggunakan contoh dasar di NetApp Volumes, endpoint ONTAP API yang diperlukan adalah /api/storage/volumes. Endpoint ini membuat URL: https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.
Buat payload permintaan.

Gunakan contoh payload dari dokumentasi ONTAP agar sesuai dengan lingkungan spesifik Anda. Contoh:
```
{
  "name": "vol1",
  "aggregates": [
    {
      "name": "aggr1"
    }
  ],
  "svm": {
    "name": "vs1"
  }
}
```
Saat membuat volume, gunakan kolom name untuk menetapkan nama volume. Payload pembuatan volume memerlukan nama agregat dan storage virtual machine (SVM) yang ditetapkan oleh NetApp Volumes selama pembuatan pool mode ONTAP. Dalam mode ONTAP, setiap kumpulan penyimpanan memiliki satu SVM dan satu agregat penyimpanan. Informasi ini dapat diambil dengan membuat kueri ONTAP untuk semua SVM.

Untuk mengambil nama SVM dan aggregate:
1. Gunakan ontap_fields untuk pemilihan kolom: di kumpulan mode NetApp Volumes ONTAP, gunakan parameter kueri ontap_fields=, bukan parameter fields= ONTAP standar untuk menentukan kolom yang diminta.
2. Opsional: Gunakanjq untuk mengekstrak kolom: contoh berikut menggunakan alat open source jq untuk mengekstrak name (nama SVM) dan aggregates dari respons JSON, yang berguna untuk diproses dalam skrip 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}'
```
  Contoh respons:
```
{
 "name": "gcnv-7cf6ee41c1a94f0-svm-01",
 "aggregates": "aggr1"
}
```
Jalankan panggilan API pembuatan volume.

Dengan nama gabungan (aggr1) dan nama SVM (gcnv-7cf6ee41c1a94f0-svm-01), buat payload pembuatan volume akhir dan kirimkan panggilan API. Perhatikan bahwa payload ONTAP API harus disertakan dalam amplop body: {} untuk NetApp Volumes.

Contoh berikut membuat volume bernama myvolume dengan ukuran 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"
  }
}'
```
Pembuatan volume mendukung banyak parameter opsional, seperti size. Misalnya, payload menentukan ukuran 2 GB. Halaman dokumentasi resource mencantumkan semua parameter yang tersedia, termasuk parameter wajib dan opsional. Dokumen ini juga memberikan contoh mendetail tentang isi muatan dan isi respons.

Untuk mengonfigurasi auto-tiering di ONTAP REST API, sertakan objek JSON tiering di isi permintaan:
- Untuk menetapkan kebijakan tingkat volume ke all, gunakan "tiering": {"policy": "all"}.
- Opsional: Untuk mengonfigurasi hari pendinginan, gunakan "tiering": {"policy": "auto", "min_cooling_days": 31}.
  
  Anda dapat menentukan batas pendinginan antara 2 dan 183 hari di kolom min_cooling_days. Nilai minimum periode penantian default adalah 31 hari.
Untuk melewati tingkat aktif dan menulis data langsung ke tingkat cloud pada volume baca-tulis (RW), gunakan proxy CLI ONTAP Google Cloud CLI dengan hak istimewa lanjutan:
```
set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
```

Pantau tugas ONTAP.

Sebagian besar panggilan ONTAP API, seperti operasi POST atau PATCH yang membuat atau memperbarui resource, tidak berjalan secara sinkron. Sebagai gantinya, panggilan ini menampilkan resource tugas ONTAP, seperti yang ditunjukkan dalam contoh pembuatan volume.

Contoh respons pekerjaan:

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

Untuk memeriksa status tugas, kueri resource tugas menggunakan uuid yang ditampilkan:

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"

Contoh respons:

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

Jika state adalah success, volume akan dibuat.

Alur kerja contoh ini akan memandu Anda mencari tindakan ONTAP dalam dokumentasi ONTAP REST API. Panduan ini juga menunjukkan cara membuat format payload yang diperlukan dan mengirimkannya ke kumpulan penyimpanan menggunakan Google API. Terakhir, Codelab ini menunjukkan cara memantau tugas ONTAP hingga resource dibuat. Dengan pendekatan ini, Anda dapat mengontrol sebagian besar setelan ONTAP untuk kumpulan penyimpanan.

Menggunakan Terraform untuk mengelola mode ONTAP

Anda dapat mengelola resource mode ONTAP menggunakan proxy CLI. Proxy CLI efektif untuk penggunaan interaktif, tetapi otomatisasi bisa lebih rumit. Terraform secara konsisten mengelola siklus proses resource cloud, dan Anda dapat menggunakannya untuk mengelola resource NetApp Volumes dan ONTAP.

Gunakan tabel Ringkasan pengelolaan fitur untuk membantu Anda menentukan penyedia yang akan digunakan.

Penyedia Google mengelola resource melalui NetApp Volumes API.
Penyedia NetApp-ONTAP mengelola resource melalui ONTAP REST API.

Misalnya, Anda membuat kumpulan penyimpanan mode ONTAP menggunakan penyedia Google, versi 7.27.0 atau yang lebih baru. Kemudian, untuk membuat volume di pool mode ONTAP tersebut, Anda menggunakan penyedia NetApp-ONTAP, versi 2.6.0 atau yang lebih baru.

Untuk mengetahui informasi selengkapnya tentang penyiapan dan contoh, lihat dokumentasi penyedia NetApp-ONTAP.

Tindakan ONTAP yang diizinkan

Saat mengakses kumpulan mode ONTAP melalui API atau proxy CLI, Anda tidak memiliki izin penuh dan tidak dapat menjalankan semua perintah ONTAP. Pembatasan ini membantu melindungi integritas sistem dan mencegah perubahan pada resource fisik pokok yang dikelola oleh layanan.

Untuk beberapa API, sistem memfilter payload permintaan dan respons API. Misalnya, karena NetApp Volumes menagih kapasitas logis, sistem memblokir parameter untuk mengonfigurasi kapasitas fisik. Jika Anda mengirim parameter yang tidak diizinkan, API akan menampilkan error.

Untuk mengetahui informasi selengkapnya tentang cara kami menagih, lihat Penagihan: kapasitas logis versus fisik.

Perintah ONTAP yang didukung

Anda dapat mengelola mode ONTAP dengan mengirimkan perintah ONTAP menggunakan proxy CLI ONTAP Google Cloud CLI. NetApp Volumes mendukung sebagian besar perintah untuk mengelola SVM, LUN, volume, dan fitur ONTAP. Beberapa perintah diblokir untuk melindungi integritas sistem atau karena perintah tersebut mengelola resource fisik yang tidak relevan dalam layanan terkelola seperti NetApp Volumes.

Anda menjalankan perintah di tingkat hak istimewa administrator ONTAP. Untuk mengalihkan tingkat hak istimewa ke lanjutan, tambahkan set advanced; atau set -privilege advanced; ke awal perintah Anda. Serangkaian perintah terbatas juga mendukung tingkat hak istimewa diagnostik (diag), yang dapat Anda akses dengan menambahkan set diag; di awal perintah Anda. Perubahan hak istimewa ini tidak bersifat persisten.

Karena proxy bukan shell interaktif, Anda hanya dapat menjalankan satu perintah dalam satu waktu. Batasan ini berarti bahwa proxy tidak mendukung perintah interaktif yang meminta informasi tambahan. Misalnya, Anda tidak dapat membuat vserver (SVM) CIFS atau SMB yang memerlukan kredensial administrator Active Directory. Proxy CLI juga tidak mendukung peering cluster karena merupakan perintah interaktif. Untuk melakukan operasi tersebut, Anda harus menggunakan ONTAP REST API.

Tabel berikut mencantumkan grup perintah, perintah, dan batasan proxy CLI ONTAP yang didukung:

Rangkaian perintah	Tujuan	Perintah yang didukung	Catatan
Cluster	Cluster peer untuk SnapMirror, FlexCache, dan menampilkan informasi tertentu tentang cluster	cluster peer - akses penuh cluster show, identity show, date show, ha show, statistics show, dan time-service ntp server show - hanya baca	Proxy CLI tidak mendukung perintah `cluster peer create` interaktif; gunakan REST API sebagai gantinya. Anda dapat menggunakan perintah `cluster peer` lainnya, seperti `show`.
Debug	Mendukung pelacakan paket (tcpdump), LUN, dan pemecahan masalah penguncian	debug network tcpdump, debug san lun, dan debug lock persistence - akses penuh	Semua perintah debug yang diizinkan memerlukan tingkat hak istimewa `diag`. Berikut adalah perintah debug umum.
Acara	Buat filter untuk mengirim peristiwa ONTAP yang menarik ke tujuan SMTP atau syslog	event catalog show dan log peristiwa - hanya baca event config, event filter, dan notifikasi peristiwa - akses penuh	Memungkinkan Anda mencatat peristiwa ke tujuan kustom. Anda dapat menggunakan `event log show` untuk menampilkan peristiwa log menurut waktu atau jenis.
Tugas	Mengelola tugas ONTAP di tingkat node dan cluster	job show, job schedule, job private, job stop, dan job resume - akses penuh
LUN	Membuat dan mengelola LUN dan grup inisiasi, serta mengimpor LUN asing	lun create, lun bind, dan igroup - akses penuh	Meskipun impor LUN diizinkan, disk asing tidak dapat dihubungkan ke sistem mode ONTAP.
Jaringan	Menampilkan konfigurasi port jaringan, antarmuka, rute, dan ruang IP, menjalankan ping dan traceroute ke alamat IP eksternal, serta menampilkan koneksi klien menurut protokol	network ping, network traceroute, network port interface, network ipspace, dan network connections - hanya baca
QoS	Membuat dan mengelola grup kebijakan QoS serta menampilkan performa untuk grup tersebut	Semua perintah QoS - hanya baca	Setelan QoS bersifat hanya lihat.
Keamanan	Menampilkan konfigurasi audit, mengaktifkan fitur anti-ransomware, serta membuat dan menginstal sertifikat	audit keamanan - hanya baca volume anti-ransomware keamanan dan sertifikat keamanan - akses penuh	Parameter anti-ransomware dapat disetel saat membuat volume. Anda hanya dapat membuat sertifikat server dan klien.
SnapLock	Mengelola log dan jam SnapLock, serta mengontrol operasi pembekuan litigasi dan retensi berbasis peristiwa SnapLock	snaplock compliance-clock dan snaplock log - akses penuh	Gunakan perintah volume snaplock modify untuk mengonfigurasi SnapLock pada masing-masing volume. Anda dapat mengelola perintah SnapLock snaplock event-retention dan snaplock legal-hold hanya dengan menggunakan ONTAP REST API.
SnapMirror	Membuat dan mengelola hubungan SnapMirror	snapmirror create, snapmirror initialize, snapmirror break, dan snapmirror resync - akses penuh
Statistik	Menampilkan statistik sistem berkala atau membuat sampel statistik tertentu	statistics samples, statistics start, statistics stop, dan statistics show-periodic - akses penuh statistics volume, statistics lun, statistics aggregate, statistics qtree, dan statistics SVM - hanya baca	Banyak perintah memerlukan mode lanjutan untuk menentukan parameternya.
Sistem	Perintah sistem umumnya tidak didukung, tetapi transmisi arsip performa dan AutoSupport dapat dipanggil	system node autosupport invoke dan system node autosupport invoke-performance-archive - akses penuh	File AutoSupport tersedia untuk Dukungan NetApp.
Volume	Membuat dan mengelola volume	volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock, snapshot - akses penuh	Beberapa kemampuan volume seperti pelaporan/penerapan ruang logis dan jaminan ruang (tidak ada) dikelola secara otomatis oleh sistem. Tetapkan kebijakan tingkat volume untuk menggunakan tingkat otomatis yang ditetapkan di tingkat pool.
Vserver	Mengelola SVM (vserver) untuk akses file (SMB, NFS), blok (iSCSI, NVMe), dan objek (S3) ke volume. Mengelola kebijakan yang digunakan untuk volume seperti kebijakan ekspor untuk NFS. Mengaktifkan fitur SVM seperti audit logging (akses file), grup konsistensi, kebijakan, layanan nama (DNS, LDAP), dan antivirus (vscan). Membuat peering SVM untuk SnapMirror dan FlexCache.	vserver cifs create (bergabung ke domain Active Directory), vserver nfs create, vserver iscsi create, dan vserver nvme create - akses penuh vserver object-store-server - akses penuh	Gunakan perintah vserver modify untuk menyetel bahasa default, gaya keamanan, serta kebijakan snapshot dan kuota untuk semua volume. vserver create tidak didukung saat ini. Perintah perubahan sandi tidak dapat dijalankan secara interaktif dan harus ditentukan menggunakan parameter perintah, atau menggunakan REST API.
Perintah lama		zona waktu dan versi - akses penuh

Menghapus pool mode ONTAP

Untuk menghapus pool mode ONTAP, Anda harus menghapus semua volume di pool terlebih dahulu.