View a markdown version of this page

将 ModifyImageAttribute 与 CLI 配合使用 - Amazon Elastic Compute Cloud
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将 ModifyImageAttribute 与 CLI 配合使用

以下代码示例显示了如何使用ModifyImageAttribute。

CLI
Amazon CLI

示例 1：公开 AMI

以下 modify-instance-attribute 示例将公开指定的 AMI。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{Group=all}]"

此命令不生成任何输出。

示例 2：将 AMI 设为私有

以下 modify-instance-attribute 示例将指定的 AMI 设为私有。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{Group=all}]"

此命令不生成任何输出。

示例 3：向 Amazon 账户授予启动权限

以下modify-instance-attribute示例向指定 Amazon 账户授予启动权限。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{UserId=123456789012}]"

此命令不生成任何输出。

示例 4：移除 Amazon 账户的启动权限

以下modify-instance-attribute示例删除指定 Amazon 账户的启动权限。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{UserId=123456789012}]"
PowerShell
适用于 PowerShell V4 的工具

示例 1：此示例更新指定 AMI 的描述。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"

示例 2：此示例将 AMI 设为公开（例如，任何人 Amazon Web Services 账户 都可以使用它）。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all

示例 3：此示例将 AMI 设为私有（例如，只有作为所有者的您才能使用它）。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all

示例 4：此示例向指定的授予启动权限 Amazon Web Services 账户。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333

示例 5：此示例删除了指定的启动权限 Amazon Web Services 账户。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333

  • 有关 API 的详细信息，请参阅 ModifyImageAttribute Amazon Tools for PowerShell Cmdlet 参考文档 (V4)。

适用于 PowerShell V5 的工具

示例 1：此示例更新指定 AMI 的描述。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Description "New description"

示例 2：此示例将 AMI 设为公开（例如，任何人 Amazon Web Services 账户 都可以使用它）。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserGroup all

示例 3：此示例将 AMI 设为私有（例如，只有作为所有者的您才能使用它）。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserGroup all

示例 4：此示例向指定的授予启动权限 Amazon Web Services 账户。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType add -UserId 111122223333

示例 5：此示例删除了指定的启动权限 Amazon Web Services 账户。

Edit-EC2ImageAttribute -ImageId ami-12345678 -Attribute launchPermission -OperationType remove -UserId 111122223333

  • 有关 API 的详细信息，请参阅 ModifyImageAttribute Amazon Tools for PowerShell Cmdlet 参考文档 (V5)。

有关 S Amazon DK 开发者指南和代码示例的完整列表，请参阅使用 Amazon SDK 创建 Amazon EC2 资源。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。