Class: Aws::Comprehend::Types::StartTopicsDetectionJobRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb

Overview

Note:

When making an API call, you may pass StartTopicsDetectionJobRequest data as a hash:

{
  input_data_config: { # required
    s3_uri: "S3Uri", # required
    input_format: "ONE_DOC_PER_FILE", # accepts ONE_DOC_PER_FILE, ONE_DOC_PER_LINE
  },
  output_data_config: { # required
    s3_uri: "S3Uri", # required
    kms_key_id: "KmsKeyId",
  },
  data_access_role_arn: "IamRoleArn", # required
  job_name: "JobName",
  number_of_topics: 1,
  client_request_token: "ClientRequestTokenString",
  volume_kms_key_id: "KmsKeyId",
  vpc_config: {
    security_group_ids: ["SecurityGroupId"], # required
    subnets: ["SubnetId"], # required
  },
}

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#client_request_tokenString

A unique identifier for the request. If you do not set the client request token, Amazon Comprehend generates one.

A suitable default value is auto-generated. You should normally not need to pass this option.

Returns:

  • (String)


4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#data_access_role_arnString

The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that grants Amazon Comprehend read access to your input data. For more information, see https://docs.aws.amazon.com/comprehend/latest/dg/access-control-managing-permissions.html#auth-role-permissions.

Returns:

  • (String)


4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#input_data_configTypes::InputDataConfig

Specifies the format and location of the input data for the job.



4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#job_nameString

The identifier of the job.

Returns:

  • (String)


4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#number_of_topicsInteger

The number of topics to detect.

Returns:

  • (Integer)


4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#output_data_configTypes::OutputDataConfig

Specifies where to send the output files. The output is a compressed archive with two files, topic-terms.csv that lists the terms associated with each topic, and doc-topics.csv that lists the documents associated with each topic



4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#volume_kms_key_idString

ID for the AWS Key Management Service (KMS) key that Amazon Comprehend uses to encrypt data on the storage volume attached to the ML compute instance(s) that process the analysis job. The VolumeKmsKeyId can be either of the following formats:

  • KMS Key ID: "1234abcd-12ab-34cd-56ef-1234567890ab"

  • Amazon Resource Name (ARN) of a KMS Key: "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"

Returns:

  • (String)


4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end

#vpc_configTypes::VpcConfig

Configuration parameters for an optional private Virtual Private Cloud (VPC) containing the resources you are using for your topic detection job. For more information, see Amazon VPC.

Returns:



4631
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642
# File 'gems/aws-sdk-comprehend/lib/aws-sdk-comprehend/types.rb', line 4631

class StartTopicsDetectionJobRequest < Struct.new(
  :input_data_config,
  :output_data_config,
  :data_access_role_arn,
  :job_name,
  :number_of_topics,
  :client_request_token,
  :volume_kms_key_id,
  :vpc_config)
  SENSITIVE = []
  include Aws::Structure
end