aws-sdk-proton 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a54dcd6810fcef8979772a47975580b51acd528ebc85fbaad40d1b4a6d0f70a
-  data.tar.gz: 04e2cae9aca1c0b81eb1a615cacf31f47ce7811bce496e8d12ef1309be92043e
+  metadata.gz: 2a995c34eb20768735466e4c2683e17ceb7e1066e6cd70b0dda8317b6085f532
+  data.tar.gz: 5e5ce8fb3cbc0deae9f6e70065de6aa9ee283adff58fefc6553be4801dfce8f9
 SHA512:
-  metadata.gz: 925fece7859267df592bb07f1682bcc6d24536c64bbe3eb8c021b46b3b30e235be49ef5703b47dd3317ea2cd2efa004a887980a05563765a61b7b8cb45a04cd1
-  data.tar.gz: 10be88edde46c9f97550b384cdc7df24fcf91bcc926cfb36a4ae4d5bcde035994913e79abe0935e1264ca77405432b63233bf75fb666cbc32b9a2d3da9e83329
+  metadata.gz: 75e2836c6c38e0895bbdfef0fd1706653ad1e773bc72bc001eac14ffa5b2e5d063da4f1f56fa2b64d5b3d730f3d8a7232daf169d647dd5f38f355cb60b881c8e
+  data.tar.gz: 88733cba9a283e62e4ea1369a97e224c4ae221440a7319cf29625d30c9ff5fb28152ee4541a1263bb2a253080497cbe304e837ca76012fd28a544388d328b053

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.20.0 (2022-11-16)
+------------------
+
+* Feature - Add support for sorting and filtering in ListServiceInstances
+
 1.19.0 (2022-11-14)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.19.0
+1.20.0

data/lib/aws-sdk-proton/client.rb

@@ -779,18 +779,13 @@ module Aws::Proton
     #
     # **You can provision environments using the following methods:**
     #
-    # * **Amazon Web Services-managed provisioning** – Proton makes direct
-    #   calls to provision your resources.
+    # * Amazon Web Services-managed provisioning: Proton makes direct calls
+    #   to provision your resources.
     #
-    # * **Self-managed provisioning** – Proton makes pull requests on your
+    # * Self-managed provisioning: Proton makes pull requests on your
     #   repository to provide compiled infrastructure as code (IaC) files
     #   that your IaC engine uses to provision resources.
     #
-    # * **CodeBuild-based provisioning** – Proton uses CodeBuild to run
-    #   shell commands that you provide. Your commands can read inputs that
-    #   Proton provides, and are responsible for provisioning or
-    #   deprovisioning infrastructure and generating output values.
-    #
     # For more information, see [Environments][1] and [Provisioning
     # methods][2] in the *Proton User Guide*.
     #
@@ -828,15 +823,15 @@ module Aws::Proton
     #   A description of the environment that's being created and deployed.
     #
     # @option params [String] :environment_account_connection_id
-    #   The ID of the environment account connection that you provide if you
-    #   want Proton to provision infrastructure resources for your environment
-    #   or for any of the service instances running in it in an environment
-    #   account. For more information, see [Environment account
+    #   The ID of the environment account connection that you provide if
+    #   you're provisioning your environment infrastructure resources to an
+    #   environment account. For more information, see [Environment account
     #   connections][1] in the *Proton User guide*.
     #
-    #   If you specify the `environmentAccountConnectionId` parameter, don't
-    #   specify `protonServiceRoleArn`, `codebuildRoleArn`, or
-    #   `provisioningRepository`.
+    #   To use Amazon Web Services-managed provisioning for the environment,
+    #   specify either the `environmentAccountConnectionId` or
+    #   `protonServiceRoleArn` parameter and omit the `provisioningRepository`
+    #   parameter.
     #
     #
     #
@@ -846,13 +841,12 @@ module Aws::Proton
     #   The name of the environment.
     #
     # @option params [String] :proton_service_role_arn
-    #   The Amazon Resource Name (ARN) of the IAM service role that allows
-    #   Proton to provision infrastructure using Amazon Web Services-managed
-    #   provisioning and CloudFormation on your behalf.
+    #   The Amazon Resource Name (ARN) of the Proton service role that allows
+    #   Proton to make calls to other services on your behalf.
     #
-    #   To use Amazon Web Services-managed provisioning for the environment or
-    #   for any service instance running in the environment, specify either
-    #   the `environmentAccountConnectionId` or `protonServiceRoleArn`
+    #   To use Amazon Web Services-managed provisioning for the environment,
+    #   specify either the `environmentAccountConnectionId` or
+    #   `protonServiceRoleArn` parameter and omit the `provisioningRepository`
     #   parameter.
     #
     # @option params [Types::RepositoryBranchInput] :provisioning_repository
@@ -861,8 +855,9 @@ module Aws::Proton
     #   repository is a repository that has been registered with Proton. For
     #   more information, see CreateRepository.
     #
-    #   To use self-managed provisioning for the environment or for any
-    #   service instance running in the environment, specify this parameter.
+    #   To use self-managed provisioning for the environment, specify this
+    #   parameter and omit the `environmentAccountConnectionId` and
+    #   `protonServiceRoleArn` parameters.
     #
     # @option params [required, String] :spec
     #   A YAML formatted string that provides inputs as defined in the
@@ -990,11 +985,10 @@ module Aws::Proton
     #   environment account.
     #
     # @option params [String] :component_role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision directly
-    #   defined components in the associated environment account. It
-    #   determines the scope of infrastructure that a component can provision
-    #   in the account.
+    #   The Amazon Resource Name (ARN) of the IAM service role that Proton
+    #   uses when provisioning directly defined components in the associated
+    #   environment account. It determines the scope of infrastructure that a
+    #   component can provision in the account.
     #
     #   You must specify `componentRoleArn` to allow directly defined
     #   components to be associated with any environments running in this
@@ -1020,10 +1014,9 @@ module Aws::Proton
     #   environment account.
     #
     # @option params [required, String] :role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision infrastructure
-    #   resources using Amazon Web Services-managed provisioning and
-    #   CloudFormation in the associated environment account.
+    #   The Amazon Resource Name (ARN) of the IAM service role that's created
+    #   in the environment account. Proton uses this role to provision
+    #   infrastructure resources in the associated environment account.
     #
     # @option params [Array<Types::Tag>] :tags
     #   An optional list of metadata items that you can associate with the
@@ -3579,7 +3572,13 @@ module Aws::Proton
       req.send_request(options)
     end
 
-    # List service instances with summary data.
+    # List service instances with summary data. This action lists service
+    # instances of all services in the Amazon Web Services account.
+    #
+    # @option params [Array<Types::ListServiceInstancesFilter>] :filters
+    #   An array of filtering criteria that scope down the result list. By
+    #   default, all service instances in the Amazon Web Services account are
+    #   returned.
     #
     # @option params [Integer] :max_results
     #   The maximum number of service instances to list.
@@ -3592,6 +3591,19 @@ module Aws::Proton
     # @option params [String] :service_name
     #   The name of the service that the service instance belongs to.
     #
+    # @option params [String] :sort_by
+    #   The field that the result list is sorted by.
+    #
+    #   When you choose to sort by `serviceName`, service instances within
+    #   each service are sorted by service instance name.
+    #
+    #   Default: `serviceName`
+    #
+    # @option params [String] :sort_order
+    #   Result list sort order.
+    #
+    #   Default: `ASCENDING`
+    #
     # @return [Types::ListServiceInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListServiceInstancesOutput#next_token #next_token} => String
