精确时间库存
Precision Time Inventory (Precision时间资源清册)列出计费帐户中包含的所有Precision Time服务实例及其配置状态。如果您的Fabric帐户已过渡到Equinix身份和访问管理(IAM)平台,请使用上下文切换器下拉列表访问您的项目及其资产。
要查看Precision时间服务,您需要EPT Service Admin角色。
要访问API中的Precision时间服务信息,必须提交客户端ID和客户端机密以进行OAuth2身份验证。有关如何调用OAuth API以验证和验证凭据的说明,请参阅API身份验证。
服务清单
- Portal
- API
-
登录客户门户。
-
从_Precision Time_菜单中,单击Service Inventory(服务资源清册)。

该表列出了您的Precision Time服务,其状态,软件包,源站接入点,源站客户端位置,时间服务位置和上次修改服务的日期。单击导出CSV将数据导出到可下载.csv文件。
要获取Precision Time服务列表, 请向端点发送POST请求/fabric/v4/timeServices/search。此端点还提供对响应进行筛选和排序的功能。要查看特定项目的服务列表,请按项目ID进行筛选。
cURL 请求示例:
curl -X POST 'https://api.equinix.com/fabric/v4/timeServices/search' \
-H 'content-type: application/json' \
-H 'authorization: Bearer <token>' \
-d '{
"filter": {
"and": [
{
"property": "/project/projectId",
"operator": "=",
"values": [
"<project_id>"
]
}
]
},
"pagination": {
"offset": 0,
"limit": 20
},
"sort": [
{
"direction": "DESC",
"property": "/changeLog/createdDateTime"
}
]
}'
服务详情
- Portal
- API
在服务清单中,点击服务名称即可访问详细信息页面。

服务详细信息包括有关服务的基本信息。您还可以找到有关位置,网络和连接设置,NTP或PTP高级配置详细信息以及定价的详细信息。
要获取Precision Time服务的详细信息, 请向端点发送GET请求/fabric/v4/timeServices/{serviceId}。在请求的路径中指定服务的ID。
cURL 请求示例:
curl -X 'GET' 'https://api.equinix.com/fabric/v4/timeServices/<service_id>' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
连接
- Portal
- API
要获取Precision Time服务的连接列表, 请向终结点发送GET请求/fabric/v4/timeServices/{serviceId}/connections。在请求的路径中指定服务的ID。
cURL 请求示例:
curl -X 'GET' 'https://api.equinix.com/fabric/v4/timeServices/<service_id>/connections' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <Bearer Token>'
Equinix API 还提供了创建 Precision Time 服务连接指标流的功能,以便您可以从 Equinix API 查看数据,或者创建订阅将数据发送到您的数据收集平台。
配置从 API 收集数据:
要获取您的数据,您可以通过以下两种方式之一进行操作:
- 从指标 API 端点检索数据](../observability/streaming-data/metrics.md#viewing-metrics-from-the-api)。
- 创建订阅并将数据发送到数据收集器。
查看事件日志
查看或流式传输Precision Time服务生命周期事件的完整列表。以下事件数据可用:
equinix.fabric.time_service.state.cancelled
equinix.fabric.time_service.state.configured
equinix.fabric.time_service.state.configuring
equinix.fabric.time_service.state.configuring_failed
equinix.fabric.time_service.state.deprovisioned
equinix.fabric.time_service.state.deprovisioning
equinix.fabric.time_service.state.deprovisioning_failed
equinix.fabric.time_service.state.draft
equinix.fabric.time_service.state.provisioned
equinix.fabric.time_service.state.provisioning
equinix.fabric.time_service.state.provisioning_failed
请参阅支持的事件列表。
- Portal
- API
要查看精确时间服务实例的生命周期事件:
-
导航至资产详情页面。
-
单击事件选项卡。
-
从下拉菜单中选择时间或日期范围来筛选事件。

Equinix API 允许您为 Precision Time 服务生命周期事件创建流,以便您可以从 Equinix API 查看数据,或者创建订阅将数据发送到您的数据收集平台。
配置从 API 收集数据:
要获取您的数据,您可以通过以下两种方式之一进行操作:
- 创建订阅并将数据发送到数据收集器。
