From 50060dd775b57f36da7fb2f08024f9c3556a7b48 Mon Sep 17 00:00:00 2001 From: Alex Wood Date: Thu, 27 Aug 2015 16:45:39 -0700 Subject: [PATCH] API Update for Aws::ConfigService Adds support for the `#list_discovered_resources` API. --- CHANGELOG.md | 3 + .../apis/config/2014-11-12/api-2.json | 69 ++++++++++++++++ .../apis/config/2014-11-12/docs-2.json | 82 ++++++++++++++++--- 3 files changed, 142 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3fdb0fa5dae..95d7ec601e2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,9 @@ Unreleased Changes ------------------ +* Feature - Aws::ConfigService - Adds support for the + `#list_discovered_resources` API. + 2.1.16 (2015-08-25) ------------------ diff --git a/aws-sdk-core/apis/config/2014-11-12/api-2.json b/aws-sdk-core/apis/config/2014-11-12/api-2.json index 0169d15471d..3d0a81b11d9 100644 --- a/aws-sdk-core/apis/config/2014-11-12/api-2.json +++ b/aws-sdk-core/apis/config/2014-11-12/api-2.json @@ -147,6 +147,33 @@ } ] }, + "ListDiscoveredResources":{ + "name":"ListDiscoveredResources", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListDiscoveredResourcesRequest"}, + "output":{"shape":"ListDiscoveredResourcesResponse"}, + "errors":[ + { + "shape":"ValidationException", + "exception":true + }, + { + "shape":"InvalidLimitException", + "exception":true + }, + { + "shape":"InvalidNextTokenException", + "exception":true + }, + { + "shape":"NoAvailableConfigurationRecorderException", + "exception":true + } + ] + }, "PutConfigurationRecorder":{ "name":"PutConfigurationRecorder", "http":{ @@ -249,6 +276,7 @@ "AccountId":{"type":"string"}, "AllSupported":{"type":"boolean"}, "AvailabilityZone":{"type":"string"}, + "AwsRegion":{"type":"string"}, "Boolean":{"type":"boolean"}, "ChannelName":{ "type":"string", @@ -294,6 +322,8 @@ "arn":{"shape":"ARN"}, "resourceType":{"shape":"ResourceType"}, "resourceId":{"shape":"ResourceId"}, + "resourceName":{"shape":"ResourceName"}, + "awsRegion":{"shape":"AwsRegion"}, "availabilityZone":{"shape":"AvailabilityZone"}, "resourceCreationTime":{"shape":"ResourceCreationTime"}, "tags":{"shape":"Tags"}, @@ -554,6 +584,25 @@ "min":0, "max":100 }, + "ListDiscoveredResourcesRequest":{ + "type":"structure", + "required":["resourceType"], + "members":{ + "resourceType":{"shape":"ResourceType"}, + "resourceIds":{"shape":"ResourceIdList"}, + "resourceName":{"shape":"ResourceName"}, + "limit":{"shape":"Limit"}, + "includeDeletedResources":{"shape":"Boolean"}, + "nextToken":{"shape":"NextToken"} + } + }, + "ListDiscoveredResourcesResponse":{ + "type":"structure", + "members":{ + "resourceIdentifiers":{"shape":"ResourceIdentifierList"}, + "nextToken":{"shape":"NextToken"} + } + }, "MaxNumberOfConfigurationRecordersExceededException":{ "type":"structure", "members":{ @@ -648,6 +697,7 @@ "members":{ "resourceType":{"shape":"ResourceType"}, "resourceId":{"shape":"ResourceId"}, + "resourceName":{"shape":"ResourceName"}, "relationshipName":{"shape":"RelationshipName"} } }, @@ -657,7 +707,26 @@ }, "RelationshipName":{"type":"string"}, "ResourceCreationTime":{"type":"timestamp"}, + "ResourceDeletionTime":{"type":"timestamp"}, "ResourceId":{"type":"string"}, + "ResourceIdList":{ + "type":"list", + "member":{"shape":"ResourceId"} + }, + "ResourceIdentifier":{ + "type":"structure", + "members":{ + "resourceType":{"shape":"ResourceType"}, + "resourceId":{"shape":"ResourceId"}, + "resourceName":{"shape":"ResourceName"}, + "resourceDeletionTime":{"shape":"ResourceDeletionTime"} + } + }, + "ResourceIdentifierList":{ + "type":"list", + "member":{"shape":"ResourceIdentifier"} + }, + "ResourceName":{"type":"string"}, "ResourceNotDiscoveredException":{ "type":"structure", "members":{ diff --git a/aws-sdk-core/apis/config/2014-11-12/docs-2.json b/aws-sdk-core/apis/config/2014-11-12/docs-2.json index fdda032b701..ae2ae1a1ca8 100644 --- a/aws-sdk-core/apis/config/2014-11-12/docs-2.json +++ b/aws-sdk-core/apis/config/2014-11-12/docs-2.json @@ -7,7 +7,8 @@ "DescribeConfigurationRecorders": "

Returns the name of one or more specified configuration recorders. If the recorder name is not specified, this action returns the names of all the configuration recorders associated with the account.

Currently, you can specify only one configuration recorder per account.

", "DescribeDeliveryChannelStatus": "

Returns the current status of the specified delivery channel. If a delivery channel is not specified, this action returns the current status of all delivery channels associated with the account.

Currently, you can specify only one delivery channel per account.", "DescribeDeliveryChannels": "

Returns details about the specified delivery channel. If a delivery channel is not specified, this action returns the details of all delivery channels associated with the account.

Currently, you can specify only one delivery channel per account.

", - "GetResourceConfigHistory": "

Returns a list of configuration items for the specified resource. The list contains details about each state of the resource during the specified time interval. You can specify a limit on the number of results returned on the page. If a limit is specified, a nextToken is returned as part of the result that you can use to continue this request.

Each call to the API is limited to span a duration of seven days. It is likely that the number of records returned is smaller than the specified limit. In such cases, you can make another call, using the nextToken .

", + "GetResourceConfigHistory": "

Returns a list of configuration items for the specified resource. The list contains details about each state of the resource during the specified time interval.

The response is paginated, and by default, AWS Config returns a limit of 10 configuration items per page. You can customize this number with the limit parameter. The response includes a nextToken string, and to get the next page of results, run the request again and enter this string for the nextToken parameter.

Each call to the API is limited to span a duration of seven days. It is likely that the number of records returned is smaller than the specified limit. In such cases, you can make another call, using the nextToken.

", + "ListDiscoveredResources": "

Accepts a resource type and returns a list of resource identifiers for the resources of that type. A resource identifier includes the resource type, ID, and (if available) the custom resource name. The results consist of resources that AWS Config has discovered, including those that AWS Config is not currently recording. You can narrow the results to include only resources that have specific resource IDs or a resource name.

You can specify either resource IDs or a resource name but not both in the same request.

The response is paginated, and by default AWS Config lists 100 resource identifiers on each page. You can customize this number with the limit parameter. The response includes a nextToken string, and to get the next page of results, run the request again and enter this string for the nextToken parameter.

", "PutConfigurationRecorder": "

Creates a new configuration recorder to record the selected resource configurations.

You can use this action to change the role roleARN and/or the recordingGroup of an existing recorder. To change the role, call the action on the existing configuration recorder and specify a role.

Currently, you can specify only one configuration recorder per account.

If ConfigurationRecorder does not have the recordingGroup parameter specified, the default is to record all supported resource types.

", "PutDeliveryChannel": "

Creates a new delivery channel object to deliver the configuration information to an Amazon S3 bucket, and to an Amazon SNS topic.

You can use this action to change the Amazon S3 bucket or an Amazon SNS topic of the existing delivery channel. To change the Amazon S3 bucket or an Amazon SNS topic, call this action and specify the changed values for the S3 bucket and the SNS topic. If you specify a different value for either the S3 bucket or the SNS topic, this action will keep the existing value for the parameter that is not changed.

Currently, you can specify only one delivery channel per account.

", "StartConfigurationRecorder": "

Starts recording configurations of the AWS resources you have selected to record in your AWS account.

You must have created at least one delivery channel to successfully start the configuration recorder.

", @@ -39,10 +40,17 @@ "ConfigurationItem$availabilityZone": "

The Availability Zone associated with the resource.

" } }, + "AwsRegion": { + "base": null, + "refs": { + "ConfigurationItem$awsRegion": "

The region where the resource resides.

" + } + }, "Boolean": { "base": null, "refs": { - "ConfigurationRecorderStatus$recording": "

Specifies whether the recorder is currently recording or not.

" + "ConfigurationRecorderStatus$recording": "

Specifies whether the recorder is currently recording or not.

", + "ListDiscoveredResourcesRequest$includeDeletedResources": "

Specifies whether AWS Config includes deleted resources in the results. By default, deleted resources are not included.

" } }, "ChannelName": { @@ -284,12 +292,12 @@ } }, "InvalidLimitException": { - "base": "

You have reached the limit on the pagination.

", + "base": "

The specified limit is outside the allowable range.

", "refs": { } }, "InvalidNextTokenException": { - "base": "

The specified nextToken for pagination is not valid.

", + "base": "

The specified next token is invalid. Specify the nextToken string that was returned in the previous response to get the next page of results.

", "refs": { } }, @@ -332,7 +340,18 @@ "Limit": { "base": null, "refs": { - "GetResourceConfigHistoryRequest$limit": "

The maximum number of configuration items returned in each page. The default is 10. You cannot specify a limit greater than 100.

" + "GetResourceConfigHistoryRequest$limit": "

The maximum number of configuration items returned on each page. The default is 10. You cannot specify a limit greater than 100. If you specify 0, AWS Config uses the default.

", + "ListDiscoveredResourcesRequest$limit": "

The maximum number of resource identifiers returned on each page. The default is 100. You cannot specify a limit greater than 100. If you specify 0, AWS Config uses the default.

" + } + }, + "ListDiscoveredResourcesRequest": { + "base": null, + "refs": { + } + }, + "ListDiscoveredResourcesResponse": { + "base": null, + "refs": { } }, "MaxNumberOfConfigurationRecordersExceededException": { @@ -354,12 +373,14 @@ "NextToken": { "base": null, "refs": { - "GetResourceConfigHistoryRequest$nextToken": "

An optional parameter used for pagination of the results.

", - "GetResourceConfigHistoryResponse$nextToken": "

A token used for pagination of results.

" + "GetResourceConfigHistoryRequest$nextToken": "

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

", + "GetResourceConfigHistoryResponse$nextToken": "

The string that you use in a subsequent request to get the next page of results in a paginated response.

", + "ListDiscoveredResourcesRequest$nextToken": "

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

", + "ListDiscoveredResourcesResponse$nextToken": "

The string that you use in a subsequent request to get the next page of results in a paginated response.

" } }, "NoAvailableConfigurationRecorderException": { - "base": "

There are no configuration recorders available to provide the role needed to describe your resources.

", + "base": "

There are no configuration recorders available to provide the role needed to describe your resources. Create a configuration recorder.

", "refs": { } }, @@ -446,7 +467,7 @@ "RelationshipName": { "base": null, "refs": { - "Relationship$relationshipName": "

The name of the related resource.

" + "Relationship$relationshipName": "

The type of relationship with the related resource.

" } }, "ResourceCreationTime": { @@ -455,12 +476,47 @@ "ConfigurationItem$resourceCreationTime": "

The time stamp when the resource was created.

" } }, + "ResourceDeletionTime": { + "base": null, + "refs": { + "ResourceIdentifier$resourceDeletionTime": "

The time that the resource was deleted.

" + } + }, "ResourceId": { "base": null, "refs": { "ConfigurationItem$resourceId": "

The ID of the resource (for example., sg-xxxxxx).

", "GetResourceConfigHistoryRequest$resourceId": "

The ID of the resource (for example., sg-xxxxxx).

", - "Relationship$resourceId": "

The resource ID of the related resource (for example, sg-xxxxxx).

" + "Relationship$resourceId": "

The ID of the related resource (for example, sg-xxxxxx).

", + "ResourceIdList$member": null, + "ResourceIdentifier$resourceId": "

The ID of the resource (for example., sg-xxxxxx).

" + } + }, + "ResourceIdList": { + "base": null, + "refs": { + "ListDiscoveredResourcesRequest$resourceIds": "

The IDs of only those resources that you want AWS Config to list in the response. If you do not specify this parameter, AWS Config lists all resources of the specified type that it has discovered.

" + } + }, + "ResourceIdentifier": { + "base": "

The details that identify a resource that is discovered by AWS Config, including the resource type, ID, and (if available) the custom resource name.

", + "refs": { + "ResourceIdentifierList$member": null + } + }, + "ResourceIdentifierList": { + "base": null, + "refs": { + "ListDiscoveredResourcesResponse$resourceIdentifiers": "

The details that identify a resource that is discovered by AWS Config, including the resource type, ID, and (if available) the custom resource name.

" + } + }, + "ResourceName": { + "base": null, + "refs": { + "ConfigurationItem$resourceName": "

The custom name of the resource, if available.

", + "ListDiscoveredResourcesRequest$resourceName": "

The custom name of only those resources that you want AWS Config to list in the response. If you do not specify this parameter, AWS Config lists all resources of the specified type that it has discovered.

", + "Relationship$resourceName": "

The custom name of the related resource, if available.

", + "ResourceIdentifier$resourceName": "

The custom name of the resource (if available).

" } }, "ResourceNotDiscoveredException": { @@ -473,14 +529,16 @@ "refs": { "ConfigurationItem$resourceType": "

The type of AWS resource.

", "GetResourceConfigHistoryRequest$resourceType": "

The resource type.

", + "ListDiscoveredResourcesRequest$resourceType": "

The type of resources that you want AWS Config to list in the response.

", "Relationship$resourceType": "

The resource type of the related resource.

", + "ResourceIdentifier$resourceType": "

The type of resource.

", "ResourceTypeList$member": null } }, "ResourceTypeList": { "base": null, "refs": { - "RecordingGroup$resourceTypes": "

A comma-separated list of strings representing valid AWS resource types (e.g., AWS::EC2::Instance or AWS::CloudTrail::Trail). resourceTypes is only valid if you have chosen not to select allSupported. For a list of valid resourceTypes values, see the resourceType Value column in the following topic: Supported AWS Resource Types.

" + "RecordingGroup$resourceTypes": "

A comma-separated list of strings representing valid AWS resource types (for example, AWS::EC2::Instance or AWS::CloudTrail::Trail). resourceTypes is only valid if you have chosen not to select allSupported. For a list of valid resourceTypes values, see the resourceType Value column in the following topic: Supported AWS Resource Types.

" } }, "StartConfigurationRecorderRequest": { @@ -507,7 +565,7 @@ "DeliverConfigSnapshotResponse$configSnapshotId": "

The ID of the snapshot that is being created.

", "DeliveryChannel$s3BucketName": "

The name of the Amazon S3 bucket used to store configuration history for the delivery channel.

", "DeliveryChannel$s3KeyPrefix": "

The prefix for the specified Amazon S3 bucket.

", - "DeliveryChannel$snsTopicARN": "

The Amazon Resource Name (ARN) of the IAM role used for accessing the Amazon S3 bucket and the Amazon SNS topic.

", + "DeliveryChannel$snsTopicARN": "

The Amazon Resource Name (ARN) of the SNS topic that AWS Config delivers notifications to.

", "DeliveryChannelStatus$name": "

The name of the delivery channel.

" } },