@@ -3602,9 +3614,17 @@ module Aws::Proton
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_service_instances({
+    #     filters: [
+    #       {
+    #         key: "name", # accepts name, deploymentStatus, templateName, serviceName, deployedTemplateVersionStatus, environmentName, lastDeploymentAttemptedAtBefore, lastDeploymentAttemptedAtAfter, createdAtBefore, createdAtAfter
+    #         value: "ListServiceInstancesFilterValue",
+    #       },
+    #     ],
     #     max_results: 1,
     #     next_token: "NextToken",
     #     service_name: "ResourceName",
+    #     sort_by: "name", # accepts name, deploymentStatus, templateName, serviceName, environmentName, lastDeploymentAttemptedAt, createdAt
+    #     sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
     #   })
     #
     # @example Response structure
@@ -3915,38 +3935,25 @@ module Aws::Proton
       req.send_request(options)
     end
 
-    # Notify Proton of the following information related to a provisioned
-    # resource (environment, service instance, or service pipeline):
-    #
-    # * For [CodeBuild-based provisioning][1], provide your provisioned
-    #   resource output values to Proton.
-    #
-    # * For [self-managed provisioning][2], notify Proton about the status
-    #   of your provisioned resource. To disambiguate between different
-    #   deployments of the same resource, set `deploymentId` to a unique
-    #   deployment ID of your choice.
+    # Notify Proton of status changes to a provisioned resource when you use
+    # self-managed provisioning.
     #
-    #        </li> </ul>
+    # For more information, see [Self-managed provisioning][1] in the
+    # *Proton User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-codebuild
-    # [2]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
+    # [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
     #
     # @option params [String] :deployment_id
-    #   The deployment ID for your provisioned resource. Proton uses it to
-    #   disambiguate different deployments of the resource. Applicable to
-    #   [self-managed provisioning][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
+    #   The deployment ID for your provisioned resource.
     #
     # @option params [Array<Types::Output>] :outputs
-    #   The output values generated by your provisioned resource.
+    #   The provisioned resource state change detail data that's returned by
+    #   Proton.
     #
     # @option params [required, String] :resource_arn
-    #   The Amazon Resource Name (ARN) of your provisioned resource.
+    #   The provisioned resource Amazon Resource Name (ARN).
     #
     # @option params [String] :status
     #   The status of your provisioned resource.
@@ -4292,8 +4299,9 @@ module Aws::Proton
     # Update an environment.
     #
     # If the environment is associated with an environment account
-    # connection, *don't* update or include the `protonServiceRoleArn`,
-    # `codebuildRoleArn`, and `provisioningRepository` parameters.
+    # connection, *don't* update or include the `protonServiceRoleArn` and
+    # `provisioningRepository` parameter to update or connect to an
+    # environment account connection.
     #
     # You can only update to a new environment account connection if that
     # connection was created in the same environment account that the
@@ -4306,18 +4314,16 @@ module Aws::Proton
     # connect the environment to an environment account connection if it
     # *isn't* already associated with an environment connection.
     #
-    # You can update either `environmentAccountConnectionId` or one or more
-    # of `protonServiceRoleArn`, `codebuildRoleArn`, and
-    # `provisioningRepository`.
+    # You can update either the `environmentAccountConnectionId` or
+    # `protonServiceRoleArn` parameter and value. You can’t update both.
     #
-    # If the environment was configured for Amazon Web Services-managed or
-    # CodeBuild-based provisioning, omit the `provisioningRepository`
-    # parameter.
+    # If the environment was configured for Amazon Web Services-managed
+    # provisioning, omit the `provisioningRepository` parameter.
     #
     # If the environment was configured for self-managed provisioning,
     # specify the `provisioningRepository` parameter and omit the
-    # `protonServiceRoleArn`, `codebuildRoleArn`, and
-    # `provisioningRepository` parameters.
+    # `protonServiceRoleArn` and `environmentAccountConnectionId`
+    # parameters.
     #
     # For more information, see [Environments][1] and [Provisioning
     # methods][2] in the *Proton User Guide*.
@@ -4429,28 +4435,19 @@ module Aws::Proton
     #   A description of the environment update.
     #
     # @option params [String] :environment_account_connection_id
-    #   The ID of the environment account connection that you provide if you
-    #   want Proton to provision infrastructure resources for your environment
-    #   or for any of the service instances running in it in an environment
-    #   account. For more information, see [Environment account
-    #   connections][1] in the *Proton User guide*.
+    #   The ID of the environment account connection.
     #
     #   You can only update to a new environment account connection if it was
     #   created in the same environment account that the current environment
     #   account connection was created in and is associated with the current
     #   environment.
     #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-env-account-connections.html
-    #
     # @option params [required, String] :name
     #   The name of the environment to update.
     #
     # @option params [String] :proton_service_role_arn
-    #   The Amazon Resource Name (ARN) of the IAM service role that allows
-    #   Proton to provision infrastructure using Amazon Web Services-managed
-    #   provisioning and CloudFormation on your behalf.
+    #   The Amazon Resource Name (ARN) of the Proton service role that allows
+    #   Proton to make API calls to other services your behalf.
     #
     # @option params [Types::RepositoryBranchInput] :provisioning_repository
     #   The linked repository that you use to host your rendered
@@ -4562,10 +4559,8 @@ module Aws::Proton
     #   The ID of the environment account connection to update.
     #
     # @option params [String] :role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision infrastructure
-    #   resources using Amazon Web Services-managed provisioning and
-    #   CloudFormation in the associated environment account.
+    #   The Amazon Resource Name (ARN) of the IAM service role that's
+    #   associated with the environment account connection to update.
     #
     # @return [Types::UpdateEnvironmentAccountConnectionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5241,7 +5236,7 @@ module Aws::Proton
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-proton'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-proton/client_api.rb

@@ -165,8 +165,13 @@ module Aws::Proton
     ListServiceInstanceOutputsOutput = Shapes::StructureShape.new(name: 'ListServiceInstanceOutputsOutput')
     ListServiceInstanceProvisionedResourcesInput = Shapes::StructureShape.new(name: 'ListServiceInstanceProvisionedResourcesInput')
     ListServiceInstanceProvisionedResourcesOutput = Shapes::StructureShape.new(name: 'ListServiceInstanceProvisionedResourcesOutput')
+    ListServiceInstancesFilter = Shapes::StructureShape.new(name: 'ListServiceInstancesFilter')
+    ListServiceInstancesFilterBy = Shapes::StringShape.new(name: 'ListServiceInstancesFilterBy')
+    ListServiceInstancesFilterList = Shapes::ListShape.new(name: 'ListServiceInstancesFilterList')
+    ListServiceInstancesFilterValue = Shapes::StringShape.new(name: 'ListServiceInstancesFilterValue')
     ListServiceInstancesInput = Shapes::StructureShape.new(name: 'ListServiceInstancesInput')
     ListServiceInstancesOutput = Shapes::StructureShape.new(name: 'ListServiceInstancesOutput')
+    ListServiceInstancesSortBy = Shapes::StringShape.new(name: 'ListServiceInstancesSortBy')
     ListServicePipelineOutputsInput = Shapes::StructureShape.new(name: 'ListServicePipelineOutputsInput')
     ListServicePipelineOutputsOutput = Shapes::StructureShape.new(name: 'ListServicePipelineOutputsOutput')
     ListServicePipelineProvisionedResourcesInput = Shapes::StructureShape.new(name: 'ListServicePipelineProvisionedResourcesInput')
@@ -248,6 +253,7 @@ module Aws::Proton
     ServiceTemplateVersionArn = Shapes::StringShape.new(name: 'ServiceTemplateVersionArn')
     ServiceTemplateVersionSummary = Shapes::StructureShape.new(name: 'ServiceTemplateVersionSummary')
     ServiceTemplateVersionSummaryList = Shapes::ListShape.new(name: 'ServiceTemplateVersionSummaryList')
+    SortOrder = Shapes::StringShape.new(name: 'SortOrder')
     SpecContents = Shapes::StringShape.new(name: 'SpecContents')
     StatusMessage = Shapes::StringShape.new(name: 'StatusMessage')
     String = Shapes::StringShape.new(name: 'String')
@@ -916,9 +922,18 @@ module Aws::Proton
     ListServiceInstanceProvisionedResourcesOutput.add_member(:provisioned_resources, Shapes::ShapeRef.new(shape: ProvisionedResourceList, required: true, location_name: "provisionedResources"))
     ListServiceInstanceProvisionedResourcesOutput.struct_class = Types::ListServiceInstanceProvisionedResourcesOutput
 
+    ListServiceInstancesFilter.add_member(:key, Shapes::ShapeRef.new(shape: ListServiceInstancesFilterBy, location_name: "key"))
+    ListServiceInstancesFilter.add_member(:value, Shapes::ShapeRef.new(shape: ListServiceInstancesFilterValue, location_name: "value"))
+    ListServiceInstancesFilter.struct_class = Types::ListServiceInstancesFilter
+
+    ListServiceInstancesFilterList.member = Shapes::ShapeRef.new(shape: ListServiceInstancesFilter)
+
+    ListServiceInstancesInput.add_member(:filters, Shapes::ShapeRef.new(shape: ListServiceInstancesFilterList, location_name: "filters"))
     ListServiceInstancesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxPageResults, location_name: "maxResults"))
     ListServiceInstancesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     ListServiceInstancesInput.add_member(:service_name, Shapes::ShapeRef.new(shape: ResourceName, location_name: "serviceName"))
