1. 接口描述
接口请求域名： csip.tencentcloudapi.com 。
获取网卡列表
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DescribeNICAssets。 |
| Version | 是 | String | 公共参数，本接口取值：2022-11-21。 |
| Region | 否 | String | 公共参数，此参数为可选参数。 |
| MemberId.N | 否 | Array of String | 集团账号的成员id 示例值：["mem-6wfo0fzks3","mem-85fo0fzks4"] |
| Filter | 否 | Filter | 过滤参数 示例值：{ "Filters": [ { "Name": "Status", "Values": [ "0" ], "OperatorType": 7 }, { "Name": "Uin", "Values": [ "100065" ], "OperatorType": 7 } ], "Limit": 10, "Offset": 0, "StartTime": "2024-10-26 00:00:00", "EndTime": "2024-11-01 23:59:59" } |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Data | Array of NICAsset | 列表 示例值：[ { "AppId": "13451", "Uin": "10944446", "AssetId": "eni-4r05m1wj", "AssetName": "未命名", "AssetType": "ENI", "PrivateIp": "172.16.0.6", "PublicIp": "10.4..", "Region": "ap-guangzhou", "VpcId": "vpc-hbe549z5", "VpcName": "league-vpc-2", "Tag": { "Name": "env", "Value": "dev" }, "OutboundPeakBandwidth": "0bps", "InboundPeakBandwidth": "0bps", "OutboundCumulativeFlow": "0B", "InboundCumulativeFlow": "0B", "NetworkAttack": 0, "ExposedPort": 0, "ExposedVUL": 0, "ConfigureRisk": 0, "CreateTime": "2023-11-23 19:58:39", "ScanTask": 1, "LastScanTime": "2024-10-12 16:33:37", "Nick": "nickname", "IsCore": 0, "IsNewAsset": 0 } ] |
| TotalCount | Integer | 总数 示例值：10 |
| RegionList | Array of FilterDataObject | 地域列表 示例值：[ { "Text": "广州", "Value": "ap-guangzhou" }, { "Text": "南京", "Value": "ap-nanjing" }, { "Text": "上海", "Value": "ap-shanghai" } ] |
| AssetTypeList | Array of FilterDataObject | 资产类型列表 示例值：[ { "Text": "ENI", "Value": "ENI" } ] |
| VpcList | Array of FilterDataObject | vpc列表 示例值：[ { "Text": "league-vpc-2", "Value": "vpc-hdbed9z5" }, { "Text": "vpc-gz-0", "Value": "vpc-63z25m89" } ] |
| AppIdList | Array of FilterDataObject | appid列表 示例值：[ { "Value": "1894", "Text": "1894" } ] |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 获取网卡列表
获取网卡列表
输入示例
POST / HTTP/1.1
Host: csip.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeNICAssets
<公共请求参数>
{
"MemberId": [
"mem-688033",
"mem-tencent-52d96a4d"
],
"Filter": {
"Limit": 1
}
}输出示例
{
"Response": {
"AppIdList": [
{
"Text": "2421",
"Value": "2421"
},
{
"Text": "1894",
"Value": "1894"
}
],
"AssetTypeList": [
{
"Text": "ENI",
"Value": "ENI"
}
],
"Data": [
{
"AppId": "15651",
"AssetId": "eni-45xmwr0j",
"AssetName": "未命名",
"AssetType": "ENI",
"ConfigureRisk": 0,
"CreateTime": "2023-11-23 19:58:39",
"ExposedPort": 0,
"ExposedVUL": 0,
"InboundCumulativeFlow": "0B",
"InboundPeakBandwidth": "0bps",
"IsCore": 1,
"IsNewAsset": 0,
"LastScanTime": "2024-10-12 16:33:37",
"NetworkAttack": 0,
"Nick": "焦糖小蛋糕",
"OutboundCumulativeFlow": "0B",
"OutboundPeakBandwidth": "0bps",
"PrivateIp": "172.16.0.6",
"PublicIp": "1.1.1.1",
"Region": "ap-guangzhou",
"ScanTask": 8,
"Tag": null,
"Uin": "10446",
"VpcId": "vpc-hbe549z5",
"VpcName": "league-vpc-2"
}
],
"RegionList": [
{
"Text": "广州",
"Value": "ap-guangzhou"
},
{
"Text": "南京",
"Value": "ap-nanjing"
},
{
"Text": "上海",
"Value": "ap-shanghai"
}
],
"RequestId": "00369b23-b4da-446f-8d07-7ee691d237a4",
"TotalCount": 7,
"VpcList": [
{
"Text": "league-vpc-2",
"Value": "vpc-hdbed9z5"
},
{
"Text": "vpc-gz-0",
"Value": "vpc-63z25m89"
}
]
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
该接口暂无业务逻辑相关的错误码，其他错误码详见 公共错误码。
