すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::PrivateLink::VpcEndpointService

最終更新日:Apr 30, 2025

ALIYUN::PrivateLink::VpcEndpointService は、エンドポイントサービスを作成するために使用されます。

構文

{
  "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, // リソースグループ ID
    "DeletionForce": Boolean // 強制削除
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

User

List

いいえ

はい

エンドポイントサービスのホワイトリストに登録されている Alibaba Cloud アカウント。

ホワイトリストには最大 20 の Alibaba Cloud アカウントを追加できます。

ServiceDescription

String

いいえ

はい

エンドポイントサービスの説明。

説明は 2 ~ 256 文字で、英字、数字、アンダースコア (_)、およびハイフン (-) を使用できます。文字で始める必要があります。

Resource

List

いいえ

はい

エンドポイントサービスに追加するサービスリソース。

エンドポイントサービスには最大 20 のサービスリソースを追加できます。

詳細については、「リソースのプロパティ」をご参照ください。

ConnectBandwidth

Integer

いいえ

はい

デフォルトの最大帯域幅。

有効な値: 100 ~ 1024。

単位: Mbit/s。

AutoAcceptEnabled

Boolean

いいえ

はい

エンドポイント接続リクエストを自動的に承認するかどうかを指定します。

有効な値:

  • true

  • false (デフォルト)

Payer

String

いいえ

いいえ

支払い者。

有効な値:

  • Endpoint: サービス利用者

  • EndpointService: サービスプロバイダー

ZoneAffinityEnabled

Boolean

いいえ

はい

ゾーンアフィニティをサポートするかどうかを指定します。

有効な値:

  • true

  • false (デフォルト)

ServiceResourceType

String

いいえ

いいえ

サービスリソースのタイプ。

値を slb に設定します。slb の値は Classic Load Balancer (CLB) を指定します。

Tags

List

いいえ

はい

タグ。

最大 20 個のタグを追加できます。

ResourceGroupId

String

いいえ

はい

リソースグループの ID。

なし。

DeletionForce

Boolean

いいえ

はい

エンドポイントサービスを強制的に削除するかどうかを指定します。

有効な値:

  • true

  • false

リソースの構文

"Resource": [
  {
    "ZoneId": String, // ゾーン ID
    "ResourceId": String, // リソース ID
    "ResourceType": String // リソースタイプ
  }
]

リソースのプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

ZoneId

String

はい

いいえ

サービスリソースが属するゾーンの ID。

なし。

ResourceId

String

はい

いいえ

エンドポイントサービスに追加するサービスリソース。

なし。

ResourceType

String

はい

いいえ

エンドポイントサービスに追加するサービスリソースのタイプ。

値を slb に設定します。slb の値は、VPC 内にあり、PrivateLink をサポートする Server Load Balancer (SLB) インスタンスを指定します。

説明

PrivateLink をサポートする SLB インスタンスのみを、エンドポイントサービスのサービスリソースとして使用できます。

タグの構文

"Tags": [
  {
    "Value": String, // タグ値
    "Key": String // タグキー
  }
]

タグのプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Key

String

はい

いいえ

タグキー。

最大 20 個のタグキーを指定できます。タグキーは空の文字列にすることはできません。

タグキーは最大 64 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

Value

String

いいえ

いいえ

タグ値。

最大 20 個のタグ値を指定できます。タグ値は空の文字列にすることができます。

タグ値は最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。

戻り値

Fn::GetAtt

  • ServiceName: エンドポイントサービスの名前。

  • ServiceDomain: エンドポイントサービスのドメイン名。

  • ServiceId: エンドポイントサービスの ID。

  • ServiceDescription: エンドポイントサービスの説明。

  • MinBandwidth: エンドポイント接続の最小帯域幅。

  • MaxBandwidth: エンドポイント接続の最大帯域幅。

  • Arn: Alibaba Cloud リソースネーム (ARN)。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  MasterZoneId:
    Type: String
    Description: ロードバランサーインスタンスを作成するマスターゾーン ID。
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  SlaveZoneId:
    Type: String
    Description: ロードバランサーインスタンスを作成するスレーブゾーン ID。
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  VpcId:
    Type: String
    Description: ロードバランサーインスタンスを作成する VPC ID。VPC ネットワークの場合のみ。
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
  VSwitchId:
    Type: String
    Description: ロードバランサーインスタンスを作成する VSwitch ID。VPC ネットワークの場合のみ。
    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: エンドポイントサービスの名前。
    Value:
      Fn::GetAtt:
        - VpcEndpointService
        - ServiceName
  ServiceDomain:
    Description: エンドポイントサービスのドメイン名。
    Value:
      Fn::GetAtt:
        - VpcEndpointService
        - ServiceDomain
  ServiceId:
    Description: エンドポイントサービスの ID。
    Value:
      Fn::GetAtt:
        - VpcEndpointService
        - ServiceId                    
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "MasterZoneId": {
      "Type": "String",
      "Description": "ロードバランサーインスタンスを作成するマスターゾーン ID。",
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId"
    },
    "SlaveZoneId": {
      "Type": "String",
      "Description": "ロードバランサーインスタンスを作成するスレーブゾーン ID。",
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId"
    },
    "VpcId": {
      "Type": "String",
      "Description": "ロードバランサーインスタンスを作成する VPC ID。VPC ネットワークの場合のみ。",
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
    },
    "VSwitchId": {
      "Type": "String",
      "Description": "ロードバランサーインスタンスを作成する VSwitch ID。VPC ネットワークの場合のみ。",
      "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": "エンドポイントサービスの名前。",
      "Value": {
        "Fn::GetAtt": [
          "VpcEndpointService",
          "ServiceName"
        ]
      }
    },
    "ServiceDomain": {
      "Description": "エンドポイントサービスのドメイン名。",
      "Value": {
        "Fn::GetAtt": [
          "VpcEndpointService",
          "ServiceDomain"
        ]
      }
    },
    "ServiceId": {
      "Description": "エンドポイントサービスの ID。",
      "Value": {
        "Fn::GetAtt": [
          "VpcEndpointService",
          "ServiceId"
        ]
      }
    }
  }
}