+    ListServiceInstancesInput.add_member(:sort_by, Shapes::ShapeRef.new(shape: ListServiceInstancesSortBy, location_name: "sortBy"))
+    ListServiceInstancesInput.add_member(:sort_order, Shapes::ShapeRef.new(shape: SortOrder, location_name: "sortOrder"))
     ListServiceInstancesInput.struct_class = Types::ListServiceInstancesInput
 
     ListServiceInstancesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))

data/lib/aws-sdk-proton/types.rb

@@ -72,9 +72,10 @@ module Aws::Proton
     #   @return [Types::RepositoryBranch]
     #
     # @!attribute [rw] pipeline_service_role_arn
-    #   The Amazon Resource Name (ARN) of the service role that Proton uses
-    #   for provisioning pipelines. Proton assumes this role for Amazon Web
-    #   Services-managed provisioning.
+    #   The Amazon Resource Name (ARN) of the service role you want to use
+    #   for provisioning pipelines. Assumed by Proton for Amazon Web
+    #   Services-managed provisioning, and by customer-owned automation for
+    #   self-managed provisioning.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/AccountSettings AWS API Documentation
@@ -584,11 +585,10 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] component_role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision directly
-    #   defined components in the associated environment account. It
-    #   determines the scope of infrastructure that a component can
-    #   provision in the account.
+    #   The Amazon Resource Name (ARN) of the IAM service role that Proton
+    #   uses when provisioning directly defined components in the associated
+    #   environment account. It determines the scope of infrastructure that
+    #   a component can provision in the account.
     #
     #   You must specify `componentRoleArn` to allow directly defined
     #   components to be associated with any environments running in this
