訪問控制endpoint查詢
更新時間 2025-06-11 14:55:16
最近更新時間: 2025-06-11 14:55:16
分享文章
接口介紹
查詢內外網訪問endpoint
接口約束
- 支持的線上資源池 :上海7、南京3、南京5、杭州2、合肥2、九江、廣州6、武漢4、福州25、廈門3、郴州2、海口2、北京5、雄安2、石家莊20、內蒙6、晉中、遼陽1、西安5、烏魯木齊4、烏魯木齊27、中衛5、蘭州2、西寧2、拉薩3、昆明2、重慶2、成都4、貴州3、上海33、寧波邊緣云、華東1、上海36、南昌5、青島20、武漢41、長沙42、長沙37、南寧23、北京行業云20、華北2、西南1、上海32。
- 自2024年8月21日后,響應參數"intranetEndpoint"將會支持返回對象存儲內網域名。即當該資源池支持通過內網域名方式訪問對象存儲后,"intranetEndpoint"將由原先固定返回內網IP地址(如"//100.127.154.200"),改為返回內網域名(如//shanghai-15-internal.zos.daliqc.cn)。
- 當前已有杭州7、華北2、上海15支持內網域名;如需通過內網域名訪問對象存儲,請注意將云主機/裸金屬的默認DNS,指向天翼云內網DNS。詳情請見:更改主機DNS使內網DNS配置生效。
URI
GET /v4/oss/get-endpoint
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 區域ID | 332232eb-63aa-465e-9028-52e5123866f0 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| ipv6Endpoint | Array of String | 內網ipv6列表,未配置時為空 | null |
| intranetEndpoint | Array of String | 內網ipv4列表,未配置時為空 注:2024年8月21日后,對于杭州7、華北2、上海15資源池,本參數會返回內網域名; 其他資源池會返回內網IP地址 |
["//100.127.154.200"] ["//shanghai-15-internal.zos.daliqc.cn"] |
| internetEndpoint | Array of String | 外網ipv4列表,未配置時為空 | ["//100.124.255.6:80"] |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/get-endpoint?regionID=332232eb-63aa-465e-9028-52e5123866f0
響應示例
{
"returnObj": {
"ipv6Endpoint": null,
"intranetEndpoint": [
"//100.127.154.200"
],
"internetEndpoint": [
"//100.124.255.6:80"
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表