update_machine_group - Simple Log Service

Memodifikasi informasi grup mesin.

Sintaks permintaan

aliyunlog log update_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 update_machine_group.

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

Untuk informasi tentang parameter global dari antarmuka baris perintah (CLI) Layanan Log, lihat Parameter Global.

Contoh

Modifikasi file bernama machinegroup.json di mana nama grup mesin adalah 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	Pengidentifikasi 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 pengidentifikasi grup mesin. Nilai valid: ip: Grup mesin menggunakan alamat IP sebagai pengidentifikasi. userdefined: Grup mesin menggunakan ID kustom sebagai pengidentifikasi.
group_name	Nama grup mesin. Nama harus memenuhi persyaratan berikut: Nama harus unik dalam sebuah proyek. Nama hanya dapat berisi huruf kecil, digit, tanda hubung (-), dan garis bawah (_). Nama harus dimulai dan diakhiri dengan huruf kecil atau digit. 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 memodifikasi file konfigurasi grup mesin bernama group_name2.

aliyunlog log update_machine_group --project_name="aliyun-test-project" --group_detail="file://./machinegroup.json"

Kueri informasi grup mesin. Jalankan perintah berikut:

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

Keluaran berikut dikembalikan:

{
  "createTime": 1622105480,
  "groupAttribute": {
    "externalName": "",
    "groupTopic": "topic x",
    "osType": "",
    "policy": "",
    "region": ""
  },
  "groupName": "group_name2",
  "groupType": "",
  "lastModifyTime": 1622105480,
  "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

UpdateMachineGroup