訪問控制(RAM)是阿里云提供的管理用戶身份與資源訪問權(quán)限的服務(wù)。使用RAM可以讓您避免與其他用戶共享阿里云賬號(hào)密鑰,并可按需為用戶授予最小權(quán)限。RAM中使用權(quán)限策略描述授權(quán)的具體內(nèi)容。
本文為您介紹資源管理(ResourceManager)(ResourceSharing)為RAM權(quán)限策略定義的操作(Action)、資源(Resource)和條件(Condition)。資源管理(ResourceManager)(ResourceSharing)的RAM代碼(RamCode)為[{"popCode":"ResourceDirectoryMaster","ramCodes":["resourcemanager"]},{"popCode":"ResourceCenter","ramCodes":["resourcecenter","tag"]},{"popCode":"ResourceSharing","ramCodes":["resourcesharing"]},{"popCode":"ResourceManager","ramCodes":["resourcemanager","ram"]}],支持的授權(quán)粒度為RESOURCE。
權(quán)限策略通用結(jié)構(gòu)
權(quán)限策略支持JSON格式,其通用結(jié)構(gòu)如下:
{
"Version": "1",
"Statement": [
{
"Effect": "<Effect>",
"Action": "<Action>",
"Resource": "<Resource>",
"Condition": {
"<Condition_operator>": {
"<Condition_key>": [
"<Condition_value>"
]
}
}
}
]
}
- Effect:權(quán)限策略效果。取值:Allow(允許)、Deny(拒絕)。
- Action:授予允許或拒絕權(quán)限的具體操作。具體信息,請(qǐng)參見操作(Action)。
- Resource:受操作影響的具體對(duì)象,您可以使用資源ARN來(lái)描述指定資源。具體信息,請(qǐng)參見資源(Resource)。
- Condition:指授權(quán)生效的條件。可選字段。具體信息,請(qǐng)參見條件(Condition)。
- Condition_operator:條件運(yùn)算符,不同類型的條件對(duì)應(yīng)不同的條件運(yùn)算符。具體信息,請(qǐng)參見權(quán)限策略基本元素。
- Condition_key:條件關(guān)鍵字。
- Condition_value:條件關(guān)鍵字對(duì)應(yīng)的值。
操作(Action)
下表是資源管理(ResourceManager)(ResourceSharing)定義的操作,這些操作可以在RAM權(quán)限策略語(yǔ)句的Action
元素中使用,用來(lái)授予執(zhí)行該操作的權(quán)限。下面對(duì)表中的具體項(xiàng)提供說明:- 操作:是指具體的權(quán)限點(diǎn)。
- API:是指操作對(duì)應(yīng)的API接口。
- 訪問級(jí)別:是指每個(gè)操作的訪問級(jí)別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。該列不體現(xiàn)適用于任何操作的通用條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | API | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|---|
resourcesharing:CheckSharingWithResourceDirectoryStatus | CheckSharingWithResourceDirectoryStatus | get | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:ListResourceShares | ListResourceShares | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:GetPermission | GetPermission | get | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:ListResourceShareAssociations | ListResourceShareAssociations | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:AcceptResourceShareInvitation | AcceptResourceShareInvitation | update | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:EnableSharingWithResourceDirectory | EnableSharingWithResourceDirectory | update | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:ListPermissionVersions | ListPermissionVersions | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:ListResourceShareInvitations | ListResourceShareInvitations | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:ChangeResourceGroup | ChangeResourceGroup | update | ResourceShare acs:resourcesharing:{#regionId}:{#accountId}:resourceshare/{#ResourceShareId} | 無(wú) | 無(wú) |
resourcesharing:ListSharedTargets | ListSharedTargets | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:DisassociateResourceShare | DisassociateResourceShare | update | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:DeleteResourceShare | DeleteResourceShare | delete | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:DisassociateResourceSharePermission | DisassociateResourceSharePermission | update | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:UpdateResourceShare | UpdateResourceShare | update | 全部資源 * | resourcesharing:RequestedAllowExternalTargets | 無(wú) |
resourcesharing:CreateResourceShare | CreateResourceShare | create | 全部資源 * | resourcesharing:RequestedAllowExternalTargets resourcesharing:Target resourcesharing:RequestedResourceType | 無(wú) |
resourcesharing:ListResourceSharePermissions | ListResourceSharePermissions | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:RejectResourceShareInvitation | RejectResourceShareInvitation | update | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:ListPermissions | ListPermissions | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:AssociateResourceShare | AssociateResourceShare | update | 全部資源 * | resourcesharing:Target resourcesharing:RequestedResourceType | 無(wú) |
resourcesharing:ListSharedResources | ListSharedResources | list | 全部資源 * | 無(wú) | 無(wú) |
resourcesharing:AssociateResourceSharePermission | AssociateResourceSharePermission | update | 全部資源 * | 無(wú) | 無(wú) |
資源(Resource)
下表是資源管理(ResourceManager)(ResourceSharing)定義的資源,這些資源可以在RAM權(quán)限策略語(yǔ)句的Resource
元素中使用,用來(lái)授予對(duì)該資源執(zhí)行具體操作的權(quán)限。 其中,資源ARN是資源在阿里云上的唯一標(biāo)識(shí)。具體說明如下:{#}
為變量標(biāo)識(shí),需要您替換為實(shí)際值。例如:{#ramcode}
需要您替換為實(shí)際的云服務(wù)RAM代碼。-
*
表示全部。例如:{#resourceType}
為*
時(shí):表示全部資源。{#regionId}
為*
時(shí):表示全部地域。{#accountId}
為*
時(shí):表示全部阿里云賬號(hào)。
資源類型 | 資源ARN |
---|---|
ResourceShare | acs:resourcesharing:{#regionId}:{#accountId}:resourceshare/{#ResourceShareId} |
ResourceSharePermission | acs:resourcesharing:{#regionId}:{#accountId}:* |
ResourceShare | acs:resourcesharing:{#regionId}:{#accountId}:resourceshare/* |
條件(Condition)
下表是資源管理(ResourceManager)(ResourceSharing)定義的產(chǎn)品級(jí)條件關(guān)鍵字,這些條件關(guān)鍵字可以在RAM權(quán)限策略語(yǔ)句的
Condition
元素中使用,用來(lái)描述授予權(quán)限的條件。以下僅列舉產(chǎn)品級(jí)的條件關(guān)鍵字,阿里云定義的通用條件關(guān)鍵字也同樣適用資源管理(ResourceManager)(ResourceSharing)。其中,數(shù)據(jù)類型決定了您可以使用哪些條件運(yùn)算符將請(qǐng)求中的值與權(quán)限策略語(yǔ)句中的值進(jìn)行比較。您必須使用與數(shù)據(jù)類型匹配的條件運(yùn)算符,否則無(wú)法匹配策略語(yǔ)句,授權(quán)行為無(wú)效。數(shù)據(jù)類型與條件運(yùn)算符的對(duì)應(yīng)關(guān)系,請(qǐng)參見條件操作類型。
條件關(guān)鍵字 | 描述 | 類型 |
---|---|---|
ram:ServiceName | 服務(wù)關(guān)聯(lián)角色可信的云服務(wù)標(biāo)識(shí),取值示例:actiontrail.aliyuncs.com服務(wù)關(guān)聯(lián)角色可信的云服務(wù)標(biāo)識(shí),取值示例:actiontrail.aliyuncs.com | String |
resourcesharing:RequestedAllowExternalTargets | 是否允許共享給資源目錄外的賬號(hào)。取值示例:false。 | Boolean |
resourcesharing:Target | 取值示例:資源目錄ID、資源夾的RDPath或賬號(hào)的RDPath(組織內(nèi)賬號(hào))或賬號(hào)ID(組織外賬號(hào))。 | String |
resourcesharing:RequestedResourceType | 資源類型。取值示例:VSwitch。 | String |