Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::PrivateLink::VpcEndpointService

Última atualização: Jun 27, 2026

O recurso ALIYUN::PrivateLink::VpcEndpointService cria um serviço de endpoint.

Sintaxe

{
  "Type": "ALIYUN::PrivateLink::VpcEndpointService",
  "Properties": {
    "User": List,
    "ServiceDescription": String,
    "Resource": List,
    "ConnectBandwidth": Integer,
    "AutoAcceptEnabled": Boolean,
    "Payer": String,
    "ZoneAffinityEnabled": Boolean,
    "ServiceResourceType": String,
    "Tags": List,
    "ResourceGroupId": String,
    "DeletionForce": Boolean
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

User

List

Não

Sim

Contas da Alibaba Cloud na lista de permissões do serviço de endpoint.

Máximo: 20 contas.

ServiceDescription

String

Não

Sim

Descrição do serviço de endpoint.

De 2 a 256 caracteres. Aceita letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra.

Resource

List

Não

Sim

Recursos de serviço a serem adicionados ao serviço de endpoint.

Máximo: 20 recursos de serviço.

Para mais informações, consulte Propriedades de Resource.

ConnectBandwidth

Integer

Não

Sim

Largura de banda máxima padrão.

Valores válidos: 100 a 1024.

Unidade: Mbit/s.

AutoAcceptEnabled

Boolean

Não

Sim

Indica se as solicitações de conexão de endpoint devem ser aceitas automaticamente.

Valores válidos:

  • true

  • false (padrão)

Payer

String

Não

Não

Pagador do serviço de endpoint.

Valores válidos:

  • Endpoint: consumidor do serviço

  • EndpointService: provedor do serviço

ZoneAffinityEnabled

Boolean

Não

Sim

Indica se a afinidade de zona deve ser ativada.

Valores válidos:

  • true

  • false (padrão)

ServiceResourceType

String

Não

Não

Tipo do recurso de serviço.

Defina como slb (Classic Load Balancer).

Tags

List

Não

Sim

Tags.

Máximo: 20 tags.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

DeletionForce

Boolean

Não

Sim

Indica se o serviço de endpoint deve ser excluído forçadamente.

Valores válidos:

  • true

  • false

Sintaxe de Resource

"Resource": [
  {
    "ZoneId": String,
    "ResourceId": String,
    "ResourceType": String
  }
]

Propriedades de Resource

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

ZoneId

String

Sim

Não

ID da zona do recurso de serviço.

Nenhuma.

ResourceId

String

Sim

Não

ID do recurso de serviço a ser adicionado.

Nenhuma.

ResourceType

String

Sim

Não

Tipo do recurso de serviço a ser adicionado.

Defina como slb (instâncias de SLB em uma VPC que suportam PrivateLink).

Nota

Apenas instâncias de SLB com PrivateLink habilitado podem atuar como recursos de serviço de endpoint.

Sintaxe de Tags

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

Key

String

Sim

Não

Chave da tag.

Máximo: 20 chaves de tag. Não pode estar vazia.

Até 64 caracteres. Não pode começar com aliyun ou acs:, nem conter http:// ou https://.

Value

String

Não

Não

Valor da tag.

Máximo: 20 valores de tag. Pode estar vazio.

Até 128 caracteres. Não pode começar com aliyun ou acs:, nem conter http:// ou https://.

Valores de retorno

Fn::GetAtt

  • ServiceName: nome do serviço de endpoint.

  • ServiceDomain: nome de domínio do serviço de endpoint.

  • ServiceId: ID do serviço de endpoint.

  • ServiceDescription: descrição do serviço de endpoint.

  • MinBandwidth: largura de banda mínima da conexão de endpoint.

  • MaxBandwidth: largura de banda máxima da conexão de endpoint.

  • Arn: Alibaba Cloud Resource Name (ARN).

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  MasterZoneId:
    Type: String
    Description: The master zone id to create load balancer instance.
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  SlaveZoneId:
    Type: String
    Description: The slave zone id to create load balancer instance.
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  VpcId:
    Type: String
    Description: The VPC id to create load balancer instance. For VPC network only.
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
  VSwitchId:
    Type: String
    Description: The VSwitch id to create load balancer instance. For VPC network only.
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    AssociationPropertyMetadata:
      VpcId: VpcId
      ZoneId: MasterZoneId
Resources:
  LoadBalancer:
    Type: ALIYUN::SLB::LoadBalancer
    Properties:
      SupportPrivateLink: true
      PayType: PayOnDemand
      VpcId:
        Ref: VpcId
      VSwitchId:
        Ref: VSwitchId
      LoadBalancerSpec: slb.s1.small
      LoadBalancerName: mytest
      AddressType: intranet
      MasterZoneId:
        Ref: MasterZoneId
      SlaveZoneId:
        Ref: SlaveZoneId
  VpcEndpointService:
    DependsOn: LoadBalancer
    Type: ALIYUN::PrivateLink::VpcEndpointService
    Properties:
      User:
        - Ref: ALIYUN::AccountId
      ServiceDescription: test service endpoint
      Resource:
        - ZoneId:
            Ref: MasterZoneId
          ResourceId:
            Ref: LoadBalancer
          ResourceType: slb
      ConnectBandwidth: 100
      AutoAcceptEnabled: true
Outputs:
  ServiceName:
    Description: The name of the endpoint service.
    Value:
      Fn::GetAtt:
        - VpcEndpointService
        - ServiceName
  ServiceDomain:
    Description: The domain name of the endpoint service.
    Value:
      Fn::GetAtt:
        - VpcEndpointService
        - ServiceDomain
  ServiceId:
    Description: The ID of the endpoint service.
    Value:
      Fn::GetAtt:
        - VpcEndpointService
        - ServiceId                    
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "MasterZoneId": {
      "Type": "String",
      "Description": "The master zone id to create load balancer instance.",
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId"
    },
    "SlaveZoneId": {
      "Type": "String",
      "Description": "The slave zone id to create load balancer instance.",
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId"
    },
    "VpcId": {
      "Type": "String",
      "Description": "The VPC id to create load balancer instance. For VPC network only.",
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
    },
    "VSwitchId": {
      "Type": "String",
      "Description": "The VSwitch id to create load balancer instance. For VPC network only.",
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "VpcId": "VpcId",
        "ZoneId": "MasterZoneId"
      }
    }
  },
  "Resources": {
    "LoadBalancer": {
      "Type": "ALIYUN::SLB::LoadBalancer",
      "Properties": {
        "SupportPrivateLink": true,
        "PayType": "PayOnDemand",
        "VpcId": {
          "Ref": "VpcId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "LoadBalancerSpec": "slb.s1.small",
        "LoadBalancerName": "mytest",
        "AddressType": "intranet",
        "MasterZoneId": {
          "Ref": "MasterZoneId"
        },
        "SlaveZoneId": {
          "Ref": "SlaveZoneId"
        }
      }
    },
    "VpcEndpointService": {
      "DependsOn": "LoadBalancer",
      "Type": "ALIYUN::PrivateLink::VpcEndpointService",
      "Properties": {
        "User": [
          {
            "Ref": "ALIYUN::AccountId"
          }
        ],
        "ServiceDescription": "test service endpoint",
        "Resource": [
          {
            "ZoneId": {
              "Ref": "MasterZoneId"
            },
            "ResourceId": {
              "Ref": "LoadBalancer"
            },
            "ResourceType": "slb"
          }
        ],
        "ConnectBandwidth": 100,
        "AutoAcceptEnabled": true
      }
    }
  },
  "Outputs": {
    "ServiceName": {
      "Description": "The name of the endpoint service.",
      "Value": {
        "Fn::GetAtt": [
          "VpcEndpointService",
          "ServiceName"
        ]
      }
    },
    "ServiceDomain": {
      "Description": "The domain name of the endpoint service.",
      "Value": {
        "Fn::GetAtt": [
          "VpcEndpointService",
          "ServiceDomain"
        ]
      }
    },
    "ServiceId": {
      "Description": "The ID of the endpoint service.",
      "Value": {
        "Fn::GetAtt": [
          "VpcEndpointService",
          "ServiceId"
        ]
      }
    }
  }
}