Modifies the configurations that are used to detect unusual logons to your servers. The configurations that you can modify include the common logon location, IP address, time range, and account.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyLoginBaseConfig

The operation that you want to perform. Set the value to ModifyLoginBaseConfig.

Type String Yes login_common_location

The type of logon configuration that you want to modify. Valid values:

  • login_common_location: common logon location
  • login_common_ip: common logon IP address
  • login_common_time: common logon time range
  • login_common_account: common logon account
Config String Yes {"totalCount":174,"uuidCount":4,"location":"Montenegro","id":0}

The details about the configurations that are used to detect unusual logons to your servers. The value of this parameter is in the JSON format and contains the following fields:

  • totalCount: the total number of servers.
  • uuidCount: the number of servers to which the configuration is applied.
  • id: the ID of the configuration.
  • location: the name of the common logon location.
Note You must specify location only if the Type parameter is set to login_common_location.
  • ip: the common logon IP address.
Note You must specify ip only if the Type parameter is set to login_common_ip.
  • startTime: the start time of the common logon time range.
Note You must specify startTime only if the Type parameter is set to login_common_time.
  • endTime: the end time of the common logon time range.
Note You must specify endTime only if the Type parameter is set to login_common_time.
  • account: the common logon account.
Note You must specify account only if the Type parameter is set to login_common_account.
Target String Yes [{"target":"inet-7c676676-06fa-442e-90fb-b802e5d6****","targetType":"uuid","flag":"add"}]

The configurations of the server to which the configuration is applied. The value of this parameter is in the JSON format and contains the following fields:

  • Target: the UUID of the server that you want to add or remove.
  • targetType: the type of the server to which the configuration is applied. Valid values:
    • uuid: a server
    • groupId: a server group
  • flag: the operation that you want to perform on the server. Valid values:
    • del: removes the server from the configuration.
    • add: adds the server to the configuration.

Response parameters

Parameter Type Example Description
RequestId String AB96FDDF-ED29-52B1-9FAE-8203F2808F24

The ID of the request, which is used to locate and troubleshoot issues.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyLoginBaseConfig
&Type=login_common_location
&Config={"totalCount":174,"uuidCount":4,"location":"Peninsula of Macao","id":0}
&Target=[{"target":"inet-7c676676-06fa-442e-90fb-b802e5d6****","targetType":"uuid","flag":"add"}]
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyLoginBaseConfigResponse>
    <RequestId>AB96FDDF-ED29-52B1-9FAE-8203F2808F24</RequestId>
</ModifyLoginBaseConfigResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "AB96FDDF-ED29-52B1-9FAE-8203F2808F24"
}

Error codes

HTTP status code Error code Error message Description
400 DataNotExists %s data not exist The error message returned because the specified data does not exist.
500 ServerError ServerError The error message returned because a server error occurred.

For a list of error codes, visit the API Error Center.