@@ -617,10 +617,9 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision
-    #   infrastructure resources using Amazon Web Services-managed
-    #   provisioning and CloudFormation in the associated environment
+    #   The Amazon Resource Name (ARN) of the IAM service role that's
+    #   created in the environment account. Proton uses this role to
+    #   provision infrastructure resources in the associated environment
     #   account.
     #   @return [String]
     #
@@ -722,15 +721,15 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] environment_account_connection_id
-    #   The ID of the environment account connection that you provide if you
-    #   want Proton to provision infrastructure resources for your
-    #   environment or for any of the service instances running in it in an
+    #   The ID of the environment account connection that you provide if
+    #   you're provisioning your environment infrastructure resources to an
     #   environment account. For more information, see [Environment account
     #   connections][1] in the *Proton User guide*.
     #
-    #   If you specify the `environmentAccountConnectionId` parameter,
-    #   don't specify `protonServiceRoleArn`, `codebuildRoleArn`, or
-    #   `provisioningRepository`.
+    #   To use Amazon Web Services-managed provisioning for the environment,
+    #   specify either the `environmentAccountConnectionId` or
+    #   `protonServiceRoleArn` parameter and omit the
+    #   `provisioningRepository` parameter.
     #
     #
     #
@@ -742,14 +741,13 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] proton_service_role_arn
-    #   The Amazon Resource Name (ARN) of the IAM service role that allows
-    #   Proton to provision infrastructure using Amazon Web Services-managed
-    #   provisioning and CloudFormation on your behalf.
+    #   The Amazon Resource Name (ARN) of the Proton service role that
+    #   allows Proton to make calls to other services on your behalf.
     #
