create_machine_group - Simple Log Service

Membuat grup mesin.

Sintaks permintaan

aliyunlog log create_machine_group --project_name=<nilai> --group_detail=<nilai> [--access-id=<nilai>] [--access-key=<nilai>] [--sts-token=<nilai>] [--region-endpoint=<nilai>] [--client-name=<nilai>] [--jmes-filter=<nilai>] [--format-output=<nilai>] [--decode-output=<nilai>]

Parameter permintaan

Tabel berikut menjelaskan parameter yang diperlukan dan spesifik untuk perintah create_machine_group.

Parameter	Tipe	Diperlukan	Contoh	Deskripsi
--project_name	String	Ya	aliyun-test-project	Nama proyek.
--group_detail	Objek JSON	Ya	file://./machinegroup.json	Path file konfigurasi untuk grup mesin.

Untuk informasi tentang parameter global Antarmuka Baris Perintah (CLI) Layanan Log, lihat Parameter Global.

Contoh

Buat file bernama machinegroup.json dengan nama grup mesin group_name2. Contoh berikut menunjukkan isi file machinegroup.json:

{
  "machine_list": [
    "machine1",
    "machine2"
  ],
  "machine_type": "userdefined",
  "group_name": "group_name2",
  "group_type": "",
  "group_attribute": {
    "groupTopic": "topic x"
  }
}

Tabel berikut menjelaskan parameter.

Parameter	Deskripsi
machine_list	Pengenal server dalam grup mesin. Jika Anda mengatur parameter machineIdentifyType ke ip, masukkan alamat IP server dalam grup mesin. Jika Anda mengatur parameter machineIdentifyType ke userdefined, masukkan ID kustom. Untuk informasi lebih lanjut tentang cara mengonfigurasi ID kustom, lihat Buat grup mesin berbasis ID kustom.
machine_type	Tipe pengenal grup mesin. Nilai valid: ip: Grup mesin menggunakan alamat IP sebagai pengenal. userdefined: Grup mesin menggunakan ID kustom sebagai pengenal.
group_name	Nama grup mesin. Nama harus memenuhi persyaratan berikut: Nama harus unik dalam sebuah proyek. Nama hanya dapat berisi huruf kecil, angka, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dan diakhiri dengan huruf kecil atau angka. Nama harus memiliki panjang 3 hingga 128 karakter.
group_type	Tipe grup mesin. Nilai valid: null.
group_attribute	Atribut grup mesin. Untuk informasi lebih lanjut tentang parameter group_attribute, lihat tabel berikut.

Tabel berikut menjelaskan parameter dalam group_attribute.

Parameter	Deskripsi
groupTopic	Topik grup mesin.

Gunakan akun default untuk membuat grup mesin bernama group_name2.
```
aliyunlog log create_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"
```
Setelah menjalankan perintah, tidak ada respons yang dikembalikan.

Kueri grup mesin yang telah dibuat. Jalankan perintah berikut:

aliyunlog log get_machine_group --project_name="aliyun-test-project" --group_name="group_name2"

Keluaran berikut akan dikembalikan:

{
  "createTime": 1622104319,
  "groupAttribute": {
    "externalName": "",
    "groupTopic": "topic x",
    "osType": "",
    "policy": "",
    "region": ""
  },
  "groupName": "group_name2",
  "groupType": "",
  "lastModifyTime": 1622104319,
  "machineIdentifyType": "userdefined",
  "machineList": [
    "machine1",
    "machine2"
  ]
}

Kode kesalahan

Jika pesan kesalahan dikembalikan, perbaiki kesalahan berdasarkan kode kesalahan operasi API terkait. Untuk informasi lebih lanjut, lihat Kode Kesalahan.

Referensi API

CreateMachineGroup