你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Bicep 资源定义
可以使用目标操作部署 ec2Images 资源类型：
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.AwsConnector/ec2Images 资源，请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.AwsConnector/ec2Images@2024-12-01' = {
location: 'string'
name: 'string'
properties: {
arn: 'string'
awsAccountId: 'string'
awsProperties: {
architecture: {
value: 'string'
}
blockDeviceMappings: [
{
deviceName: 'string'
ebs: {
deleteOnTermination: bool
encrypted: bool
iops: int
kmsKeyId: 'string'
outpostArn: 'string'
snapshotId: 'string'
throughput: int
volumeSize: int
volumeType: {
value: 'string'
}
}
noDevice: 'string'
virtualName: 'string'
}
]
bootMode: {
value: 'string'
}
creationDate: 'string'
deprecationTime: 'string'
deregistrationProtection: 'string'
description: 'string'
enaSupport: bool
hypervisor: {
value: 'string'
}
imageId: 'string'
imageLocation: 'string'
imageOwnerAlias: 'string'
imageType: {
value: 'string'
}
imdsSupport: {
value: 'string'
}
kernelId: 'string'
lastLaunchedTime: 'string'
name: 'string'
ownerId: 'string'
platform: {
value: 'string'
}
platformDetails: 'string'
productCodes: [
{
productCodeId: 'string'
productCodeType: {
value: 'string'
}
}
]
public: bool
ramdiskId: 'string'
rootDeviceName: 'string'
rootDeviceType: {
value: 'string'
}
sourceInstanceId: 'string'
sriovNetSupport: 'string'
state: {
value: 'string'
}
stateReason: {
code: 'string'
message: 'string'
}
tags: [
{
key: 'string'
value: 'string'
}
]
tpmSupport: {
value: 'string'
}
usageOperation: 'string'
virtualizationType: {
value: 'string'
}
}
awsRegion: 'string'
awsSourceSchema: 'string'
awsTags: {
{customized property}: 'string'
}
publicCloudConnectorsResourceId: 'string'
publicCloudResourceName: 'string'
}
tags: {
{customized property}: 'string'
}
}
属性值
Microsoft.AwsConnector/ec2Images
| 名字 | 描述 | 价值 |
|---|---|---|
| 位置 | 资源所在的地理位置 | string （必需） |
| 名字 | 资源名称 | 字符串 约束： 模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) （必需） |
| 性能 | 此资源的资源特定属性。 | Ec2Image属性 |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
ArchitectureValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “arm64” “arm64_mac” “i386” “x86_64” “x86_64_mac” |
AwsEc2ImageProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| 建筑 | <p>映像的体系结构。</p> | ArchitectureValuesEnumValue |
| blockDeviceMappings | <p>任何块设备映射条目。</p> | BlockDeviceMapping[] |
| bootMode 引导模式 | <p>映像的启动模式。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-boot.htmlAmazon EC2 用户指南>/i<中的>启动模式</> a <href='>'>启动模式。>/p | BootModeValuesEnumValue |
| 创建日期 | <p>创建映像的日期和时间。</p> | 字符串 |
| 弃用时间 | <p>UTC 格式弃用 AMI 的日期和时间， 采用以下格式：<i>YYYY</i>-<i>MM</i>-<i>DD</i<<T>i<HH>/i<：>i<MM>/i<：>i<SS>/iZ。 如果为秒指定了值，Amazon EC2 会将秒舍入到最接近的分钟。</p> | 字符串 |
| deregistrationProtection | <p>指示是否为 AMI 启用取消注册保护。</p> | 字符串 |
| 描述 | <p>映像创建过程中提供的 AMI 的说明。</p> | 字符串 |
| ena支持 | <p>指定是否启用了增强的网络与 ENA。</p> | 布尔 |
| 虚拟机监控程序 | <p>映像的虚拟机监控程序类型。 仅支持<xen>/code<>代码。 不支持 <ovm>/code<>代码。</p> | HypervisorTypeEnumValue |
| 图像 ID | <p>AMI 的 ID。</p> | 字符串 |
| imageLocation | <p>AMI 的位置。</p> | 字符串 |
| imageOwner别名 | <p>所有者别名（<代码>amazon</code> | <代码>aws-marketplace</code>）。</p> | 字符串 |
| 图像类型 | <p>图像类型。</p> | ImageTypeValuesEnumValue |
| imds支持 | <p>如果 <代码>v2.0</code>，则表示在 AMI 中指定了 IMDSv2。 从此 AMI 启动的实例将具有 <代码>HttpTokens</code> 自动设置为 <代码>所需的</code>，以便默认情况下，实例要求在请求实例元数据时使用 IMDSv2。 此外，<代码>HttpPutResponseHopLimit</code> 设置为 <代码>2</code>。 有关详细信息，请参阅 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration>>>i<Amazon EC2 用户指南>/i<中配置 AMI>/a<。>/p | ImdsSupportValuesEnumValue |
| 内核 ID | <p>与映像关联的内核（如果有）。 仅适用于计算机映像。</p> | 字符串 |
| lastLaunchedTime （上次发布时间） | <p>日期和时间，在上次使用 AMI 启动 EC2 实例时，<href='http://www.iso.org/iso/iso8601>ISO 8601 日期/<格式>>ISO 8601 日期/<。 当 AMI 用于启动实例时，在报告该使用情况之前有 24 小时延迟。自 2017 年 4 月起，<>p<>代码<lastLaunchedTime>/code< 数据>/<>p 注释。</p></note> | 字符串 |
| 名字 | <p>映像创建过程中提供的 AMI 的名称。</p> | 字符串 |
| 所有者 ID | <p>拥有映像的 Amazon Web Services 帐户的 ID。</p> | 字符串 |
| 平台 | <p>此值设置为 windows<windows>/code<>代码;否则为空。</p> | PlatformValuesEnumValue |
| 平台详情 | <p>与 AMI 计费代码关联的平台详细信息。 有关详细信息，请参阅 <amazon EC2 用户指南https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-billing-info.html/i><>中的<<了解 AMI 计费信息</a><href='>。/p | 字符串 |
| 产品代码 | <p>与 AMI 关联的任何错误代码。</p> | 产品代码 |
| 公共 | <p>指示映像是否具有公共启动权限。 如果此映像具有公共启动权限或 <代码>false</code>，则该值<true>/code< true >代码。</p> | 布尔 |
| ramdiskId | <p>与映像关联的 RAM 磁盘（如果有）。 仅适用于计算机映像。</p> | 字符串 |
| rootDevice名称 | <p>根设备卷的设备名称（例如，<代码>/dev/sda1</code>）。</p> | 字符串 |
| rootDeviceType | <p>AMI 使用的根设备的类型。 AMI 可以使用 Amazon EBS 卷或实例存储卷。</p> | DeviceTypeEnumValue |
| 源实例 ID | <p>使用 href='<' https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html>CreateImage</a /a>创建 AMI 时创建的实例的 ID。 仅当使用 CreateImage 创建 AMI 时，才会显示此字段。</p> | 字符串 |
| sriovNet支持 | <p>指定是否启用了 Intel 82599 虚拟函数接口的增强网络。</p> | 字符串 |
| 州 | <p>AMI 的当前状态。 如果状态 <代码>可用的</code>，则映像已成功注册，并可用于启动实例。</p> | ImageStateEnumValue |
| stateReason （状态原因） | <p>状态更改的原因。</p> | StateReason |
| 标签 | <p>分配给映像的任何标记。</p> | 标签自动生成11 |
| tpm支持 | <p>如果为 NitroTPM 支持配置映像，则该值<v2.0>/code<>代码。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nitrotpm.htmlAmazon EC2 用户指南>/i<中的>NitroTPM</a><href='>。</p> | TpmSupportValuesEnumValue |
| usageOperation | <p>Amazon EC2 实例的操作以及与 AMI 关联的计费代码。 <代码>usageOperation</code><对应于 Amazon Web Services 成本和使用情况报告中的https://docs.aws.amazon.com/cur/latest/userguide/Lineitem-columns.html#Lineitem-details-O-Operation>行项/操作</操作</< 列以及 https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.htmlhref='>'<Amazon Web Services 价目表 API>/a。 可以在 Amazon EC2 控制台中的 <b>实例</b> 或 <b>ACI</b> 页上查看这些字段， 或在 amazon EC2 API 中的 <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html'>DescribeImages</a> 命令返回的响应中，或 <href='https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html'>describe-images</a /a> 命令在 CLI 中。</p> | 字符串 |
| virtualizationType | <p>AMI 的虚拟化类型。</p> | VirtualizationTypeEnumValue |
BlockDeviceMapping
| 名字 | 描述 | 价值 |
|---|---|---|
| deviceName （设备名称） | <p>设备名称（例如，<代码>/dev/sdh</code> 或 <代码>xvdh</code>）。</p> | 字符串 |
| EBS | <p>参数，用于在启动实例时自动设置 EBS 卷。</p> | EbsBlock设备 |
| 无设备 | <p>若要从块设备映射中省略设备，请指定一个空字符串。 指定此属性后，无论分配的值如何，设备都会从块设备映射中删除。</p> | 字符串 |
| 虚拟名称 | <p>虚拟设备名称（<代码>临时</code>N）。 实例存储卷从 0 开始编号。 具有 2 个可用实例存储卷的实例类型可以为 <代码>临时代码</code> 指定映射，<代码>临时 1</code>。 可用实例存储卷的数量取决于实例类型。 连接到实例后，必须装载卷。</p><p>NVMe 实例存储卷会自动枚举并分配设备名称。 在块设备映射中包括它们不起作用。</p><p>约束：对于 M3 实例，必须在实例的块设备映射中指定实例存储卷。 启动 M3 实例时，我们将忽略 AMI 块设备映射中指定的任何实例存储卷。</p> | 字符串 |
BootModeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “legacy-bios” “uefi” “uefi-preferred” |
DeviceTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “ebs” “instance-store” |
EbsBlock设备
| 名字 | 描述 | 价值 |
|---|---|---|
| deleteOnTermination | <p>指示在实例终止时是否删除 EBS 卷。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#preserving-volumes-on-terminationAmazon EC2 用户指南>/i<>/< a>保留 Amazon EBS 卷<>href='<。>/p | 布尔 |
| 加密 | <p>指示从备份快照还原时 EBS 卷的加密状态是否已更改。 将加密状态设置为 <代码>true</code> 的效果取决于卷源（新源或快照），启动加密状态、所有权以及默认是否启用加密。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html#encryption-parametersAmazon EBS 用户指南>/i>/i>中的 <href='>'<Amazon EBS 加密>/a<。>/p<>p<在任何情况下，都无法从加密卷中删除加密。>/p<>p加密卷只能附加到支持 Amazon EBS 加密的实例。 有关详细信息，请参阅 <href='https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption-requirements.html#ebs-encryption_supported_instances'>支持的实例类型</a /a>。</p><p>此参数不由 <>DescribeImageAttribute</a>返回。</p><p>For <>CreateImage</a>，<>RegisterImage</a>，是否可以包含此参数，允许的值因所创建的块设备映射类型而异。</p><ul><li><p>如果要为 <b>新的 （空） 卷</b>创建块设备映射，可以包括此参数， 并为加密卷指定 <代码>true</code>，或为未加密卷<false>/code<>代码。 如果省略此参数，则默认 <代码>false</code>（未加密）。</p></li><li><p>如果要从 <b>现有加密或未加密快照</b>创建块设备映射，则必须省略此参数。 如果包含此参数，则无论指定的值如何，请求都会失败。</p></li><li><p>如果要从 <b>现有未加密卷</b>创建块设备映射，则可以包含此参数，但必须指定 <代码>false</code>。 如果指定 <代码>true</code>，则请求将失败。 在这种情况下，建议省略参数。</p></li><li><p>如果要从 <b 创建块设备映射，>现有加密卷</b>，可以包括此参数， 并指定 <代码>true</code>，或 <代码>false</code>。 但是，如果指定 <代码>false</code>，则忽略参数，并且块设备映射始终加密。 在这种情况下，建议省略参数。</p></li></ul> | 布尔 |
| IOPS （国际速率） | <p>每秒 I/O 操作数（IOPS）。 对于 <代码>gp3</code>，<代码>io1</code>，<代码>io2</code> 卷，这表示为卷预配的 IOPS 数。 对于 <代码>gp2</code> 卷，这表示卷的基线性能以及卷累积 I/O 信用额度的速率。</p><p>以下是每种卷类型的支持值：</p><ul><li><p><代码>gp3</code>>： 3,000 - 16,000 IOPS>/p<>/li<>li<>p<>代码<io1>/code<： 100 - 64,000 IOPS>/p<>/li<>li<>p<>代码<io2>/code<： 100 - 256,000 IOPS>/p<>/li<>/ul<>p<对于 >代码<io2>/code< 卷， https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instanceshref='>'<实例上，>/a /a，可以在 实现高达 256,000 IOPS。 在其他实例上，可以实现高达 32,000 IOPS 的性能。</p><p><代码>io1</code> 和 <代码>io2</code> 卷需要此参数。 <代码>gp3</code> 卷的默认值为 3,000 IOPS。</p> | 整数 (int) |
| kmsKeyId | <p>标识符（密钥 ID、密钥别名、ID ARN 或别名 ARN）用于对 EBS 卷进行加密的客户托管 CMK。</p><p>此参数仅在 <代码>BlockDeviceMapping</code> 对象上受支持，<href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html'>RunInstances</a>，<href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html'>RequestSpotFleet</a>， <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html'>RequestSpotInstances</a /a>。</p> | 字符串 |
| 前哨Arn | <p>存储快照的前哨的 ARN。</p><p>使用 <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html'>CreateImage</a>时，不支持此参数。</p> | 字符串 |
| 快照 ID | <p>快照的 ID。</p> | 字符串 |
| 吞吐量 | <p>MiB/s 中卷支持的吞吐量，</p><p>此参数仅适用于<gp3>/code< 卷 >代码。</p><p>有效范围：最小值为 125。 最大值为 1000。</p> | 整数 (int) |
| 体积大小 | <p>卷的大小（以 GiB 为单位）。 必须指定快照 ID 或卷大小。 如果指定快照，则默认值为快照大小。 可以指定等于或大于快照大小的卷大小。</p><p>以下每种卷类型支持的大小：</p><ul><li><p><代码>gp2</code> 和 <代码>gp3</code>： 1 - 16,384 GiB</p></li><li><p><code>io1</code>： 4 - 16,384 GiB</p></li><li><p><code>io2</code>： 4 - 65,536 GiB</p></li><li><p><code>st1</code> 和 <code>sc1</code>： 125 - 16,384 GiB</p></li><li><p><代码>标准</code>： 1 - 1024 GiB</p></li></ul> | 整数 (int) |
| 音量类型 | <p>卷类型。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html>Amazon EBS 用户指南</i></a><href='>'>'>。/p | VolumeTypeEnumValue |
Ec2Image属性
| 名字 | 描述 | 价值 |
|---|---|---|
| 阿恩 | Amazon 资源名称 （ARN） | 字符串 |
| awsAccountId | AWS 帐户 ID | 字符串 |
| awsProperties | AWS 属性 | AwsEc2ImageProperties |
| awsRegion | AWS 区域 | 字符串 |
| awsSourceSchema | AWS 源架构 | 字符串 |
| aws标签 | AWS 标记 | Ec2ImagePropertiesAwsTags |
| publicCloudConnectorsResourceId | 公有云连接器资源 ID | 字符串 |
| publicCloudResourceName （公共云资源名称） | 公有云资源名称 | 字符串 |
Ec2ImagePropertiesAwsTags
| 名字 | 描述 | 价值 |
|---|
HypervisorTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “ovm” “xen” |
ImageStateEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “available” “deregistered” “disabled” “error” “failed” “invalid” “pending” “暂时性” |
ImageTypeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “kernel” “machine” “ramdisk” |
ImdsSupportValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “v2.0” |
PlatformValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “Windows” |
产品代码
| 名字 | 描述 | 价值 |
|---|---|---|
| productCodeId 产品代码 ID | <p>产品代码。</p> | 字符串 |
| productCodeType | <p>产品代码的类型。</p> | ProductCodeValuesEnumValue |
ProductCodeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “devpay” “marketplace” |
StateReason
| 名字 | 描述 | 价值 |
|---|---|---|
| 法典 | <p>状态更改的原因代码。</p> | 字符串 |
| 消息 | <p>状态更改的消息。</p><ul><li><p><>server.InsufficientInstanceCapacity</code>：没有足够的容量来满足启动请求。</p></li><li><p><code>Server.InternalError</code>：导致实例在启动期间终止的内部错误。</p></li><li><p><code>Server.ScheduledStop</code>：由于计划停用，实例已停止。</p></li><li><p><代码>Server.SpotInstanceShutdown</code>：实例已停止，因为最高价格等于或高于现价的现成请求数超过了可用容量，或者由于现价上涨。</p></li><li><p><代码>Server.SpotInstanceTermination</code>：实例已终止，因为最高价格等于或高于现价的现成请求数超过了可用容量，或者由于现价上涨。</p></li><li><p><code>Client.InstanceInitiatedShutdown</code>：实例已从实例的操作系统关闭。</p></li><li><p><code>Client.InstanceTerminated</code>：实例在 AMI 创建期间终止或重新启动。</p></li><li><p><代码>Client.InternalError</code>：客户端错误导致实例在启动期间终止。</p></li><li><p><code>Client.InvalidSnapshot.NotFound</code>：找不到指定的快照。</p></li><li><p><code>Client.UserInitiatedHibernate</code>：在实例上启动休眠。</p></li><li><p><code>Client.UserInitiatedShutdown</code>：实例已使用 Amazon EC2 API 关闭。</p></li><li><p><代码>Client.VolumeLimitExceed</code>：超出 EBS 卷数或总存储数的限制。 减少使用情况或请求增加帐户限制。</p></li></ul> | 字符串 |
标签自动生成11
| 名字 | 描述 | 价值 |
|---|---|---|
| 钥匙 | <p>标记的键。</p><p>约束：标记键区分大小写，最多接受 127 个 Unicode 字符。 可能不以 <代码>aws 开头：</code>。</p> | 字符串 |
| 价值 | <p>标记的值。</p><p>约束：标记值区分大小写，最多接受 256 个 Unicode 字符。</p> | 字符串 |
TpmSupportValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “v2.0” |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
VirtualizationTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “hvm” “paravirtual” |
VolumeTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “gp2” “gp3” “io1” “io2” “sc1” “st1” “standard” |
ARM 模板资源定义
可以使用目标操作部署 ec2Images 资源类型：
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.AwsConnector/ec2Images 资源，请将以下 JSON 添加到模板。
{
"type": "Microsoft.AwsConnector/ec2Images",
"apiVersion": "2024-12-01",
"name": "string",
"location": "string",
"properties": {
"arn": "string",
"awsAccountId": "string",
"awsProperties": {
"architecture": {
"value": "string"
},
"blockDeviceMappings": [
{
"deviceName": "string",
"ebs": {
"deleteOnTermination": "bool",
"encrypted": "bool",
"iops": "int",
"kmsKeyId": "string",
"outpostArn": "string",
"snapshotId": "string",
"throughput": "int",
"volumeSize": "int",
"volumeType": {
"value": "string"
}
},
"noDevice": "string",
"virtualName": "string"
}
],
"bootMode": {
"value": "string"
},
"creationDate": "string",
"deprecationTime": "string",
"deregistrationProtection": "string",
"description": "string",
"enaSupport": "bool",
"hypervisor": {
"value": "string"
},
"imageId": "string",
"imageLocation": "string",
"imageOwnerAlias": "string",
"imageType": {
"value": "string"
},
"imdsSupport": {
"value": "string"
},
"kernelId": "string",
"lastLaunchedTime": "string",
"name": "string",
"ownerId": "string",
"platform": {
"value": "string"
},
"platformDetails": "string",
"productCodes": [
{
"productCodeId": "string",
"productCodeType": {
"value": "string"
}
}
],
"public": "bool",
"ramdiskId": "string",
"rootDeviceName": "string",
"rootDeviceType": {
"value": "string"
},
"sourceInstanceId": "string",
"sriovNetSupport": "string",
"state": {
"value": "string"
},
"stateReason": {
"code": "string",
"message": "string"
},
"tags": [
{
"key": "string",
"value": "string"
}
],
"tpmSupport": {
"value": "string"
},
"usageOperation": "string",
"virtualizationType": {
"value": "string"
}
},
"awsRegion": "string",
"awsSourceSchema": "string",
"awsTags": {
"{customized property}": "string"
},
"publicCloudConnectorsResourceId": "string",
"publicCloudResourceName": "string"
},
"tags": {
"{customized property}": "string"
}
}
属性值
Microsoft.AwsConnector/ec2Images
| 名字 | 描述 | 价值 |
|---|---|---|
| apiVersion | API 版本 | '2024-12-01' |
| 位置 | 资源所在的地理位置 | string （必需） |
| 名字 | 资源名称 | 字符串 约束： 模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) （必需） |
| 性能 | 此资源的资源特定属性。 | Ec2Image属性 |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 类型 | 资源类型 | “Microsoft.AwsConnector/ec2Images” |
ArchitectureValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “arm64” “arm64_mac” “i386” “x86_64” “x86_64_mac” |
AwsEc2ImageProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| 建筑 | <p>映像的体系结构。</p> | ArchitectureValuesEnumValue |
| blockDeviceMappings | <p>任何块设备映射条目。</p> | BlockDeviceMapping[] |
| bootMode 引导模式 | <p>映像的启动模式。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-boot.htmlAmazon EC2 用户指南>/i<中的>启动模式</> a <href='>'>启动模式。>/p | BootModeValuesEnumValue |
| 创建日期 | <p>创建映像的日期和时间。</p> | 字符串 |
| 弃用时间 | <p>UTC 格式弃用 AMI 的日期和时间， 采用以下格式：<i>YYYY</i>-<i>MM</i>-<i>DD</i<<T>i<HH>/i<：>i<MM>/i<：>i<SS>/iZ。 如果为秒指定了值，Amazon EC2 会将秒舍入到最接近的分钟。</p> | 字符串 |
| deregistrationProtection | <p>指示是否为 AMI 启用取消注册保护。</p> | 字符串 |
| 描述 | <p>映像创建过程中提供的 AMI 的说明。</p> | 字符串 |
| ena支持 | <p>指定是否启用了增强的网络与 ENA。</p> | 布尔 |
| 虚拟机监控程序 | <p>映像的虚拟机监控程序类型。 仅支持<xen>/code<>代码。 不支持 <ovm>/code<>代码。</p> | HypervisorTypeEnumValue |
| 图像 ID | <p>AMI 的 ID。</p> | 字符串 |
| imageLocation | <p>AMI 的位置。</p> | 字符串 |
| imageOwner别名 | <p>所有者别名（<代码>amazon</code> | <代码>aws-marketplace</code>）。</p> | 字符串 |
| 图像类型 | <p>图像类型。</p> | ImageTypeValuesEnumValue |
| imds支持 | <p>如果 <代码>v2.0</code>，则表示在 AMI 中指定了 IMDSv2。 从此 AMI 启动的实例将具有 <代码>HttpTokens</code> 自动设置为 <代码>所需的</code>，以便默认情况下，实例要求在请求实例元数据时使用 IMDSv2。 此外，<代码>HttpPutResponseHopLimit</code> 设置为 <代码>2</code>。 有关详细信息，请参阅 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration>>>i<Amazon EC2 用户指南>/i<中配置 AMI>/a<。>/p | ImdsSupportValuesEnumValue |
| 内核 ID | <p>与映像关联的内核（如果有）。 仅适用于计算机映像。</p> | 字符串 |
| lastLaunchedTime （上次发布时间） | <p>日期和时间，在上次使用 AMI 启动 EC2 实例时，<href='http://www.iso.org/iso/iso8601>ISO 8601 日期/<格式>>ISO 8601 日期/<。 当 AMI 用于启动实例时，在报告该使用情况之前有 24 小时延迟。自 2017 年 4 月起，<>p<>代码<lastLaunchedTime>/code< 数据>/<>p 注释。</p></note> | 字符串 |
| 名字 | <p>映像创建过程中提供的 AMI 的名称。</p> | 字符串 |
| 所有者 ID | <p>拥有映像的 Amazon Web Services 帐户的 ID。</p> | 字符串 |
| 平台 | <p>此值设置为 windows<windows>/code<>代码;否则为空。</p> | PlatformValuesEnumValue |
| 平台详情 | <p>与 AMI 计费代码关联的平台详细信息。 有关详细信息，请参阅 <amazon EC2 用户指南https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-billing-info.html/i><>中的<<了解 AMI 计费信息</a><href='>。/p | 字符串 |
| 产品代码 | <p>与 AMI 关联的任何错误代码。</p> | 产品代码 |
| 公共 | <p>指示映像是否具有公共启动权限。 如果此映像具有公共启动权限或 <代码>false</code>，则该值<true>/code< true >代码。</p> | 布尔 |
| ramdiskId | <p>与映像关联的 RAM 磁盘（如果有）。 仅适用于计算机映像。</p> | 字符串 |
| rootDevice名称 | <p>根设备卷的设备名称（例如，<代码>/dev/sda1</code>）。</p> | 字符串 |
| rootDeviceType | <p>AMI 使用的根设备的类型。 AMI 可以使用 Amazon EBS 卷或实例存储卷。</p> | DeviceTypeEnumValue |
| 源实例 ID | <p>使用 href='<' https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html>CreateImage</a /a>创建 AMI 时创建的实例的 ID。 仅当使用 CreateImage 创建 AMI 时，才会显示此字段。</p> | 字符串 |
| sriovNet支持 | <p>指定是否启用了 Intel 82599 虚拟函数接口的增强网络。</p> | 字符串 |
| 州 | <p>AMI 的当前状态。 如果状态 <代码>可用的</code>，则映像已成功注册，并可用于启动实例。</p> | ImageStateEnumValue |
| stateReason （状态原因） | <p>状态更改的原因。</p> | StateReason |
| 标签 | <p>分配给映像的任何标记。</p> | 标签自动生成11 |
| tpm支持 | <p>如果为 NitroTPM 支持配置映像，则该值<v2.0>/code<>代码。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nitrotpm.htmlAmazon EC2 用户指南>/i<中的>NitroTPM</a><href='>。</p> | TpmSupportValuesEnumValue |
| usageOperation | <p>Amazon EC2 实例的操作以及与 AMI 关联的计费代码。 <代码>usageOperation</code><对应于 Amazon Web Services 成本和使用情况报告中的https://docs.aws.amazon.com/cur/latest/userguide/Lineitem-columns.html#Lineitem-details-O-Operation>行项/操作</操作</< 列以及 https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.htmlhref='>'<Amazon Web Services 价目表 API>/a。 可以在 Amazon EC2 控制台中的 <b>实例</b> 或 <b>ACI</b> 页上查看这些字段， 或在 amazon EC2 API 中的 <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html'>DescribeImages</a> 命令返回的响应中，或 <href='https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html'>describe-images</a /a> 命令在 CLI 中。</p> | 字符串 |
| virtualizationType | <p>AMI 的虚拟化类型。</p> | VirtualizationTypeEnumValue |
BlockDeviceMapping
| 名字 | 描述 | 价值 |
|---|---|---|
| deviceName （设备名称） | <p>设备名称（例如，<代码>/dev/sdh</code> 或 <代码>xvdh</code>）。</p> | 字符串 |
| EBS | <p>参数，用于在启动实例时自动设置 EBS 卷。</p> | EbsBlock设备 |
| 无设备 | <p>若要从块设备映射中省略设备，请指定一个空字符串。 指定此属性后，无论分配的值如何，设备都会从块设备映射中删除。</p> | 字符串 |
| 虚拟名称 | <p>虚拟设备名称（<代码>临时</code>N）。 实例存储卷从 0 开始编号。 具有 2 个可用实例存储卷的实例类型可以为 <代码>临时代码</code> 指定映射，<代码>临时 1</code>。 可用实例存储卷的数量取决于实例类型。 连接到实例后，必须装载卷。</p><p>NVMe 实例存储卷会自动枚举并分配设备名称。 在块设备映射中包括它们不起作用。</p><p>约束：对于 M3 实例，必须在实例的块设备映射中指定实例存储卷。 启动 M3 实例时，我们将忽略 AMI 块设备映射中指定的任何实例存储卷。</p> | 字符串 |
BootModeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “legacy-bios” “uefi” “uefi-preferred” |
DeviceTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “ebs” “instance-store” |
EbsBlock设备
| 名字 | 描述 | 价值 |
|---|---|---|
| deleteOnTermination | <p>指示在实例终止时是否删除 EBS 卷。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#preserving-volumes-on-terminationAmazon EC2 用户指南>/i<>/< a>保留 Amazon EBS 卷<>href='<。>/p | 布尔 |
| 加密 | <p>指示从备份快照还原时 EBS 卷的加密状态是否已更改。 将加密状态设置为 <代码>true</code> 的效果取决于卷源（新源或快照），启动加密状态、所有权以及默认是否启用加密。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html#encryption-parametersAmazon EBS 用户指南>/i>/i>中的 <href='>'<Amazon EBS 加密>/a<。>/p<>p<在任何情况下，都无法从加密卷中删除加密。>/p<>p加密卷只能附加到支持 Amazon EBS 加密的实例。 有关详细信息，请参阅 <href='https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption-requirements.html#ebs-encryption_supported_instances'>支持的实例类型</a /a>。</p><p>此参数不由 <>DescribeImageAttribute</a>返回。</p><p>For <>CreateImage</a>，<>RegisterImage</a>，是否可以包含此参数，允许的值因所创建的块设备映射类型而异。</p><ul><li><p>如果要为 <b>新的 （空） 卷</b>创建块设备映射，可以包括此参数， 并为加密卷指定 <代码>true</code>，或为未加密卷<false>/code<>代码。 如果省略此参数，则默认 <代码>false</code>（未加密）。</p></li><li><p>如果要从 <b>现有加密或未加密快照</b>创建块设备映射，则必须省略此参数。 如果包含此参数，则无论指定的值如何，请求都会失败。</p></li><li><p>如果要从 <b>现有未加密卷</b>创建块设备映射，则可以包含此参数，但必须指定 <代码>false</code>。 如果指定 <代码>true</code>，则请求将失败。 在这种情况下，建议省略参数。</p></li><li><p>如果要从 <b 创建块设备映射，>现有加密卷</b>，可以包括此参数， 并指定 <代码>true</code>，或 <代码>false</code>。 但是，如果指定 <代码>false</code>，则忽略参数，并且块设备映射始终加密。 在这种情况下，建议省略参数。</p></li></ul> | 布尔 |
| IOPS （国际速率） | <p>每秒 I/O 操作数（IOPS）。 对于 <代码>gp3</code>，<代码>io1</code>，<代码>io2</code> 卷，这表示为卷预配的 IOPS 数。 对于 <代码>gp2</code> 卷，这表示卷的基线性能以及卷累积 I/O 信用额度的速率。</p><p>以下是每种卷类型的支持值：</p><ul><li><p><代码>gp3</code>>： 3,000 - 16,000 IOPS>/p<>/li<>li<>p<>代码<io1>/code<： 100 - 64,000 IOPS>/p<>/li<>li<>p<>代码<io2>/code<： 100 - 256,000 IOPS>/p<>/li<>/ul<>p<对于 >代码<io2>/code< 卷， https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instanceshref='>'<实例上，>/a /a，可以在 实现高达 256,000 IOPS。 在其他实例上，可以实现高达 32,000 IOPS 的性能。</p><p><代码>io1</code> 和 <代码>io2</code> 卷需要此参数。 <代码>gp3</code> 卷的默认值为 3,000 IOPS。</p> | 整数 (int) |
| kmsKeyId | <p>标识符（密钥 ID、密钥别名、ID ARN 或别名 ARN）用于对 EBS 卷进行加密的客户托管 CMK。</p><p>此参数仅在 <代码>BlockDeviceMapping</code> 对象上受支持，<href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html'>RunInstances</a>，<href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html'>RequestSpotFleet</a>， <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html'>RequestSpotInstances</a /a>。</p> | 字符串 |
| 前哨Arn | <p>存储快照的前哨的 ARN。</p><p>使用 <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html'>CreateImage</a>时，不支持此参数。</p> | 字符串 |
| 快照 ID | <p>快照的 ID。</p> | 字符串 |
| 吞吐量 | <p>MiB/s 中卷支持的吞吐量，</p><p>此参数仅适用于<gp3>/code< 卷 >代码。</p><p>有效范围：最小值为 125。 最大值为 1000。</p> | 整数 (int) |
| 体积大小 | <p>卷的大小（以 GiB 为单位）。 必须指定快照 ID 或卷大小。 如果指定快照，则默认值为快照大小。 可以指定等于或大于快照大小的卷大小。</p><p>以下每种卷类型支持的大小：</p><ul><li><p><代码>gp2</code> 和 <代码>gp3</code>： 1 - 16,384 GiB</p></li><li><p><code>io1</code>： 4 - 16,384 GiB</p></li><li><p><code>io2</code>： 4 - 65,536 GiB</p></li><li><p><code>st1</code> 和 <code>sc1</code>： 125 - 16,384 GiB</p></li><li><p><代码>标准</code>： 1 - 1024 GiB</p></li></ul> | 整数 (int) |
| 音量类型 | <p>卷类型。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html>Amazon EBS 用户指南</i></a><href='>'>'>。/p | VolumeTypeEnumValue |
Ec2Image属性
| 名字 | 描述 | 价值 |
|---|---|---|
| 阿恩 | Amazon 资源名称 （ARN） | 字符串 |
| awsAccountId | AWS 帐户 ID | 字符串 |
| awsProperties | AWS 属性 | AwsEc2ImageProperties |
| awsRegion | AWS 区域 | 字符串 |
| awsSourceSchema | AWS 源架构 | 字符串 |
| aws标签 | AWS 标记 | Ec2ImagePropertiesAwsTags |
| publicCloudConnectorsResourceId | 公有云连接器资源 ID | 字符串 |
| publicCloudResourceName （公共云资源名称） | 公有云资源名称 | 字符串 |
Ec2ImagePropertiesAwsTags
| 名字 | 描述 | 价值 |
|---|
HypervisorTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “ovm” “xen” |
ImageStateEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “available” “deregistered” “disabled” “error” “failed” “invalid” “pending” “暂时性” |
ImageTypeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “kernel” “machine” “ramdisk” |
ImdsSupportValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “v2.0” |
PlatformValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “Windows” |
产品代码
| 名字 | 描述 | 价值 |
|---|---|---|
| productCodeId 产品代码 ID | <p>产品代码。</p> | 字符串 |
| productCodeType | <p>产品代码的类型。</p> | ProductCodeValuesEnumValue |
ProductCodeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “devpay” “marketplace” |
StateReason
| 名字 | 描述 | 价值 |
|---|---|---|
| 法典 | <p>状态更改的原因代码。</p> | 字符串 |
| 消息 | <p>状态更改的消息。</p><ul><li><p><>server.InsufficientInstanceCapacity</code>：没有足够的容量来满足启动请求。</p></li><li><p><code>Server.InternalError</code>：导致实例在启动期间终止的内部错误。</p></li><li><p><code>Server.ScheduledStop</code>：由于计划停用，实例已停止。</p></li><li><p><代码>Server.SpotInstanceShutdown</code>：实例已停止，因为最高价格等于或高于现价的现成请求数超过了可用容量，或者由于现价上涨。</p></li><li><p><代码>Server.SpotInstanceTermination</code>：实例已终止，因为最高价格等于或高于现价的现成请求数超过了可用容量，或者由于现价上涨。</p></li><li><p><code>Client.InstanceInitiatedShutdown</code>：实例已从实例的操作系统关闭。</p></li><li><p><code>Client.InstanceTerminated</code>：实例在 AMI 创建期间终止或重新启动。</p></li><li><p><代码>Client.InternalError</code>：客户端错误导致实例在启动期间终止。</p></li><li><p><code>Client.InvalidSnapshot.NotFound</code>：找不到指定的快照。</p></li><li><p><code>Client.UserInitiatedHibernate</code>：在实例上启动休眠。</p></li><li><p><code>Client.UserInitiatedShutdown</code>：实例已使用 Amazon EC2 API 关闭。</p></li><li><p><代码>Client.VolumeLimitExceed</code>：超出 EBS 卷数或总存储数的限制。 减少使用情况或请求增加帐户限制。</p></li></ul> | 字符串 |
标签自动生成11
| 名字 | 描述 | 价值 |
|---|---|---|
| 钥匙 | <p>标记的键。</p><p>约束：标记键区分大小写，最多接受 127 个 Unicode 字符。 可能不以 <代码>aws 开头：</code>。</p> | 字符串 |
| 价值 | <p>标记的值。</p><p>约束：标记值区分大小写，最多接受 256 个 Unicode 字符。</p> | 字符串 |
TpmSupportValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “v2.0” |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
VirtualizationTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “hvm” “paravirtual” |
VolumeTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “gp2” “gp3” “io1” “io2” “sc1” “st1” “standard” |
用法示例
Terraform （AzAPI 提供程序）资源定义
可以使用目标操作部署 ec2Images 资源类型：
- 资源组
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.AwsConnector/ec2Images 资源，请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.AwsConnector/ec2Images@2024-12-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
arn = "string"
awsAccountId = "string"
awsProperties = {
architecture = {
value = "string"
}
blockDeviceMappings = [
{
deviceName = "string"
ebs = {
deleteOnTermination = bool
encrypted = bool
iops = int
kmsKeyId = "string"
outpostArn = "string"
snapshotId = "string"
throughput = int
volumeSize = int
volumeType = {
value = "string"
}
}
noDevice = "string"
virtualName = "string"
}
]
bootMode = {
value = "string"
}
creationDate = "string"
deprecationTime = "string"
deregistrationProtection = "string"
description = "string"
enaSupport = bool
hypervisor = {
value = "string"
}
imageId = "string"
imageLocation = "string"
imageOwnerAlias = "string"
imageType = {
value = "string"
}
imdsSupport = {
value = "string"
}
kernelId = "string"
lastLaunchedTime = "string"
name = "string"
ownerId = "string"
platform = {
value = "string"
}
platformDetails = "string"
productCodes = [
{
productCodeId = "string"
productCodeType = {
value = "string"
}
}
]
public = bool
ramdiskId = "string"
rootDeviceName = "string"
rootDeviceType = {
value = "string"
}
sourceInstanceId = "string"
sriovNetSupport = "string"
state = {
value = "string"
}
stateReason = {
code = "string"
message = "string"
}
tags = [
{
key = "string"
value = "string"
}
]
tpmSupport = {
value = "string"
}
usageOperation = "string"
virtualizationType = {
value = "string"
}
}
awsRegion = "string"
awsSourceSchema = "string"
awsTags = {
{customized property} = "string"
}
publicCloudConnectorsResourceId = "string"
publicCloudResourceName = "string"
}
}
}
属性值
Microsoft.AwsConnector/ec2Images
| 名字 | 描述 | 价值 |
|---|---|---|
| 位置 | 资源所在的地理位置 | string （必需） |
| 名字 | 资源名称 | 字符串 约束： 模式 = ^(?=.{0,259}[^\s.]$)(?!.*[<>%&\?/#]) （必需） |
| 性能 | 此资源的资源特定属性。 | Ec2Image属性 |
| 标签 | 资源标记 | 标记名称和值的字典。 |
| 类型 | 资源类型 | “Microsoft.AwsConnector/ec2Images@2024-12-01” |
ArchitectureValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “arm64” “arm64_mac” “i386” “x86_64” “x86_64_mac” |
AwsEc2ImageProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| 建筑 | <p>映像的体系结构。</p> | ArchitectureValuesEnumValue |
| blockDeviceMappings | <p>任何块设备映射条目。</p> | BlockDeviceMapping[] |
| bootMode 引导模式 | <p>映像的启动模式。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-boot.htmlAmazon EC2 用户指南>/i<中的>启动模式</> a <href='>'>启动模式。>/p | BootModeValuesEnumValue |
| 创建日期 | <p>创建映像的日期和时间。</p> | 字符串 |
| 弃用时间 | <p>UTC 格式弃用 AMI 的日期和时间， 采用以下格式：<i>YYYY</i>-<i>MM</i>-<i>DD</i<<T>i<HH>/i<：>i<MM>/i<：>i<SS>/iZ。 如果为秒指定了值，Amazon EC2 会将秒舍入到最接近的分钟。</p> | 字符串 |
| deregistrationProtection | <p>指示是否为 AMI 启用取消注册保护。</p> | 字符串 |
| 描述 | <p>映像创建过程中提供的 AMI 的说明。</p> | 字符串 |
| ena支持 | <p>指定是否启用了增强的网络与 ENA。</p> | 布尔 |
| 虚拟机监控程序 | <p>映像的虚拟机监控程序类型。 仅支持<xen>/code<>代码。 不支持 <ovm>/code<>代码。</p> | HypervisorTypeEnumValue |
| 图像 ID | <p>AMI 的 ID。</p> | 字符串 |
| imageLocation | <p>AMI 的位置。</p> | 字符串 |
| imageOwner别名 | <p>所有者别名（<代码>amazon</code> | <代码>aws-marketplace</code>）。</p> | 字符串 |
| 图像类型 | <p>图像类型。</p> | ImageTypeValuesEnumValue |
| imds支持 | <p>如果 <代码>v2.0</code>，则表示在 AMI 中指定了 IMDSv2。 从此 AMI 启动的实例将具有 <代码>HttpTokens</code> 自动设置为 <代码>所需的</code>，以便默认情况下，实例要求在请求实例元数据时使用 IMDSv2。 此外，<代码>HttpPutResponseHopLimit</code> 设置为 <代码>2</code>。 有关详细信息，请参阅 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-new-instances.html#configure-IMDS-new-instances-ami-configuration>>>i<Amazon EC2 用户指南>/i<中配置 AMI>/a<。>/p | ImdsSupportValuesEnumValue |
| 内核 ID | <p>与映像关联的内核（如果有）。 仅适用于计算机映像。</p> | 字符串 |
| lastLaunchedTime （上次发布时间） | <p>日期和时间，在上次使用 AMI 启动 EC2 实例时，<href='http://www.iso.org/iso/iso8601>ISO 8601 日期/<格式>>ISO 8601 日期/<。 当 AMI 用于启动实例时，在报告该使用情况之前有 24 小时延迟。自 2017 年 4 月起，<>p<>代码<lastLaunchedTime>/code< 数据>/<>p 注释。</p></note> | 字符串 |
| 名字 | <p>映像创建过程中提供的 AMI 的名称。</p> | 字符串 |
| 所有者 ID | <p>拥有映像的 Amazon Web Services 帐户的 ID。</p> | 字符串 |
| 平台 | <p>此值设置为 windows<windows>/code<>代码;否则为空。</p> | PlatformValuesEnumValue |
| 平台详情 | <p>与 AMI 计费代码关联的平台详细信息。 有关详细信息，请参阅 <amazon EC2 用户指南https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-billing-info.html/i><>中的<<了解 AMI 计费信息</a><href='>。/p | 字符串 |
| 产品代码 | <p>与 AMI 关联的任何错误代码。</p> | 产品代码 |
| 公共 | <p>指示映像是否具有公共启动权限。 如果此映像具有公共启动权限或 <代码>false</code>，则该值<true>/code< true >代码。</p> | 布尔 |
| ramdiskId | <p>与映像关联的 RAM 磁盘（如果有）。 仅适用于计算机映像。</p> | 字符串 |
| rootDevice名称 | <p>根设备卷的设备名称（例如，<代码>/dev/sda1</code>）。</p> | 字符串 |
| rootDeviceType | <p>AMI 使用的根设备的类型。 AMI 可以使用 Amazon EBS 卷或实例存储卷。</p> | DeviceTypeEnumValue |
| 源实例 ID | <p>使用 href='<' https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html>CreateImage</a /a>创建 AMI 时创建的实例的 ID。 仅当使用 CreateImage 创建 AMI 时，才会显示此字段。</p> | 字符串 |
| sriovNet支持 | <p>指定是否启用了 Intel 82599 虚拟函数接口的增强网络。</p> | 字符串 |
| 州 | <p>AMI 的当前状态。 如果状态 <代码>可用的</code>，则映像已成功注册，并可用于启动实例。</p> | ImageStateEnumValue |
| stateReason （状态原因） | <p>状态更改的原因。</p> | StateReason |
| 标签 | <p>分配给映像的任何标记。</p> | 标签自动生成11 |
| tpm支持 | <p>如果为 NitroTPM 支持配置映像，则该值<v2.0>/code<>代码。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nitrotpm.htmlAmazon EC2 用户指南>/i<中的>NitroTPM</a><href='>。</p> | TpmSupportValuesEnumValue |
| usageOperation | <p>Amazon EC2 实例的操作以及与 AMI 关联的计费代码。 <代码>usageOperation</code><对应于 Amazon Web Services 成本和使用情况报告中的https://docs.aws.amazon.com/cur/latest/userguide/Lineitem-columns.html#Lineitem-details-O-Operation>行项/操作</操作</< 列以及 https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.htmlhref='>'<Amazon Web Services 价目表 API>/a。 可以在 Amazon EC2 控制台中的 <b>实例</b> 或 <b>ACI</b> 页上查看这些字段， 或在 amazon EC2 API 中的 <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html'>DescribeImages</a> 命令返回的响应中，或 <href='https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html'>describe-images</a /a> 命令在 CLI 中。</p> | 字符串 |
| virtualizationType | <p>AMI 的虚拟化类型。</p> | VirtualizationTypeEnumValue |
BlockDeviceMapping
| 名字 | 描述 | 价值 |
|---|---|---|
| deviceName （设备名称） | <p>设备名称（例如，<代码>/dev/sdh</code> 或 <代码>xvdh</code>）。</p> | 字符串 |
| EBS | <p>参数，用于在启动实例时自动设置 EBS 卷。</p> | EbsBlock设备 |
| 无设备 | <p>若要从块设备映射中省略设备，请指定一个空字符串。 指定此属性后，无论分配的值如何，设备都会从块设备映射中删除。</p> | 字符串 |
| 虚拟名称 | <p>虚拟设备名称（<代码>临时</code>N）。 实例存储卷从 0 开始编号。 具有 2 个可用实例存储卷的实例类型可以为 <代码>临时代码</code> 指定映射，<代码>临时 1</code>。 可用实例存储卷的数量取决于实例类型。 连接到实例后，必须装载卷。</p><p>NVMe 实例存储卷会自动枚举并分配设备名称。 在块设备映射中包括它们不起作用。</p><p>约束：对于 M3 实例，必须在实例的块设备映射中指定实例存储卷。 启动 M3 实例时，我们将忽略 AMI 块设备映射中指定的任何实例存储卷。</p> | 字符串 |
BootModeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “legacy-bios” “uefi” “uefi-preferred” |
DeviceTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “ebs” “instance-store” |
EbsBlock设备
| 名字 | 描述 | 价值 |
|---|---|---|
| deleteOnTermination | <p>指示在实例终止时是否删除 EBS 卷。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#preserving-volumes-on-terminationAmazon EC2 用户指南>/i<>/< a>保留 Amazon EBS 卷<>href='<。>/p | 布尔 |
| 加密 | <p>指示从备份快照还原时 EBS 卷的加密状态是否已更改。 将加密状态设置为 <代码>true</code> 的效果取决于卷源（新源或快照），启动加密状态、所有权以及默认是否启用加密。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption.html#encryption-parametersAmazon EBS 用户指南>/i>/i>中的 <href='>'<Amazon EBS 加密>/a<。>/p<>p<在任何情况下，都无法从加密卷中删除加密。>/p<>p加密卷只能附加到支持 Amazon EBS 加密的实例。 有关详细信息，请参阅 <href='https://docs.aws.amazon.com/ebs/latest/userguide/ebs-encryption-requirements.html#ebs-encryption_supported_instances'>支持的实例类型</a /a>。</p><p>此参数不由 <>DescribeImageAttribute</a>返回。</p><p>For <>CreateImage</a>，<>RegisterImage</a>，是否可以包含此参数，允许的值因所创建的块设备映射类型而异。</p><ul><li><p>如果要为 <b>新的 （空） 卷</b>创建块设备映射，可以包括此参数， 并为加密卷指定 <代码>true</code>，或为未加密卷<false>/code<>代码。 如果省略此参数，则默认 <代码>false</code>（未加密）。</p></li><li><p>如果要从 <b>现有加密或未加密快照</b>创建块设备映射，则必须省略此参数。 如果包含此参数，则无论指定的值如何，请求都会失败。</p></li><li><p>如果要从 <b>现有未加密卷</b>创建块设备映射，则可以包含此参数，但必须指定 <代码>false</code>。 如果指定 <代码>true</code>，则请求将失败。 在这种情况下，建议省略参数。</p></li><li><p>如果要从 <b 创建块设备映射，>现有加密卷</b>，可以包括此参数， 并指定 <代码>true</code>，或 <代码>false</code>。 但是，如果指定 <代码>false</code>，则忽略参数，并且块设备映射始终加密。 在这种情况下，建议省略参数。</p></li></ul> | 布尔 |
| IOPS （国际速率） | <p>每秒 I/O 操作数（IOPS）。 对于 <代码>gp3</code>，<代码>io1</code>，<代码>io2</code> 卷，这表示为卷预配的 IOPS 数。 对于 <代码>gp2</code> 卷，这表示卷的基线性能以及卷累积 I/O 信用额度的速率。</p><p>以下是每种卷类型的支持值：</p><ul><li><p><代码>gp3</code>>： 3,000 - 16,000 IOPS>/p<>/li<>li<>p<>代码<io1>/code<： 100 - 64,000 IOPS>/p<>/li<>li<>p<>代码<io2>/code<： 100 - 256,000 IOPS>/p<>/li<>/ul<>p<对于 >代码<io2>/code< 卷， https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instanceshref='>'<实例上，>/a /a，可以在 实现高达 256,000 IOPS。 在其他实例上，可以实现高达 32,000 IOPS 的性能。</p><p><代码>io1</code> 和 <代码>io2</code> 卷需要此参数。 <代码>gp3</code> 卷的默认值为 3,000 IOPS。</p> | 整数 (int) |
| kmsKeyId | <p>标识符（密钥 ID、密钥别名、ID ARN 或别名 ARN）用于对 EBS 卷进行加密的客户托管 CMK。</p><p>此参数仅在 <代码>BlockDeviceMapping</code> 对象上受支持，<href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html'>RunInstances</a>，<href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotFleet.html'>RequestSpotFleet</a>， <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RequestSpotInstances.html'>RequestSpotInstances</a /a>。</p> | 字符串 |
| 前哨Arn | <p>存储快照的前哨的 ARN。</p><p>使用 <href='https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html'>CreateImage</a>时，不支持此参数。</p> | 字符串 |
| 快照 ID | <p>快照的 ID。</p> | 字符串 |
| 吞吐量 | <p>MiB/s 中卷支持的吞吐量，</p><p>此参数仅适用于<gp3>/code< 卷 >代码。</p><p>有效范围：最小值为 125。 最大值为 1000。</p> | 整数 (int) |
| 体积大小 | <p>卷的大小（以 GiB 为单位）。 必须指定快照 ID 或卷大小。 如果指定快照，则默认值为快照大小。 可以指定等于或大于快照大小的卷大小。</p><p>以下每种卷类型支持的大小：</p><ul><li><p><代码>gp2</code> 和 <代码>gp3</code>： 1 - 16,384 GiB</p></li><li><p><code>io1</code>： 4 - 16,384 GiB</p></li><li><p><code>io2</code>： 4 - 65,536 GiB</p></li><li><p><code>st1</code> 和 <code>sc1</code>： 125 - 16,384 GiB</p></li><li><p><代码>标准</code>： 1 - 1024 GiB</p></li></ul> | 整数 (int) |
| 音量类型 | <p>卷类型。 有关详细信息，请参阅 <ihttps://docs.aws.amazon.com/ebs/latest/userguide/ebs-volume-types.html>Amazon EBS 用户指南</i></a><href='>'>'>。/p | VolumeTypeEnumValue |
Ec2Image属性
| 名字 | 描述 | 价值 |
|---|---|---|
| 阿恩 | Amazon 资源名称 （ARN） | 字符串 |
| awsAccountId | AWS 帐户 ID | 字符串 |
| awsProperties | AWS 属性 | AwsEc2ImageProperties |
| awsRegion | AWS 区域 | 字符串 |
| awsSourceSchema | AWS 源架构 | 字符串 |
| aws标签 | AWS 标记 | Ec2ImagePropertiesAwsTags |
| publicCloudConnectorsResourceId | 公有云连接器资源 ID | 字符串 |
| publicCloudResourceName （公共云资源名称） | 公有云资源名称 | 字符串 |
Ec2ImagePropertiesAwsTags
| 名字 | 描述 | 价值 |
|---|
HypervisorTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “ovm” “xen” |
ImageStateEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “available” “deregistered” “disabled” “error” “failed” “invalid” “pending” “暂时性” |
ImageTypeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “kernel” “machine” “ramdisk” |
ImdsSupportValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “v2.0” |
PlatformValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “Windows” |
产品代码
| 名字 | 描述 | 价值 |
|---|---|---|
| productCodeId 产品代码 ID | <p>产品代码。</p> | 字符串 |
| productCodeType | <p>产品代码的类型。</p> | ProductCodeValuesEnumValue |
ProductCodeValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “devpay” “marketplace” |
StateReason
| 名字 | 描述 | 价值 |
|---|---|---|
| 法典 | <p>状态更改的原因代码。</p> | 字符串 |
| 消息 | <p>状态更改的消息。</p><ul><li><p><>server.InsufficientInstanceCapacity</code>：没有足够的容量来满足启动请求。</p></li><li><p><code>Server.InternalError</code>：导致实例在启动期间终止的内部错误。</p></li><li><p><code>Server.ScheduledStop</code>：由于计划停用，实例已停止。</p></li><li><p><代码>Server.SpotInstanceShutdown</code>：实例已停止，因为最高价格等于或高于现价的现成请求数超过了可用容量，或者由于现价上涨。</p></li><li><p><代码>Server.SpotInstanceTermination</code>：实例已终止，因为最高价格等于或高于现价的现成请求数超过了可用容量，或者由于现价上涨。</p></li><li><p><code>Client.InstanceInitiatedShutdown</code>：实例已从实例的操作系统关闭。</p></li><li><p><code>Client.InstanceTerminated</code>：实例在 AMI 创建期间终止或重新启动。</p></li><li><p><代码>Client.InternalError</code>：客户端错误导致实例在启动期间终止。</p></li><li><p><code>Client.InvalidSnapshot.NotFound</code>：找不到指定的快照。</p></li><li><p><code>Client.UserInitiatedHibernate</code>：在实例上启动休眠。</p></li><li><p><code>Client.UserInitiatedShutdown</code>：实例已使用 Amazon EC2 API 关闭。</p></li><li><p><代码>Client.VolumeLimitExceed</code>：超出 EBS 卷数或总存储数的限制。 减少使用情况或请求增加帐户限制。</p></li></ul> | 字符串 |
标签自动生成11
| 名字 | 描述 | 价值 |
|---|---|---|
| 钥匙 | <p>标记的键。</p><p>约束：标记键区分大小写，最多接受 127 个 Unicode 字符。 可能不以 <代码>aws 开头：</code>。</p> | 字符串 |
| 价值 | <p>标记的值。</p><p>约束：标记值区分大小写，最多接受 256 个 Unicode 字符。</p> | 字符串 |
TpmSupportValuesEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “v2.0” |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
VirtualizationTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “hvm” “paravirtual” |
VolumeTypeEnumValue
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 属性值 | “gp2” “gp3” “io1” “io2” “sc1” “st1” “standard” |