Lists the external stores.

Request syntax

GET /externalstores? externalStoreName=<external_store_name_prefix>&offset=<offset>&lines=<lines>
'Content-Length': '0', 
'x-log-bodyrawsize': '0', 
'x-log-apiversion': '0.6.0', 
'x-log-signaturemethod': 
'hmac-sha1', 
'Host': '<endpoint>',
'Date': 'Thu, 19 Apr 2018 03:03:16 GMT', 
'Authorization': 'LOG <yourAccessKeyId>:<yourSignature>'}

Request parameters

  • Request headers

    The ListExternalStore operation does not have operation-specific request headers. For information about the common request headers of Log Service API operations, see Common request headers.

  • Parameters
    Parameter Type Required Example Description
    externalStoreName string No None. The external stores whose names contain the string.
    offset integer No 0 The external stores are queried from the offset position.
    lines integer No 10 The number of external stores to be listed.

Response parameters

  • Response headers

    The ListExternalStore operation does not have operation-specific response headers. For information about the common response headers of Log Service API operations, see Common response headers.

  • Response elements
    The response body of the ListExternalStore operation contains a list of all configuration files of the project. The following table describes the parameters of the response body.
    Parameter Type Example Description
    count Integer 3 The number of returned external stores.
    total Integer 3 The total number of external stores on the server.
    externalstores String array ecs_store, rds_store, and ecs_store1 The list of returned external stores.

Examples

  • Sample requests
    GET http://ali-yunlei-chengdu.cn-chengdu.log.aliyuncs.com:80/externalstores?externalStoreName=&offset=0&lines=10
    'Content-Length': '0', 
    'x-log-bodyrawsize': '0', 
    'x-log-apiversion': '0.6.0', 
    'x-log-signaturemethod': 
    'hmac-sha1', 
    'Host': 'ali-yunlei-chengdu.cn-chengdu.log.aliyuncs.com',
    'Date': 'Thu, 19 Apr 2018 03:03:16 GMT', 
    'Authorization': 'LOG <yourAccessKeyId>:<yourSignature>'}
  • Sample success responses
    Header :
    {
        "content-length": "103", 
        "server": "nginx/1.6.1", 
        "connection": "close", 
        "date": "Mon, 09 Nov 2015 09:19:13 GMT", 
        "content-type": "application/json", 
        "x-log-requestid": "5640651199248CAA2300C2BA"
    }
    Body:
    {
        "count": 3, 
        "externalstores": 
        [
            "ecs_store", 
            "rds_store", 
            "ecs_store1"
        ], 
        "total": 3
    }

Error codes

HTTP status code Error code Error message Description
400 ProjectAlreadyExist Project {project} already exists. The error message returned because the specified project already exists.
400 ParameterInvalid The body is not valid json string. The error message returned because a parameter value is invalid.
500 InternalServerError Specified Server Error Message. The error message returned because an internal server error has occurred.

For more information about the error codes, see Common error codes.