AWS Identity and Access Management
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

Amazon Storage Gateway 的操作、资源和条件键

Amazon Storage Gateway(服务前缀:storagegateway)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考:

Amazon Storage Gateway 定义的操作

您可以在 Action 策略语句的 IAM 元素中指定以下操作。可以使用策略授予在 AWS 中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

资源列指示每个操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定所有资源(“*”)。如果该列包含一种资源类型,则可以在含有该操作的语句中指定该类型的 ARN。必需资源在表中以星号 (*) 表示。如果在使用该操作的语句中指定资源级权限 ARN,则它必须属于该类型。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种类型而不使用其他类型。

有关下表中各列的详细信息,请参阅 操作表

操作 描述 访问级别 资源类型(* 为必需) 条件键 相关操作
ActivateGateway 该操作激活您此前部署在 主机上的网关。 写入

aws:RequestTag/${TagKey}

aws:TagKeys

AddCache 此操作将一个或多个网关本地磁盘配置为缓存卷网关的缓存。 写入

gateway*

AddTagsToResource 此操作为指定资源添加一个或多个标签。 标记

gateway

share

tape

volume

aws:RequestTag/${TagKey}

aws:TagKeys

AddUploadBuffer 此操作将一个或多个网关本地磁盘配置为指定网关的上传缓冲区。 写入

gateway*

AddWorkingStorage 此操作将一个或多个网关本地磁盘配置为工作存储,供指定的网关使用。 写入

gateway*

AttachVolume 该操作将卷连接到 iSCSI 连接,然后将卷附加到指定的网关。 写入

gateway*

volume*

CancelArchival 取消已经启动的将虚拟磁带存档到虚拟磁带架 (VTS) 的过程。 写入

gateway*

tape*

CancelRetrieval 取消已经启动的从虚拟磁带架 (VTS) 检索虚拟磁带的过程。 写入

gateway*

tape*

CreateCachediSCSIVolume 该操作在指定的缓存网关上创建缓存卷。只有网关缓存卷体系架构才支持此操作。 写入

gateway*

volume*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateNFSFileShare 该操作在现有文件网关上创建 NFS 文件共享。 写入

gateway*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSMBFileShare 该操作在现有文件网关上创建 SMB 文件共享。 写入

gateway*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSnapshot 该操作开始创建卷的快照。 写入

volume*

CreateSnapshotFromVolumeRecoveryPoint 该操作从卷还原点开始创建网关的快照。 写入

volume*

CreateStorediSCSIVolume 该操作在指定网关上创建卷。 写入

gateway*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateTapeWithBarcode 使用您自己的条码创建虚拟磁带。 写入

gateway*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateTapes 创建一个或多个虚拟磁带。您将数据写入虚拟磁带,然后将其存档。 写入

gateway*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteBandwidthRateLimit 此操作会删除网关的带宽速率限制。 写入

gateway*

DeleteChapCredentials 此操作会删除指定的 iSCSI 目标及其配套启动程序的质询握手身份验证协议 (CHAP) 证书。 写入

target*

DeleteFileShare 该操作会从文件网关删除一个文件共享。 写入

share*

DeleteGateway 此操作会删除网关。 写入

gateway*

DeleteSnapshotSchedule 此操作会删除卷的快照。 写入

volume*

DeleteTape 删除指定的虚拟磁带。 写入

gateway*

tape*

DeleteTapeArchive 从虚拟磁带架 (VTS) 删除指定的虚拟磁带。 写入
DeleteVolume 此操作会删除您之前使用 CreateCachediSCSIVolume 或 CreateStorediSCSIVolume API 创建的指定网关卷。 写入

volume*

DescribeBandwidthRateLimit 此操作会返回网关的带宽速率限制。 Read

gateway*

DescribeCache 此操作会返回有关网关缓存的信息。只有网关缓存卷体系架构才支持此操作。 Read

gateway*

DescribeCachediSCSIVolumes 该操作返回请求中所指定网关卷的描述。只有网关缓存卷体系架构才支持此操作。 Read

volume*

DescribeChapCredentials 此操作会返回指定的 iSCSI 目标的质询握手身份验证协议 (CHAP) 证书信息,每对“目标–启动程序”一个。 Read

target*

DescribeGatewayInformation 此操作会返回有关网关的元数据,如名称、网络接口、已配置的时区和状态(网关运行与否)。 Read

gateway*

DescribeMaintenanceStartTime 该操作返回网关的周度维护起始时间信息,包括一星期中的天和时间。 Read

gateway*

DescribeNFSFileShares 该操作从文件网关获取一个或多个文件共享的描述。 Read

share*

DescribeSMBFileShares 该操作从文件网关获取一个或多个文件共享的描述。 Read

share*

DescribeSMBSettings 该操作从文件网关中获取服务器消息块 (SMB) 文件共享设置描述。 Read

gateway*

DescribeSnapshotSchedule 该操作介绍指定网关卷的快照计划。 Read

volume*

DescribeStorediSCSIVolumes 该操作返回请求中指定的网关卷的描述。 Read

volume*

DescribeTapeArchives 返回虚拟磁带架 (VTS) 中指定虚拟磁带的描述。 Read
DescribeTapeRecoveryPoints 返回指定网关 VTL 可用的虚拟磁带还原点列表。 Read

gateway*

DescribeTapes 返回指定的虚拟磁带的 Amazon 资源名称 (ARN) 描述。 Read

gateway*

DescribeUploadBuffer 此操作会返回有关网关的上传缓冲区的信息。 Read

gateway*

DescribeVTLDevices 返回指定网关的虚拟磁带库 (VTL) 设备的描述。 Read

gateway*

DescribeWorkingStorage 此操作会返回有关网关工作存储的信息。 Read

gateway*

DetachVolume 该操作将卷与 iSCSI 连接断开连接,然后将卷从指定的网关中分离。 写入

volume*

DisableGateway 如果网关不再正常工作则将其禁用。 写入

gateway*

JoinDomain 该操作允许您加入 Active Directory 域。 写入

gateway*

ListFileShares 此操作会获得特定文件网关的文件共享列表,或属于调用用户账户的文件共享列表。 List

gateway*

ListGateways 此操作列出了该请求中指定地区的 AWS 账户所拥有的网关。返回的列表是按网关Amazon 资源名称 (ARN) 排序的。 List
ListLocalDisks 此操作返回网关的本地磁盘列表。 List

gateway*

ListTagsForResource 此操作列出了已添加到指定资源的标签。 Read

gateway

share

tape

volume

ListTapes 列出您的虚拟磁带库 (VTL) 和虚拟磁带架 (VTS) 中的虚拟磁带。 Read

tape*

ListVolumeInitiators 此操作会列出与卷连接的 iSCSI 启动程序。 Read

volume*

ListVolumeRecoveryPoints 该操作列出指定网关的还原点。 List

gateway*

ListVolumes 此操作列出网关的 iSCSI 存储卷。 List

gateway*

NotifyWhenUploaded 在将写入到 NFS 文件共享的所有文件上传到 Amazon S3 时,该操作通过 CloudWatch Events 向您发送通知。 写入

share*

RefreshCache 此操作刷新指定文件共享的缓存。 写入

share*

RemoveTagsFromResource 此操作删除指定资源的一个或多个标签。 标记

gateway

share

tape

volume

aws:TagKeys

ResetCache 此操作会重置所有遇到错误的缓存磁盘,并将它们设为可用状态,以便重新配置为缓存存储。 写入

gateway*

RetrieveTapeArchive 检索从虚拟磁带架 (VTS) 存档到网关 VTL 的虚拟磁带。 写入

gateway*

tape*

RetrieveTapeRecoveryPoint 检索指定虚拟磁带的还原点。 写入

gateway*

tape*

SetLocalConsolePassword 设置虚拟机本地控制台的密码。 写入

gateway*

SetSMBGuestPassword 设置 SMB 来宾用户的密码。 写入

gateway*

ShutdownGateway 此操作会关闭网关。 写入

gateway*

StartGateway 此操作会启动您之前关闭的网关。 写入

gateway*

UpdateBandwidthRateLimit 此操作会更新网关的带宽速率限制。 写入

gateway*

UpdateChapCredentials 此操作会更新指定的 iSCSI 目标的质询握手身份验证协议 (CHAP) 证书。 写入

target*

UpdateGatewayInformation 此操作会更新网关的元数据,其中包括网关的名称和时区。 写入

gateway*

UpdateGatewaySoftwareNow 此操作会更新网关虚拟机 (VM) 软件。 写入

gateway*

UpdateMaintenanceStartTime 该操作更新网关的周度维护起始时间信息,包括一星期中的天和时间。维护时间与网关时区中的时间一致。 写入

gateway*

UpdateNFSFileShare 该操作更新 NFS 文件共享。 写入

share*

UpdateSMBFileShare 该操作更新 SMB 文件共享。 写入

share*

UpdateSnapshotSchedule 此操作会更新为网关卷配置的快照计划。 写入

volume*

UpdateVTLDeviceType 此操作会更新网关 VTL 中的介质更换器类型。 写入

device*

Amazon Storage Gateway 定义的资源

以下资源类型是由该服务定义的,可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键,从而定义资源类型。这些键显示在表的最后一列。有关下表中各列的详细信息,请参阅 资源类型表

资源类型 ARN 条件键
device arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}/device/${Vtldevice}
gateway arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}

aws:ResourceTag/${TagKey}

share arn:${Partition}:storagegateway:${Region}:${Account}:share/${ShareId}

aws:ResourceTag/${TagKey}

tape arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${TapeBarcode}

aws:ResourceTag/${TagKey}

target arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}/target/${IscsiTarget}
volume arn:${Partition}:storagegateway:${Region}:${Account}:gateway/${GatewayId}/volume/${VolumeId}

aws:ResourceTag/${TagKey}

Amazon Storage Gateway 的条件键

Amazon Storage Gateway 定义以下可以在 IAM 策略的 Condition 元素中使用的条件键。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息,请参阅 条件键表

要查看适用于所有服务的全局条件键,请参阅 IAM 策略参考 中的可用的全局条件键

条件键 描述 类型
aws:RequestTag/${TagKey} 根据每个标签的允许值集筛选创建请求。 字符串
aws:ResourceTag/${TagKey} 根据与资源关联的标签值筛选操作。 字符串
aws:TagKeys 根据在请求中是否具有必需标签以筛选创建请求。 字符串