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:May 06, 2025

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

    ECS image common parameters

    • Common parameter structure

      Take the common parameters of a Linux operating system ECS image as an example, such as aliyun/services/ecs/images/linux/centos-latest/centos_8_5_64. In this example, aliyun/services/ecs/images/linux/centos-latest/ is the path of this common parameter, and centos_8_5_64 is a specific parameter value. The common parameter structure consists of the following components:

      • aliyun/services/ecs: The common parameter prefix, which indicates the common parameter path of ECS.

      • /images: The second-level folder, which indicates images.

      • /linux : The third-level folder, which indicates that the operating system type is Linux.

      • /centos-latest: The fourth-level folder, which indicates the latest CentOS system image.

      • /centos_8_5_64: The common parameter suffix, which indicates 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 of aliyun/services/ecs/images/, you can use GetParametersByPath and run 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 of 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 the detailed information of a specific image, you can use GetParameter. For example, to obtain the detailed information 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/, you can use GetParametersByPath and run 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 of 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 the detailed information of a specific image, you can use GetParameter. For example, to obtain the detailed information 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"
}