Skip to content

Commit

Permalink
feat(AWSCloudWatchLogs): update models to latest
Browse files Browse the repository at this point in the history
  • Loading branch information
awsmobilesdk committed Sep 20, 2023
1 parent 4e8df0b commit 3c21dd7
Show file tree
Hide file tree
Showing 4 changed files with 26 additions and 9 deletions.
5 changes: 5 additions & 0 deletions AWSLogs/AWSLogsModel.h
Original file line number Diff line number Diff line change
Expand Up @@ -2045,6 +2045,11 @@ typedef NS_ENUM(NSInteger, AWSLogsStandardUnit) {
@interface AWSLogsPutQueryDefinitionRequest : AWSRequest


/**
<p>Used as an idempotency token, to avoid returning an exception if the service receives the same request twice because of a network error.</p>
*/
@property (nonatomic, strong) NSString * _Nullable clientToken;

/**
<p>Use this parameter to include specific log groups as part of your query definition.</p><p>If you are updating a query definition and you omit this parameter, then the updated definition will contain no log groups.</p>
*/
Expand Down
1 change: 1 addition & 0 deletions AWSLogs/AWSLogsModel.m
Original file line number Diff line number Diff line change
Expand Up @@ -1837,6 +1837,7 @@ + (BOOL)supportsSecureCoding {

+ (NSDictionary *)JSONKeyPathsByPropertyKey {
return @{
@"clientToken" : @"clientToken",
@"logGroupNames" : @"logGroupNames",
@"name" : @"name",
@"queryDefinitionId" : @"queryDefinitionId",
Expand Down
17 changes: 14 additions & 3 deletions AWSLogs/AWSLogsResources.m
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ - (NSString *)definitionString {
{\"shape\":\"OperationAbortedException\"},\
{\"shape\":\"ServiceUnavailableException\"}\
],\
\"documentation\":\"<p>Creates a log group with the specified name. You can create up to 20,000 log groups per account.</p> <p>You must use the following guidelines when naming a log group:</p> <ul> <li> <p>Log group names must be unique within a Region for an Amazon Web Services account.</p> </li> <li> <p>Log group names can be between 1 and 512 characters long.</p> </li> <li> <p>Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), '.' (period), and '#' (number sign)</p> </li> </ul> <p>When you create a log group, by default the log events in the log group do not expire. To set a retention policy so that events expire and are deleted after a specified time, use <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html\\\">PutRetentionPolicy</a>.</p> <p>If you associate an KMS key with the log group, ingested data is encrypted using the KMS key. This association is stored as long as the data encrypted with the KMS key is still within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data whenever it is requested.</p> <p>If you attempt to associate a KMS key with the log group but the KMS key does not exist or the KMS key is disabled, you receive an <code>InvalidParameterException</code> error. </p> <important> <p>CloudWatch Logs supports only symmetric KMS keys. Do not associate an asymmetric KMS key with your log group. For more information, see <a href=\\\"https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html\\\">Using Symmetric and Asymmetric Keys</a>.</p> </important>\"\
\"documentation\":\"<p>Creates a log group with the specified name. You can create up to 1,000,000 log groups per Region per account.</p> <p>You must use the following guidelines when naming a log group:</p> <ul> <li> <p>Log group names must be unique within a Region for an Amazon Web Services account.</p> </li> <li> <p>Log group names can be between 1 and 512 characters long.</p> </li> <li> <p>Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), '.' (period), and '#' (number sign)</p> </li> </ul> <p>When you create a log group, by default the log events in the log group do not expire. To set a retention policy so that events expire and are deleted after a specified time, use <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html\\\">PutRetentionPolicy</a>.</p> <p>If you associate an KMS key with the log group, ingested data is encrypted using the KMS key. This association is stored as long as the data encrypted with the KMS key is still within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data whenever it is requested.</p> <p>If you attempt to associate a KMS key with the log group but the KMS key does not exist or the KMS key is disabled, you receive an <code>InvalidParameterException</code> error. </p> <important> <p>CloudWatch Logs supports only symmetric KMS keys. Do not associate an asymmetric KMS key with your log group. For more information, see <a href=\\\"https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html\\\">Using Symmetric and Asymmetric Keys</a>.</p> </important>\"\
},\
\"CreateLogStream\":{\
\"name\":\"CreateLogStream\",\
Expand Down Expand Up @@ -677,7 +677,7 @@ - (NSString *)definitionString {
{\"shape\":\"LimitExceededException\"},\
{\"shape\":\"ServiceUnavailableException\"}\
],\
\"documentation\":\"<p>Creates or updates a metric filter and associates it with the specified log group. With metric filters, you can configure rules to extract metric data from log events ingested through <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html\\\">PutLogEvents</a>.</p> <p>The maximum number of metric filters that can be associated with a log group is 100.</p> <p>When you create a metric filter, you can also optionally assign a unit and dimensions to the metric that is created.</p> <important> <p>Metrics extracted from log events are charged as custom metrics. To prevent unexpected high charges, do not specify high-cardinality fields such as <code>IPAddress</code> or <code>requestID</code> as dimensions. Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric. </p> <p>CloudWatch Logs disables a metric filter if it generates 1,000 different name/value pairs for your specified dimensions within a certain amount of time. This helps to prevent accidental high charges.</p> <p>You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html\\\"> Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges</a>. </p> </important>\"\
\"documentation\":\"<p>Creates or updates a metric filter and associates it with the specified log group. With metric filters, you can configure rules to extract metric data from log events ingested through <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html\\\">PutLogEvents</a>.</p> <p>The maximum number of metric filters that can be associated with a log group is 100.</p> <p>When you create a metric filter, you can also optionally assign a unit and dimensions to the metric that is created.</p> <important> <p>Metrics extracted from log events are charged as custom metrics. To prevent unexpected high charges, do not specify high-cardinality fields such as <code>IPAddress</code> or <code>requestID</code> as dimensions. Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric. </p> <p>CloudWatch Logs might disable a metric filter if it generates 1,000 different name/value pairs for your specified dimensions within one hour.</p> <p>You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html\\\"> Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges</a>. </p> </important>\"\
},\
\"PutQueryDefinition\":{\
\"name\":\"PutQueryDefinition\",\
Expand Down Expand Up @@ -723,7 +723,7 @@ - (NSString *)definitionString {
{\"shape\":\"OperationAbortedException\"},\
{\"shape\":\"ServiceUnavailableException\"}\
],\
\"documentation\":\"<p>Sets the retention of the specified log group. With a retention policy, you can configure the number of days for which to retain log events in the specified log group.</p> <note> <p>CloudWatch Logs doesn’t immediately delete log events when they reach their retention setting. It typically takes up to 72 hours after that before log events are deleted, but in rare situations might take longer.</p> <p>To illustrate, imagine that you change a log group to have a longer retention setting when it contains log events that are past the expiration date, but haven’t been deleted. Those log events will take up to 72 hours to be deleted after the new retention date is reached. To make sure that log data is deleted permanently, keep a log group at its lower retention setting until 72 hours after the previous retention period ends. Alternatively, wait to change the retention setting until you confirm that the earlier log events are deleted. </p> </note>\"\
\"documentation\":\"<p>Sets the retention of the specified log group. With a retention policy, you can configure the number of days for which to retain log events in the specified log group.</p> <note> <p>CloudWatch Logs doesn’t immediately delete log events when they reach their retention setting. It typically takes up to 72 hours after that before log events are deleted, but in rare situations might take longer.</p> <p>To illustrate, imagine that you change a log group to have a longer retention setting when it contains log events that are past the expiration date, but haven’t been deleted. Those log events will take up to 72 hours to be deleted after the new retention date is reached. To make sure that log data is deleted permanently, keep a log group at its lower retention setting until 72 hours after the previous retention period ends. Alternatively, wait to change the retention setting until you confirm that the earlier log events are deleted. </p> <p>When log events reach their retention setting they are marked for deletion. After they are marked for deletion, they do not add to your archival storage costs anymore, even if they are not actually deleted until later. These log events marked for deletion are also not included when you use an API to retrieve the <code>storedBytes</code> value to see how many bytes a log group is storing.</p> </note>\"\
},\
\"PutSubscriptionFilter\":{\
\"name\":\"PutSubscriptionFilter\",\
Expand Down Expand Up @@ -933,6 +933,12 @@ - (NSString *)definitionString {
}\
}\
},\
\"ClientToken\":{\
\"type\":\"string\",\
\"max\":128,\
\"min\":36,\
\"pattern\":\"\\\\S{36,128}\"\
},\
\"CreateExportTaskRequest\":{\
\"type\":\"structure\",\
\"required\":[\
Expand Down Expand Up @@ -2619,6 +2625,11 @@ - (NSString *)definitionString {
\"queryString\":{\
\"shape\":\"QueryDefinitionString\",\
\"documentation\":\"<p>The query string to use for this definition. For more information, see <a href=\\\"https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html\\\">CloudWatch Logs Insights Query Syntax</a>.</p>\"\
},\
\"clientToken\":{\
\"shape\":\"ClientToken\",\
\"documentation\":\"<p>Used as an idempotency token, to avoid returning an exception if the service receives the same request twice because of a network error.</p>\",\
\"idempotencyToken\":true\
}\
}\
},\
Expand Down
Loading

0 comments on commit 3c21dd7

Please sign in to comment.