PortsCollection
更新时间： 2026/09/07
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Fabrics/fabric_id/Switches/switch_id/Ports
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | Ports资源模型的OData描述信息 |
| @odata.id | string | true | - | Ports资源节点的访问路径 |
| @odata.type | string | true | - | Ports资源类型 |
| Name | string | true | - | Ports集合资源的名称 |
| Members@odata.count | number | true | - | Ports资源数量 |
| Members | array | true | - | Ports资源列表，提供所有系统资源URL的引用 |
| Members[].@odata.id | string | true | - | Ports资源的访问路径 |
supported_methods
- GET
HTTP methods
GET
命令功能
查询Ports资源
命令格式
URL: https://device_ip/redfish/v1/Fabrics/fabric_id/Switches/switch_id/Ports
请求头:
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 执行该GET请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
| fabric_id | fabric设备ID | 可通过/redfish/v1/Fabrics的Members属性获得 |
| switch_id | switch设备ID | 可通过/redfish/v1/Fabrics/fabric_id/Switches的Members属性获得 |
使用指南
BMC300 5.13.3.27及以上版本，Atlas 350L SuperSuite，Atlas 560EL SuperSuite机型支持。
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/Fabrics/fabric_id/Switches/switch_id/Ports请求头：
X-Auth-Token: 123456789***********************请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#PortCollection.PortCollection",
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports",
"@odata.type": "#PortCollection.PortCollection",
"Name": "Switches Port Collection",
"Members@odata.count": 16,
"Members": [
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/0"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/1"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/2"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/3"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/4"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/5"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/6"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/7"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/8"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/9"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/10"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/11"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/12"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/13"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/14"
},
{
"@odata.id": "/redfish/v1/Fabrics/1/Switches/0/Ports/15"
}
]
}响应码：200