获得账户使用

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

身份验证

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

URL

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

         

          

           
          
          

         

          

           

            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帐户使用的示例API调用:

         

          

           
          
          

         

          

           

            1
           进口的要求
          
          

           

            2
           进口json
          
          

           

            3.
           导入的时间
          
          

           

            4
           Api_key = '您的API密钥'
          
          

           

            5
           def handle_response(职责):
          
          

           

            6
           响应=职责
          
          

           

            7
           time . sleep (1)
          
          

           

            8
           如果响应。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
           要求=请求。get (url,标题=标题)
          
          

           

            18
           返回请求
          
          

           

            19
           
          
          

           

            20.
           
          
          

           

            21
           def get_usage ():
          
          

           

            22
           要求= make_request ()
          
          

           

            23
           handle_response(要求)
          
          

           

            24
           
          
          

           

            25
           def开始():
          
          

           

            26
           get_usage ()
          
          

           

            27
           
          
          

           

            28
           
          
          

           

            29
           If __name__ == '__main__':
          
          

           

            30.
           start ()