DescribeImages
Query available image resources on AlibabaCloud by specifying ImageId, usage scenarios, and filters to manage and deploy instances efficiently.
Instructions
指定ImageId、镜像被使用场景、Filter过滤等参数,查询您可以使用的镜像资源列表。
Input Schema
Name | Required | Description | Default |
---|---|---|---|
ActionType | No | 镜像需要被使用到的场景。取值范围: - CreateEcs(默认):创建实例。 - ChangeOS:更换系统盘/更换操作系统。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:CreateEcs | |
Architecture | No | 镜像的体系架构。取值范围: - i386。 - x86_64。 - arm64。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:i386 | |
DryRun | No | 是否只预检此次请求。 - true:发送检查请求,不会查询资源状况。检查项包括AccessKey是否有效、RAM用户的授权情况和是否填写了必需参数。如果检查不通过,则返回对应错误。如果检查通过,会返回错误码DryRunOperation。 - false:发送正常请求,通过检查后返回2XX HTTP状态码并直接查询资源状况。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
Filter | No | 查询资源时的筛选条件列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
ImageFamily | No | 镜像族系名称,查询镜像时可通过设置该参数来过滤当前族系对应的镜像。 默认值:空。 > 阿里云官方镜像关联的镜像族系信息请参见[公共镜像概述](~~108393~~)。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:hangzhou-daily-update | |
ImageId | No | 镜像ID。 <details> <summary>镜像ID的命名规则</summary> - 公共镜像:以操作系统版本号、架构、语言和发布日期命名。例如,Windows Server 2008 R2企业版、64位英文系统的镜像ID为win2008r2_64_ent_sp1_en-us_40G_alibase_20190318.vhd。 - 自定义镜像、共享镜像、云市场镜像、社区镜像的镜像:以m开头。 </details> 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:m-bp1g7004ksh0oeuc**** | |
ImageName | No | 镜像名称。支持模糊搜索。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:testImageName | |
ImageOwnerAlias | No | 镜像来源。取值范围: - system:阿里云官方提供的,且不是通过云市场发布的镜像,和控制台中的“公共镜像”概念不同。 - self:您创建的自定义镜像。 - others:包含共享镜像(其他阿里云用户直接共享给您的镜像)和社区镜像(任意阿里云用户将其自定义镜像完全公开共享后的镜像)。您需要注意: - 查找社区镜像时,IsPublic必须为true。 - 查找共享镜像时,IsPublic需要设置为false或者不传值。 - marketplace:阿里云或者第三方供应商ISV在云市场发布的镜像,需要和ECS一起购买。请自行留意云市场镜像的收费详情。 默认值:空。 >空表示返回取值为system、self以及others的结果。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:self | |
ImageOwnerId | No | 镜像所属的阿里云账号ID。该参数仅在查询共享镜像以及社区镜像时生效。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:20169351435666**** | |
InstanceType | No | 为指定的实例规格查询可以使用的镜像。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:ecs.g5.large | |
IsPublic | No | 是否查询已发布的社区镜像。取值范围: - true:查询已发布的社区镜像。当您指定该参数值为true时,ImageOwnerAlias必须为others。 - false:查询除社区镜像的其他镜像类型,具体以ImageOwnerAlias参数值为准。 默认值:false。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
IsSupportCloudinit | No | 镜像是否支持cloud-init。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
IsSupportIoOptimized | No | 镜像是否可以运行在I/O优化实例上。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:true | |
OSType | No | 镜像的操作系统类型。取值范围: - windows。 - linux。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:linux | |
PageNumber | No | 镜像资源列表的页码。 起始值:1。 默认值:1。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:1 | |
PageSize | No | 分页查询时设置的每页行数。 最大值:100。 默认值:10。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: integer,参数示例:10 | |
RegionId | Yes | 镜像所属的地域ID。您可以调用[DescribeRegions](~~25609~~)查看最新的阿里云地域列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:cn-hangzhou | |
ResourceGroupId | No | 自定义镜像所在的企业资源组ID。使用该参数过滤资源时,资源数量不能超过1000个。 >不支持默认资源组过滤。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:rg-bp67acfmxazb4p**** | |
ShowExpired | No | 订阅型镜像是否已经超过使用期限。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: boolean,参数示例:false | |
SnapshotId | No | 根据某一快照ID创建的自定义镜像。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:s-bp17ot2q7x72ggtw**** | |
Status | No | 查询指定状态的镜像,如果不配置此参数,默认只返回Available状态的镜像。取值范围: - Creating:镜像正在创建中。 - Waiting:多任务排队中。 - Available(默认):您可以使用的镜像。 - UnAvailable:您不能使用的镜像。 - CreateFailed:创建失败的镜像。 - Deprecated:已弃用的镜像。 默认值:Available。当前参数支持同时取多个值,值之间以半角逗号(,)隔开。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:Available | |
Tag | No | 标签列表。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: array,参数示例: | |
Usage | No | 镜像是否已经运行在ECS实例中。取值范围: - instance:镜像处于运行状态,有ECS实例使用。 - none:镜像处于闲置状态,暂无ECS实例使用。 请注意,提供参数要严格按照参数的类型和参数示例的提示,如果提到参数为String,且为一个 JSON 数组字符串,应在数组内使用单引号包裹对应的参数以避免转义问题,并在最外侧用双引号包裹以确保其是字符串,否则可能会导致参数解析错误。参数类型: string,参数示例:instance |
Input Schema (JSON Schema)
You must be authenticated.
Other Tools from AlibabaCloud MCP Server
- DeleteBucket
- DeleteInstances
- DescribeAccountAttributes
- DescribeAvailableResource
- DescribeDBInstances
- DescribeImages
- DescribeInstances
- DescribeRegions
- DescribeSecurityGroups
- DescribeVpcs
- DescribeVSwitches
- DescribeZones
- GetCpuloadavg15mData
- GetCpuloadavg5mData
- GetCpuLoadavgData
- GetCpuUsageData
- GetDiskTotalData
- GetDiskUsageData
- GetDiskUsedData
- GetMemUsageData
- GetMemUsedData
- ListBuckets
- ListObjects
- PutBucket
- RebootInstances
- RebootRDSInstances
- ReplaceSystemDisk
- ResetPassword
- RunCommand
- RunInstances
- StartInstances
- StartRDSInstances
- StopInstances
- StopRDSInstances
Related Tools
- @aliyun/alibabacloud-ecs-mcp-server
- @aliyun/alibabacloud-core-mcp-server
- @aliyun/alibabacloud-core-mcp-server
- @aliyun/alibabacloud-core-mcp-server
- @aliyun/alibabacloud-core-mcp-server