All Products
Search
Document Center

Simple Log Service:ListExternalStore

Last Updated:Oct 26, 2023

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
    ParameterTypeRequiredExampleDescription
    externalStoreNamestringNoNone.The external stores whose names contain the string.
    offsetintegerNo0The external stores are queried from the offset position.
    linesintegerNo10The 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.
    ParameterTypeExampleDescription
    countInteger3The number of returned external stores.
    totalInteger3The total number of external stores on the server.
    externalstoresString arrayecs_store, rds_store, and ecs_store1The 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 codeError codeError messageDescription
400ProjectAlreadyExistProject {project} already exists.The error message returned because the specified project already exists.
400ParameterInvalidThe body is not valid json string.The error message returned because a parameter value is invalid.
500InternalServerErrorSpecified Server Error Message.The error message returned because an internal server error has occurred.

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