全部產品
Search
文件中心

PrivateLink:授權信息

更新時間:Jul 15, 2026

存取控制(RAM)是阿里雲提供的系統管理使用者身份與資源存取權限的服務。使用 RAM 可以讓您避免與其他使用者共用阿里雲帳號密鑰,並可按需為使用者授予最小許可權。RAM 中使用權限原則描述授權的具體內容。

本文為您介紹 私網連接 為 RAM 權限原則定義的操作(Action)、資源(Resource)和條件(Condition)。 私網連接 的 RAM 代碼(RamCode)為 privatelink ,支援的授權粒度為 資源級

權限原則通用結構

權限原則支援 JSON 格式,其通用結構如下:

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}        

各欄位含義如下:

  • Effect:權限原則效果。取值:Allow(允許)、Deny(拒絕)。

  • Action:授予允許或拒絕許可權的具體操作。具體資訊,請參見操作(Action)

  • Resource:受操作影響的具體對象,您可以使用資源 ARN 來描述指定資源。具體資訊,請參見資源(Resource)

  • Condition:指授權生效的條件。可選欄位。具體資訊,請參見條件(Condition)

    • Condition_operator:條件運算子,不同類型的條件對應不同的條件運算子。具體資訊,請參見權限原則基本元素

    • Condition_key:條件關鍵字。

    • Condition_value:條件關鍵字對應的值。

操作(Action)

下表是私網連接定義的操作,這些操作可以在 RAM 權限原則語句的Action元素中使用,用來授予執行該操作的許可權。下面對錶中的具體項提供說明:

  • 操作:是指具體的許可權點。

  • API:是指操作對應的 API 介面。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。該列不體現適用於任何操作的通用條件關鍵字

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

API

存取層級

資源類型

條件關鍵字

關聯操作

privatelink:DetachResourceFromVpcEndpointService DetachResourceFromVpcEndpointService update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

LoadBalancer

acs:nlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

NatGateway

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

