赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 日志服务
  4. 开发参考
  5. 日志服务SDK
  6. Python SDK
  7. 采集日志
  8. 管理机器组
  9. 创建机器组

创建机器组

  • 管理机器组
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

调用CreateMachineGroup接口创建一个机器组。

前提条件

您已完成以下操作:

  • 开通日志服务。

  • 初始化日志服务Python SDK。

参数说明

def create_machine_group(self, project_name, group_detail):

请求参数

名称

类型

是否必填

说明

project_name

String

是

Project名称:项目(Project)是日志服务的资源管理单元,是进行多用户隔离与访问控制的主要边界。更多信息,请参见管理Project。

group_detail

MachineGroupDetail

是

机器组配置信息。

MachineGroupDetail参数说明:

名称

类型

是否必填

说明

group_name

String

是

机器组名称。命名规则如下:

  • 只能包括小写字母、数字、短划线(-)和下划线(_)。

  • 必须以小写字母或者数字开头和结尾。

  • 长度必须在 2~128 字符之间。

machine_type

String

是

机器组标识。

  • ip:IP地址机器组。

  • userdefined:用户自定义标识机器组。

machine_list

List

是

机器组列表。

  • 如果machine_type配置为IP,则此处填写IP地址,此IP地址为Logtail自动获取的服务器IP地址。更多信息,请参见管理机器组。

  • 如果machine_type配置为userdefined,则此处填写自定义的标识。更多信息,请参见管理机器组。

返回参数

返回参数请参见:CreateMachineGroup - 创建机器组。

示例代码

from aliyun.log import LogClient, MachineGroupDetail
import os

# 本示例从环境变量中获取AccessKey ID和AccessKey Secret
access_key_id = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_ID', '')
access_key_secret = os.environ.get('ALIBABA_CLOUD_ACCESS_KEY_SECRET', '')
# 日志服务的服务接入点
endpoint = "cn-hangzhou.log.aliyuncs.com"

# 实例化LogClient类
client = LogClient(endpoint, access_key_id, access_key_secret)

project_name = "proj-test-1"


def main():
    group_name="group-1"
    machine_type = "ip"
    machine_list = ['192.168.0.10', '192.168.0.30']
    # 实例化MachineGroupDetail类
    group_detail = MachineGroupDetail(group_name, machine_type, machine_list)
    # 创建机器组
    res = client.create_machine_group(project_name, group_detail)
    res.log_print()


if __name__ == '__main__':
    main()

示例返回结果

CreateMachineGroupResponse:
headers: {'Server': 'AliyunSLS', 'Content-Length': '0', 'Connection': 'keep-alive', 'Access-Control-Allow-Origin': '*', 'Date': 'Tue, 15 Oct 2024 03:04:40 GMT', 'x-log-time': '1728961480', 'x-log-requestid': '670DDBC86930C98F86C6****'}

Process finished with exit code 0

相关文档

  • 管理机器组的API请参见:

    • CreateMachineGroup - 创建机器组

    • DeleteMachineGroup - 删除机器组

    • RemoveConfigFromMachineGroup - 删除机器组Logtail配置

    • ApplyConfigToMachineGroup - 应用Logtail配置到机器组

    • UpdateMachineGroup - 修改机器组

    • UpdateMachineGroupMachine - 修改机器组机器列表

    • ListMachineGroup - 查询Project下的机器组

    • ListMachines - 查询机器组中的机器列表

    • GetMachineGroup - 获取机器组配置

    • GetAppliedConfigs - 获取已应用的Logtail配置列表

    • GetAppliedMachineGroups - 通过Logtail配置获取已绑定的机器组

  • 更多示例代码,请参见Aliyun Log Python SDK on GitHub。

相关文章

创建机器组 2025-04-22 10:35

调用CreateMachineGroup接口创建一个机器组。 前提条件 您已完成以下操作:

更新机器组 2025-04-22 10:35

调用UpdateMachineGroup接口更新机器组配置信息。 前提条件 您已完成以下操作:

删除机器组 2025-04-22 10:35

调用DeleteMachineGroup接口删除机器组。如果机器组已应用Logtail采集配置,则删除机器组后,会解绑对应的Logtail配置。 前提条件 您已完成以下操作:

查询指定Project的机器组 2025-04-22 10:35

调用ListMachineGroup接口列出目标Project下的机器组。 前提条件 您已完成以下操作:

查询机器组的机器列表 2025-04-22 10:35

调用ListMachines接口列出机器组中与日志服务连接正常的机器列表。 前提条件 您已完成以下操作:

获取机器组配置 2025-04-22 10:35

调用GetMachineGroup接口获取目标机器组的具体信息。 前提条件 您已完成以下操作:

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号