Learn R Programming

paws (version 0.4.0)

sagemaker: Amazon SageMaker Service

Description

Provides APIs for creating and managing SageMaker resources.

Other Resources:

Usage

sagemaker(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

    • endpoint: The complete URL to use for the constructed client.

    • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Service syntax

svc <- sagemaker(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

add_associationCreates an association between the source and the destination
add_tagsAdds or overwrites one or more tags for the specified SageMaker resource
associate_trial_componentAssociates a trial component with a trial
batch_describe_model_packageThis action batch describes a list of versioned model packages
create_actionCreates an action
create_algorithmCreate a machine learning algorithm that you can use in SageMaker and list in the Amazon Web Services Marketplace
create_appCreates a running app for the specified UserProfile
create_app_image_configCreates a configuration for running a SageMaker image as a KernelGateway app
create_artifactCreates an artifact
create_auto_ml_jobCreates an Autopilot job also referred to as Autopilot experiment or AutoML job
create_auto_ml_job_v2Creates an Autopilot job also referred to as Autopilot experiment or AutoML job V2
create_code_repositoryCreates a Git repository as a resource in your SageMaker account
create_compilation_jobStarts a model compilation job
create_contextCreates a context
create_data_quality_job_definitionCreates a definition for a job that monitors data quality and drift
create_device_fleetCreates a device fleet
create_domainCreates a Domain used by Amazon SageMaker Studio
create_edge_deployment_planCreates an edge deployment plan, consisting of multiple stages
create_edge_deployment_stageCreates a new stage in an existing edge deployment plan
create_edge_packaging_jobStarts a SageMaker Edge Manager model packaging job
create_endpointCreates an endpoint using the endpoint configuration specified in the request
create_endpoint_configCreates an endpoint configuration that SageMaker hosting services uses to deploy models
create_experimentCreates a SageMaker experiment
create_feature_groupCreate a new FeatureGroup
create_flow_definitionCreates a flow definition
create_hubCreate a hub
create_human_task_uiDefines the settings you will use for the human review workflow user interface
create_hyper_parameter_tuning_jobStarts a hyperparameter tuning job
create_imageCreates a custom SageMaker image
create_image_versionCreates a version of the SageMaker image specified by ImageName
create_inference_experimentCreates an inference experiment using the configurations specified in the request
create_inference_recommendations_jobStarts a recommendation job
create_labeling_jobCreates a job that uses workers to label the data objects in your input dataset
create_modelCreates a model in SageMaker
create_model_bias_job_definitionCreates the definition for a model bias job
create_model_cardCreates an Amazon SageMaker Model Card
create_model_card_export_jobCreates an Amazon SageMaker Model Card export job
create_model_explainability_job_definitionCreates the definition for a model explainability job
create_model_packageCreates a model package that you can use to create SageMaker models or list on Amazon Web Services Marketplace, or a versioned model that is part of a model group
create_model_package_groupCreates a model group
create_model_quality_job_definitionCreates a definition for a job that monitors model quality and drift
create_monitoring_scheduleCreates a schedule that regularly starts Amazon SageMaker Processing Jobs to monitor the data captured for an Amazon SageMaker Endpoint
create_notebook_instanceCreates an SageMaker notebook instance
create_notebook_instance_lifecycle_configCreates a lifecycle configuration that you can associate with a notebook instance
create_pipelineCreates a pipeline using a JSON pipeline definition
create_presigned_domain_urlCreates a URL for a specified UserProfile in a Domain
create_presigned_notebook_instance_urlReturns a URL that you can use to connect to the Jupyter server from a notebook instance
create_processing_jobCreates a processing job
create_projectCreates a machine learning (ML) project that can contain one or more templates that set up an ML pipeline from training to deploying an approved model
create_spaceCreates a space used for real time collaboration in a Domain
create_studio_lifecycle_configCreates a new Studio Lifecycle Configuration
create_training_jobStarts a model training job
create_transform_jobStarts a transform job
create_trialCreates an SageMaker trial
create_trial_componentCreates a trial component, which is a stage of a machine learning trial
create_user_profileCreates a user profile
create_workforceUse this operation to create a workforce
create_workteamCreates a new work team for labeling your data
delete_actionDeletes an action
delete_algorithmRemoves the specified algorithm from your account
delete_appUsed to stop and delete an app
delete_app_image_configDeletes an AppImageConfig
delete_artifactDeletes an artifact
delete_associationDeletes an association
delete_code_repositoryDeletes the specified Git repository from your account
delete_contextDeletes an context
delete_data_quality_job_definitionDeletes a data quality monitoring job definition
delete_device_fleetDeletes a fleet
delete_domainUsed to delete a domain
delete_edge_deployment_planDeletes an edge deployment plan if (and only if) all the stages in the plan are inactive or there are no stages in the plan
delete_edge_deployment_stageDelete a stage in an edge deployment plan if (and only if) the stage is inactive
delete_endpointDeletes an endpoint
delete_endpoint_configDeletes an endpoint configuration
delete_experimentDeletes an SageMaker experiment
delete_feature_groupDelete the FeatureGroup and any data that was written to the OnlineStore of the FeatureGroup
delete_flow_definitionDeletes the specified flow definition
delete_hubDelete a hub
delete_hub_contentDelete the contents of a hub
delete_human_task_uiUse this operation to delete a human task user interface (worker task template)
delete_imageDeletes a SageMaker image and all versions of the image
delete_image_versionDeletes a version of a SageMaker image
delete_inference_experimentDeletes an inference experiment
delete_modelDeletes a model
delete_model_bias_job_definitionDeletes an Amazon SageMaker model bias job definition
delete_model_cardDeletes an Amazon SageMaker Model Card
delete_model_explainability_job_definitionDeletes an Amazon SageMaker model explainability job definition
delete_model_packageDeletes a model package
delete_model_package_groupDeletes the specified model group
delete_model_package_group_policyDeletes a model group resource policy
delete_model_quality_job_definitionDeletes the secified model quality monitoring job definition
delete_monitoring_scheduleDeletes a monitoring schedule
delete_notebook_instanceDeletes an SageMaker notebook instance
delete_notebook_instance_lifecycle_configDeletes a notebook instance lifecycle configuration
delete_pipelineDeletes a pipeline if there are no running instances of the pipeline
delete_projectDelete the specified project
delete_spaceUsed to delete a space
delete_studio_lifecycle_configDeletes the Studio Lifecycle Configuration
delete_tagsDeletes the specified tags from an SageMaker resource
delete_trialDeletes the specified trial
delete_trial_componentDeletes the specified trial component
delete_user_profileDeletes a user profile
delete_workforceUse this operation to delete a workforce
delete_workteamDeletes an existing work team
deregister_devicesDeregisters the specified devices
describe_actionDescribes an action
describe_algorithmReturns a description of the specified algorithm that is in your account
describe_appDescribes the app
describe_app_image_configDescribes an AppImageConfig
describe_artifactDescribes an artifact
describe_auto_ml_jobReturns information about an AutoML job created by calling CreateAutoMLJob
describe_auto_ml_job_v2Returns information about an AutoML job created by calling CreateAutoMLJobV2 or CreateAutoMLJob
describe_code_repositoryGets details about the specified Git repository
describe_compilation_jobReturns information about a model compilation job
describe_contextDescribes a context
describe_data_quality_job_definitionGets the details of a data quality monitoring job definition
describe_deviceDescribes the device
describe_device_fleetA description of the fleet the device belongs to
describe_domainThe description of the domain
describe_edge_deployment_planDescribes an edge deployment plan with deployment status per stage
describe_edge_packaging_jobA description of edge packaging jobs
describe_endpointReturns the description of an endpoint
describe_endpoint_configReturns the description of an endpoint configuration created using the CreateEndpointConfig API
describe_experimentProvides a list of an experiment's properties
describe_feature_groupUse this operation to describe a FeatureGroup
describe_feature_metadataShows the metadata for a feature within a feature group
describe_flow_definitionReturns information about the specified flow definition
describe_hubDescribe a hub
describe_hub_contentDescribe the content of a hub
describe_human_task_uiReturns information about the requested human task user interface (worker task template)
describe_hyper_parameter_tuning_jobReturns a description of a hyperparameter tuning job, depending on the fields selected
describe_imageDescribes a SageMaker image
describe_image_versionDescribes a version of a SageMaker image
describe_inference_experimentReturns details about an inference experiment
describe_inference_recommendations_jobProvides the results of the Inference Recommender job
describe_labeling_jobGets information about a labeling job
describe_lineage_groupProvides a list of properties for the requested lineage group
describe_modelDescribes a model that you created using the CreateModel API
describe_model_bias_job_definitionReturns a description of a model bias job definition
describe_model_cardDescribes the content, creation time, and security configuration of an Amazon SageMaker Model Card
describe_model_card_export_jobDescribes an Amazon SageMaker Model Card export job
describe_model_explainability_job_definitionReturns a description of a model explainability job definition
describe_model_packageReturns a description of the specified model package, which is used to create SageMaker models or list them on Amazon Web Services Marketplace
describe_model_package_groupGets a description for the specified model group
describe_model_quality_job_definitionReturns a description of a model quality job definition
describe_monitoring_scheduleDescribes the schedule for a monitoring job
describe_notebook_instanceReturns information about a notebook instance
describe_notebook_instance_lifecycle_configReturns a description of a notebook instance lifecycle configuration
describe_pipelineDescribes the details of a pipeline
describe_pipeline_definition_for_executionDescribes the details of an execution's pipeline definition
describe_pipeline_executionDescribes the details of a pipeline execution
describe_processing_jobReturns a description of a processing job
describe_projectDescribes the details of a project
describe_spaceDescribes the space
describe_studio_lifecycle_configDescribes the Studio Lifecycle Configuration
describe_subscribed_workteamGets information about a work team provided by a vendor
describe_training_jobReturns information about a training job
describe_transform_jobReturns information about a transform job
describe_trialProvides a list of a trial's properties
describe_trial_componentProvides a list of a trials component's properties
describe_user_profileDescribes a user profile
describe_workforceLists private workforce information, including workforce name, Amazon Resource Name (ARN), and, if applicable, allowed IP address ranges (CIDRs)
describe_workteamGets information about a specific work team
disable_sagemaker_servicecatalog_portfolioDisables using Service Catalog in SageMaker
disassociate_trial_componentDisassociates a trial component from a trial
enable_sagemaker_servicecatalog_portfolioEnables using Service Catalog in SageMaker
get_device_fleet_reportDescribes a fleet
get_lineage_group_policyThe resource policy for the lineage group
get_model_package_group_policyGets a resource policy that manages access for a model group
get_sagemaker_servicecatalog_portfolio_statusGets the status of Service Catalog in SageMaker
get_scaling_configuration_recommendationStarts an Amazon SageMaker Inference Recommender autoscaling recommendation job
get_search_suggestionsAn auto-complete API for the search functionality in the SageMaker console
import_hub_contentImport hub content
list_actionsLists the actions in your account and their properties
list_algorithmsLists the machine learning algorithms that have been created
list_aliasesLists the aliases of a specified image or image version
list_app_image_configsLists the AppImageConfigs in your account and their properties
list_appsLists apps
list_artifactsLists the artifacts in your account and their properties
list_associationsLists the associations in your account and their properties
list_auto_ml_jobsRequest a list of jobs
list_candidates_for_auto_ml_jobList the candidates created for the job
list_code_repositoriesGets a list of the Git repositories in your account
list_compilation_jobsLists model compilation jobs that satisfy various filters
list_contextsLists the contexts in your account and their properties
list_data_quality_job_definitionsLists the data quality job definitions in your account
list_device_fleetsReturns a list of devices in the fleet
list_devicesA list of devices
list_domainsLists the domains
list_edge_deployment_plansLists all edge deployment plans
list_edge_packaging_jobsReturns a list of edge packaging jobs
list_endpoint_configsLists endpoint configurations
list_endpointsLists endpoints
list_experimentsLists all the experiments in your account
list_feature_groupsList FeatureGroups based on given filter and order
list_flow_definitionsReturns information about the flow definitions in your account
list_hub_contentsList the contents of a hub
list_hub_content_versionsList hub content versions
list_hubsList all existing hubs
list_human_task_uisReturns information about the human task user interfaces in your account
list_hyper_parameter_tuning_jobsGets a list of HyperParameterTuningJobSummary objects that describe the hyperparameter tuning jobs launched in your account
list_imagesLists the images in your account and their properties
list_image_versionsLists the versions of a specified image and their properties
list_inference_experimentsReturns the list of all inference experiments
list_inference_recommendations_jobsLists recommendation jobs that satisfy various filters
list_inference_recommendations_job_stepsReturns a list of the subtasks for an Inference Recommender job
list_labeling_jobsGets a list of labeling jobs
list_labeling_jobs_for_workteamGets a list of labeling jobs assigned to a specified work team
list_lineage_groupsA list of lineage groups shared with your Amazon Web Services account
list_model_bias_job_definitionsLists model bias jobs definitions that satisfy various filters
list_model_card_export_jobsList the export jobs for the Amazon SageMaker Model Card
list_model_cardsList existing model cards
list_model_card_versionsList existing versions of an Amazon SageMaker Model Card
list_model_explainability_job_definitionsLists model explainability job definitions that satisfy various filters
list_model_metadataLists the domain, framework, task, and model name of standard machine learning models found in common model zoos
list_model_package_groupsGets a list of the model groups in your Amazon Web Services account
list_model_packagesLists the model packages that have been created
list_model_quality_job_definitionsGets a list of model quality monitoring job definitions in your account
list_modelsLists models created with the CreateModel API
list_monitoring_alert_historyGets a list of past alerts in a model monitoring schedule
list_monitoring_alertsGets the alerts for a single monitoring schedule
list_monitoring_executionsReturns list of all monitoring job executions
list_monitoring_schedulesReturns list of all monitoring schedules
list_notebook_instance_lifecycle_configsLists notebook instance lifestyle configurations created with the CreateNotebookInstanceLifecycleConfig API
list_notebook_instancesReturns a list of the SageMaker notebook instances in the requester's account in an Amazon Web Services Region
list_pipeline_executionsGets a list of the pipeline executions
list_pipeline_execution_stepsGets a list of PipeLineExecutionStep objects
list_pipeline_parameters_for_executionGets a list of parameters for a pipeline execution
list_pipelinesGets a list of pipelines
list_processing_jobsLists processing jobs that satisfy various filters
list_projectsGets a list of the projects in an Amazon Web Services account
list_resource_catalogsLists Amazon SageMaker Catalogs based on given filters and orders
list_spacesLists spaces
list_stage_devicesLists devices allocated to the stage, containing detailed device information and deployment status
list_studio_lifecycle_configsLists the Studio Lifecycle Configurations in your Amazon Web Services Account
list_subscribed_workteamsGets a list of the work teams that you are subscribed to in the Amazon Web Services Marketplace
list_tagsReturns the tags for the specified SageMaker resource
list_training_jobsLists training jobs
list_training_jobs_for_hyper_parameter_tuning_jobGets a list of TrainingJobSummary objects that describe the training jobs that a hyperparameter tuning job launched
list_transform_jobsLists transform jobs
list_trial_componentsLists the trial components in your account
list_trialsLists the trials in your account
list_user_profilesLists user profiles
list_workforcesUse this operation to list all private and vendor workforces in an Amazon Web Services Region
list_workteamsGets a list of private work teams that you have defined in a region
put_model_package_group_policyAdds a resouce policy to control access to a model group
query_lineageUse this action to inspect your lineage and discover relationships between entities
register_devicesRegister devices
render_ui_templateRenders the UI template so that you can preview the worker's experience
retry_pipeline_executionRetry the execution of the pipeline
searchFinds SageMaker resources that match a search query
send_pipeline_execution_step_failureNotifies the pipeline that the execution of a callback step failed, along with a message describing why
send_pipeline_execution_step_successNotifies the pipeline that the execution of a callback step succeeded and provides a list of the step's output parameters
start_edge_deployment_stageStarts a stage in an edge deployment plan
start_inference_experimentStarts an inference experiment
start_monitoring_scheduleStarts a previously stopped monitoring schedule
start_notebook_instanceLaunches an ML compute instance with the latest version of the libraries and attaches your ML storage volume
start_pipeline_executionStarts a pipeline execution
stop_auto_ml_jobA method for forcing a running job to shut down
stop_compilation_jobStops a model compilation job
stop_edge_deployment_stageStops a stage in an edge deployment plan
stop_edge_packaging_jobRequest to stop an edge packaging job
stop_hyper_parameter_tuning_jobStops a running hyperparameter tuning job and all running training jobs that the tuning job launched
stop_inference_experimentStops an inference experiment
stop_inference_recommendations_jobStops an Inference Recommender job
stop_labeling_jobStops a running labeling job
stop_monitoring_scheduleStops a previously started monitoring schedule
stop_notebook_instanceTerminates the ML compute instance
stop_pipeline_executionStops a pipeline execution
stop_processing_jobStops a processing job
stop_training_jobStops a training job
stop_transform_jobStops a batch transform job
update_actionUpdates an action
update_app_image_configUpdates the properties of an AppImageConfig
update_artifactUpdates an artifact
update_code_repositoryUpdates the specified Git repository with the specified values
update_contextUpdates a context
update_device_fleetUpdates a fleet of devices
update_devicesUpdates one or more devices in a fleet
update_domainUpdates the default settings for new user profiles in the domain
update_endpointDeploys the new EndpointConfig specified in the request, switches to using newly created endpoint, and then deletes resources provisioned for the endpoint using the previous EndpointConfig (there is no availability loss)
update_endpoint_weights_and_capacitiesUpdates variant weight of one or more variants associated with an existing endpoint, or capacity of one variant associated with an existing endpoint
update_experimentAdds, updates, or removes the description of an experiment
update_feature_groupUpdates the feature group by either adding features or updating the online store configuration
update_feature_metadataUpdates the description and parameters of the feature group
update_hubUpdate a hub
update_imageUpdates the properties of a SageMaker image
update_image_versionUpdates the properties of a SageMaker image version
update_inference_experimentUpdates an inference experiment that you created
update_model_cardUpdate an Amazon SageMaker Model Card
update_model_packageUpdates a versioned model
update_monitoring_alertUpdate the parameters of a model monitor alert
update_monitoring_scheduleUpdates a previously created schedule
update_notebook_instanceUpdates a notebook instance
update_notebook_instance_lifecycle_configUpdates a notebook instance lifecycle configuration created with the CreateNotebookInstanceLifecycleConfig API
update_pipelineUpdates a pipeline
update_pipeline_executionUpdates a pipeline execution
update_projectUpdates a machine learning (ML) project that is created from a template that sets up an ML pipeline from training to deploying an approved model
update_spaceUpdates the settings of a space
update_training_jobUpdate a model training job to request a new Debugger profiling configuration or to change warm pool retention length
update_trialUpdates the display name of a trial
update_trial_componentUpdates one or more properties of a trial component
update_user_profileUpdates a user profile
update_workforceUse this operation to update your workforce
update_workteamUpdates an existing work team with new member definitions or description

Examples

Run this code
if (FALSE) {
svc <- sagemaker()
svc$add_association(
  Foo = 123
)
}

Run the code above in your browser using DataLab