获取帐户使用

使用“get帐户使用”请求方法在特定日期范围内检索您帐户的数据使用情况。请注意，此API调用将帐户使用的值返回字节字节。

验证

在开始之前，请确保您有一个具有读/写权限的API密钥。

URL.

使用以下URL格式为API调用：

         

          

           
          
         

          

           

            1
           https：//region.rest.logs.Insight.Rapid7.com/usage/Organizations?from=yyyy-mm-dd&to=yyyy-mm -dd.
          

改变地区为您的帐户匹配数据中心，例如我们那欧洲联盟那加利福尼亚州， 或者Au.。

URL参数

改变从和到匹配要使用的日期范围。日期值必须在ISO 8601表单中，例如以下内容：

• 来自= yyyy-mm-dd
• = YYYY-MM-DD

如果您想要检索最近10天的帐户使用情况，也可以将这些参数留空。您可以检索过去24小时内的数据。

数据参数

此API调用没有数据参数。

成功响应

此API呼叫的成功响应是“代码200.”成功代码的内容看起来类似于以下内容：

         

          

           
          
         

          

           

            1
           {
          
          

           

            2
           “daily_usage”：[
          
          

           

            3.
           
          
          

           

            4.
           {
          
          

           

            5.
           “使用”:134929550,
          
          

           

            6.
           “天”：“2018-12-13”
          
          

           

            7.
           }，
          
          

           

            8.
           {
          
          

           

            9.
           “用法”：133613742，
          
          

           

            10.
           “日”：“2018-12-12”
          
          

           

            11.
           }，
          
          

           

            12.
           {
          
          

           

            13.
           “用法”：133206061，
          
          

           

            14.
           “日”：“2018-12-11”
          
          

           

            15.
           }，
          
          

           

            16.
           {
          
          

           

            17.
           “使用”:126998155,
          
          

           

            18.
           “日”：“2018-12-10”
          
          

           

            19.
           }，
          
          

           

            20.
           {
          
          

           

            21.
           “用法”：131107328，
          
          

           

            22.
           “天”:“2018-12-09”
          
          

           

            23.
           }，
          
          

           

            24.
           ......
          
          

           

            25.
           ]，
          
          

           

            26.
           “期间”：2427260775，
          
          

           

            27.
           “时期”： {
          
          

           

            28.
           “到”：“2018-12-19”，
          
          

           

            29.
           “从”:“2018-12-01”
          
          

           

            30.
           }，
          
          

           

            31.
           “ID”：“<内部ID>”，
          
          

           

            32.
           “名称”：“<帐户名称>”
          
          

           

            33.
           }
          

示例调用

下面是GET帐户使用的API调用示例:

         

          

           
          
         

          

           

            1
           进口的要求
          
          

           

            2
           进口json.
          
          

           

            3.
           进口时间
          
          

           

            4.
           Api_key = '你的API密钥'
          
          

           

            5.
           def handle_response（RESP）：
          
          

           

            6.
           响应= resp.
          
          

           

            7.
           Time.Leep（1）
          
          

           

            8.
           如果响应。status_code = = 200:
          
          

           

            9.
           打印json.dumps（resp.json（），indent = 4）
          
          

           

            10.
           其他:
          
          

           

            11.
           打印response.status_code.
          
          

           

            12.
           
          
          

           

            13.
           def make_request（提供_url = none）：
          
          

           

            14.
           headers = {'x-api-key': API_KEY}
          
          

           

            15.
           
          
          

           

            16.
           URL =“https://us.rest.logs.insight.rapid7.com/usage/organizations?from=2018-12-01&To=2018-12-19”
          
          

           

            17.
           要求=请求。get (url,标题=标题)
          
          

           

            18.
           返回req.
          
          

           

            19.
           
          
          

           

            20.
           
          
          

           

            21.
           def get_usage（）：
          
          

           

            22.
           req = make_request（）
          
          

           

            23.
           handle_response（req）
          
          

           

            24.
           
          
          

           

            25.
           def start（）：
          
          

           

            26.
           get_usage ()
          
          

           

            27.
           
          
          

           

            28.
           
          
          

           

            29.
           如果__name__ =='__main__'：
          
          

           

            30.
           开始（）