-    #   To use Amazon Web Services-managed provisioning for the environment
-    #   or for any service instance running in the environment, specify
-    #   either the `environmentAccountConnectionId` or
-    #   `protonServiceRoleArn` parameter.
+    #   To use Amazon Web Services-managed provisioning for the environment,
+    #   specify either the `environmentAccountConnectionId` or
+    #   `protonServiceRoleArn` parameter and omit the
+    #   `provisioningRepository` parameter.
     #   @return [String]
     #
     # @!attribute [rw] provisioning_repository
@@ -758,8 +756,9 @@ module Aws::Proton
     #   repository is a repository that has been registered with Proton. For
     #   more information, see CreateRepository.
     #
-    #   To use self-managed provisioning for the environment or for any
-    #   service instance running in the environment, specify this parameter.
+    #   To use self-managed provisioning for the environment, specify this
+    #   parameter and omit the `environmentAccountConnectionId` and
+    #   `protonServiceRoleArn` parameters.
     #   @return [Types::RepositoryBranchInput]
     #
     # @!attribute [rw] spec
@@ -1853,7 +1852,7 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] environment_account_connection_id
-    #   The ID of the environment account connection that Proton uses to
+    #   The ID of the environment account connection that's used to
     #   provision infrastructure resources in an environment account.
     #   @return [String]
     #
@@ -1875,9 +1874,8 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] proton_service_role_arn
-    #   The Amazon Resource Name (ARN) of the IAM service role that allows
-    #   Proton to provision infrastructure using Amazon Web Services-managed
-    #   provisioning and CloudFormation on your behalf.
+    #   The Amazon Resource Name (ARN) of the Proton service role that
+    #   allows Proton to make calls to other services on your behalf.
     #   @return [String]
     #
     # @!attribute [rw] provisioning
@@ -1994,11 +1992,8 @@ module Aws::Proton
     #   @return [Time]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision
-    #   infrastructure resources using Amazon Web Services-managed
-    #   provisioning and CloudFormation in the associated environment
-    #   account.
+    #   The IAM service role that's associated with the environment account
+    #   connection.
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -3695,15 +3690,65 @@ module Aws::Proton
       include Aws::Structure
     end
 
+    # A filtering criterion to scope down the result list of the
+    # ListServiceInstances action.
+    #
+    # @note When making an API call, you may pass ListServiceInstancesFilter
+    #   data as a hash:
+    #
+    #       {
+    #         key: "name", # accepts name, deploymentStatus, templateName, serviceName, deployedTemplateVersionStatus, environmentName, lastDeploymentAttemptedAtBefore, lastDeploymentAttemptedAtAfter, createdAtBefore, createdAtAfter
+    #         value: "ListServiceInstancesFilterValue",
+    #       }
+    #
+    # @!attribute [rw] key
+    #   The name of a filtering criterion.
+    #   @return [String]
+    #
+    # @!attribute [rw] value
+    #   A value to filter by.
+    #
+    #   With the date/time keys (`*At\{Before,After\}`), the value is a
+    #   valid [RFC 3339][1] string with no UTC offset and with an optional
+    #   fractional precision (for example, `1985-04-12T23:20:50.52Z`).
+    #
+    #
+    #
+    #   [1]: https://datatracker.ietf.org/doc/html/rfc3339.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServiceInstancesFilter AWS API Documentation
+    #
+    class ListServiceInstancesFilter < Struct.new(
+      :key,
+      :value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListServiceInstancesInput
     #   data as a hash:
     #
     #       {
+    #         filters: [
+    #           {
+    #             key: "name", # accepts name, deploymentStatus, templateName, serviceName, deployedTemplateVersionStatus, environmentName, lastDeploymentAttemptedAtBefore, lastDeploymentAttemptedAtAfter, createdAtBefore, createdAtAfter
+    #             value: "ListServiceInstancesFilterValue",
+    #           },
+    #         ],
     #         max_results: 1,
     #         next_token: "NextToken",
     #         service_name: "ResourceName",
+    #         sort_by: "name", # accepts name, deploymentStatus, templateName, serviceName, environmentName, lastDeploymentAttemptedAt, createdAt
+    #         sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
     #       }
     #
+    # @!attribute [rw] filters
+    #   An array of filtering criteria that scope down the result list. By
+    #   default, all service instances in the Amazon Web Services account
+    #   are returned.
+    #   @return [Array<Types::ListServiceInstancesFilter>]
+    #
     # @!attribute [rw] max_results
     #   The maximum number of service instances to list.
     #   @return [Integer]
@@ -3718,12 +3763,30 @@ module Aws::Proton
     #   The name of the service that the service instance belongs to.
     #   @return [String]
     #
+    # @!attribute [rw] sort_by
+    #   The field that the result list is sorted by.
+    #
+    #   When you choose to sort by `serviceName`, service instances within
+    #   each service are sorted by service instance name.
+    #
+    #   Default: `serviceName`
+    #   @return [String]
+    #
+    # @!attribute [rw] sort_order
+    #   Result list sort order.
+    #
+    #   Default: `ASCENDING`
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/ListServiceInstancesInput AWS API Documentation
     #
     class ListServiceInstancesInput < Struct.new(
+      :filters,
       :max_results,
       :next_token,
-      :service_name)
+      :service_name,
+      :sort_by,
+      :sort_order)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4064,21 +4127,16 @@ module Aws::Proton
     #       }
     #
     # @!attribute [rw] deployment_id
