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 Google Proxy API untuk panggilan ONTAP REST API.

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

Menggunakan Google Proxy API untuk panggilan ONTAP REST API

NetApp Volumes menyediakan endpoint Google API untuk setiap kumpulan penyimpanan mode FlexUnified 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/v1beta1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL

URL ini terdiri dari elemen berikut:

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

Ganti informasi berikut:
- PROJECT: project ID atau nomor 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/v1beta1/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/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' 

   --header "Authorization: Bearer $TOKEN" 

   --header "Content-Type: application/json"

Membuat volume

Bagian ini menunjukkan cara membuat volume bernama myvolume di kumpulan penyimpanan mode Flex Unified 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/v1beta1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.
Buat payload permintaan.

Gunakan payload contoh 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 mesin virtual (SVM) penyimpanan 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 SVM dan nama gabungan:
1. Gunakan ontap_fields untuk pemilihan kolom: di kumpulan mode NetApp Volumes ONTAP, gunakan parameter kueri ontap_fields=, bukan parameter ONTAP fields= 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/v1beta1/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/v1beta1/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.

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 tugas:

{
  "body": {
    "job": {
      "_links": {
        "self": {
          "href": "curl --location
'https://netapp.googleapis.com/v1beta1/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/v1beta1/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 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, tindakan ini menunjukkan cara memantau tugas ONTAP hingga resource dibuat. Dengan pendekatan ini, Anda dapat mengontrol sebagian besar setelan ONTAP untuk pool penyimpanan Anda.

Tindakan ONTAP yang diizinkan

Saat mengakses kumpulan melalui proxy API atau CLI, Anda memiliki izin terbatas dan tidak dapat menjalankan semua perintah ONTAP. Tindakan ini melindungi integritas sistem. 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.

Menghapus pool mode ONTAP

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