ListVpcEndpointServicesByEndUser を使用して承認されたエンドポイントサービスをクエリ - PrivateLink - Alibaba Cloud - PrivateLink

現在のアカウントが権限付与ホワイトリストに登録されているエンドポイントサービスを照会します。結果には、現在のアカウントおよび他のアカウントのサービスが含まれます。また、アクティブな、エンドポイントの作成時に関連付け可能なサービス、および既存のエンドポイントにすでに関連付けられているサービスも含まれます。

操作説明

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

privatelink:ListVpcEndpointServicesByEndUser

get

*VpcEndpointサービス

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

privatelink:VpcEndpointServiceId

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	クエリするエンドポイントサービスのリージョン ID。 DescribeRegions を呼び出してリージョン ID を取得できます。	cn-huhehaote
NextToken	string	任意	次のクエリのトークンを含めるかどうかを指定します。有効な値: 最初のクエリの場合、またはこれ以上結果が存在しない場合は、このパラメーターを空にします。さらに結果が存在する場合は、このパラメーターを前の API 呼び出しで返された NextToken 値に設定します。	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	任意	1 ページあたりのエントリ数。有効な値: 1 ～ 1000。デフォルト値: 50。	50
ServiceId	string	任意	クエリするエンドポイントサービスの ID。	epsrv-hp3vpx8yqxblby3i****
ServiceName	string	任意	クエリするエンドポイントサービスの名前。	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3xdsq46ael67lo****
ServiceType	string	任意	エンドポイントサービスのタイプ。値を Interface に設定します。これはインターフェイスエンドポイントを示します。EPS リソースタイプとして、Application Load Balancer (ALB)、Classic Load Balancer (CLB)、および Network Load Balancer (NLB) を追加できます。	Interface
Tag	array<object>	任意	タグ。
	object	任意	タグ。
Key	string	任意	インスタンスのタグキー。最大 20 個のタグキーを指定できます。タグキーは空の文字列にできません。タグキーの長さは最大 64 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。	FinanceDept
Value	string	任意	インスタンスのタグ値。最大 20 個のタグ値を指定できます。タグ値は空の文字列にできます。タグ値の長さは最大 128 文字で、aliyun または acs: で始めることはできません。http:// または https:// を含めることはできません。	FinanceJoshua
ResourceGroupId	string	任意	リソースグループ ID。	rg-acfmy*****
ServiceRegionId	string	任意	エンドポイントサービスのリージョン ID。	cn-beijing

レスポンスフィールド

フィールド	型	説明	例
	object
Services	array<object>	エンドポイントサービス。
	array<object>	エンドポイントサービス。
Payer	string	支払者。有効な値: Endpoint: サービス利用者。 EndpointService: サービスプロバイダー。	Endpoint
ServiceDomain	string	エンドポイントの作成時に関連付け可能なエンドポイントサービスのドメイン名。	epsrv-hp3vpx8yqxblby3i****.cn-huhehaote.privatelink.aliyuncs.com
Zones	array	エンドポイントの作成時に関連付け可能なエンドポイントサービスのアクティブなゾーン。
	string	エンドポイントの作成時に関連付け可能なエンドポイントサービスのアクティブなゾーン。	cn-huhehaote-a
ServiceId	string	エンドポイントの作成時に関連付け可能なエンドポイントサービスの ID。	epsrv-hp3vpx8yqxblby3i****
ServiceName	string	エンドポイントの作成時に関連付け可能なエンドポイントサービスの名前。	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****
ServiceType	string	エンドポイントサービスのタイプ。値を Interface に設定します。これはインターフェイスエンドポイントを示します。EPS リソースタイプとして、Application Load Balancer (ALB)、Classic Load Balancer (CLB)、および Network Load Balancer (NLB) を追加できます。	Interface
ServiceSupportIPv6	boolean	エンドポイントサービスが IPv6 をサポートしているかどうかを示します。有効な値: true: IPv6 がサポートされています。 false: IPv6 はサポートされていません。	false
Tags	array<object>	タグ。
	object	タグ。
Key	string	インスタンスのタグキー。	FinanceDept
Value	string	インスタンスのタグ値。	FinanceJoshua
ResourceGroupId	string	リソースグループ ID。	rg-acfmy*****
ServiceResourceType	string	EPS リソースタイプ。有効な値: slb: EPS リソースタイプは Classic Load Balancer (CLB) です。 alb: EPS リソースタイプは Application Load Balancer (ALB) です。 nlb: EPS リソースタイプは Network Load Balancer (NLB) です。	slb
AddressIpVersion	string	プロトコルバージョン。有効な値: IPv4: IPv4。 DualStack: デュアルスタック。	IPv4
ZoneAffinityEnabled	boolean	サービスに接続するエンドポイントドメイン名に対して最寄りアクセスが有効になっているかどうかを示します。有効な値: true: 最寄りアクセスが有効になっています。 false: 最寄りアクセスが無効になっています。	false
VpcEndpointPolicySupported	boolean	エンドポイントサービスがエンドポイントポリシーをサポートしているかどうかを示します。有効な値: true: エンドポイントポリシーがサポートされています。 false: エンドポイントポリシーはサポートされていません。
AutoAcceptEnabled	boolean	エンドポイントサービスがエンドポイント接続の呼び出しを自動的に受け入れるように設定されているかどうかを示します。有効な値: true: エンドポイントサービスはエンドポイント接続の呼び出しを自動的に受け入れます。 false: エンドポイントサービスはエンドポイント接続の呼び出しを自動的に受け入れません。	true
NextToken	string	次のクエリのトークンが存在するかどうかを示します。有効な値: NextToken が空の場合、これ以上結果は存在しません。 NextToken が返された場合、その値は次のクエリのトークンを示します。	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	リクエスト ID。	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
MaxResults	integer	1 ページあたりのエントリ数。	50
TotalCount	string	返されるエントリの総数。	29

例

成功レスポンス

JSONJSON

{
  "Services": [
    {
      "Payer": "Endpoint",
      "ServiceDomain": "epsrv-hp3vpx8yqxblby3i****.cn-huhehaote.privatelink.aliyuncs.com",
      "Zones": [
        "cn-huhehaote-a"
      ],
      "ServiceId": "epsrv-hp3vpx8yqxblby3i****",
      "ServiceName": "com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****",
      "ServiceType": "Interface",
      "ServiceSupportIPv6": false,
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "ResourceGroupId": "rg-acfmy*****",
      "ServiceResourceType": "slb",
      "AddressIpVersion": "IPv4",
      "ZoneAffinityEnabled": false,
      "VpcEndpointPolicySupported": false,
      "AutoAcceptEnabled": true
    }
  ],
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults": 50,
  "TotalCount": "29"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。