-    #   The deployment ID for your provisioned resource. Proton uses it to
-    #   disambiguate different deployments of the resource. Applicable to
-    #   [self-managed provisioning][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-works-prov-methods.html#ag-works-prov-methods-self
+    #   The deployment ID for your provisioned resource.
     #   @return [String]
     #
     # @!attribute [rw] outputs
-    #   The output values generated by your provisioned resource.
+    #   The provisioned resource state change detail data that's returned
+    #   by Proton.
     #   @return [Array<Types::Output>]
     #
     # @!attribute [rw] resource_arn
-    #   The Amazon Resource Name (ARN) of your provisioned resource.
+    #   The provisioned resource Amazon Resource Name (ARN).
     #   @return [String]
     #
     # @!attribute [rw] status
@@ -5541,11 +5599,8 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of an IAM service role in the
-    #   environment account. Proton uses this role to provision
-    #   infrastructure resources using Amazon Web Services-managed
-    #   provisioning and CloudFormation in the associated environment
-    #   account.
+    #   The Amazon Resource Name (ARN) of the IAM service role that's
+    #   associated with the environment account connection to update.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/proton-2020-07-20/UpdateEnvironmentAccountConnectionInput AWS API Documentation
@@ -5661,20 +5716,12 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] environment_account_connection_id
-    #   The ID of the environment account connection that you provide if you
-    #   want Proton to provision infrastructure resources for your
-    #   environment or for any of the service instances running in it in an
-    #   environment account. For more information, see [Environment account
-    #   connections][1] in the *Proton User guide*.
+    #   The ID of the environment account connection.
     #
     #   You can only update to a new environment account connection if it
     #   was created in the same environment account that the current
     #   environment account connection was created in and is associated with
     #   the current environment.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/proton/latest/userguide/ag-env-account-connections.html
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -5682,9 +5729,8 @@ module Aws::Proton
     #   @return [String]
     #
     # @!attribute [rw] proton_service_role_arn
-    #   The Amazon Resource Name (ARN) of the IAM service role that allows
-    #   Proton to provision infrastructure using Amazon Web Services-managed
-    #   provisioning and CloudFormation on your behalf.
+    #   The Amazon Resource Name (ARN) of the Proton service role that
+    #   allows Proton to make API calls to other services your behalf.
     #   @return [String]
     #
     # @!attribute [rw] provisioning_repository

data/lib/aws-sdk-proton.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-proton/customizations'
 # @!group service
 module Aws::Proton
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.20.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-proton
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-11-14 00:00:00.000000000 Z
+date: 2022-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core