API 名称:EnableAccessLog。
API 域名:open.volcengineapi.com。
API 描述:开启访问日志。
节流限制:每秒最多提交 5 个 API 请求。
在使用该部分 API 提交请求时必须包含以下 URI 参数。
除了 URI 参数,该 API 请求还需要包含签名参数。关于更多签名参数的信息,参见公共请求参数。
名称 | 类型 | 是否必选 | 格式 | 说明 |
---|---|---|---|---|
Action | string | 是 | [a-zA-Z]+ | API 名称,如 EnableAccessLog。 |
Version | string | 是 | YYYY-MM-DD | API 版本信息。该参数的取值是 2020-04-01 。 |
X-Expires | int | 否 | 900 | 表示签名的有效时间,单位是秒,默认值是900。 |
在使用该 API 提交请求时,请求参数中可以包含的参数如下。
参数 | 类型 | 是否必选 | 参数说明 | 示例值 |
---|---|---|---|---|
LoadBalancerId | String | 是 | ALB 实例ID。 | alb-bp1b6c719dfa08ex**** |
BucketName | String | 是 | 用于存储访问日志的对象存储桶的名称。 | alb-tos1 |
参数 | 类型 | 参数说明 | 示例值 |
---|---|---|---|
RequestId | String | 请求ID。 | 20210811152539010225146063030**** |
GET /?Action=EnableAccessLog&Version=2020-04-01&LoadBalancerId=alb-bp1b6c719dfa08ex****&BucketName=alb-tos1 HTTP/1.1 Host: open.volcengineapi.com Region: cn-test ServiceName: alb
{ "ResponseMetadata": { "RequestId": "202108171522560****524314701095A5A", "Action": "EnableAccessLog", "Version": "2020-04-01", "Service": "alb", "Region": "cn-test" }, "Result": { "RequestId": "202108171522560****524314701095A5A" } }
如果响应正文包含 Error 字段,则表示 API 请求失败。此处仅展示当前 API 的错误码,更多错误码请参见公共错误码。
HTTP Code | 错误码 | 错误信息 | 错误描述 |
---|---|---|---|
400 | OperationDenied.AccountArrears | The request on the specified resource is denied due to the account being in arrears status. | 因账号处于欠费状态,对于该资源的操作请求被拒绝。 |
409 | InvalidAccessLog.Conflict | The specified AccessLog of the LoadBalancer already exists. | 指定的 ALB 实例的访问日志投递功能已存在。 |
400 | OperationFailed.QueryIAM | The request on the specified resource failed due to the query on IAM failed. | 因请求 IAM 失败,对于该资源的操作请求失败。 |
400 | InvalidBucketName.NotFound | The specified Bucket does not exist. | 指定的存储桶不存在。 |
400 | OperationFailed.QueryTos | The request on the specified resource failed due to the query on TOS failed. | 因请求 TOS 失败,对于该资源的操作请求失败。 |
400 | InvalidLoadBalancer.InvalidStatus | The specified LoadBalancer is not in the correct status for the request. | 指定的 ALB 实例所处状态无法响应该请求。 |
403 | Forbidden | You are not authorized to delivery access log to TOS. | 您无权限开启访问日志投递TOS。 |
404 | InvalidLoadBalancer.NotFound | The specified LoadBalancer does not exist. | 指定的 ALB 实例不存在。 |