All Products
Search

This Product

    CloudOps Orchestration Service:Obtain the common parameters of an ECS image

    Document Center

    CloudOps Orchestration Service:Obtain the common parameters of an ECS image

    Last Updated:Jun 18, 2026

    Common parameters provided by CloudOps Orchestration Service (OOS) are managed and maintained by Alibaba Cloud, unlike regular parameters that you create yourself. These parameters store the latest system image IDs in an image family. You can call API operations and use parameter paths to obtain ECS image types for different operating systems, the common parameters for each distribution version, and image IDs.

    ECS image common parameters

    • Common parameter structure

      The common parameter aliyun/services/ecs/images/linux/centos-latest/centos_8_5_64 for a Linux ECS image consists of the path aliyun/services/ecs/images/linux/centos-latest/ and the parameter value centos_8_5_64. The structure breaks down as follows:

      • aliyun/services/ecs: Common parameter prefix, indicating the ECS parameter path.

      • /images: Second-level folder, indicating images.

      • /linux : Third-level folder, indicating the Linux operating system type.

      • /centos-latest: Fourth-level folder, indicating the latest CentOS system image.

      • /centos_8_5_64: Common parameter suffix, indicating a specific CentOS 8 image family.

    • Common parameter retrieval paths

      • Linux operating system: aliyun/services/ecs/images/linux

      • Windows operating system: aliyun/services/ecs/images/windows

    Prerequisites

    Alibaba Cloud CLI is installed and configured. If Alibaba Cloud CLI is not installed or configured, see:

    Note

    If you only need to perform temporary debugging operations, you do not need to install Alibaba Cloud CLI. You can use Cloud Shell provided by Alibaba Cloud to obtain information about cloud service hosts.

    1. Install Alibaba Cloud CLI.

    2. Configure Alibaba Cloud CLI.

      Configure parameters, such as credentials and regions, that are required to use Alibaba Cloud resources. For more information about how to configure the information, see Identity credential types.

    Procedure

    Obtain Linux operating system image common parameters

    Obtain supported Linux distributions

    To obtain all Linux system types under aliyun/services/ecs/images/, use GetParametersByPath with the following command:

    aliyun oos GetParametersByPath --Path aliyun/services/ecs/images/linux/

    Returns:

    {
    "MaxResults": 10,
    "Parameters": [
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-17T06:21:15Z",
    "Description": "",
    "Id": "p-b3881d719f624e56b0ea",
    "Name": "aliyun/services/ecs/images/linux/almalinux-latest",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-17T06:21:15Z",
    "Value": "almalinux-latest"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-17T06:21:15Z",
    "Description": "",
    "Id": "p-d8d12d8734924cd8800e",
    "Name": "aliyun/services/ecs/images/linux/debian-latest",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-17T06:21:15Z",
    "Value": "debian-latest"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-17T06:21:14Z",
    "Description": "",
    "Id": "p-1469bd95f1fa4676a7a9",
    "Name": "aliyun/services/ecs/images/linux/rockylinux-latest",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-17T06:21:14Z",
    "Value": "rockylinux-latest"
    }
    ],
    "RequestId": "xxxxxxxxxxxxxx"
}

    Obtain image common parameters of a Linux distribution

    Use GetParametersByPath to obtain all common parameters under the aliyun/services/ecs/images/linux/aliyun-latest/ path, which represents the latest Alibaba Cloud Linux images:

    aliyun oos GetParametersByPath --Path aliyun/services/ecs/images/linux/aliyun-latest/

    Returns:

    {
    "MaxResults": 10,
    "Parameters": [
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:25Z",
    "Description": "",
    "Id": "p-77246c47199c4a1da8bd",
    "Name": "aliyun/services/ecs/images/linux/aliyun-latest/alibaba_cloud_linux_2_1903_lts_64",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:25Z",
    "Value": "aliyun_2_1903_x64_20G_alibase_20230327.vhd"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:25Z",
    "Description": "",
    "Id": "p-0cb615ab447e43d78c8a",
    "Name": "aliyun/services/ecs/images/linux/aliyun-latest/alibaba_cloud_linux_3_2104_lts_64",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:25Z",
    "Value": "aliyun_3_x64_20G_alibase_20230327.vhd"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:24Z",
    "Description": "",
    "Id": "p-e4b81bf48c6b4a1194da",
    "Name": "aliyun/services/ecs/images/linux/aliyun-latest/alibaba_cloud_linux_3_2104_lts_64_arm",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:24Z",
    "Value": "aliyun_3_arm64_20G_alibase_20230327.vhd"
    }
    ],
    "RequestId": "xxxxxxxxxxxxxxxx"
}

    Obtain Linux image IDs

    To view detailed information about a specific image, use GetParameter. For example, to obtain details of aliyun/services/ecs/images/linux/aliyun-latest/alibaba_cloud_linux_3_2104_lts_64:

    aliyun oos GetParameter --Name aliyun/services/ecs/images/linux/aliyun-latest/alibaba_cloud_linux_3_2104_lts_64

    Returns:

    {
    "Parameter": {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:25Z",
    "Description": "",
    "Id": "p-0cb615ab447e43d78c8a",
    "Name": "aliyun/services/ecs/images/linux/aliyun-latest/alibaba_cloud_linux_3_2104_lts_64",
    "ParameterVersion": 1,
    "ResourceGroupId": "",
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:25Z",
    "Value": "aliyun_3_x64_20G_alibase_20230327.vhd"
    },
    "RequestId": "xxxxxxxxxxxxxxxx"
}

    Obtain Windows operating system image common parameters

    Obtain supported Windows distributions

    To obtain all Windows system types under aliyun/services/ecs/images/, use GetParametersByPath with the following command:

    aliyun oos GetParametersByPath --Path aliyun/services/ecs/images/windows/

    Returns:

    {
    "MaxResults": 10,
    "Parameters": [
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-17T06:21:12Z",
    "Description": "",
    "Id": "p-054efea36c844cd1bd13",
    "Name": "aliyun/services/ecs/images/windows/win2012r2-latest",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-17T06:21:12Z",
    "Value": "win2012r2-latest"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-17T06:21:12Z",
    "Description": "",
    "Id": "p-2739773e66cb453a8881",
    "Name": "aliyun/services/ecs/images/windows/win2019-latest",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-17T06:21:12Z",
    "Value": "win2019-latest"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-17T06:21:12Z",
    "Description": "",
    "Id": "p-dbbcc5339033469db729",
    "Name": "aliyun/services/ecs/images/windows/win2022-latest",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-17T06:21:12Z",
    "Value": "win2022-latest"
    }
    ],
    "RequestId": "xxxxxxxxxxxxxxxx"
}

    Obtain image common parameters of a Windows distribution

    Use GetParametersByPath to obtain all common parameters under the aliyun/services/ecs/images/windows/win2022-latest/ path, which represents the latest Windows 2022 images:

    aliyun oos GetParametersByPath --Path aliyun/services/ecs/images/windows/win2022-latest/

    Returns:

    {
    "MaxResults": 10,
    "Parameters": [
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:23Z",
    "Description": "",
    "Id": "p-135294c8fa0c468cb64c",
    "Name": "aliyun/services/ecs/images/windows/win2022-latest/win_2022_datacenter_64_en",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:23Z",
    "Value": "win2022_21H2_x64_dtc_en-us_40G_alibase_20230413.vhd"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:23Z",
    "Description": "",
    "Id": "p-c8d1adf990c64eb98426",
    "Name": "aliyun/services/ecs/images/windows/win2022-latest/win_2022_datacenter_64_ch",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:23Z",
    "Value": "win2022_21H2_x64_dtc_zh-cn_40G_alibase_20230413.vhd"
    },
    {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:23Z",
    "Description": "",
    "Id": "p-e139e998b54b4f60b6d5",
    "Name": "aliyun/services/ecs/images/windows/win2022-latest/win_2022_container_datacenter_64_en",
    "ParameterVersion": 1,
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:23Z",
    "Value": "win2022_21H2_x64_dtc_en-us_40G_container_alibase_20230413.vhd"
    }
    ],
    "RequestId": "xxxxxxxxxxxxxxxxx"
}

    Obtain Windows image IDs

    To view detailed information about a specific image, use GetParameter. For example, to obtain details of aliyun/services/ecs/images/windows/win2022-latest/win_2022_container_datacenter_64_en:

    aliyun oos GetParameter --Name aliyun/services/ecs/images/windows/win2022-latest/win_2022_container_datacenter_64_en

    Returns:

    {
    "Parameter": {
    "Constraints": "",
    "CreatedBy": "ACS",
    "CreatedDate": "2023-05-16T02:44:23Z",
    "Description": "",
    "Id": "p-e139e998b54b4f60b6d5",
    "Name": "aliyun/services/ecs/images/windows/win2022-latest/win_2022_container_datacenter_64_en",
    "ParameterVersion": 1,
    "ResourceGroupId": "",
    "ShareType": "Public",
    "Tags": {},
    "Type": "String",
    "UpdatedBy": "ACS",
    "UpdatedDate": "2023-05-16T02:44:23Z",
    "Value": "win2022_21H2_x64_dtc_en-us_40G_container_alibase_20230413.vhd"
    },
    "RequestId": "xxxxxxxxxxxxxxxxxx"
}