Class: Aws::APIGateway::Types::Stage

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb

Overview

Represents a unique identifier for a version of a deployed RestApi that is callable by users.

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#access_log_settingsTypes::AccessLogSettings

Settings for logging access in this stage.



5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#cache_cluster_enabledBoolean

Specifies whether a cache cluster is enabled for the stage. To activate a method-level cache, set CachingEnabled to true for a method.

Returns:

  • (Boolean)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#cache_cluster_sizeString

The stage's cache capacity in GB. For more information about choosing a cache size, see Enabling API caching to enhance responsiveness.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#cache_cluster_statusString

The status of the cache cluster for the stage, if enabled.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#canary_settingsTypes::CanarySettings

Settings for the canary deployment in this stage.



5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#client_certificate_idString

The identifier of a client certificate for an API stage.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#created_dateTime

The timestamp when the stage was created.

Returns:

  • (Time)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#deployment_idString

The identifier of the Deployment that the stage points to.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#descriptionString

The stage's description.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#documentation_versionString

The version of the associated API documentation.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#last_updated_dateTime

The timestamp when the stage last updated.

Returns:

  • (Time)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#method_settingsHash<String,Types::MethodSetting>

A map that defines the method settings for a Stage resource. Keys (designated as /{method_setting_key below) are method paths defined as {resource_path}/{http_method} for an individual method override, or /*/* for overriding all methods in the stage.

Returns:



5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#stage_nameString

The name of the stage is the first path segment in the Uniform Resource Identifier (URI) of a call to API Gateway. Stage names can only contain alphanumeric characters, hyphens, and underscores. Maximum length is 128 characters.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#tagsHash<String,String>

The collection of tags. Each tag element is associated with a given resource.

Returns:

  • (Hash<String,String>)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#tracing_enabledBoolean

Specifies whether active tracing with X-ray is enabled for the Stage.

Returns:

  • (Boolean)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#variablesHash<String,String>

A map that defines the stage variables for a Stage resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9-._~:/?#&=,]+.

Returns:

  • (Hash<String,String>)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end

#web_acl_arnString

The ARN of the WebAcl associated with the Stage.

Returns:

  • (String)


5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
# File 'gems/aws-sdk-apigateway/lib/aws-sdk-apigateway/types.rb', line 5009

class Stage < Struct.new(
  :deployment_id,
  :client_certificate_id,
  :stage_name,
  :description,
  :cache_cluster_enabled,
  :cache_cluster_size,
  :cache_cluster_status,
  :method_settings,
  :variables,
  :documentation_version,
  :access_log_settings,
  :canary_settings,
  :tracing_enabled,
  :web_acl_arn,
  :tags,
  :created_date,
  :last_updated_date)
  SENSITIVE = []
  include Aws::Structure
end