コロケーションデータをAPIからストリーム配信

Streaming APIは、お客様のデータをAPIから取得するためのサブスクリプションの作成をサポートしています。

前提条件

• OAuth2認証のためのユーザー認証情報、クライアントID、クライアントシークレットを送信します。Equinix APIへのリクエストを認証する方法については、「API認証」(../../equinix-api/api-authentication.md)を参照してください。

• [サブスクリプションの作成Smartview/v2/streaming/subscriptions](/api-catalog/smartviewv2/#operation/createSubscription) エンドポイントに POST リクエストを送信し、channelTypeにRESTを指定します。レスポンスのLocation` ヘッダには、リアルタイムフィードを利用するために必要な購読 ID が含まれます。詳細はCreating a Subscriptionを参照してください。

データの取得

REST ストリーミングチャネルのメッセージを取得するには、smartview/v2/streaming/subscriptionData/{subscriptionId} エンドポイントに GET リクエストを送信します。

サンプルcURLリクエスト：

curl -X   
GET 'https://api.equinix.com/smartview/v2/streaming/subscriptionData/0f6bdb36-e130-4924-b038-ee1785fad999'

回答例

{  
    "alarmMessageData": [],  
    "alertMessageData": [],  
    "environmentMessageData": [],  
    "meteredPowerMessageData": [],  
    "powerMessageData": [  
        {  
            "type": "power",  
            "data": {  
                "streamId": "20409808",  
                "ibx": "LD9",  
                "asset": {  
                    "id": "20409808",  
                    "type": "CIRCUIT"  
                },  
                "cage": "LD9:0G:0Z10BB",  
                "cabinet": "LD9:0G:0Z10BB:0109",  
                "accountNumber": "116710",  
                "description": "32-amp 230v Single Phase Primary AC Power",  
                "oid": "1.3.6.1.2.1.299.36.10.4442",  
                "realPower": {  
                    "value": "0.000",  
                    "unit": "kW"  
                },  
                "apparentPower": {  
                    "value": "0.000",  
                    "unit": "kVA"  
                },  
                "current": {  
                    "value": "0.000",  
                    "unit": "A"  
                },  
                "powerFactor": {  
                    "value": "0.000",  
                    "unit": "pf"  
                },  
                "soldCurrent": {  
                    "value": "32.000",  
                    "unit": "A"  
                },  
                "soldPower": {  
                    "value": "7.360",  
                    "unit": "kVA"  
                },  
                "powerConsumptionToContractual": {  
                    "value": "0.000",  
                    "unit": "PERCENT"  
                },  
                "peakLastSevenDays": {  
                    "value": "0.000",  
                    "unit": "kVA"  
                },  
                "peakLastSevenDaysRatio": {  
                    "value": "0.000",  
                    "unit": "PERCENT"  
                },  
                "peakLastSevenDaysContractualPower": {  
                    "value": "7.360",  
                    "unit": "kVA"  
                },  
                "peakLastSevenDaysTime": "2023-12-06T05:45:00",  
                "lastUpdated": "2023-12-07T15:49:00",  
                "readingTime": "2023-12-07T15:45:00"  
            }  
        },  
        {  
            "type": "power",  
            "data": {  
                "streamId": "20409809",  
                "ibx": "LD9",  
                "asset": {  
                    "id": "20409809",  
                    "type": "CIRCUIT"  
                },  
                "cage": "LD9:0G:0Z10BB",  
                "cabinet": "LD9:0G:0Z10BB:0109",  
                "accountNumber": "116710",  
                "description": "32-amp 230v Single Phase Redundant AC Power",  
                "oid": "1.3.6.1.2.1.299.36.10.4443",  
                "realPower": {  
                    "value": "0.000",  
                    "unit": "kW"  
                },  
                "apparentPower": {  
                    "value": "0.000",  
                    "unit": "kVA"  
                },  
                "current": {  
                    "value": "0.000",  
                    "unit": "A"  
                },  
                "powerFactor": {  
                    "value": "0.000",  
                    "unit": "pf"  
                },  
                "soldCurrent": {  
                    "value": "32.000",  
                    "unit": "A"  
                },  
                "soldPower": {  
                    "value": "7.360",  
                    "unit": "kVA"  
                },  
                "powerConsumptionToContractual": {  
                    "value": "0.000",  
                    "unit": "PERCENT"  
                },  
                "peakLastSevenDays": {  
                    "value": "0.000",  
                    "unit": "kVA"  
                },  
                "peakLastSevenDaysRatio": {  
                    "value": "-1.000",  
                    "unit": "PERCENT"  
                },  
                "peakLastSevenDaysContractualPower": {  
                    "value": "0.000",  
                    "unit": "kVA"  
                },  
                "peakLastSevenDaysTime": "2023-12-06T22:15:00",  
                "lastUpdated": "2023-12-07T15:49:00",  
                "readingTime": "2023-12-07T15:45:00"  
            }  
        }  
    ],  
    "tagPointMessageData": [],  
    "pagination": {  
        "offset": 0,  
        "limit": 250,  
        "total": 46,  
        "next": null,  
        "previous": "?offset=0&limit=250"  
    }  
}