Creates index analysis tasks for an AsparaDB for MongoDB instance.

Before you call this operation, make sure that the following requirements are met:

  • The region of the instance is China (Hangzhou), China (Shanghai), China (Shenzhen), China (Qingdao), or China (Beijing).
  • The instance is a replica set instance or a sharded cluster instance.
  • The audit log feature is enabled for the instance.
Note
  • After calling this operation to create index analysis tasks, you can call the DescribeAvailableTimeRange operation to query corresponding tasks and their statuses.
  • This API can be called up to 10 times each day.

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 CreateRecommendationTask

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

StartTime String Yes 2019-01-01T12Z

The beginning of the time range to query. Specify the time in the yyyy-MM-ddTHHZ format. The time must be in UTC.

Note The value of StartTime must be later than the time when the log audit function was enabled.
EndTime String Yes 2019-01-01T18Z

The end of the time range to query. Specify the time in the yyyy-MM-ddTHHZ format. The time must be in UTC.

Note The maximum time range is 7 days.
InstanceId String Yes dds-bpxxxxxxxx

The ID of the instance.

Note If you set this parameter to the ID of a sharded cluster instance, you must also specify the NodeId parameter.
NodeId String No d-bpxxxxxxxx

The ID of the shard node in the sharded cluster instance.

Note This parameter takes effect only when you set the DBInstanceId parameter to the ID of a sharded cluster instance.
RegionId String No cn-hangzhou

The region ID of the instance. You can call the DescribeDBInstanceAttribute operation to query the region ID of an instance.

AccessKeyId String No LTAIgbTGpxxxxxx

The AccessKey ID provided to you by Alibaba Cloud.

Response parameters

Parameter Type Example Description
RequestId String 009D2572-6839-43C0-8D89-44DB46CBA2EA

The ID of the request.

Examples

Sample requests


http(s)://mongodb.aliyuncs.com/? Action=CreateRecommendationTask
&StartTime=2019-01-01T12Z
&EndTime=2019-01-01T18Z
&InstanceId=dds-bpxxxxxxxx
&<Common request parameters>

Sample success responses

XML format

<CreateRecommendationTaskResponse>
	  <RequestId>009D2572-6839-43C0-8D89-44DB46CBA2EA</RequestId>
</CreateRecommendationTaskResponse>

JSON format

{ &quot;RequestId&quot;:&quot;009D2572-6839-43C0-8D89-44DB46CBA2EA&quot; }

Error codes

HTTP status code Error code Error message Description
400 InvalidEndTime.Format Specified end time is not valid. The error message returned because the end of the time range to query is invalid. Check the format of the specified time.

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