Package 'paws'

Title: Amazon Web Services Software Development Kit
Description: Interface to Amazon Web Services <https://aws.amazon.com>, including storage, database, and compute services, such as 'Simple Storage Service' ('S3'), 'DynamoDB' 'NoSQL' database, and 'Lambda' functions-as-a-service.
Authors: David Kretch [aut], Adam Banker [aut], Dyfan Jones [cre], Amazon.com, Inc. [cph]
Maintainer: Dyfan Jones <[email protected]>
License: Apache License (>= 2.0)
Version: 0.7.0
Built: 2024-10-04 09:31:31 UTC
Source: https://github.com/paws-r/paws

Help Index


Access Analyzer

Description

Identity and Access Management Access Analyzer helps you to set, verify, and refine your IAM policies by providing a suite of capabilities. Its features include findings for external and unused access, basic and custom policy checks for validating policies, and policy generation to generate fine-grained policies. To start using IAM Access Analyzer to identify external or unused access, you first need to create an analyzer.

External access analyzers help identify potential risks of accessing resources by enabling you to identify any resource policies that grant access to an external principal. It does this by using logic-based reasoning to analyze resource-based policies in your Amazon Web Services environment. An external principal can be another Amazon Web Services account, a root user, an IAM user or role, a federated user, an Amazon Web Services service, or an anonymous user. You can also use IAM Access Analyzer to preview public and cross-account access to your resources before deploying permissions changes.

Unused access analyzers help identify potential identity access risks by enabling you to identify unused IAM roles, unused access keys, unused console passwords, and IAM principals with unused service and action-level permissions.

Beyond findings, IAM Access Analyzer provides basic and custom policy checks to validate IAM policies before deploying permissions changes. You can use policy generation to refine permissions by attaching a policy generated using access activity logged in CloudTrail logs.

This guide describes the IAM Access Analyzer operations that you can call programmatically. For general information about IAM Access Analyzer, see Identity and Access Management Access Analyzer in the IAM User Guide.

Usage