privatelink:ListVpcEndpointServiceUsers ListVpcEndpointServiceUsers get

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:ListVpcEndpointServices ListVpcEndpointServices get

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/*

privatelink:RemoveUserFromVpcEndpointService RemoveUserFromVpcEndpointService update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:GetVpcEndpointServiceAttribute GetVpcEndpointServiceAttribute get

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:UpdateVpcEndpointAttribute UpdateVpcEndpointAttribute update

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:RemoveZoneFromVpcEndpoint RemoveZoneFromVpcEndpoint update

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:TagResources TagResources update

*VpcEndpoint

acs:privatelink:*:{#accountId}:vpcendpoint/{#vpcendpointId}

*VpcEndpointService

acs:privatelink:*:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

privatelink:AttachSecurityGroupToVpcEndpoint AttachSecurityGroupToVpcEndpoint update

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}

privatelink:ListVpcEndpointSecurityGroups ListVpcEndpointSecurityGroups get

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:DeleteVpcEndpointService DeleteVpcEndpointService delete

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:ListVpcEndpointConnections ListVpcEndpointConnections list

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:DisableVpcEndpointZoneConnection DisableVpcEndpointZoneConnection update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

privatelink:ListVpcEndpointServiceResources ListVpcEndpointServiceResources get

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:CreateVpcEndpoint CreateVpcEndpoint create

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/*

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

*VPC

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

privatelink:VpcEndpointServiceId

privatelink:DeleteVpcEndpoint DeleteVpcEndpoint delete

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:CheckProductOpen CheckProductOpen none

*全部資源

*

privatelink:AddUserToVpcEndpointService AddUserToVpcEndpointService create

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:UpdateVpcEndpointConnectionAttribute UpdateVpcEndpointConnectionAttribute update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:EnableVpcEndpointConnection EnableVpcEndpointConnection update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:UpdateVpcEndpointServiceAttribute UpdateVpcEndpointServiceAttribute update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:ChangeResourceGroup ChangeResourceGroup update

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:DisableVpcEndpointConnection DisableVpcEndpointConnection update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:ListVpcEndpointZones ListVpcEndpointZones get

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:CreateVpcEndpointService CreateVpcEndpointService create

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/*

LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

LoadBalancer

acs:nlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

NatGateway

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

privatelink:UpdateVpcEndpointZoneConnectionResourceAttribute UpdateVpcEndpointZoneConnectionResourceAttribute update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

*LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

privatelink:DetachSecurityGroupFromVpcEndpoint DetachSecurityGroupFromVpcEndpoint update

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}

privatelink:EnableVpcEndpointZoneConnection EnableVpcEndpointZoneConnection update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

privatelink:OpenPrivateLinkService OpenPrivateLinkService none

*全部資源

*

privatelink:UntagResources UntagResources update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:ListVpcEndpointServicesByEndUser ListVpcEndpointServicesByEndUser get

*VpcEndpointService

acs:privatelink:{#regionId}:{#AccountId}:vpcendpointservice/*

privatelink:VpcEndpointServiceId

privatelink:GetVpcEndpointAttribute GetVpcEndpointAttribute get

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:ListTagResources ListTagResources get

*VpcEndpoint

acs:privatelink:*:{#accountId}:vpcendpoint/{#vpcendpointId}

*VpcEndpointService

acs:privatelink:*:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

privatelink:ListVpcEndpoints ListVpcEndpoints get

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:UpdateVpcEndpointServiceResourceAttribute UpdateVpcEndpointServiceResourceAttribute update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}

*LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

privatelink:VerifyVpcEndpointServicePrivateDns VerifyVpcEndpointServicePrivateDns update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

privatelink:AddZoneToVpcEndpoint AddZoneToVpcEndpoint create

*VpcEndpoint

acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}

privatelink:AttachResourceToVpcEndpointService AttachResourceToVpcEndpointService update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

LoadBalancer

acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

LoadBalancer

acs:nlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

*NatGateway

acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}

資源(Resource)

下表是私網連接定義的資源,這些資源可以在 RAM 權限原則語句的Resource元素中使用,用來授予對該資源執行具體操作的許可權。 其中,資源 ARN 是資源在阿里雲上的唯一標識。具體說明如下:

  • {#}為變數標識,需要您替換為實際值。例如:{#ramcode}需要您替換為實際的雲端服務RAM代碼。

  • *表示全部。例如:

    • {#resourceType}*時:表示全部資源。

    • {#regionId}*時:表示全部地區。

    • {#accountId}*時:表示全部阿里雲帳號。

資源類型

資源 ARN

VpcEndpointService
  • acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}
  • acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/*
  • acs:privatelink:*:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}
  • acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#vpcendpointserviceId}
LoadBalancer
  • acs:slb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}
  • acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}
  • acs:nlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}
NatGateway
  • acs:vpc:{#regionId}:{#accountId}:natgateway/{#NatGatewayId}
VpcEndpoint
  • acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/{#EndpointId}
  • acs:privatelink:*:{#accountId}:vpcendpoint/{#vpcendpointId}
  • acs:privatelink:{#regionId}:{#accountId}:vpcendpoint/*
SecurityGroup
  • acs:ecs:{#regionId}:{#accountId}:securitygroup/{#SecurityGroupId}
VSwitch
  • acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}
VPC
  • acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

條件(Condition)

下表是私網連接 定義的產品級條件關鍵字,這些條件關鍵字可以在 RAM 權限原則語句的Condition元素中使用,用來描述授予許可權的條件。以下僅列舉產品級的條件關鍵字,阿里雲定義的通用條件關鍵字也同樣適用私網連接

其中,資料類型決定了您可以使用哪些條件運算子將請求中的值與權限原則語句中的值進行比較。您必須使用與資料類型匹配的條件運算子,否則無法匹配策略語句,授權行為無效。資料類型與條件運算子的對應關係,請參見條件操作類型

條件關鍵字

描述

類型

privatelink:VpcEndpointServiceId vpcendpointservice的ID STRING

相關操作

您可以建立自訂權限原則,並將權限原則授予 RAM 使用者、RAM 使用者組或 RAM 角色。具體操作如下: