AWS SDK for C++  1.9.20
AWS SDK for C++
Public Member Functions | List of all members
Aws::SageMaker::Model::CreateCompilationJobRequest Class Reference

#include <CreateCompilationJobRequest.h>

+ Inheritance diagram for Aws::SageMaker::Model::CreateCompilationJobRequest:

Public Member Functions

 CreateCompilationJobRequest ()
 
virtual const char * GetServiceRequestName () const override
 
Aws::String SerializePayload () const override
 
Aws::Http::HeaderValueCollection GetRequestSpecificHeaders () const override
 
const Aws::StringGetCompilationJobName () const
 
bool CompilationJobNameHasBeenSet () const
 
void SetCompilationJobName (const Aws::String &value)
 
void SetCompilationJobName (Aws::String &&value)
 
void SetCompilationJobName (const char *value)
 
CreateCompilationJobRequestWithCompilationJobName (const Aws::String &value)
 
CreateCompilationJobRequestWithCompilationJobName (Aws::String &&value)
 
CreateCompilationJobRequestWithCompilationJobName (const char *value)
 
const Aws::StringGetRoleArn () const
 
bool RoleArnHasBeenSet () const
 
void SetRoleArn (const Aws::String &value)
 
void SetRoleArn (Aws::String &&value)
 
void SetRoleArn (const char *value)
 
CreateCompilationJobRequestWithRoleArn (const Aws::String &value)
 
CreateCompilationJobRequestWithRoleArn (Aws::String &&value)
 
CreateCompilationJobRequestWithRoleArn (const char *value)
 
const InputConfigGetInputConfig () const
 
bool InputConfigHasBeenSet () const
 
void SetInputConfig (const InputConfig &value)
 
void SetInputConfig (InputConfig &&value)
 
CreateCompilationJobRequestWithInputConfig (const InputConfig &value)
 
CreateCompilationJobRequestWithInputConfig (InputConfig &&value)
 
const OutputConfigGetOutputConfig () const
 
bool OutputConfigHasBeenSet () const
 
void SetOutputConfig (const OutputConfig &value)
 
void SetOutputConfig (OutputConfig &&value)
 
CreateCompilationJobRequestWithOutputConfig (const OutputConfig &value)
 
CreateCompilationJobRequestWithOutputConfig (OutputConfig &&value)
 
const StoppingConditionGetStoppingCondition () const
 
bool StoppingConditionHasBeenSet () const
 
void SetStoppingCondition (const StoppingCondition &value)
 
void SetStoppingCondition (StoppingCondition &&value)
 
CreateCompilationJobRequestWithStoppingCondition (const StoppingCondition &value)
 
CreateCompilationJobRequestWithStoppingCondition (StoppingCondition &&value)
 
const Aws::Vector< Tag > & GetTags () const
 
bool TagsHasBeenSet () const
 
void SetTags (const Aws::Vector< Tag > &value)
 
void SetTags (Aws::Vector< Tag > &&value)
 
CreateCompilationJobRequestWithTags (const Aws::Vector< Tag > &value)
 
CreateCompilationJobRequestWithTags (Aws::Vector< Tag > &&value)
 
CreateCompilationJobRequestAddTags (const Tag &value)
 
CreateCompilationJobRequestAddTags (Tag &&value)
 
- Public Member Functions inherited from Aws::SageMaker::SageMakerRequest
virtual ~SageMakerRequest ()
 
void AddParametersToRequest (Aws::Http::HttpRequest &httpRequest) const
 
Aws::Http::HeaderValueCollection GetHeaders () const override
 
- Public Member Functions inherited from Aws::AmazonSerializableWebServiceRequest
 AmazonSerializableWebServiceRequest ()
 
virtual ~AmazonSerializableWebServiceRequest ()
 
std::shared_ptr< Aws::IOStreamGetBody () const override
 
- Public Member Functions inherited from Aws::AmazonWebServiceRequest
 AmazonWebServiceRequest ()
 
virtual ~AmazonWebServiceRequest ()=default
 
virtual void AddQueryStringParameters (Aws::Http::URI &uri) const
 
virtual void PutToPresignedUrl (Aws::Http::URI &uri) const
 
virtual bool IsStreaming () const
 
virtual bool IsEventStreamRequest () const
 
virtual bool SignBody () const
 
virtual bool IsChunked () const
 
virtual void SetRequestSignedHandler (const RequestSignedHandler &handler)
 
virtual const RequestSignedHandlerGetRequestSignedHandler () const
 
const Aws::IOStreamFactoryGetResponseStreamFactory () const
 
void SetResponseStreamFactory (const Aws::IOStreamFactory &factory)
 
virtual void SetDataReceivedEventHandler (const Aws::Http::DataReceivedEventHandler &dataReceivedEventHandler)
 
virtual void SetDataSentEventHandler (const Aws::Http::DataSentEventHandler &dataSentEventHandler)
 
virtual void SetContinueRequestHandler (const Aws::Http::ContinueRequestHandler &continueRequestHandler)
 
virtual void SetDataReceivedEventHandler (Aws::Http::DataReceivedEventHandler &&dataReceivedEventHandler)
 
virtual void SetDataSentEventHandler (Aws::Http::DataSentEventHandler &&dataSentEventHandler)
 
virtual void SetContinueRequestHandler (Aws::Http::ContinueRequestHandler &&continueRequestHandler)
 
virtual void SetRequestRetryHandler (const RequestRetryHandler &handler)
 
virtual void SetRequestRetryHandler (RequestRetryHandler &&handler)
 
virtual const Aws::Http::DataReceivedEventHandlerGetDataReceivedEventHandler () const
 
virtual const Aws::Http::DataSentEventHandlerGetDataSentEventHandler () const
 
virtual const Aws::Http::ContinueRequestHandlerGetContinueRequestHandler () const
 
virtual const RequestRetryHandlerGetRequestRetryHandler () const
 
virtual bool ShouldComputeContentMd5 () const
 

Additional Inherited Members

- Protected Member Functions inherited from Aws::AmazonWebServiceRequest
virtual void DumpBodyToUrl (Aws::Http::URI &uri) const
 

Detailed Description

Definition at line 26 of file CreateCompilationJobRequest.h.

Constructor & Destructor Documentation

◆ CreateCompilationJobRequest()

Aws::SageMaker::Model::CreateCompilationJobRequest::CreateCompilationJobRequest ( )

Member Function Documentation

◆ AddTags() [1/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::AddTags ( const Tag value)
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 396 of file CreateCompilationJobRequest.h.

◆ AddTags() [2/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::AddTags ( Tag &&  value)
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 405 of file CreateCompilationJobRequest.h.

◆ CompilationJobNameHasBeenSet()

bool Aws::SageMaker::Model::CreateCompilationJobRequest::CompilationJobNameHasBeenSet ( ) const
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 52 of file CreateCompilationJobRequest.h.

◆ GetCompilationJobName()

const Aws::String& Aws::SageMaker::Model::CreateCompilationJobRequest::GetCompilationJobName ( ) const
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 46 of file CreateCompilationJobRequest.h.

◆ GetInputConfig()

const InputConfig& Aws::SageMaker::Model::CreateCompilationJobRequest::GetInputConfig ( ) const
inline

Provides information about the location of input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.

Definition at line 217 of file CreateCompilationJobRequest.h.

◆ GetOutputConfig()

const OutputConfig& Aws::SageMaker::Model::CreateCompilationJobRequest::GetOutputConfig ( ) const
inline

Provides information about the output location for the compiled model and the target device the model runs on.

Definition at line 259 of file CreateCompilationJobRequest.h.

◆ GetRequestSpecificHeaders()

Aws::Http::HeaderValueCollection Aws::SageMaker::Model::CreateCompilationJobRequest::GetRequestSpecificHeaders ( ) const
overridevirtual

Reimplemented from Aws::SageMaker::SageMakerRequest.

◆ GetRoleArn()

const Aws::String& Aws::SageMaker::Model::CreateCompilationJobRequest::GetRoleArn ( ) const
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 104 of file CreateCompilationJobRequest.h.

◆ GetServiceRequestName()

virtual const char* Aws::SageMaker::Model::CreateCompilationJobRequest::GetServiceRequestName ( ) const
inlineoverridevirtual

Implements Aws::AmazonWebServiceRequest.

Definition at line 35 of file CreateCompilationJobRequest.h.

◆ GetStoppingCondition()

const StoppingCondition& Aws::SageMaker::Model::CreateCompilationJobRequest::GetStoppingCondition ( ) const
inline

Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.

Definition at line 297 of file CreateCompilationJobRequest.h.

◆ GetTags()

const Aws::Vector<Tag>& Aws::SageMaker::Model::CreateCompilationJobRequest::GetTags ( ) const
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 342 of file CreateCompilationJobRequest.h.

◆ InputConfigHasBeenSet()

bool Aws::SageMaker::Model::CreateCompilationJobRequest::InputConfigHasBeenSet ( ) const
inline

Provides information about the location of input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.

Definition at line 224 of file CreateCompilationJobRequest.h.

◆ OutputConfigHasBeenSet()

bool Aws::SageMaker::Model::CreateCompilationJobRequest::OutputConfigHasBeenSet ( ) const
inline

Provides information about the output location for the compiled model and the target device the model runs on.

Definition at line 265 of file CreateCompilationJobRequest.h.

◆ RoleArnHasBeenSet()

bool Aws::SageMaker::Model::CreateCompilationJobRequest::RoleArnHasBeenSet ( ) const
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 119 of file CreateCompilationJobRequest.h.

◆ SerializePayload()

Aws::String Aws::SageMaker::Model::CreateCompilationJobRequest::SerializePayload ( ) const
overridevirtual

Convert payload into String.

Implements Aws::AmazonSerializableWebServiceRequest.

◆ SetCompilationJobName() [1/3]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetCompilationJobName ( Aws::String &&  value)
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 64 of file CreateCompilationJobRequest.h.

◆ SetCompilationJobName() [2/3]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetCompilationJobName ( const Aws::String value)
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 58 of file CreateCompilationJobRequest.h.

◆ SetCompilationJobName() [3/3]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetCompilationJobName ( const char *  value)
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 70 of file CreateCompilationJobRequest.h.

◆ SetInputConfig() [1/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetInputConfig ( const InputConfig value)
inline

Provides information about the location of input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.

Definition at line 231 of file CreateCompilationJobRequest.h.

◆ SetInputConfig() [2/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetInputConfig ( InputConfig &&  value)
inline

Provides information about the location of input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.

Definition at line 238 of file CreateCompilationJobRequest.h.

◆ SetOutputConfig() [1/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetOutputConfig ( const OutputConfig value)
inline

Provides information about the output location for the compiled model and the target device the model runs on.

Definition at line 271 of file CreateCompilationJobRequest.h.

◆ SetOutputConfig() [2/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetOutputConfig ( OutputConfig &&  value)
inline

Provides information about the output location for the compiled model and the target device the model runs on.

Definition at line 277 of file CreateCompilationJobRequest.h.

◆ SetRoleArn() [1/3]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetRoleArn ( Aws::String &&  value)
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 149 of file CreateCompilationJobRequest.h.

◆ SetRoleArn() [2/3]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetRoleArn ( const Aws::String value)
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 134 of file CreateCompilationJobRequest.h.

◆ SetRoleArn() [3/3]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetRoleArn ( const char *  value)
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 164 of file CreateCompilationJobRequest.h.

◆ SetStoppingCondition() [1/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetStoppingCondition ( const StoppingCondition value)
inline

Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.

Definition at line 311 of file CreateCompilationJobRequest.h.

◆ SetStoppingCondition() [2/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetStoppingCondition ( StoppingCondition &&  value)
inline

Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.

Definition at line 318 of file CreateCompilationJobRequest.h.

◆ SetTags() [1/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetTags ( Aws::Vector< Tag > &&  value)
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 369 of file CreateCompilationJobRequest.h.

◆ SetTags() [2/2]

void Aws::SageMaker::Model::CreateCompilationJobRequest::SetTags ( const Aws::Vector< Tag > &  value)
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 360 of file CreateCompilationJobRequest.h.

◆ StoppingConditionHasBeenSet()

bool Aws::SageMaker::Model::CreateCompilationJobRequest::StoppingConditionHasBeenSet ( ) const
inline

Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.

Definition at line 304 of file CreateCompilationJobRequest.h.

◆ TagsHasBeenSet()

bool Aws::SageMaker::Model::CreateCompilationJobRequest::TagsHasBeenSet ( ) const
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 351 of file CreateCompilationJobRequest.h.

◆ WithCompilationJobName() [1/3]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithCompilationJobName ( Aws::String &&  value)
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 82 of file CreateCompilationJobRequest.h.

◆ WithCompilationJobName() [2/3]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithCompilationJobName ( const Aws::String value)
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 76 of file CreateCompilationJobRequest.h.

◆ WithCompilationJobName() [3/3]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithCompilationJobName ( const char *  value)
inline

A name for the model compilation job. The name must be unique within the AWS Region and within your AWS account.

Definition at line 88 of file CreateCompilationJobRequest.h.

◆ WithInputConfig() [1/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithInputConfig ( const InputConfig value)
inline

Provides information about the location of input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.

Definition at line 245 of file CreateCompilationJobRequest.h.

◆ WithInputConfig() [2/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithInputConfig ( InputConfig &&  value)
inline

Provides information about the location of input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.

Definition at line 252 of file CreateCompilationJobRequest.h.

◆ WithOutputConfig() [1/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithOutputConfig ( const OutputConfig value)
inline

Provides information about the output location for the compiled model and the target device the model runs on.

Definition at line 283 of file CreateCompilationJobRequest.h.

◆ WithOutputConfig() [2/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithOutputConfig ( OutputConfig &&  value)
inline

Provides information about the output location for the compiled model and the target device the model runs on.

Definition at line 289 of file CreateCompilationJobRequest.h.

◆ WithRoleArn() [1/3]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithRoleArn ( Aws::String &&  value)
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 194 of file CreateCompilationJobRequest.h.

◆ WithRoleArn() [2/3]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithRoleArn ( const Aws::String value)
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 179 of file CreateCompilationJobRequest.h.

◆ WithRoleArn() [3/3]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithRoleArn ( const char *  value)
inline

The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to perform tasks on your behalf.

During model compilation, Amazon SageMaker needs your permission to:

  • Read input data from an S3 bucket

  • Write model artifacts to an S3 bucket

  • Write logs to Amazon CloudWatch Logs

  • Publish metrics to Amazon CloudWatch

You grant permissions for all of these tasks to an IAM role. To pass this role to Amazon SageMaker, the caller of this API must have the iam:PassRole permission. For more information, see Amazon SageMaker Roles.

Definition at line 209 of file CreateCompilationJobRequest.h.

◆ WithStoppingCondition() [1/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithStoppingCondition ( const StoppingCondition value)
inline

Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.

Definition at line 325 of file CreateCompilationJobRequest.h.

◆ WithStoppingCondition() [2/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithStoppingCondition ( StoppingCondition &&  value)
inline

Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker ends the compilation job. Use this API to cap model training costs.

Definition at line 332 of file CreateCompilationJobRequest.h.

◆ WithTags() [1/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithTags ( Aws::Vector< Tag > &&  value)
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 387 of file CreateCompilationJobRequest.h.

◆ WithTags() [2/2]

CreateCompilationJobRequest& Aws::SageMaker::Model::CreateCompilationJobRequest::WithTags ( const Aws::Vector< Tag > &  value)
inline

An array of key-value pairs. You can use tags to categorize your AWS resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging AWS Resources.

Definition at line 378 of file CreateCompilationJobRequest.h.


The documentation for this class was generated from the following file: