获得账户使用

使用“GET Account Usage”请求方法来检索特定日期范围内您的账户的数据使用情况。注意，这个API调用以字节为单位返回您的帐户使用值。

身份验证

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

URL

为你的API调用使用以下URL格式:

         

          

           
          
         

          

           

            1
           https://REGION.rest.logs.insight.rapid7.com/usage/organizations?from=YYYY-MM-DD&to=YYYY-MM-DD
          

改变地区要匹配您帐户的数据中心，请执行以下操作：我们，欧盟，ca,或非盟．

URL参数

改变从…起和来以匹配要使用的日期范围。日期值必须采用ISO 8601格式，例如:

• 从= YYYY-MM-DD
• 至=YYYY-MM-DD

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

数据参数

这个API调用没有数据参数。

成功响应

这个API调用的成功响应是“Code 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
           “period_usage”:2427260775,
          
          

           

            27
           “期”:{
          
          

           

            28
           “”:“2018-12-19”,
          
          

           

            29
           “自”：“2018-12-01”
          
          

           

            30.
           }，
          
          

           

            31
           “id”:“内部id > <”
          
          

           

            32
           “名称”:“<帐户名称>”
          
          

           

            33
           ｝
          

抽样电话

以下是GET account用法的示例API调用：

         

          

           
          
         

          

           

            1
           导入请求
          
          

           

            2
           进口json
          
          

           

            3.
           导入的时间
          
          

           

            4
           API_密钥='您的API密钥'
          
          

           

            5
           def handle_response(职责):
          
          

           

            6
           响应=职责
          
          

           

            7
           time . sleep (1)
          
          

           

            8
           如果response.status_code==200：
          
          

           

            9
           打印json.dumps (resp.json(),缩进= 4)
          
          

           

            10
           其他：
          
          

           

            11
           打印response.status_code
          
          

           

            12
           
          
          

           

            13
           def make_request (provided_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
           req=requests.get（url，headers=headers）
          
          

           

            18
           返回请求
          
          

           

            19
           
          
          

           

            20.
           
          
          

           

            21
           def get_usage ():
          
          

           

            22
           要求= make_request ()
          
          

           

            23
           handle_response(要求)
          
          

           

            24
           
          
          

           

            25
           def开始():
          
          

           

            26
           get_用法（）
          
          

           

            27
           
          
          

           

            28
           
          
          

           

            29
           如果__name__ == '__main__':
          
          

           

            30.
           start ()