aws-sdk-codecatalyst 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5843c12be5f57cfe77a99d3ec59ddeedfdc55a5b609de997df395831d050f20
-  data.tar.gz: 6b12500d736b74d7a1f351d750cf3b6989c3cb4ef37563f40c1391d6f386934a
+  metadata.gz: c8459d893e24bdd14d32b0e65e4817589d2a800fe0da5720c432149b096a9a2d
+  data.tar.gz: 47c258128dfb006484c2f414880e5fc4d2606820a73d1c4ecc7fd1affd65d4be
 SHA512:
-  metadata.gz: 93f1f757a0e2a58304efd7a12c5a210ff3e9101a1b704fdb38814be039578b4744c8f47f7605e9fbb972a55afc48e97dc7bc0dcb83c9daea8ed9370d430c37f8
-  data.tar.gz: d65fab762f9f26aa33be8ce5c61e24cc65a83fe1e9757008e4c780e69d5e37de67c2873a07b0dd92bc53c2206d0ef6dfcc304e2f7ff5dff5c50112a7410521f2
+  metadata.gz: 4fcf5960dd232012b68c2d94cd9a27520b27f804b3ba01b172748bace95eba8a063e50627dd2041d64997922d0f8667c7ed2b1f0a8be14b12f4091763e2ce864
+  data.tar.gz: 4812dcfa075037c52e16c58cf40bf5ba770f3935f3da2095797a2708487b0bf33ad5887323cadae7640965dda6619ef74eeebb0d25c1302e24f063a20e6569bd

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.2.0 (2023-03-01)
+------------------
+
+* Feature - Published Dev Environments StopDevEnvironmentSession API
+
 1.1.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

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

@@ -396,6 +396,7 @@ module Aws::CodeCatalyst
     #   * {Types::CreateAccessTokenResponse#secret #secret} => String
     #   * {Types::CreateAccessTokenResponse#name #name} => String
     #   * {Types::CreateAccessTokenResponse#expires_time #expires_time} => Time
+    #   * {Types::CreateAccessTokenResponse#access_token_id #access_token_id} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -409,6 +410,7 @@ module Aws::CodeCatalyst
     #   resp.secret #=> String
     #   resp.name #=> String
     #   resp.expires_time #=> Time
+    #   resp.access_token_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/codecatalyst-2022-09-28/CreateAccessToken AWS API Documentation
     #
@@ -421,9 +423,14 @@ module Aws::CodeCatalyst
 
     # Creates a Dev Environment in Amazon CodeCatalyst, a cloud-based
     # development Dev Environment that you can use to quickly work on the
-    # code stored in the source repositories of your project. By default, a
-    # Dev Environment is configured to have a 2 core processor, 4GB of RAM,
-    # and 16GB of persistent storage.
+    # code stored in the source repositories of your project.
+    #
+    # <note markdown="1"> When created in the Amazon CodeCatalyst console, by default a Dev
+    # Environment is configured to have a 2 core processor, 4GB of RAM, and
+    # 16GB of persistent storage. None of these defaults apply to a Dev
+    # Environment created programmatically.
+    #
+    #  </note>
     #
     # @option params [required, String] :space_name
     #   The name of the space.
@@ -465,10 +472,12 @@ module Aws::CodeCatalyst
     #
     # @option params [required, Types::PersistentStorageConfiguration] :persistent_storage
     #   Information about the amount of storage allocated to the Dev
-    #   Environment. By default, a Dev Environment is configured to have 16GB
-    #   of persistent storage.
+    #   Environment.
     #
-    #   <note markdown="1"> Valid values for persistent storage are based on memory sizes in 16GB
+    #   <note markdown="1"> By default, a Dev Environment is configured to have 16GB of persistent
+    #   storage when created from the Amazon CodeCatalyst console, but there
+    #   is no default when programmatically creating a Dev Environment. Valid
+    #   values for persistent storage are based on memory sizes in 16GB
     #   increments. Valid values are 16, 32, and 64.
     #
     #    </note>
@@ -1513,6 +1522,54 @@ module Aws::CodeCatalyst
       req.send_request(options)
     end
 
