調用ListVpcEndpoints接口，查詢終端節(jié)點列表。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產(chǎn)品自身定義的條件關鍵字。
- 關聯(lián)操作：是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
|---|---|---|---|---|
| privatelink:ListVpcEndpoints | get |
|
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 要查詢的終端節(jié)點所屬的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-huhehaote |
| NextToken | string | 否 | 是否擁有下一次查詢的令牌（Token）。取值：
| caeba0bbb2be03f84eb48b699f0a4883 |
| MaxResults | integer | 否 | 分頁大小。取值范圍：1~1000。默認值：50。 | 50 |
| EndpointId | string | 否 | 要查詢的終端節(jié)點 ID。 | ep-hp33b2e43fays7s8**** |
| ServiceName | string | 否 | 要查詢的終端節(jié)點關聯(lián)的終端節(jié)點服務名稱。 | com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i**** |
| VpcId | string | 否 | 終端節(jié)點所屬的專有網(wǎng)絡。 | vpc-fdjkf789dfdfdfde**** |
| EndpointName | string | 否 | 終端節(jié)點名稱。 | test |
| EndpointType | string | 否 | 終端節(jié)點類型。取值：
| Interface |
| EndpointStatus | string | 否 | 終端節(jié)點狀態(tài)，取值：
| Active |
| ConnectionStatus | string | 否 | 終端節(jié)點連接狀態(tài)，取值：
| Disconnected |
| Tag | array<object> | 否 | 標簽列表。 | |
| object | 否 | 標簽。 | ||
| Key | string | 否 | 實例的標簽鍵。最多支持 20 個標簽鍵。一旦傳入該值，則不允許為空字符串。 最多支持 64 個字符，不能以 | FinanceDept |
| Value | string | 否 | 實例的標簽值。最多支持 20 個標簽值。一旦傳入該值，可以為空字符串。 最多支持 128 個字符，不能以 | FinanceJoshua |
| ResourceGroupId | string | 否 | 資源組 ID。 | 1 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"Endpoints": [
{
"VpcId": "vpc-hp356stwkxg3fn2xe****",
"EndpointName": "test",
"EndpointType": "Interface",
"CreateTime": "2021-09-24T18:00:07Z",
"ServiceId": "epsrv-hp3vpx8yqxblby3i****",
"ZoneAffinityEnabled": true,
"EndpointDomain": "ep-hp33b2e43fays7s8****.epsrv-hp3xdsq46ael67lo****.cn-huhehaote.privatelink.aliyuncs.com",
"EndpointStatus": "Active",
"RegionId": "cn-huhehaote",
"ResourceOwner": true,
"Bandwidth": 1024,
"ConnectionStatus": "Disconnected",
"EndpointDescription": "This is my Endpoint.",
"EndpointId": "ep-hp33b2e43fays7s8****",
"EndpointBusinessStatus": "Normal",
"ServiceName": "com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3xdsq46ael67lo****",
"Tags": [
{
"Key": "FinanceDept",
"Value": "FinanceJoshua"
}
],
"ResourceGroupId": "1",
"PolicyDocument": "{\\n \\\"Version\\\": \\\"1\\\",\\n \\\"Statement\\\": [\\n {\\n \\\"Effect\\\": \\\"Allow\\\",\\n \\\"Action\\\": \\\"*\\\",\\n \\\"Principal\\\": \\\"*\\\",\\n \\\"Resource\\\": \\\"*\\\"\\n }\\n ]\\n}",
"AddressIpVersion": ""
}
],
"NextToken": "caeba0bbb2be03f84eb48b699f0a****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
"MaxResults": 50,
"TotalCount": 12
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-09-12 | OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2024-05-10 | OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2023-09-26 | OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2023-09-19 | OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-09-05 | OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2023-03-02 | OpenAPI 描述信息更新、OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2022-07-26 | OpenAPI 入?yún)l(fā)生變更、OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |
| 2021-03-17 | OpenAPI 返回結構發(fā)生變更 | 查看變更詳情 |