Domain name for API request: cloudaudit.tencentcloudapi.com.
Parameter requirements:
IsCreateNewBucket
exists, cosRegion
and osBucketName
are required.IsEnableCmqNotify
is 1, IsCreateNewQueue
, CmqRegion
, and CmqQueueName
are required.IsEnableCmqNotify
is 0, IsCreateNewQueue
, CmqRegion
, and CmqQueueName
cannot be passed in.IsEnableKmsEncry
is 1, KmsRegion
and KeyId
are required.A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: CreateAudit. |
Version | Yes | String | Common Params. The value used for this API: 2019-03-19. |
Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. This API only supports: ap-guangzhou. |
IsEnableCmqNotify | Yes | Integer | Whether to enable CMQ message notification. 1: Yes; 0: No. Only CMQ queue service is currently supported. If CMQ message notification is enabled, CloudAudit will deliver your log contents to the designated queue in the specified region in real time. |
ReadWriteAttribute | Yes | Integer | Manages the read/write attribute of event. Valid values: 1 (read-only), 2 (write-only), 3 (read/write). |
AuditName | Yes | String | Tracking set name, which can contain 3–128 ASCII letters (a–z; A–Z), digits (0–9), and underscores (_). |
CosRegion | Yes | String | COS region. Supported regions can be queried through the ListCosEnableRegion API. |
IsCreateNewBucket | Yes | Integer | Whether to create a COS bucket. 1: Yes; 0: No. |
CosBucketName | Yes | String | User-defined COS bucket name, which can only contain 1–40 lowercase letters (a–z), digits (0–9), and dashes (-) and cannot begin or end with "-". If a bucket is not newly created, CloudAudit will not verify whether it actually exists. Enter the name with caution to avoid log delivery failure and consequent data loss. |
KeyId | No | String | Globally unique ID of the CMK. This value is required if it is not a newly created KMS element. It can be obtained through ListKeyAliasByRegion . CloudAudit will not verify the validity of the KeyId . Enter it carefully to avoid data loss. |
CmqQueueName | No | String | Queue name, which must begin with a letter and can contain up to 64 letters, digits, and dashes (-). This field is required if the value of IsEnableCmqNotify is 1. If a queue is not newly created, CloudAudit will not verify whether it actually exists. Enter the name with caution to avoid log delivery failure and consequent data loss. |
KmsRegion | No | String | KMS region. Currently supported regions can be obtained through ListKmsEnableRegion . This must be the same as the COS region. |
IsEnableKmsEncry | No | Integer | Whether to enable KMS encryption. 1: Yes, 0: No. If KMS encryption is enabled, the data will be encrypted when delivered to COS. |
CmqRegion | No | String | Region where the queue is located. Supported CMQ regions can be queried through the ListCmqEnableRegion API. This field is required if the value of IsEnableCmqNotify is 1. |
LogFilePrefix | No | String | Log file prefix, which can only contain 3–40 ASCII letters (a–z; A–Z) and digits (0–9). It can be left empty and is the account ID by default. |
IsCreateNewQueue | No | Integer | Whether to create a queue. 1: Yes; 0: No. This field is required if the value of IsEnableCmqNotify is 1. |
Parameter Name | Type | Description |
---|---|---|
IsSuccess | Integer | Whether creation succeeded. |
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
This example shows you how to create a tracking set.
https://cloudaudit.tencentcloudapi.com/?Action=CreateAudit
&AuditName=auditTest_1
&CmqQueueName=cmq-01
&CmqRegion=sh
&CosBucketName=cos-01
&CosRegion=ap-shanghai
&IsCreateNewBucket=1
&IsCreateNewQueue=1
&IsEnableCmqNotify=1
&LogFilePrefix=akshsb1j
&ReadWriteAttribute=2
&<Common request parameters>
{
"Response": {
"IsSuccess": 1,
"RequestId": "e9501707-784a-474c-b524-67ed9d3a6b50"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
FailedOperation.CreateBucketFail | Failed to create the COS bucket. |
InternalError.CmqError | An exception occurred while creating the CMQ queue, probably because the CMQ queue to be created already exists, or your account has no permission or has overdue payments. |
InternalError.CreateAuditError | An error occurred while creating the tracking set. Submit a ticket for assistance. |
InvalidParameterValue.AuditNameError | The tracking set name is non-compliant. |
InvalidParameterValue.CmqRegionError | CloudAudit currently does not support the entered CMQ region. |
InvalidParameterValue.CosNameError | The entered COS bucket name is non-compliant. |
InvalidParameterValue.CosRegionError | CloudAudit currently does not support the entered COS region. |
InvalidParameterValue.IsCreateNewBucketError | The value of IsCreateNewBucket can be 0 or 1. 0 indicates not to create a bucket, while 1 indicates to create a bucket. |
InvalidParameterValue.IsCreateNewQueueError | The value of IsCreateNewQueue can be 0 or 1. 0 indicates not to create a queue, while 1 indicates to create a queue. |
InvalidParameterValue.IsEnableCmqNotifyError | The value of IsEnableCmqNotify can be 0 or 1. 0 indicates not to enable CMQ delivery, while 1 indicates to enable CMQ delivery. |
InvalidParameterValue.LogFilePrefixError | The log prefix format is incorrect. |
InvalidParameterValue.QueueNameError | The entered queue name is non-compliant. |
InvalidParameterValue.ReadWriteAttributeError | Valid values of the read/write attribute: 1 (read-only), 2 (write-only), 3 (read/write). |
LimitExceeded.OverAmount | The maximum number of tracking sets has been exceeded. |
MissingParameter.MissAuditName | The tracking set name is missing. |
MissingParameter.MissCosBucketName | The COS bucket parameter is missing. |
MissingParameter.MissCosRegion | The COS region parameter is missing. |
MissingParameter.cmq | If the value of IsEnableCmqNotify is 1, IsCreateNewQueue , CmqQueueName , and CmqRegion are required. |
ResourceInUse.AlreadyExistsSameAudit | A tracking set with the same name already exists. |
ResourceInUse.AlreadyExistsSameAuditCmqConfig | A tracking set with the same CMQ delivery configuration already exists. |
ResourceInUse.AlreadyExistsSameAuditCosConfig | A tracking set with the same COS delivery configuration already exists. |
ResourceInUse.CosBucketExists | The COS bucket already exists. |
ResourceNotFound.RoleNotExist | The role doesn’t exist. |
Was this page helpful?