strongdm 15.39.0 → 15.40.0

data/lib/models/porcelain.rb

@@ -636,6 +636,59 @@ module SDM
     end
   end
 
+  class AWSConnector
+    # AccountIds is the list of AWS Accounts to scan
+    attr_accessor :account_ids
+    # Description of the Connector.
+    attr_accessor :description
+    # ExcludeTags filters out discovered resources that have the tag and value.
+    # We do allow duplicate tag names for ExcludeTags to support multiple excluded values for the tag.
+    attr_accessor :exclude_tags
+    # Unique identifier of the Connector.
+    attr_accessor :id
+    # IncludeTags only discovers cloud resources that have one of the included tags.
+    # We do not allow duplicate tag names for IncludeTags
+    attr_accessor :include_tags
+    # Unique human-readable name of the Connector.
+    attr_accessor :name
+    # RoleName is the Role we're assuming into for an account
+    attr_accessor :role_name
+    # ScanPeriod identifies which remote system this Connector discovers
+    attr_accessor :scan_period
+    # Services is a list of services this connector should scan.
+    attr_accessor :services
+
+    def initialize(
+      account_ids: nil,
+      description: nil,
+      exclude_tags: nil,
+      id: nil,
+      include_tags: nil,
+      name: nil,
+      role_name: nil,
+      scan_period: nil,
+      services: nil
+    )
+      @account_ids = account_ids == nil ? [] : account_ids
+      @description = description == nil ? "" : description
+      @exclude_tags = exclude_tags == nil ? [] : exclude_tags
+      @id = id == nil ? "" : id
+      @include_tags = include_tags == nil ? [] : include_tags
+      @name = name == nil ? "" : name
+      @role_name = role_name == nil ? "" : role_name
+      @scan_period = scan_period == nil ? "" : scan_period
+      @services = services == nil ? [] : services
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
   class AWSConsole
     # The bind interface is the IP address to which the port override of a resource is bound (for example, 127.0.0.1). It is automatically generated if not provided and may also be set to one of the ResourceIPAllocationMode constants to select between VNM, loopback, or default allocation.
     attr_accessor :bind_interface
@@ -4180,6 +4233,63 @@ module SDM
     end
   end
 
+  class AzureConnector
+    # ClientId is the ID of the Application / Service Account we're acting as
+    attr_accessor :client_id
+    # Description of the Connector.
+    attr_accessor :description
+    # ExcludeTags filters out discovered resources that have the tag and value.
+    # We do allow duplicate tag names for ExcludeTags to support multiple excluded values for the tag.
+    attr_accessor :exclude_tags
+    # Unique identifier of the Connector.
+    attr_accessor :id
+    # IncludeTags only discovers cloud resources that have one of the included tags.
+    # We do not allow duplicate tag names for IncludeTags
+    attr_accessor :include_tags
+    # Unique human-readable name of the Connector.
+    attr_accessor :name
+    # ScanPeriod identifies which remote system this Connector discovers
+    attr_accessor :scan_period
+    # Services is a list of services this connector should scan.
+    attr_accessor :services
+    # SubscriptionIds are the targets of discovery.
+    attr_accessor :subscription_ids
+    # TenantId is the Azure Tenant we're discovering in
+    attr_accessor :tenant_id
+
+    def initialize(
+      client_id: nil,
+      description: nil,
+      exclude_tags: nil,
+      id: nil,
+      include_tags: nil,
+      name: nil,
+      scan_period: nil,
+      services: nil,
+      subscription_ids: nil,
+      tenant_id: nil
+    )
+      @client_id = client_id == nil ? "" : client_id
+      @description = description == nil ? "" : description
+      @exclude_tags = exclude_tags == nil ? [] : exclude_tags
+      @id = id == nil ? "" : id
+      @include_tags = include_tags == nil ? [] : include_tags
+      @name = name == nil ? "" : name
+      @scan_period = scan_period == nil ? "" : scan_period
+      @services = services == nil ? [] : services
+      @subscription_ids = subscription_ids == nil ? [] : subscription_ids
+      @tenant_id = tenant_id == nil ? "" : tenant_id
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
   class AzureMysql
     # The bind interface is the IP address to which the port override of a resource is bound (for example, 127.0.0.1). It is automatically generated if not provided and may also be set to one of the ResourceIPAllocationMode constants to select between VNM, loopback, or default allocation.
     attr_accessor :bind_interface
@@ -5147,6 +5257,228 @@ module SDM
     end
   end
 
