Skip to content

Client

opsworks R Documentation

AWS OpsWorks

Description

OpsWorks

Welcome to the OpsWorks Stacks API Reference. This guide provides descriptions, syntax, and usage examples for OpsWorks Stacks actions and data types, including common parameters and error codes.

OpsWorks Stacks is an application management service that provides an integrated experience for managing the complete application lifecycle. For information about OpsWorks, see the OpsWorks information page.

SDKs and CLI

Use the OpsWorks Stacks API by using the Command Line Interface (CLI) or by using one of the Amazon Web Services SDKs to implement applications in your preferred language. For more information, see:

Endpoints

OpsWorks Stacks supports the following endpoints, all HTTPS. You must connect to one of the following endpoints. Stacks can only be accessed or managed within the endpoint in which they are created.

  • opsworks.us-east-1.amazonaws.com

  • opsworks.us-east-2.amazonaws.com

  • opsworks.us-west-1.amazonaws.com

  • opsworks.us-west-2.amazonaws.com

  • opsworks.ca-central-1.amazonaws.com (API only; not available in the Amazon Web Services Management Console)

  • opsworks.eu-west-1.amazonaws.com

  • opsworks.eu-west-2.amazonaws.com

  • opsworks.eu-west-3.amazonaws.com

  • opsworks.eu-central-1.amazonaws.com

  • opsworks.ap-northeast-1.amazonaws.com

  • opsworks.ap-northeast-2.amazonaws.com

  • opsworks.ap-south-1.amazonaws.com

  • opsworks.ap-southeast-1.amazonaws.com

  • opsworks.ap-southeast-2.amazonaws.com

  • opsworks.sa-east-1.amazonaws.com

Chef Versions

When you call create_stack, clone_stack, or update_stack we recommend you use the ConfigurationManager parameter to specify the Chef version. The recommended and default value for Linux stacks is currently 12. Windows stacks use Chef 12.2. For more information, see Chef Versions.

You can specify Chef 12, 11.10, or 11.4 for your Linux stack. We recommend migrating your existing Linux stacks to Chef 12 as soon as possible.

Usage

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

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.

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.

Service syntax

svc <- opsworks(
  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

assign_instance
Assign a registered instance to a layer
assign_volume
Assigns one of the stack's registered Amazon EBS volumes to a specified instance
associate_elastic_ip
Associates one of the stack's registered Elastic IP addresses with a specified instance
attach_elastic_load_balancer
Attaches an Elastic Load Balancing load balancer to a specified layer
clone_stack
Creates a clone of a specified stack
create_app
Creates an app for a specified stack
create_deployment
Runs deployment or stack commands
create_instance
Creates an instance in a specified stack
create_layer
Creates a layer
create_stack
Creates a new stack
create_user_profile
Creates a new user profile
delete_app
Deletes a specified app
delete_instance
Deletes a specified instance, which terminates the associated Amazon EC2 instance
delete_layer
Deletes a specified layer
delete_stack
Deletes a specified stack
delete_user_profile
Deletes a user profile
deregister_ecs_cluster
Deregisters a specified Amazon ECS cluster from a stack
deregister_elastic_ip
Deregisters a specified Elastic IP address
deregister_instance
Deregister an instance from OpsWorks Stacks
deregister_rds_db_instance
Deregisters an Amazon RDS instance
deregister_volume
Deregisters an Amazon EBS volume
describe_agent_versions
Describes the available OpsWorks Stacks agent versions
describe_apps
Requests a description of a specified set of apps
describe_commands
Describes the results of specified commands
describe_deployments
Requests a description of a specified set of deployments
describe_ecs_clusters
Describes Amazon ECS clusters that are registered with a stack
describe_elastic_ips
Describes Elastic IP addresses
describe_elastic_load_balancers
Describes a stack's Elastic Load Balancing instances
describe_instances
Requests a description of a set of instances
describe_layers
Requests a description of one or more layers in a specified stack
describe_load_based_auto_scaling
Describes load-based auto scaling configurations for specified layers
describe_my_user_profile
Describes a user's SSH information
describe_operating_systems
Describes the operating systems that are supported by OpsWorks Stacks
describe_permissions
Describes the permissions for a specified stack
describe_raid_arrays
Describe an instance's RAID arrays
describe_rds_db_instances
Describes Amazon RDS instances
describe_service_errors
Describes OpsWorks Stacks service errors
describe_stack_provisioning_parameters
Requests a description of a stack's provisioning parameters
describe_stacks
Requests a description of one or more stacks
describe_stack_summary
Describes the number of layers and apps in a specified stack, and the number of instances in each state, such as running_setup or online
describe_time_based_auto_scaling
Describes time-based auto scaling configurations for specified instances
describe_user_profiles
Describe specified users
describe_volumes
Describes an instance's Amazon EBS volumes
detach_elastic_load_balancer
Detaches a specified Elastic Load Balancing instance from its layer
disassociate_elastic_ip
Disassociates an Elastic IP address from its instance
get_hostname_suggestion
Gets a generated host name for the specified layer, based on the current host name theme
grant_access
This action can be used only with Windows stacks
list_tags
Returns a list of tags that are applied to the specified stack or layer
reboot_instance
Reboots a specified instance
register_ecs_cluster
Registers a specified Amazon ECS cluster with a stack
register_elastic_ip
Registers an Elastic IP address with a specified stack
register_instance
Registers instances that were created outside of OpsWorks Stacks with a specified stack
register_rds_db_instance
Registers an Amazon RDS instance with a stack
register_volume
Registers an Amazon EBS volume with a specified stack
set_load_based_auto_scaling
Specify the load-based auto scaling configuration for a specified layer
set_permission
Specifies a user's permissions
set_time_based_auto_scaling
Specify the time-based auto scaling configuration for a specified instance
start_instance
Starts a specified instance
start_stack
Starts a stack's instances
stop_instance
Stops a specified instance
stop_stack
Stops a specified stack
tag_resource
Apply cost-allocation tags to a specified stack or layer in OpsWorks Stacks
unassign_instance
Unassigns a registered instance from all layers that are using the instance
unassign_volume
Unassigns an assigned Amazon EBS volume
untag_resource
Removes tags from a specified stack or layer
update_app
Updates a specified app
update_elastic_ip
Updates a registered Elastic IP address's name
update_instance
Updates a specified instance
update_layer
Updates a specified layer
update_my_user_profile
Updates a user's SSH public key
update_rds_db_instance
Updates an Amazon RDS instance
update_stack
Updates a specified stack
update_user_profile
Updates a specified user profile
update_volume
Updates an Amazon EBS volume's name or mount point

Examples

## Not run: 
svc <- opsworks()
svc$assign_instance(
  Foo = 123
)

## End(Not run)