Modifies a configuration recorder.

Only Cloud Config for individuals supports this operation.

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 PutConfigurationRecorder

The operation that you want to perform. Set the value to PutConfigurationRecorder.
ResourceTypes String Yes ACS::ECS::Instance,ACS::ECS::Disk

The types of the resources that you want Cloud Config to monitor. Separate multiple resources with commas (,).

Response parameters

Parameter Type Example Description
ConfigurationRecorder Struct

The details of the configuration recorder.
AccountId Long 123456789

The ID of your Alibaba Cloud account.
ConfigurationRecorderStatus String REGISTERED

The status of the configuration recorder. Valid values:

  • REGISTRABLE: The configuration recorder has not been registered.
  • BUILDING: The configuration recorder is in deployment.
  • REGISTERED: The configuration recorder has been registered.
  • REBUILDING: The configuration recorder is being redeployed.
ResourceTypes List ACS::ECS::Instance,ACS::ECS::Disk

The types of resources that are monitored.
RequestId String A3601178-A6A2-4636-BE56-1116F73C0B0C

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=PutConfigurationRecorder
&ResourceTypes=ACS::ECS::Instance,ACS::ECS::Disk
&<Common request parameters>

Sample success responses

XML format 

<PutConfigurationRecorderResponse>
          <RequestId>7C189ED2-30C1-492E-82B6-0D828B556ED9</RequestId>
          <ConfigurationRecorder>
                <ConfigurationRecorderStatus>REBUILDING</ConfigurationRecorderStatus>
                <ResourceTypes>ACS::ECS::Instance</ResourceTypes>
                <ResourceTypes>ACS::ECS::Disk</ResourceTypes>
                <AccountId>103201326074****</AccountId>
          </ConfigurationRecorder>
</PutConfigurationRecorderResponse>

JSON format 

{
    "RequestId": "7C189ED2-30C1-492E-82B6-0D828B556ED9",
    "ConfigurationRecorder": {
        "ConfigurationRecorderStatus": "REBUILDING",
        "ResourceTypes": [
            "ACS::ECS::Instance",
            "ACS::ECS::Disk"
        ],
        "AccountId": "103201326074****"
    }
}

Error codes

HTTP status code Error code Error message Description
400 NoPermission You are not authorized to perform this operation. The error message returned because you are not authorized to perform the specified operation.
503 ServiceUnavailable The request has failed due to a temporary failure of the server. The error message returned because the service is unavailable.
404 AccountNotExisted Your account does not exist. The error message returned because your account does not exist.
400 Invalid.ResourceTypes.Value The specified resourceTypes is invalid. The error message returned because the specified resource type is invalid.
400 ProcessIsRunning The process is running. The error message returned because the service initialization is in progress.
400 EnterpriseEditionAllResourceTypesDefault The Enterprise Edition monitor all resource types by default. The error message returned because Cloud Config for Enterprise monitors all supported types of resources by default and you cannot use a master account to modify the monitoring scope.
400 RDMemberNoPermission You are not authorized to perform the operation. The reasons include: 1. You have not enabled the resource directory service. 2. You are not using the administrator account of resource directory. The error message returned because you are not authorized to perform the specified operation potentially for one of the following reasons:1. You have not enabled a resource directory.2. You are using a member account of the specified resource directory.

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