UpdateDeliveryConfiguration - Amazon CloudWatch Logs (original) (raw)

Use this operation to update the configuration of a delivery to change either the S3 path pattern or the format of the delivered logs. You can't use this operation to change the source or destination of the delivery.

Request Syntax

{
   "fieldDelimiter": "string",
   "id": "string",
   "recordFields": [ "string" ],
   "s3DeliveryConfiguration": { 
      "enableHiveCompatiblePath": boolean,
      "suffixPath": "string"
   }
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

fieldDelimiter

The field delimiter to use between record fields when the final output format of a delivery is in Plain, W3C, or Raw format.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 5.

Required: No

id

The ID of the delivery to be updated by this request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[0-9A-Za-z]+$

Required: Yes

recordFields

The list of record fields to be delivered to the destination, in order. If the delivery's log source has mandatory fields, they must be included in this list.

Type: Array of strings

Array Members: Minimum number of 0 items. Maximum number of 128 items.

Length Constraints: Minimum length of 1. Maximum length of 64.

Required: No

s3DeliveryConfiguration

This structure contains parameters that are valid only when the delivery's delivery destination is an S3 bucket.

Type: S3DeliveryConfiguration object

Required: No

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You don't have sufficient permissions to perform this action.

HTTP Status Code: 400

ConflictException

This operation attempted to create a resource that already exists.

HTTP Status Code: 400

ResourceNotFoundException

The specified resource does not exist.

HTTP Status Code: 400

ServiceUnavailableException

The service cannot complete the request.

HTTP Status Code: 500

ThrottlingException

The request was throttled because of quota limits.

HTTP Status Code: 400

ValidationException

One of the parameters for the request is not valid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: