paws.networking (version 0.5.0)

apigateway: 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
)

Value

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

Arguments

config

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

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

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

    • anonymous: Set anonymous credentials.

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

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

  • close_connection: Immediately close all HTTP connections.

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

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

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

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

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

  • anonymous: Set anonymous credentials.

endpoint

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

region

Optional shorthand for AWS Region used in instantiating the client.

Service syntax

svc <- 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_keyCreate an ApiKey resource
create_authorizerAdds a new Authorizer resource to an existing RestApi resource
create_base_path_mappingCreates a new BasePathMapping resource
create_deploymentCreates a Deployment resource, which makes a specified RestApi callable over the internet
create_documentation_partCreates a documentation part
create_documentation_versionCreates a documentation version
create_domain_nameCreates a new domain name
create_modelAdds a new Model resource to an existing RestApi resource
create_request_validatorCreates a RequestValidator of a given RestApi
create_resourceCreates a Resource resource
create_rest_apiCreates a new RestApi resource
create_stageCreates a new Stage resource that references a pre-existing Deployment for the API
create_usage_planCreates a usage plan with the throttle and quota limits, as well as the associated API stages, specified in the payload
create_usage_plan_keyCreates a usage plan key for adding an existing API key to a usage plan
create_vpc_linkCreates 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_keyDeletes the ApiKey resource
delete_authorizerDeletes an existing Authorizer resource
delete_base_path_mappingDeletes the BasePathMapping resource
delete_client_certificateDeletes the ClientCertificate resource
delete_deploymentDeletes a Deployment resource
delete_documentation_partDeletes a documentation part
delete_documentation_versionDeletes a documentation version
delete_domain_nameDeletes the DomainName resource
delete_gateway_responseClears any customization of a GatewayResponse of a specified response type on the given RestApi and resets it with the default settings
delete_integrationRepresents a delete integration
delete_integration_responseRepresents a delete integration response
delete_methodDeletes an existing Method resource
delete_method_responseDeletes an existing MethodResponse resource
delete_modelDeletes a model
delete_request_validatorDeletes a RequestValidator of a given RestApi
delete_resourceDeletes a Resource resource
delete_rest_apiDeletes the specified API
delete_stageDeletes a Stage resource
delete_usage_planDeletes a usage plan of a given plan Id
delete_usage_plan_keyDeletes a usage plan key and remove the underlying API key from the associated usage plan
delete_vpc_linkDeletes an existing VpcLink of a specified identifier
flush_stage_authorizers_cacheFlushes all authorizer cache entries on a stage
flush_stage_cacheFlushes a stage's cache
generate_client_certificateGenerates a ClientCertificate resource
get_accountGets information about the current Account resource
get_api_keyGets information about the current ApiKey resource
get_api_keysGets information about the current ApiKeys resource
get_authorizerDescribe an existing Authorizer resource
get_authorizersDescribe an existing Authorizers resource
get_base_path_mappingDescribe a BasePathMapping resource
get_base_path_mappingsRepresents a collection of BasePathMapping resources
get_client_certificateGets information about the current ClientCertificate resource
get_client_certificatesGets a collection of ClientCertificate resources
get_deploymentGets information about a Deployment resource
get_deploymentsGets information about a Deployments collection
get_documentation_partGets a documentation part
get_documentation_partsGets documentation parts
get_documentation_versionGets a documentation version
get_documentation_versionsGets documentation versions
get_domain_nameRepresents a domain name that is contained in a simpler, more intuitive URL that can be called
get_domain_namesRepresents a collection of DomainName resources
get_exportExports a deployed version of a RestApi in a specified format
get_gateway_responseGets a GatewayResponse of a specified response type on the given RestApi
get_gateway_responsesGets the GatewayResponses collection on the given RestApi
get_integrationGet the integration settings
get_integration_responseRepresents a get integration response
get_methodDescribe an existing Method resource
get_method_responseDescribes a MethodResponse resource
get_modelDescribes an existing model defined for a RestApi resource
get_modelsDescribes existing Models defined for a RestApi resource
get_model_templateGenerates a sample mapping template that can be used to transform a payload into the structure of a model
get_request_validatorGets a RequestValidator of a given RestApi
get_request_validatorsGets the RequestValidators collection of a given RestApi
get_resourceLists information about a resource
get_resourcesLists information about a collection of Resource resources
get_rest_apiLists the RestApi resource in the collection
get_rest_apisLists the RestApis resources for your collection
get_sdkGenerates a client SDK for a RestApi and Stage
get_sdk_typeGets an SDK type
get_sdk_typesGets SDK types
get_stageGets information about a Stage resource
get_stagesGets information about one or more Stage resources
get_tagsGets the Tags collection for a given resource
get_usageGets the usage data of a usage plan in a specified time interval
get_usage_planGets a usage plan of a given plan identifier
get_usage_plan_keyGets a usage plan key of a given key identifier
get_usage_plan_keysGets all the usage plan keys representing the API keys added to a specified usage plan
get_usage_plansGets all the usage plans of the caller's account
get_vpc_linkGets a specified VPC link under the caller's account in a region
get_vpc_linksGets the VpcLinks collection under the caller's account in a selected region
import_api_keysImport API keys from an external source, such as a CSV-formatted file
import_documentation_partsImports documentation parts
import_rest_apiA feature of the API Gateway control service for creating a new API from an external API definition file
put_gateway_responseCreates a customization of a GatewayResponse of a specified response type and status code on the given RestApi
put_integrationSets up a method's integration
put_integration_responseRepresents a put integration
put_methodAdd a method to an existing Resource resource
put_method_responseAdds a MethodResponse to an existing Method resource
put_rest_apiA feature of the API Gateway control service for updating an existing API with an input of external API definitions
tag_resourceAdds or updates a tag on a given resource
test_invoke_authorizerSimulate the execution of an Authorizer in your RestApi with headers, parameters, and an incoming request body
test_invoke_methodSimulate the invocation of a Method in your RestApi with headers, parameters, and an incoming request body
untag_resourceRemoves a tag from a given resource
update_accountChanges information about the current Account resource
update_api_keyChanges information about an ApiKey resource
update_authorizerUpdates an existing Authorizer resource
update_base_path_mappingChanges information about the BasePathMapping resource
update_client_certificateChanges information about an ClientCertificate resource
update_deploymentChanges information about a Deployment resource
update_documentation_partUpdates a documentation part
update_documentation_versionUpdates a documentation version
update_domain_nameChanges information about the DomainName resource
update_gateway_responseUpdates a GatewayResponse of a specified response type on the given RestApi
update_integrationRepresents an update integration
update_integration_responseRepresents an update integration response
update_methodUpdates an existing Method resource
update_method_responseUpdates an existing MethodResponse resource
update_modelChanges information about a model
update_request_validatorUpdates a RequestValidator of a given RestApi
update_resourceChanges information about a Resource resource
update_rest_apiChanges information about the specified API
update_stageChanges information about a Stage resource
update_usageGrants a temporary extension to the remaining quota of a usage plan associated with a specified API key
update_usage_planUpdates a usage plan of a given plan Id
update_vpc_linkUpdates an existing VpcLink of a specified identifier

Examples

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

Run the code above in your browser using DataLab