All Products
Search
Document Center

ApsaraDB for MongoDB:DescribeActiveOperationTasks

Last Updated:Sep 03, 2024

Queries the scheduled O\\\&M tasks of an ApsaraDB for MongoDB instance.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
dds:DescribeActiveOperationTaskslist
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
RegionstringNo

The region ID of the instance.

Note If you set the Region parameter to all, all tasks created within your Alibaba Cloud account are queried. In this case, you must set the taskType parameter to all.
cn-beijing
TaskTypestringNo

The task type.

***
PageSizeintegerNo

The number of entries to return on each page. Valid values: 30, 50, and 100. Default value: 30.

30
PageNumberintegerNo

The page number of the page to return.

1
ProductIdstringNo

The ID of the service.

***
DbTypestringNo

The type of the database engine.

***
StatusintegerNo

The status of the task. Valid values:

  • 0: waiting for execution
  • 1: being executed
  • 2: successful
  • 3: failed
0
InsNamestringNo

The name of the instance.

dds-bp16aaccfe10e3e4
AllowChangeintegerNo

Specifies whether to allow the modification operation. Valid values:

  • 0: The modification operation is not allowed.
  • 1: The modification operation is allowed.
-1
AllowCancelintegerNo

Specifies whether to allow the cancellation operation. Valid values:

  • 0: The cancellation operation is not allowed.
  • 1: The cancellation operation is allowed.
***
ChangeLevelstringNo

The type of task configuration change. Valid values:

  • all (default): The configurations of all O&M tasks are changed.
  • S0: The configurations of tasks initiated to fix exceptions are changed.
  • S1: The configurations of system O&M tasks are changed.
***

Response parameters

ParameterTypeDescriptionExample
object
PageNumberinteger

The number of the returned page.

1
RequestIdstring

The request ID.

111E7B16-0A87-4CBA-B271-F34AD61E099F
PageSizeinteger

The number of entries returned per page.

30
TotalRecordCountinteger

The total number of returned entries.

727
Itemsarray<object>

The O&M tasks.

object

The list of O&M tasks.

Statusinteger

N/A

***
ChangeLevelEnstring

N/A

***
TaskTypestring

The task type.

***
InsNamestring

The ID of the node.

***
Regionstring

The region of the instance.

cn-hangzhou
ImpactZhstring

N/A

***
CreatedTimestring

The time when the task was created.

2021-07-14 10:48:43
SwitchTimestring

The switchover point in time in which disconnection may occur. The time follows the ISO 8601 standard in the yyyy-mm-ddThh:mm:ssZ format. The time is displayed in UTC.

2022-11-24T11:20:00Z
ChangeLevelZhstring

The task type in English.

***
Deadlinestring

The end time of the O&M task.

1646014421633
PrepareIntervalstring

The required preparation period between the task start time and the switchover time. The time is displayed in the HH:mm:ss format.

***
TaskTypeZhstring

The task type in Chinese.

***
CurrentAVZstring

N/A

***
AllowChangestring

Indicates whether the modification operation is allowed.

  • 0: The modification operation is not allowed.
  • 1: The modification operation is allowed.
0
DbVersionstring

The version of the database engine.

5.6
ImpactEnstring

N/A

***
InsCommentstring

The description of the instance.

***
StartTimestring

The start time of the task. The time follows the ISO 8601 standard in the yyyy-mm-dd Thh:mm:ssZ format. The time is displayed in UTC.

2022-12-24T06:01:05Z
ModifiedTimestring

The time when the task is modified. The time follows the ISO 8601 standard in the yyyy-mm-ddThh:mm:ssZ format. The time is displayed in UTC.

2022-12-24T09:48:01Z
AllowCancelstring

N/A

***
DbTypestring

The type of the database engine.

mongoDb
ChangeLevelstring

The change level of the O&M task.

***
TaskTypeEnstring

N/A

***
ResultInfostring

The result information. The value of this parameter can be ignored.

***
Idinteger

The task ID.

***
SubInsNamesarray

The subinstances.

string

The name of the subinstance.

***

Examples

Sample success responses

JSONformat

{
  "PageNumber": 1,
  "RequestId": "111E7B16-0A87-4CBA-B271-F34AD61E099F",
  "PageSize": 30,
  "TotalRecordCount": 727,
  "Items": [
    {
      "Status": 0,
      "ChangeLevelEn": "***",
      "TaskType": "***",
      "InsName": "***",
      "Region": "cn-hangzhou",
      "ImpactZh": "***",
      "CreatedTime": "2021-07-14 10:48:43",
      "SwitchTime": "2022-11-24T11:20:00Z",
      "ChangeLevelZh": "***",
      "Deadline": "1646014421633",
      "PrepareInterval": "***",
      "TaskTypeZh": "***",
      "CurrentAVZ": "***",
      "AllowChange": "0",
      "DbVersion": "5.6",
      "ImpactEn": "***",
      "InsComment": "***",
      "StartTime": "2022-12-24T06:01:05Z",
      "ModifiedTime": "2022-12-24T09:48:01Z",
      "AllowCancel": "***",
      "DbType": "mongoDb",
      "ChangeLevel": "***",
      "TaskTypeEn": "***",
      "ResultInfo": "***",
      "Id": 0,
      "SubInsNames": [
        "***"
      ]
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.