accessanalyzer(
  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 <- accessanalyzer(
  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

apply_archive_rule Retroactively applies the archive rule to existing findings that meet the archive rule criteria
cancel_policy_generation Cancels the requested policy generation
check_access_not_granted Checks whether the specified access isn't allowed by a policy
check_no_new_access Checks whether new access is allowed for an updated policy when compared to the existing policy
check_no_public_access Checks whether a resource policy can grant public access to the specified resource type
create_access_preview Creates an access preview that allows you to preview IAM Access Analyzer findings for your resource before deploying resource permissions
create_analyzer Creates an analyzer for your account
create_archive_rule Creates an archive rule for the specified analyzer
delete_analyzer Deletes the specified analyzer
delete_archive_rule Deletes the specified archive rule
generate_finding_recommendation Creates a recommendation for an unused permissions finding
get_access_preview Retrieves information about an access preview for the specified analyzer
get_analyzed_resource Retrieves information about a resource that was analyzed
get_analyzer Retrieves information about the specified analyzer
get_archive_rule Retrieves information about an archive rule
get_finding Retrieves information about the specified finding
get_finding_recommendation Retrieves information about a finding recommendation for the specified analyzer
get_finding_v2 Retrieves information about the specified finding
get_generated_policy Retrieves the policy that was generated using StartPolicyGeneration
list_access_preview_findings Retrieves a list of access preview findings generated by the specified access preview
list_access_previews Retrieves a list of access previews for the specified analyzer
list_analyzed_resources Retrieves a list of resources of the specified type that have been analyzed by the specified external access analyzer
list_analyzers Retrieves a list of analyzers
list_archive_rules Retrieves a list of archive rules created for the specified analyzer
list_findings Retrieves a list of findings generated by the specified analyzer
list_findings_v2 Retrieves a list of findings generated by the specified analyzer
list_policy_generations Lists all of the policy generations requested in the last seven days
list_tags_for_resource Retrieves a list of tags applied to the specified resource
start_policy_generation Starts the policy generation request
start_resource_scan Immediately starts a scan of the policies applied to the specified resource
tag_resource Adds a tag to the specified resource
untag_resource Removes a tag from the specified resource
update_archive_rule Updates the criteria and values for the specified archive rule
update_findings Updates the status for the specified findings
validate_policy Requests the validation of a policy and returns a list of findings

Examples

## Not run: 
svc <- accessanalyzer()
svc$check_access_not_granted(
  access = list(
    list(
      actions = list(
        "s3:PutObject"
      )
    )
  ),
  policyDocument = "{"Version":"2012-10-17","Id":"123","Statement":[{"Sid":...",
  policyType = "RESOURCE_POLICY"
)

## End(Not run)

AWS Account

Description

Operations for Amazon Web Services Account Management

Usage

account(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 <- account(
  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

accept_primary_email_update Accepts the request that originated from StartPrimaryEmailUpdate to update the primary email address (also known as the root user email address) for the specified account
delete_alternate_contact Deletes the specified alternate contact from an Amazon Web Services account
disable_region Disables (opts-out) a particular Region for an account
enable_region Enables (opts-in) a particular Region for an account
get_alternate_contact Retrieves the specified alternate contact attached to an Amazon Web Services account
get_contact_information Retrieves the primary contact information of an Amazon Web Services account
get_primary_email Retrieves the primary email address for the specified account
get_region_opt_status Retrieves the opt-in status of a particular Region
list_regions Lists all the Regions for a given account and their respective opt-in statuses
put_alternate_contact Modifies the specified alternate contact attached to an Amazon Web Services account
put_contact_information Updates the primary contact information of an Amazon Web Services account
start_primary_email_update Starts the process to update the primary email address for the specified account

Examples

## Not run: 
svc <- account()
svc$accept_primary_email_update(
  Foo = 123
)

## End(Not run)

AWS Certificate Manager

Description

Certificate Manager

You can use Certificate Manager (ACM) to manage SSL/TLS certificates for your Amazon Web Services-based websites and applications. For more information about using ACM, see the Certificate Manager User Guide.

Usage

acm(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 <- acm(
  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_tags_to_certificate Adds one or more tags to an ACM certificate
delete_certificate Deletes a certificate and its associated private key
describe_certificate Returns detailed metadata about the specified ACM certificate
export_certificate Exports a private certificate issued by a private certificate authority (CA) for use anywhere
get_account_configuration Returns the account configuration options associated with an Amazon Web Services account
get_certificate Retrieves a certificate and its certificate chain
import_certificate Imports a certificate into Certificate Manager (ACM) to use with services that are integrated with ACM
list_certificates Retrieves a list of certificate ARNs and domain names
list_tags_for_certificate Lists the tags that have been applied to the ACM certificate
put_account_configuration Adds or modifies account-level configurations in ACM
remove_tags_from_certificate Remove one or more tags from an ACM certificate
renew_certificate Renews an eligible ACM certificate
request_certificate Requests an ACM certificate for use with other Amazon Web Services services
resend_validation_email Resends the email that requests domain ownership validation
update_certificate_options Updates a certificate

Examples

## Not run: 
svc <- acm()
svc$add_tags_to_certificate(
  Foo = 123
)

## End(Not run)

AWS Certificate Manager Private Certificate Authority

Description

This is the Amazon Web Services Private Certificate Authority API Reference. It provides descriptions, syntax, and usage examples for each of the actions and data types involved in creating and managing a private certificate authority (CA) for your organization.

The documentation for each action shows the API request parameters and the JSON response. Alternatively, you can use one of the Amazon Web Services SDKs to access an API that is tailored to the programming language or platform that you prefer. For more information, see Amazon Web Services SDKs.

Each Amazon Web Services Private CA API operation has a quota that determines the number of times the operation can be called per second. Amazon Web Services Private CA throttles API requests at different rates depending on the operation. Throttling means that Amazon Web Services Private CA rejects an otherwise valid request because the request exceeds the operation's quota for the number of requests per second. When a request is throttled, Amazon Web Services Private CA returns a ThrottlingException error. Amazon Web Services Private CA does not guarantee a minimum request rate for APIs.

To see an up-to-date list of your Amazon Web Services Private CA quotas, or to request a quota increase, log into your Amazon Web Services account and visit the Service Quotas console.

Usage

acmpca(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 <- acmpca(
  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

create_certificate_authority Creates a root or subordinate private certificate authority (CA)
create_certificate_authority_audit_report Creates an audit report that lists every time that your CA private key is used
create_permission Grants one or more permissions on a private CA to the Certificate Manager (ACM) service principal (acm
delete_certificate_authority Deletes a private certificate authority (CA)
delete_permission Revokes permissions on a private CA granted to the Certificate Manager (ACM) service principal (acm
delete_policy Deletes the resource-based policy attached to a private CA
describe_certificate_authority Lists information about your private certificate authority (CA) or one that has been shared with you
describe_certificate_authority_audit_report Lists information about a specific audit report created by calling the CreateCertificateAuthorityAuditReport action
get_certificate Retrieves a certificate from your private CA or one that has been shared with you
get_certificate_authority_certificate Retrieves the certificate and certificate chain for your private certificate authority (CA) or one that has been shared with you
get_certificate_authority_csr Retrieves the certificate signing request (CSR) for your private certificate authority (CA)
get_policy Retrieves the resource-based policy attached to a private CA
import_certificate_authority_certificate Imports a signed private CA certificate into Amazon Web Services Private CA
issue_certificate Uses your private certificate authority (CA), or one that has been shared with you, to issue a client certificate
list_certificate_authorities Lists the private certificate authorities that you created by using the CreateCertificateAuthority action
list_permissions List all permissions on a private CA, if any, granted to the Certificate Manager (ACM) service principal (acm
list_tags Lists the tags, if any, that are associated with your private CA or one that has been shared with you
put_policy Attaches a resource-based policy to a private CA
restore_certificate_authority Restores a certificate authority (CA) that is in the DELETED state
revoke_certificate Revokes a certificate that was issued inside Amazon Web Services Private CA
tag_certificate_authority Adds one or more tags to your private CA
untag_certificate_authority Remove one or more tags from your private CA
update_certificate_authority Updates the status or configuration of a private certificate authority (CA)

Examples

## Not run: 
svc <- acmpca()
svc$create_certificate_authority(
  Foo = 123
)

## End(Not run)

Amazon API Gateway

Description

Amazon API Gateway helps developers deliver robust, secure, and scalable mobile and web application back ends. API Gateway allows developers to securely connect mobile and web applications to APIs that run on Lambda, Amazon EC2, or other publicly addressable web services that are hosted outside of AWS.

Usage

apigateway(
  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 <- apigateway(
  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

create_api_key Create an ApiKey resource
create_authorizer Adds a new Authorizer resource to an existing RestApi resource
create_base_path_mapping Creates a new BasePathMapping resource
create_deployment Creates a Deployment resource, which makes a specified RestApi callable over the internet
create_documentation_part Creates a documentation part
create_documentation_version Creates a documentation version
create_domain_name Creates a new domain name
create_model Adds a new Model resource to an existing RestApi resource
create_request_validator Creates a RequestValidator of a given RestApi
create_resource Creates a Resource resource
create_rest_api Creates a new RestApi resource
create_stage Creates a new Stage resource that references a pre-existing Deployment for the API
create_usage_plan Creates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload
create_usage_plan_key Creates a usage plan key for adding an existing API key to a usage plan
create_vpc_link Creates a VPC link, under the caller's account in a selected region, in an asynchronous operation that typically takes 2-4 minutes to complete and become operational
delete_api_key Deletes the ApiKey resource
delete_authorizer Deletes an existing Authorizer resource
delete_base_path_mapping Deletes the BasePathMapping resource
delete_client_certificate Deletes the ClientCertificate resource
delete_deployment Deletes a Deployment resource
delete_documentation_part Deletes a documentation part
delete_documentation_version Deletes a documentation version
delete_domain_name Deletes the DomainName resource
delete_gateway_response Clears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings
delete_integration Represents a delete integration
delete_integration_response Represents a delete integration response
delete_method Deletes an existing Method resource
delete_method_response Deletes an existing MethodResponse resource
delete_model Deletes a model
delete_request_validator Deletes a RequestValidator of a given RestApi
delete_resource Deletes a Resource resource
delete_rest_api Deletes the specified API
delete_stage Deletes a Stage resource
delete_usage_plan Deletes a usage plan of a given plan Id
delete_usage_plan_key Deletes a usage plan key and remove the underlying API key from the associated usage plan
delete_vpc_link Deletes an existing VpcLink of a specified identifier
flush_stage_authorizers_cache Flushes all authorizer cache entries on a stage
flush_stage_cache Flushes a stage's cache
generate_client_certificate Generates a ClientCertificate resource
get_account Gets information about the current Account resource
get_api_key Gets information about the current ApiKey resource
get_api_keys Gets information about the current ApiKeys resource
get_authorizer Describe an existing Authorizer resource
get_authorizers Describe an existing Authorizers resource
get_base_path_mapping Describe a BasePathMapping resource
get_base_path_mappings Represents a collection of BasePathMapping resources
get_client_certificate Gets information about the current ClientCertificate resource
get_client_certificates Gets a collection of ClientCertificate resources
get_deployment Gets information about a Deployment resource
get_deployments Gets information about a Deployments collection
get_documentation_part Gets a documentation part
get_documentation_parts Gets documentation parts
get_documentation_version Gets a documentation version
get_documentation_versions Gets documentation versions
get_domain_name Represents a domain name that is contained in a simpler, more intuitive URL that can be called
get_domain_names Represents a collection of DomainName resources
get_export Exports a deployed version of a RestApi in a specified format
get_gateway_response Gets a GatewayResponse of a specified response type on the given RestApi
get_gateway_responses Gets the GatewayResponses collection on the given RestApi
get_integration Get the integration settings
get_integration_response Represents a get integration response
get_method Describe an existing Method resource
get_method_response Describes a MethodResponse resource
get_model Describes an existing model defined for a RestApi resource
get_models Describes existing Models defined for a RestApi resource
get_model_template Generates a sample mapping template that can be used to transform a payload into the structure of a model
get_request_validator Gets a RequestValidator of a given RestApi
get_request_validators Gets the RequestValidators collection of a given RestApi
get_resource Lists information about a resource
get_resources Lists information about a collection of Resource resources
get_rest_api Lists the RestApi resource in the collection
get_rest_apis Lists the RestApis resources for your collection
get_sdk Generates a client SDK for a RestApi and Stage
get_sdk_type Gets an SDK type
get_sdk_types Gets SDK types
get_stage Gets information about a Stage resource
get_stages Gets information about one or more Stage resources
get_tags Gets the Tags collection for a given resource
get_usage Gets the usage data of a usage plan in a specified time interval
get_usage_plan Gets a usage plan of a given plan identifier
get_usage_plan_key Gets a usage plan key of a given key identifier
get_usage_plan_keys Gets all the usage plan keys representing the API keys added to a specified usage plan
get_usage_plans Gets all the usage plans of the caller's account
get_vpc_link Gets a specified VPC link under the caller's account in a region
get_vpc_links Gets the VpcLinks collection under the caller's account in a selected region
import_api_keys Import API keys from an external source, such as a CSV-formatted file
import_documentation_parts Imports documentation parts
import_rest_api A feature of the API Gateway control service for creating a new API from an external API definition file
put_gateway_response Creates a customization of a GatewayResponse of a specified response type and status code on the given RestApi
put_integration Sets up a method's integration
put_integration_response Represents a put integration
put_method Add a method to an existing Resource resource
put_method_response Adds a MethodResponse to an existing Method resource
put_rest_api A feature of the API Gateway control service for updating an existing API with an input of external API definitions
tag_resource Adds or updates a tag on a given resource
test_invoke_authorizer Simulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body
test_invoke_method Simulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body
untag_resource Removes a tag from a given resource
update_account Changes information about the current Account resource
update_api_key Changes information about an ApiKey resource
update_authorizer Updates an existing Authorizer resource
update_base_path_mapping Changes information about the BasePathMapping resource
update_client_certificate Changes information about an ClientCertificate resource
update_deployment Changes information about a Deployment resource
update_documentation_part Updates a documentation part
update_documentation_version Updates a documentation version
update_domain_name Changes information about the DomainName resource
update_gateway_response Updates a GatewayResponse of a specified response type on the given RestApi
update_integration Represents an update integration
update_integration_response Represents an update integration response
update_method Updates an existing Method resource
update_method_response Updates an existing MethodResponse resource
update_model Changes information about a model
update_request_validator Updates a RequestValidator of a given RestApi
update_resource Changes information about a Resource resource
update_rest_api Changes information about the specified API
update_stage Changes information about a Stage resource
update_usage Grants a temporary extension to the remaining quota of a usage plan associated with a specified API key
update_usage_plan Updates a usage plan of a given plan Id
update_vpc_link Updates an existing VpcLink of a specified identifier

Examples

## Not run: 
svc <- apigateway()
svc$create_api_key(
  Foo = 123
)

## End(Not run)

AmazonApiGatewayManagementApi

Description

The Amazon API Gateway Management API allows you to directly manage runtime aspects of your deployed APIs. To use it, you must explicitly set the SDK's endpoint to point to the endpoint of your deployed API. The endpoint will be of the form https://{api-id}.execute-api.{region}.amazonaws.com/{stage}, or will be the endpoint corresponding to your API's custom domain and base path, if applicable.

Usage

apigatewaymanagementapi(
  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 <- apigatewaymanagementapi(
  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

delete_connection Delete the connection with the provided id
get_connection Get information about the connection with the provided id
post_to_connection Sends the provided data to the specified connection

Examples

## Not run: 
svc <- apigatewaymanagementapi()
svc$delete_connection(
  Foo = 123
)

## End(Not run)

AmazonApiGatewayV2

Description

Amazon API Gateway V2

Usage

apigatewayv2(
  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 <- apigatewayv2(
  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

create_api Creates an Api resource
create_api_mapping Creates an API mapping
create_authorizer Creates an Authorizer for an API
create_deployment Creates a Deployment for an API
create_domain_name Creates a domain name
create_integration Creates an Integration
create_integration_response Creates an IntegrationResponses
create_model Creates a Model for an API
create_route Creates a Route for an API
create_route_response Creates a RouteResponse for a Route
create_stage Creates a Stage for an API
create_vpc_link Creates a VPC link
delete_access_log_settings Deletes the AccessLogSettings for a Stage
delete_api Deletes an Api resource
delete_api_mapping Deletes an API mapping
delete_authorizer Deletes an Authorizer
delete_cors_configuration Deletes a CORS configuration
delete_deployment Deletes a Deployment
delete_domain_name Deletes a domain name
delete_integration Deletes an Integration
delete_integration_response Deletes an IntegrationResponses
delete_model Deletes a Model
delete_route Deletes a Route
delete_route_request_parameter Deletes a route request parameter
delete_route_response Deletes a RouteResponse
delete_route_settings Deletes the RouteSettings for a stage
delete_stage Deletes a Stage
delete_vpc_link Deletes a VPC link
export_api Export api
get_api Gets an Api resource
get_api_mapping Gets an API mapping
get_api_mappings Gets API mappings
get_apis Gets a collection of Api resources
get_authorizer Gets an Authorizer
get_authorizers Gets the Authorizers for an API
get_deployment Gets a Deployment
get_deployments Gets the Deployments for an API
get_domain_name Gets a domain name
get_domain_names Gets the domain names for an AWS account
get_integration Gets an Integration
get_integration_response Gets an IntegrationResponses
get_integration_responses Gets the IntegrationResponses for an Integration
get_integrations Gets the Integrations for an API
get_model Gets a Model
get_models Gets the Models for an API
get_model_template Gets a model template
get_route Gets a Route
get_route_response Gets a RouteResponse
get_route_responses Gets the RouteResponses for a Route
get_routes Gets the Routes for an API
get_stage Gets a Stage
get_stages Gets the Stages for an API
get_tags Gets a collection of Tag resources
get_vpc_link Gets a VPC link
get_vpc_links Gets a collection of VPC links
import_api Imports an API
reimport_api Puts an Api resource
reset_authorizers_cache Resets all authorizer cache entries on a stage
tag_resource Creates a new Tag resource to represent a tag
untag_resource Deletes a Tag
update_api Updates an Api resource
update_api_mapping The API mapping
update_authorizer Updates an Authorizer
update_deployment Updates a Deployment
update_domain_name Updates a domain name
update_integration Updates an Integration
update_integration_response Updates an IntegrationResponses
update_model Updates a Model
update_route Updates a Route
update_route_response Updates a RouteResponse
update_stage Updates a Stage
update_vpc_link Updates a VPC link

Examples

## Not run: 
svc <- apigatewayv2()
svc$create_api(
  Foo = 123
)

## End(Not run)

AppFabric

Description

Amazon Web Services AppFabric quickly connects software as a service (SaaS) applications across your organization. This allows IT and security teams to easily manage and secure applications using a standard schema, and employees can complete everyday tasks faster using generative artificial intelligence (AI). You can use these APIs to complete AppFabric tasks, such as setting up audit log ingestions or viewing user access. For more information about AppFabric, including the required permissions to use the service, see the Amazon Web Services AppFabric Administration Guide. For more information about using the Command Line Interface (CLI) to manage your AppFabric resources, see the AppFabric section of the CLI Reference.

Usage

appfabric(
  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 <- appfabric(
  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

batch_get_user_access_tasks Gets user access details in a batch request
connect_app_authorization Establishes a connection between Amazon Web Services AppFabric and an application, which allows AppFabric to call the APIs of the application
create_app_authorization Creates an app authorization within an app bundle, which allows AppFabric to connect to an application
create_app_bundle Creates an app bundle to collect data from an application using AppFabric
create_ingestion Creates a data ingestion for an application
create_ingestion_destination Creates an ingestion destination, which specifies how an application's ingested data is processed by Amazon Web Services AppFabric and where it's delivered
delete_app_authorization Deletes an app authorization
delete_app_bundle Deletes an app bundle
delete_ingestion Deletes an ingestion
delete_ingestion_destination Deletes an ingestion destination
get_app_authorization Returns information about an app authorization
get_app_bundle Returns information about an app bundle
get_ingestion Returns information about an ingestion
get_ingestion_destination Returns information about an ingestion destination
list_app_authorizations Returns a list of all app authorizations configured for an app bundle
list_app_bundles Returns a list of app bundles
list_ingestion_destinations Returns a list of all ingestion destinations configured for an ingestion
list_ingestions Returns a list of all ingestions configured for an app bundle
list_tags_for_resource Returns a list of tags for a resource
start_ingestion Starts (enables) an ingestion, which collects data from an application
start_user_access_tasks Starts the tasks to search user access status for a specific email address
stop_ingestion Stops (disables) an ingestion
tag_resource Assigns one or more tags (key-value pairs) to the specified resource
untag_resource Removes a tag or tags from a resource
update_app_authorization Updates an app authorization within an app bundle, which allows AppFabric to connect to an application
update_ingestion_destination Updates an ingestion destination, which specifies how an application's ingested data is processed by Amazon Web Services AppFabric and where it's delivered

Examples

## Not run: 
svc <- appfabric()
svc$batch_get_user_access_tasks(
  Foo = 123
)

## End(Not run)

Application Auto Scaling

Description

With Application Auto Scaling, you can configure automatic scaling for the following resources:

  • Amazon AppStream 2.0 fleets

  • Amazon Aurora Replicas

  • Amazon Comprehend document classification and entity recognizer endpoints

  • Amazon DynamoDB tables and global secondary indexes throughput capacity

  • Amazon ECS services

  • Amazon ElastiCache for Redis clusters (replication groups)

  • Amazon EMR clusters

  • Amazon Keyspaces (for Apache Cassandra) tables

  • Lambda function provisioned concurrency

  • Amazon Managed Streaming for Apache Kafka broker storage

  • Amazon Neptune clusters

  • Amazon SageMaker endpoint variants

  • Amazon SageMaker inference components

  • Amazon SageMaker serverless endpoint provisioned concurrency

  • Spot Fleets (Amazon EC2)

  • Pool of WorkSpaces

  • Custom resources provided by your own applications or services

To learn more about Application Auto Scaling, see the Application Auto Scaling User Guide.

API Summary

The Application Auto Scaling service API includes three key sets of actions:

  • Register and manage scalable targets - Register Amazon Web Services or custom resources as scalable targets (a resource that Application Auto Scaling can scale), set minimum and maximum capacity limits, and retrieve information on existing scalable targets.

  • Configure and manage automatic scaling - Define scaling policies to dynamically scale your resources in response to CloudWatch alarms, schedule one-time or recurring scaling actions, and retrieve your recent scaling activity history.

  • Suspend and resume scaling - Temporarily suspend and later resume automatic scaling by calling the register_scalable_target API action for any Application Auto Scaling scalable target. You can suspend and resume (individually or in combination) scale-out activities that are triggered by a scaling policy, scale-in activities that are triggered by a scaling policy, and scheduled scaling.

Usage

applicationautoscaling(
  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 <- applicationautoscaling(
  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

delete_scaling_policy Deletes the specified scaling policy for an Application Auto Scaling scalable target
delete_scheduled_action Deletes the specified scheduled action for an Application Auto Scaling scalable target
deregister_scalable_target Deregisters an Application Auto Scaling scalable target when you have finished using it
describe_scalable_targets Gets information about the scalable targets in the specified namespace
describe_scaling_activities Provides descriptive information about the scaling activities in the specified namespace from the previous six weeks
describe_scaling_policies Describes the Application Auto Scaling scaling policies for the specified service namespace
describe_scheduled_actions Describes the Application Auto Scaling scheduled actions for the specified service namespace
list_tags_for_resource Returns all the tags on the specified Application Auto Scaling scalable target
put_scaling_policy Creates or updates a scaling policy for an Application Auto Scaling scalable target
put_scheduled_action Creates or updates a scheduled action for an Application Auto Scaling scalable target
register_scalable_target Registers or updates a scalable target, which is the resource that you want to scale
tag_resource Adds or edits tags on an Application Auto Scaling scalable target
untag_resource Deletes tags from an Application Auto Scaling scalable target

Examples

## Not run: 
svc <- applicationautoscaling()
# This example deletes a scaling policy for the Amazon ECS service called
# web-app, which is running in the default cluster.
svc$delete_scaling_policy(
  PolicyName = "web-app-cpu-lt-25",
  ResourceId = "service/default/web-app",
  ScalableDimension = "ecs:service:DesiredCount",
  ServiceNamespace = "ecs"
)

## End(Not run)

AWS Application Cost Profiler

Description

This reference provides descriptions of the AWS Application Cost Profiler API.

The AWS Application Cost Profiler API provides programmatic access to view, create, update, and delete application cost report definitions, as well as to import your usage data into the Application Cost Profiler service.

For more information about using this service, see the AWS Application Cost Profiler User Guide.

Usage

applicationcostprofiler(
  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 <- applicationcostprofiler(
  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

delete_report_definition Deletes the specified report definition in AWS Application Cost Profiler
get_report_definition Retrieves the definition of a report already configured in AWS Application Cost Profiler
import_application_usage Ingests application usage data from Amazon Simple Storage Service (Amazon S3)
list_report_definitions Retrieves a list of all reports and their configurations for your AWS account
put_report_definition Creates the report definition for a report in Application Cost Profiler
update_report_definition Updates existing report in AWS Application Cost Profiler

Examples

## Not run: 
svc <- applicationcostprofiler()
svc$delete_report_definition(
  Foo = 123
)

## End(Not run)

Amazon CloudWatch Application Insights

Description

Amazon CloudWatch Application Insights is a service that helps you detect common problems with your applications. It enables you to pinpoint the source of issues in your applications (built with technologies such as Microsoft IIS, .NET, and Microsoft SQL Server), by providing key insights into detected problems.

After you onboard your application, CloudWatch Application Insights identifies, recommends, and sets up metrics and logs. It continuously analyzes and correlates your metrics and logs for unusual behavior to surface actionable problems with your application. For example, if your application is slow and unresponsive and leading to HTTP 500 errors in your Application Load Balancer (ALB), Application Insights informs you that a memory pressure problem with your SQL Server database is occurring. It bases this analysis on impactful metrics and log errors.

Usage

applicationinsights(
  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 <- applicationinsights(
  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_workload Adds a workload to a component
create_application Adds an application that is created from a resource group
create_component Creates a custom component by grouping similar standalone instances to monitor
create_log_pattern Adds an log pattern to a LogPatternSet
delete_application Removes the specified application from monitoring
delete_component Ungroups a custom component
delete_log_pattern Removes the specified log pattern from a LogPatternSet
describe_application Describes the application
describe_component Describes a component and lists the resources that are grouped together in a component
describe_component_configuration Describes the monitoring configuration of the component
describe_component_configuration_recommendation Describes the recommended monitoring configuration of the component
describe_log_pattern Describe a specific log pattern from a LogPatternSet
describe_observation Describes an anomaly or error with the application
describe_problem Describes an application problem
describe_problem_observations Describes the anomalies or errors associated with the problem
describe_workload Describes a workload and its configuration
list_applications Lists the IDs of the applications that you are monitoring
list_components Lists the auto-grouped, standalone, and custom components of the application
list_configuration_history Lists the INFO, WARN, and ERROR events for periodic configuration updates performed by Application Insights
list_log_patterns Lists the log patterns in the specific log LogPatternSet
list_log_pattern_sets Lists the log pattern sets in the specific application
list_problems Lists the problems with your application
list_tags_for_resource Retrieve a list of the tags (keys and values) that are associated with a specified application
list_workloads Lists the workloads that are configured on a given component
remove_workload Remove workload from a component
tag_resource Add one or more tags (keys and values) to a specified application
untag_resource Remove one or more tags (keys and values) from a specified application
update_application Updates the application
update_component Updates the custom component name and/or the list of resources that make up the component
update_component_configuration Updates the monitoring configurations for the component
update_log_pattern Adds a log pattern to a LogPatternSet
update_problem Updates the visibility of the problem or specifies the problem as RESOLVED
update_workload Adds a workload to a component

Examples

## Not run: 
svc <- applicationinsights()
svc$add_workload(
  Foo = 123
)

## End(Not run)

AWS App Mesh

Description

App Mesh is a service mesh based on the Envoy proxy that makes it easy to monitor and control microservices. App Mesh standardizes how your microservices communicate, giving you end-to-end visibility and helping to ensure high availability for your applications.

App Mesh gives you consistent visibility and network traffic controls for every microservice in an application. You can use App Mesh with Amazon Web Services Fargate, Amazon ECS, Amazon EKS, Kubernetes on Amazon Web Services, and Amazon EC2.

App Mesh supports microservice applications that use service discovery naming for their components. For more information about service discovery on Amazon ECS, see Service Discovery in the Amazon Elastic Container Service Developer Guide. Kubernetes kube-dns and coredns are supported. For more information, see DNS for Services and Pods in the Kubernetes documentation.

Usage

appmesh(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 <- appmesh(
  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

create_gateway_route Creates a gateway route
create_mesh Creates a service mesh
create_route Creates a route that is associated with a virtual router
create_virtual_gateway Creates a virtual gateway
create_virtual_node Creates a virtual node within a service mesh
create_virtual_router Creates a virtual router within a service mesh
create_virtual_service Creates a virtual service within a service mesh
delete_gateway_route Deletes an existing gateway route
delete_mesh Deletes an existing service mesh
delete_route Deletes an existing route
delete_virtual_gateway Deletes an existing virtual gateway
delete_virtual_node Deletes an existing virtual node
delete_virtual_router Deletes an existing virtual router
delete_virtual_service Deletes an existing virtual service
describe_gateway_route Describes an existing gateway route
describe_mesh Describes an existing service mesh
describe_route Describes an existing route
describe_virtual_gateway Describes an existing virtual gateway
describe_virtual_node Describes an existing virtual node
describe_virtual_router Describes an existing virtual router
describe_virtual_service Describes an existing virtual service
list_gateway_routes Returns a list of existing gateway routes that are associated to a virtual gateway
list_meshes Returns a list of existing service meshes
list_routes Returns a list of existing routes in a service mesh
list_tags_for_resource List the tags for an App Mesh resource
list_virtual_gateways Returns a list of existing virtual gateways in a service mesh
list_virtual_nodes Returns a list of existing virtual nodes
list_virtual_routers Returns a list of existing virtual routers in a service mesh
list_virtual_services Returns a list of existing virtual services in a service mesh
tag_resource Associates the specified tags to a resource with the specified resourceArn
untag_resource Deletes specified tags from a resource
update_gateway_route Updates an existing gateway route that is associated to a specified virtual gateway in a service mesh
update_mesh Updates an existing service mesh
update_route Updates an existing route for a specified service mesh and virtual router
update_virtual_gateway Updates an existing virtual gateway in a specified service mesh
update_virtual_node Updates an existing virtual node in a specified service mesh
update_virtual_router Updates an existing virtual router in a specified service mesh
update_virtual_service Updates an existing virtual service in a specified service mesh

Examples

## Not run: 
svc <- appmesh()
svc$create_gateway_route(
  Foo = 123
)

## End(Not run)

AWS Service Catalog App Registry

Description

Amazon Web Services Service Catalog AppRegistry enables organizations to understand the application context of their Amazon Web Services resources. AppRegistry provides a repository of your applications, their resources, and the application metadata that you use within your enterprise.

Usage

appregistry(
  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 <- appregistry(
  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

associate_attribute_group Associates an attribute group with an application to augment the application's metadata with the group's attributes
associate_resource Associates a resource with an application
create_application Creates a new application that is the top-level node in a hierarchy of related cloud resource abstractions
create_attribute_group Creates a new attribute group as a container for user-defined attributes
delete_application Deletes an application that is specified either by its application ID, name, or ARN
delete_attribute_group Deletes an attribute group, specified either by its attribute group ID, name, or ARN
disassociate_attribute_group Disassociates an attribute group from an application to remove the extra attributes contained in the attribute group from the application's metadata
disassociate_resource Disassociates a resource from application
get_application Retrieves metadata information about one of your applications
get_associated_resource Gets the resource associated with the application
get_attribute_group Retrieves an attribute group by its ARN, ID, or name
get_configuration Retrieves a TagKey configuration from an account
list_applications Retrieves a list of all of your applications
list_associated_attribute_groups Lists all attribute groups that are associated with specified application
list_associated_resources Lists all of the resources that are associated with the specified application
list_attribute_groups Lists all attribute groups which you have access to
list_attribute_groups_for_application Lists the details of all attribute groups associated with a specific application
list_tags_for_resource Lists all of the tags on the resource
put_configuration Associates a TagKey configuration to an account
sync_resource Syncs the resource with current AppRegistry records
tag_resource Assigns one or more tags (key-value pairs) to the specified resource
untag_resource Removes tags from a resource
update_application Updates an existing application with new attributes
update_attribute_group Updates an existing attribute group with new details

Examples

## Not run: 
svc <- appregistry()
svc$associate_attribute_group(
  Foo = 123
)

## End(Not run)

AWS App Runner

Description

App Runner

App Runner is an application service that provides a fast, simple, and cost-effective way to go directly from an existing container image or source code to a running service in the Amazon Web Services Cloud in seconds. You don't need to learn new technologies, decide which compute service to use, or understand how to provision and configure Amazon Web Services resources.

App Runner connects directly to your container registry or source code repository. It provides an automatic delivery pipeline with fully managed operations, high performance, scalability, and security.

For more information about App Runner, see the App Runner Developer Guide. For release information, see the App Runner Release Notes.

To install the Software Development Kits (SDKs), Integrated Development Environment (IDE) Toolkits, and command line tools that you can use to access the API, see Tools for Amazon Web Services.

Endpoints

For a list of Region-specific endpoints that App Runner supports, see App Runner endpoints and quotas in the Amazon Web Services General Reference.

Usage

apprunner(
  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 <- apprunner(
  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

associate_custom_domain Associate your own domain name with the App Runner subdomain URL of your App Runner service
create_auto_scaling_configuration Create an App Runner automatic scaling configuration resource
create_connection Create an App Runner connection resource
create_observability_configuration Create an App Runner observability configuration resource
create_service Create an App Runner service
create_vpc_connector Create an App Runner VPC connector resource
create_vpc_ingress_connection Create an App Runner VPC Ingress Connection resource
delete_auto_scaling_configuration Delete an App Runner automatic scaling configuration resource
delete_connection Delete an App Runner connection
delete_observability_configuration Delete an App Runner observability configuration resource
delete_service Delete an App Runner service
delete_vpc_connector Delete an App Runner VPC connector resource
delete_vpc_ingress_connection Delete an App Runner VPC Ingress Connection resource that's associated with an App Runner service
describe_auto_scaling_configuration Return a full description of an App Runner automatic scaling configuration resource
describe_custom_domains Return a description of custom domain names that are associated with an App Runner service
describe_observability_configuration Return a full description of an App Runner observability configuration resource
describe_service Return a full description of an App Runner service
describe_vpc_connector Return a description of an App Runner VPC connector resource
describe_vpc_ingress_connection Return a full description of an App Runner VPC Ingress Connection resource
disassociate_custom_domain Disassociate a custom domain name from an App Runner service
list_auto_scaling_configurations Returns a list of active App Runner automatic scaling configurations in your Amazon Web Services account
list_connections Returns a list of App Runner connections that are associated with your Amazon Web Services account
list_observability_configurations Returns a list of active App Runner observability configurations in your Amazon Web Services account
list_operations Return a list of operations that occurred on an App Runner service
list_services Returns a list of running App Runner services in your Amazon Web Services account
list_services_for_auto_scaling_configuration Returns a list of the associated App Runner services using an auto scaling configuration
list_tags_for_resource List tags that are associated with for an App Runner resource
list_vpc_connectors Returns a list of App Runner VPC connectors in your Amazon Web Services account
list_vpc_ingress_connections Return a list of App Runner VPC Ingress Connections in your Amazon Web Services account
pause_service Pause an active App Runner service
resume_service Resume an active App Runner service
start_deployment Initiate a manual deployment of the latest commit in a source code repository or the latest image in a source image repository to an App Runner service
tag_resource Add tags to, or update the tag values of, an App Runner resource
untag_resource Remove tags from an App Runner resource
update_default_auto_scaling_configuration Update an auto scaling configuration to be the default
update_service Update an App Runner service
update_vpc_ingress_connection Update an existing App Runner VPC Ingress Connection resource

Examples

## Not run: 
svc <- apprunner()
svc$associate_custom_domain(
  Foo = 123
)

## End(Not run)

Amazon AppStream

Description

Amazon AppStream 2.0

This is the Amazon AppStream 2.0 API Reference. This documentation provides descriptions and syntax for each of the actions and data types in AppStream 2.0. AppStream 2.0 is a fully managed, secure application streaming service that lets you stream desktop applications to users without rewriting applications. AppStream 2.0 manages the AWS resources that are required to host and run your applications, scales automatically, and provides access to your users on demand.

You can call the AppStream 2.0 API operations by using an interface VPC endpoint (interface endpoint). For more information, see Access AppStream 2.0 API Operations and CLI Commands Through an Interface VPC Endpoint in the Amazon AppStream 2.0 Administration Guide.

To learn more about AppStream 2.0, see the following resources:

Usage

appstream(
  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 <- appstream(
  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

associate_app_block_builder_app_block Associates the specified app block builder with the specified app block
associate_application_fleet Associates the specified application with the specified fleet
associate_application_to_entitlement Associates an application to entitle
associate_fleet Associates the specified fleet with the specified stack
batch_associate_user_stack Associates the specified users with the specified stacks
batch_disassociate_user_stack Disassociates the specified users from the specified stacks
copy_image Copies the image within the same region or to a new region within the same AWS account
create_app_block Creates an app block
create_app_block_builder Creates an app block builder
create_app_block_builder_streaming_url Creates a URL to start a create app block builder streaming session
create_application Creates an application
create_directory_config Creates a Directory Config object in AppStream 2
create_entitlement Creates a new entitlement
create_fleet Creates a fleet
create_image_builder Creates an image builder
create_image_builder_streaming_url Creates a URL to start an image builder streaming session
create_stack Creates a stack to start streaming applications to users
create_streaming_url Creates a temporary URL to start an AppStream 2
create_theme_for_stack Creates custom branding that customizes the appearance of the streaming application catalog page
create_updated_image Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2
create_usage_report_subscription Creates a usage report subscription
create_user Creates a new user in the user pool
delete_app_block Deletes an app block
delete_app_block_builder Deletes an app block builder
delete_application Deletes an application
delete_directory_config Deletes the specified Directory Config object from AppStream 2
delete_entitlement Deletes the specified entitlement
delete_fleet Deletes the specified fleet
delete_image Deletes the specified image
delete_image_builder Deletes the specified image builder and releases the capacity
delete_image_permissions Deletes permissions for the specified private image
delete_stack Deletes the specified stack
delete_theme_for_stack Deletes custom branding that customizes the appearance of the streaming application catalog page
delete_usage_report_subscription Disables usage report generation
delete_user Deletes a user from the user pool
describe_app_block_builder_app_block_associations Retrieves a list that describes one or more app block builder associations
describe_app_block_builders Retrieves a list that describes one or more app block builders
describe_app_blocks Retrieves a list that describes one or more app blocks
describe_application_fleet_associations Retrieves a list that describes one or more application fleet associations
describe_applications Retrieves a list that describes one or more applications
describe_directory_configs Retrieves a list that describes one or more specified Directory Config objects for AppStream 2
describe_entitlements Retrieves a list that describes one of more entitlements
describe_fleets Retrieves a list that describes one or more specified fleets, if the fleet names are provided
describe_image_builders Retrieves a list that describes one or more specified image builders, if the image builder names are provided
describe_image_permissions Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own
describe_images Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided
describe_sessions Retrieves a list that describes the streaming sessions for a specified stack and fleet
describe_stacks Retrieves a list that describes one or more specified stacks, if the stack names are provided
describe_theme_for_stack Retrieves a list that describes the theme for a specified stack
describe_usage_report_subscriptions Retrieves a list that describes one or more usage report subscriptions
describe_users Retrieves a list that describes one or more specified users in the user pool
describe_user_stack_associations Retrieves a list that describes the UserStackAssociation objects
disable_user Disables the specified user in the user pool
disassociate_app_block_builder_app_block Disassociates a specified app block builder from a specified app block
disassociate_application_fleet Disassociates the specified application from the fleet
disassociate_application_from_entitlement Deletes the specified application from the specified entitlement
disassociate_fleet Disassociates the specified fleet from the specified stack
enable_user Enables a user in the user pool
expire_session Immediately stops the specified streaming session
list_associated_fleets Retrieves the name of the fleet that is associated with the specified stack
list_associated_stacks Retrieves the name of the stack with which the specified fleet is associated
list_entitled_applications Retrieves a list of entitled applications
list_tags_for_resource Retrieves a list of all tags for the specified AppStream 2
start_app_block_builder Starts an app block builder
start_fleet Starts the specified fleet
start_image_builder Starts the specified image builder
stop_app_block_builder Stops an app block builder
stop_fleet Stops the specified fleet
stop_image_builder Stops the specified image builder
tag_resource Adds or overwrites one or more tags for the specified AppStream 2
untag_resource Disassociates one or more specified tags from the specified AppStream 2
update_app_block_builder Updates an app block builder
update_application Updates the specified application
update_directory_config Updates the specified Directory Config object in AppStream 2
update_entitlement Updates the specified entitlement
update_fleet Updates the specified fleet
update_image_permissions Adds or updates permissions for the specified private image
update_stack Updates the specified fields for the specified stack
update_theme_for_stack Updates custom branding that customizes the appearance of the streaming application catalog page

Examples

## Not run: 
svc <- appstream()
svc$associate_app_block_builder_app_block(
  Foo = 123
)

## End(Not run)

AWS ARC - Zonal Shift

Description

Welcome to the API Reference Guide for zonal shift and zonal autoshift in Amazon Route 53 Application Recovery Controller (Route 53 ARC).

You can start a zonal shift to move traffic for a load balancer resource away from an Availability Zone to help your application recover quickly from an impairment in an Availability Zone. For example, you can recover your application from a developer's bad code deployment or from an Amazon Web Services infrastructure failure in a single Availability Zone.

You can also configure zonal autoshift for supported load balancer resources. Zonal autoshift is a capability in Route 53 ARC where you authorize Amazon Web Services to shift away application resource traffic from an Availability Zone during events, on your behalf, to help reduce your time to recovery. Amazon Web Services starts an autoshift when internal telemetry indicates that there is an Availability Zone impairment that could potentially impact customers.

To help make sure that zonal autoshift is safe for your application, you must also configure practice runs when you enable zonal autoshift for a resource. Practice runs start weekly zonal shifts for a resource, to shift traffic for the resource away from an Availability Zone. Practice runs help you to make sure, on a regular basis, that you have enough capacity in all the Availability Zones in an Amazon Web Services Region for your application to continue to operate normally when traffic for a resource is shifted away from one Availability Zone.

Before you configure practice runs or enable zonal autoshift, we strongly recommend that you prescale your application resource capacity in all Availability Zones in the Region where your application resources are deployed. You should not rely on scaling on demand when an autoshift or practice run starts. Zonal autoshift, including practice runs, works independently, and does not wait for auto scaling actions to complete. Relying on auto scaling, instead of pre-scaling, can result in loss of availability.

If you use auto scaling to handle regular cycles of traffic, we strongly recommend that you configure the minimum capacity of your auto scaling to continue operating normally with the loss of an Availability Zone.

Be aware that Route 53 ARC does not inspect the health of individual resources. Amazon Web Services only starts an autoshift when Amazon Web Services telemetry detects that there is an Availability Zone impairment that could potentially impact customers. In some cases, resources might be shifted away that are not experiencing impact.

For more information about using zonal shift and zonal autoshift, see the Amazon Route 53 Application Recovery Controller Developer Guide.

Usage

arczonalshift(
  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 <- arczonalshift(
  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

cancel_zonal_shift Cancel a zonal shift in Amazon Route 53 Application Recovery Controller
create_practice_run_configuration A practice run configuration for zonal autoshift is required when you enable zonal autoshift
delete_practice_run_configuration Deletes the practice run configuration for a resource
get_autoshift_observer_notification_status Returns the status of autoshift observer notification
get_managed_resource Get information about a resource that's been registered for zonal shifts with Amazon Route 53 Application Recovery Controller in this Amazon Web Services Region
list_autoshifts Returns a list of autoshifts for an Amazon Web Services Region
list_managed_resources Lists all the resources in your Amazon Web Services account in this Amazon Web Services Region that are managed for zonal shifts in Amazon Route 53 Application Recovery Controller, and information about them
list_zonal_shifts Lists all active and completed zonal shifts in Amazon Route 53 Application Recovery Controller in your Amazon Web Services account in this Amazon Web Services Region
start_zonal_shift You start a zonal shift to temporarily move load balancer traffic away from an Availability Zone in an Amazon Web Services Region, to help your application recover immediately, for example, from a developer's bad code deployment or from an Amazon Web Services infrastructure failure in a single Availability Zone
update_autoshift_observer_notification_status Update the status of autoshift observer notification
update_practice_run_configuration Update a practice run configuration to change one or more of the following: add, change, or remove the blocking alarm; change the outcome alarm; or add, change, or remove blocking dates or time windows
update_zonal_autoshift_configuration The zonal autoshift configuration for a resource includes the practice run configuration and the status for running autoshifts, zonal autoshift status
update_zonal_shift Update an active zonal shift in Amazon Route 53 Application Recovery Controller in your Amazon Web Services account

Examples

## Not run: 
svc <- arczonalshift()
svc$cancel_zonal_shift(
  Foo = 123
)

## End(Not run)

Amazon Athena

Description

Amazon Athena is an interactive query service that lets you use standard SQL to analyze data directly in Amazon S3. You can point Athena at your data in Amazon S3 and run ad-hoc queries and get results in seconds. Athena is serverless, so there is no infrastructure to set up or manage. You pay only for the queries you run. Athena scales automatically—executing queries in parallel—so results are fast, even with large datasets and complex queries. For more information, see What is Amazon Athena in the Amazon Athena User Guide.

If you connect to Athena using the JDBC driver, use version 1.1.0 of the driver or later with the Amazon Athena API. Earlier version drivers do not support the API. For more information and to download the driver, see Accessing Amazon Athena with JDBC.

Usage

athena(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 <- athena(
  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

batch_get_named_query Returns the details of a single named query or a list of up to 50 queries, which you provide as an array of query ID strings
batch_get_prepared_statement Returns the details of a single prepared statement or a list of up to 256 prepared statements for the array of prepared statement names that you provide
batch_get_query_execution Returns the details of a single query execution or a list of up to 50 query executions, which you provide as an array of query execution ID strings
cancel_capacity_reservation Cancels the capacity reservation with the specified name
create_capacity_reservation Creates a capacity reservation with the specified name and number of requested data processing units
create_data_catalog Creates (registers) a data catalog with the specified name and properties
create_named_query Creates a named query in the specified workgroup
create_notebook Creates an empty ipynb file in the specified Apache Spark enabled workgroup
create_prepared_statement Creates a prepared statement for use with SQL queries in Athena
create_presigned_notebook_url Gets an authentication token and the URL at which the notebook can be accessed
create_work_group Creates a workgroup with the specified name
delete_capacity_reservation Deletes a cancelled capacity reservation
delete_data_catalog Deletes a data catalog
delete_named_query Deletes the named query if you have access to the workgroup in which the query was saved
delete_notebook Deletes the specified notebook
delete_prepared_statement Deletes the prepared statement with the specified name from the specified workgroup
delete_work_group Deletes the workgroup with the specified name
export_notebook Exports the specified notebook and its metadata
get_calculation_execution Describes a previously submitted calculation execution
get_calculation_execution_code Retrieves the unencrypted code that was executed for the calculation
get_calculation_execution_status Gets the status of a current calculation
get_capacity_assignment_configuration Gets the capacity assignment configuration for a capacity reservation, if one exists
get_capacity_reservation Returns information about the capacity reservation with the specified name
get_database Returns a database object for the specified database and data catalog
get_data_catalog Returns the specified data catalog
get_named_query Returns information about a single query
get_notebook_metadata Retrieves notebook metadata for the specified notebook ID
get_prepared_statement Retrieves the prepared statement with the specified name from the specified workgroup
get_query_execution Returns information about a single execution of a query if you have access to the workgroup in which the query ran
get_query_results Streams the results of a single query execution specified by QueryExecutionId from the Athena query results location in Amazon S3
get_query_runtime_statistics Returns query execution runtime statistics related to a single execution of a query if you have access to the workgroup in which the query ran
get_session Gets the full details of a previously created session, including the session status and configuration
get_session_status Gets the current status of a session
get_table_metadata Returns table metadata for the specified catalog, database, and table
get_work_group Returns information about the workgroup with the specified name
import_notebook Imports a single ipynb file to a Spark enabled workgroup
list_application_dpu_sizes Returns the supported DPU sizes for the supported application runtimes (for example, Athena notebook version 1)
list_calculation_executions Lists the calculations that have been submitted to a session in descending order
list_capacity_reservations Lists the capacity reservations for the current account
list_databases Lists the databases in the specified data catalog
list_data_catalogs Lists the data catalogs in the current Amazon Web Services account
list_engine_versions Returns a list of engine versions that are available to choose from, including the Auto option
list_executors Lists, in descending order, the executors that joined a session
list_named_queries Provides a list of available query IDs only for queries saved in the specified workgroup
list_notebook_metadata Displays the notebook files for the specified workgroup in paginated format
list_notebook_sessions Lists, in descending order, the sessions that have been created in a notebook that are in an active state like CREATING, CREATED, IDLE or BUSY
list_prepared_statements Lists the prepared statements in the specified workgroup
list_query_executions Provides a list of available query execution IDs for the queries in the specified workgroup
list_sessions Lists the sessions in a workgroup that are in an active state like CREATING, CREATED, IDLE, or BUSY
list_table_metadata Lists the metadata for the tables in the specified data catalog database
list_tags_for_resource Lists the tags associated with an Athena resource
list_work_groups Lists available workgroups for the account
put_capacity_assignment_configuration Puts a new capacity assignment configuration for a specified capacity reservation
start_calculation_execution Submits calculations for execution within a session
start_query_execution Runs the SQL query statements contained in the Query
start_session Creates a session for running calculations within a workgroup
stop_calculation_execution Requests the cancellation of a calculation
stop_query_execution Stops a query execution
tag_resource Adds one or more tags to an Athena resource
terminate_session Terminates an active session
untag_resource Removes one or more tags from an Athena resource
update_capacity_reservation Updates the number of requested data processing units for the capacity reservation with the specified name
update_data_catalog Updates the data catalog that has the specified name
update_named_query Updates a NamedQuery object
update_notebook Updates the contents of a Spark notebook
update_notebook_metadata Updates the metadata for a notebook
update_prepared_statement Updates a prepared statement
update_work_group Updates the workgroup with the specified name

Examples

## Not run: 
svc <- athena()
svc$batch_get_named_query(
  Foo = 123
)

## End(Not run)

AWS Audit Manager

Description

Welcome to the Audit Manager API reference. This guide is for developers who need detailed information about the Audit Manager API operations, data types, and errors.

Audit Manager is a service that provides automated evidence collection so that you can continually audit your Amazon Web Services usage. You can use it to assess the effectiveness of your controls, manage risk, and simplify compliance.

Audit Manager provides prebuilt frameworks that structure and automate assessments for a given compliance standard. Frameworks include a prebuilt collection of controls with descriptions and testing procedures. These controls are grouped according to the requirements of the specified compliance standard or regulation. You can also customize frameworks and controls to support internal audits with specific requirements.

Use the following links to get started with the Audit Manager API:

  • Actions: An alphabetical list of all Audit Manager API operations.

  • Data types: An alphabetical list of all Audit Manager data types.

  • Common parameters: Parameters that all operations can use.

  • Common errors: Client and server errors that all operations can return.

If you're new to Audit Manager, we recommend that you review the Audit Manager User Guide.

Usage

auditmanager(
  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 <- auditmanager(
  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

associate_assessment_report_evidence_folder Associates an evidence folder to an assessment report in an Audit Manager assessment
batch_associate_assessment_report_evidence Associates a list of evidence to an assessment report in an Audit Manager assessment
batch_create_delegation_by_assessment Creates a batch of delegations for an assessment in Audit Manager
batch_delete_delegation_by_assessment Deletes a batch of delegations for an assessment in Audit Manager
batch_disassociate_assessment_report_evidence Disassociates a list of evidence from an assessment report in Audit Manager
batch_import_evidence_to_assessment_control Adds one or more pieces of evidence to a control in an Audit Manager assessment
create_assessment Creates an assessment in Audit Manager
create_assessment_framework Creates a custom framework in Audit Manager
create_assessment_report Creates an assessment report for the specified assessment
create_control Creates a new custom control in Audit Manager
delete_assessment Deletes an assessment in Audit Manager
delete_assessment_framework Deletes a custom framework in Audit Manager
delete_assessment_framework_share Deletes a share request for a custom framework in Audit Manager
delete_assessment_report Deletes an assessment report in Audit Manager
delete_control Deletes a custom control in Audit Manager
deregister_account Deregisters an account in Audit Manager
deregister_organization_admin_account Removes the specified Amazon Web Services account as a delegated administrator for Audit Manager
disassociate_assessment_report_evidence_folder Disassociates an evidence folder from the specified assessment report in Audit Manager
get_account_status Gets the registration status of an account in Audit Manager
get_assessment Gets information about a specified assessment
get_assessment_framework Gets information about a specified framework
get_assessment_report_url Gets the URL of an assessment report in Audit Manager
get_change_logs Gets a list of changelogs from Audit Manager
get_control Gets information about a specified control
get_delegations Gets a list of delegations from an audit owner to a delegate
get_evidence Gets information about a specified evidence item
get_evidence_by_evidence_folder Gets all evidence from a specified evidence folder in Audit Manager
get_evidence_file_upload_url Creates a presigned Amazon S3 URL that can be used to upload a file as manual evidence
get_evidence_folder Gets an evidence folder from a specified assessment in Audit Manager
get_evidence_folders_by_assessment Gets the evidence folders from a specified assessment in Audit Manager
get_evidence_folders_by_assessment_control Gets a list of evidence folders that are associated with a specified control in an Audit Manager assessment
get_insights Gets the latest analytics data for all your current active assessments
get_insights_by_assessment Gets the latest analytics data for a specific active assessment
get_organization_admin_account Gets the name of the delegated Amazon Web Services administrator account for a specified organization
get_services_in_scope Gets a list of the Amazon Web Services from which Audit Manager can collect evidence
get_settings Gets the settings for a specified Amazon Web Services account
list_assessment_control_insights_by_control_domain Lists the latest analytics data for controls within a specific control domain and a specific active assessment
list_assessment_frameworks Returns a list of the frameworks that are available in the Audit Manager framework library
list_assessment_framework_share_requests Returns a list of sent or received share requests for custom frameworks in Audit Manager
list_assessment_reports Returns a list of assessment reports created in Audit Manager
list_assessments Returns a list of current and past assessments from Audit Manager
list_control_domain_insights Lists the latest analytics data for control domains across all of your active assessments
list_control_domain_insights_by_assessment Lists analytics data for control domains within a specified active assessment
list_control_insights_by_control_domain Lists the latest analytics data for controls within a specific control domain across all active assessments
list_controls Returns a list of controls from Audit Manager
list_keywords_for_data_source Returns a list of keywords that are pre-mapped to the specified control data source
list_notifications Returns a list of all Audit Manager notifications
list_tags_for_resource Returns a list of tags for the specified resource in Audit Manager
register_account Enables Audit Manager for the specified Amazon Web Services account
register_organization_admin_account Enables an Amazon Web Services account within the organization as the delegated administrator for Audit Manager
start_assessment_framework_share Creates a share request for a custom framework in Audit Manager
tag_resource Tags the specified resource in Audit Manager
untag_resource Removes a tag from a resource in Audit Manager
update_assessment Edits an Audit Manager assessment
update_assessment_control Updates a control within an assessment in Audit Manager
update_assessment_control_set_status Updates the status of a control set in an Audit Manager assessment
update_assessment_framework Updates a custom framework in Audit Manager
update_assessment_framework_share Updates a share request for a custom framework in Audit Manager
update_assessment_status Updates the status of an assessment in Audit Manager
update_control Updates a custom control in Audit Manager
update_settings Updates Audit Manager settings for the current account
validate_assessment_report_integrity Validates the integrity of an assessment report in Audit Manager

Examples

## Not run: 
svc <- auditmanager()
svc$associate_assessment_report_evidence_folder(
  Foo = 123
)

## End(Not run)

Amazon Augmented AI Runtime

Description

Amazon Augmented AI (Amazon A2I) adds the benefit of human judgment to any machine learning application. When an AI application can't evaluate data with a high degree of confidence, human reviewers can take over. This human review is called a human review workflow. To create and start a human review workflow, you need three resources: a worker task template, a flow definition, and a human loop.

For information about these resources and prerequisites for using Amazon A2I, see Get Started with Amazon Augmented AI in the Amazon SageMaker Developer Guide.

This API reference includes information about API actions and data types that you can use to interact with Amazon A2I programmatically. Use this guide to:

  • Start a human loop with the start_human_loop operation when using Amazon A2I with a custom task type. To learn more about the difference between custom and built-in task types, see Use Task Types . To learn how to start a human loop using this API, see Create and Start a Human Loop for a Custom Task Type in the Amazon SageMaker Developer Guide.

  • Manage your human loops. You can list all human loops that you have created, describe individual human loops, and stop and delete human loops. To learn more, see Monitor and Manage Your Human Loop in the Amazon SageMaker Developer Guide.

Amazon A2I integrates APIs from various AWS services to create and start human review workflows for those services. To learn how Amazon A2I uses these APIs, see Use APIs in Amazon A2I in the Amazon SageMaker Developer Guide.

Usage

augmentedairuntime(
  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 <- augmentedairuntime(
  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

delete_human_loop Deletes the specified human loop for a flow definition
describe_human_loop Returns information about the specified human loop
list_human_loops Returns information about human loops, given the specified parameters
start_human_loop Starts a human loop, provided that at least one activation condition is met
stop_human_loop Stops the specified human loop

Examples

## Not run: 
svc <- augmentedairuntime()
svc$delete_human_loop(
  Foo = 123
)

## End(Not run)

Auto Scaling

Description

Amazon EC2 Auto Scaling

Amazon EC2 Auto Scaling is designed to automatically launch and terminate EC2 instances based on user-defined scaling policies, scheduled actions, and health checks.

For more information, see the Amazon EC2 Auto Scaling User Guide and the Amazon EC2 Auto Scaling API Reference.

Usage

autoscaling(
  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 <- autoscaling(
  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

attach_instances Attaches one or more EC2 instances to the specified Auto Scaling group
attach_load_balancers This API operation is superseded by AttachTrafficSources, which can attach multiple traffic sources types
attach_load_balancer_target_groups This API operation is superseded by AttachTrafficSources, which can attach multiple traffic sources types
attach_traffic_sources Attaches one or more traffic sources to the specified Auto Scaling group
batch_delete_scheduled_action Deletes one or more scheduled actions for the specified Auto Scaling group
batch_put_scheduled_update_group_action Creates or updates one or more scheduled scaling actions for an Auto Scaling group
cancel_instance_refresh Cancels an instance refresh or rollback that is in progress
complete_lifecycle_action Completes the lifecycle action for the specified token or instance with the specified result
create_auto_scaling_group We strongly recommend using a launch template when calling this operation to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2
create_launch_configuration Creates a launch configuration
create_or_update_tags Creates or updates tags for the specified Auto Scaling group
delete_auto_scaling_group Deletes the specified Auto Scaling group
delete_launch_configuration Deletes the specified launch configuration
delete_lifecycle_hook Deletes the specified lifecycle hook
delete_notification_configuration Deletes the specified notification
delete_policy Deletes the specified scaling policy
delete_scheduled_action Deletes the specified scheduled action
delete_tags Deletes the specified tags
delete_warm_pool Deletes the warm pool for the specified Auto Scaling group
describe_account_limits Describes the current Amazon EC2 Auto Scaling resource quotas for your account
describe_adjustment_types Describes the available adjustment types for step scaling and simple scaling policies
describe_auto_scaling_groups Gets information about the Auto Scaling groups in the account and Region
describe_auto_scaling_instances Gets information about the Auto Scaling instances in the account and Region
describe_auto_scaling_notification_types Describes the notification types that are supported by Amazon EC2 Auto Scaling
describe_instance_refreshes Gets information about the instance refreshes for the specified Auto Scaling group from the previous six weeks
describe_launch_configurations Gets information about the launch configurations in the account and Region
describe_lifecycle_hooks Gets information about the lifecycle hooks for the specified Auto Scaling group
describe_lifecycle_hook_types Describes the available types of lifecycle hooks
describe_load_balancers This API operation is superseded by DescribeTrafficSources, which can describe multiple traffic sources types
describe_load_balancer_target_groups This API operation is superseded by DescribeTrafficSources, which can describe multiple traffic sources types
describe_metric_collection_types Describes the available CloudWatch metrics for Amazon EC2 Auto Scaling
describe_notification_configurations Gets information about the Amazon SNS notifications that are configured for one or more Auto Scaling groups
describe_policies Gets information about the scaling policies in the account and Region
describe_scaling_activities Gets information about the scaling activities in the account and Region
describe_scaling_process_types Describes the scaling process types for use with the ResumeProcesses and SuspendProcesses APIs
describe_scheduled_actions Gets information about the scheduled actions that haven't run or that have not reached their end time
describe_tags Describes the specified tags
describe_termination_policy_types Describes the termination policies supported by Amazon EC2 Auto Scaling
describe_traffic_sources Gets information about the traffic sources for the specified Auto Scaling group
describe_warm_pool Gets information about a warm pool and its instances
detach_instances Removes one or more instances from the specified Auto Scaling group
detach_load_balancers This API operation is superseded by DetachTrafficSources, which can detach multiple traffic sources types
detach_load_balancer_target_groups This API operation is superseded by DetachTrafficSources, which can detach multiple traffic sources types
detach_traffic_sources Detaches one or more traffic sources from the specified Auto Scaling group
disable_metrics_collection Disables group metrics collection for the specified Auto Scaling group
enable_metrics_collection Enables group metrics collection for the specified Auto Scaling group
enter_standby Moves the specified instances into the standby state
execute_policy Executes the specified policy
exit_standby Moves the specified instances out of the standby state
get_predictive_scaling_forecast Retrieves the forecast data for a predictive scaling policy
put_lifecycle_hook Creates or updates a lifecycle hook for the specified Auto Scaling group
put_notification_configuration Configures an Auto Scaling group to send notifications when specified events take place
put_scaling_policy Creates or updates a scaling policy for an Auto Scaling group
put_scheduled_update_group_action Creates or updates a scheduled scaling action for an Auto Scaling group
put_warm_pool Creates or updates a warm pool for the specified Auto Scaling group
record_lifecycle_action_heartbeat Records a heartbeat for the lifecycle action associated with the specified token or instance
resume_processes Resumes the specified suspended auto scaling processes, or all suspended process, for the specified Auto Scaling group
rollback_instance_refresh Cancels an instance refresh that is in progress and rolls back any changes that it made
set_desired_capacity Sets the size of the specified Auto Scaling group
set_instance_health Sets the health status of the specified instance
set_instance_protection Updates the instance protection settings of the specified instances
start_instance_refresh Starts an instance refresh
suspend_processes Suspends the specified auto scaling processes, or all processes, for the specified Auto Scaling group
terminate_instance_in_auto_scaling_group Terminates the specified instance and optionally adjusts the desired group size
update_auto_scaling_group We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2

Examples

## Not run: 
svc <- autoscaling()
# This example attaches the specified instance to the specified Auto
# Scaling group.
svc$attach_instances(
  AutoScalingGroupName = "my-auto-scaling-group",
  InstanceIds = list(
    "i-93633f9b"
  )
)

## End(Not run)

AWS Auto Scaling Plans

Description

AWS Auto Scaling

Use AWS Auto Scaling to create scaling plans for your applications to automatically scale your scalable AWS resources.

API Summary

You can use the AWS Auto Scaling service API to accomplish the following tasks:

  • Create and manage scaling plans

  • Define target tracking scaling policies to dynamically scale your resources based on utilization

  • Scale Amazon EC2 Auto Scaling groups using predictive scaling and dynamic scaling to scale your Amazon EC2 capacity faster

  • Set minimum and maximum capacity limits

  • Retrieve information on existing scaling plans

  • Access current forecast data and historical forecast data for up to 56 days previous

To learn more about AWS Auto Scaling, including information about granting IAM users required permissions for AWS Auto Scaling actions, see the AWS Auto Scaling User Guide.

Usage

autoscalingplans(
  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 <- autoscalingplans(
  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

create_scaling_plan Creates a scaling plan
delete_scaling_plan Deletes the specified scaling plan
describe_scaling_plan_resources Describes the scalable resources in the specified scaling plan
describe_scaling_plans Describes one or more of your scaling plans
get_scaling_plan_resource_forecast_data Retrieves the forecast data for a scalable resource
update_scaling_plan Updates the specified scaling plan

Examples

## Not run: 
svc <- autoscalingplans()
svc$create_scaling_plan(
  Foo = 123
)

## End(Not run)

AWS Backup

Description

Backup

Backup is a unified backup service designed to protect Amazon Web Services services and their associated data. Backup simplifies the creation, migration, restoration, and deletion of backups, while also providing reporting and auditing.

Usage

backup(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 <- backup(
  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

cancel_legal_hold Removes the specified legal hold on a recovery point
create_backup_plan Creates a backup plan using a backup plan name and backup rules
create_backup_selection Creates a JSON document that specifies a set of resources to assign to a backup plan
create_backup_vault Creates a logical container where backups are stored
create_framework Creates a framework with one or more controls
create_legal_hold Creates a legal hold on a recovery point (backup)
create_logically_air_gapped_backup_vault Creates a logical container to where backups may be copied
create_report_plan Creates a report plan
create_restore_testing_plan Creates a restore testing plan
create_restore_testing_selection This request can be sent after CreateRestoreTestingPlan request returns successfully
delete_backup_plan Deletes a backup plan
delete_backup_selection Deletes the resource selection associated with a backup plan that is specified by the SelectionId
delete_backup_vault Deletes the backup vault identified by its name
delete_backup_vault_access_policy Deletes the policy document that manages permissions on a backup vault
delete_backup_vault_lock_configuration Deletes Backup Vault Lock from a backup vault specified by a backup vault name
delete_backup_vault_notifications Deletes event notifications for the specified backup vault
delete_framework Deletes the framework specified by a framework name
delete_recovery_point Deletes the recovery point specified by a recovery point ID
delete_report_plan Deletes the report plan specified by a report plan name
delete_restore_testing_plan This request deletes the specified restore testing plan
delete_restore_testing_selection Input the Restore Testing Plan name and Restore Testing Selection name
describe_backup_job Returns backup job details for the specified BackupJobId
describe_backup_vault Returns metadata about a backup vault specified by its name
describe_copy_job Returns metadata associated with creating a copy of a resource
describe_framework Returns the framework details for the specified FrameworkName
describe_global_settings Describes whether the Amazon Web Services account is opted in to cross-account backup
describe_protected_resource Returns information about a saved resource, including the last time it was backed up, its Amazon Resource Name (ARN), and the Amazon Web Services service type of the saved resource
describe_recovery_point Returns metadata associated with a recovery point, including ID, status, encryption, and lifecycle
describe_region_settings Returns the current service opt-in settings for the Region
describe_report_job Returns the details associated with creating a report as specified by its ReportJobId
describe_report_plan Returns a list of all report plans for an Amazon Web Services account and Amazon Web Services Region
describe_restore_job Returns metadata associated with a restore job that is specified by a job ID
disassociate_recovery_point Deletes the specified continuous backup recovery point from Backup and releases control of that continuous backup to the source service, such as Amazon RDS
disassociate_recovery_point_from_parent This action to a specific child (nested) recovery point removes the relationship between the specified recovery point and its parent (composite) recovery point
export_backup_plan_template Returns the backup plan that is specified by the plan ID as a backup template
get_backup_plan Returns BackupPlan details for the specified BackupPlanId
get_backup_plan_from_json Returns a valid JSON document specifying a backup plan or an error
get_backup_plan_from_template Returns the template specified by its templateId as a backup plan
get_backup_selection Returns selection metadata and a document in JSON format that specifies a list of resources that are associated with a backup plan
get_backup_vault_access_policy Returns the access policy document that is associated with the named backup vault
get_backup_vault_notifications Returns event notifications for the specified backup vault
get_legal_hold This action returns details for a specified legal hold
get_recovery_point_restore_metadata Returns a set of metadata key-value pairs that were used to create the backup
get_restore_job_metadata This request returns the metadata for the specified restore job
get_restore_testing_inferred_metadata This request returns the minimal required set of metadata needed to start a restore job with secure default settings
get_restore_testing_plan Returns RestoreTestingPlan details for the specified RestoreTestingPlanName
get_restore_testing_selection Returns RestoreTestingSelection, which displays resources and elements of the restore testing plan
get_supported_resource_types Returns the Amazon Web Services resource types supported by Backup
list_backup_jobs Returns a list of existing backup jobs for an authenticated account for the last 30 days
list_backup_job_summaries This is a request for a summary of backup jobs created or running within the most recent 30 days
list_backup_plans Lists the active backup plans for the account
list_backup_plan_templates Lists the backup plan templates
list_backup_plan_versions Returns version metadata of your backup plans, including Amazon Resource Names (ARNs), backup plan IDs, creation and deletion dates, plan names, and version IDs
list_backup_selections Returns an array containing metadata of the resources associated with the target backup plan
list_backup_vaults Returns a list of recovery point storage containers along with information about them
list_copy_jobs Returns metadata about your copy jobs
list_copy_job_summaries This request obtains a list of copy jobs created or running within the the most recent 30 days
list_frameworks Returns a list of all frameworks for an Amazon Web Services account and Amazon Web Services Region
list_legal_holds This action returns metadata about active and previous legal holds
list_protected_resources Returns an array of resources successfully backed up by Backup, including the time the resource was saved, an Amazon Resource Name (ARN) of the resource, and a resource type
list_protected_resources_by_backup_vault This request lists the protected resources corresponding to each backup vault
list_recovery_points_by_backup_vault Returns detailed information about the recovery points stored in a backup vault
list_recovery_points_by_legal_hold This action returns recovery point ARNs (Amazon Resource Names) of the specified legal hold
list_recovery_points_by_resource The information about the recovery points of the type specified by a resource Amazon Resource Name (ARN)
list_report_jobs Returns details about your report jobs
list_report_plans Returns a list of your report plans
list_restore_jobs Returns a list of jobs that Backup initiated to restore a saved resource, including details about the recovery process
list_restore_jobs_by_protected_resource This returns restore jobs that contain the specified protected resource
list_restore_job_summaries This request obtains a summary of restore jobs created or running within the the most recent 30 days
list_restore_testing_plans Returns a list of restore testing plans
list_restore_testing_selections Returns a list of restore testing selections
list_tags Returns the tags assigned to the resource, such as a target recovery point, backup plan, or backup vault
put_backup_vault_access_policy Sets a resource-based policy that is used to manage access permissions on the target backup vault
put_backup_vault_lock_configuration Applies Backup Vault Lock to a backup vault, preventing attempts to delete any recovery point stored in or created in a backup vault
put_backup_vault_notifications Turns on notifications on a backup vault for the specified topic and events
put_restore_validation_result This request allows you to send your independent self-run restore test validation results
start_backup_job Starts an on-demand backup job for the specified resource
start_copy_job Starts a job to create a one-time copy of the specified resource
start_report_job Starts an on-demand report job for the specified report plan
start_restore_job Recovers the saved resource identified by an Amazon Resource Name (ARN)
stop_backup_job Attempts to cancel a job to create a one-time backup of a resource
tag_resource Assigns a set of key-value pairs to a recovery point, backup plan, or backup vault identified by an Amazon Resource Name (ARN)
untag_resource Removes a set of key-value pairs from a recovery point, backup plan, or backup vault identified by an Amazon Resource Name (ARN)
update_backup_plan Updates the specified backup plan
update_framework Updates the specified framework
update_global_settings Updates whether the Amazon Web Services account is opted in to cross-account backup
update_recovery_point_lifecycle Sets the transition lifecycle of a recovery point
update_region_settings Updates the current service opt-in settings for the Region
update_report_plan Updates the specified report plan
update_restore_testing_plan This request will send changes to your specified restore testing plan
update_restore_testing_selection Updates the specified restore testing selection

Examples

## Not run: 
svc <- backup()
svc$cancel_legal_hold(
  Foo = 123
)

## End(Not run)

AWS Backup Gateway

Description

Backup gateway

Backup gateway connects Backup to your hypervisor, so you can create, store, and restore backups of your virtual machines (VMs) anywhere, whether on-premises or in the VMware Cloud (VMC) on Amazon Web Services.

Add on-premises resources by connecting to a hypervisor through a gateway. Backup will automatically discover the resources in your hypervisor.

Use Backup to assign virtual or on-premises resources to a backup plan, or run on-demand backups. Once you have backed up your resources, you can view them and restore them like any resource supported by Backup.

To download the Amazon Web Services software to get started, navigate to the Backup console, choose Gateways, then choose Create gateway.

Usage

backupgateway(
  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 <- backupgateway(
  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

associate_gateway_to_server Associates a backup gateway with your server
create_gateway Creates a backup gateway
delete_gateway Deletes a backup gateway
delete_hypervisor Deletes a hypervisor
disassociate_gateway_from_server Disassociates a backup gateway from the specified server
get_bandwidth_rate_limit_schedule Retrieves the bandwidth rate limit schedule for a specified gateway
get_gateway By providing the ARN (Amazon Resource Name), this API returns the gateway
get_hypervisor This action requests information about the specified hypervisor to which the gateway will connect
get_hypervisor_property_mappings This action retrieves the property mappings for the specified hypervisor
get_virtual_machine By providing the ARN (Amazon Resource Name), this API returns the virtual machine
import_hypervisor_configuration Connect to a hypervisor by importing its configuration
list_gateways Lists backup gateways owned by an Amazon Web Services account in an Amazon Web Services Region
list_hypervisors Lists your hypervisors
list_tags_for_resource Lists the tags applied to the resource identified by its Amazon Resource Name (ARN)
list_virtual_machines Lists your virtual machines
put_bandwidth_rate_limit_schedule This action sets the bandwidth rate limit schedule for a specified gateway
put_hypervisor_property_mappings This action sets the property mappings for the specified hypervisor
put_maintenance_start_time Set the maintenance start time for a gateway
start_virtual_machines_metadata_sync This action sends a request to sync metadata across the specified virtual machines
tag_resource Tag the resource
test_hypervisor_configuration Tests your hypervisor configuration to validate that backup gateway can connect with the hypervisor and its resources
untag_resource Removes tags from the resource
update_gateway_information Updates a gateway's name
update_gateway_software_now Updates the gateway virtual machine (VM) software
update_hypervisor Updates a hypervisor metadata, including its host, username, and password

Examples

## Not run: 
svc <- backupgateway()
svc$associate_gateway_to_server(
  Foo = 123
)

## End(Not run)

AWS Batch

Description

Batch

Using Batch, you can run batch computing workloads on the Amazon Web Services Cloud. Batch computing is a common means for developers, scientists, and engineers to access large amounts of compute resources. Batch uses the advantages of the batch computing to remove the undifferentiated heavy lifting of configuring and managing required infrastructure. At the same time, it also adopts a familiar batch computing software approach. You can use Batch to efficiently provision resources, and work toward eliminating capacity constraints, reducing your overall compute costs, and delivering results more quickly.

As a fully managed service, Batch can run batch computing workloads of any scale. Batch automatically provisions compute resources and optimizes workload distribution based on the quantity and scale of your specific workloads. With Batch, there's no need to install or manage batch computing software. This means that you can focus on analyzing results and solving your specific problems instead.

Usage

batch(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 <- batch(
  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

cancel_job Cancels a job in an Batch job queue
create_compute_environment Creates an Batch compute environment
create_job_queue Creates an Batch job queue
create_scheduling_policy Creates an Batch scheduling policy
delete_compute_environment Deletes an Batch compute environment
delete_job_queue Deletes the specified job queue
delete_scheduling_policy Deletes the specified scheduling policy
deregister_job_definition Deregisters an Batch job definition
describe_compute_environments Describes one or more of your compute environments
describe_job_definitions Describes a list of job definitions
describe_job_queues Describes one or more of your job queues
describe_jobs Describes a list of Batch jobs
describe_scheduling_policies Describes one or more of your scheduling policies
get_job_queue_snapshot Provides a list of the first 100 RUNNABLE jobs associated to a single job queue
list_jobs Returns a list of Batch jobs
list_scheduling_policies Returns a list of Batch scheduling policies
list_tags_for_resource Lists the tags for an Batch resource
register_job_definition Registers an Batch job definition
submit_job Submits an Batch job from a job definition
tag_resource Associates the specified tags to a resource with the specified resourceArn
terminate_job Terminates a job in a job queue
untag_resource Deletes specified tags from an Batch resource
update_compute_environment Updates an Batch compute environment
update_job_queue Updates a job queue
update_scheduling_policy Updates a scheduling policy

Examples

## Not run: 
svc <- batch()
# This example cancels a job with the specified job ID.
svc$cancel_job(
  jobId = "1d828f65-7a4d-42e8-996d-3b900ed59dc4",
  reason = "Cancelling job."
)

## End(Not run)

Amazon Bedrock

Description

Describes the API operations for creating, managing, fine-turning, and evaluating Amazon Bedrock models.

Usage

bedrock(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 <- bedrock(
  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

batch_delete_evaluation_job Creates a batch deletion job
create_evaluation_job API operation for creating and managing Amazon Bedrock automatic model evaluation jobs and model evaluation jobs that use human workers
create_guardrail Creates a guardrail to block topics and to implement safeguards for your generative AI applications
create_guardrail_version Creates a version of the guardrail
create_model_copy_job Copies a model to another region so that it can be used there
create_model_customization_job Creates a fine-tuning job to customize a base model
create_model_import_job Creates a model import job to import model that you have customized in other environments, such as Amazon SageMaker
create_model_invocation_job Creates a batch inference job to invoke a model on multiple prompts
create_provisioned_model_throughput Creates dedicated throughput for a base or custom model with the model units and for the duration that you specify
delete_custom_model Deletes a custom model that you created earlier
delete_guardrail Deletes a guardrail
delete_imported_model Deletes a custom model that you imported earlier
delete_model_invocation_logging_configuration Delete the invocation logging
delete_provisioned_model_throughput Deletes a Provisioned Throughput
get_custom_model Get the properties associated with a Amazon Bedrock custom model that you have created
get_evaluation_job Retrieves the properties associated with a model evaluation job, including the status of the job
get_foundation_model Get details about a Amazon Bedrock foundation model
get_guardrail Gets details about a guardrail
get_imported_model Gets properties associated with a customized model you imported
get_inference_profile Gets information about an inference profile
get_model_copy_job Retrieves information about a model copy job
get_model_customization_job Retrieves the properties associated with a model-customization job, including the status of the job
get_model_import_job Retrieves the properties associated with import model job, including the status of the job
get_model_invocation_job Gets details about a batch inference job
get_model_invocation_logging_configuration Get the current configuration values for model invocation logging
get_provisioned_model_throughput Returns details for a Provisioned Throughput
list_custom_models Returns a list of the custom models that you have created with the CreateModelCustomizationJob operation
list_evaluation_jobs Lists model evaluation jobs
list_foundation_models Lists Amazon Bedrock foundation models that you can use
list_guardrails Lists details about all the guardrails in an account
list_imported_models Returns a list of models you've imported
list_inference_profiles Returns a list of inference profiles that you can use
list_model_copy_jobs Returns a list of model copy jobs that you have submitted
list_model_customization_jobs Returns a list of model customization jobs that you have submitted
list_model_import_jobs Returns a list of import jobs you've submitted
list_model_invocation_jobs Lists all batch inference jobs in the account
list_provisioned_model_throughputs Lists the Provisioned Throughputs in the account
list_tags_for_resource List the tags associated with the specified resource
put_model_invocation_logging_configuration Set the configuration values for model invocation logging
stop_evaluation_job Stops an in progress model evaluation job
stop_model_customization_job Stops an active model customization job
stop_model_invocation_job Stops a batch inference job
tag_resource Associate tags with a resource
untag_resource Remove one or more tags from a resource
update_guardrail Updates a guardrail with the values you specify
update_provisioned_model_throughput Updates the name or associated model for a Provisioned Throughput

Examples

## Not run: 
svc <- bedrock()
svc$batch_delete_evaluation_job(
  Foo = 123
)

## End(Not run)

Amazon Bedrock Runtime

Description

Describes the API operations for running inference using Amazon Bedrock models.

Usage

bedrockruntime(
  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 <- bedrockruntime(
  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

apply_guardrail The action to apply a guardrail
converse Sends messages to the specified Amazon Bedrock model
converse_stream Sends messages to the specified Amazon Bedrock model and returns the response in a stream
invoke_model Invokes the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body
invoke_model_with_response_stream Invoke the specified Amazon Bedrock model to run inference using the prompt and inference parameters provided in the request body

Examples

## Not run: 
svc <- bedrockruntime()
svc$apply_guardrail(
  Foo = 123
)

## End(Not run)

AWSBillingConductor

Description

Amazon Web Services Billing Conductor is a fully managed service that you can use to customize a proforma version of your billing data each month, to accurately show or chargeback your end customers. Amazon Web Services Billing Conductor doesn't change the way you're billed by Amazon Web Services each month by design. Instead, it provides you with a mechanism to configure, generate, and display rates to certain customers over a given billing period. You can also analyze the difference between the rates you apply to your accounting groupings relative to your actual rates from Amazon Web Services. As a result of your Amazon Web Services Billing Conductor configuration, the payer account can also see the custom rate applied on the billing details page of the Amazon Web Services Billing console, or configure a cost and usage report per billing group.

This documentation shows how you can configure Amazon Web Services Billing Conductor using its API. For more information about using the Amazon Web Services Billing Conductor user interface, see the Amazon Web Services Billing Conductor User Guide.

Usage

billingconductor(
  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 <- billingconductor(
  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

associate_accounts Connects an array of account IDs in a consolidated billing family to a predefined billing group
associate_pricing_rules Connects an array of PricingRuleArns to a defined PricingPlan
batch_associate_resources_to_custom_line_item Associates a batch of resources to a percentage custom line item
batch_disassociate_resources_from_custom_line_item Disassociates a batch of resources from a percentage custom line item
create_billing_group Creates a billing group that resembles a consolidated billing family that Amazon Web Services charges, based off of the predefined pricing plan computation
create_custom_line_item Creates a custom line item that can be used to create a one-time fixed charge that can be applied to a single billing group for the current or previous billing period
create_pricing_plan Creates a pricing plan that is used for computing Amazon Web Services charges for billing groups
create_pricing_rule Creates a pricing rule can be associated to a pricing plan, or a set of pricing plans
delete_billing_group Deletes a billing group
delete_custom_line_item Deletes the custom line item identified by the given ARN in the current, or previous billing period
delete_pricing_plan Deletes a pricing plan
delete_pricing_rule Deletes the pricing rule that's identified by the input Amazon Resource Name (ARN)
disassociate_accounts Removes the specified list of account IDs from the given billing group
disassociate_pricing_rules Disassociates a list of pricing rules from a pricing plan
get_billing_group_cost_report Retrieves the margin summary report, which includes the Amazon Web Services cost and charged amount (pro forma cost) by Amazon Web Service for a specific billing group
list_account_associations This is a paginated call to list linked accounts that are linked to the payer account for the specified time period
list_billing_group_cost_reports A paginated call to retrieve a summary report of actual Amazon Web Services charges and the calculated Amazon Web Services charges based on the associated pricing plan of a billing group
list_billing_groups A paginated call to retrieve a list of billing groups for the given billing period
list_custom_line_items A paginated call to get a list of all custom line items (FFLIs) for the given billing period
list_custom_line_item_versions A paginated call to get a list of all custom line item versions
list_pricing_plans A paginated call to get pricing plans for the given billing period
list_pricing_plans_associated_with_pricing_rule A list of the pricing plans that are associated with a pricing rule
list_pricing_rules Describes a pricing rule that can be associated to a pricing plan, or set of pricing plans
list_pricing_rules_associated_to_pricing_plan Lists the pricing rules that are associated with a pricing plan
list_resources_associated_to_custom_line_item List the resources that are associated to a custom line item
list_tags_for_resource A list the tags for a resource
tag_resource Associates the specified tags to a resource with the specified resourceArn
untag_resource Deletes specified tags from a resource
update_billing_group This updates an existing billing group
update_custom_line_item Update an existing custom line item in the current or previous billing period
update_pricing_plan This updates an existing pricing plan
update_pricing_rule Updates an existing pricing rule

Examples

## Not run: 
svc <- billingconductor()
svc$associate_accounts(
  Foo = 123
)

## End(Not run)

Braket

Description

The Amazon Braket API Reference provides information about the operations and structures supported in Amazon Braket.

Additional Resources:

Usage

braket(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 <- braket(
  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

cancel_job Cancels an Amazon Braket job
cancel_quantum_task Cancels the specified task
create_job Creates an Amazon Braket job
create_quantum_task Creates a quantum task
get_device Retrieves the devices available in Amazon Braket
get_job Retrieves the specified Amazon Braket job
get_quantum_task Retrieves the specified quantum task
list_tags_for_resource Shows the tags associated with this resource
search_devices Searches for devices using the specified filters
search_jobs Searches for Amazon Braket jobs that match the specified filter values
search_quantum_tasks Searches for tasks that match the specified filter values
tag_resource Add a tag to the specified resource
untag_resource Remove tags from a resource

Examples

## Not run: 
svc <- braket()
svc$cancel_job(
  Foo = 123
)

## End(Not run)

AWS Budgets

Description

Use the Amazon Web Services Budgets API to plan your service usage, service costs, and instance reservations. This API reference provides descriptions, syntax, and usage examples for each of the actions and data types for the Amazon Web Services Budgets feature.

Budgets provide you with a way to see the following information:

  • How close your plan is to your budgeted amount or to the free tier limits

  • Your usage-to-date, including how much you've used of your Reserved Instances (RIs)

  • Your current estimated charges from Amazon Web Services, and how much your predicted usage will accrue in charges by the end of the month

  • How much of your budget has been used

Amazon Web Services updates your budget status several times a day. Budgets track your unblended costs, subscriptions, refunds, and RIs. You can create the following types of budgets:

  • Cost budgets - Plan how much you want to spend on a service.

  • Usage budgets - Plan how much you want to use one or more services.

  • RI utilization budgets - Define a utilization threshold, and receive alerts when your RI usage falls below that threshold. This lets you see if your RIs are unused or under-utilized.

  • RI coverage budgets - Define a coverage threshold, and receive alerts when the number of your instance hours that are covered by RIs fall below that threshold. This lets you see how much of your instance usage is covered by a reservation.

Service Endpoint

The Amazon Web Services Budgets API provides the following endpoint:

  • https://budgets.amazonaws.com

For information about costs that are associated with the Amazon Web Services Budgets API, see Amazon Web Services Cost Management Pricing.

Usage

budgets(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 <- budgets(
  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

create_budget Creates a budget and, if included, notifications and subscribers
create_budget_action Creates a budget action
create_notification Creates a notification
create_subscriber Creates a subscriber
delete_budget Deletes a budget
delete_budget_action Deletes a budget action
delete_notification Deletes a notification
delete_subscriber Deletes a subscriber
describe_budget Describes a budget
describe_budget_action Describes a budget action detail
describe_budget_action_histories Describes a budget action history detail
describe_budget_actions_for_account Describes all of the budget actions for an account
describe_budget_actions_for_budget Describes all of the budget actions for a budget
describe_budget_notifications_for_account Lists the budget names and notifications that are associated with an account
describe_budget_performance_history Describes the history for DAILY, MONTHLY, and QUARTERLY budgets
describe_budgets Lists the budgets that are associated with an account
describe_notifications_for_budget Lists the notifications that are associated with a budget
describe_subscribers_for_notification Lists the subscribers that are associated with a notification
execute_budget_action Executes a budget action
list_tags_for_resource Lists tags associated with a budget or budget action resource
tag_resource Creates tags for a budget or budget action resource
untag_resource Deletes tags associated with a budget or budget action resource
update_budget Updates a budget
update_budget_action Updates a budget action
update_notification Updates a notification
update_subscriber Updates a subscriber

Examples

## Not run: 
svc <- budgets()
svc$create_budget(
  Foo = 123
)

## End(Not run)

AWS Cloud9

Description

Cloud9

Cloud9 is a collection of tools that you can use to code, build, run, test, debug, and release software in the cloud.

For more information about Cloud9, see the Cloud9 User Guide.

Cloud9 supports these operations:

Usage

cloud9(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 <- cloud9(
  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

create_environment_ec2 Creates an Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then connects from the instance to the environment
create_environment_membership Adds an environment member to an Cloud9 development environment
delete_environment Deletes an Cloud9 development environment
delete_environment_membership Deletes an environment member from a development environment
describe_environment_memberships Gets information about environment members for an Cloud9 development environment
describe_environments Gets information about Cloud9 development environments
describe_environment_status Gets status information for an Cloud9 development environment
list_environments Gets a list of Cloud9 development environment identifiers
list_tags_for_resource Gets a list of the tags associated with an Cloud9 development environment
tag_resource Adds tags to an Cloud9 development environment
untag_resource Removes tags from an Cloud9 development environment
update_environment Changes the settings of an existing Cloud9 development environment
update_environment_membership Changes the settings of an existing environment member for an Cloud9 development environment

Examples

## Not run: 
svc <- cloud9()
# 
svc$create_environment_ec2(
  name = "my-demo-environment",
  automaticStopTimeMinutes = 60L,
  description = "This is my demonstration environment.",
  imageId = "amazonlinux-2023-x86_64",
  instanceType = "t2.micro",
  ownerArn = "arn:aws:iam::123456789012:user/MyDemoUser",
  subnetId = "subnet-6300cd1b"
)

## End(Not run)

AWS Cloud Control API

Description

For more information about Amazon Web Services Cloud Control API, see the Amazon Web Services Cloud Control API User Guide.

Usage

cloudcontrolapi(
  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 <- cloudcontrolapi(
  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

cancel_resource_request Cancels the specified resource operation request
create_resource Creates the specified resource
delete_resource Deletes the specified resource
get_resource Returns information about the current state of the specified resource
get_resource_request_status Returns the current status of a resource operation request
list_resource_requests Returns existing resource operation requests
list_resources Returns information about the specified resources
update_resource Updates the specified property values in the resource

Examples

## Not run: 
svc <- cloudcontrolapi()
svc$cancel_resource_request(
  Foo = 123
)

## End(Not run)

Amazon CloudDirectory

Description

Amazon Cloud Directory

Amazon Cloud Directory is a component of the AWS Directory Service that simplifies the development and management of cloud-scale web, mobile, and IoT applications. This guide describes the Cloud Directory operations that you can call programmatically and includes detailed information on data types and errors. For information about Cloud Directory features, see AWS Directory Service and the Amazon Cloud Directory Developer Guide.

Usage

clouddirectory(
  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 <- clouddirectory(
  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_facet_to_object Adds a new Facet to an object
apply_schema Copies the input published schema, at the specified version, into the Directory with the same name and version as that of the published schema
attach_object Attaches an existing object to another object
attach_policy Attaches a policy object to a regular object
attach_to_index Attaches the specified object to the specified index
attach_typed_link Attaches a typed link to a specified source and target object
batch_read Performs all the read operations in a batch
batch_write Performs all the write operations in a batch
create_directory Creates a Directory by copying the published schema into the directory
create_facet Creates a new Facet in a schema
create_index Creates an index object
create_object Creates an object in a Directory
create_schema Creates a new schema in a development state
create_typed_link_facet Creates a TypedLinkFacet
delete_directory Deletes a directory
delete_facet Deletes a given Facet
delete_object Deletes an object and its associated attributes
delete_schema Deletes a given schema
delete_typed_link_facet Deletes a TypedLinkFacet
detach_from_index Detaches the specified object from the specified index
detach_object Detaches a given object from the parent object
detach_policy Detaches a policy from an object
detach_typed_link Detaches a typed link from a specified source and target object
disable_directory Disables the specified directory
enable_directory Enables the specified directory
get_applied_schema_version Returns current applied schema version ARN, including the minor version in use
get_directory Retrieves metadata about a directory
get_facet Gets details of the Facet, such as facet name, attributes, Rules, or ObjectType
get_link_attributes Retrieves attributes that are associated with a typed link
get_object_attributes Retrieves attributes within a facet that are associated with an object
get_object_information Retrieves metadata about an object
get_schema_as_json Retrieves a JSON representation of the schema
get_typed_link_facet_information Returns the identity attribute order for a specific TypedLinkFacet
list_applied_schema_arns Lists schema major versions applied to a directory
list_attached_indices Lists indices attached to the specified object
list_development_schema_arns Retrieves each Amazon Resource Name (ARN) of schemas in the development state
list_directories Lists directories created within an account
list_facet_attributes Retrieves attributes attached to the facet
list_facet_names Retrieves the names of facets that exist in a schema
list_incoming_typed_links Returns a paginated list of all the incoming TypedLinkSpecifier information for an object
list_index Lists objects attached to the specified index
list_managed_schema_arns Lists the major version families of each managed schema
list_object_attributes Lists all attributes that are associated with an object
list_object_children Returns a paginated list of child objects that are associated with a given object
list_object_parent_paths Retrieves all available parent paths for any object type such as node, leaf node, policy node, and index node objects
list_object_parents Lists parent objects that are associated with a given object in pagination fashion
list_object_policies Returns policies attached to an object in pagination fashion
list_outgoing_typed_links Returns a paginated list of all the outgoing TypedLinkSpecifier information for an object
list_policy_attachments Returns all of the ObjectIdentifiers to which a given policy is attached
list_published_schema_arns Lists the major version families of each published schema
list_tags_for_resource Returns tags for a resource
list_typed_link_facet_attributes Returns a paginated list of all attribute definitions for a particular TypedLinkFacet
list_typed_link_facet_names Returns a paginated list of TypedLink facet names for a particular schema
lookup_policy Lists all policies from the root of the Directory to the object specified
publish_schema Publishes a development schema with a major version and a recommended minor version
put_schema_from_json Allows a schema to be updated using JSON upload
remove_facet_from_object Removes the specified facet from the specified object
tag_resource An API operation for adding tags to a resource
untag_resource An API operation for removing tags from a resource
update_facet Does the following:
update_link_attributes Updates a given typed link’s attributes
update_object_attributes Updates a given object's attributes
update_schema Updates the schema name with a new name
update_typed_link_facet Updates a TypedLinkFacet
upgrade_applied_schema Upgrades a single directory in-place using the PublishedSchemaArn with schema updates found in MinorVersion
upgrade_published_schema Upgrades a published schema under a new minor version revision using the current contents of DevelopmentSchemaArn

Examples

## Not run: 
svc <- clouddirectory()
svc$add_facet_to_object(
  Foo = 123
)

## End(Not run)

AWS CloudFormation

Description

CloudFormation

CloudFormation allows you to create and manage Amazon Web Services infrastructure deployments predictably and repeatedly. You can use CloudFormation to leverage Amazon Web Services products, such as Amazon Elastic Compute Cloud, Amazon Elastic Block Store, Amazon Simple Notification Service, Elastic Load Balancing, and Auto Scaling to build highly reliable, highly scalable, cost-effective applications without creating or configuring the underlying Amazon Web Services infrastructure.

With CloudFormation, you declare all your resources and dependencies in a template file. The template defines a collection of resources as a single unit called a stack. CloudFormation creates and deletes all member resources of the stack together and manages all dependencies between the resources for you.

For more information about CloudFormation, see the CloudFormation product page.

CloudFormation makes use of other Amazon Web Services products. If you need additional technical information about a specific Amazon Web Services product, you can find the product's technical documentation at docs.aws.amazon.com.

Usage

cloudformation(
  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 <- cloudformation(
  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

activate_organizations_access Activate trusted access with Organizations
activate_type Activates a public third-party extension, making it available for use in stack templates
batch_describe_type_configurations Returns configuration data for the specified CloudFormation extensions, from the CloudFormation registry for the account and Region
cancel_update_stack Cancels an update on the specified stack
continue_update_rollback For a specified stack that's in the UPDATE_ROLLBACK_FAILED state, continues rolling it back to the UPDATE_ROLLBACK_COMPLETE state
create_change_set Creates a list of changes that will be applied to a stack so that you can review the changes before executing them
create_generated_template Creates a template from existing resources that are not already managed with CloudFormation
create_stack Creates a stack as specified in the template
create_stack_instances Creates stack instances for the specified accounts, within the specified Amazon Web Services Regions
create_stack_set Creates a stack set
deactivate_organizations_access Deactivates trusted access with Organizations
deactivate_type Deactivates a public extension that was previously activated in this account and Region
delete_change_set Deletes the specified change set
delete_generated_template Deleted a generated template
delete_stack Deletes a specified stack
delete_stack_instances Deletes stack instances for the specified accounts, in the specified Amazon Web Services Regions
delete_stack_set Deletes a stack set
deregister_type Marks an extension or extension version as DEPRECATED in the CloudFormation registry, removing it from active use
describe_account_limits Retrieves your account's CloudFormation limits, such as the maximum number of stacks that you can create in your account
describe_change_set Returns the inputs for the change set and a list of changes that CloudFormation will make if you execute the change set
describe_change_set_hooks Returns hook-related information for the change set and a list of changes that CloudFormation makes when you run the change set
describe_generated_template Describes a generated template
describe_organizations_access Retrieves information about the account's OrganizationAccess status
describe_publisher Returns information about a CloudFormation extension publisher
describe_resource_scan Describes details of a resource scan
describe_stack_drift_detection_status Returns information about a stack drift detection operation
describe_stack_events Returns all stack related events for a specified stack in reverse chronological order
describe_stack_instance Returns the stack instance that's associated with the specified StackSet, Amazon Web Services account, and Amazon Web Services Region
describe_stack_resource Returns a description of the specified resource in the specified stack
describe_stack_resource_drifts Returns drift information for the resources that have been checked for drift in the specified stack
describe_stack_resources Returns Amazon Web Services resource descriptions for running and deleted stacks
describe_stacks Returns the description for the specified stack; if no stack name was specified, then it returns the description for all the stacks created
describe_stack_set Returns the description of the specified StackSet
describe_stack_set_operation Returns the description of the specified StackSet operation
describe_type Returns detailed information about an extension that has been registered
describe_type_registration Returns information about an extension's registration, including its current status and type and version identifiers
detect_stack_drift Detects whether a stack's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters
detect_stack_resource_drift Returns information about whether a resource's actual configuration differs, or has drifted, from its expected configuration, as defined in the stack template and any values specified as template parameters
detect_stack_set_drift Detect drift on a stack set
estimate_template_cost Returns the estimated monthly cost of a template
execute_change_set Updates a stack using the input information that was provided when the specified change set was created
get_generated_template Retrieves a generated template
get_stack_policy Returns the stack policy for a specified stack
get_template Returns the template body for a specified stack
get_template_summary Returns information about a new or existing template
import_stacks_to_stack_set Import existing stacks into a new stack sets
list_change_sets Returns the ID and status of each active change set for a stack
list_exports Lists all exported output values in the account and Region in which you call this action
list_generated_templates Lists your generated templates in this Region
list_imports Lists all stacks that are importing an exported output value
list_resource_scan_related_resources Lists the related resources for a list of resources from a resource scan
list_resource_scan_resources Lists the resources from a resource scan
list_resource_scans List the resource scans from newest to oldest
list_stack_instance_resource_drifts Returns drift information for resources in a stack instance
list_stack_instances Returns summary information about stack instances that are associated with the specified stack set
list_stack_resources Returns descriptions of all resources of the specified stack
list_stacks Returns the summary information for stacks whose status matches the specified StackStatusFilter
list_stack_set_auto_deployment_targets Returns summary information about deployment targets for a stack set
list_stack_set_operation_results Returns summary information about the results of a stack set operation
list_stack_set_operations Returns summary information about operations performed on a stack set
list_stack_sets Returns summary information about stack sets that are associated with the user
list_type_registrations Returns a list of registration tokens for the specified extension(s)
list_types Returns summary information about extension that have been registered with CloudFormation
list_type_versions Returns summary information about the versions of an extension
publish_type Publishes the specified extension to the CloudFormation registry as a public extension in this Region
record_handler_progress Reports progress of a resource handler to CloudFormation
register_publisher Registers your account as a publisher of public extensions in the CloudFormation registry
register_type Registers an extension with the CloudFormation service
rollback_stack When specifying RollbackStack, you preserve the state of previously provisioned resources when an operation fails
set_stack_policy Sets a stack policy for a specified stack
set_type_configuration Specifies the configuration data for a registered CloudFormation extension, in the given account and Region
set_type_default_version Specify the default version of an extension
signal_resource Sends a signal to the specified resource with a success or failure status
start_resource_scan Starts a scan of the resources in this account in this Region
stop_stack_set_operation Stops an in-progress operation on a stack set and its associated stack instances
test_type Tests a registered extension to make sure it meets all necessary requirements for being published in the CloudFormation registry
update_generated_template Updates a generated template
update_stack Updates a stack as specified in the template
update_stack_instances Updates the parameter values for stack instances for the specified accounts, within the specified Amazon Web Services Regions
update_stack_set Updates the stack set, and associated stack instances in the specified accounts and Amazon Web Services Regions
update_termination_protection Updates termination protection for the specified stack
validate_template Validates a specified template

Examples

## Not run: 
svc <- cloudformation()
# This example creates a generated template with a resources file.
svc$create_generated_template(
  GeneratedTemplateName = "JazzyTemplate",
  Resources = list(
    list(
      ResourceIdentifier = list(
        BucketName = "jazz-bucket"
      ),
      ResourceType = "AWS::S3::Bucket"
    ),
    list(
      ResourceIdentifier = list(
        DhcpOptionsId = "random-id123"
      ),
      ResourceType = "AWS::EC2::DHCPOptions"
    )
  )
)

## End(Not run)

Amazon CloudFront

Description

This is the Amazon CloudFront API Reference. This guide is for developers who need detailed information about CloudFront API actions, data types, and errors. For detailed information about CloudFront features, see the Amazon CloudFront Developer Guide.

Usage

cloudfront(
  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 <- cloudfront(
  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

associate_alias Associates an alias (also known as a CNAME or an alternate domain name) with a CloudFront distribution
copy_distribution Creates a staging distribution using the configuration of the provided primary distribution
create_cache_policy Creates a cache policy
create_cloud_front_origin_access_identity Creates a new origin access identity
create_continuous_deployment_policy Creates a continuous deployment policy that distributes traffic for a custom domain name to two different CloudFront distributions
create_distribution Creates a CloudFront distribution
create_distribution_with_tags Create a new distribution with tags
create_field_level_encryption_config Create a new field-level encryption configuration
create_field_level_encryption_profile Create a field-level encryption profile
create_function Creates a CloudFront function
create_invalidation Create a new invalidation
create_key_group Creates a key group that you can use with CloudFront signed URLs and signed cookies
create_key_value_store Specifies the key value store resource to add to your account
create_monitoring_subscription Enables additional CloudWatch metrics for the specified CloudFront distribution
create_origin_access_control Creates a new origin access control in CloudFront
create_origin_request_policy Creates an origin request policy
create_public_key Uploads a public key to CloudFront that you can use with signed URLs and signed cookies, or with field-level encryption
create_realtime_log_config Creates a real-time log configuration
create_response_headers_policy Creates a response headers policy
create_streaming_distribution This API is deprecated
create_streaming_distribution_with_tags This API is deprecated
delete_cache_policy Deletes a cache policy
delete_cloud_front_origin_access_identity Delete an origin access identity
delete_continuous_deployment_policy Deletes a continuous deployment policy
delete_distribution Delete a distribution
delete_field_level_encryption_config Remove a field-level encryption configuration
delete_field_level_encryption_profile Remove a field-level encryption profile
delete_function Deletes a CloudFront function
delete_key_group Deletes a key group
delete_key_value_store Specifies the key value store to delete
delete_monitoring_subscription Disables additional CloudWatch metrics for the specified CloudFront distribution
delete_origin_access_control Deletes a CloudFront origin access control
delete_origin_request_policy Deletes an origin request policy
delete_public_key Remove a public key you previously added to CloudFront
delete_realtime_log_config Deletes a real-time log configuration
delete_response_headers_policy Deletes a response headers policy
delete_streaming_distribution Delete a streaming distribution
describe_function Gets configuration information and metadata about a CloudFront function, but not the function's code
describe_key_value_store Specifies the key value store and its configuration
get_cache_policy Gets a cache policy, including the following metadata:
get_cache_policy_config Gets a cache policy configuration
get_cloud_front_origin_access_identity Get the information about an origin access identity
get_cloud_front_origin_access_identity_config Get the configuration information about an origin access identity
get_continuous_deployment_policy Gets a continuous deployment policy, including metadata (the policy's identifier and the date and time when the policy was last modified)
get_continuous_deployment_policy_config Gets configuration information about a continuous deployment policy
get_distribution Get the information about a distribution
get_distribution_config Get the configuration information about a distribution
get_field_level_encryption Get the field-level encryption configuration information
get_field_level_encryption_config Get the field-level encryption configuration information
get_field_level_encryption_profile Get the field-level encryption profile information
get_field_level_encryption_profile_config Get the field-level encryption profile configuration information
get_function Gets the code of a CloudFront function
get_invalidation Get the information about an invalidation
get_key_group Gets a key group, including the date and time when the key group was last modified
get_key_group_config Gets a key group configuration
get_monitoring_subscription Gets information about whether additional CloudWatch metrics are enabled for the specified CloudFront distribution
get_origin_access_control Gets a CloudFront origin access control, including its unique identifier
get_origin_access_control_config Gets a CloudFront origin access control configuration
get_origin_request_policy Gets an origin request policy, including the following metadata:
get_origin_request_policy_config Gets an origin request policy configuration
get_public_key Gets a public key
get_public_key_config Gets a public key configuration
get_realtime_log_config Gets a real-time log configuration
get_response_headers_policy Gets a response headers policy, including metadata (the policy's identifier and the date and time when the policy was last modified)
get_response_headers_policy_config Gets a response headers policy configuration
get_streaming_distribution Gets information about a specified RTMP distribution, including the distribution configuration
get_streaming_distribution_config Get the configuration information about a streaming distribution
list_cache_policies Gets a list of cache policies
list_cloud_front_origin_access_identities Lists origin access identities
list_conflicting_aliases Gets a list of aliases (also called CNAMEs or alternate domain names) that conflict or overlap with the provided alias, and the associated CloudFront distributions and Amazon Web Services accounts for each conflicting alias
list_continuous_deployment_policies Gets a list of the continuous deployment policies in your Amazon Web Services account
list_distributions List CloudFront distributions
list_distributions_by_cache_policy_id Gets a list of distribution IDs for distributions that have a cache behavior that's associated with the specified cache policy
list_distributions_by_key_group Gets a list of distribution IDs for distributions that have a cache behavior that references the specified key group
list_distributions_by_origin_request_policy_id Gets a list of distribution IDs for distributions that have a cache behavior that's associated with the specified origin request policy
list_distributions_by_realtime_log_config Gets a list of distributions that have a cache behavior that's associated with the specified real-time log configuration
list_distributions_by_response_headers_policy_id Gets a list of distribution IDs for distributions that have a cache behavior that's associated with the specified response headers policy
list_distributions_by_web_acl_id List the distributions that are associated with a specified WAF web ACL
list_field_level_encryption_configs List all field-level encryption configurations that have been created in CloudFront for this account
list_field_level_encryption_profiles Request a list of field-level encryption profiles that have been created in CloudFront for this account
list_functions Gets a list of all CloudFront functions in your Amazon Web Services account
list_invalidations Lists invalidation batches
list_key_groups Gets a list of key groups
list_key_value_stores Specifies the key value stores to list
list_origin_access_controls Gets the list of CloudFront origin access controls in this Amazon Web Services account
list_origin_request_policies Gets a list of origin request policies
list_public_keys List all public keys that have been added to CloudFront for this account
list_realtime_log_configs Gets a list of real-time log configurations
list_response_headers_policies Gets a list of response headers policies
list_streaming_distributions List streaming distributions
list_tags_for_resource List tags for a CloudFront resource
publish_function Publishes a CloudFront function by copying the function code from the DEVELOPMENT stage to LIVE
tag_resource Add tags to a CloudFront resource
test_function Tests a CloudFront function
untag_resource Remove tags from a CloudFront resource
update_cache_policy Updates a cache policy configuration
update_cloud_front_origin_access_identity Update an origin access identity
update_continuous_deployment_policy Updates a continuous deployment policy
update_distribution Updates the configuration for a CloudFront distribution
update_distribution_with_staging_config Copies the staging distribution's configuration to its corresponding primary distribution
update_field_level_encryption_config Update a field-level encryption configuration
update_field_level_encryption_profile Update a field-level encryption profile
update_function Updates a CloudFront function
update_key_group Updates a key group
update_key_value_store Specifies the key value store to update
update_origin_access_control Updates a CloudFront origin access control
update_origin_request_policy Updates an origin request policy configuration
update_public_key Update public key information
update_realtime_log_config Updates a real-time log configuration
update_response_headers_policy Updates a response headers policy
update_streaming_distribution Update a streaming distribution

Examples

## Not run: 
svc <- cloudfront()
# Use the following command to create a function.
svc$create_function(
  FunctionCode = "function-code.js",
  FunctionConfig = list(
    Comment = "my-function-comment",
    KeyValueStoreAssociations = list(
      Items = list(
        list(
          KeyValueStoreARN = "arn:aws:cloudfront::123456789012:key-value-st..."
        )
      ),
      Quantity = 1L
    ),
    Runtime = "cloudfront-js-2.0"
  ),
  Name = "my-function-name"
)

## End(Not run)

Amazon CloudHSM

Description

AWS CloudHSM Service

This is documentation for AWS CloudHSM Classic. For more information, see AWS CloudHSM Classic FAQs, the AWS CloudHSM Classic User Guide, and the AWS CloudHSM Classic API Reference.

For information about the current version of AWS CloudHSM, see AWS CloudHSM, the AWS CloudHSM User Guide, and the AWS CloudHSM API Reference.

Usage

cloudhsm(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 <- cloudhsm(
  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_tags_to_resource This is documentation for AWS CloudHSM Classic
create_hapg This is documentation for AWS CloudHSM Classic
create_hsm This is documentation for AWS CloudHSM Classic
create_luna_client This is documentation for AWS CloudHSM Classic
delete_hapg This is documentation for AWS CloudHSM Classic
delete_hsm This is documentation for AWS CloudHSM Classic
delete_luna_client This is documentation for AWS CloudHSM Classic
describe_hapg This is documentation for AWS CloudHSM Classic
describe_hsm This is documentation for AWS CloudHSM Classic
describe_luna_client This is documentation for AWS CloudHSM Classic
get_config This is documentation for AWS CloudHSM Classic
list_available_zones This is documentation for AWS CloudHSM Classic
list_hapgs This is documentation for AWS CloudHSM Classic
list_hsms This is documentation for AWS CloudHSM Classic
list_luna_clients This is documentation for AWS CloudHSM Classic
list_tags_for_resource This is documentation for AWS CloudHSM Classic
modify_hapg This is documentation for AWS CloudHSM Classic
modify_hsm This is documentation for AWS CloudHSM Classic
modify_luna_client This is documentation for AWS CloudHSM Classic
remove_tags_from_resource This is documentation for AWS CloudHSM Classic

Examples

## Not run: 
svc <- cloudhsm()
svc$add_tags_to_resource(
  Foo = 123
)

## End(Not run)

AWS CloudHSM V2

Description

For more information about CloudHSM, see CloudHSM and the CloudHSM User Guide.

Usage

cloudhsmv2(
  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 <- cloudhsmv2(
  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

copy_backup_to_region Copy an CloudHSM cluster backup to a different region
create_cluster Creates a new CloudHSM cluster
create_hsm Creates a new hardware security module (HSM) in the specified CloudHSM cluster
delete_backup Deletes a specified CloudHSM backup
delete_cluster Deletes the specified CloudHSM cluster
delete_hsm Deletes the specified HSM
delete_resource_policy Deletes an CloudHSM resource policy
describe_backups Gets information about backups of CloudHSM clusters
describe_clusters Gets information about CloudHSM clusters
get_resource_policy Retrieves the resource policy document attached to a given resource
initialize_cluster Claims an CloudHSM cluster by submitting the cluster certificate issued by your issuing certificate authority (CA) and the CA's root certificate
list_tags Gets a list of tags for the specified CloudHSM cluster
modify_backup_attributes Modifies attributes for CloudHSM backup
modify_cluster Modifies CloudHSM cluster
put_resource_policy Creates or updates an CloudHSM resource policy
restore_backup Restores a specified CloudHSM backup that is in the PENDING_DELETION state
tag_resource Adds or overwrites one or more tags for the specified CloudHSM cluster
untag_resource Removes the specified tag or tags from the specified CloudHSM cluster

Examples

## Not run: 
svc <- cloudhsmv2()
svc$copy_backup_to_region(
  Foo = 123
)

## End(Not run)

Amazon CloudSearch

Description

Amazon CloudSearch Configuration Service

You use the Amazon CloudSearch configuration service to create, configure, and manage search domains. Configuration service requests are submitted using the AWS Query protocol. AWS Query requests are HTTP or HTTPS requests submitted via HTTP GET or POST with a query parameter named Action.

The endpoint for configuration service requests is region-specific: cloudsearch.region.amazonaws.com. For example, cloudsearch.us-east-1.amazonaws.com. For a current list of supported regions and endpoints, see Regions and Endpoints.

Usage

cloudsearch(
  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 <- cloudsearch(
  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

build_suggesters Indexes the search suggestions
create_domain Creates a new search domain
define_analysis_scheme Configures an analysis scheme that can be applied to a text or text-array field to define language-specific text processing options
define_expression Configures an Expression for the search domain
define_index_field Configures an IndexField for the search domain
define_suggester Configures a suggester for a domain
delete_analysis_scheme Deletes an analysis scheme
delete_domain Permanently deletes a search domain and all of its data
delete_expression Removes an Expression from the search domain
delete_index_field Removes an IndexField from the search domain
delete_suggester Deletes a suggester
describe_analysis_schemes Gets the analysis schemes configured for a domain
describe_availability_options Gets the availability options configured for a domain
describe_domain_endpoint_options Returns the domain's endpoint options, specifically whether all requests to the domain must arrive over HTTPS
describe_domains Gets information about the search domains owned by this account
describe_expressions Gets the expressions configured for the search domain
describe_index_fields Gets information about the index fields configured for the search domain
describe_scaling_parameters Gets the scaling parameters configured for a domain
describe_service_access_policies Gets information about the access policies that control access to the domain's document and search endpoints
describe_suggesters Gets the suggesters configured for a domain
index_documents Tells the search domain to start indexing its documents using the latest indexing options
list_domain_names Lists all search domains owned by an account
update_availability_options Configures the availability options for a domain
update_domain_endpoint_options Updates the domain's endpoint options, specifically whether all requests to the domain must arrive over HTTPS
update_scaling_parameters Configures scaling parameters for a domain
update_service_access_policies Configures the access rules that control access to the domain's document and search endpoints

Examples

## Not run: 
svc <- cloudsearch()
svc$build_suggesters(
  Foo = 123
)

## End(Not run)

Amazon CloudSearch Domain

Description

You use the AmazonCloudSearch2013 API to upload documents to a search domain and search those documents.

The endpoints for submitting upload_documents, search, and suggest requests are domain-specific. To get the endpoints for your domain, use the Amazon CloudSearch configuration service DescribeDomains action. The domain endpoints are also displayed on the domain dashboard in the Amazon CloudSearch console. You submit suggest requests to the search endpoint.

For more information, see the Amazon CloudSearch Developer Guide.

Usage

cloudsearchdomain(
  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 <- cloudsearchdomain(
  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

search Retrieves a list of documents that match the specified search criteria
suggest Retrieves autocomplete suggestions for a partial query string
upload_documents Posts a batch of documents to a search domain for indexing

Examples

## Not run: 
svc <- cloudsearchdomain()
svc$search(
  Foo = 123
)

## End(Not run)

AWS CloudTrail

Description

CloudTrail

This is the CloudTrail API Reference. It provides descriptions of actions, data types, common parameters, and common errors for CloudTrail.

CloudTrail is a web service that records Amazon Web Services API calls for your Amazon Web Services account and delivers log files to an Amazon S3 bucket. The recorded information includes the identity of the user, the start time of the Amazon Web Services API call, the source IP address, the request parameters, and the response elements returned by the service.

As an alternative to the API, you can use one of the Amazon Web Services SDKs, which consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .NET, iOS, Android, etc.). The SDKs provide programmatic access to CloudTrail. For example, the SDKs handle cryptographically signing requests, managing errors, and retrying requests automatically. For more information about the Amazon Web Services SDKs, including how to download and install them, see Tools to Build on Amazon Web Services.

See the CloudTrail User Guide for information about the data that is included with each Amazon Web Services API call listed in the log files.

Usage

cloudtrail(
  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 <- cloudtrail(
  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_tags Adds one or more tags to a trail, event data store, or channel, up to a limit of 50
cancel_query Cancels a query if the query is not in a terminated state, such as CANCELLED, FAILED, TIMED_OUT, or FINISHED
create_channel Creates a channel for CloudTrail to ingest events from a partner or external source
create_event_data_store Creates a new event data store
create_trail Creates a trail that specifies the settings for delivery of log data to an Amazon S3 bucket
delete_channel Deletes a channel
delete_event_data_store Disables the event data store specified by EventDataStore, which accepts an event data store ARN
delete_resource_policy Deletes the resource-based policy attached to the CloudTrail channel
delete_trail Deletes a trail
deregister_organization_delegated_admin Removes CloudTrail delegated administrator permissions from a member account in an organization
describe_query Returns metadata about a query, including query run time in milliseconds, number of events scanned and matched, and query status
describe_trails Retrieves settings for one or more trails associated with the current Region for your account
disable_federation Disables Lake query federation on the specified event data store
enable_federation Enables Lake query federation on the specified event data store
get_channel Returns information about a specific channel
get_event_data_store Returns information about an event data store specified as either an ARN or the ID portion of the ARN
get_event_selectors Describes the settings for the event selectors that you configured for your trail
get_import Returns information about a specific import
get_insight_selectors Describes the settings for the Insights event selectors that you configured for your trail or event data store
get_query_results Gets event data results of a query
get_resource_policy Retrieves the JSON text of the resource-based policy document attached to the CloudTrail channel
get_trail Returns settings information for a specified trail
get_trail_status Returns a JSON-formatted list of information about the specified trail
list_channels Lists the channels in the current account, and their source names
list_event_data_stores Returns information about all event data stores in the account, in the current Region
list_import_failures Returns a list of failures for the specified import
list_imports Returns information on all imports, or a select set of imports by ImportStatus or Destination
list_insights_metric_data Returns Insights metrics data for trails that have enabled Insights
list_public_keys Returns all public keys whose private keys were used to sign the digest files within the specified time range
list_queries Returns a list of queries and query statuses for the past seven days
list_tags Lists the tags for the specified trails, event data stores, or channels in the current Region
list_trails Lists trails that are in the current account
lookup_events Looks up management events or CloudTrail Insights events that are captured by CloudTrail
put_event_selectors Configures an event selector or advanced event selectors for your trail
put_insight_selectors Lets you enable Insights event logging by specifying the Insights selectors that you want to enable on an existing trail or event data store
put_resource_policy Attaches a resource-based permission policy to a CloudTrail channel that is used for an integration with an event source outside of Amazon Web Services
register_organization_delegated_admin Registers an organization’s member account as the CloudTrail delegated administrator
remove_tags Removes the specified tags from a trail, event data store, or channel
restore_event_data_store Restores a deleted event data store specified by EventDataStore, which accepts an event data store ARN
start_event_data_store_ingestion Starts the ingestion of live events on an event data store specified as either an ARN or the ID portion of the ARN
start_import Starts an import of logged trail events from a source S3 bucket to a destination event data store
start_logging Starts the recording of Amazon Web Services API calls and log file delivery for a trail
start_query Starts a CloudTrail Lake query
stop_event_data_store_ingestion Stops the ingestion of live events on an event data store specified as either an ARN or the ID portion of the ARN
stop_import Stops a specified import
stop_logging Suspends the recording of Amazon Web Services API calls and log file delivery for the specified trail
update_channel Updates a channel specified by a required channel ARN or UUID
update_event_data_store Updates an event data store
update_trail Updates trail settings that control what events you are logging, and how to handle log files

Examples

## Not run: 
svc <- cloudtrail()
svc$add_tags(
  Foo = 123
)

## End(Not run)

AWS CloudTrail Data Service

Description

The CloudTrail Data Service lets you ingest events into CloudTrail from any source in your hybrid environments, such as in-house or SaaS applications hosted on-premises or in the cloud, virtual machines, or containers. You can store, access, analyze, troubleshoot and take action on this data without maintaining multiple log aggregators and reporting tools. After you run put_audit_events to ingest your application activity into CloudTrail, you can use CloudTrail Lake to search, query, and analyze the data that is logged from your applications.

Usage

cloudtraildataservice(
  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 <- cloudtraildataservice(
  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

put_audit_events Ingests your application events into CloudTrail Lake

Examples

## Not run: 
svc <- cloudtraildataservice()
svc$put_audit_events(
  Foo = 123
)

## End(Not run)

Amazon CloudWatch

Description

Amazon CloudWatch monitors your Amazon Web Services (Amazon Web Services) resources and the applications you run on Amazon Web Services in real time. You can use CloudWatch to collect and track metrics, which are the variables you want to measure for your resources and applications.

CloudWatch alarms send notifications or automatically change the resources you are monitoring based on rules that you define. For example, you can monitor the CPU usage and disk reads and writes of your Amazon EC2 instances. Then, use this data to determine whether you should launch additional instances to handle increased load. You can also use this data to stop under-used instances to save money.

In addition to monitoring the built-in metrics that come with Amazon Web Services, you can monitor your own custom metrics. With CloudWatch, you gain system-wide visibility into resource utilization, application performance, and operational health.

Usage

cloudwatch(
  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 <- cloudwatch(
  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

delete_alarms Deletes the specified alarms
delete_anomaly_detector Deletes the specified anomaly detection model from your account
delete_dashboards Deletes all dashboards that you specify
delete_insight_rules Permanently deletes the specified Contributor Insights rules
delete_metric_stream Permanently deletes the metric stream that you specify
describe_alarm_history Retrieves the history for the specified alarm
describe_alarms Retrieves the specified alarms
describe_alarms_for_metric Retrieves the alarms for the specified metric
describe_anomaly_detectors Lists the anomaly detection models that you have created in your account
describe_insight_rules Returns a list of all the Contributor Insights rules in your account
disable_alarm_actions Disables the actions for the specified alarms
disable_insight_rules Disables the specified Contributor Insights rules
enable_alarm_actions Enables the actions for the specified alarms
enable_insight_rules Enables the specified Contributor Insights rules
get_dashboard Displays the details of the dashboard that you specify
get_insight_rule_report This operation returns the time series data collected by a Contributor Insights rule
get_metric_data You can use the GetMetricData API to retrieve CloudWatch metric values
get_metric_statistics Gets statistics for the specified metric
get_metric_stream Returns information about the metric stream that you specify
get_metric_widget_image You can use the GetMetricWidgetImage API to retrieve a snapshot graph of one or more Amazon CloudWatch metrics as a bitmap image
list_dashboards Returns a list of the dashboards for your account
list_managed_insight_rules Returns a list that contains the number of managed Contributor Insights rules in your account
list_metrics List the specified metrics
list_metric_streams Returns a list of metric streams in this account
list_tags_for_resource Displays the tags associated with a CloudWatch resource
put_anomaly_detector Creates an anomaly detection model for a CloudWatch metric
put_composite_alarm Creates or updates a composite alarm
put_dashboard Creates a dashboard if it does not already exist, or updates an existing dashboard
put_insight_rule Creates a Contributor Insights rule
put_managed_insight_rules Creates a managed Contributor Insights rule for a specified Amazon Web Services resource
put_metric_alarm Creates or updates an alarm and associates it with the specified metric, metric math expression, anomaly detection model, or Metrics Insights query
put_metric_data Publishes metric data points to Amazon CloudWatch
put_metric_stream Creates or updates a metric stream
set_alarm_state Temporarily sets the state of an alarm for testing purposes
start_metric_streams Starts the streaming of metrics for one or more of your metric streams
stop_metric_streams Stops the streaming of metrics for one or more of your metric streams
tag_resource Assigns one or more tags (key-value pairs) to the specified CloudWatch resource
untag_resource Removes one or more tags from the specified resource

Examples

## Not run: 
svc <- cloudwatch()
svc$delete_alarms(
  Foo = 123
)

## End(Not run)

Amazon CloudWatch Events

Description

Amazon EventBridge helps you to respond to state changes in your Amazon Web Services resources. When your resources change state, they automatically send events to an event stream. You can create rules that match selected events in the stream and route them to targets to take action. You can also use rules to take action on a predetermined schedule. For example, you can configure rules to:

  • Automatically invoke an Lambda function to update DNS entries when an event notifies you that Amazon EC2 instance enters the running state.

  • Direct specific API records from CloudTrail to an Amazon Kinesis data stream for detailed analysis of potential security or availability risks.

  • Periodically invoke a built-in target to create a snapshot of an Amazon EBS volume.

For more information about the features of Amazon EventBridge, see the Amazon EventBridge User Guide.

Usage

cloudwatchevents(
  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 <- cloudwatchevents(
  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

activate_event_source Activates a partner event source that has been deactivated
cancel_replay Cancels the specified replay
create_api_destination Creates an API destination, which is an HTTP invocation endpoint configured as a target for events
create_archive Creates an archive of events with the specified settings
create_connection Creates a connection
create_event_bus Creates a new event bus within your account
create_partner_event_source Called by an SaaS partner to create a partner event source
deactivate_event_source You can use this operation to temporarily stop receiving events from the specified partner event source
deauthorize_connection Removes all authorization parameters from the connection
delete_api_destination Deletes the specified API destination
delete_archive Deletes the specified archive
delete_connection Deletes a connection
delete_event_bus Deletes the specified custom event bus or partner event bus
delete_partner_event_source This operation is used by SaaS partners to delete a partner event source
delete_rule Deletes the specified rule
describe_api_destination Retrieves details about an API destination
describe_archive Retrieves details about an archive
describe_connection Retrieves details about a connection
describe_event_bus Displays details about an event bus in your account
describe_event_source This operation lists details about a partner event source that is shared with your account
describe_partner_event_source An SaaS partner can use this operation to list details about a partner event source that they have created
describe_replay Retrieves details about a replay
describe_rule Describes the specified rule
disable_rule Disables the specified rule
enable_rule Enables the specified rule
list_api_destinations Retrieves a list of API destination in the account in the current Region
list_archives Lists your archives
list_connections Retrieves a list of connections from the account
list_event_buses Lists all the event buses in your account, including the default event bus, custom event buses, and partner event buses
list_event_sources You can use this to see all the partner event sources that have been shared with your Amazon Web Services account
list_partner_event_source_accounts An SaaS partner can use this operation to display the Amazon Web Services account ID that a particular partner event source name is associated with
list_partner_event_sources An SaaS partner can use this operation to list all the partner event source names that they have created
list_replays Lists your replays
list_rule_names_by_target Lists the rules for the specified target
list_rules Lists your Amazon EventBridge rules
list_tags_for_resource Displays the tags associated with an EventBridge resource
list_targets_by_rule Lists the targets assigned to the specified rule
put_events Sends custom events to Amazon EventBridge so that they can be matched to rules
put_partner_events This is used by SaaS partners to write events to a customer's partner event bus
put_permission Running PutPermission permits the specified Amazon Web Services account or Amazon Web Services organization to put events to the specified event bus
put_rule Creates or updates the specified rule
put_targets Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule
remove_permission Revokes the permission of another Amazon Web Services account to be able to put events to the specified event bus
remove_targets Removes the specified targets from the specified rule
start_replay Starts the specified replay
tag_resource Assigns one or more tags (key-value pairs) to the specified EventBridge resource
test_event_pattern Tests whether the specified event pattern matches the provided event
untag_resource Removes one or more tags from the specified EventBridge resource
update_api_destination Updates an API destination
update_archive Updates the specified archive
update_connection Updates settings for a connection

Examples

## Not run: 
svc <- cloudwatchevents()
svc$activate_event_source(
  Foo = 123
)

## End(Not run)

Amazon CloudWatch Evidently

Description

You can use Amazon CloudWatch Evidently to safely validate new features by serving them to a specified percentage of your users while you roll out the feature. You can monitor the performance of the new feature to help you decide when to ramp up traffic to your users. This helps you reduce risk and identify unintended consequences before you fully launch the feature.

You can also conduct A/B experiments to make feature design decisions based on evidence and data. An experiment can test as many as five variations at once. Evidently collects experiment data and analyzes it using statistical methods. It also provides clear recommendations about which variations perform better. You can test both user-facing features and backend features.

Usage

cloudwatchevidently(
  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 <- cloudwatchevidently(
  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

batch_evaluate_feature This operation assigns feature variation to user sessions
create_experiment Creates an Evidently experiment
create_feature Creates an Evidently feature that you want to launch or test
create_launch Creates a launch of a given feature
create_project Creates a project, which is the logical object in Evidently that can contain features, launches, and experiments
create_segment Use this operation to define a segment of your audience
delete_experiment Deletes an Evidently experiment
delete_feature Deletes an Evidently feature
delete_launch Deletes an Evidently launch
delete_project Deletes an Evidently project
delete_segment Deletes a segment
evaluate_feature This operation assigns a feature variation to one given user session
get_experiment Returns the details about one experiment
get_experiment_results Retrieves the results of a running or completed experiment
get_feature Returns the details about one feature
get_launch Returns the details about one launch
get_project Returns the details about one launch
get_segment Returns information about the specified segment
list_experiments Returns configuration details about all the experiments in the specified project
list_features Returns configuration details about all the features in the specified project
list_launches Returns configuration details about all the launches in the specified project
list_projects Returns configuration details about all the projects in the current Region in your account
list_segment_references Use this operation to find which experiments or launches are using a specified segment
list_segments Returns a list of audience segments that you have created in your account in this Region
list_tags_for_resource Displays the tags associated with an Evidently resource
put_project_events Sends performance events to Evidently
start_experiment Starts an existing experiment
start_launch Starts an existing launch
stop_experiment Stops an experiment that is currently running
stop_launch Stops a launch that is currently running
tag_resource Assigns one or more tags (key-value pairs) to the specified CloudWatch Evidently resource
test_segment_pattern Use this operation to test a rules pattern that you plan to use to create an audience segment
untag_resource Removes one or more tags from the specified resource
update_experiment Updates an Evidently experiment
update_feature Updates an existing feature
update_launch Updates a launch of a given feature
update_project Updates the description of an existing project
update_project_data_delivery Updates the data storage options for this project

Examples

## Not run: 
svc <- cloudwatchevidently()
svc$batch_evaluate_feature(
  Foo = 123
)

## End(Not run)

Amazon CloudWatch Internet Monitor

Description

Amazon CloudWatch Internet Monitor provides visibility into how internet issues impact the performance and availability between your applications hosted on Amazon Web Services and your end users. It can reduce the time it takes for you to diagnose internet issues from days to minutes. Internet Monitor uses the connectivity data that Amazon Web Services captures from its global networking footprint to calculate a baseline of performance and availability for internet traffic. This is the same data that Amazon Web Services uses to monitor internet uptime and availability. With those measurements as a baseline, Internet Monitor raises awareness for you when there are significant problems for your end users in the different geographic locations where your application runs.

Internet Monitor publishes internet measurements to CloudWatch Logs and CloudWatch Metrics, to easily support using CloudWatch tools with health information for geographies and networks specific to your application. Internet Monitor sends health events to Amazon EventBridge so that you can set up notifications. If an issue is caused by the Amazon Web Services network, you also automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem.

To use Internet Monitor, you create a monitor and associate your application's resources with it - VPCs, NLBs, CloudFront distributions, or WorkSpaces directories - so Internet Monitor can determine where your application's internet traffic is. Internet Monitor then provides internet measurements from Amazon Web Services that are specific to the locations and ASNs (typically, internet service providers or ISPs) that communicate with your application.

For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.

Usage

cloudwatchinternetmonitor(
  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 <- cloudwatchinternetmonitor(
  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

create_monitor Creates a monitor in Amazon CloudWatch Internet Monitor
delete_monitor Deletes a monitor in Amazon CloudWatch Internet Monitor
get_health_event Gets information that Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor
get_internet_event Gets information that Amazon CloudWatch Internet Monitor has generated about an internet event
get_monitor Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name
get_query_results Return the data for a query with the Amazon CloudWatch Internet Monitor query interface
get_query_status Returns the current status of a query for the Amazon CloudWatch Internet Monitor query interface, for a specified query ID and monitor
list_health_events Lists all health events for a monitor in Amazon CloudWatch Internet Monitor
list_internet_events Lists internet events that cause performance or availability issues for client locations
list_monitors Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor
list_tags_for_resource Lists the tags for a resource
start_query Start a query to return data for a specific query type for the Amazon CloudWatch Internet Monitor query interface
stop_query Stop a query that is progress for a specific monitor
tag_resource Adds a tag to a resource
untag_resource Removes a tag from a resource
update_monitor Updates a monitor

Examples

## Not run: 
svc <- cloudwatchinternetmonitor()
svc$create_monitor(
  Foo = 123
)

## End(Not run)

Amazon CloudWatch Logs

Description

You can use Amazon CloudWatch Logs to monitor, store, and access your log files from EC2 instances, CloudTrail, and other sources. You can then retrieve the associated log data from CloudWatch Logs using the CloudWatch console. Alternatively, you can use CloudWatch Logs commands in the Amazon Web Services CLI, CloudWatch Logs API, or CloudWatch Logs SDK.

You can use CloudWatch Logs to:

  • Monitor logs from EC2 instances in real time: You can use CloudWatch Logs to monitor applications and systems using log data. For example, CloudWatch Logs can track the number of errors that occur in your application logs. Then, it can send you a notification whenever the rate of errors exceeds a threshold that you specify. CloudWatch Logs uses your log data for monitoring so no code changes are required. For example, you can monitor application logs for specific literal terms (such as "NullReferenceException"). You can also count the number of occurrences of a literal term at a particular position in log data (such as "404" status codes in an Apache access log). When the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch metric that you specify.

  • Monitor CloudTrail logged events: You can create alarms in CloudWatch and receive notifications of particular API activity as captured by CloudTrail. You can use the notification to perform troubleshooting.

  • Archive log data: You can use CloudWatch Logs to store your log data in highly durable storage. You can change the log retention setting so that any log events earlier than this setting are automatically deleted. The CloudWatch Logs agent helps to quickly send both rotated and non-rotated log data off of a host and into the log service. You can then access the raw log data when you need it.

Usage

cloudwatchlogs(
  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 <- cloudwatchlogs(
  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

associate_kms_key Associates the specified KMS key with either one log group in the account, or with all stored CloudWatch Logs query insights results in the account
cancel_export_task Cancels the specified export task
create_delivery Creates a delivery
create_export_task Creates an export task so that you can efficiently export data from a log group to an Amazon S3 bucket
create_log_anomaly_detector Creates an anomaly detector that regularly scans one or more log groups and look for patterns and anomalies in the logs
create_log_group Creates a log group with the specified name
create_log_stream Creates a log stream for the specified log group
delete_account_policy Deletes a CloudWatch Logs account policy
delete_data_protection_policy Deletes the data protection policy from the specified log group
delete_delivery Deletes s delivery
delete_delivery_destination Deletes a delivery destination
delete_delivery_destination_policy Deletes a delivery destination policy
delete_delivery_source Deletes a delivery source
delete_destination Deletes the specified destination, and eventually disables all the subscription filters that publish to it
delete_log_anomaly_detector Deletes the specified CloudWatch Logs anomaly detector
delete_log_group Deletes the specified log group and permanently deletes all the archived log events associated with the log group
delete_log_stream Deletes the specified log stream and permanently deletes all the archived log events associated with the log stream
delete_metric_filter Deletes the specified metric filter
delete_query_definition Deletes a saved CloudWatch Logs Insights query definition
delete_resource_policy Deletes a resource policy from this account
delete_retention_policy Deletes the specified retention policy
delete_subscription_filter Deletes the specified subscription filter
describe_account_policies Returns a list of all CloudWatch Logs account policies in the account
describe_deliveries Retrieves a list of the deliveries that have been created in the account
describe_delivery_destinations Retrieves a list of the delivery destinations that have been created in the account
describe_delivery_sources Retrieves a list of the delivery sources that have been created in the account
describe_destinations Lists all your destinations
describe_export_tasks Lists the specified export tasks
describe_log_groups Lists the specified log groups
describe_log_streams Lists the log streams for the specified log group
describe_metric_filters Lists the specified metric filters
describe_queries Returns a list of CloudWatch Logs Insights queries that are scheduled, running, or have been run recently in this account
describe_query_definitions This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions
describe_resource_policies Lists the resource policies in this account
describe_subscription_filters Lists the subscription filters for the specified log group
disassociate_kms_key Disassociates the specified KMS key from the specified log group or from all CloudWatch Logs Insights query results in the account
filter_log_events Lists log events from the specified log group
get_data_protection_policy Returns information about a log group data protection policy
get_delivery Returns complete information about one logical delivery
get_delivery_destination Retrieves complete information about one delivery destination
get_delivery_destination_policy Retrieves the delivery destination policy assigned to the delivery destination that you specify
get_delivery_source Retrieves complete information about one delivery source
get_log_anomaly_detector Retrieves information about the log anomaly detector that you specify
get_log_events Lists log events from the specified log stream
get_log_group_fields Returns a list of the fields that are included in log events in the specified log group
get_log_record Retrieves all of the fields and values of a single log event
get_query_results Returns the results from the specified query
list_anomalies Returns a list of anomalies that log anomaly detectors have found
list_log_anomaly_detectors Retrieves a list of the log anomaly detectors in the account
list_tags_for_resource Displays the tags associated with a CloudWatch Logs resource
list_tags_log_group The ListTagsLogGroup operation is on the path to deprecation
put_account_policy Creates an account-level data protection policy or subscription filter policy that applies to all log groups or a subset of log groups in the account
put_data_protection_policy Creates a data protection policy for the specified log group
put_delivery_destination Creates or updates a logical delivery destination
put_delivery_destination_policy Creates and assigns an IAM policy that grants permissions to CloudWatch Logs to deliver logs cross-account to a specified destination in this account
put_delivery_source Creates or updates a logical delivery source
put_destination Creates or updates a destination
put_destination_policy Creates or updates an access policy associated with an existing destination
put_log_events Uploads a batch of log events to the specified log stream
put_metric_filter Creates or updates a metric filter and associates it with the specified log group
put_query_definition Creates or updates a query definition for CloudWatch Logs Insights
put_resource_policy Creates or updates a resource policy allowing other Amazon Web Services services to put log events to this account, such as Amazon Route 53
put_retention_policy Sets the retention of the specified log group
put_subscription_filter Creates or updates a subscription filter and associates it with the specified log group
start_live_tail Starts a Live Tail streaming session for one or more log groups
start_query Schedules a query of a log group using CloudWatch Logs Insights
stop_query Stops a CloudWatch Logs Insights query that is in progress
tag_log_group The TagLogGroup operation is on the path to deprecation
tag_resource Assigns one or more tags (key-value pairs) to the specified CloudWatch Logs resource
test_metric_filter Tests the filter pattern of a metric filter against a sample of log event messages
untag_log_group The UntagLogGroup operation is on the path to deprecation
untag_resource Removes one or more tags from the specified resource
update_anomaly Use this operation to suppress anomaly detection for a specified anomaly or pattern
update_log_anomaly_detector Updates an existing log anomaly detector

Examples

## Not run: 
svc <- cloudwatchlogs()
svc$associate_kms_key(
  Foo = 123
)

## End(Not run)

CloudWatch Observability Access Manager

Description

Use Amazon CloudWatch Observability Access Manager to create and manage links between source accounts and monitoring accounts by using CloudWatch cross-account observability. With CloudWatch cross-account observability, you can monitor and troubleshoot applications that span multiple accounts within a Region. Seamlessly search, visualize, and analyze your metrics, logs, traces, and Application Insights applications in any of the linked accounts without account boundaries.

Set up one or more Amazon Web Services accounts as monitoring accounts and link them with multiple source accounts. A monitoring account is a central Amazon Web Services account that can view and interact with observability data generated from source accounts. A source account is an individual Amazon Web Services account that generates observability data for the resources that reside in it. Source accounts share their observability data with the monitoring account. The shared observability data can include metrics in Amazon CloudWatch, logs in Amazon CloudWatch Logs, traces in X-Ray, and applications in Amazon CloudWatch Application Insights.

Usage

cloudwatchobservabilityaccessmanager(
  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 <- cloudwatchobservabilityaccessmanager(
  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

create_link Creates a link between a source account and a sink that you have created in a monitoring account
create_sink Use this to create a sink in the current account, so that it can be used as a monitoring account in CloudWatch cross-account observability
delete_link Deletes a link between a monitoring account sink and a source account
delete_sink Deletes a sink
get_link Returns complete information about one link
get_sink Returns complete information about one monitoring account sink
get_sink_policy Returns the current sink policy attached to this sink
list_attached_links Returns a list of source account links that are linked to this monitoring account sink
list_links Use this operation in a source account to return a list of links to monitoring account sinks that this source account has
list_sinks Use this operation in a monitoring account to return the list of sinks created in that account
list_tags_for_resource Displays the tags associated with a resource
put_sink_policy Creates or updates the resource policy that grants permissions to source accounts to link to the monitoring account sink
tag_resource Assigns one or more tags (key-value pairs) to the specified resource
untag_resource Removes one or more tags from the specified resource
update_link Use this operation to change what types of data are shared from a source account to its linked monitoring account sink

Examples

## Not run: 
svc <- cloudwatchobservabilityaccessmanager()
svc$create_link(
  Foo = 123
)

## End(Not run)

CloudWatch RUM

Description

With Amazon CloudWatch RUM, you can perform real-user monitoring to collect client-side data about your web application performance from actual user sessions in real time. The data collected includes page load times, client-side errors, and user behavior. When you view this data, you can see it all aggregated together and also see breakdowns by the browsers and devices that your customers use.

You can use the collected data to quickly identify and debug client-side performance issues. CloudWatch RUM helps you visualize anomalies in your application performance and find relevant debugging data such as error messages, stack traces, and user sessions. You can also use RUM to understand the range of end-user impact including the number of users, geolocations, and browsers used.

Usage

cloudwatchrum(
  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 <- cloudwatchrum(
  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

batch_create_rum_metric_definitions Specifies the extended metrics and custom metrics that you want a CloudWatch RUM app monitor to send to a destination
batch_delete_rum_metric_definitions Removes the specified metrics from being sent to an extended metrics destination
batch_get_rum_metric_definitions Retrieves the list of metrics and dimensions that a RUM app monitor is sending to a single destination
create_app_monitor Creates a Amazon CloudWatch RUM app monitor, which collects telemetry data from your application and sends that data to RUM
delete_app_monitor Deletes an existing app monitor
delete_rum_metrics_destination Deletes a destination for CloudWatch RUM extended metrics, so that the specified app monitor stops sending extended metrics to that destination
get_app_monitor Retrieves the complete configuration information for one app monitor
get_app_monitor_data Retrieves the raw performance events that RUM has collected from your web application, so that you can do your own processing or analysis of this data
list_app_monitors Returns a list of the Amazon CloudWatch RUM app monitors in the account
list_rum_metrics_destinations Returns a list of destinations that you have created to receive RUM extended metrics, for the specified app monitor
list_tags_for_resource Displays the tags associated with a CloudWatch RUM resource
put_rum_events Sends telemetry events about your application performance and user behavior to CloudWatch RUM
put_rum_metrics_destination Creates or updates a destination to receive extended metrics from CloudWatch RUM
tag_resource Assigns one or more tags (key-value pairs) to the specified CloudWatch RUM resource
untag_resource Removes one or more tags from the specified resource
update_app_monitor Updates the configuration of an existing app monitor
update_rum_metric_definition Modifies one existing metric definition for CloudWatch RUM extended metrics

Examples

## Not run: 
svc <- cloudwatchrum()
svc$batch_create_rum_metric_definitions(
  Foo = 123
)

## End(Not run)

CodeArtifact

Description

CodeArtifact is a fully managed artifact repository compatible with language-native package managers and build tools such as npm, Apache Maven, pip, and dotnet. You can use CodeArtifact to share packages with development teams and pull packages. Packages can be pulled from both public and CodeArtifact repositories. You can also create an upstream relationship between a CodeArtifact repository and another repository, which effectively merges their contents from the point of view of a package manager client.

CodeArtifact concepts

  • Repository: A CodeArtifact repository contains a set of package versions, each of which maps to a set of assets, or files. Repositories are polyglot, so a single repository can contain packages of any supported type. Each repository exposes endpoints for fetching and publishing packages using tools such as the npm CLI or the Maven CLI ( mvn ). For a list of supported package managers, see the CodeArtifact User Guide.

  • Domain: Repositories are aggregated into a higher-level entity known as a domain. All package assets and metadata are stored in the domain, but are consumed through repositories. A given package asset, such as a Maven JAR file, is stored once per domain, no matter how many repositories it's present in. All of the assets and metadata in a domain are encrypted with the same customer master key (CMK) stored in Key Management Service (KMS).

    Each repository is a member of a single domain and can't be moved to a different domain.

    The domain allows organizational policy to be applied across multiple repositories, such as which accounts can access repositories in the domain, and which public repositories can be used as sources of packages.

    Although an organization can have multiple domains, we recommend a single production domain that contains all published artifacts so that teams can find and share packages across their organization.

  • Package: A package is a bundle of software and the metadata required to resolve dependencies and install the software. CodeArtifact supports npm, PyPI, Maven, NuGet, Swift, Ruby, Cargo, and generic package formats. For more information about the supported package formats and how to use CodeArtifact with them, see the CodeArtifact User Guide.

    In CodeArtifact, a package consists of:

    • A name (for example, webpack is the name of a popular npm package)

    • An optional namespace (for example, ⁠@types⁠ in ⁠@types/node⁠)

    • A set of versions (for example, ⁠1.0.0⁠, ⁠1.0.1⁠, ⁠1.0.2⁠, etc.)

    • Package-level metadata (for example, npm tags)

  • Package group: A group of packages that match a specified definition. Package groups can be used to apply configuration to multiple packages that match a defined pattern using package format, package namespace, and package name. You can use package groups to more conveniently configure package origin controls for multiple packages. Package origin controls are used to block or allow ingestion or publishing of new package versions, which protects users from malicious actions known as dependency substitution attacks.

  • Package version: A version of a package, such as ⁠@types/node 12.6.9⁠. The version number format and semantics vary for different package formats. For example, npm package versions must conform to the Semantic Versioning specification. In CodeArtifact, a package version consists of the version identifier, metadata at the package version level, and a set of assets.

  • Upstream repository: One repository is upstream of another when the package versions in it can be accessed from the repository endpoint of the downstream repository, effectively merging the contents of the two repositories from the point of view of a client. CodeArtifact allows creating an upstream relationship between two repositories.

  • Asset: An individual file stored in CodeArtifact associated with a package version, such as an npm .tgz file or Maven POM and JAR files.

CodeArtifact supported API operations

  • associate_external_connection: Adds an existing external connection to a repository.

  • copy_package_versions: Copies package versions from one repository to another repository in the same domain.

  • create_domain: Creates a domain.

  • create_package_group: Creates a package group.

  • create_repository: Creates a CodeArtifact repository in a domain.

  • delete_domain: Deletes a domain. You cannot delete a domain that contains repositories.

  • delete_domain_permissions_policy: Deletes the resource policy that is set on a domain.

  • delete_package: Deletes a package and all associated package versions.

  • delete_package_group: Deletes a package group. Does not delete packages or package versions that are associated with a package group.

  • delete_package_versions: Deletes versions of a package. After a package has been deleted, it can be republished, but its assets and metadata cannot be restored because they have been permanently removed from storage.

  • delete_repository: Deletes a repository.

  • delete_repository_permissions_policy: Deletes the resource policy that is set on a repository.

  • describe_domain: Returns a DomainDescription object that contains information about the requested domain.

  • describe_package: Returns a PackageDescription object that contains details about a package.

  • describe_package_group: Returns a PackageGroup object that contains details about a package group.

  • describe_package_version: Returns a PackageVersionDescription object that contains details about a package version.

  • describe_repository: Returns a RepositoryDescription object that contains detailed information about the requested repository.

  • dispose_package_versions: Disposes versions of a package. A package version with the status Disposed cannot be restored because they have been permanently removed from storage.

  • disassociate_external_connection: Removes an existing external connection from a repository.

  • get_associated_package_group: Returns the most closely associated package group to the specified package.

  • get_authorization_token: Generates a temporary authorization token for accessing repositories in the domain. The token expires the authorization period has passed. The default authorization period is 12 hours and can be customized to any length with a maximum of 12 hours.

  • get_domain_permissions_policy: Returns the policy of a resource that is attached to the specified domain.

  • get_package_version_asset: Returns the contents of an asset that is in a package version.

  • get_package_version_readme: Gets the readme file or descriptive text for a package version.

  • get_repository_endpoint: Returns the endpoint of a repository for a specific package format. A repository has one endpoint for each package format:

    • cargo

    • generic

    • maven

    • npm

    • nuget

    • pypi

    • ruby

    • swift

  • get_repository_permissions_policy: Returns the resource policy that is set on a repository.

  • list_allowed_repositories_for_group: Lists the allowed repositories for a package group that has origin configuration set to ALLOW_SPECIFIC_REPOSITORIES.

  • list_associated_packages: Returns a list of packages associated with the requested package group.

  • list_domains: Returns a list of DomainSummary objects. Each returned DomainSummary object contains information about a domain.

  • list_packages: Lists the packages in a repository.

  • list_package_groups: Returns a list of package groups in the requested domain.

  • list_package_version_assets: Lists the assets for a given package version.

  • list_package_version_dependencies: Returns a list of the direct dependencies for a package version.

  • list_package_versions: Returns a list of package versions for a specified package in a repository.

  • list_repositories: Returns a list of repositories owned by the Amazon Web Services account that called this method.

  • list_repositories_in_domain: Returns a list of the repositories in a domain.

  • list_sub_package_groups: Returns a list of direct children of the specified package group.

  • publish_package_version: Creates a new package version containing one or more assets.

  • put_domain_permissions_policy: Attaches a resource policy to a domain.

  • put_package_origin_configuration: Sets the package origin configuration for a package, which determine how new versions of the package can be added to a specific repository.

  • put_repository_permissions_policy: Sets the resource policy on a repository that specifies permissions to access it.

  • update_package_group: Updates a package group. This API cannot be used to update a package group's origin configuration or pattern.

  • update_package_group_origin_configuration: Updates the package origin configuration for a package group.

  • update_package_versions_status: Updates the status of one or more versions of a package.

  • update_repository: Updates the properties of a repository.

Usage

codeartifact(
  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 <- codeartifact(
  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

associate_external_connection Adds an existing external connection to a repository
copy_package_versions Copies package versions from one repository to another repository in the same domain
create_domain Creates a domain
create_package_group Creates a package group
create_repository Creates a repository
delete_domain Deletes a domain
delete_domain_permissions_policy Deletes the resource policy set on a domain
delete_package Deletes a package and all associated package versions
delete_package_group Deletes a package group
delete_package_versions Deletes one or more versions of a package
delete_repository Deletes a repository
delete_repository_permissions_policy Deletes the resource policy that is set on a repository
describe_domain Returns a DomainDescription object that contains information about the requested domain
describe_package Returns a PackageDescription object that contains information about the requested package
describe_package_group Returns a PackageGroupDescription object that contains information about the requested package group
describe_package_version Returns a PackageVersionDescription object that contains information about the requested package version
describe_repository Returns a RepositoryDescription object that contains detailed information about the requested repository
disassociate_external_connection Removes an existing external connection from a repository
dispose_package_versions Deletes the assets in package versions and sets the package versions' status to Disposed
get_associated_package_group Returns the most closely associated package group to the specified package
get_authorization_token Generates a temporary authorization token for accessing repositories in the domain
get_domain_permissions_policy Returns the resource policy attached to the specified domain
get_package_version_asset Returns an asset (or file) that is in a package
get_package_version_readme Gets the readme file or descriptive text for a package version
get_repository_endpoint Returns the endpoint of a repository for a specific package format
get_repository_permissions_policy Returns the resource policy that is set on a repository
list_allowed_repositories_for_group Lists the repositories in the added repositories list of the specified restriction type for a package group
list_associated_packages Returns a list of packages associated with the requested package group
list_domains Returns a list of DomainSummary objects for all domains owned by the Amazon Web Services account that makes this call
list_package_groups Returns a list of package groups in the requested domain
list_packages Returns a list of PackageSummary objects for packages in a repository that match the request parameters
list_package_version_assets Returns a list of AssetSummary objects for assets in a package version
list_package_version_dependencies Returns the direct dependencies for a package version
list_package_versions Returns a list of PackageVersionSummary objects for package versions in a repository that match the request parameters
list_repositories Returns a list of RepositorySummary objects
list_repositories_in_domain Returns a list of RepositorySummary objects
list_sub_package_groups Returns a list of direct children of the specified package group
list_tags_for_resource Gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in CodeArtifact
publish_package_version Creates a new package version containing one or more assets (or files)
put_domain_permissions_policy Sets a resource policy on a domain that specifies permissions to access it
put_package_origin_configuration Sets the package origin configuration for a package
put_repository_permissions_policy Sets the resource policy on a repository that specifies permissions to access it
tag_resource Adds or updates tags for a resource in CodeArtifact
untag_resource Removes tags from a resource in CodeArtifact
update_package_group Updates a package group
update_package_group_origin_configuration Updates the package origin configuration for a package group
update_package_versions_status Updates the status of one or more versions of a package
update_repository Update the properties of a repository

Examples

## Not run: 
svc <- codeartifact()
svc$associate_external_connection(
  Foo = 123
)

## End(Not run)

AWS CodeBuild

Description

CodeBuild

CodeBuild is a fully managed build service in the cloud. CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy. CodeBuild eliminates the need to provision, manage, and scale your own build servers. It provides prepackaged build environments for the most popular programming languages and build tools, such as Apache Maven, Gradle, and more. You can also fully customize build environments in CodeBuild to use your own build tools. CodeBuild scales automatically to meet peak build requests. You pay only for the build time you consume. For more information about CodeBuild, see the CodeBuildUser Guide.

Usage

codebuild(
  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 <- codebuild(
  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

batch_delete_builds Deletes one or more builds
batch_get_build_batches Retrieves information about one or more batch builds
batch_get_builds Gets information about one or more builds
batch_get_fleets Gets information about one or more compute fleets
batch_get_projects Gets information about one or more build projects
batch_get_report_groups Returns an array of report groups
batch_get_reports Returns an array of reports
create_fleet Creates a compute fleet
create_project Creates a build project
create_report_group Creates a report group
create_webhook For an existing CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, enables CodeBuild to start rebuilding the source code every time a code change is pushed to the repository
delete_build_batch Deletes a batch build
delete_fleet Deletes a compute fleet
delete_project Deletes a build project
delete_report Deletes a report
delete_report_group Deletes a report group
delete_resource_policy Deletes a resource policy that is identified by its resource ARN
delete_source_credentials Deletes a set of GitHub, GitHub Enterprise, or Bitbucket source credentials
delete_webhook For an existing CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, stops CodeBuild from rebuilding the source code every time a code change is pushed to the repository
describe_code_coverages Retrieves one or more code coverage reports
describe_test_cases Returns a list of details about test cases for a report
get_report_group_trend Analyzes and accumulates test report values for the specified test reports
get_resource_policy Gets a resource policy that is identified by its resource ARN
import_source_credentials Imports the source repository credentials for an CodeBuild project that has its source code stored in a GitHub, GitHub Enterprise, GitLab, GitLab Self Managed, or Bitbucket repository
invalidate_project_cache Resets the cache for a project
list_build_batches Retrieves the identifiers of your build batches in the current region
list_build_batches_for_project Retrieves the identifiers of the build batches for a specific project
list_builds Gets a list of build IDs, with each build ID representing a single build
list_builds_for_project Gets a list of build identifiers for the specified build project, with each build identifier representing a single build
list_curated_environment_images Gets information about Docker images that are managed by CodeBuild
list_fleets Gets a list of compute fleet names with each compute fleet name representing a single compute fleet
list_projects Gets a list of build project names, with each build project name representing a single build project
list_report_groups Gets a list ARNs for the report groups in the current Amazon Web Services account
list_reports Returns a list of ARNs for the reports in the current Amazon Web Services account
list_reports_for_report_group Returns a list of ARNs for the reports that belong to a ReportGroup
list_shared_projects Gets a list of projects that are shared with other Amazon Web Services accounts or users
list_shared_report_groups Gets a list of report groups that are shared with other Amazon Web Services accounts or users
list_source_credentials Returns a list of SourceCredentialsInfo objects
put_resource_policy Stores a resource policy for the ARN of a Project or ReportGroup object
retry_build Restarts a build
retry_build_batch Restarts a failed batch build
start_build Starts running a build with the settings defined in the project
start_build_batch Starts a batch build for a project
stop_build Attempts to stop running a build
stop_build_batch Stops a running batch build
update_fleet Updates a compute fleet
update_project Changes the settings of a build project
update_project_visibility Changes the public visibility for a project
update_report_group Updates a report group
update_webhook Updates the webhook associated with an CodeBuild build project

Examples

## Not run: 
svc <- codebuild()
svc$batch_delete_builds(
  Foo = 123
)

## End(Not run)

Amazon CodeCatalyst

Description

Welcome to the Amazon CodeCatalyst API reference. This reference provides descriptions of operations and data types for Amazon CodeCatalyst. You can use the Amazon CodeCatalyst API to work with the following objects.

Spaces, by calling the following:

  • delete_space, which deletes a space.

  • get_space, which returns information about a space.

  • get_subscription, which returns information about the Amazon Web Services account used for billing purposes and the billing plan for the space.

  • list_spaces, which retrieves a list of spaces.

  • update_space, which changes one or more values for a space.

Projects, by calling the following:

  • create_project which creates a project in a specified space.

  • get_project, which returns information about a project.

  • list_projects, which retrieves a list of projects in a space.

Users, by calling the following:

  • get_user_details, which returns information about a user in Amazon CodeCatalyst.

Source repositories, by calling the following:

  • create_source_repository, which creates an empty Git-based source repository in a specified project.

  • create_source_repository_branch, which creates a branch in a specified repository where you can work on code.

  • delete_source_repository, which deletes a source repository.

  • get_source_repository, which returns information about a source repository.

  • get_source_repository_clone_urls, which returns information about the URLs that can be used with a Git client to clone a source repository.

  • list_source_repositories, which retrieves a list of source repositories in a project.

  • list_source_repository_branches, which retrieves a list of branches in a source repository.

Dev Environments and the Amazon Web Services Toolkits, by calling the following:

  • create_dev_environment, which creates a Dev Environment, where you can quickly work on the code stored in the source repositories of your project.

  • delete_dev_environment, which deletes a Dev Environment.

  • get_dev_environment, which returns information about a Dev Environment.

  • list_dev_environments, which retrieves a list of Dev Environments in a project.

  • list_dev_environment_sessions, which retrieves a list of active Dev Environment sessions in a project.

  • start_dev_environment, which starts a specified Dev Environment and puts it into an active state.

  • start_dev_environment_session, which starts a session to a specified Dev Environment.

  • stop_dev_environment, which stops a specified Dev Environment and puts it into an stopped state.

  • stop_dev_environment_session, which stops a session for a specified Dev Environment.

  • update_dev_environment, which changes one or more values for a Dev Environment.

Workflows, by calling the following:

  • get_workflow, which returns information about a workflow.

  • get_workflow_run, which returns information about a specified run of a workflow.

  • list_workflow_runs, which retrieves a list of runs of a specified workflow.

  • list_workflows, which retrieves a list of workflows in a specified project.

  • start_workflow_run, which starts a run of a specified workflow.

Security, activity, and resource management in Amazon CodeCatalyst, by calling the following:

  • create_access_token, which creates a personal access token (PAT) for the current user.

  • delete_access_token, which deletes a specified personal access token (PAT).

  • list_access_tokens, which lists all personal access tokens (PATs) associated with a user.

  • list_event_logs, which retrieves a list of events that occurred during a specified time period in a space.

  • verify_session, which verifies whether the calling user has a valid Amazon CodeCatalyst login and session.

If you are using the Amazon CodeCatalyst APIs with an SDK or the CLI, you must configure your computer to work with Amazon CodeCatalyst and single sign-on (SSO). For more information, see Setting up to use the CLI with Amazon CodeCatalyst and the SSO documentation for your SDK.

Usage

codecatalyst(
  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 <- codecatalyst(
  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

create_access_token Creates a personal access token (PAT) for the current user
create_dev_environment Creates a Dev Environment in Amazon CodeCatalyst, a cloud-based development environment that you can use to quickly work on the code stored in the source repositories of your project
create_project Creates a project in a specified space
create_source_repository Creates an empty Git-based source repository in a specified project
create_source_repository_branch Creates a branch in a specified source repository in Amazon CodeCatalyst
delete_access_token Deletes a specified personal access token (PAT)
delete_dev_environment Deletes a Dev Environment
delete_project Deletes a project in a space
delete_source_repository Deletes a source repository in Amazon CodeCatalyst
delete_space Deletes a space
get_dev_environment Returns information about a Dev Environment for a source repository in a project
get_project Returns information about a project
get_source_repository Returns information about a source repository
get_source_repository_clone_urls Returns information about the URLs that can be used with a Git client to clone a source repository
get_space Returns information about an space
get_subscription Returns information about the Amazon Web Services account used for billing purposes and the billing plan for the space
get_user_details Returns information about a user
get_workflow Returns information about a workflow
get_workflow_run Returns information about a specified run of a workflow
list_access_tokens Lists all personal access tokens (PATs) associated with the user who calls the API
list_dev_environments Retrieves a list of Dev Environments in a project
list_dev_environment_sessions Retrieves a list of active sessions for a Dev Environment in a project
list_event_logs Retrieves a list of events that occurred during a specific time in a space
list_projects Retrieves a list of projects
list_source_repositories Retrieves a list of source repositories in a project
list_source_repository_branches Retrieves a list of branches in a specified source repository
list_spaces Retrieves a list of spaces
list_workflow_runs Retrieves a list of workflow runs of a specified workflow
list_workflows Retrieves a list of workflows in a specified project
start_dev_environment Starts a specified Dev Environment and puts it into an active state
start_dev_environment_session Starts a session for a specified Dev Environment
start_workflow_run Begins a run of a specified workflow
stop_dev_environment Pauses a specified Dev Environment and places it in a non-running state
stop_dev_environment_session Stops a session for a specified Dev Environment
update_dev_environment Changes one or more values for a Dev Environment
update_project Changes one or more values for a project
update_space Changes one or more values for a space
verify_session Verifies whether the calling user has a valid Amazon CodeCatalyst login and session

Examples

## Not run: 
svc <- codecatalyst()
svc$create_access_token(
  Foo = 123
)

## End(Not run)

AWS CodeCommit

Description

CodeCommit

This is the CodeCommit API Reference. This reference provides descriptions of the operations and data types for CodeCommit API along with usage examples.

You can use the CodeCommit API to work with the following objects:

Repositories, by calling the following:

  • batch_get_repositories, which returns information about one or more repositories associated with your Amazon Web Services account.

  • create_repository, which creates an CodeCommit repository.

  • delete_repository, which deletes an CodeCommit repository.

  • get_repository, which returns information about a specified repository.

  • list_repositories, which lists all CodeCommit repositories associated with your Amazon Web Services account.

  • update_repository_description, which sets or updates the description of the repository.

  • update_repository_encryption_key, which updates the Key Management Service encryption key used to encrypt and decrypt a repository.

  • update_repository_name, which changes the name of the repository. If you change the name of a repository, no other users of that repository can access it until you send them the new HTTPS or SSH URL to use.

Branches, by calling the following:

  • create_branch, which creates a branch in a specified repository.

  • delete_branch, which deletes the specified branch in a repository unless it is the default branch.

  • get_branch, which returns information about a specified branch.

  • list_branches, which lists all branches for a specified repository.

  • update_default_branch, which changes the default branch for a repository.

Files, by calling the following:

  • delete_file, which deletes the content of a specified file from a specified branch.

  • get_blob, which returns the base-64 encoded content of an individual Git blob object in a repository.

  • get_file, which returns the base-64 encoded content of a specified file.

  • get_folder, which returns the contents of a specified folder or directory.

  • list_file_commit_history, which retrieves a list of commits and changes to a specified file.

  • put_file, which adds or modifies a single file in a specified repository and branch.

Commits, by calling the following:

  • batch_get_commits, which returns information about one or more commits in a repository.

  • create_commit, which creates a commit for changes to a repository.

  • get_commit, which returns information about a commit, including commit messages and author and committer information.

  • get_differences, which returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID, or other fully qualified reference).

Merges, by calling the following:

  • batch_describe_merge_conflicts, which returns information about conflicts in a merge between commits in a repository.

  • create_unreferenced_merge_commit, which creates an unreferenced commit between two branches or commits for the purpose of comparing them and identifying any potential conflicts.

  • describe_merge_conflicts, which returns information about merge conflicts between the base, source, and destination versions of a file in a potential merge.

  • get_merge_commit, which returns information about the merge between a source and destination commit.

  • get_merge_conflicts, which returns information about merge conflicts between the source and destination branch in a pull request.

  • get_merge_options, which returns information about the available merge options between two branches or commit specifiers.

  • merge_branches_by_fast_forward, which merges two branches using the fast-forward merge option.

  • merge_branches_by_squash, which merges two branches using the squash merge option.

  • merge_branches_by_three_way, which merges two branches using the three-way merge option.

Pull requests, by calling the following:

  • create_pull_request, which creates a pull request in a specified repository.

  • create_pull_request_approval_rule, which creates an approval rule for a specified pull request.

  • delete_pull_request_approval_rule, which deletes an approval rule for a specified pull request.

  • describe_pull_request_events, which returns information about one or more pull request events.

  • evaluate_pull_request_approval_rules, which evaluates whether a pull request has met all the conditions specified in its associated approval rules.

  • get_comments_for_pull_request, which returns information about comments on a specified pull request.

  • get_pull_request, which returns information about a specified pull request.

  • get_pull_request_approval_states, which returns information about the approval states for a specified pull request.

  • get_pull_request_override_state, which returns information about whether approval rules have been set aside (overriden) for a pull request, and if so, the Amazon Resource Name (ARN) of the user or identity that overrode the rules and their requirements for the pull request.

  • list_pull_requests, which lists all pull requests for a repository.

  • merge_pull_request_by_fast_forward, which merges the source destination branch of a pull request into the specified destination branch for that pull request using the fast-forward merge option.

  • merge_pull_request_by_squash, which merges the source destination branch of a pull request into the specified destination branch for that pull request using the squash merge option.

  • merge_pull_request_by_three_way, which merges the source destination branch of a pull request into the specified destination branch for that pull request using the three-way merge option.

  • override_pull_request_approval_rules, which sets aside all approval rule requirements for a pull request.

  • post_comment_for_pull_request, which posts a comment to a pull request at the specified line, file, or request.

  • update_pull_request_approval_rule_content, which updates the structure of an approval rule for a pull request.

  • update_pull_request_approval_state, which updates the state of an approval on a pull request.

  • update_pull_request_description, which updates the description of a pull request.

  • update_pull_request_status, which updates the status of a pull request.

  • update_pull_request_title, which updates the title of a pull request.

Approval rule templates, by calling the following:

  • associate_approval_rule_template_with_repository, which associates a template with a specified repository. After the template is associated with a repository, CodeCommit creates approval rules that match the template conditions on every pull request created in the specified repository.

  • batch_associate_approval_rule_template_with_repositories, which associates a template with one or more specified repositories. After the template is associated with a repository, CodeCommit creates approval rules that match the template conditions on every pull request created in the specified repositories.

  • batch_disassociate_approval_rule_template_from_repositories, which removes the association between a template and specified repositories so that approval rules based on the template are not automatically created when pull requests are created in those repositories.

  • create_approval_rule_template, which creates a template for approval rules that can then be associated with one or more repositories in your Amazon Web Services account.

  • delete_approval_rule_template, which deletes the specified template. It does not remove approval rules on pull requests already created with the template.

  • disassociate_approval_rule_template_from_repository, which removes the association between a template and a repository so that approval rules based on the template are not automatically created when pull requests are created in the specified repository.

  • get_approval_rule_template, which returns information about an approval rule template.

  • list_approval_rule_templates, which lists all approval rule templates in the Amazon Web Services Region in your Amazon Web Services account.

  • list_associated_approval_rule_templates_for_repository, which lists all approval rule templates that are associated with a specified repository.

  • list_repositories_for_approval_rule_template, which lists all repositories associated with the specified approval rule template.

  • update_approval_rule_template_description, which updates the description of an approval rule template.

  • update_approval_rule_template_name, which updates the name of an approval rule template.

  • update_approval_rule_template_content, which updates the content of an approval rule template.

Comments in a repository, by calling the following:

  • delete_comment_content, which deletes the content of a comment on a commit in a repository.

  • get_comment, which returns information about a comment on a commit.

  • get_comment_reactions, which returns information about emoji reactions to comments.

  • get_comments_for_compared_commit, which returns information about comments on the comparison between two commit specifiers in a repository.

  • post_comment_for_compared_commit, which creates a comment on the comparison between two commit specifiers in a repository.

  • post_comment_reply, which creates a reply to a comment.

  • put_comment_reaction, which creates or updates an emoji reaction to a comment.

  • update_comment, which updates the content of a comment on a commit in a repository.

Tags used to tag resources in CodeCommit (not Git tags), by calling the following:

  • list_tags_for_resource, which gets information about Amazon Web Servicestags for a specified Amazon Resource Name (ARN) in CodeCommit.

  • tag_resource, which adds or updates tags for a resource in CodeCommit.

  • untag_resource, which removes tags for a resource in CodeCommit.

Triggers, by calling the following:

  • get_repository_triggers, which returns information about triggers configured for a repository.

  • put_repository_triggers, which replaces all triggers for a repository and can be used to create or delete triggers.

  • test_repository_triggers, which tests the functionality of a repository trigger by sending data to the trigger target.

For information about how to use CodeCommit, see the CodeCommit User Guide.

Usage

codecommit(
  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 <- codecommit(
  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

associate_approval_rule_template_with_repository Creates an association between an approval rule template and a specified repository
batch_associate_approval_rule_template_with_repositories Creates an association between an approval rule template and one or more specified repositories
batch_describe_merge_conflicts Returns information about one or more merge conflicts in the attempted merge of two commit specifiers using the squash or three-way merge strategy
batch_disassociate_approval_rule_template_from_repositories Removes the association between an approval rule template and one or more specified repositories
batch_get_commits Returns information about the contents of one or more commits in a repository
batch_get_repositories Returns information about one or more repositories
create_approval_rule_template Creates a template for approval rules that can then be associated with one or more repositories in your Amazon Web Services account
create_branch Creates a branch in a repository and points the branch to a commit
create_commit Creates a commit for a repository on the tip of a specified branch
create_pull_request Creates a pull request in the specified repository
create_pull_request_approval_rule Creates an approval rule for a pull request
create_repository Creates a new, empty repository
create_unreferenced_merge_commit Creates an unreferenced commit that represents the result of merging two branches using a specified merge strategy
delete_approval_rule_template Deletes a specified approval rule template
delete_branch Deletes a branch from a repository, unless that branch is the default branch for the repository
delete_comment_content Deletes the content of a comment made on a change, file, or commit in a repository
delete_file Deletes a specified file from a specified branch
delete_pull_request_approval_rule Deletes an approval rule from a specified pull request
delete_repository Deletes a repository
describe_merge_conflicts Returns information about one or more merge conflicts in the attempted merge of two commit specifiers using the squash or three-way merge strategy
describe_pull_request_events Returns information about one or more pull request events
disassociate_approval_rule_template_from_repository Removes the association between a template and a repository so that approval rules based on the template are not automatically created when pull requests are created in the specified repository
evaluate_pull_request_approval_rules Evaluates whether a pull request has met all the conditions specified in its associated approval rules
get_approval_rule_template Returns information about a specified approval rule template
get_blob Returns the base-64 encoded content of an individual blob in a repository
get_branch Returns information about a repository branch, including its name and the last commit ID
get_comment Returns the content of a comment made on a change, file, or commit in a repository
get_comment_reactions Returns information about reactions to a specified comment ID
get_comments_for_compared_commit Returns information about comments made on the comparison between two commits
get_comments_for_pull_request Returns comments made on a pull request
get_commit Returns information about a commit, including commit message and committer information
get_differences Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID, or other fully qualified reference)
get_file Returns the base-64 encoded contents of a specified file and its metadata
get_folder Returns the contents of a specified folder in a repository
get_merge_commit Returns information about a specified merge commit
get_merge_conflicts Returns information about merge conflicts between the before and after commit IDs for a pull request in a repository
get_merge_options Returns information about the merge options available for merging two specified branches
get_pull_request Gets information about a pull request in a specified repository
get_pull_request_approval_states Gets information about the approval states for a specified pull request
get_pull_request_override_state Returns information about whether approval rules have been set aside (overridden) for a pull request, and if so, the Amazon Resource Name (ARN) of the user or identity that overrode the rules and their requirements for the pull request
get_repository Returns information about a repository
get_repository_triggers Gets information about triggers configured for a repository
list_approval_rule_templates Lists all approval rule templates in the specified Amazon Web Services Region in your Amazon Web Services account
list_associated_approval_rule_templates_for_repository Lists all approval rule templates that are associated with a specified repository
list_branches Gets information about one or more branches in a repository
list_file_commit_history Retrieves a list of commits and changes to a specified file
list_pull_requests Returns a list of pull requests for a specified repository
list_repositories Gets information about one or more repositories
list_repositories_for_approval_rule_template Lists all repositories associated with the specified approval rule template
list_tags_for_resource Gets information about Amazon Web Servicestags for a specified Amazon Resource Name (ARN) in CodeCommit
merge_branches_by_fast_forward Merges two branches using the fast-forward merge strategy
merge_branches_by_squash Merges two branches using the squash merge strategy
merge_branches_by_three_way Merges two specified branches using the three-way merge strategy
merge_pull_request_by_fast_forward Attempts to merge the source commit of a pull request into the specified destination branch for that pull request at the specified commit using the fast-forward merge strategy
merge_pull_request_by_squash Attempts to merge the source commit of a pull request into the specified destination branch for that pull request at the specified commit using the squash merge strategy
merge_pull_request_by_three_way Attempts to merge the source commit of a pull request into the specified destination branch for that pull request at the specified commit using the three-way merge strategy
override_pull_request_approval_rules Sets aside (overrides) all approval rule requirements for a specified pull request
post_comment_for_compared_commit Posts a comment on the comparison between two commits
post_comment_for_pull_request Posts a comment on a pull request
post_comment_reply Posts a comment in reply to an existing comment on a comparison between commits or a pull request
put_comment_reaction Adds or updates a reaction to a specified comment for the user whose identity is used to make the request
put_file Adds or updates a file in a branch in an CodeCommit repository, and generates a commit for the addition in the specified branch
put_repository_triggers Replaces all triggers for a repository
tag_resource Adds or updates tags for a resource in CodeCommit
test_repository_triggers Tests the functionality of repository triggers by sending information to the trigger target
untag_resource Removes tags for a resource in CodeCommit
update_approval_rule_template_content Updates the content of an approval rule template
update_approval_rule_template_description Updates the description for a specified approval rule template
update_approval_rule_template_name Updates the name of a specified approval rule template
update_comment Replaces the contents of a comment
update_default_branch Sets or changes the default branch name for the specified repository
update_pull_request_approval_rule_content Updates the structure of an approval rule created specifically for a pull request
update_pull_request_approval_state Updates the state of a user's approval on a pull request
update_pull_request_description Replaces the contents of the description of a pull request
update_pull_request_status Updates the status of a pull request
update_pull_request_title Replaces the title of a pull request
update_repository_description Sets or changes the comment or description for a repository
update_repository_encryption_key Updates the Key Management Service encryption key used to encrypt and decrypt a CodeCommit repository
update_repository_name Renames a repository

Examples

## Not run: 
svc <- codecommit()
svc$associate_approval_rule_template_with_repository(
  Foo = 123
)

## End(Not run)

AWS CodeDeploy

Description

CodeDeploy is a deployment service that automates application deployments to Amazon EC2 instances, on-premises instances running in your own facility, serverless Lambda functions, or applications in an Amazon ECS service.

You can deploy a nearly unlimited variety of application content, such as an updated Lambda function, updated applications in an Amazon ECS service, code, web and configuration files, executables, packages, scripts, multimedia files, and so on. CodeDeploy can deploy application content stored in Amazon S3 buckets, GitHub repositories, or Bitbucket repositories. You do not need to make changes to your existing code before you can use CodeDeploy.

CodeDeploy makes it easier for you to rapidly release new features, helps you avoid downtime during application deployment, and handles the complexity of updating your applications, without many of the risks associated with error-prone manual deployments.

CodeDeploy Components

Use the information in this guide to help you work with the following CodeDeploy components:

  • Application: A name that uniquely identifies the application you want to deploy. CodeDeploy uses this name, which functions as a container, to ensure the correct combination of revision, deployment configuration, and deployment group are referenced during a deployment.

  • Deployment group: A set of individual instances, CodeDeploy Lambda deployment configuration settings, or an Amazon ECS service and network details. A Lambda deployment group specifies how to route traffic to a new version of a Lambda function. An Amazon ECS deployment group specifies the service created in Amazon ECS to deploy, a load balancer, and a listener to reroute production traffic to an updated containerized application. An Amazon EC2/On-premises deployment group contains individually tagged instances, Amazon EC2 instances in Amazon EC2 Auto Scaling groups, or both. All deployment groups can specify optional trigger, alarm, and rollback settings.

  • Deployment configuration: A set of deployment rules and deployment success and failure conditions used by CodeDeploy during a deployment.

  • Deployment: The process and the components used when updating a Lambda function, a containerized application in an Amazon ECS service, or of installing content on one or more instances.

  • Application revisions: For an Lambda deployment, this is an AppSpec file that specifies the Lambda function to be updated and one or more functions to validate deployment lifecycle events. For an Amazon ECS deployment, this is an AppSpec file that specifies the Amazon ECS task definition, container, and port where production traffic is rerouted. For an EC2/On-premises deployment, this is an archive file that contains source content—source code, webpages, executable files, and deployment scripts—along with an AppSpec file. Revisions are stored in Amazon S3 buckets or GitHub repositories. For Amazon S3, a revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. For GitHub, a revision is uniquely identified by its commit ID.

This guide also contains information to help you get details about the instances in your deployments, to make on-premises instances available for CodeDeploy deployments, to get details about a Lambda function deployment, and to get details about Amazon ECS service deployments.

CodeDeploy Information Resources

Usage

codedeploy(
  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 <- codedeploy(
  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_tags_to_on_premises_instances Adds tags to on-premises instances
batch_get_application_revisions Gets information about one or more application revisions
batch_get_applications Gets information about one or more applications
batch_get_deployment_groups Gets information about one or more deployment groups
batch_get_deployment_instances This method works, but is deprecated
batch_get_deployments Gets information about one or more deployments
batch_get_deployment_targets Returns an array of one or more targets associated with a deployment
batch_get_on_premises_instances Gets information about one or more on-premises instances
continue_deployment For a blue/green deployment, starts the process of rerouting traffic from instances in the original environment to instances in the replacement environment without waiting for a specified wait time to elapse
create_application Creates an application
create_deployment Deploys an application revision through the specified deployment group
create_deployment_config Creates a deployment configuration
create_deployment_group Creates a deployment group to which application revisions are deployed
delete_application Deletes an application
delete_deployment_config Deletes a deployment configuration
delete_deployment_group Deletes a deployment group
delete_git_hub_account_token Deletes a GitHub account connection
delete_resources_by_external_id Deletes resources linked to an external ID
deregister_on_premises_instance Deregisters an on-premises instance
get_application Gets information about an application
get_application_revision Gets information about an application revision
get_deployment Gets information about a deployment
get_deployment_config Gets information about a deployment configuration
get_deployment_group Gets information about a deployment group
get_deployment_instance Gets information about an instance as part of a deployment
get_deployment_target Returns information about a deployment target
get_on_premises_instance Gets information about an on-premises instance
list_application_revisions Lists information about revisions for an application
list_applications Lists the applications registered with the user or Amazon Web Services account
list_deployment_configs Lists the deployment configurations with the user or Amazon Web Services account
list_deployment_groups Lists the deployment groups for an application registered with the Amazon Web Services user or Amazon Web Services account
list_deployment_instances The newer BatchGetDeploymentTargets should be used instead because it works with all compute types
list_deployments Lists the deployments in a deployment group for an application registered with the user or Amazon Web Services account
list_deployment_targets Returns an array of target IDs that are associated a deployment
list_git_hub_account_token_names Lists the names of stored connections to GitHub accounts
list_on_premises_instances Gets a list of names for one or more on-premises instances
list_tags_for_resource Returns a list of tags for the resource identified by a specified Amazon Resource Name (ARN)
put_lifecycle_event_hook_execution_status Sets the result of a Lambda validation function
register_application_revision Registers with CodeDeploy a revision for the specified application
register_on_premises_instance Registers an on-premises instance
remove_tags_from_on_premises_instances Removes one or more tags from one or more on-premises instances
skip_wait_time_for_instance_termination In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is complete
stop_deployment Attempts to stop an ongoing deployment
tag_resource Associates the list of tags in the input Tags parameter with the resource identified by the ResourceArn input parameter
untag_resource Disassociates a resource from a list of tags
update_application Changes the name of an application
update_deployment_group Changes information about a deployment group

Examples

## Not run: 
svc <- codedeploy()
svc$add_tags_to_on_premises_instances(
  Foo = 123
)

## End(Not run)

Amazon CodeGuru Profiler

Description

This section provides documentation for the Amazon CodeGuru Profiler API operations.

Amazon CodeGuru Profiler collects runtime performance data from your live applications, and provides recommendations that can help you fine-tune your application performance. Using machine learning algorithms, CodeGuru Profiler can help you find your most expensive lines of code and suggest ways you can improve efficiency and remove CPU bottlenecks.

Amazon CodeGuru Profiler provides different visualizations of profiling data to help you identify what code is running on the CPU, see how much time is consumed, and suggest ways to reduce CPU utilization.

Amazon CodeGuru Profiler currently supports applications written in all Java virtual machine (JVM) languages and Python. While CodeGuru Profiler supports both visualizations and recommendations for applications written in Java, it can also generate visualizations and a subset of recommendations for applications written in other JVM languages and Python.

For more information, see What is Amazon CodeGuru Profiler in the Amazon CodeGuru Profiler User Guide.

Usage

codeguruprofiler(
  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 <- codeguruprofiler(
  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_notification_channels Add up to 2 anomaly notifications channels for a profiling group
batch_get_frame_metric_data Returns the time series of values for a requested list of frame metrics from a time period
configure_agent Used by profiler agents to report their current state and to receive remote configuration updates
create_profiling_group Creates a profiling group
delete_profiling_group Deletes a profiling group
describe_profiling_group Returns a ProfilingGroupDescription object that contains information about the requested profiling group
get_findings_report_account_summary Returns a list of FindingsReportSummary objects that contain analysis results for all profiling groups in your AWS account
get_notification_configuration Get the current configuration for anomaly notifications for a profiling group
get_policy Returns the JSON-formatted resource-based policy on a profiling group
get_profile Gets the aggregated profile of a profiling group for a specified time range
get_recommendations Returns a list of Recommendation objects that contain recommendations for a profiling group for a given time period
list_findings_reports List the available reports for a given profiling group and time range
list_profile_times Lists the start times of the available aggregated profiles of a profiling group for an aggregation period within the specified time range
list_profiling_groups Returns a list of profiling groups
list_tags_for_resource Returns a list of the tags that are assigned to a specified resource
post_agent_profile Submits profiling data to an aggregated profile of a profiling group
put_permission Adds permissions to a profiling group's resource-based policy that are provided using an action group
remove_notification_channel Remove one anomaly notifications channel for a profiling group
remove_permission Removes permissions from a profiling group's resource-based policy that are provided using an action group
submit_feedback Sends feedback to CodeGuru Profiler about whether the anomaly detected by the analysis is useful or not
tag_resource Use to assign one or more tags to a resource
untag_resource Use to remove one or more tags from a resource
update_profiling_group Updates a profiling group

Examples

## Not run: 
svc <- codeguruprofiler()
svc$add_notification_channels(
  Foo = 123
)

## End(Not run)

Amazon CodeGuru Reviewer

Description

This section provides documentation for the Amazon CodeGuru Reviewer API operations. CodeGuru Reviewer is a service that uses program analysis and machine learning to detect potential defects that are difficult for developers to find and recommends fixes in your Java and Python code.

By proactively detecting and providing recommendations for addressing code defects and implementing best practices, CodeGuru Reviewer improves the overall quality and maintainability of your code base during the code review stage. For more information about CodeGuru Reviewer, see the AmazonCodeGuru Reviewer User Guide.

To improve the security of your CodeGuru Reviewer API calls, you can establish a private connection between your VPC and CodeGuru Reviewer by creating an interface VPC endpoint. For more information, see CodeGuru Reviewer and interface VPC endpoints (Amazon Web Services PrivateLink) in the Amazon CodeGuru Reviewer User Guide.

Usage

codegurureviewer(
  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 <- codegurureviewer(
  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

associate_repository Use to associate an Amazon Web Services CodeCommit repository or a repository managed by Amazon Web Services CodeStar Connections with Amazon CodeGuru Reviewer
create_code_review Use to create a code review with a CodeReviewType of RepositoryAnalysis
describe_code_review Returns the metadata associated with the code review along with its status
describe_recommendation_feedback Describes the customer feedback for a CodeGuru Reviewer recommendation
describe_repository_association Returns a RepositoryAssociation object that contains information about the requested repository association
disassociate_repository Removes the association between Amazon CodeGuru Reviewer and a repository
list_code_reviews Lists all the code reviews that the customer has created in the past 90 days
list_recommendation_feedback Returns a list of RecommendationFeedbackSummary objects that contain customer recommendation feedback for all CodeGuru Reviewer users
list_recommendations Returns the list of all recommendations for a completed code review
list_repository_associations Returns a list of RepositoryAssociationSummary objects that contain summary information about a repository association
list_tags_for_resource Returns the list of tags associated with an associated repository resource
put_recommendation_feedback Stores customer feedback for a CodeGuru Reviewer recommendation
tag_resource Adds one or more tags to an associated repository
untag_resource Removes a tag from an associated repository

Examples

## Not run: 
svc <- codegurureviewer()
svc$associate_repository(
  Foo = 123
)

## End(Not run)

Amazon CodeGuru Security

Description

Amazon CodeGuru Security is in preview release and is subject to change.

This section provides documentation for the Amazon CodeGuru Security API operations. CodeGuru Security is a service that uses program analysis and machine learning to detect security policy violations and vulnerabilities, and recommends ways to address these security risks.

By proactively detecting and providing recommendations for addressing security risks, CodeGuru Security improves the overall security of your application code. For more information about CodeGuru Security, see the Amazon CodeGuru Security User Guide.

Usage

codegurusecurity(
  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 <- codegurusecurity(
  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

batch_get_findings Returns a list of requested findings from standard scans
create_scan Use to create a scan using code uploaded to an Amazon S3 bucket
create_upload_url Generates a pre-signed URL, request headers used to upload a code resource, and code artifact identifier for the uploaded resource
get_account_configuration Use to get the encryption configuration for an account
get_findings Returns a list of all findings generated by a particular scan
get_metrics_summary Returns a summary of metrics for an account from a specified date, including number of open findings, the categories with most findings, the scans with most open findings, and scans with most open critical findings
get_scan Returns details about a scan, including whether or not a scan has completed
list_findings_metrics Returns metrics about all findings in an account within a specified time range
list_scans Returns a list of all scans in an account
list_tags_for_resource Returns a list of all tags associated with a scan
tag_resource Use to add one or more tags to an existing scan
untag_resource Use to remove one or more tags from an existing scan
update_account_configuration Use to update the encryption configuration for an account

Examples

## Not run: 
svc <- codegurusecurity()
svc$batch_get_findings(
  Foo = 123
)

## End(Not run)

AWS CodePipeline

Description

CodePipeline

Overview

This is the CodePipeline API Reference. This guide provides descriptions of the actions and data types for CodePipeline. Some functionality for your pipeline can only be configured through the API. For more information, see the CodePipeline User Guide.

You can use the CodePipeline API to work with pipelines, stages, actions, and transitions.

Pipelines are models of automated release processes. Each pipeline is uniquely named, and consists of stages, actions, and transitions.

You can work with pipelines by calling:

  • create_pipeline, which creates a uniquely named pipeline.

  • delete_pipeline, which deletes the specified pipeline.

  • get_pipeline, which returns information about the pipeline structure and pipeline metadata, including the pipeline Amazon Resource Name (ARN).

  • get_pipeline_execution, which returns information about a specific execution of a pipeline.

  • get_pipeline_state, which returns information about the current state of the stages and actions of a pipeline.

  • list_action_executions, which returns action-level details for past executions. The details include full stage and action-level details, including individual action duration, status, any errors that occurred during the execution, and input and output artifact location details.

  • list_pipelines, which gets a summary of all of the pipelines associated with your account.

  • list_pipeline_executions, which gets a summary of the most recent executions for a pipeline.

  • start_pipeline_execution, which runs the most recent revision of an artifact through the pipeline.

  • stop_pipeline_execution, which stops the specified pipeline execution from continuing through the pipeline.

  • update_pipeline, which updates a pipeline with edits or changes to the structure of the pipeline.

Pipelines include stages. Each stage contains one or more actions that must complete before the next stage begins. A stage results in success or failure. If a stage fails, the pipeline stops at that stage and remains stopped until either a new version of an artifact appears in the source location, or a user takes action to rerun the most recent artifact through the pipeline. You can call get_pipeline_state, which displays the status of a pipeline, including the status of stages in the pipeline, or get_pipeline, which returns the entire structure of the pipeline, including the stages of that pipeline. For more information about the structure of stages and actions, see CodePipeline Pipeline Structure Reference.

Pipeline stages include actions that are categorized into categories such as source or build actions performed in a stage of a pipeline. For example, you can use a source action to import artifacts into a pipeline from a source such as Amazon S3. Like stages, you do not work with actions directly in most cases, but you do define and interact with actions when working with pipeline operations such as create_pipeline and get_pipeline_state. Valid action categories are:

  • Source

  • Build

  • Test

  • Deploy

  • Approval

  • Invoke

Pipelines also include transitions, which allow the transition of artifacts from one stage to the next in a pipeline after the actions in one stage complete.

You can work with transitions by calling:

  • disable_stage_transition, which prevents artifacts from transitioning to the next stage in a pipeline.

  • enable_stage_transition, which enables transition of artifacts between stages in a pipeline.

Using the API to integrate with CodePipeline

For third-party integrators or developers who want to create their own integrations with CodePipeline, the expected sequence varies from the standard API user. To integrate with CodePipeline, developers need to work with the following items:

Jobs, which are instances of an action. For example, a job for a source action might import a revision of an artifact from a source.

You can work with jobs by calling:

  • acknowledge_job, which confirms whether a job worker has received the specified job.

  • get_job_details, which returns the details of a job.

  • poll_for_jobs, which determines whether there are any jobs to act on.

  • put_job_failure_result, which provides details of a job failure.

  • put_job_success_result, which provides details of a job success.

Third party jobs, which are instances of an action created by a partner action and integrated into CodePipeline. Partner actions are created by members of the Amazon Web Services Partner Network.

You can work with third party jobs by calling:

  • acknowledge_third_party_job, which confirms whether a job worker has received the specified job.

  • get_third_party_job_details, which requests the details of a job for a partner action.

  • poll_for_third_party_jobs, which determines whether there are any jobs to act on.

  • put_third_party_job_failure_result, which provides details of a job failure.

  • put_third_party_job_success_result, which provides details of a job success.

Usage

codepipeline(
  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 <- codepipeline(
  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

acknowledge_job Returns information about a specified job and whether that job has been received by the job worker
acknowledge_third_party_job Confirms a job worker has received the specified job
create_custom_action_type Creates a new custom action that can be used in all pipelines associated with the Amazon Web Services account
create_pipeline Creates a pipeline
delete_custom_action_type Marks a custom action as deleted
delete_pipeline Deletes the specified pipeline
delete_webhook Deletes a previously created webhook by name
deregister_webhook_with_third_party Removes the connection between the webhook that was created by CodePipeline and the external tool with events to be detected
disable_stage_transition Prevents artifacts in a pipeline from transitioning to the next stage in the pipeline
enable_stage_transition Enables artifacts in a pipeline to transition to a stage in a pipeline
get_action_type Returns information about an action type created for an external provider, where the action is to be used by customers of the external provider
get_job_details Returns information about a job
get_pipeline Returns the metadata, structure, stages, and actions of a pipeline
get_pipeline_execution Returns information about an execution of a pipeline, including details about artifacts, the pipeline execution ID, and the name, version, and status of the pipeline
get_pipeline_state Returns information about the state of a pipeline, including the stages and actions
get_third_party_job_details Requests the details of a job for a third party action
list_action_executions Lists the action executions that have occurred in a pipeline
list_action_types Gets a summary of all CodePipeline action types associated with your account
list_pipeline_executions Gets a summary of the most recent executions for a pipeline
list_pipelines Gets a summary of all of the pipelines associated with your account
list_rule_executions Lists the rule executions that have occurred in a pipeline configured for conditions with rules
list_rule_types Lists the rules for the condition
list_tags_for_resource Gets the set of key-value pairs (metadata) that are used to manage the resource
list_webhooks Gets a listing of all the webhooks in this Amazon Web Services Region for this account
override_stage_condition Used to override a stage condition
poll_for_jobs Returns information about any jobs for CodePipeline to act on
poll_for_third_party_jobs Determines whether there are any third party jobs for a job worker to act on
put_action_revision Provides information to CodePipeline about new revisions to a source
put_approval_result Provides the response to a manual approval request to CodePipeline
put_job_failure_result Represents the failure of a job as returned to the pipeline by a job worker
put_job_success_result Represents the success of a job as returned to the pipeline by a job worker
put_third_party_job_failure_result Represents the failure of a third party job as returned to the pipeline by a job worker
put_third_party_job_success_result Represents the success of a third party job as returned to the pipeline by a job worker
put_webhook Defines a webhook and returns a unique webhook URL generated by CodePipeline
register_webhook_with_third_party Configures a connection between the webhook that was created and the external tool with events to be detected
retry_stage_execution You can retry a stage that has failed without having to run a pipeline again from the beginning
rollback_stage Rolls back a stage execution
start_pipeline_execution Starts the specified pipeline
stop_pipeline_execution Stops the specified pipeline execution
tag_resource Adds to or modifies the tags of the given resource
untag_resource Removes tags from an Amazon Web Services resource
update_action_type Updates an action type that was created with any supported integration model, where the action type is to be used by customers of the action type provider
update_pipeline Updates a specified pipeline with edits or changes to its structure

Examples

## Not run: 
svc <- codepipeline()
svc$acknowledge_job(
  Foo = 123
)

## End(Not run)

AWS CodeStar connections

Description

AWS CodeStar Connections

This Amazon Web Services CodeStar Connections API Reference provides descriptions and usage examples of the operations and data types for the Amazon Web Services CodeStar Connections API. You can use the connections API to work with connections and installations.

Connections are configurations that you use to connect Amazon Web Services resources to external code repositories. Each connection is a resource that can be given to services such as CodePipeline to connect to a third-party repository such as Bitbucket. For example, you can add the connection in CodePipeline so that it triggers your pipeline when a code change is made to your third-party code repository. Each connection is named and associated with a unique ARN that is used to reference the connection.

When you create a connection, the console initiates a third-party connection handshake. Installations are the apps that are used to conduct this handshake. For example, the installation for the Bitbucket provider type is the Bitbucket app. When you create a connection, you can choose an existing installation or create one.

When you want to create a connection to an installed provider type such as GitHub Enterprise Server, you create a host for your connections.

You can work with connections by calling:

  • create_connection, which creates a uniquely named connection that can be referenced by services such as CodePipeline.

  • delete_connection, which deletes the specified connection.

  • get_connection, which returns information about the connection, including the connection status.

  • list_connections, which lists the connections associated with your account.

You can work with hosts by calling:

  • create_host, which creates a host that represents the infrastructure where your provider is installed.

  • delete_host, which deletes the specified host.

  • get_host, which returns information about the host, including the setup status.

  • list_hosts, which lists the hosts associated with your account.

You can work with tags in Amazon Web Services CodeStar Connections by calling the following:

  • list_tags_for_resource, which gets information about Amazon Web Services tags for a specified Amazon Resource Name (ARN) in Amazon Web Services CodeStar Connections.

  • tag_resource, which adds or updates tags for a resource in Amazon Web Services CodeStar Connections.

  • untag_resource, which removes tags for a resource in Amazon Web Services CodeStar Connections.

For information about how to use Amazon Web Services CodeStar Connections, see the Developer Tools User Guide.

Usage

codestarconnections(
  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 <- codestarconnections(
  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

create_connection Creates a connection that can then be given to other Amazon Web Services services like CodePipeline so that it can access third-party code repositories
create_host Creates a resource that represents the infrastructure where a third-party provider is installed
create_repository_link Creates a link to a specified external Git repository
create_sync_configuration Creates a sync configuration which allows Amazon Web Services to sync content from a Git repository to update a specified Amazon Web Services resource
delete_connection The connection to be deleted
delete_host The host to be deleted
delete_repository_link Deletes the association between your connection and a specified external Git repository
delete_sync_configuration Deletes the sync configuration for a specified repository and connection
get_connection Returns the connection ARN and details such as status, owner, and provider type
get_host Returns the host ARN and details such as status, provider type, endpoint, and, if applicable, the VPC configuration
get_repository_link Returns details about a repository link
get_repository_sync_status Returns details about the sync status for a repository
get_resource_sync_status Returns the status of the sync with the Git repository for a specific Amazon Web Services resource
get_sync_blocker_summary Returns a list of the most recent sync blockers
get_sync_configuration Returns details about a sync configuration, including the sync type and resource name
list_connections Lists the connections associated with your account
list_hosts Lists the hosts associated with your account
list_repository_links Lists the repository links created for connections in your account
list_repository_sync_definitions Lists the repository sync definitions for repository links in your account
list_sync_configurations Returns a list of sync configurations for a specified repository
list_tags_for_resource Gets the set of key-value pairs (metadata) that are used to manage the resource
tag_resource Adds to or modifies the tags of the given resource
untag_resource Removes tags from an Amazon Web Services resource
update_host Updates a specified host with the provided configurations
update_repository_link Updates the association between your connection and a specified external Git repository
update_sync_blocker Allows you to update the status of a sync blocker, resolving the blocker and allowing syncing to continue
update_sync_configuration Updates the sync configuration for your connection and a specified external Git repository

Examples

## Not run: 
svc <- codestarconnections()
svc$create_connection(
  Foo = 123
)

## End(Not run)

AWS CodeStar Notifications

Description

This AWS CodeStar Notifications API Reference provides descriptions and usage examples of the operations and data types for the AWS CodeStar Notifications API. You can use the AWS CodeStar Notifications API to work with the following objects:

Notification rules, by calling the following:

  • create_notification_rule, which creates a notification rule for a resource in your account.

  • delete_notification_rule, which deletes a notification rule.

  • describe_notification_rule, which provides information about a notification rule.

  • list_notification_rules, which lists the notification rules associated with your account.

  • update_notification_rule, which changes the name, events, or targets associated with a notification rule.

  • subscribe, which subscribes a target to a notification rule.

  • unsubscribe, which removes a target from a notification rule.

Targets, by calling the following:

  • delete_target, which removes a notification rule target from a notification rule.

  • list_targets, which lists the targets associated with a notification rule.

Events, by calling the following:

  • list_event_types, which lists the event types you can include in a notification rule.

Tags, by calling the following:

  • list_tags_for_resource, which lists the tags already associated with a notification rule in your account.

  • tag_resource, which associates a tag you provide with a notification rule in your account.

  • untag_resource, which removes a tag from a notification rule in your account.

For information about how to use AWS CodeStar Notifications, see the Amazon Web Services Developer Tools Console User Guide.

Usage

codestarnotifications(
  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 <- codestarnotifications(
  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

create_notification_rule Creates a notification rule for a resource
delete_notification_rule Deletes a notification rule for a resource
delete_target Deletes a specified target for notifications
describe_notification_rule Returns information about a specified notification rule
list_event_types Returns information about the event types available for configuring notifications
list_notification_rules Returns a list of the notification rules for an Amazon Web Services account
list_tags_for_resource Returns a list of the tags associated with a notification rule
list_targets Returns a list of the notification rule targets for an Amazon Web Services account
subscribe Creates an association between a notification rule and an Chatbot topic or Chatbot client so that the associated target can receive notifications when the events described in the rule are triggered
tag_resource Associates a set of provided tags with a notification rule
unsubscribe Removes an association between a notification rule and an Chatbot topic so that subscribers to that topic stop receiving notifications when the events described in the rule are triggered
untag_resource Removes the association between one or more provided tags and a notification rule
update_notification_rule Updates a notification rule for a resource

Examples

## Not run: 
svc <- codestarnotifications()
svc$create_notification_rule(
  Foo = 123
)

## End(Not run)

Amazon Cognito Identity

Description

Amazon Cognito Federated Identities

Amazon Cognito Federated Identities is a web service that delivers scoped temporary credentials to mobile devices and other untrusted environments. It uniquely identifies a device and supplies the user with a consistent identity over the lifetime of an application.

Using Amazon Cognito Federated Identities, you can enable authentication with one or more third-party identity providers (Facebook, Google, or Login with Amazon) or an Amazon Cognito user pool, and you can also choose to support unauthenticated access from your app. Cognito delivers a unique identifier for each user and acts as an OpenID token provider trusted by AWS Security Token Service (STS) to access temporary, limited-privilege AWS credentials.

For a description of the authentication flow from the Amazon Cognito Developer Guide see Authentication Flow.

For more information see Amazon Cognito Federated Identities.

Usage

cognitoidentity(
  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 <- cognitoidentity(
  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

create_identity_pool Creates a new identity pool
delete_identities Deletes identities from an identity pool
delete_identity_pool Deletes an identity pool
describe_identity Returns metadata related to the given identity, including when the identity was created and any associated linked logins
describe_identity_pool Gets details about a particular identity pool, including the pool name, ID description, creation date, and current number of users
get_credentials_for_identity Returns credentials for the provided identity ID
get_id Generates (or retrieves) a Cognito ID
get_identity_pool_roles Gets the roles for an identity pool
get_open_id_token Gets an OpenID token, using a known Cognito ID
get_open_id_token_for_developer_identity Registers (or retrieves) a Cognito IdentityId and an OpenID Connect token for a user authenticated by your backend authentication process
get_principal_tag_attribute_map Use GetPrincipalTagAttributeMap to list all mappings between PrincipalTags and user attributes
list_identities Lists the identities in an identity pool
list_identity_pools Lists all of the Cognito identity pools registered for your account
list_tags_for_resource Lists the tags that are assigned to an Amazon Cognito identity pool
lookup_developer_identity Retrieves the IdentityID associated with a DeveloperUserIdentifier or the list of DeveloperUserIdentifier values associated with an IdentityId for an existing identity
merge_developer_identities Merges two users having different IdentityIds, existing in the same identity pool, and identified by the same developer provider
set_identity_pool_roles Sets the roles for an identity pool
set_principal_tag_attribute_map You can use this operation to use default (username and clientID) attribute or custom attribute mappings
tag_resource Assigns a set of tags to the specified Amazon Cognito identity pool
unlink_developer_identity Unlinks a DeveloperUserIdentifier from an existing identity
unlink_identity Unlinks a federated identity from an existing account
untag_resource Removes the specified tags from the specified Amazon Cognito identity pool
update_identity_pool Updates an identity pool

Examples

## Not run: 
svc <- cognitoidentity()
svc$create_identity_pool(
  Foo = 123
)

## End(Not run)

Amazon Cognito Identity Provider

Description

With the Amazon Cognito user pools API, you can configure user pools and authenticate users. To authenticate users from third-party identity providers (IdPs) in this API, you can link IdP users to native user profiles. Learn more about the authentication and authorization of federated users at Adding user pool sign-in through a third party and in the User pool federation endpoints and hosted UI reference.

This API reference provides detailed information about API operations and object types in Amazon Cognito.

Along with resource management operations, the Amazon Cognito user pools API includes classes of operations and authorization models for client-side and server-side authentication of users. You can interact with operations in the Amazon Cognito user pools API as any of the following subjects.

  1. An administrator who wants to configure user pools, app clients, users, groups, or other user pool functions.

  2. A server-side app, like a web application, that wants to use its Amazon Web Services privileges to manage, authenticate, or authorize a user.

  3. A client-side app, like a mobile app, that wants to make unauthenticated requests to manage, authenticate, or authorize a user.

For more information, see Using the Amazon Cognito user pools API and user pool endpoints in the Amazon Cognito Developer Guide.

With your Amazon Web Services SDK, you can build the logic to support operational flows in every use case for this API. You can also make direct REST API requests to Amazon Cognito user pools service endpoints. The following links can get you started with the CognitoIdentityProvider client in other supported Amazon Web Services SDKs.

To get started with an Amazon Web Services SDK, see Tools to Build on Amazon Web Services. For example actions and scenarios, see Code examples for Amazon Cognito Identity Provider using Amazon Web Services SDKs.

Usage

cognitoidentityprovider(
  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 operat