+  # ConnectorCreateRequest specifies a connector to create.
+  class ConnectorCreateRequest
+    # Parameters to define the new Connector.
+    attr_accessor :connector
+
+    def initialize(
+      connector: nil
+    )
+      @connector = connector == nil ? nil : connector
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorCreateResponse reports the result of a create.
+  class ConnectorCreateResponse
+    # The created Connector.
+    attr_accessor :connector
+    # Rate limit information.
+    attr_accessor :rate_limit
+
+    def initialize(
+      connector: nil,
+      rate_limit: nil
+    )
+      @connector = connector == nil ? nil : connector
+      @rate_limit = rate_limit == nil ? nil : rate_limit
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorDeleteRequest identifies a connector by ID to delete.
+  class ConnectorDeleteRequest
+    # The unique identifier of the connector to delete.
+    attr_accessor :id
+
+    def initialize(
+      id: nil
+    )
+      @id = id == nil ? "" : id
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorDeleteResponse returns information about a connector that was deleted.
+  class ConnectorDeleteResponse
+    # Reserved for future use.
+    attr_accessor :meta
+    # Rate limit information.
+    attr_accessor :rate_limit
+
+    def initialize(
+      meta: nil,
+      rate_limit: nil
+    )
+      @meta = meta == nil ? nil : meta
+      @rate_limit = rate_limit == nil ? nil : rate_limit
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorGetRequest specifies which Connector to retrieve.
+  class ConnectorGetRequest
+    # The unique identifier of the Connector to retrieve.
+    attr_accessor :id
+
+    def initialize(
+      id: nil
+    )
+      @id = id == nil ? "" : id
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorGetResponse returns a requested Connector.
+  class ConnectorGetResponse
+    # The requested Connector.
+    attr_accessor :connector
+    # Reserved for future use.
+    attr_accessor :meta
+    # Rate limit information.
+    attr_accessor :rate_limit
+
+    def initialize(
+      connector: nil,
+      meta: nil,
+      rate_limit: nil
+    )
+      @connector = connector == nil ? nil : connector
+      @meta = meta == nil ? nil : meta
+      @rate_limit = rate_limit == nil ? nil : rate_limit
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorListRequest specifies criteria for retrieving a list of connectors.
+  class ConnectorListRequest
+    # A human-readable filter query string.
+    attr_accessor :filter
+
+    def initialize(
+      filter: nil
+    )
+      @filter = filter == nil ? "" : filter
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorListResponse returns a list of connectors that meet the criteria of a
+  # ConnectorListRequest.
+  class ConnectorListResponse
+    # Rate limit information.
+    attr_accessor :rate_limit
+
+    def initialize(
+      rate_limit: nil
+    )
+      @rate_limit = rate_limit == nil ? nil : rate_limit
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorUpdateRequest updates a connector.
+  class ConnectorUpdateRequest
+    # Parameters to overwrite the specified connector.
+    attr_accessor :connector
+
+    def initialize(
+      connector: nil
+    )
+      @connector = connector == nil ? nil : connector
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
+  # ConnectorUpdateResponse returns the fields of a connector after it has been updated by
+  # a connectorUpdateRequest.
+  class ConnectorUpdateResponse
+    # The updated connector.
+    attr_accessor :connector
+    # Rate limit information.
+    attr_accessor :rate_limit
+
+    def initialize(
+      connector: nil,
+      rate_limit: nil
+    )
+      @connector = connector == nil ? nil : connector
+      @rate_limit = rate_limit == nil ? nil : rate_limit
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
   # ControlPanelGetRDPCAPublicKeyResponse represents a request for an
   # organization's RDP Certificate Authority public key.
   class ControlPanelGetRDPCAPublicKeyResponse
@@ -6629,6 +6961,67 @@ module SDM
     end
   end
 
+  class GCPConnector
+    # Description of the Connector.
+    attr_accessor :description
+    # ExcludeTags filters out discovered resources that have the tag and value.
+    # We do allow duplicate tag names for ExcludeTags to support multiple excluded values for the tag.
+    attr_accessor :exclude_tags
+    # Unique identifier of the Connector.
+    attr_accessor :id
+    # IncludeTags only discovers cloud resources that have one of the included tags.
+    # We do not allow duplicate tag names for IncludeTags
+    attr_accessor :include_tags
+    # Unique human-readable name of the Connector.
+    attr_accessor :name
+    # PoolId is the GCP Workload Pool Identifier used to authenticate our JWT
+    attr_accessor :pool_id
+    # ProjectIds is the list of GCP Projects the connector will scan
+    attr_accessor :project_ids
+    # ProjectNumber is the GCP Project the Workload Pool is defined in
+    attr_accessor :project_number
+    # ProviderId is the GCP Workload Provider Identifier used to authenticate our JWT
+    attr_accessor :provider_id
+    # ScanPeriod identifies which remote system this Connector discovers
+    attr_accessor :scan_period
+    # Services is a list of services this connector should scan.
+    attr_accessor :services
+
+    def initialize(
+      description: nil,
+      exclude_tags: nil,
+      id: nil,
+      include_tags: nil,
+      name: nil,
+      pool_id: nil,
+      project_ids: nil,
+      project_number: nil,
+      provider_id: nil,
+      scan_period: nil,
+      services: nil
+    )
+      @description = description == nil ? "" : description
+      @exclude_tags = exclude_tags == nil ? [] : exclude_tags
+      @id = id == nil ? "" : id
+      @include_tags = include_tags == nil ? [] : include_tags
+      @name = name == nil ? "" : name
+      @pool_id = pool_id == nil ? "" : pool_id
+      @project_ids = project_ids == nil ? [] : project_ids
+      @project_number = project_number == nil ? "" : project_number
+      @provider_id = provider_id == nil ? "" : provider_id
+      @scan_period = scan_period == nil ? "" : scan_period
+      @services = services == nil ? [] : services
+    end
+
+    def to_json(options = {})
+      hash = {}
+      self.instance_variables.each do |var|
+        hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
+      end
+      hash.to_json
+    end
+  end
+
   class GCPConsole
     # The bind interface is the IP address to which the port override of a resource is bound (for example, 127.0.0.1). It is automatically generated if not provided and may also be set to one of the ResourceIPAllocationMode constants to select between VNM, loopback, or default allocation.
     attr_accessor :bind_interface

data/lib/strongdm.rb

@@ -30,7 +30,7 @@ module SDM #:nodoc:
     DEFAULT_RETRY_FACTOR = 1.6
     DEFAULT_RETRY_JITTER = 0.2
     API_VERSION = "2025-04-14"
-    USER_AGENT = "strongdm-sdk-ruby/15.39.0"
+    USER_AGENT = "strongdm-sdk-ruby/15.40.0"
     private_constant :DEFAULT_BASE_RETRY_DELAY, :DEFAULT_MAX_RETRY_DELAY, :DEFAULT_RETRY_FACTOR, :DEFAULT_RETRY_JITTER, :API_VERSION, :USER_AGENT
 
     # Creates a new strongDM API client.
@@ -79,6 +79,7 @@ module SDM #:nodoc:
       @approval_workflows = ApprovalWorkflows.new(@channel, self)
       @approval_workflows_history = ApprovalWorkflowsHistory.new(@channel, self)
       @control_panel = ControlPanel.new(@channel, self)
+      @discovery_connectors = DiscoveryConnectors.new(@channel, self)
       @roles = Roles.new(@channel, self)
       @groups = Groups.new(@channel, self)
       @groups_history = GroupsHistory.new(@channel, self)
@@ -329,6 +330,11 @@ module SDM #:nodoc:
     #
     # See {ControlPanel}.
     attr_reader :control_panel
+    # A Discovery Connector is a configuration object for performing Resource
+    # Scans in remote systems such as AWS, GCP, Azure, and other systems.
+    #
+    # See {DiscoveryConnectors}.
+    attr_reader :discovery_connectors
     # A Role has a list of access rules which determine which Resources the members
     # of the Role have access to. An Account can be a member of multiple Roles via
     # AccountAttachments.
@@ -550,6 +556,7 @@ module SDM #:nodoc:
       @approval_workflows = ApprovalWorkflows.new(@channel, self)
       @approval_workflows_history = ApprovalWorkflowsHistory.new(@channel, self)
       @control_panel = ControlPanel.new(@channel, self)
+      @discovery_connectors = DiscoveryConnectors.new(@channel, self)
       @roles = Roles.new(@channel, self)
       @groups = Groups.new(@channel, self)
       @groups_history = GroupsHistory.new(@channel, self)
@@ -608,6 +615,7 @@ module SDM #:nodoc:
       @approval_workflow_approvers = SnapshotApprovalWorkflowApprovers.new(client.approval_workflow_approvers)
       @approval_workflow_steps = SnapshotApprovalWorkflowSteps.new(client.approval_workflow_steps)
       @approval_workflows = SnapshotApprovalWorkflows.new(client.approval_workflows)
+      @discovery_connectors = SnapshotDiscoveryConnectors.new(client.discovery_connectors)
       @roles = SnapshotRoles.new(client.roles)
       @groups = SnapshotGroups.new(client.groups)
       @groups_roles = SnapshotGroupsRoles.new(client.groups_roles)
@@ -672,6 +680,11 @@ module SDM #:nodoc:
     #
     # See {SnapshotApprovalWorkflows}.
     attr_reader :approval_workflows
+    # A Discovery Connector is a configuration object for performing Resource
+    # Scans in remote systems such as AWS, GCP, Azure, and other systems.
+    #
+    # See {SnapshotDiscoveryConnectors}.
+    attr_reader :discovery_connectors
     # A Role has a list of access rules which determine which Resources the members
     # of the Role have access to. An Account can be a member of multiple Roles via
     # AccountAttachments.

data/lib/svc.rb

@@ -2344,6 +2344,220 @@ module SDM #:nodoc:
     end
   end
 
+  # A Discovery Connector is a configuration object for performing Resource
+  # Scans in remote systems such as AWS, GCP, Azure, and other systems.
+  #
+  # See:
+  # {AWSConnector}
+  # {AzureConnector}
+  # {GCPConnector}
+  class DiscoveryConnectors
+    extend Gem::Deprecate
+
+    def initialize(channel, parent)
+      begin
+        @stub = V1::DiscoveryConnectors::Stub.new(nil, nil, channel_override: channel)
+      rescue => exception
+        raise Plumbing::convert_error_to_porcelain(exception)
+      end
+      @parent = parent
+    end
+
+    # Create adds a new Connector.
+    def create(
+      connector,
+      deadline: nil
+    )
+      req = V1::ConnectorCreateRequest.new()
+
+      req.connector = Plumbing::convert_connector_to_plumbing(connector)
+      tries = 0
+      plumbing_response = nil
+      loop do
+        begin
+          plumbing_response = @stub.create(req, metadata: @parent.get_metadata("DiscoveryConnectors.Create", req), deadline: deadline)
+        rescue => exception
+          if (@parent.shouldRetry(tries, exception, deadline))
+            tries + +sleep(@parent.exponentialBackoff(tries, deadline))
+            next
+          end
+          raise Plumbing::convert_error_to_porcelain(exception)
+        end
+        break
+      end
+
+      resp = ConnectorCreateResponse.new()
+      resp.connector = Plumbing::convert_connector_to_porcelain(plumbing_response.connector)
+      resp.rate_limit = Plumbing::convert_rate_limit_metadata_to_porcelain(plumbing_response.rate_limit)
+      resp
+    end
+
+    # Get reads one Connector by ID
+    def get(
+      id,
+      deadline: nil
+    )
+      req = V1::ConnectorGetRequest.new()
+      if not @parent.snapshot_time.nil?
+        req.meta = V1::GetRequestMetadata.new()
+        req.meta.snapshot_at = @parent.snapshot_time
+      end
+
+      req.id = (id)
+      tries = 0
+      plumbing_response = nil
+      loop do
+        begin
+          plumbing_response = @stub.get(req, metadata: @parent.get_metadata("DiscoveryConnectors.Get", req), deadline: deadline)
+        rescue => exception
+          if (@parent.shouldRetry(tries, exception, deadline))
+            tries + +sleep(@parent.exponentialBackoff(tries, deadline))
+            next
+          end
+          raise Plumbing::convert_error_to_porcelain(exception)
+        end
+        break
+      end
+
+      resp = ConnectorGetResponse.new()
+      resp.connector = Plumbing::convert_connector_to_porcelain(plumbing_response.connector)
+      resp.meta = Plumbing::convert_get_response_metadata_to_porcelain(plumbing_response.meta)
+      resp.rate_limit = Plumbing::convert_rate_limit_metadata_to_porcelain(plumbing_response.rate_limit)
+      resp
+    end
+
+    # Update replaces all the fields of a Connector by ID.
+    def update(
+      connector,
+      deadline: nil
+    )
+      req = V1::ConnectorUpdateRequest.new()
+
+      req.connector = Plumbing::convert_connector_to_plumbing(connector)
+      tries = 0
+      plumbing_response = nil
+      loop do
+        begin
+          plumbing_response = @stub.update(req, metadata: @parent.get_metadata("DiscoveryConnectors.Update", req), deadline: deadline)
+        rescue => exception
+          if (@parent.shouldRetry(tries, exception, deadline))
+            tries + +sleep(@parent.exponentialBackoff(tries, deadline))
+            next
+          end
+          raise Plumbing::convert_error_to_porcelain(exception)
+        end
+        break
+      end
+
+      resp = ConnectorUpdateResponse.new()
+      resp.connector = Plumbing::convert_connector_to_porcelain(plumbing_response.connector)
+      resp.rate_limit = Plumbing::convert_rate_limit_metadata_to_porcelain(plumbing_response.rate_limit)
+      resp
+    end
+
+    # Delete removes a Connector by ID.
+    def delete(
+      id,
+      deadline: nil
+    )
+      req = V1::ConnectorDeleteRequest.new()
+
+      req.id = (id)
+      tries = 0
+      plumbing_response = nil
+      loop do
+        begin
+          plumbing_response = @stub.delete(req, metadata: @parent.get_metadata("DiscoveryConnectors.Delete", req), deadline: deadline)
+        rescue => exception
+          if (@parent.shouldRetry(tries, exception, deadline))
+            tries + +sleep(@parent.exponentialBackoff(tries, deadline))
+            next
+          end
+          raise Plumbing::convert_error_to_porcelain(exception)
+        end
+        break
+      end
+
+      resp = ConnectorDeleteResponse.new()
+      resp.meta = Plumbing::convert_delete_response_metadata_to_porcelain(plumbing_response.meta)
+      resp.rate_limit = Plumbing::convert_rate_limit_metadata_to_porcelain(plumbing_response.rate_limit)
+      resp
+    end
+
+    # List gets a list of Connectors matching a given set of criteria.
+    def list(
+      filter,
+      *args,
+      deadline: nil
+    )
+      req = V1::ConnectorListRequest.new()
+      req.meta = V1::ListRequestMetadata.new()
+      if not @parent.page_limit.nil?
+        req.meta.limit = @parent.page_limit
+      end
+      if not @parent.snapshot_time.nil?
+        req.meta.snapshot_at = @parent.snapshot_time
+      end
+
+      req.filter = Plumbing::quote_filter_args(filter, *args)
+      resp = Enumerator::Generator.new { |g|
+        tries = 0
+        loop do
+          begin
+            plumbing_response = @stub.list(req, metadata: @parent.get_metadata("DiscoveryConnectors.List", req), deadline: deadline)
+          rescue => exception
+            if (@parent.shouldRetry(tries, exception, deadline))
+              tries + +sleep(@parent.exponentialBackoff(tries, deadline))
+              next
+            end
+            raise Plumbing::convert_error_to_porcelain(exception)
+          end
+          tries = 0
+          plumbing_response.connectors.each do |plumbing_item|
+            g.yield Plumbing::convert_connector_to_porcelain(plumbing_item)
+          end
+          break if plumbing_response.meta.next_cursor == ""
+          req.meta.cursor = plumbing_response.meta.next_cursor
+        end
+      }
+      resp
+    end
+  end
+
+  # SnapshotDiscoveryConnectors exposes the read only methods of the DiscoveryConnectors
+  # service for historical queries.
+  class SnapshotDiscoveryConnectors
+    extend Gem::Deprecate
+
+    def initialize(discovery_connectors)
+      @discovery_connectors = discovery_connectors
+    end
+
+    # Get reads one Connector by ID
+    def get(
+      id,
+      deadline: nil
+    )
+      return @discovery_connectors.get(
+               id,
+               deadline: deadline,
+             )
+    end
+
+    # List gets a list of Connectors matching a given set of criteria.
+    def list(
+      filter,
+      *args,
+      deadline: nil
+    )
+      return @discovery_connectors.list(
+               filter,
+                            *args,
+                            deadline: deadline,
+             )
+    end
+  end
+
   # A Role has a list of access rules which determine which Resources the members
   # of the Role have access to. An Account can be a member of multiple Roles via
   # AccountAttachments.

data/lib/version

@@ -13,5 +13,5 @@
 # limitations under the License.
 #
 module SDM
-  VERSION = "15.39.0"
+  VERSION = "15.40.0"
 end

data/lib/version.rb

@@ -13,5 +13,5 @@
 # limitations under the License.
 #
 module SDM
-  VERSION = "15.39.0"
+  VERSION = "15.40.0"
 end