+    # Stops a session for a specified Dev Environment.
+    #
+    # @option params [required, String] :space_name
+    #   The name of the space.
+    #
+    # @option params [required, String] :project_name
+    #   The name of the project in the space.
+    #
+    # @option params [required, String] :id
+    #   The system-generated unique ID of the Dev Environment. To obtain this
+    #   ID, use ListDevEnvironments.
+    #
+    # @option params [required, String] :session_id
+    #   The system-generated unique ID of the Dev Environment session. This ID
+    #   is returned by StartDevEnvironmentSession.
+    #
+    # @return [Types::StopDevEnvironmentSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StopDevEnvironmentSessionResponse#space_name #space_name} => String
+    #   * {Types::StopDevEnvironmentSessionResponse#project_name #project_name} => String
+    #   * {Types::StopDevEnvironmentSessionResponse#id #id} => String
+    #   * {Types::StopDevEnvironmentSessionResponse#session_id #session_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.stop_dev_environment_session({
+    #     space_name: "NameString", # required
+    #     project_name: "NameString", # required
+    #     id: "Uuid", # required
+    #     session_id: "StopDevEnvironmentSessionRequestSessionIdString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.space_name #=> String
+    #   resp.project_name #=> String
+    #   resp.id #=> String
+    #   resp.session_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codecatalyst-2022-09-28/StopDevEnvironmentSession AWS API Documentation
+    #
+    # @overload stop_dev_environment_session(params = {})
+    # @param [Hash] params ({})
+    def stop_dev_environment_session(params = {}, options = {})
+      req = build_request(:stop_dev_environment_session, params)
+      req.send_request(options)
+    end
+
     # Changes one or more values for a Dev Environment. Updating certain
     # values of the Dev Environment will cause a restart.
     #
@@ -1643,7 +1700,7 @@ module Aws::CodeCatalyst
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-codecatalyst'
-      context[:gem_version] = '1.1.0'
+      context[:gem_version] = '1.2.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -148,6 +148,10 @@ module Aws::CodeCatalyst
     StatusReason = Shapes::StringShape.new(name: 'StatusReason')
     StopDevEnvironmentRequest = Shapes::StructureShape.new(name: 'StopDevEnvironmentRequest')
     StopDevEnvironmentResponse = Shapes::StructureShape.new(name: 'StopDevEnvironmentResponse')
+    StopDevEnvironmentSessionRequest = Shapes::StructureShape.new(name: 'StopDevEnvironmentSessionRequest')
+    StopDevEnvironmentSessionRequestSessionIdString = Shapes::StringShape.new(name: 'StopDevEnvironmentSessionRequestSessionIdString')
+    StopDevEnvironmentSessionResponse = Shapes::StructureShape.new(name: 'StopDevEnvironmentSessionResponse')
+    StopDevEnvironmentSessionResponseSessionIdString = Shapes::StringShape.new(name: 'StopDevEnvironmentSessionResponseSessionIdString')
     String = Shapes::StringShape.new(name: 'String')
     StringList = Shapes::ListShape.new(name: 'StringList')
     SyntheticTimestamp_date_time = Shapes::TimestampShape.new(name: 'SyntheticTimestamp_date_time', timestampFormat: "iso8601")
@@ -182,8 +186,9 @@ module Aws::CodeCatalyst
     CreateAccessTokenRequest.struct_class = Types::CreateAccessTokenRequest
 
     CreateAccessTokenResponse.add_member(:secret, Shapes::ShapeRef.new(shape: AccessTokenSecret, required: true, location_name: "secret"))
-    CreateAccessTokenResponse.add_member(:name, Shapes::ShapeRef.new(shape: AccessTokenName, location_name: "name"))
-    CreateAccessTokenResponse.add_member(:expires_time, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, location_name: "expiresTime"))
+    CreateAccessTokenResponse.add_member(:name, Shapes::ShapeRef.new(shape: AccessTokenName, required: true, location_name: "name"))
+    CreateAccessTokenResponse.add_member(:expires_time, Shapes::ShapeRef.new(shape: SyntheticTimestamp_date_time, required: true, location_name: "expiresTime"))
+    CreateAccessTokenResponse.add_member(:access_token_id, Shapes::ShapeRef.new(shape: AccessTokenId, required: true, location_name: "accessTokenId"))
     CreateAccessTokenResponse.struct_class = Types::CreateAccessTokenResponse
 
     CreateDevEnvironmentRequest.add_member(:space_name, Shapes::ShapeRef.new(shape: NameString, required: true, location: "uri", location_name: "spaceName"))
