You are viewing documentation for version 3 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: Aws::CodeDeploy::Client

Inherits:
Seahorse::Client::Base show all
Includes:
Aws::ClientStubs
Defined in:
gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from Aws::ClientStubs

#stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

Constructor Details

#initialize(*args) ⇒ Client

Returns a new instance of Client

Parameters:

  • options (Hash) —

    a customizable set of options



163
164
165
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 163

def initialize(*args)
  super
end

Instance Method Details

#add_tags_to_on_premises_instances(params = {}) ⇒ Struct

Adds tags to on-premises instances.

Examples:

Request syntax with placeholder values


resp = client.add_tags_to_on_premises_instances({
  tags: [ # required
    {
      key: "Key",
      value: "Value",
    },
  ],
  instance_names: ["InstanceName"], # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :tags (required, Array<Types::Tag>) —

    The tag key-value pairs to add to the on-premises instances.

    Keys and values are both required. Keys cannot be null or empty strings. Value-only tags are not allowed.

  • :instance_names (required, Array<String>) —

    The names of the on-premises instances to which to add tags.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



198
199
200
201
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 198

def add_tags_to_on_premises_instances(params = {}, options = {})
  req = build_request(:add_tags_to_on_premises_instances, params)
  req.send_request(options)
end

#batch_get_application_revisions(params = {}) ⇒ Types::BatchGetApplicationRevisionsOutput

Gets information about one or more application revisions.

Examples:

Request syntax with placeholder values


resp = client.batch_get_application_revisions({
  application_name: "ApplicationName", # required
  revisions: [ # required
    {
      revision_type: "S3", # accepts S3, GitHub, String
      s3_location: {
        bucket: "S3Bucket",
        key: "S3Key",
        bundle_type: "tar", # accepts tar, tgz, zip, YAML, JSON
        version: "VersionId",
        e_tag: "ETag",
      },
      git_hub_location: {
        repository: "Repository",
        commit_id: "CommitId",
      },
      string: {
        content: "RawStringContent",
        sha256: "RawStringSha256",
      },
    },
  ],
})

Response structure


resp.application_name #=> String
resp.error_message #=> String
resp.revisions #=> Array
resp.revisions[0].revision_location.revision_type #=> String, one of "S3", "GitHub", "String"
resp.revisions[0].revision_location.s3_location.bucket #=> String
resp.revisions[0].revision_location.s3_location.key #=> String
resp.revisions[0].revision_location.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.revisions[0].revision_location.s3_location.version #=> String
resp.revisions[0].revision_location.s3_location.e_tag #=> String
resp.revisions[0].revision_location.git_hub_location.repository #=> String
resp.revisions[0].revision_location.git_hub_location.commit_id #=> String
resp.revisions[0].revision_location.string.content #=> String
resp.revisions[0].revision_location.string.sha256 #=> String
resp.revisions[0].generic_revision_info.description #=> String
resp.revisions[0].generic_revision_info.deployment_groups #=> Array
resp.revisions[0].generic_revision_info.deployment_groups[0] #=> String
resp.revisions[0].generic_revision_info.first_used_time #=> Time
resp.revisions[0].generic_revision_info.last_used_time #=> Time
resp.revisions[0].generic_revision_info.register_time #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application about which to get revision information.

  • :revisions (required, Array<Types::RevisionLocation>) —

    Information to get about the application revisions, including type and location.

Returns:

See Also:



271
272
273
274
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 271

def batch_get_application_revisions(params = {}, options = {})
  req = build_request(:batch_get_application_revisions, params)
  req.send_request(options)
end

#batch_get_applications(params = {}) ⇒ Types::BatchGetApplicationsOutput

Gets information about one or more applications.

Examples:

Request syntax with placeholder values


resp = client.batch_get_applications({
  application_names: ["ApplicationName"], # required
})

Response structure


resp.applications_info #=> Array
resp.applications_info[0].application_id #=> String
resp.applications_info[0].application_name #=> String
resp.applications_info[0].create_time #=> Time
resp.applications_info[0].linked_to_git_hub #=> Boolean
resp.applications_info[0]. #=> String
resp.applications_info[0].compute_platform #=> String, one of "Server", "Lambda"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_names (required, Array<String>) —

    A list of application names separated by spaces.

Returns:

See Also:



305
306
307
308
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 305

def batch_get_applications(params = {}, options = {})
  req = build_request(:batch_get_applications, params)
  req.send_request(options)
end

#batch_get_deployment_groups(params = {}) ⇒ Types::BatchGetDeploymentGroupsOutput

Gets information about one or more deployment groups.

Examples:

Request syntax with placeholder values


resp = client.batch_get_deployment_groups({
  application_name: "ApplicationName", # required
  deployment_group_names: ["DeploymentGroupName"], # required
})

Response structure


resp.deployment_groups_info #=> Array
resp.deployment_groups_info[0].application_name #=> String
resp.deployment_groups_info[0].deployment_group_id #=> String
resp.deployment_groups_info[0].deployment_group_name #=> String
resp.deployment_groups_info[0].deployment_config_name #=> String
resp.deployment_groups_info[0].ec2_tag_filters #=> Array
resp.deployment_groups_info[0].ec2_tag_filters[0].key #=> String
resp.deployment_groups_info[0].ec2_tag_filters[0].value #=> String
resp.deployment_groups_info[0].ec2_tag_filters[0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_groups_info[0].on_premises_instance_tag_filters #=> Array
resp.deployment_groups_info[0].on_premises_instance_tag_filters[0].key #=> String
resp.deployment_groups_info[0].on_premises_instance_tag_filters[0].value #=> String
resp.deployment_groups_info[0].on_premises_instance_tag_filters[0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_groups_info[0].auto_scaling_groups #=> Array
resp.deployment_groups_info[0].auto_scaling_groups[0].name #=> String
resp.deployment_groups_info[0].auto_scaling_groups[0].hook #=> String
resp.deployment_groups_info[0].service_role_arn #=> String
resp.deployment_groups_info[0].target_revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.deployment_groups_info[0].target_revision.s3_location.bucket #=> String
resp.deployment_groups_info[0].target_revision.s3_location.key #=> String
resp.deployment_groups_info[0].target_revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.deployment_groups_info[0].target_revision.s3_location.version #=> String
resp.deployment_groups_info[0].target_revision.s3_location.e_tag #=> String
resp.deployment_groups_info[0].target_revision.git_hub_location.repository #=> String
resp.deployment_groups_info[0].target_revision.git_hub_location.commit_id #=> String
resp.deployment_groups_info[0].target_revision.string.content #=> String
resp.deployment_groups_info[0].target_revision.string.sha256 #=> String
resp.deployment_groups_info[0].trigger_configurations #=> Array
resp.deployment_groups_info[0].trigger_configurations[0].trigger_name #=> String
resp.deployment_groups_info[0].trigger_configurations[0].trigger_target_arn #=> String
resp.deployment_groups_info[0].trigger_configurations[0].trigger_events #=> Array
resp.deployment_groups_info[0].trigger_configurations[0].trigger_events[0] #=> String, one of "DeploymentStart", "DeploymentSuccess", "DeploymentFailure", "DeploymentStop", "DeploymentRollback", "DeploymentReady", "InstanceStart", "InstanceSuccess", "InstanceFailure", "InstanceReady"
resp.deployment_groups_info[0].alarm_configuration.enabled #=> Boolean
resp.deployment_groups_info[0].alarm_configuration.ignore_poll_alarm_failure #=> Boolean
resp.deployment_groups_info[0].alarm_configuration.alarms #=> Array
resp.deployment_groups_info[0].alarm_configuration.alarms[0].name #=> String
resp.deployment_groups_info[0].auto_rollback_configuration.enabled #=> Boolean
resp.deployment_groups_info[0].auto_rollback_configuration.events #=> Array
resp.deployment_groups_info[0].auto_rollback_configuration.events[0] #=> String, one of "DEPLOYMENT_FAILURE", "DEPLOYMENT_STOP_ON_ALARM", "DEPLOYMENT_STOP_ON_REQUEST"
resp.deployment_groups_info[0].deployment_style.deployment_type #=> String, one of "IN_PLACE", "BLUE_GREEN"
resp.deployment_groups_info[0].deployment_style.deployment_option #=> String, one of "WITH_TRAFFIC_CONTROL", "WITHOUT_TRAFFIC_CONTROL"
resp.deployment_groups_info[0].blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.action #=> String, one of "TERMINATE", "KEEP_ALIVE"
resp.deployment_groups_info[0].blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.termination_wait_time_in_minutes #=> Integer
resp.deployment_groups_info[0].blue_green_deployment_configuration.deployment_ready_option.action_on_timeout #=> String, one of "CONTINUE_DEPLOYMENT", "STOP_DEPLOYMENT"
resp.deployment_groups_info[0].blue_green_deployment_configuration.deployment_ready_option.wait_time_in_minutes #=> Integer
resp.deployment_groups_info[0].blue_green_deployment_configuration.green_fleet_provisioning_option.action #=> String, one of "DISCOVER_EXISTING", "COPY_AUTO_SCALING_GROUP"
resp.deployment_groups_info[0].load_balancer_info.elb_info_list #=> Array
resp.deployment_groups_info[0].load_balancer_info.elb_info_list[0].name #=> String
resp.deployment_groups_info[0].load_balancer_info.target_group_info_list #=> Array
resp.deployment_groups_info[0].load_balancer_info.target_group_info_list[0].name #=> String
resp.deployment_groups_info[0].last_successful_deployment.deployment_id #=> String
resp.deployment_groups_info[0].last_successful_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
resp.deployment_groups_info[0].last_successful_deployment.end_time #=> Time
resp.deployment_groups_info[0].last_successful_deployment.create_time #=> Time
resp.deployment_groups_info[0].last_attempted_deployment.deployment_id #=> String
resp.deployment_groups_info[0].last_attempted_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
resp.deployment_groups_info[0].last_attempted_deployment.end_time #=> Time
resp.deployment_groups_info[0].last_attempted_deployment.create_time #=> Time
resp.deployment_groups_info[0].ec2_tag_set.ec2_tag_set_list #=> Array
resp.deployment_groups_info[0].ec2_tag_set.ec2_tag_set_list[0] #=> Array
resp.deployment_groups_info[0].ec2_tag_set.ec2_tag_set_list[0][0].key #=> String
resp.deployment_groups_info[0].ec2_tag_set.ec2_tag_set_list[0][0].value #=> String
resp.deployment_groups_info[0].ec2_tag_set.ec2_tag_set_list[0][0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_groups_info[0].on_premises_tag_set.on_premises_tag_set_list #=> Array
resp.deployment_groups_info[0].on_premises_tag_set.on_premises_tag_set_list[0] #=> Array
resp.deployment_groups_info[0].on_premises_tag_set.on_premises_tag_set_list[0][0].key #=> String
resp.deployment_groups_info[0].on_premises_tag_set.on_premises_tag_set_list[0][0].value #=> String
resp.deployment_groups_info[0].on_premises_tag_set.on_premises_tag_set_list[0][0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_groups_info[0].compute_platform #=> String, one of "Server", "Lambda"
resp.error_message #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :deployment_group_names (required, Array<String>) —

    The deployment groups' names.

Returns:

See Also:



408
409
410
411
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 408

def batch_get_deployment_groups(params = {}, options = {})
  req = build_request(:batch_get_deployment_groups, params)
  req.send_request(options)
end

#batch_get_deployment_instances(params = {}) ⇒ Types::BatchGetDeploymentInstancesOutput

Gets information about one or more instance that are part of a deployment group.

Examples:

Request syntax with placeholder values


resp = client.batch_get_deployment_instances({
  deployment_id: "DeploymentId", # required
  instance_ids: ["InstanceId"], # required
})

Response structure


resp.instances_summary #=> Array
resp.instances_summary[0].deployment_id #=> String
resp.instances_summary[0].instance_id #=> String
resp.instances_summary[0].status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown", "Ready"
resp.instances_summary[0].last_updated_at #=> Time
resp.instances_summary[0].lifecycle_events #=> Array
resp.instances_summary[0].lifecycle_events[0].lifecycle_event_name #=> String
resp.instances_summary[0].lifecycle_events[0].diagnostics.error_code #=> String, one of "Success", "ScriptMissing", "ScriptNotExecutable", "ScriptTimedOut", "ScriptFailed", "UnknownError"
resp.instances_summary[0].lifecycle_events[0].diagnostics.script_name #=> String
resp.instances_summary[0].lifecycle_events[0].diagnostics.message #=> String
resp.instances_summary[0].lifecycle_events[0].diagnostics.log_tail #=> String
resp.instances_summary[0].lifecycle_events[0].start_time #=> Time
resp.instances_summary[0].lifecycle_events[0].end_time #=> Time
resp.instances_summary[0].lifecycle_events[0].status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown"
resp.instances_summary[0].instance_type #=> String, one of "Blue", "Green"
resp.error_message #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (required, String) —

    The unique ID of a deployment.

  • :instance_ids (required, Array<String>) —

    The unique IDs of instances in the deployment group.

Returns:

See Also:



457
458
459
460
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 457

def batch_get_deployment_instances(params = {}, options = {})
  req = build_request(:batch_get_deployment_instances, params)
  req.send_request(options)
end

#batch_get_deployments(params = {}) ⇒ Types::BatchGetDeploymentsOutput

Gets information about one or more deployments.

Examples:

Request syntax with placeholder values


resp = client.batch_get_deployments({
  deployment_ids: ["DeploymentId"], # required
})

Response structure


resp.deployments_info #=> Array
resp.deployments_info[0].application_name #=> String
resp.deployments_info[0].deployment_group_name #=> String
resp.deployments_info[0].deployment_config_name #=> String
resp.deployments_info[0].deployment_id #=> String
resp.deployments_info[0].previous_revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.deployments_info[0].previous_revision.s3_location.bucket #=> String
resp.deployments_info[0].previous_revision.s3_location.key #=> String
resp.deployments_info[0].previous_revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.deployments_info[0].previous_revision.s3_location.version #=> String
resp.deployments_info[0].previous_revision.s3_location.e_tag #=> String
resp.deployments_info[0].previous_revision.git_hub_location.repository #=> String
resp.deployments_info[0].previous_revision.git_hub_location.commit_id #=> String
resp.deployments_info[0].previous_revision.string.content #=> String
resp.deployments_info[0].previous_revision.string.sha256 #=> String
resp.deployments_info[0].revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.deployments_info[0].revision.s3_location.bucket #=> String
resp.deployments_info[0].revision.s3_location.key #=> String
resp.deployments_info[0].revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.deployments_info[0].revision.s3_location.version #=> String
resp.deployments_info[0].revision.s3_location.e_tag #=> String
resp.deployments_info[0].revision.git_hub_location.repository #=> String
resp.deployments_info[0].revision.git_hub_location.commit_id #=> String
resp.deployments_info[0].revision.string.content #=> String
resp.deployments_info[0].revision.string.sha256 #=> String
resp.deployments_info[0].status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
resp.deployments_info[0].error_information.code #=> String, one of "DEPLOYMENT_GROUP_MISSING", "APPLICATION_MISSING", "REVISION_MISSING", "IAM_ROLE_MISSING", "IAM_ROLE_PERMISSIONS", "NO_EC2_SUBSCRIPTION", "OVER_MAX_INSTANCES", "NO_INSTANCES", "TIMEOUT", "HEALTH_CONSTRAINTS_INVALID", "HEALTH_CONSTRAINTS", "INTERNAL_ERROR", "THROTTLED", "ALARM_ACTIVE", "AGENT_ISSUE", "AUTO_SCALING_IAM_ROLE_PERMISSIONS", "AUTO_SCALING_CONFIGURATION", "MANUAL_STOP", "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", "MISSING_ELB_INFORMATION", "MISSING_GITHUB_TOKEN", "ELASTIC_LOAD_BALANCING_INVALID", "ELB_INVALID_INSTANCE", "INVALID_LAMBDA_CONFIGURATION", "INVALID_LAMBDA_FUNCTION", "HOOK_EXECUTION_FAILURE"
resp.deployments_info[0].error_information.message #=> String
resp.deployments_info[0].create_time #=> Time
resp.deployments_info[0].start_time #=> Time
resp.deployments_info[0].complete_time #=> Time
resp.deployments_info[0].deployment_overview.pending #=> Integer
resp.deployments_info[0].deployment_overview.in_progress #=> Integer
resp.deployments_info[0].deployment_overview.succeeded #=> Integer
resp.deployments_info[0].deployment_overview.failed #=> Integer
resp.deployments_info[0].deployment_overview.skipped #=> Integer
resp.deployments_info[0].deployment_overview.ready #=> Integer
resp.deployments_info[0].description #=> String
resp.deployments_info[0].creator #=> String, one of "user", "autoscaling", "codeDeployRollback"
resp.deployments_info[0].ignore_application_stop_failures #=> Boolean
resp.deployments_info[0].auto_rollback_configuration.enabled #=> Boolean
resp.deployments_info[0].auto_rollback_configuration.events #=> Array
resp.deployments_info[0].auto_rollback_configuration.events[0] #=> String, one of "DEPLOYMENT_FAILURE", "DEPLOYMENT_STOP_ON_ALARM", "DEPLOYMENT_STOP_ON_REQUEST"
resp.deployments_info[0].update_outdated_instances_only #=> Boolean
resp.deployments_info[0].rollback_info.rollback_deployment_id #=> String
resp.deployments_info[0].rollback_info.rollback_triggering_deployment_id #=> String
resp.deployments_info[0].rollback_info.rollback_message #=> String
resp.deployments_info[0].deployment_style.deployment_type #=> String, one of "IN_PLACE", "BLUE_GREEN"
resp.deployments_info[0].deployment_style.deployment_option #=> String, one of "WITH_TRAFFIC_CONTROL", "WITHOUT_TRAFFIC_CONTROL"
resp.deployments_info[0].target_instances.tag_filters #=> Array
resp.deployments_info[0].target_instances.tag_filters[0].key #=> String
resp.deployments_info[0].target_instances.tag_filters[0].value #=> String
resp.deployments_info[0].target_instances.tag_filters[0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployments_info[0].target_instances.auto_scaling_groups #=> Array
resp.deployments_info[0].target_instances.auto_scaling_groups[0] #=> String
resp.deployments_info[0].target_instances.ec2_tag_set.ec2_tag_set_list #=> Array
resp.deployments_info[0].target_instances.ec2_tag_set.ec2_tag_set_list[0] #=> Array
resp.deployments_info[0].target_instances.ec2_tag_set.ec2_tag_set_list[0][0].key #=> String
resp.deployments_info[0].target_instances.ec2_tag_set.ec2_tag_set_list[0][0].value #=> String
resp.deployments_info[0].target_instances.ec2_tag_set.ec2_tag_set_list[0][0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployments_info[0].instance_termination_wait_time_started #=> Boolean
resp.deployments_info[0].blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.action #=> String, one of "TERMINATE", "KEEP_ALIVE"
resp.deployments_info[0].blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.termination_wait_time_in_minutes #=> Integer
resp.deployments_info[0].blue_green_deployment_configuration.deployment_ready_option.action_on_timeout #=> String, one of "CONTINUE_DEPLOYMENT", "STOP_DEPLOYMENT"
resp.deployments_info[0].blue_green_deployment_configuration.deployment_ready_option.wait_time_in_minutes #=> Integer
resp.deployments_info[0].blue_green_deployment_configuration.green_fleet_provisioning_option.action #=> String, one of "DISCOVER_EXISTING", "COPY_AUTO_SCALING_GROUP"
resp.deployments_info[0].load_balancer_info.elb_info_list #=> Array
resp.deployments_info[0].load_balancer_info.elb_info_list[0].name #=> String
resp.deployments_info[0].load_balancer_info.target_group_info_list #=> Array
resp.deployments_info[0].load_balancer_info.target_group_info_list[0].name #=> String
resp.deployments_info[0].additional_deployment_status_info #=> String
resp.deployments_info[0].file_exists_behavior #=> String, one of "DISALLOW", "OVERWRITE", "RETAIN"
resp.deployments_info[0].deployment_status_messages #=> Array
resp.deployments_info[0].deployment_status_messages[0] #=> String
resp.deployments_info[0].compute_platform #=> String, one of "Server", "Lambda"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_ids (required, Array<String>) —

    A list of deployment IDs, separated by spaces.

Returns:

See Also:



559
560
561
562
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 559

def batch_get_deployments(params = {}, options = {})
  req = build_request(:batch_get_deployments, params)
  req.send_request(options)
end

#batch_get_on_premises_instances(params = {}) ⇒ Types::BatchGetOnPremisesInstancesOutput

Gets information about one or more on-premises instances.

Examples:

Request syntax with placeholder values


resp = client.batch_get_on_premises_instances({
  instance_names: ["InstanceName"], # required
})

Response structure


resp.instance_infos #=> Array
resp.instance_infos[0].instance_name #=> String
resp.instance_infos[0].iam_session_arn #=> String
resp.instance_infos[0].iam_user_arn #=> String
resp.instance_infos[0].instance_arn #=> String
resp.instance_infos[0].register_time #=> Time
resp.instance_infos[0].deregister_time #=> Time
resp.instance_infos[0].tags #=> Array
resp.instance_infos[0].tags[0].key #=> String
resp.instance_infos[0].tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :instance_names (required, Array<String>) —

    The names of the on-premises instances about which to get information.

Returns:

See Also:



596
597
598
599
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 596

def batch_get_on_premises_instances(params = {}, options = {})
  req = build_request(:batch_get_on_premises_instances, params)
  req.send_request(options)
end

#continue_deployment(params = {}) ⇒ Struct

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. (Traffic rerouting, which is achieved by registering instances in the replacement environment with the load balancer, can start as soon as all instances have a status of Ready.)

Examples:

Request syntax with placeholder values


resp = client.continue_deployment({
  deployment_id: "DeploymentId",
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (String) —

    The deployment ID of the blue/green deployment for which you want to start rerouting traffic to the replacement environment.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



624
625
626
627
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 624

def continue_deployment(params = {}, options = {})
  req = build_request(:continue_deployment, params)
  req.send_request(options)
end

#create_application(params = {}) ⇒ Types::CreateApplicationOutput

Creates an application.

Examples:

Request syntax with placeholder values


resp = client.create_application({
  application_name: "ApplicationName", # required
  compute_platform: "Server", # accepts Server, Lambda
})

Response structure


resp.application_id #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of the application. This name must be unique with the applicable IAM user or AWS account.

  • :compute_platform (String) —

    The destination platform type for the deployment (Lambda or Server).

Returns:

See Also:



658
659
660
661
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 658

def create_application(params = {}, options = {})
  req = build_request(:create_application, params)
  req.send_request(options)
end

#create_deployment(params = {}) ⇒ Types::CreateDeploymentOutput

Deploys an application revision through the specified deployment group.

Examples:

Request syntax with placeholder values


resp = client.create_deployment({
  application_name: "ApplicationName", # required
  deployment_group_name: "DeploymentGroupName",
  revision: {
    revision_type: "S3", # accepts S3, GitHub, String
    s3_location: {
      bucket: "S3Bucket",
      key: "S3Key",
      bundle_type: "tar", # accepts tar, tgz, zip, YAML, JSON
      version: "VersionId",
      e_tag: "ETag",
    },
    git_hub_location: {
      repository: "Repository",
      commit_id: "CommitId",
    },
    string: {
      content: "RawStringContent",
      sha256: "RawStringSha256",
    },
  },
  deployment_config_name: "DeploymentConfigName",
  description: "Description",
  ignore_application_stop_failures: false,
  target_instances: {
    tag_filters: [
      {
        key: "Key",
        value: "Value",
        type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
      },
    ],
    auto_scaling_groups: ["AutoScalingGroupName"],
    ec2_tag_set: {
      ec2_tag_set_list: [
        [
          {
            key: "Key",
            value: "Value",
            type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
          },
        ],
      ],
    },
  },
  auto_rollback_configuration: {
    enabled: false,
    events: ["DEPLOYMENT_FAILURE"], # accepts DEPLOYMENT_FAILURE, DEPLOYMENT_STOP_ON_ALARM, DEPLOYMENT_STOP_ON_REQUEST
  },
  update_outdated_instances_only: false,
  file_exists_behavior: "DISALLOW", # accepts DISALLOW, OVERWRITE, RETAIN
})

Response structure


resp.deployment_id #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :deployment_group_name (String) —

    The name of the deployment group.

  • :revision (Types::RevisionLocation) —

    The type and location of the revision to deploy.

  • :deployment_config_name (String) —

    The name of a deployment configuration associated with the applicable IAM user or AWS account.

    If not specified, the value configured in the deployment group will be used as the default. If the deployment group does not have a deployment configuration associated with it, then CodeDeployDefault.OneAtATime will be used by default.

  • :description (String) —

    A comment about the deployment.

  • :ignore_application_stop_failures (Boolean) —

    If set to true, then if the deployment causes the ApplicationStop deployment lifecycle event to an instance to fail, the deployment to that instance will not be considered to have failed at that point and will continue on to the BeforeInstall deployment lifecycle event.

    If set to false or not specified, then if the deployment causes the ApplicationStop deployment lifecycle event to fail to an instance, the deployment to that instance will stop, and the deployment to that instance will be considered to have failed.

  • :target_instances (Types::TargetInstances) —

    Information about the instances that will belong to the replacement environment in a blue/green deployment.

  • :auto_rollback_configuration (Types::AutoRollbackConfiguration) —

    Configuration information for an automatic rollback that is added when a deployment is created.

  • :update_outdated_instances_only (Boolean) —

    Indicates whether to deploy to all instances or only to instances that are not running the latest application revision.

  • :file_exists_behavior (String) —

    Information about how AWS CodeDeploy handles files that already exist in a deployment target location but weren't part of the previous successful deployment.

    The fileExistsBehavior parameter takes any of the following values:

    • DISALLOW: The deployment fails. This is also the default behavior if no option is specified.

    • OVERWRITE: The version of the file from the application revision currently being deployed replaces the version already on the instance.

    • RETAIN: The version of the file already on the instance is kept and used as part of the new deployment.

Returns:

See Also:



795
796
797
798
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 795

def create_deployment(params = {}, options = {})
  req = build_request(:create_deployment, params)
  req.send_request(options)
end

#create_deployment_config(params = {}) ⇒ Types::CreateDeploymentConfigOutput

Creates a deployment configuration.

Examples:

Request syntax with placeholder values


resp = client.create_deployment_config({
  deployment_config_name: "DeploymentConfigName", # required
  minimum_healthy_hosts: {
    value: 1,
    type: "HOST_COUNT", # accepts HOST_COUNT, FLEET_PERCENT
  },
  traffic_routing_config: {
    type: "TimeBasedCanary", # accepts TimeBasedCanary, TimeBasedLinear, AllAtOnce
    time_based_canary: {
      canary_percentage: 1,
      canary_interval: 1,
    },
    time_based_linear: {
      linear_percentage: 1,
      linear_interval: 1,
    },
  },
  compute_platform: "Server", # accepts Server, Lambda
})

Response structure


resp.deployment_config_id #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_config_name (required, String) —

    The name of the deployment configuration to create.

  • :minimum_healthy_hosts (Types::MinimumHealthyHosts) —

    The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value.

    The type parameter takes either of the following values:

    • HOST_COUNT: The value parameter represents the minimum number of healthy instances as an absolute value.

    • FLEET_PERCENT: The value parameter represents the minimum number of healthy instances as a percentage of the total number of instances in the deployment. If you specify FLEET_PERCENT, at the start of the deployment, AWS CodeDeploy converts the percentage to the equivalent number of instance and rounds up fractional instances.

    The value parameter takes an integer.

    For example, to set a minimum of 95% healthy instance, specify a type of FLEET_PERCENT and a value of 95.

  • :traffic_routing_config (Types::TrafficRoutingConfig) —

    The configuration that specifies how the deployment traffic will be routed.

  • :compute_platform (String) —

    The destination platform type for the deployment (Lambda or Server>).

Returns:

See Also:



868
869
870
871
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 868

def create_deployment_config(params = {}, options = {})
  req = build_request(:create_deployment_config, params)
  req.send_request(options)
end

#create_deployment_group(params = {}) ⇒ Types::CreateDeploymentGroupOutput

Creates a deployment group to which application revisions will be deployed.

Examples:

Request syntax with placeholder values


resp = client.create_deployment_group({
  application_name: "ApplicationName", # required
  deployment_group_name: "DeploymentGroupName", # required
  deployment_config_name: "DeploymentConfigName",
  ec2_tag_filters: [
    {
      key: "Key",
      value: "Value",
      type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
    },
  ],
  on_premises_instance_tag_filters: [
    {
      key: "Key",
      value: "Value",
      type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
    },
  ],
  auto_scaling_groups: ["AutoScalingGroupName"],
  service_role_arn: "Role", # required
  trigger_configurations: [
    {
      trigger_name: "TriggerName",
      trigger_target_arn: "TriggerTargetArn",
      trigger_events: ["DeploymentStart"], # accepts DeploymentStart, DeploymentSuccess, DeploymentFailure, DeploymentStop, DeploymentRollback, DeploymentReady, InstanceStart, InstanceSuccess, InstanceFailure, InstanceReady
    },
  ],
  alarm_configuration: {
    enabled: false,
    ignore_poll_alarm_failure: false,
    alarms: [
      {
        name: "AlarmName",
      },
    ],
  },
  auto_rollback_configuration: {
    enabled: false,
    events: ["DEPLOYMENT_FAILURE"], # accepts DEPLOYMENT_FAILURE, DEPLOYMENT_STOP_ON_ALARM, DEPLOYMENT_STOP_ON_REQUEST
  },
  deployment_style: {
    deployment_type: "IN_PLACE", # accepts IN_PLACE, BLUE_GREEN
    deployment_option: "WITH_TRAFFIC_CONTROL", # accepts WITH_TRAFFIC_CONTROL, WITHOUT_TRAFFIC_CONTROL
  },
  blue_green_deployment_configuration: {
    terminate_blue_instances_on_deployment_success: {
      action: "TERMINATE", # accepts TERMINATE, KEEP_ALIVE
      termination_wait_time_in_minutes: 1,
    },
    deployment_ready_option: {
      action_on_timeout: "CONTINUE_DEPLOYMENT", # accepts CONTINUE_DEPLOYMENT, STOP_DEPLOYMENT
      wait_time_in_minutes: 1,
    },
    green_fleet_provisioning_option: {
      action: "DISCOVER_EXISTING", # accepts DISCOVER_EXISTING, COPY_AUTO_SCALING_GROUP
    },
  },
  load_balancer_info: {
    elb_info_list: [
      {
        name: "ELBName",
      },
    ],
    target_group_info_list: [
      {
        name: "TargetGroupName",
      },
    ],
  },
  ec2_tag_set: {
    ec2_tag_set_list: [
      [
        {
          key: "Key",
          value: "Value",
          type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
        },
      ],
    ],
  },
  on_premises_tag_set: {
    on_premises_tag_set_list: [
      [
        {
          key: "Key",
          value: "Value",
          type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
        },
      ],
    ],
  },
})

Response structure


resp.deployment_group_id #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :deployment_group_name (required, String) —

    The name of a new deployment group for the specified application.

  • :deployment_config_name (String) —

    If specified, the deployment configuration name can be either one of the predefined configurations provided with AWS CodeDeploy or a custom deployment configuration that you create by calling the create deployment configuration operation.

    CodeDeployDefault.OneAtATime is the default deployment configuration. It is used if a configuration isn't specified for the deployment or the deployment group.

    For more information about the predefined deployment configurations in AWS CodeDeploy, see Working with Deployment Groups in AWS CodeDeploy in the AWS CodeDeploy User Guide.

  • :ec2_tag_filters (Array<Types::EC2TagFilter>) —

    The Amazon EC2 tags on which to filter. The deployment group will include EC2 instances with any of the specified tags. Cannot be used in the same call as ec2TagSet.

  • :on_premises_instance_tag_filters (Array<Types::TagFilter>) —

    The on-premises instance tags on which to filter. The deployment group will include on-premises instances with any of the specified tags. Cannot be used in the same call as OnPremisesTagSet.

  • :auto_scaling_groups (Array<String>) —

    A list of associated Auto Scaling groups.

  • :service_role_arn (required, String) —

    A service role ARN that allows AWS CodeDeploy to act on the user's behalf when interacting with AWS services.

  • :trigger_configurations (Array<Types::TriggerConfig>) —

    Information about triggers to create when the deployment group is created. For examples, see Create a Trigger for an AWS CodeDeploy Event in the AWS CodeDeploy User Guide.

  • :alarm_configuration (Types::AlarmConfiguration) —

    Information to add about Amazon CloudWatch alarms when the deployment group is created.

  • :auto_rollback_configuration (Types::AutoRollbackConfiguration) —

    Configuration information for an automatic rollback that is added when a deployment group is created.

  • :deployment_style (Types::DeploymentStyle) —

    Information about the type of deployment, in-place or blue/green, that you want to run and whether to route deployment traffic behind a load balancer.

  • :blue_green_deployment_configuration (Types::BlueGreenDeploymentConfiguration) —

    Information about blue/green deployment options for a deployment group.

  • :load_balancer_info (Types::LoadBalancerInfo) —

    Information about the load balancer used in a deployment.

  • :ec2_tag_set (Types::EC2TagSet) —

    Information about groups of tags applied to EC2 instances. The deployment group will include only EC2 instances identified by all the tag groups. Cannot be used in the same call as ec2TagFilters.

  • :on_premises_tag_set (Types::OnPremisesTagSet) —

    Information about groups of tags applied to on-premises instances. The deployment group will include only on-premises instances identified by all the tag groups. Cannot be used in the same call as onPremisesInstanceTagFilters.

Returns:

See Also:



1065
1066
1067
1068
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1065

def create_deployment_group(params = {}, options = {})
  req = build_request(:create_deployment_group, params)
  req.send_request(options)
end

#delete_application(params = {}) ⇒ Struct

Deletes an application.

Examples:

Request syntax with placeholder values


resp = client.delete_application({
  application_name: "ApplicationName", # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



1088
1089
1090
1091
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1088

def delete_application(params = {}, options = {})
  req = build_request(:delete_application, params)
  req.send_request(options)
end

#delete_deployment_config(params = {}) ⇒ Struct

Deletes a deployment configuration.

A deployment configuration cannot be deleted if it is currently in use. Predefined configurations cannot be deleted.

Examples:

Request syntax with placeholder values


resp = client.delete_deployment_config({
  deployment_config_name: "DeploymentConfigName", # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_config_name (required, String) —

    The name of a deployment configuration associated with the applicable IAM user or AWS account.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



1116
1117
1118
1119
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1116

def delete_deployment_config(params = {}, options = {})
  req = build_request(:delete_deployment_config, params)
  req.send_request(options)
end

#delete_deployment_group(params = {}) ⇒ Types::DeleteDeploymentGroupOutput

Deletes a deployment group.

Examples:

Request syntax with placeholder values


resp = client.delete_deployment_group({
  application_name: "ApplicationName", # required
  deployment_group_name: "DeploymentGroupName", # required
})

Response structure


resp.hooks_not_cleaned_up #=> Array
resp.hooks_not_cleaned_up[0].name #=> String
resp.hooks_not_cleaned_up[0].hook #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :deployment_group_name (required, String) —

    The name of an existing deployment group for the specified application.

Returns:

See Also:



1152
1153
1154
1155
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1152

def delete_deployment_group(params = {}, options = {})
  req = build_request(:delete_deployment_group, params)
  req.send_request(options)
end

#delete_git_hub_account_token(params = {}) ⇒ Types::DeleteGitHubAccountTokenOutput

Deletes a GitHub account connection.

Examples:

Request syntax with placeholder values


resp = client.({
  token_name: "GitHubAccountTokenName",
})

Response structure


resp.token_name #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :token_name (String) —

    The name of the GitHub account connection to delete.

Returns:

See Also:



1180
1181
1182
1183
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1180

def (params = {}, options = {})
  req = build_request(:delete_git_hub_account_token, params)
  req.send_request(options)
end

#deregister_on_premises_instance(params = {}) ⇒ Struct

Deregisters an on-premises instance.

Examples:

Request syntax with placeholder values


resp = client.deregister_on_premises_instance({
  instance_name: "InstanceName", # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :instance_name (required, String) —

    The name of the on-premises instance to deregister.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



1202
1203
1204
1205
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1202

def deregister_on_premises_instance(params = {}, options = {})
  req = build_request(:deregister_on_premises_instance, params)
  req.send_request(options)
end

#get_application(params = {}) ⇒ Types::GetApplicationOutput

Gets information about an application.

Examples:

Request syntax with placeholder values


resp = client.get_application({
  application_name: "ApplicationName", # required
})

Response structure


resp.application.application_id #=> String
resp.application.application_name #=> String
resp.application.create_time #=> Time
resp.application.linked_to_git_hub #=> Boolean
resp.application. #=> String
resp.application.compute_platform #=> String, one of "Server", "Lambda"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

Returns:

See Also:



1236
1237
1238
1239
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1236

def get_application(params = {}, options = {})
  req = build_request(:get_application, params)
  req.send_request(options)
end

#get_application_revision(params = {}) ⇒ Types::GetApplicationRevisionOutput

Gets information about an application revision.

Examples:

Request syntax with placeholder values


resp = client.get_application_revision({
  application_name: "ApplicationName", # required
  revision: { # required
    revision_type: "S3", # accepts S3, GitHub, String
    s3_location: {
      bucket: "S3Bucket",
      key: "S3Key",
      bundle_type: "tar", # accepts tar, tgz, zip, YAML, JSON
      version: "VersionId",
      e_tag: "ETag",
    },
    git_hub_location: {
      repository: "Repository",
      commit_id: "CommitId",
    },
    string: {
      content: "RawStringContent",
      sha256: "RawStringSha256",
    },
  },
})

Response structure


resp.application_name #=> String
resp.revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.revision.s3_location.bucket #=> String
resp.revision.s3_location.key #=> String
resp.revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.revision.s3_location.version #=> String
resp.revision.s3_location.e_tag #=> String
resp.revision.git_hub_location.repository #=> String
resp.revision.git_hub_location.commit_id #=> String
resp.revision.string.content #=> String
resp.revision.string.sha256 #=> String
resp.revision_info.description #=> String
resp.revision_info.deployment_groups #=> Array
resp.revision_info.deployment_groups[0] #=> String
resp.revision_info.first_used_time #=> Time
resp.revision_info.last_used_time #=> Time
resp.revision_info.register_time #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of the application that corresponds to the revision.

  • :revision (required, Types::RevisionLocation) —

    Information about the application revision to get, including type and location.

Returns:

See Also:



1304
1305
1306
1307
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1304

def get_application_revision(params = {}, options = {})
  req = build_request(:get_application_revision, params)
  req.send_request(options)
end

#get_deployment(params = {}) ⇒ Types::GetDeploymentOutput

Gets information about a deployment.

Examples:

Request syntax with placeholder values


resp = client.get_deployment({
  deployment_id: "DeploymentId", # required
})

Response structure


resp.deployment_info.application_name #=> String
resp.deployment_info.deployment_group_name #=> String
resp.deployment_info.deployment_config_name #=> String
resp.deployment_info.deployment_id #=> String
resp.deployment_info.previous_revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.deployment_info.previous_revision.s3_location.bucket #=> String
resp.deployment_info.previous_revision.s3_location.key #=> String
resp.deployment_info.previous_revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.deployment_info.previous_revision.s3_location.version #=> String
resp.deployment_info.previous_revision.s3_location.e_tag #=> String
resp.deployment_info.previous_revision.git_hub_location.repository #=> String
resp.deployment_info.previous_revision.git_hub_location.commit_id #=> String
resp.deployment_info.previous_revision.string.content #=> String
resp.deployment_info.previous_revision.string.sha256 #=> String
resp.deployment_info.revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.deployment_info.revision.s3_location.bucket #=> String
resp.deployment_info.revision.s3_location.key #=> String
resp.deployment_info.revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.deployment_info.revision.s3_location.version #=> String
resp.deployment_info.revision.s3_location.e_tag #=> String
resp.deployment_info.revision.git_hub_location.repository #=> String
resp.deployment_info.revision.git_hub_location.commit_id #=> String
resp.deployment_info.revision.string.content #=> String
resp.deployment_info.revision.string.sha256 #=> String
resp.deployment_info.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
resp.deployment_info.error_information.code #=> String, one of "DEPLOYMENT_GROUP_MISSING", "APPLICATION_MISSING", "REVISION_MISSING", "IAM_ROLE_MISSING", "IAM_ROLE_PERMISSIONS", "NO_EC2_SUBSCRIPTION", "OVER_MAX_INSTANCES", "NO_INSTANCES", "TIMEOUT", "HEALTH_CONSTRAINTS_INVALID", "HEALTH_CONSTRAINTS", "INTERNAL_ERROR", "THROTTLED", "ALARM_ACTIVE", "AGENT_ISSUE", "AUTO_SCALING_IAM_ROLE_PERMISSIONS", "AUTO_SCALING_CONFIGURATION", "MANUAL_STOP", "MISSING_BLUE_GREEN_DEPLOYMENT_CONFIGURATION", "MISSING_ELB_INFORMATION", "MISSING_GITHUB_TOKEN", "ELASTIC_LOAD_BALANCING_INVALID", "ELB_INVALID_INSTANCE", "INVALID_LAMBDA_CONFIGURATION", "INVALID_LAMBDA_FUNCTION", "HOOK_EXECUTION_FAILURE"
resp.deployment_info.error_information.message #=> String
resp.deployment_info.create_time #=> Time
resp.deployment_info.start_time #=> Time
resp.deployment_info.complete_time #=> Time
resp.deployment_info.deployment_overview.pending #=> Integer
resp.deployment_info.deployment_overview.in_progress #=> Integer
resp.deployment_info.deployment_overview.succeeded #=> Integer
resp.deployment_info.deployment_overview.failed #=> Integer
resp.deployment_info.deployment_overview.skipped #=> Integer
resp.deployment_info.deployment_overview.ready #=> Integer
resp.deployment_info.description #=> String
resp.deployment_info.creator #=> String, one of "user", "autoscaling", "codeDeployRollback"
resp.deployment_info.ignore_application_stop_failures #=> Boolean
resp.deployment_info.auto_rollback_configuration.enabled #=> Boolean
resp.deployment_info.auto_rollback_configuration.events #=> Array
resp.deployment_info.auto_rollback_configuration.events[0] #=> String, one of "DEPLOYMENT_FAILURE", "DEPLOYMENT_STOP_ON_ALARM", "DEPLOYMENT_STOP_ON_REQUEST"
resp.deployment_info.update_outdated_instances_only #=> Boolean
resp.deployment_info.rollback_info.rollback_deployment_id #=> String
resp.deployment_info.rollback_info.rollback_triggering_deployment_id #=> String
resp.deployment_info.rollback_info.rollback_message #=> String
resp.deployment_info.deployment_style.deployment_type #=> String, one of "IN_PLACE", "BLUE_GREEN"
resp.deployment_info.deployment_style.deployment_option #=> String, one of "WITH_TRAFFIC_CONTROL", "WITHOUT_TRAFFIC_CONTROL"
resp.deployment_info.target_instances.tag_filters #=> Array
resp.deployment_info.target_instances.tag_filters[0].key #=> String
resp.deployment_info.target_instances.tag_filters[0].value #=> String
resp.deployment_info.target_instances.tag_filters[0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_info.target_instances.auto_scaling_groups #=> Array
resp.deployment_info.target_instances.auto_scaling_groups[0] #=> String
resp.deployment_info.target_instances.ec2_tag_set.ec2_tag_set_list #=> Array
resp.deployment_info.target_instances.ec2_tag_set.ec2_tag_set_list[0] #=> Array
resp.deployment_info.target_instances.ec2_tag_set.ec2_tag_set_list[0][0].key #=> String
resp.deployment_info.target_instances.ec2_tag_set.ec2_tag_set_list[0][0].value #=> String
resp.deployment_info.target_instances.ec2_tag_set.ec2_tag_set_list[0][0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_info.instance_termination_wait_time_started #=> Boolean
resp.deployment_info.blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.action #=> String, one of "TERMINATE", "KEEP_ALIVE"
resp.deployment_info.blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.termination_wait_time_in_minutes #=> Integer
resp.deployment_info.blue_green_deployment_configuration.deployment_ready_option.action_on_timeout #=> String, one of "CONTINUE_DEPLOYMENT", "STOP_DEPLOYMENT"
resp.deployment_info.blue_green_deployment_configuration.deployment_ready_option.wait_time_in_minutes #=> Integer
resp.deployment_info.blue_green_deployment_configuration.green_fleet_provisioning_option.action #=> String, one of "DISCOVER_EXISTING", "COPY_AUTO_SCALING_GROUP"
resp.deployment_info.load_balancer_info.elb_info_list #=> Array
resp.deployment_info.load_balancer_info.elb_info_list[0].name #=> String
resp.deployment_info.load_balancer_info.target_group_info_list #=> Array
resp.deployment_info.load_balancer_info.target_group_info_list[0].name #=> String
resp.deployment_info.additional_deployment_status_info #=> String
resp.deployment_info.file_exists_behavior #=> String, one of "DISALLOW", "OVERWRITE", "RETAIN"
resp.deployment_info.deployment_status_messages #=> Array
resp.deployment_info.deployment_status_messages[0] #=> String
resp.deployment_info.compute_platform #=> String, one of "Server", "Lambda"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (required, String) —

    A deployment ID associated with the applicable IAM user or AWS account.

Returns:

See Also:



1406
1407
1408
1409
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1406

def get_deployment(params = {}, options = {})
  req = build_request(:get_deployment, params)
  req.send_request(options)
end

#get_deployment_config(params = {}) ⇒ Types::GetDeploymentConfigOutput

Gets information about a deployment configuration.

Examples:

Request syntax with placeholder values


resp = client.get_deployment_config({
  deployment_config_name: "DeploymentConfigName", # required
})

Response structure


resp.deployment_config_info.deployment_config_id #=> String
resp.deployment_config_info.deployment_config_name #=> String
resp.deployment_config_info.minimum_healthy_hosts.value #=> Integer
resp.deployment_config_info.minimum_healthy_hosts.type #=> String, one of "HOST_COUNT", "FLEET_PERCENT"
resp.deployment_config_info.create_time #=> Time
resp.deployment_config_info.compute_platform #=> String, one of "Server", "Lambda"
resp.deployment_config_info.traffic_routing_config.type #=> String, one of "TimeBasedCanary", "TimeBasedLinear", "AllAtOnce"
resp.deployment_config_info.traffic_routing_config.time_based_canary.canary_percentage #=> Integer
resp.deployment_config_info.traffic_routing_config.time_based_canary.canary_interval #=> Integer
resp.deployment_config_info.traffic_routing_config.time_based_linear.linear_percentage #=> Integer
resp.deployment_config_info.traffic_routing_config.time_based_linear.linear_interval #=> Integer

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_config_name (required, String) —

    The name of a deployment configuration associated with the applicable IAM user or AWS account.

Returns:

See Also:



1445
1446
1447
1448
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1445

def get_deployment_config(params = {}, options = {})
  req = build_request(:get_deployment_config, params)
  req.send_request(options)
end

#get_deployment_group(params = {}) ⇒ Types::GetDeploymentGroupOutput

Gets information about a deployment group.

Examples:

Request syntax with placeholder values


resp = client.get_deployment_group({
  application_name: "ApplicationName", # required
  deployment_group_name: "DeploymentGroupName", # required
})

Response structure


resp.deployment_group_info.application_name #=> String
resp.deployment_group_info.deployment_group_id #=> String
resp.deployment_group_info.deployment_group_name #=> String
resp.deployment_group_info.deployment_config_name #=> String
resp.deployment_group_info.ec2_tag_filters #=> Array
resp.deployment_group_info.ec2_tag_filters[0].key #=> String
resp.deployment_group_info.ec2_tag_filters[0].value #=> String
resp.deployment_group_info.ec2_tag_filters[0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_group_info.on_premises_instance_tag_filters #=> Array
resp.deployment_group_info.on_premises_instance_tag_filters[0].key #=> String
resp.deployment_group_info.on_premises_instance_tag_filters[0].value #=> String
resp.deployment_group_info.on_premises_instance_tag_filters[0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_group_info.auto_scaling_groups #=> Array
resp.deployment_group_info.auto_scaling_groups[0].name #=> String
resp.deployment_group_info.auto_scaling_groups[0].hook #=> String
resp.deployment_group_info.service_role_arn #=> String
resp.deployment_group_info.target_revision.revision_type #=> String, one of "S3", "GitHub", "String"
resp.deployment_group_info.target_revision.s3_location.bucket #=> String
resp.deployment_group_info.target_revision.s3_location.key #=> String
resp.deployment_group_info.target_revision.s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.deployment_group_info.target_revision.s3_location.version #=> String
resp.deployment_group_info.target_revision.s3_location.e_tag #=> String
resp.deployment_group_info.target_revision.git_hub_location.repository #=> String
resp.deployment_group_info.target_revision.git_hub_location.commit_id #=> String
resp.deployment_group_info.target_revision.string.content #=> String
resp.deployment_group_info.target_revision.string.sha256 #=> String
resp.deployment_group_info.trigger_configurations #=> Array
resp.deployment_group_info.trigger_configurations[0].trigger_name #=> String
resp.deployment_group_info.trigger_configurations[0].trigger_target_arn #=> String
resp.deployment_group_info.trigger_configurations[0].trigger_events #=> Array
resp.deployment_group_info.trigger_configurations[0].trigger_events[0] #=> String, one of "DeploymentStart", "DeploymentSuccess", "DeploymentFailure", "DeploymentStop", "DeploymentRollback", "DeploymentReady", "InstanceStart", "InstanceSuccess", "InstanceFailure", "InstanceReady"
resp.deployment_group_info.alarm_configuration.enabled #=> Boolean
resp.deployment_group_info.alarm_configuration.ignore_poll_alarm_failure #=> Boolean
resp.deployment_group_info.alarm_configuration.alarms #=> Array
resp.deployment_group_info.alarm_configuration.alarms[0].name #=> String
resp.deployment_group_info.auto_rollback_configuration.enabled #=> Boolean
resp.deployment_group_info.auto_rollback_configuration.events #=> Array
resp.deployment_group_info.auto_rollback_configuration.events[0] #=> String, one of "DEPLOYMENT_FAILURE", "DEPLOYMENT_STOP_ON_ALARM", "DEPLOYMENT_STOP_ON_REQUEST"
resp.deployment_group_info.deployment_style.deployment_type #=> String, one of "IN_PLACE", "BLUE_GREEN"
resp.deployment_group_info.deployment_style.deployment_option #=> String, one of "WITH_TRAFFIC_CONTROL", "WITHOUT_TRAFFIC_CONTROL"
resp.deployment_group_info.blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.action #=> String, one of "TERMINATE", "KEEP_ALIVE"
resp.deployment_group_info.blue_green_deployment_configuration.terminate_blue_instances_on_deployment_success.termination_wait_time_in_minutes #=> Integer
resp.deployment_group_info.blue_green_deployment_configuration.deployment_ready_option.action_on_timeout #=> String, one of "CONTINUE_DEPLOYMENT", "STOP_DEPLOYMENT"
resp.deployment_group_info.blue_green_deployment_configuration.deployment_ready_option.wait_time_in_minutes #=> Integer
resp.deployment_group_info.blue_green_deployment_configuration.green_fleet_provisioning_option.action #=> String, one of "DISCOVER_EXISTING", "COPY_AUTO_SCALING_GROUP"
resp.deployment_group_info.load_balancer_info.elb_info_list #=> Array
resp.deployment_group_info.load_balancer_info.elb_info_list[0].name #=> String
resp.deployment_group_info.load_balancer_info.target_group_info_list #=> Array
resp.deployment_group_info.load_balancer_info.target_group_info_list[0].name #=> String
resp.deployment_group_info.last_successful_deployment.deployment_id #=> String
resp.deployment_group_info.last_successful_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
resp.deployment_group_info.last_successful_deployment.end_time #=> Time
resp.deployment_group_info.last_successful_deployment.create_time #=> Time
resp.deployment_group_info.last_attempted_deployment.deployment_id #=> String
resp.deployment_group_info.last_attempted_deployment.status #=> String, one of "Created", "Queued", "InProgress", "Succeeded", "Failed", "Stopped", "Ready"
resp.deployment_group_info.last_attempted_deployment.end_time #=> Time
resp.deployment_group_info.last_attempted_deployment.create_time #=> Time
resp.deployment_group_info.ec2_tag_set.ec2_tag_set_list #=> Array
resp.deployment_group_info.ec2_tag_set.ec2_tag_set_list[0] #=> Array
resp.deployment_group_info.ec2_tag_set.ec2_tag_set_list[0][0].key #=> String
resp.deployment_group_info.ec2_tag_set.ec2_tag_set_list[0][0].value #=> String
resp.deployment_group_info.ec2_tag_set.ec2_tag_set_list[0][0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_group_info.on_premises_tag_set.on_premises_tag_set_list #=> Array
resp.deployment_group_info.on_premises_tag_set.on_premises_tag_set_list[0] #=> Array
resp.deployment_group_info.on_premises_tag_set.on_premises_tag_set_list[0][0].key #=> String
resp.deployment_group_info.on_premises_tag_set.on_premises_tag_set_list[0][0].value #=> String
resp.deployment_group_info.on_premises_tag_set.on_premises_tag_set_list[0][0].type #=> String, one of "KEY_ONLY", "VALUE_ONLY", "KEY_AND_VALUE"
resp.deployment_group_info.compute_platform #=> String, one of "Server", "Lambda"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :deployment_group_name (required, String) —

    The name of an existing deployment group for the specified application.

Returns:

See Also:



1546
1547
1548
1549
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1546

def get_deployment_group(params = {}, options = {})
  req = build_request(:get_deployment_group, params)
  req.send_request(options)
end

#get_deployment_instance(params = {}) ⇒ Types::GetDeploymentInstanceOutput

Gets information about an instance as part of a deployment.

Examples:

Request syntax with placeholder values


resp = client.get_deployment_instance({
  deployment_id: "DeploymentId", # required
  instance_id: "InstanceId", # required
})

Response structure


resp.instance_summary.deployment_id #=> String
resp.instance_summary.instance_id #=> String
resp.instance_summary.status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown", "Ready"
resp.instance_summary.last_updated_at #=> Time
resp.instance_summary.lifecycle_events #=> Array
resp.instance_summary.lifecycle_events[0].lifecycle_event_name #=> String
resp.instance_summary.lifecycle_events[0].diagnostics.error_code #=> String, one of "Success", "ScriptMissing", "ScriptNotExecutable", "ScriptTimedOut", "ScriptFailed", "UnknownError"
resp.instance_summary.lifecycle_events[0].diagnostics.script_name #=> String
resp.instance_summary.lifecycle_events[0].diagnostics.message #=> String
resp.instance_summary.lifecycle_events[0].diagnostics.log_tail #=> String
resp.instance_summary.lifecycle_events[0].start_time #=> Time
resp.instance_summary.lifecycle_events[0].end_time #=> Time
resp.instance_summary.lifecycle_events[0].status #=> String, one of "Pending", "InProgress", "Succeeded", "Failed", "Skipped", "Unknown"
resp.instance_summary.instance_type #=> String, one of "Blue", "Green"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (required, String) —

    The unique ID of a deployment.

  • :instance_id (required, String) —

    The unique ID of an instance in the deployment group.

Returns:

See Also:



1591
1592
1593
1594
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1591

def get_deployment_instance(params = {}, options = {})
  req = build_request(:get_deployment_instance, params)
  req.send_request(options)
end

#get_on_premises_instance(params = {}) ⇒ Types::GetOnPremisesInstanceOutput

Gets information about an on-premises instance.

Examples:

Request syntax with placeholder values


resp = client.get_on_premises_instance({
  instance_name: "InstanceName", # required
})

Response structure


resp.instance_info.instance_name #=> String
resp.instance_info.iam_session_arn #=> String
resp.instance_info.iam_user_arn #=> String
resp.instance_info.instance_arn #=> String
resp.instance_info.register_time #=> Time
resp.instance_info.deregister_time #=> Time
resp.instance_info.tags #=> Array
resp.instance_info.tags[0].key #=> String
resp.instance_info.tags[0].value #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :instance_name (required, String) —

    The name of the on-premises instance about which to get information.

Returns:

See Also:



1627
1628
1629
1630
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1627

def get_on_premises_instance(params = {}, options = {})
  req = build_request(:get_on_premises_instance, params)
  req.send_request(options)
end

#list_application_revisions(params = {}) ⇒ Types::ListApplicationRevisionsOutput

Lists information about revisions for an application.

Examples:

Request syntax with placeholder values


resp = client.list_application_revisions({
  application_name: "ApplicationName", # required
  sort_by: "registerTime", # accepts registerTime, firstUsedTime, lastUsedTime
  sort_order: "ascending", # accepts ascending, descending
  s3_bucket: "S3Bucket",
  s3_key_prefix: "S3Key",
  deployed: "include", # accepts include, exclude, ignore
  next_token: "NextToken",
})

Response structure


resp.revisions #=> Array
resp.revisions[0].revision_type #=> String, one of "S3", "GitHub", "String"
resp.revisions[0].s3_location.bucket #=> String
resp.revisions[0].s3_location.key #=> String
resp.revisions[0].s3_location.bundle_type #=> String, one of "tar", "tgz", "zip", "YAML", "JSON"
resp.revisions[0].s3_location.version #=> String
resp.revisions[0].s3_location.e_tag #=> String
resp.revisions[0].git_hub_location.repository #=> String
resp.revisions[0].git_hub_location.commit_id #=> String
resp.revisions[0].string.content #=> String
resp.revisions[0].string.sha256 #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :sort_by (String) —

    The column name to use to sort the list results:

    • registerTime: Sort by the time the revisions were registered with AWS CodeDeploy.

    • firstUsedTime: Sort by the time the revisions were first used in a deployment.

    • lastUsedTime: Sort by the time the revisions were last used in a deployment.

    If not specified or set to null, the results will be returned in an arbitrary order.

  • :sort_order (String) —

    The order in which to sort the list results:

    • ascending: ascending order.

    • descending: descending order.

    If not specified, the results will be sorted in ascending order.

    If set to null, the results will be sorted in an arbitrary order.

  • :s3_bucket (String) —

    An Amazon S3 bucket name to limit the search for revisions.

    If set to null, all of the user's buckets will be searched.

  • :s3_key_prefix (String) —

    A key prefix for the set of Amazon S3 objects to limit the search for revisions.

  • :deployed (String) —

    Whether to list revisions based on whether the revision is the target revision of an deployment group:

    • include: List revisions that are target revisions of a deployment group.

    • exclude: Do not list revisions that are target revisions of a deployment group.

    • ignore: List all revisions.

  • :next_token (String) —

    An identifier returned from the previous list application revisions call. It can be used to return the next set of applications in the list.

Returns:

See Also:



1726
1727
1728
1729
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1726

def list_application_revisions(params = {}, options = {})
  req = build_request(:list_application_revisions, params)
  req.send_request(options)
end

#list_applications(params = {}) ⇒ Types::ListApplicationsOutput

Lists the applications registered with the applicable IAM user or AWS account.

Examples:

Request syntax with placeholder values


resp = client.list_applications({
  next_token: "NextToken",
})

Response structure


resp.applications #=> Array
resp.applications[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :next_token (String) —

    An identifier returned from the previous list applications call. It can be used to return the next set of applications in the list.

Returns:

See Also:



1759
1760
1761
1762
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1759

def list_applications(params = {}, options = {})
  req = build_request(:list_applications, params)
  req.send_request(options)
end

#list_deployment_configs(params = {}) ⇒ Types::ListDeploymentConfigsOutput

Lists the deployment configurations with the applicable IAM user or AWS account.

Examples:

Request syntax with placeholder values


resp = client.list_deployment_configs({
  next_token: "NextToken",
})

Response structure


resp.deployment_configs_list #=> Array
resp.deployment_configs_list[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :next_token (String) —

    An identifier returned from the previous list deployment configurations call. It can be used to return the next set of deployment configurations in the list.

Returns:

See Also:



1793
1794
1795
1796
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1793

def list_deployment_configs(params = {}, options = {})
  req = build_request(:list_deployment_configs, params)
  req.send_request(options)
end

#list_deployment_groups(params = {}) ⇒ Types::ListDeploymentGroupsOutput

Lists the deployment groups for an application registered with the applicable IAM user or AWS account.

Examples:

Request syntax with placeholder values


resp = client.list_deployment_groups({
  application_name: "ApplicationName", # required
  next_token: "NextToken",
})

Response structure


resp.application_name #=> String
resp.deployment_groups #=> Array
resp.deployment_groups[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :next_token (String) —

    An identifier returned from the previous list deployment groups call. It can be used to return the next set of deployment groups in the list.

Returns:

See Also:



1834
1835
1836
1837
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1834

def list_deployment_groups(params = {}, options = {})
  req = build_request(:list_deployment_groups, params)
  req.send_request(options)
end

#list_deployment_instances(params = {}) ⇒ Types::ListDeploymentInstancesOutput

Lists the instance for a deployment associated with the applicable IAM user or AWS account.

Examples:

Request syntax with placeholder values


resp = client.list_deployment_instances({
  deployment_id: "DeploymentId", # required
  next_token: "NextToken",
  instance_status_filter: ["Pending"], # accepts Pending, InProgress, Succeeded, Failed, Skipped, Unknown, Ready
  instance_type_filter: ["Blue"], # accepts Blue, Green
})

Response structure


resp.instances_list #=> Array
resp.instances_list[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (required, String) —

    The unique ID of a deployment.

  • :next_token (String) —

    An identifier returned from the previous list deployment instances call. It can be used to return the next set of deployment instances in the list.

  • :instance_status_filter (Array<String>) —

    A subset of instances to list by status:

    • Pending: Include those instance with pending deployments.

    • InProgress: Include those instance where deployments are still in progress.

    • Succeeded: Include those instances with successful deployments.

    • Failed: Include those instance with failed deployments.

    • Skipped: Include those instance with skipped deployments.

    • Unknown: Include those instance with deployments in an unknown state.

  • :instance_type_filter (Array<String>) —

    The set of instances in a blue/green deployment, either those in the original environment ("BLUE") or those in the replacement environment ("GREEN"), for which you want to view instance information.

Returns:

See Also:



1897
1898
1899
1900
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1897

def list_deployment_instances(params = {}, options = {})
  req = build_request(:list_deployment_instances, params)
  req.send_request(options)
end

#list_deployments(params = {}) ⇒ Types::ListDeploymentsOutput

Lists the deployments in a deployment group for an application registered with the applicable IAM user or AWS account.

Examples:

Request syntax with placeholder values


resp = client.list_deployments({
  application_name: "ApplicationName",
  deployment_group_name: "DeploymentGroupName",
  include_only_statuses: ["Created"], # accepts Created, Queued, InProgress, Succeeded, Failed, Stopped, Ready
  create_time_range: {
    start: Time.now,
    end: Time.now,
  },
  next_token: "NextToken",
})

Response structure


resp.deployments #=> Array
resp.deployments[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :deployment_group_name (String) —

    The name of an existing deployment group for the specified application.

  • :include_only_statuses (Array<String>) —

    A subset of deployments to list by status:

    • Created: Include created deployments in the resulting list.

    • Queued: Include queued deployments in the resulting list.

    • In Progress: Include in-progress deployments in the resulting list.

    • Succeeded: Include successful deployments in the resulting list.

    • Failed: Include failed deployments in the resulting list.

    • Stopped: Include stopped deployments in the resulting list.

  • :create_time_range (Types::TimeRange) —

    A time range (start and end) for returning a subset of the list of deployments.

  • :next_token (String) —

    An identifier returned from the previous list deployments call. It can be used to return the next set of deployments in the list.

Returns:

See Also:



1964
1965
1966
1967
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1964

def list_deployments(params = {}, options = {})
  req = build_request(:list_deployments, params)
  req.send_request(options)
end

#list_git_hub_account_token_names(params = {}) ⇒ Types::ListGitHubAccountTokenNamesOutput

Lists the names of stored connections to GitHub accounts.

Examples:

Request syntax with placeholder values


resp = client.({
  next_token: "NextToken",
})

Response structure


resp.token_name_list #=> Array
resp.token_name_list[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :next_token (String) —

    An identifier returned from the previous ListGitHubAccountTokenNames call. It can be used to return the next set of names in the list.

Returns:

See Also:



1996
1997
1998
1999
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 1996

def (params = {}, options = {})
  req = build_request(:list_git_hub_account_token_names, params)
  req.send_request(options)
end

#list_on_premises_instances(params = {}) ⇒ Types::ListOnPremisesInstancesOutput

Gets a list of names for one or more on-premises instances.

Unless otherwise specified, both registered and deregistered on-premises instance names will be listed. To list only registered or deregistered on-premises instance names, use the registration status parameter.

Examples:

Request syntax with placeholder values


resp = client.list_on_premises_instances({
  registration_status: "Registered", # accepts Registered, Deregistered
  tag_filters: [
    {
      key: "Key",
      value: "Value",
      type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
    },
  ],
  next_token: "NextToken",
})

Response structure


resp.instance_names #=> Array
resp.instance_names[0] #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :registration_status (String) —

    The registration status of the on-premises instances:

    • Deregistered: Include deregistered on-premises instances in the resulting list.

    • Registered: Include registered on-premises instances in the resulting list.

  • :tag_filters (Array<Types::TagFilter>) —

    The on-premises instance tags that will be used to restrict the corresponding on-premises instance names returned.

  • :next_token (String) —

    An identifier returned from the previous list on-premises instances call. It can be used to return the next set of on-premises instances in the list.

Returns:

See Also:



2055
2056
2057
2058
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2055

def list_on_premises_instances(params = {}, options = {})
  req = build_request(:list_on_premises_instances, params)
  req.send_request(options)
end

#put_lifecycle_event_hook_execution_status(params = {}) ⇒ Types::PutLifecycleEventHookExecutionStatusOutput

Sets the result of a Lambda validation function. The function validates one or both lifecycle events (BeforeAllowTraffic and AfterAllowTraffic) and returns Succeeded or Failed.

Examples:

Request syntax with placeholder values


resp = client.put_lifecycle_event_hook_execution_status({
  deployment_id: "DeploymentId",
  lifecycle_event_hook_execution_id: "LifecycleEventHookExecutionId",
  status: "Pending", # accepts Pending, InProgress, Succeeded, Failed, Skipped, Unknown
})

Response structure


resp.lifecycle_event_hook_execution_id #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (String) —

    The ID of the deployment. Pass this ID to a Lambda function that validates a deployment lifecycle event.

  • :lifecycle_event_hook_execution_id (String) —

    The execution ID of a deployment's lifecycle hook. A deployment lifecycle hook is specified in the hooks section of the AppSpec file.

  • :status (String) —

    The result of a Lambda function that validates a deployment lifecycle event (Succeeded or Failed).

Returns:

See Also:



2097
2098
2099
2100
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2097

def put_lifecycle_event_hook_execution_status(params = {}, options = {})
  req = build_request(:put_lifecycle_event_hook_execution_status, params)
  req.send_request(options)
end

#register_application_revision(params = {}) ⇒ Struct

Registers with AWS CodeDeploy a revision for the specified application.

Examples:

Request syntax with placeholder values


resp = client.register_application_revision({
  application_name: "ApplicationName", # required
  description: "Description",
  revision: { # required
    revision_type: "S3", # accepts S3, GitHub, String
    s3_location: {
      bucket: "S3Bucket",
      key: "S3Key",
      bundle_type: "tar", # accepts tar, tgz, zip, YAML, JSON
      version: "VersionId",
      e_tag: "ETag",
    },
    git_hub_location: {
      repository: "Repository",
      commit_id: "CommitId",
    },
    string: {
      content: "RawStringContent",
      sha256: "RawStringSha256",
    },
  },
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The name of an AWS CodeDeploy application associated with the applicable IAM user or AWS account.

  • :description (String) —

    A comment about the revision.

  • :revision (required, Types::RevisionLocation) —

    Information about the application revision to register, including type and location.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2147
2148
2149
2150
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2147

def register_application_revision(params = {}, options = {})
  req = build_request(:register_application_revision, params)
  req.send_request(options)
end

#register_on_premises_instance(params = {}) ⇒ Struct

Registers an on-premises instance.

Only one IAM ARN (an IAM session ARN or IAM user ARN) is supported in the request. You cannot use both.

Examples:

Request syntax with placeholder values


resp = client.register_on_premises_instance({
  instance_name: "InstanceName", # required
  iam_session_arn: "IamSessionArn",
  iam_user_arn: "IamUserArn",
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :instance_name (required, String) —

    The name of the on-premises instance to register.

  • :iam_session_arn (String) —

    The ARN of the IAM session to associate with the on-premises instance.

  • :iam_user_arn (String) —

    The ARN of the IAM user to associate with the on-premises instance.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2182
2183
2184
2185
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2182

def register_on_premises_instance(params = {}, options = {})
  req = build_request(:register_on_premises_instance, params)
  req.send_request(options)
end

#remove_tags_from_on_premises_instances(params = {}) ⇒ Struct

Removes one or more tags from one or more on-premises instances.

Examples:

Request syntax with placeholder values


resp = client.remove_tags_from_on_premises_instances({
  tags: [ # required
    {
      key: "Key",
      value: "Value",
    },
  ],
  instance_names: ["InstanceName"], # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :tags (required, Array<Types::Tag>) —

    The tag key-value pairs to remove from the on-premises instances.

  • :instance_names (required, Array<String>) —

    The names of the on-premises instances from which to remove tags.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2213
2214
2215
2216
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2213

def remove_tags_from_on_premises_instances(params = {}, options = {})
  req = build_request(:remove_tags_from_on_premises_instances, params)
  req.send_request(options)
end

#skip_wait_time_for_instance_termination(params = {}) ⇒ Struct

In a blue/green deployment, overrides any specified wait time and starts terminating instances immediately after the traffic routing is completed.

Examples:

Request syntax with placeholder values


resp = client.skip_wait_time_for_instance_termination({
  deployment_id: "DeploymentId",
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (String) —

    The ID of the blue/green deployment for which you want to skip the instance termination wait time.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2238
2239
2240
2241
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2238

def skip_wait_time_for_instance_termination(params = {}, options = {})
  req = build_request(:skip_wait_time_for_instance_termination, params)
  req.send_request(options)
end

#stop_deployment(params = {}) ⇒ Types::StopDeploymentOutput

Attempts to stop an ongoing deployment.

Examples:

Request syntax with placeholder values


resp = client.stop_deployment({
  deployment_id: "DeploymentId", # required
  auto_rollback_enabled: false,
})

Response structure


resp.status #=> String, one of "Pending", "Succeeded"
resp.status_message #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :deployment_id (required, String) —

    The unique ID of a deployment.

  • :auto_rollback_enabled (Boolean) —

    Indicates, when a deployment is stopped, whether instances that have been updated should be rolled back to the previous version of the application revision.

Returns:

See Also:



2274
2275
2276
2277
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2274

def stop_deployment(params = {}, options = {})
  req = build_request(:stop_deployment, params)
  req.send_request(options)
end

#update_application(params = {}) ⇒ Struct

Changes the name of an application.

Examples:

Request syntax with placeholder values


resp = client.update_application({
  application_name: "ApplicationName",
  new_application_name: "ApplicationName",
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (String) —

    The current name of the application you want to change.

  • :new_application_name (String) —

    The new name to give the application.

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2300
2301
2302
2303
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2300

def update_application(params = {}, options = {})
  req = build_request(:update_application, params)
  req.send_request(options)
end

#update_deployment_group(params = {}) ⇒ Types::UpdateDeploymentGroupOutput

Changes information about a deployment group.

Examples:

Request syntax with placeholder values


resp = client.update_deployment_group({
  application_name: "ApplicationName", # required
  current_deployment_group_name: "DeploymentGroupName", # required
  new_deployment_group_name: "DeploymentGroupName",
  deployment_config_name: "DeploymentConfigName",
  ec2_tag_filters: [
    {
      key: "Key",
      value: "Value",
      type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
    },
  ],
  on_premises_instance_tag_filters: [
    {
      key: "Key",
      value: "Value",
      type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
    },
  ],
  auto_scaling_groups: ["AutoScalingGroupName"],
  service_role_arn: "Role",
  trigger_configurations: [
    {
      trigger_name: "TriggerName",
      trigger_target_arn: "TriggerTargetArn",
      trigger_events: ["DeploymentStart"], # accepts DeploymentStart, DeploymentSuccess, DeploymentFailure, DeploymentStop, DeploymentRollback, DeploymentReady, InstanceStart, InstanceSuccess, InstanceFailure, InstanceReady
    },
  ],
  alarm_configuration: {
    enabled: false,
    ignore_poll_alarm_failure: false,
    alarms: [
      {
        name: "AlarmName",
      },
    ],
  },
  auto_rollback_configuration: {
    enabled: false,
    events: ["DEPLOYMENT_FAILURE"], # accepts DEPLOYMENT_FAILURE, DEPLOYMENT_STOP_ON_ALARM, DEPLOYMENT_STOP_ON_REQUEST
  },
  deployment_style: {
    deployment_type: "IN_PLACE", # accepts IN_PLACE, BLUE_GREEN
    deployment_option: "WITH_TRAFFIC_CONTROL", # accepts WITH_TRAFFIC_CONTROL, WITHOUT_TRAFFIC_CONTROL
  },
  blue_green_deployment_configuration: {
    terminate_blue_instances_on_deployment_success: {
      action: "TERMINATE", # accepts TERMINATE, KEEP_ALIVE
      termination_wait_time_in_minutes: 1,
    },
    deployment_ready_option: {
      action_on_timeout: "CONTINUE_DEPLOYMENT", # accepts CONTINUE_DEPLOYMENT, STOP_DEPLOYMENT
      wait_time_in_minutes: 1,
    },
    green_fleet_provisioning_option: {
      action: "DISCOVER_EXISTING", # accepts DISCOVER_EXISTING, COPY_AUTO_SCALING_GROUP
    },
  },
  load_balancer_info: {
    elb_info_list: [
      {
        name: "ELBName",
      },
    ],
    target_group_info_list: [
      {
        name: "TargetGroupName",
      },
    ],
  },
  ec2_tag_set: {
    ec2_tag_set_list: [
      [
        {
          key: "Key",
          value: "Value",
          type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
        },
      ],
    ],
  },
  on_premises_tag_set: {
    on_premises_tag_set_list: [
      [
        {
          key: "Key",
          value: "Value",
          type: "KEY_ONLY", # accepts KEY_ONLY, VALUE_ONLY, KEY_AND_VALUE
        },
      ],
    ],
  },
})

Response structure


resp.hooks_not_cleaned_up #=> Array
resp.hooks_not_cleaned_up[0].name #=> String
resp.hooks_not_cleaned_up[0].hook #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :application_name (required, String) —

    The application name corresponding to the deployment group to update.

  • :current_deployment_group_name (required, String) —

    The current name of the deployment group.

  • :new_deployment_group_name (String) —

    The new name of the deployment group, if you want to change it.

  • :deployment_config_name (String) —

    The replacement deployment configuration name to use, if you want to change it.

  • :ec2_tag_filters (Array<Types::EC2TagFilter>) —

    The replacement set of Amazon EC2 tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.

  • :on_premises_instance_tag_filters (Array<Types::TagFilter>) —

    The replacement set of on-premises instance tags on which to filter, if you want to change them. To keep the existing tags, enter their names. To remove tags, do not enter any tag names.

  • :auto_scaling_groups (Array<String>) —

    The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them. To keep the Auto Scaling groups, enter their names. To remove Auto Scaling groups, do not enter any Auto Scaling group names.

  • :service_role_arn (String) —

    A replacement ARN for the service role, if you want to change it.

  • :trigger_configurations (Array<Types::TriggerConfig>) —

    Information about triggers to change when the deployment group is updated. For examples, see Modify Triggers in an AWS CodeDeploy Deployment Group in the AWS CodeDeploy User Guide.

  • :alarm_configuration (Types::AlarmConfiguration) —

    Information to add or change about Amazon CloudWatch alarms when the deployment group is updated.

  • :auto_rollback_configuration (Types::AutoRollbackConfiguration) —

    Information for an automatic rollback configuration that is added or changed when a deployment group is updated.

  • :deployment_style (Types::DeploymentStyle) —

    Information about the type of deployment, either in-place or blue/green, you want to run and whether to route deployment traffic behind a load balancer.

  • :blue_green_deployment_configuration (Types::BlueGreenDeploymentConfiguration) —

    Information about blue/green deployment options for a deployment group.

  • :load_balancer_info (Types::LoadBalancerInfo) —

    Information about the load balancer used in a deployment.

  • :ec2_tag_set (Types::EC2TagSet) —

    Information about groups of tags applied to on-premises instances. The deployment group will include only EC2 instances identified by all the tag groups.

  • :on_premises_tag_set (Types::OnPremisesTagSet) —

    Information about an on-premises instance tag set. The deployment group will include only on-premises instances identified by all the tag groups.

Returns:

See Also:



2488
2489
2490
2491
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2488

def update_deployment_group(params = {}, options = {})
  req = build_request(:update_deployment_group, params)
  req.send_request(options)
end

#wait_until(waiter_name, params = {}, options = {}) {|w.waiter| ... } ⇒ Boolean

Polls an API operation until a resource enters a desired state.

Basic Usage

A waiter will call an API operation until:

  • It is successful
  • It enters a terminal state
  • It makes the maximum number of attempts

In between attempts, the waiter will sleep.

# polls in a loop, sleeping between attempts
client.waiter_until(waiter_name, params)

Configuration

You can configure the maximum number of polling attempts, and the delay (in seconds) between each polling attempt. You can pass configuration as the final arguments hash.

# poll for ~25 seconds
client.wait_until(waiter_name, params, {
  max_attempts: 5,
  delay: 5,
})

Callbacks

You can be notified before each polling attempt and before each delay. If you throw :success or :failure from these callbacks, it will terminate the waiter.

started_at = Time.now
client.wait_until(waiter_name, params, {

  # disable max attempts
  max_attempts: nil,

  # poll for 1 hour, instead of a number of attempts
  before_wait: -> (attempts, response) do
    throw :failure if Time.now - started_at > 3600
  end
})

Handling Errors

When a waiter is unsuccessful, it will raise an error. All of the failure errors extend from Waiters::Errors::WaiterFailed.

begin
  client.wait_until(...)
rescue Aws::Waiters::Errors::WaiterFailed
  # resource did not enter the desired state in time
end

Valid Waiters

The following table lists the valid waiter names, the operations they call, and the default :delay and :max_attempts values.

waiter_name params :delay :max_attempts
deployment_successful #get_deployment 15 120

Parameters:

  • waiter_name (Symbol)
  • params (Hash) (defaults to: {}) —

    ({})

  • options (Hash) (defaults to: {}) —

    ({})

Options Hash (options):

  • :max_attempts (Integer)
  • :delay (Integer)
  • :before_attempt (Proc)
  • :before_wait (Proc)

Yields:

  • (w.waiter)

Returns:

  • (Boolean) —

    Returns true if the waiter was successful.

Raises:

  • (Errors::FailureStateError) —

    Raised when the waiter terminates because the waiter has entered a state that it will not transition out of, preventing success.

  • (Errors::TooManyAttemptsError) —

    Raised when the configured maximum number of attempts have been made, and the waiter is not yet successful.

  • (Errors::UnexpectedError) —

    Raised when an error is encounted while polling for a resource that is not expected.

  • (Errors::NoSuchWaiterError) —

    Raised when you request to wait for an unknown state.



2598
2599
2600
2601
2602
 
# File 'gems/aws-sdk-codedeploy/lib/aws-sdk-codedeploy/client.rb', line 2598

def wait_until(waiter_name, params = {}, options = {})
  w = waiter(waiter_name, options)
  yield(w.waiter) if block_given? # deprecated
  w.wait(params)
end