@@ -465,7 +470,7 @@ module Aws::CodeCatalyst
     ListSourceRepositoryBranchesRequest.struct_class = Types::ListSourceRepositoryBranchesRequest
 
     ListSourceRepositoryBranchesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
-    ListSourceRepositoryBranchesResponse.add_member(:items, Shapes::ShapeRef.new(shape: ListSourceRepositoryBranchesItems, location_name: "items"))
+    ListSourceRepositoryBranchesResponse.add_member(:items, Shapes::ShapeRef.new(shape: ListSourceRepositoryBranchesItems, required: true, location_name: "items"))
     ListSourceRepositoryBranchesResponse.struct_class = Types::ListSourceRepositoryBranchesResponse
 
     ListSpacesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: ListSpacesRequestNextTokenString, location_name: "nextToken"))
@@ -557,6 +562,18 @@ module Aws::CodeCatalyst
     StopDevEnvironmentResponse.add_member(:status, Shapes::ShapeRef.new(shape: DevEnvironmentStatus, required: true, location_name: "status"))
     StopDevEnvironmentResponse.struct_class = Types::StopDevEnvironmentResponse
 
+    StopDevEnvironmentSessionRequest.add_member(:space_name, Shapes::ShapeRef.new(shape: NameString, required: true, location: "uri", location_name: "spaceName"))
+    StopDevEnvironmentSessionRequest.add_member(:project_name, Shapes::ShapeRef.new(shape: NameString, required: true, location: "uri", location_name: "projectName"))
+    StopDevEnvironmentSessionRequest.add_member(:id, Shapes::ShapeRef.new(shape: Uuid, required: true, location: "uri", location_name: "id"))
+    StopDevEnvironmentSessionRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: StopDevEnvironmentSessionRequestSessionIdString, required: true, location: "uri", location_name: "sessionId"))
+    StopDevEnvironmentSessionRequest.struct_class = Types::StopDevEnvironmentSessionRequest
+
+    StopDevEnvironmentSessionResponse.add_member(:space_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "spaceName"))
+    StopDevEnvironmentSessionResponse.add_member(:project_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "projectName"))
+    StopDevEnvironmentSessionResponse.add_member(:id, Shapes::ShapeRef.new(shape: Uuid, required: true, location_name: "id"))
+    StopDevEnvironmentSessionResponse.add_member(:session_id, Shapes::ShapeRef.new(shape: StopDevEnvironmentSessionResponseSessionIdString, required: true, location_name: "sessionId"))
+    StopDevEnvironmentSessionResponse.struct_class = Types::StopDevEnvironmentSessionResponse
+
     StringList.member = Shapes::ShapeRef.new(shape: String)
 
     ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -961,6 +978,20 @@ module Aws::CodeCatalyst
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:stop_dev_environment_session, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StopDevEnvironmentSession"
+        o.http_method = "DELETE"
+        o.http_request_uri = "/v1/spaces/{spaceName}/projects/{projectName}/devEnvironments/{id}/session/{sessionId}"
+        o.input = Shapes::ShapeRef.new(shape: StopDevEnvironmentSessionRequest)
+        o.output = Shapes::ShapeRef.new(shape: StopDevEnvironmentSessionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:update_dev_environment, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateDevEnvironment"
         o.http_method = "PATCH"

data/lib/aws-sdk-codecatalyst/endpoints.rb

@@ -297,6 +297,19 @@ module Aws::CodeCatalyst
       end
     end
 
+    class StopDevEnvironmentSession
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CodeCatalyst::EndpointParameters.new(
+          use_fips: context.config.use_fips_endpoint,
+          region: context.config.region,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class UpdateDevEnvironment
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-codecatalyst/plugins/endpoints.rb

@@ -100,6 +100,8 @@ module Aws::CodeCatalyst
             Aws::CodeCatalyst::Endpoints::StartDevEnvironmentSession.build(context)
           when :stop_dev_environment
             Aws::CodeCatalyst::Endpoints::StopDevEnvironment.build(context)
+          when :stop_dev_environment_session
+            Aws::CodeCatalyst::Endpoints::StopDevEnvironmentSession.build(context)
           when :update_dev_environment
             Aws::CodeCatalyst::Endpoints::UpdateDevEnvironment.build(context)
           when :verify_session

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

@@ -111,12 +111,17 @@ module Aws::CodeCatalyst
     #   [1]: https://www.rfc-editor.org/rfc/rfc3339#section-5.6
     #   @return [Time]
     #
+    # @!attribute [rw] access_token_id
+    #   The system-generated unique ID of the access token.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/codecatalyst-2022-09-28/CreateAccessTokenResponse AWS API Documentation
     #
     class CreateAccessTokenResponse < Struct.new(
       :secret,
       :name,
-      :expires_time)
+      :expires_time,
+      :access_token_id)
       SENSITIVE = [:secret]
       include Aws::Structure
     end
@@ -169,11 +174,13 @@ module Aws::CodeCatalyst
     #
     # @!attribute [rw] persistent_storage
     #   Information about the amount of storage allocated to the Dev
-    #   Environment. By default, a Dev Environment is configured to have
-    #   16GB of persistent storage.
+    #   Environment.
     #
-    #   <note markdown="1"> Valid values for persistent storage are based on memory sizes in
-    #   16GB increments. Valid values are 16, 32, and 64.
+    #   <note markdown="1"> By default, a Dev Environment is configured to have 16GB of
+    #   persistent storage when created from the Amazon CodeCatalyst
+    #   console, but there is no default when programmatically creating a
+    #   Dev Environment. Valid values for persistent storage are based on
+    #   memory sizes in 16GB increments. Valid values are 16, 32, and 64.
     #
     #    </note>
     #   @return [Types::PersistentStorageConfiguration]
@@ -1038,10 +1045,15 @@ module Aws::CodeCatalyst
     #
     # @!attribute [rw] runtime
     #   A link to the IDE runtime image.
+    #
+    #   <note markdown="1"> This parameter is not required for `VSCode`.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the IDE.
+    #   The name of the IDE. Valid values include `Cloud9`, `IntelliJ`,
+    #   `PyCharm`, `GoLand`, and `VSCode`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/codecatalyst-2022-09-28/IdeConfiguration AWS API Documentation
@@ -1645,8 +1657,7 @@ module Aws::CodeCatalyst
     # Information about an space.
     #
     # @!attribute [rw] name
-    #   *We need to know what this is and the basic usage information so
-    #   that third-party developers know how to use this data type.*
+    #   The name of the space.
     #   @return [String]
     #
     # @!attribute [rw] region_name
@@ -1847,6 +1858,62 @@ module Aws::CodeCatalyst
       include Aws::Structure
     end
 
+    # @!attribute [rw] space_name
+    #   The name of the space.
+    #   @return [String]
+    #
+    # @!attribute [rw] project_name
+    #   The name of the project in the space.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The system-generated unique ID of the Dev Environment. To obtain
+    #   this ID, use ListDevEnvironments.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   The system-generated unique ID of the Dev Environment session. This
+    #   ID is returned by StartDevEnvironmentSession.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codecatalyst-2022-09-28/StopDevEnvironmentSessionRequest AWS API Documentation
+    #
+    class StopDevEnvironmentSessionRequest < Struct.new(
+      :space_name,
+      :project_name,
+      :id,
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] space_name
+    #   The name of the space.
+    #   @return [String]
+    #
+    # @!attribute [rw] project_name
+    #   The name of the project in the space.
+    #   @return [String]
+    #
+    # @!attribute [rw] id
+    #   The system-generated unique ID of the Dev Environment.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   The system-generated unique ID of the Dev Environment session.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/codecatalyst-2022-09-28/StopDevEnvironmentSessionResponse AWS API Documentation
+    #
+    class StopDevEnvironmentSessionResponse < Struct.new(
+      :space_name,
+      :project_name,
+      :id,
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The request was denied due to request throttling.
     #
     # @!attribute [rw] message

data/lib/aws-sdk-codecatalyst.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-codecatalyst/customizations'
 # @!group service
 module Aws::CodeCatalyst
 
-  GEM_VERSION = '1.1.0'
+  GEM_VERSION = '1.2.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-codecatalyst
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core