AWSEC2

Objective-C

@interface AWSEC2

Swift

class AWSEC2

Amazon Elastic Compute Cloud

Amazon Elastic Compute Cloud (Amazon EC2) provides secure and resizable computing capacity in the AWS cloud. Using Amazon EC2 eliminates the need to invest in hardware up front, so you can develop and deploy applications faster.

To learn more, see the following resources:

  • The service configuration used to instantiate this service client.

    Warning

    Once the client is instantiated, do not modify the configuration object. It may cause unspecified behaviors.

    Declaration

    Objective-C

    @property (nonatomic, strong, readonly) AWSServiceConfiguration *configuration

    Swift

    var configuration: UnsafeMutablePointer<Int32> { get }
  • Returns the singleton service client. If the singleton object does not exist, the SDK instantiates the default service client with defaultServiceConfiguration from [AWSServiceManager defaultServiceManager]. The reference to this object is maintained by the SDK, and you do not need to retain it manually.

    For example, set the default service configuration in - application:didFinishLaunchingWithOptions:

    Swift

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
       let credentialProvider = AWSCognitoCredentialsProvider(regionType: .USEast1, identityPoolId: "YourIdentityPoolId")
       let configuration = AWSServiceConfiguration(region: .USEast1, credentialsProvider: credentialProvider)
       AWSServiceManager.default().defaultServiceConfiguration = configuration
    
       return true
    

    }

    Objective-C

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
         AWSCognitoCredentialsProvider *credentialsProvider = [[AWSCognitoCredentialsProvider alloc] initWithRegionType:AWSRegionUSEast1
                                                                                                         identityPoolId:@"YourIdentityPoolId"];
         AWSServiceConfiguration *configuration = [[AWSServiceConfiguration alloc] initWithRegion:AWSRegionUSEast1
                                                                              credentialsProvider:credentialsProvider];
         [AWSServiceManager defaultServiceManager].defaultServiceConfiguration = configuration;
    
         return YES;
     }
    

    Then call the following to get the default service client:

    Swift

    let EC2 = AWSEC2.default()
    

    Objective-C

    AWSEC2 *EC2 = [AWSEC2 defaultEC2];
    

    Declaration

    Objective-C

    + (nonnull instancetype)defaultEC2;

    Swift

    class func `default`() -> Self

    Return Value

    The default service client.

  • Creates a service client with the given service configuration and registers it for the key.

    For example, set the default service configuration in - application:didFinishLaunchingWithOptions:

    Swift

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
       let credentialProvider = AWSCognitoCredentialsProvider(regionType: .USEast1, identityPoolId: "YourIdentityPoolId")
       let configuration = AWSServiceConfiguration(region: .USWest2, credentialsProvider: credentialProvider)
       AWSEC2.register(with: configuration!, forKey: "USWest2EC2")
    
       return true
    

    }

    Objective-C

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        AWSCognitoCredentialsProvider *credentialsProvider = [[AWSCognitoCredentialsProvider alloc] initWithRegionType:AWSRegionUSEast1
                                                                                                        identityPoolId:@"YourIdentityPoolId"];
        AWSServiceConfiguration *configuration = [[AWSServiceConfiguration alloc] initWithRegion:AWSRegionUSWest2
                                                                             credentialsProvider:credentialsProvider];
    
        [AWSEC2 registerEC2WithConfiguration:configuration forKey:@"USWest2EC2"];
    
        return YES;
    }
    

    Then call the following to get the service client:

    Swift

    let EC2 = AWSEC2(forKey: "USWest2EC2")
    

    Objective-C

    AWSEC2 *EC2 = [AWSEC2 EC2ForKey:@"USWest2EC2"];
    

    Warning

    After calling this method, do not modify the configuration object. It may cause unspecified behaviors.

    Declaration

    Objective-C

    + (void)registerEC2WithConfiguration:(id)configuration
                                  forKey:(nonnull NSString *)key;

    Swift

    class func register(withConfiguration configuration: Any!, forKey key: String)

    Parameters

    configuration

    A service configuration object.

    key

    A string to identify the service client.

  • Retrieves the service client associated with the key. You need to call + registerEC2WithConfiguration:forKey: before invoking this method.

    For example, set the default service configuration in - application:didFinishLaunchingWithOptions:

    Swift

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
       let credentialProvider = AWSCognitoCredentialsProvider(regionType: .USEast1, identityPoolId: "YourIdentityPoolId")
       let configuration = AWSServiceConfiguration(region: .USWest2, credentialsProvider: credentialProvider)
       AWSEC2.register(with: configuration!, forKey: "USWest2EC2")
    
       return true
    

    }

    Objective-C

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        AWSCognitoCredentialsProvider *credentialsProvider = [[AWSCognitoCredentialsProvider alloc] initWithRegionType:AWSRegionUSEast1
                                                                                                        identityPoolId:@"YourIdentityPoolId"];
        AWSServiceConfiguration *configuration = [[AWSServiceConfiguration alloc] initWithRegion:AWSRegionUSWest2
                                                                             credentialsProvider:credentialsProvider];
    
        [AWSEC2 registerEC2WithConfiguration:configuration forKey:@"USWest2EC2"];
    
        return YES;
    }
    

    Then call the following to get the service client:

    Swift

    let EC2 = AWSEC2(forKey: "USWest2EC2")
    

    Objective-C

    AWSEC2 *EC2 = [AWSEC2 EC2ForKey:@"USWest2EC2"];
    

    Declaration

    Objective-C

    + (nonnull instancetype)EC2ForKey:(nonnull NSString *)key;

    Swift

    convenience init(forKey key: String)

    Parameters

    key

    A string to identify the service client.

    Return Value

    An instance of the service client.

  • Removes the service client associated with the key and release it.

    Warning

    Before calling this method, make sure no method is running on this client.

    Declaration

    Objective-C

    + (void)removeEC2ForKey:(nonnull NSString *)key;

    Swift

    class func remove(forKey key: String)

    Parameters

    key

    A string to identify the service client.

  • Accepts the Convertible Reserved Instance exchange quote described in the GetReservedInstancesExchangeQuote call.

    See

    AWSEC2AcceptReservedInstancesExchangeQuoteRequest

    See

    AWSEC2AcceptReservedInstancesExchangeQuoteResult

    Declaration

    Objective-C

    - (id)acceptReservedInstancesExchangeQuote:
        (nonnull AWSEC2AcceptReservedInstancesExchangeQuoteRequest *)request;

    Swift

    func acceptReservedInstancesExchangeQuote(_ request: AWSEC2AcceptReservedInstancesExchangeQuoteRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AcceptReservedInstancesExchangeQuote service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AcceptReservedInstancesExchangeQuoteResult.

  • Accepts the Convertible Reserved Instance exchange quote described in the GetReservedInstancesExchangeQuote call.

    See

    AWSEC2AcceptReservedInstancesExchangeQuoteRequest

    See

    AWSEC2AcceptReservedInstancesExchangeQuoteResult

    Declaration

    Objective-C

    - (void)
        acceptReservedInstancesExchangeQuote:
            (nonnull AWSEC2AcceptReservedInstancesExchangeQuoteRequest *)request
                           completionHandler:
                               (void (^_Nullable)(
                                   AWSEC2AcceptReservedInstancesExchangeQuoteResult
                                       *_Nullable,
                                   NSError *_Nullable))completionHandler;

    Swift

    func acceptReservedInstancesExchangeQuote(_ request: AWSEC2AcceptReservedInstancesExchangeQuoteRequest, completionHandler: ((AWSEC2AcceptReservedInstancesExchangeQuoteResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AcceptReservedInstancesExchangeQuote service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Accepts a transit gateway peering attachment request. The peering attachment must be in the pendingAcceptance state.

    See

    AWSEC2AcceptTransitGatewayPeeringAttachmentRequest

    See

    AWSEC2AcceptTransitGatewayPeeringAttachmentResult

    Declaration

    Objective-C

    - (id)acceptTransitGatewayPeeringAttachment:
        (nonnull AWSEC2AcceptTransitGatewayPeeringAttachmentRequest *)request;

    Swift

    func acceptTransitGatewayPeeringAttachment(_ request: AWSEC2AcceptTransitGatewayPeeringAttachmentRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AcceptTransitGatewayPeeringAttachment service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AcceptTransitGatewayPeeringAttachmentResult.

  • Accepts a transit gateway peering attachment request. The peering attachment must be in the pendingAcceptance state.

    See

    AWSEC2AcceptTransitGatewayPeeringAttachmentRequest

    See

    AWSEC2AcceptTransitGatewayPeeringAttachmentResult

    Declaration

    Objective-C

    - (void)
        acceptTransitGatewayPeeringAttachment:
            (nonnull AWSEC2AcceptTransitGatewayPeeringAttachmentRequest *)request
                            completionHandler:
                                (void (^_Nullable)(
                                    AWSEC2AcceptTransitGatewayPeeringAttachmentResult
                                        *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func acceptTransitGatewayPeeringAttachment(_ request: AWSEC2AcceptTransitGatewayPeeringAttachmentRequest, completionHandler: ((AWSEC2AcceptTransitGatewayPeeringAttachmentResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AcceptTransitGatewayPeeringAttachment service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Accepts a request to attach a VPC to a transit gateway.

    The VPC attachment must be in the pendingAcceptance state. Use DescribeTransitGatewayVpcAttachments to view your pending VPC attachment requests. Use RejectTransitGatewayVpcAttachment to reject a VPC attachment request.

    See

    AWSEC2AcceptTransitGatewayVpcAttachmentRequest

    See

    AWSEC2AcceptTransitGatewayVpcAttachmentResult

    Declaration

    Objective-C

    - (id)acceptTransitGatewayVpcAttachment:
        (nonnull AWSEC2AcceptTransitGatewayVpcAttachmentRequest *)request;

    Swift

    func acceptTransitGatewayVpcAttachment(_ request: AWSEC2AcceptTransitGatewayVpcAttachmentRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AcceptTransitGatewayVpcAttachment service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AcceptTransitGatewayVpcAttachmentResult.

  • Accepts a request to attach a VPC to a transit gateway.

    The VPC attachment must be in the pendingAcceptance state. Use DescribeTransitGatewayVpcAttachments to view your pending VPC attachment requests. Use RejectTransitGatewayVpcAttachment to reject a VPC attachment request.

    See

    AWSEC2AcceptTransitGatewayVpcAttachmentRequest

    See

    AWSEC2AcceptTransitGatewayVpcAttachmentResult

    Declaration

    Objective-C

    - (void)acceptTransitGatewayVpcAttachment:
                (nonnull AWSEC2AcceptTransitGatewayVpcAttachmentRequest *)request
                            completionHandler:
                                (void (^_Nullable)(
                                    AWSEC2AcceptTransitGatewayVpcAttachmentResult
                                        *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func acceptTransitGatewayVpcAttachment(_ request: AWSEC2AcceptTransitGatewayVpcAttachmentRequest, completionHandler: ((AWSEC2AcceptTransitGatewayVpcAttachmentResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AcceptTransitGatewayVpcAttachment service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Accepts one or more interface VPC endpoint connection requests to your VPC endpoint service.

    See

    AWSEC2AcceptVpcEndpointConnectionsRequest

    See

    AWSEC2AcceptVpcEndpointConnectionsResult

    Declaration

    Objective-C

    - (id)acceptVpcEndpointConnections:
        (nonnull AWSEC2AcceptVpcEndpointConnectionsRequest *)request;

    Swift

    func acceptVpcEndpointConnections(_ request: AWSEC2AcceptVpcEndpointConnectionsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AcceptVpcEndpointConnections service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AcceptVpcEndpointConnectionsResult.

  • Accepts one or more interface VPC endpoint connection requests to your VPC endpoint service.

    See

    AWSEC2AcceptVpcEndpointConnectionsRequest

    See

    AWSEC2AcceptVpcEndpointConnectionsResult

    Declaration

    Objective-C

    - (void)acceptVpcEndpointConnections:
                (nonnull AWSEC2AcceptVpcEndpointConnectionsRequest *)request
                       completionHandler:
                           (void (^_Nullable)(
                               AWSEC2AcceptVpcEndpointConnectionsResult *_Nullable,
                               NSError *_Nullable))completionHandler;

    Swift

    func acceptVpcEndpointConnections(_ request: AWSEC2AcceptVpcEndpointConnectionsRequest, completionHandler: ((AWSEC2AcceptVpcEndpointConnectionsResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AcceptVpcEndpointConnections service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use DescribeVpcPeeringConnections to view your outstanding VPC peering connection requests.

    For an inter-Region VPC peering connection request, you must accept the VPC peering connection in the Region of the accepter VPC.

    See

    AWSEC2AcceptVpcPeeringConnectionRequest

    See

    AWSEC2AcceptVpcPeeringConnectionResult

    Declaration

    Objective-C

    - (id)acceptVpcPeeringConnection:
        (nonnull AWSEC2AcceptVpcPeeringConnectionRequest *)request;

    Swift

    func acceptVpcPeeringConnection(_ request: AWSEC2AcceptVpcPeeringConnectionRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AcceptVpcPeeringConnection service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AcceptVpcPeeringConnectionResult.

  • Accept a VPC peering connection request. To accept a request, the VPC peering connection must be in the pending-acceptance state, and you must be the owner of the peer VPC. Use DescribeVpcPeeringConnections to view your outstanding VPC peering connection requests.

    For an inter-Region VPC peering connection request, you must accept the VPC peering connection in the Region of the accepter VPC.

    See

    AWSEC2AcceptVpcPeeringConnectionRequest

    See

    AWSEC2AcceptVpcPeeringConnectionResult

    Declaration

    Objective-C

    - (void)acceptVpcPeeringConnection:
                (nonnull AWSEC2AcceptVpcPeeringConnectionRequest *)request
                     completionHandler:
                         (void (^_Nullable)(
                             AWSEC2AcceptVpcPeeringConnectionResult *_Nullable,
                             NSError *_Nullable))completionHandler;

    Swift

    func acceptVpcPeeringConnection(_ request: AWSEC2AcceptVpcPeeringConnectionRequest, completionHandler: ((AWSEC2AcceptVpcPeeringConnectionResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AcceptVpcPeeringConnection service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Advertises an IPv4 or IPv6 address range that is provisioned for use with your AWS resources through bring your own IP addresses (BYOIP).

    You can perform this operation at most once every 10 seconds, even if you specify different address ranges each time.

    We recommend that you stop advertising the BYOIP CIDR from other locations when you advertise it from AWS. To minimize down time, you can configure your AWS resources to use an address from a BYOIP CIDR before it is advertised, and then simultaneously stop advertising it from the current location and start advertising it through AWS.

    It can take a few minutes before traffic to the specified addresses starts routing to AWS because of BGP propagation delays.

    To stop advertising the BYOIP CIDR, use WithdrawByoipCidr.

    See

    AWSEC2AdvertiseByoipCidrRequest

    See

    AWSEC2AdvertiseByoipCidrResult

    Declaration

    Objective-C

    - (id)advertiseByoipCidr:(nonnull AWSEC2AdvertiseByoipCidrRequest *)request;

    Swift

    func advertiseByoipCidr(_ request: AWSEC2AdvertiseByoipCidrRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AdvertiseByoipCidr service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AdvertiseByoipCidrResult.

  • Advertises an IPv4 or IPv6 address range that is provisioned for use with your AWS resources through bring your own IP addresses (BYOIP).

    You can perform this operation at most once every 10 seconds, even if you specify different address ranges each time.

    We recommend that you stop advertising the BYOIP CIDR from other locations when you advertise it from AWS. To minimize down time, you can configure your AWS resources to use an address from a BYOIP CIDR before it is advertised, and then simultaneously stop advertising it from the current location and start advertising it through AWS.

    It can take a few minutes before traffic to the specified addresses starts routing to AWS because of BGP propagation delays.

    To stop advertising the BYOIP CIDR, use WithdrawByoipCidr.

    See

    AWSEC2AdvertiseByoipCidrRequest

    See

    AWSEC2AdvertiseByoipCidrResult

    Declaration

    Objective-C

    - (void)advertiseByoipCidr:(nonnull AWSEC2AdvertiseByoipCidrRequest *)request
             completionHandler:
                 (void (^_Nullable)(AWSEC2AdvertiseByoipCidrResult *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func advertiseByoipCidr(_ request: AWSEC2AdvertiseByoipCidrRequest, completionHandler: ((AWSEC2AdvertiseByoipCidrResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AdvertiseByoipCidr service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Allocates an Elastic IP address to your AWS account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different AWS account.

    You can allocate an Elastic IP address from an address pool owned by AWS or from an address pool created from a public IPv4 address range that you have brought to AWS for use with your AWS resources using bring your own IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

    [EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another AWS account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.

    An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.

    For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).

    See

    AWSEC2AllocateAddressRequest

    See

    AWSEC2AllocateAddressResult

    Declaration

    Objective-C

    - (id)allocateAddress:(nonnull AWSEC2AllocateAddressRequest *)request;

    Swift

    func allocateAddress(_ request: AWSEC2AllocateAddressRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AllocateAddress service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AllocateAddressResult.

  • Allocates an Elastic IP address to your AWS account. After you allocate the Elastic IP address you can associate it with an instance or network interface. After you release an Elastic IP address, it is released to the IP address pool and can be allocated to a different AWS account.

    You can allocate an Elastic IP address from an address pool owned by AWS or from an address pool created from a public IPv4 address range that you have brought to AWS for use with your AWS resources using bring your own IP addresses (BYOIP). For more information, see Bring Your Own IP Addresses (BYOIP) in the Amazon Elastic Compute Cloud User Guide.

    [EC2-VPC] If you release an Elastic IP address, you might be able to recover it. You cannot recover an Elastic IP address that you released after it is allocated to another AWS account. You cannot recover an Elastic IP address for EC2-Classic. To attempt to recover an Elastic IP address that you released, specify it in this operation.

    An Elastic IP address is for use either in the EC2-Classic platform or in a VPC. By default, you can allocate 5 Elastic IP addresses for EC2-Classic per Region and 5 Elastic IP addresses for EC2-VPC per Region.

    For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    You can allocate a carrier IP address which is a public IP address from a telecommunication carrier, to a network interface which resides in a subnet in a Wavelength Zone (for example an EC2 instance).

    See

    AWSEC2AllocateAddressRequest

    See

    AWSEC2AllocateAddressResult

    Declaration

    Objective-C

    - (void)allocateAddress:(nonnull AWSEC2AllocateAddressRequest *)request
          completionHandler:
              (void (^_Nullable)(AWSEC2AllocateAddressResult *_Nullable,
                                 NSError *_Nullable))completionHandler;

    Swift

    func allocateAddress(_ request: AWSEC2AllocateAddressRequest, completionHandler: ((AWSEC2AllocateAddressResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AllocateAddress service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Allocates a Dedicated Host to your account. At a minimum, specify the supported instance type or instance family, the Availability Zone in which to allocate the host, and the number of hosts to allocate.

    See

    AWSEC2AllocateHostsRequest

    See

    AWSEC2AllocateHostsResult

    Declaration

    Objective-C

    - (id)allocateHosts:(nonnull AWSEC2AllocateHostsRequest *)request;

    Swift

    func allocateHosts(_ request: AWSEC2AllocateHostsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AllocateHosts service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AllocateHostsResult.

  • Allocates a Dedicated Host to your account. At a minimum, specify the supported instance type or instance family, the Availability Zone in which to allocate the host, and the number of hosts to allocate.

    See

    AWSEC2AllocateHostsRequest

    See

    AWSEC2AllocateHostsResult

    Declaration

    Objective-C

    - (void)allocateHosts:(nonnull AWSEC2AllocateHostsRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2AllocateHostsResult *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func allocateHosts(_ request: AWSEC2AllocateHostsRequest, completionHandler: ((AWSEC2AllocateHostsResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AllocateHosts service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Applies a security group to the association between the target network and the Client VPN endpoint. This action replaces the existing security groups with the specified security groups.

    See

    AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkRequest

    See

    AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkResult

    Declaration

    Objective-C

    - (id)applySecurityGroupsToClientVpnTargetNetwork:
        (nonnull AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkRequest *)request;

    Swift

    func applySecurityGroups(toClientVpnTargetNetwork request: AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the ApplySecurityGroupsToClientVpnTargetNetwork service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkResult.

  • Applies a security group to the association between the target network and the Client VPN endpoint. This action replaces the existing security groups with the specified security groups.

    See

    AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkRequest

    See

    AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkResult

    Declaration

    Objective-C

    - (void)
        applySecurityGroupsToClientVpnTargetNetwork:
            (nonnull AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkRequest *)
                request
                                  completionHandler:
                                      (void (^_Nullable)(
                                          AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkResult
                                              *_Nullable,
                                          NSError *_Nullable))completionHandler;

    Swift

    func applySecurityGroups(toClientVpnTargetNetwork request: AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkRequest, completionHandler: ((AWSEC2ApplySecurityGroupsToClientVpnTargetNetworkResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the ApplySecurityGroupsToClientVpnTargetNetwork service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Assigns one or more IPv6 addresses to the specified network interface. You can specify one or more specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from within the subnet’s IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies per instance type. For information, see IP Addresses Per Network Interface Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

    You must specify either the IPv6 addresses or the IPv6 address count in the request.

    See

    AWSEC2AssignIpv6AddressesRequest

    See

    AWSEC2AssignIpv6AddressesResult

    Declaration

    Objective-C

    - (id)assignIpv6Addresses:(nonnull AWSEC2AssignIpv6AddressesRequest *)request;

    Swift

    func assignIpv6Addresses(_ request: AWSEC2AssignIpv6AddressesRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssignIpv6Addresses service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssignIpv6AddressesResult.

  • Assigns one or more IPv6 addresses to the specified network interface. You can specify one or more specific IPv6 addresses, or you can specify the number of IPv6 addresses to be automatically assigned from within the subnet’s IPv6 CIDR block range. You can assign as many IPv6 addresses to a network interface as you can assign private IPv4 addresses, and the limit varies per instance type. For information, see IP Addresses Per Network Interface Per Instance Type in the Amazon Elastic Compute Cloud User Guide.

    You must specify either the IPv6 addresses or the IPv6 address count in the request.

    See

    AWSEC2AssignIpv6AddressesRequest

    See

    AWSEC2AssignIpv6AddressesResult

    Declaration

    Objective-C

    - (void)assignIpv6Addresses:(nonnull AWSEC2AssignIpv6AddressesRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2AssignIpv6AddressesResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func assignIpv6Addresses(_ request: AWSEC2AssignIpv6AddressesRequest, completionHandler: ((AWSEC2AssignIpv6AddressesResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssignIpv6Addresses service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Assigns one or more secondary private IP addresses to the specified network interface.

    You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet’s CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    When you move a secondary private IP address to another network interface, any Elastic IP address that is associated with the IP address is also moved.

    Remapping an IP address is an asynchronous operation. When you move an IP address from one network interface to another, check network/interfaces/macs/mac/local-ipv4s in the instance metadata to confirm that the remapping is complete.

    You must specify either the IP addresses or the IP address count in the request.

    See

    AWSEC2AssignPrivateIpAddressesRequest

    See

    AWSEC2AssignPrivateIpAddressesResult

    Declaration

    Objective-C

    - (id)assignPrivateIpAddresses:
        (nonnull AWSEC2AssignPrivateIpAddressesRequest *)request;

    Swift

    func assignPrivateIpAddresses(_ request: AWSEC2AssignPrivateIpAddressesRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssignPrivateIpAddresses service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssignPrivateIpAddressesResult.

  • Assigns one or more secondary private IP addresses to the specified network interface.

    You can specify one or more specific secondary IP addresses, or you can specify the number of secondary IP addresses to be automatically assigned within the subnet’s CIDR block range. The number of secondary IP addresses that you can assign to an instance varies by instance type. For information about instance types, see Instance Types in the Amazon Elastic Compute Cloud User Guide. For more information about Elastic IP addresses, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    When you move a secondary private IP address to another network interface, any Elastic IP address that is associated with the IP address is also moved.

    Remapping an IP address is an asynchronous operation. When you move an IP address from one network interface to another, check network/interfaces/macs/mac/local-ipv4s in the instance metadata to confirm that the remapping is complete.

    You must specify either the IP addresses or the IP address count in the request.

    See

    AWSEC2AssignPrivateIpAddressesRequest

    See

    AWSEC2AssignPrivateIpAddressesResult

    Declaration

    Objective-C

    - (void)assignPrivateIpAddresses:
                (nonnull AWSEC2AssignPrivateIpAddressesRequest *)request
                   completionHandler:
                       (void (^_Nullable)(
                           AWSEC2AssignPrivateIpAddressesResult *_Nullable,
                           NSError *_Nullable))completionHandler;

    Swift

    func assignPrivateIpAddresses(_ request: AWSEC2AssignPrivateIpAddressesRequest, completionHandler: ((AWSEC2AssignPrivateIpAddressesResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssignPrivateIpAddresses service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates an Elastic IP address, or carrier IP address (for instances that are in subnets in Wavelength Zones) with an instance or a network interface. Before you can use an Elastic IP address, you must allocate it to your account.

    An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    [EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance. If you associate an Elastic IP address with an instance that has an existing Elastic IP address, the existing address is disassociated from the instance, but remains allocated to your account.

    [VPC in an EC2-Classic account] If you don’t specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation. You cannot associate an Elastic IP address with an instance or network interface that has an existing Elastic IP address.

    [Subnets in Wavelength Zones] You can associate an IP address from the telecommunication carrier to the instance or network interface.

    You cannot associate an Elastic IP address with an interface in a different network border group.

    This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn’t return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

    See

    AWSEC2AssociateAddressRequest

    See

    AWSEC2AssociateAddressResult

    Declaration

    Objective-C

    - (id)associateAddress:(nonnull AWSEC2AssociateAddressRequest *)request;

    Swift

    func associateAddress(_ request: AWSEC2AssociateAddressRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateAddress service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateAddressResult.

  • Associates an Elastic IP address, or carrier IP address (for instances that are in subnets in Wavelength Zones) with an instance or a network interface. Before you can use an Elastic IP address, you must allocate it to your account.

    An Elastic IP address is for use in either the EC2-Classic platform or in a VPC. For more information, see Elastic IP Addresses in the Amazon Elastic Compute Cloud User Guide.

    [EC2-Classic, VPC in an EC2-VPC-only account] If the Elastic IP address is already associated with a different instance, it is disassociated from that instance and associated with the specified instance. If you associate an Elastic IP address with an instance that has an existing Elastic IP address, the existing address is disassociated from the instance, but remains allocated to your account.

    [VPC in an EC2-Classic account] If you don’t specify a private IP address, the Elastic IP address is associated with the primary IP address. If the Elastic IP address is already associated with a different instance or a network interface, you get an error unless you allow reassociation. You cannot associate an Elastic IP address with an instance or network interface that has an existing Elastic IP address.

    [Subnets in Wavelength Zones] You can associate an IP address from the telecommunication carrier to the instance or network interface.

    You cannot associate an Elastic IP address with an interface in a different network border group.

    This is an idempotent operation. If you perform the operation more than once, Amazon EC2 doesn’t return an error, and you may be charged for each time the Elastic IP address is remapped to the same instance. For more information, see the Elastic IP Addresses section of Amazon EC2 Pricing.

    See

    AWSEC2AssociateAddressRequest

    See

    AWSEC2AssociateAddressResult

    Declaration

    Objective-C

    - (void)associateAddress:(nonnull AWSEC2AssociateAddressRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2AssociateAddressResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func associateAddress(_ request: AWSEC2AssociateAddressRequest, completionHandler: ((AWSEC2AssociateAddressResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateAddress service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates a target network with a Client VPN endpoint. A target network is a subnet in a VPC. You can associate multiple subnets from the same VPC with a Client VPN endpoint. You can associate only one subnet in each Availability Zone. We recommend that you associate at least two subnets to provide Availability Zone redundancy.

    If you specified a VPC when you created the Client VPN endpoint or if you have previous subnet associations, the specified subnet must be in the same VPC. To specify a subnet that’s in a different VPC, you must first modify the Client VPN endpoint (ModifyClientVpnEndpoint) and change the VPC that’s associated with it.

    See

    AWSEC2AssociateClientVpnTargetNetworkRequest

    See

    AWSEC2AssociateClientVpnTargetNetworkResult

    Declaration

    Objective-C

    - (id)associateClientVpnTargetNetwork:
        (nonnull AWSEC2AssociateClientVpnTargetNetworkRequest *)request;

    Swift

    func associateClientVpnTargetNetwork(_ request: AWSEC2AssociateClientVpnTargetNetworkRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateClientVpnTargetNetwork service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateClientVpnTargetNetworkResult.

  • Associates a target network with a Client VPN endpoint. A target network is a subnet in a VPC. You can associate multiple subnets from the same VPC with a Client VPN endpoint. You can associate only one subnet in each Availability Zone. We recommend that you associate at least two subnets to provide Availability Zone redundancy.

    If you specified a VPC when you created the Client VPN endpoint or if you have previous subnet associations, the specified subnet must be in the same VPC. To specify a subnet that’s in a different VPC, you must first modify the Client VPN endpoint (ModifyClientVpnEndpoint) and change the VPC that’s associated with it.

    See

    AWSEC2AssociateClientVpnTargetNetworkRequest

    See

    AWSEC2AssociateClientVpnTargetNetworkResult

    Declaration

    Objective-C

    - (void)associateClientVpnTargetNetwork:
                (nonnull AWSEC2AssociateClientVpnTargetNetworkRequest *)request
                          completionHandler:
                              (void (^_Nullable)(
                                  AWSEC2AssociateClientVpnTargetNetworkResult
                                      *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func associateClientVpnTargetNetwork(_ request: AWSEC2AssociateClientVpnTargetNetworkRequest, completionHandler: ((AWSEC2AssociateClientVpnTargetNetworkResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateClientVpnTargetNetwork service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates a set of DHCP options (that you’ve previously created) with the specified VPC, or associates no DHCP options with the VPC.

    After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don’t need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

    For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AssociateDhcpOptionsRequest

    Declaration

    Objective-C

    - (id)associateDhcpOptions:(nonnull AWSEC2AssociateDhcpOptionsRequest *)request;

    Swift

    func associateDhcpOptions(_ request: AWSEC2AssociateDhcpOptionsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateDhcpOptions service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • Associates a set of DHCP options (that you’ve previously created) with the specified VPC, or associates no DHCP options with the VPC.

    After you associate the options with the VPC, any existing instances and all new instances that you launch in that VPC use the options. You don’t need to restart or relaunch the instances. They automatically pick up the changes within a few hours, depending on how frequently the instance renews its DHCP lease. You can explicitly renew the lease using the operating system on the instance.

    For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AssociateDhcpOptionsRequest

    Declaration

    Objective-C

    - (void)associateDhcpOptions:
                (nonnull AWSEC2AssociateDhcpOptionsRequest *)request
               completionHandler:
                   (void (^_Nullable)(NSError *_Nullable))completionHandler;

    Swift

    func associateDhcpOptions(_ request: AWSEC2AssociateDhcpOptionsRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateDhcpOptions service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates an IAM instance profile with a running or stopped instance. You cannot associate more than one IAM instance profile with an instance.

    See

    AWSEC2AssociateIamInstanceProfileRequest

    See

    AWSEC2AssociateIamInstanceProfileResult

    Declaration

    Objective-C

    - (id)associateIamInstanceProfile:
        (nonnull AWSEC2AssociateIamInstanceProfileRequest *)request;

    Swift

    func associateIamInstanceProfile(_ request: AWSEC2AssociateIamInstanceProfileRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateIamInstanceProfile service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateIamInstanceProfileResult.

  • Associates an IAM instance profile with a running or stopped instance. You cannot associate more than one IAM instance profile with an instance.

    See

    AWSEC2AssociateIamInstanceProfileRequest

    See

    AWSEC2AssociateIamInstanceProfileResult

    Declaration

    Objective-C

    - (void)associateIamInstanceProfile:
                (nonnull AWSEC2AssociateIamInstanceProfileRequest *)request
                      completionHandler:
                          (void (^_Nullable)(
                              AWSEC2AssociateIamInstanceProfileResult *_Nullable,
                              NSError *_Nullable))completionHandler;

    Swift

    func associateIamInstanceProfile(_ request: AWSEC2AssociateIamInstanceProfileRequest, completionHandler: ((AWSEC2AssociateIamInstanceProfileResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateIamInstanceProfile service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates a subnet in your VPC or an internet gateway or virtual private gateway attached to your VPC with a route table in your VPC. This association causes traffic from the subnet or gateway to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table later. A route table can be associated with multiple subnets.

    For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AssociateRouteTableRequest

    See

    AWSEC2AssociateRouteTableResult

    Declaration

    Objective-C

    - (id)associateRouteTable:(nonnull AWSEC2AssociateRouteTableRequest *)request;

    Swift

    func associateRouteTable(_ request: AWSEC2AssociateRouteTableRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateRouteTable service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateRouteTableResult.

  • Associates a subnet in your VPC or an internet gateway or virtual private gateway attached to your VPC with a route table in your VPC. This association causes traffic from the subnet or gateway to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table later. A route table can be associated with multiple subnets.

    For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AssociateRouteTableRequest

    See

    AWSEC2AssociateRouteTableResult

    Declaration

    Objective-C

    - (void)associateRouteTable:(nonnull AWSEC2AssociateRouteTableRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2AssociateRouteTableResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func associateRouteTable(_ request: AWSEC2AssociateRouteTableRequest, completionHandler: ((AWSEC2AssociateRouteTableResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateRouteTable service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates a CIDR block with your subnet. You can only associate a single IPv6 CIDR block with your subnet. An IPv6 CIDR block must have a prefix length of /64.

    See

    AWSEC2AssociateSubnetCidrBlockRequest

    See

    AWSEC2AssociateSubnetCidrBlockResult

    Declaration

    Objective-C

    - (id)associateSubnetCidrBlock:
        (nonnull AWSEC2AssociateSubnetCidrBlockRequest *)request;

    Swift

    func associateSubnetCidrBlock(_ request: AWSEC2AssociateSubnetCidrBlockRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateSubnetCidrBlock service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateSubnetCidrBlockResult.

  • Associates a CIDR block with your subnet. You can only associate a single IPv6 CIDR block with your subnet. An IPv6 CIDR block must have a prefix length of /64.

    See

    AWSEC2AssociateSubnetCidrBlockRequest

    See

    AWSEC2AssociateSubnetCidrBlockResult

    Declaration

    Objective-C

    - (void)associateSubnetCidrBlock:
                (nonnull AWSEC2AssociateSubnetCidrBlockRequest *)request
                   completionHandler:
                       (void (^_Nullable)(
                           AWSEC2AssociateSubnetCidrBlockResult *_Nullable,
                           NSError *_Nullable))completionHandler;

    Swift

    func associateSubnetCidrBlock(_ request: AWSEC2AssociateSubnetCidrBlockRequest, completionHandler: ((AWSEC2AssociateSubnetCidrBlockResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateSubnetCidrBlock service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates the specified subnets and transit gateway attachments with the specified transit gateway multicast domain.

    The transit gateway attachment must be in the available state before you can add a resource. Use DescribeTransitGatewayAttachments to see the state of the attachment.

    See

    AWSEC2AssociateTransitGatewayMulticastDomainRequest

    See

    AWSEC2AssociateTransitGatewayMulticastDomainResult

    Declaration

    Objective-C

    - (id)associateTransitGatewayMulticastDomain:
        (nonnull AWSEC2AssociateTransitGatewayMulticastDomainRequest *)request;

    Swift

    func associateTransitGatewayMulticastDomain(_ request: AWSEC2AssociateTransitGatewayMulticastDomainRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateTransitGatewayMulticastDomain service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateTransitGatewayMulticastDomainResult.

  • Associates the specified subnets and transit gateway attachments with the specified transit gateway multicast domain.

    The transit gateway attachment must be in the available state before you can add a resource. Use DescribeTransitGatewayAttachments to see the state of the attachment.

    See

    AWSEC2AssociateTransitGatewayMulticastDomainRequest

    See

    AWSEC2AssociateTransitGatewayMulticastDomainResult

    Declaration

    Objective-C

    - (void)
        associateTransitGatewayMulticastDomain:
            (nonnull AWSEC2AssociateTransitGatewayMulticastDomainRequest *)request
                             completionHandler:
                                 (void (^_Nullable)(
                                     AWSEC2AssociateTransitGatewayMulticastDomainResult
                                         *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func associateTransitGatewayMulticastDomain(_ request: AWSEC2AssociateTransitGatewayMulticastDomainRequest, completionHandler: ((AWSEC2AssociateTransitGatewayMulticastDomainResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateTransitGatewayMulticastDomain service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates the specified attachment with the specified transit gateway route table. You can associate only one route table with an attachment.

    See

    AWSEC2AssociateTransitGatewayRouteTableRequest

    See

    AWSEC2AssociateTransitGatewayRouteTableResult

    Declaration

    Objective-C

    - (id)associateTransitGatewayRouteTable:
        (nonnull AWSEC2AssociateTransitGatewayRouteTableRequest *)request;

    Swift

    func associateTransitGatewayRouteTable(_ request: AWSEC2AssociateTransitGatewayRouteTableRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateTransitGatewayRouteTable service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateTransitGatewayRouteTableResult.

  • Associates the specified attachment with the specified transit gateway route table. You can associate only one route table with an attachment.

    See

    AWSEC2AssociateTransitGatewayRouteTableRequest

    See

    AWSEC2AssociateTransitGatewayRouteTableResult

    Declaration

    Objective-C

    - (void)associateTransitGatewayRouteTable:
                (nonnull AWSEC2AssociateTransitGatewayRouteTableRequest *)request
                            completionHandler:
                                (void (^_Nullable)(
                                    AWSEC2AssociateTransitGatewayRouteTableResult
                                        *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func associateTransitGatewayRouteTable(_ request: AWSEC2AssociateTransitGatewayRouteTableRequest, completionHandler: ((AWSEC2AssociateTransitGatewayRouteTableResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateTransitGatewayRouteTable service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates a CIDR block with your VPC. You can associate a secondary IPv4 CIDR block, an Amazon-provided IPv6 CIDR block, or an IPv6 CIDR block from an IPv6 address pool that you provisioned through bring your own IP addresses (BYOIP). The IPv6 CIDR block size is fixed at /56.

    You must specify one of the following in the request: an IPv4 CIDR block, an IPv6 pool, or an Amazon-provided IPv6 CIDR block.

    For more information about associating CIDR blocks with your VPC and applicable restrictions, see VPC and Subnet Sizing in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AssociateVpcCidrBlockRequest

    See

    AWSEC2AssociateVpcCidrBlockResult

    Declaration

    Objective-C

    - (id)associateVpcCidrBlock:
        (nonnull AWSEC2AssociateVpcCidrBlockRequest *)request;

    Swift

    func associateVpcCidrBlock(_ request: AWSEC2AssociateVpcCidrBlockRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AssociateVpcCidrBlock service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AssociateVpcCidrBlockResult.

  • Associates a CIDR block with your VPC. You can associate a secondary IPv4 CIDR block, an Amazon-provided IPv6 CIDR block, or an IPv6 CIDR block from an IPv6 address pool that you provisioned through bring your own IP addresses (BYOIP). The IPv6 CIDR block size is fixed at /56.

    You must specify one of the following in the request: an IPv4 CIDR block, an IPv6 pool, or an Amazon-provided IPv6 CIDR block.

    For more information about associating CIDR blocks with your VPC and applicable restrictions, see VPC and Subnet Sizing in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AssociateVpcCidrBlockRequest

    See

    AWSEC2AssociateVpcCidrBlockResult

    Declaration

    Objective-C

    - (void)associateVpcCidrBlock:
                (nonnull AWSEC2AssociateVpcCidrBlockRequest *)request
                completionHandler:
                    (void (^_Nullable)(AWSEC2AssociateVpcCidrBlockResult *_Nullable,
                                       NSError *_Nullable))completionHandler;

    Swift

    func associateVpcCidrBlock(_ request: AWSEC2AssociateVpcCidrBlockRequest, completionHandler: ((AWSEC2AssociateVpcCidrBlockResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AssociateVpcCidrBlock service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC’s security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that’s in the running state. An instance is automatically unlinked from a VPC when it’s stopped - you can link it to the VPC again when you restart it.

    After you’ve linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

    Linking your instance to a VPC is sometimes referred to as attaching your instance.

    See

    AWSEC2AttachClassicLinkVpcRequest

    See

    AWSEC2AttachClassicLinkVpcResult

    Declaration

    Objective-C

    - (id)attachClassicLinkVpc:(nonnull AWSEC2AttachClassicLinkVpcRequest *)request;

    Swift

    func attachClassicLinkVpc(_ request: AWSEC2AttachClassicLinkVpcRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AttachClassicLinkVpc service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AttachClassicLinkVpcResult.

  • Links an EC2-Classic instance to a ClassicLink-enabled VPC through one or more of the VPC’s security groups. You cannot link an EC2-Classic instance to more than one VPC at a time. You can only link an instance that’s in the running state. An instance is automatically unlinked from a VPC when it’s stopped - you can link it to the VPC again when you restart it.

    After you’ve linked an instance, you cannot change the VPC security groups that are associated with it. To change the security groups, you must first unlink the instance, and then link it again.

    Linking your instance to a VPC is sometimes referred to as attaching your instance.

    See

    AWSEC2AttachClassicLinkVpcRequest

    See

    AWSEC2AttachClassicLinkVpcResult

    Declaration

    Objective-C

    - (void)attachClassicLinkVpc:
                (nonnull AWSEC2AttachClassicLinkVpcRequest *)request
               completionHandler:
                   (void (^_Nullable)(AWSEC2AttachClassicLinkVpcResult *_Nullable,
                                      NSError *_Nullable))completionHandler;

    Swift

    func attachClassicLinkVpc(_ request: AWSEC2AttachClassicLinkVpcRequest, completionHandler: ((AWSEC2AttachClassicLinkVpcResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AttachClassicLinkVpc service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Attaches an internet gateway or a virtual private gateway to a VPC, enabling connectivity between the internet and the VPC. For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AttachInternetGatewayRequest

    Declaration

    Objective-C

    - (id)attachInternetGateway:
        (nonnull AWSEC2AttachInternetGatewayRequest *)request;

    Swift

    func attachInternetGateway(_ request: AWSEC2AttachInternetGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AttachInternetGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • Attaches an internet gateway or a virtual private gateway to a VPC, enabling connectivity between the internet and the VPC. For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2AttachInternetGatewayRequest

    Declaration

    Objective-C

    - (void)attachInternetGateway:
                (nonnull AWSEC2AttachInternetGatewayRequest *)request
                completionHandler:
                    (void (^_Nullable)(NSError *_Nullable))completionHandler;

    Swift

    func attachInternetGateway(_ request: AWSEC2AttachInternetGatewayRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AttachInternetGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Attaches a network interface to an instance.

    See

    AWSEC2AttachNetworkInterfaceRequest

    See

    AWSEC2AttachNetworkInterfaceResult

    Declaration

    Objective-C

    - (id)attachNetworkInterface:
        (nonnull AWSEC2AttachNetworkInterfaceRequest *)request;

    Swift

    func attachNetworkInterface(_ request: AWSEC2AttachNetworkInterfaceRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AttachNetworkInterface service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AttachNetworkInterfaceResult.

  • Attaches a network interface to an instance.

    See

    AWSEC2AttachNetworkInterfaceRequest

    See

    AWSEC2AttachNetworkInterfaceResult

    Declaration

    Objective-C

    - (void)
        attachNetworkInterface:
            (nonnull AWSEC2AttachNetworkInterfaceRequest *)request
             completionHandler:
                 (void (^_Nullable)(AWSEC2AttachNetworkInterfaceResult *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func attachNetworkInterface(_ request: AWSEC2AttachNetworkInterfaceRequest, completionHandler: ((AWSEC2AttachNetworkInterfaceResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AttachNetworkInterface service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

    Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

    After you attach an EBS volume, you must make it available. For more information, see Making an EBS volume available for use.

    If a volume has an AWS Marketplace product code:

    • The volume can be attached only to a stopped instance.

    • AWS Marketplace product codes are copied from the volume to the instance.

    • You must be subscribed to the product.

    • The instance type and operating system of the instance must support the product. For example, you can’t detach a volume from a Windows instance and attach it to a Linux instance.

    For more information, see Attaching Amazon EBS volumes in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2AttachVolumeRequest

    See

    AWSEC2VolumeAttachment

    Declaration

    Objective-C

    - (id)attachVolume:(nonnull AWSEC2AttachVolumeRequest *)request;

    Swift

    func attachVolume(_ request: AWSEC2AttachVolumeRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AttachVolume service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2VolumeAttachment.

  • Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

    Encrypted EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

    After you attach an EBS volume, you must make it available. For more information, see Making an EBS volume available for use.

    If a volume has an AWS Marketplace product code:

    • The volume can be attached only to a stopped instance.

    • AWS Marketplace product codes are copied from the volume to the instance.

    • You must be subscribed to the product.

    • The instance type and operating system of the instance must support the product. For example, you can’t detach a volume from a Windows instance and attach it to a Linux instance.

    For more information, see Attaching Amazon EBS volumes in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2AttachVolumeRequest

    See

    AWSEC2VolumeAttachment

    Declaration

    Objective-C

    - (void)attachVolume:(nonnull AWSEC2AttachVolumeRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2VolumeAttachment *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func attachVolume(_ request: AWSEC2AttachVolumeRequest, completionHandler: ((AWSEC2VolumeAttachment?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AttachVolume service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Attaches a virtual private gateway to a VPC. You can attach one virtual private gateway to one VPC at a time.

    For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

    See

    AWSEC2AttachVpnGatewayRequest

    See

    AWSEC2AttachVpnGatewayResult

    Declaration

    Objective-C

    - (id)attachVpnGateway:(nonnull AWSEC2AttachVpnGatewayRequest *)request;

    Swift

    func attachVpnGateway(_ request: AWSEC2AttachVpnGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AttachVpnGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AttachVpnGatewayResult.

  • Attaches a virtual private gateway to a VPC. You can attach one virtual private gateway to one VPC at a time.

    For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

    See

    AWSEC2AttachVpnGatewayRequest

    See

    AWSEC2AttachVpnGatewayResult

    Declaration

    Objective-C

    - (void)attachVpnGateway:(nonnull AWSEC2AttachVpnGatewayRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2AttachVpnGatewayResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func attachVpnGateway(_ request: AWSEC2AttachVpnGatewayRequest, completionHandler: ((AWSEC2AttachVpnGatewayResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AttachVpnGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Adds an ingress authorization rule to a Client VPN endpoint. Ingress authorization rules act as firewall rules that grant access to networks. You must configure ingress authorization rules to enable clients to access resources in AWS or on-premises networks.

    See

    AWSEC2AuthorizeClientVpnIngressRequest

    See

    AWSEC2AuthorizeClientVpnIngressResult

    Declaration

    Objective-C

    - (id)authorizeClientVpnIngress:
        (nonnull AWSEC2AuthorizeClientVpnIngressRequest *)request;

    Swift

    func authorizeClientVpnIngress(_ request: AWSEC2AuthorizeClientVpnIngressRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AuthorizeClientVpnIngress service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2AuthorizeClientVpnIngressResult.

  • Adds an ingress authorization rule to a Client VPN endpoint. Ingress authorization rules act as firewall rules that grant access to networks. You must configure ingress authorization rules to enable clients to access resources in AWS or on-premises networks.

    See

    AWSEC2AuthorizeClientVpnIngressRequest

    See

    AWSEC2AuthorizeClientVpnIngressResult

    Declaration

    Objective-C

    - (void)authorizeClientVpnIngress:
                (nonnull AWSEC2AuthorizeClientVpnIngressRequest *)request
                    completionHandler:
                        (void (^_Nullable)(
                            AWSEC2AuthorizeClientVpnIngressResult *_Nullable,
                            NSError *_Nullable))completionHandler;

    Swift

    func authorizeClientVpnIngress(_ request: AWSEC2AuthorizeClientVpnIngressRequest, completionHandler: ((AWSEC2AuthorizeClientVpnIngressResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AuthorizeClientVpnIngress service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • [VPC only] Adds the specified egress rules to a security group for use with a VPC.

    An outbound rule permits instances to send traffic to the specified IPv4 or IPv6 CIDR address ranges, or to the instances associated with the specified destination security groups.

    You specify a protocol for each rule (for example, TCP). For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

    Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

    For more information about VPC security group limits, see Amazon VPC Limits.

    See

    AWSEC2AuthorizeSecurityGroupEgressRequest

    Declaration

    Objective-C

    - (id)authorizeSecurityGroupEgress:
        (nonnull AWSEC2AuthorizeSecurityGroupEgressRequest *)request;

    Swift

    func authorizeSecurityGroupEgress(_ request: AWSEC2AuthorizeSecurityGroupEgressRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AuthorizeSecurityGroupEgress service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • [VPC only] Adds the specified egress rules to a security group for use with a VPC.

    An outbound rule permits instances to send traffic to the specified IPv4 or IPv6 CIDR address ranges, or to the instances associated with the specified destination security groups.

    You specify a protocol for each rule (for example, TCP). For the TCP and UDP protocols, you must also specify the destination port or port range. For the ICMP protocol, you must also specify the ICMP type and code. You can use -1 for the type or code to mean all types or all codes.

    Rule changes are propagated to affected instances as quickly as possible. However, a small delay might occur.

    For more information about VPC security group limits, see Amazon VPC Limits.

    See

    AWSEC2AuthorizeSecurityGroupEgressRequest

    Declaration

    Objective-C

    - (void)authorizeSecurityGroupEgress:
                (nonnull AWSEC2AuthorizeSecurityGroupEgressRequest *)request
                       completionHandler:
                           (void (^_Nullable)(NSError *_Nullable))completionHandler;

    Swift

    func authorizeSecurityGroupEgress(_ request: AWSEC2AuthorizeSecurityGroupEgressRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AuthorizeSecurityGroupEgress service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Adds the specified ingress rules to a security group.

    An inbound rule permits instances to receive traffic from the specified IPv4 or IPv6 CIDR address ranges, or from the instances associated with the specified destination security groups.

    You specify a protocol for each rule (for example, TCP). For TCP and UDP, you must also specify the destination port or port range. For ICMP/ICMPv6, you must also specify the ICMP/ICMPv6 type and code. You can use -1 to mean all types or all codes.

    Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

    For more information about VPC security group limits, see Amazon VPC Limits.

    See

    AWSEC2AuthorizeSecurityGroupIngressRequest

    Declaration

    Objective-C

    - (id)authorizeSecurityGroupIngress:
        (nonnull AWSEC2AuthorizeSecurityGroupIngressRequest *)request;

    Swift

    func authorizeSecurityGroupIngress(_ request: AWSEC2AuthorizeSecurityGroupIngressRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the AuthorizeSecurityGroupIngress service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • Adds the specified ingress rules to a security group.

    An inbound rule permits instances to receive traffic from the specified IPv4 or IPv6 CIDR address ranges, or from the instances associated with the specified destination security groups.

    You specify a protocol for each rule (for example, TCP). For TCP and UDP, you must also specify the destination port or port range. For ICMP/ICMPv6, you must also specify the ICMP/ICMPv6 type and code. You can use -1 to mean all types or all codes.

    Rule changes are propagated to instances within the security group as quickly as possible. However, a small delay might occur.

    For more information about VPC security group limits, see Amazon VPC Limits.

    See

    AWSEC2AuthorizeSecurityGroupIngressRequest

    Declaration

    Objective-C

    - (void)authorizeSecurityGroupIngress:
                (nonnull AWSEC2AuthorizeSecurityGroupIngressRequest *)request
                        completionHandler:(void (^_Nullable)(NSError *_Nullable))
                                              completionHandler;

    Swift

    func authorizeSecurityGroupIngress(_ request: AWSEC2AuthorizeSecurityGroupIngressRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the AuthorizeSecurityGroupIngress service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Bundles an Amazon instance store-backed Windows instance.

    During bundling, only the root device volume (C:) is bundled. Data on other instance store volumes is not preserved.

    This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

    See

    AWSEC2BundleInstanceRequest

    See

    AWSEC2BundleInstanceResult

    Declaration

    Objective-C

    - (id)bundleInstance:(nonnull AWSEC2BundleInstanceRequest *)request;

    Swift

    func bundleInstance(_ request: AWSEC2BundleInstanceRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the BundleInstance service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2BundleInstanceResult.

  • Bundles an Amazon instance store-backed Windows instance.

    During bundling, only the root device volume (C:) is bundled. Data on other instance store volumes is not preserved.

    This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

    See

    AWSEC2BundleInstanceRequest

    See

    AWSEC2BundleInstanceResult

    Declaration

    Objective-C

    - (void)bundleInstance:(nonnull AWSEC2BundleInstanceRequest *)request
         completionHandler:(void (^_Nullable)(AWSEC2BundleInstanceResult *_Nullable,
                                              NSError *_Nullable))completionHandler;

    Swift

    func bundleInstance(_ request: AWSEC2BundleInstanceRequest, completionHandler: ((AWSEC2BundleInstanceResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the BundleInstance service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels a bundling operation for an instance store-backed Windows instance.

    See

    AWSEC2CancelBundleTaskRequest

    See

    AWSEC2CancelBundleTaskResult

    Declaration

    Objective-C

    - (id)cancelBundleTask:(nonnull AWSEC2CancelBundleTaskRequest *)request;

    Swift

    func cancelBundleTask(_ request: AWSEC2CancelBundleTaskRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelBundleTask service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CancelBundleTaskResult.

  • Cancels a bundling operation for an instance store-backed Windows instance.

    See

    AWSEC2CancelBundleTaskRequest

    See

    AWSEC2CancelBundleTaskResult

    Declaration

    Objective-C

    - (void)cancelBundleTask:(nonnull AWSEC2CancelBundleTaskRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2CancelBundleTaskResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func cancelBundleTask(_ request: AWSEC2CancelBundleTaskRequest, completionHandler: ((AWSEC2CancelBundleTaskResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelBundleTask service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels the specified Capacity Reservation, releases the reserved capacity, and changes the Capacity Reservation’s state to cancelled.

    Instances running in the reserved capacity continue running until you stop them. Stopped instances that target the Capacity Reservation can no longer launch. Modify these instances to either target a different Capacity Reservation, launch On-Demand Instance capacity, or run in any open Capacity Reservation that has matching attributes and sufficient capacity.

    See

    AWSEC2CancelCapacityReservationRequest

    See

    AWSEC2CancelCapacityReservationResult

    Declaration

    Objective-C

    - (id)cancelCapacityReservation:
        (nonnull AWSEC2CancelCapacityReservationRequest *)request;

    Swift

    func cancelCapacityReservation(_ request: AWSEC2CancelCapacityReservationRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelCapacityReservation service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CancelCapacityReservationResult.

  • Cancels the specified Capacity Reservation, releases the reserved capacity, and changes the Capacity Reservation’s state to cancelled.

    Instances running in the reserved capacity continue running until you stop them. Stopped instances that target the Capacity Reservation can no longer launch. Modify these instances to either target a different Capacity Reservation, launch On-Demand Instance capacity, or run in any open Capacity Reservation that has matching attributes and sufficient capacity.

    See

    AWSEC2CancelCapacityReservationRequest

    See

    AWSEC2CancelCapacityReservationResult

    Declaration

    Objective-C

    - (void)cancelCapacityReservation:
                (nonnull AWSEC2CancelCapacityReservationRequest *)request
                    completionHandler:
                        (void (^_Nullable)(
                            AWSEC2CancelCapacityReservationResult *_Nullable,
                            NSError *_Nullable))completionHandler;

    Swift

    func cancelCapacityReservation(_ request: AWSEC2CancelCapacityReservationRequest, completionHandler: ((AWSEC2CancelCapacityReservationResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelCapacityReservation service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

    For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

    See

    AWSEC2CancelConversionRequest

    Declaration

    Objective-C

    - (id)cancelConversionTask:(nonnull AWSEC2CancelConversionRequest *)request;

    Swift

    func cancelConversionTask(_ request: AWSEC2CancelConversionRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelConversionTask service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • Cancels an active conversion task. The task can be the import of an instance or volume. The action removes all artifacts of the conversion, including a partially uploaded volume or instance. If the conversion is complete or is in the process of transferring the final disk image, the command fails and returns an exception.

    For more information, see Importing a Virtual Machine Using the Amazon EC2 CLI.

    See

    AWSEC2CancelConversionRequest

    Declaration

    Objective-C

    - (void)cancelConversionTask:(nonnull AWSEC2CancelConversionRequest *)request
               completionHandler:
                   (void (^_Nullable)(NSError *_Nullable))completionHandler;

    Swift

    func cancelConversionTask(_ request: AWSEC2CancelConversionRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelConversionTask service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

    See

    AWSEC2CancelExportTaskRequest

    Declaration

    Objective-C

    - (id)cancelExportTask:(nonnull AWSEC2CancelExportTaskRequest *)request;

    Swift

    func cancelExportTask(_ request: AWSEC2CancelExportTaskRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelExportTask service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • Cancels an active export task. The request removes all artifacts of the export, including any partially-created Amazon S3 objects. If the export task is complete or is in the process of transferring the final disk image, the command fails and returns an error.

    See

    AWSEC2CancelExportTaskRequest

    Declaration

    Objective-C

    - (void)cancelExportTask:(nonnull AWSEC2CancelExportTaskRequest *)request
           completionHandler:
               (void (^_Nullable)(NSError *_Nullable))completionHandler;

    Swift

    func cancelExportTask(_ request: AWSEC2CancelExportTaskRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelExportTask service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels an in-process import virtual machine or import snapshot task.

    See

    AWSEC2CancelImportTaskRequest

    See

    AWSEC2CancelImportTaskResult

    Declaration

    Objective-C

    - (id)cancelImportTask:(nonnull AWSEC2CancelImportTaskRequest *)request;

    Swift

    func cancelImportTask(_ request: AWSEC2CancelImportTaskRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelImportTask service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CancelImportTaskResult.

  • Cancels an in-process import virtual machine or import snapshot task.

    See

    AWSEC2CancelImportTaskRequest

    See

    AWSEC2CancelImportTaskResult

    Declaration

    Objective-C

    - (void)cancelImportTask:(nonnull AWSEC2CancelImportTaskRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2CancelImportTaskResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func cancelImportTask(_ request: AWSEC2CancelImportTaskRequest, completionHandler: ((AWSEC2CancelImportTaskResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelImportTask service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

    For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CancelReservedInstancesListingRequest

    See

    AWSEC2CancelReservedInstancesListingResult

    Declaration

    Objective-C

    - (id)cancelReservedInstancesListing:
        (nonnull AWSEC2CancelReservedInstancesListingRequest *)request;

    Swift

    func cancelReservedInstancesListing(_ request: AWSEC2CancelReservedInstancesListingRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelReservedInstancesListing service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CancelReservedInstancesListingResult.

  • Cancels the specified Reserved Instance listing in the Reserved Instance Marketplace.

    For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CancelReservedInstancesListingRequest

    See

    AWSEC2CancelReservedInstancesListingResult

    Declaration

    Objective-C

    - (void)
        cancelReservedInstancesListing:
            (nonnull AWSEC2CancelReservedInstancesListingRequest *)request
                     completionHandler:
                         (void (^_Nullable)(
                             AWSEC2CancelReservedInstancesListingResult *_Nullable,
                             NSError *_Nullable))completionHandler;

    Swift

    func cancelReservedInstancesListing(_ request: AWSEC2CancelReservedInstancesListingRequest, completionHandler: ((AWSEC2CancelReservedInstancesListingResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelReservedInstancesListing service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels the specified Spot Fleet requests.

    After you cancel a Spot Fleet request, the Spot Fleet launches no new Spot Instances. You must specify whether the Spot Fleet should also terminate its Spot Instances. If you terminate the instances, the Spot Fleet request enters the cancelled_terminating state. Otherwise, the Spot Fleet request enters the cancelled_running state and the instances continue to run until they are interrupted or you terminate them manually.

    See

    AWSEC2CancelSpotFleetRequestsRequest

    See

    AWSEC2CancelSpotFleetRequestsResponse

    Declaration

    Objective-C

    - (id)cancelSpotFleetRequests:
        (nonnull AWSEC2CancelSpotFleetRequestsRequest *)request;

    Swift

    func cancelSpotFleetRequests(_ request: AWSEC2CancelSpotFleetRequestsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelSpotFleetRequests service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CancelSpotFleetRequestsResponse.

  • Cancels the specified Spot Fleet requests.

    After you cancel a Spot Fleet request, the Spot Fleet launches no new Spot Instances. You must specify whether the Spot Fleet should also terminate its Spot Instances. If you terminate the instances, the Spot Fleet request enters the cancelled_terminating state. Otherwise, the Spot Fleet request enters the cancelled_running state and the instances continue to run until they are interrupted or you terminate them manually.

    See

    AWSEC2CancelSpotFleetRequestsRequest

    See

    AWSEC2CancelSpotFleetRequestsResponse

    Declaration

    Objective-C

    - (void)cancelSpotFleetRequests:
                (nonnull AWSEC2CancelSpotFleetRequestsRequest *)request
                  completionHandler:
                      (void (^_Nullable)(
                          AWSEC2CancelSpotFleetRequestsResponse *_Nullable,
                          NSError *_Nullable))completionHandler;

    Swift

    func cancelSpotFleetRequests(_ request: AWSEC2CancelSpotFleetRequestsRequest, completionHandler: ((AWSEC2CancelSpotFleetRequestsResponse?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelSpotFleetRequests service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Cancels one or more Spot Instance requests.

    Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

    See

    AWSEC2CancelSpotInstanceRequestsRequest

    See

    AWSEC2CancelSpotInstanceRequestsResult

    Declaration

    Objective-C

    - (id)cancelSpotInstanceRequests:
        (nonnull AWSEC2CancelSpotInstanceRequestsRequest *)request;

    Swift

    func cancelSpotInstanceRequests(_ request: AWSEC2CancelSpotInstanceRequestsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CancelSpotInstanceRequests service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CancelSpotInstanceRequestsResult.

  • Cancels one or more Spot Instance requests.

    Canceling a Spot Instance request does not terminate running Spot Instances associated with the request.

    See

    AWSEC2CancelSpotInstanceRequestsRequest

    See

    AWSEC2CancelSpotInstanceRequestsResult

    Declaration

    Objective-C

    - (void)cancelSpotInstanceRequests:
                (nonnull AWSEC2CancelSpotInstanceRequestsRequest *)request
                     completionHandler:
                         (void (^_Nullable)(
                             AWSEC2CancelSpotInstanceRequestsResult *_Nullable,
                             NSError *_Nullable))completionHandler;

    Swift

    func cancelSpotInstanceRequests(_ request: AWSEC2CancelSpotInstanceRequestsRequest, completionHandler: ((AWSEC2CancelSpotInstanceRequestsResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CancelSpotInstanceRequests service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner must verify whether another user’s instance is eligible for support.

    See

    AWSEC2ConfirmProductInstanceRequest

    See

    AWSEC2ConfirmProductInstanceResult

    Declaration

    Objective-C

    - (id)confirmProductInstance:
        (nonnull AWSEC2ConfirmProductInstanceRequest *)request;

    Swift

    func confirmProductInstance(_ request: AWSEC2ConfirmProductInstanceRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the ConfirmProductInstance service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2ConfirmProductInstanceResult.

  • Determines whether a product code is associated with an instance. This action can only be used by the owner of the product code. It is useful when a product code owner must verify whether another user’s instance is eligible for support.

    See

    AWSEC2ConfirmProductInstanceRequest

    See

    AWSEC2ConfirmProductInstanceResult

    Declaration

    Objective-C

    - (void)
        confirmProductInstance:
            (nonnull AWSEC2ConfirmProductInstanceRequest *)request
             completionHandler:
                 (void (^_Nullable)(AWSEC2ConfirmProductInstanceResult *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func confirmProductInstance(_ request: AWSEC2ConfirmProductInstanceRequest, completionHandler: ((AWSEC2ConfirmProductInstanceResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the ConfirmProductInstance service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Copies the specified Amazon FPGA Image (AFI) to the current Region.

    See

    AWSEC2ReplicateFpgaImageRequest

    See

    AWSEC2ReplicateFpgaImageResult

    Declaration

    Objective-C

    - (id)replicateFpgaImage:(nonnull AWSEC2ReplicateFpgaImageRequest *)request;

    Swift

    func replicateFpgaImage(_ request: AWSEC2ReplicateFpgaImageRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CopyFpgaImage service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2ReplicateFpgaImageResult.

  • Copies the specified Amazon FPGA Image (AFI) to the current Region.

    See

    AWSEC2ReplicateFpgaImageRequest

    See

    AWSEC2ReplicateFpgaImageResult

    Declaration

    Objective-C

    - (void)replicateFpgaImage:(nonnull AWSEC2ReplicateFpgaImageRequest *)request
             completionHandler:
                 (void (^_Nullable)(AWSEC2ReplicateFpgaImageResult *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func replicateFpgaImage(_ request: AWSEC2ReplicateFpgaImageRequest, completionHandler: ((AWSEC2ReplicateFpgaImageResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CopyFpgaImage service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Initiates the copy of an AMI from the specified source Region to the current Region. You specify the destination Region by using its endpoint when making the request.

    Copies of encrypted backing snapshots for the AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, unless you set Encrypted during the copy operation. You cannot create an unencrypted copy of an encrypted backing snapshot.

    For more information about the prerequisites and limits when copying an AMI, see Copying an AMI in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2ReplicateImageRequest

    See

    AWSEC2ReplicateImageResult

    Declaration

    Objective-C

    - (id)replicateImage:(nonnull AWSEC2ReplicateImageRequest *)request;

    Swift

    func replicateImage(_ request: AWSEC2ReplicateImageRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CopyImage service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2ReplicateImageResult.

  • Initiates the copy of an AMI from the specified source Region to the current Region. You specify the destination Region by using its endpoint when making the request.

    Copies of encrypted backing snapshots for the AMI are encrypted. Copies of unencrypted backing snapshots remain unencrypted, unless you set Encrypted during the copy operation. You cannot create an unencrypted copy of an encrypted backing snapshot.

    For more information about the prerequisites and limits when copying an AMI, see Copying an AMI in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2ReplicateImageRequest

    See

    AWSEC2ReplicateImageResult

    Declaration

    Objective-C

    - (void)replicateImage:(nonnull AWSEC2ReplicateImageRequest *)request
         completionHandler:(void (^_Nullable)(AWSEC2ReplicateImageResult *_Nullable,
                                              NSError *_Nullable))completionHandler;

    Swift

    func replicateImage(_ request: AWSEC2ReplicateImageRequest, completionHandler: ((AWSEC2ReplicateImageResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CopyImage service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same Region or from one Region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).

    Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless you enable encryption for the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a different CMK.

    To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.

    Snapshots created by copying another snapshot have an arbitrary volume ID that should not be used for any purpose.

    For more information, see Copying an Amazon EBS snapshot in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2ReplicateSnapshotRequest

    See

    AWSEC2ReplicateSnapshotResult

    Declaration

    Objective-C

    - (id)replicateSnapshot:(nonnull AWSEC2ReplicateSnapshotRequest *)request;

    Swift

    func replicateSnapshot(_ request: AWSEC2ReplicateSnapshotRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CopySnapshot service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2ReplicateSnapshotResult.

  • Copies a point-in-time snapshot of an EBS volume and stores it in Amazon S3. You can copy the snapshot within the same Region or from one Region to another. You can use the snapshot to create EBS volumes or Amazon Machine Images (AMIs).

    Copies of encrypted EBS snapshots remain encrypted. Copies of unencrypted snapshots remain unencrypted, unless you enable encryption for the snapshot copy operation. By default, encrypted snapshot copies use the default AWS Key Management Service (AWS KMS) customer master key (CMK); however, you can specify a different CMK.

    To copy an encrypted snapshot that has been shared from another account, you must have permissions for the CMK used to encrypt the snapshot.

    Snapshots created by copying another snapshot have an arbitrary volume ID that should not be used for any purpose.

    For more information, see Copying an Amazon EBS snapshot in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2ReplicateSnapshotRequest

    See

    AWSEC2ReplicateSnapshotResult

    Declaration

    Objective-C

    - (void)replicateSnapshot:(nonnull AWSEC2ReplicateSnapshotRequest *)request
            completionHandler:
                (void (^_Nullable)(AWSEC2ReplicateSnapshotResult *_Nullable,
                                   NSError *_Nullable))completionHandler;

    Swift

    func replicateSnapshot(_ request: AWSEC2ReplicateSnapshotRequest, completionHandler: ((AWSEC2ReplicateSnapshotResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CopySnapshot service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a new Capacity Reservation with the specified attributes.

    Capacity Reservations enable you to reserve capacity for your Amazon EC2 instances in a specific Availability Zone for any duration. This gives you the flexibility to selectively add capacity reservations and still get the Regional RI discounts for that usage. By creating Capacity Reservations, you ensure that you always have access to Amazon EC2 capacity when you need it, for as long as you need it. For more information, see Capacity Reservations in the Amazon Elastic Compute Cloud User Guide.

    Your request to create a Capacity Reservation could fail if Amazon EC2 does not have sufficient capacity to fulfill the request. If your request fails due to Amazon EC2 capacity constraints, either try again at a later time, try in a different Availability Zone, or request a smaller capacity reservation. If your application is flexible across instance types and sizes, try to create a Capacity Reservation with different instance attributes.

    Your request could also fail if the requested quantity exceeds your On-Demand Instance limit for the selected instance type. If your request fails due to limit constraints, increase your On-Demand Instance limit for the required instance type and try again. For more information about increasing your instance limits, see Amazon EC2 Service Limits in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateCapacityReservationRequest

    See

    AWSEC2CreateCapacityReservationResult

    Declaration

    Objective-C

    - (id)createCapacityReservation:
        (nonnull AWSEC2CreateCapacityReservationRequest *)request;

    Swift

    func createCapacityReservation(_ request: AWSEC2CreateCapacityReservationRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateCapacityReservation service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateCapacityReservationResult.

  • Creates a new Capacity Reservation with the specified attributes.

    Capacity Reservations enable you to reserve capacity for your Amazon EC2 instances in a specific Availability Zone for any duration. This gives you the flexibility to selectively add capacity reservations and still get the Regional RI discounts for that usage. By creating Capacity Reservations, you ensure that you always have access to Amazon EC2 capacity when you need it, for as long as you need it. For more information, see Capacity Reservations in the Amazon Elastic Compute Cloud User Guide.

    Your request to create a Capacity Reservation could fail if Amazon EC2 does not have sufficient capacity to fulfill the request. If your request fails due to Amazon EC2 capacity constraints, either try again at a later time, try in a different Availability Zone, or request a smaller capacity reservation. If your application is flexible across instance types and sizes, try to create a Capacity Reservation with different instance attributes.

    Your request could also fail if the requested quantity exceeds your On-Demand Instance limit for the selected instance type. If your request fails due to limit constraints, increase your On-Demand Instance limit for the required instance type and try again. For more information about increasing your instance limits, see Amazon EC2 Service Limits in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateCapacityReservationRequest

    See

    AWSEC2CreateCapacityReservationResult

    Declaration

    Objective-C

    - (void)createCapacityReservation:
                (nonnull AWSEC2CreateCapacityReservationRequest *)request
                    completionHandler:
                        (void (^_Nullable)(
                            AWSEC2CreateCapacityReservationResult *_Nullable,
                            NSError *_Nullable))completionHandler;

    Swift

    func createCapacityReservation(_ request: AWSEC2CreateCapacityReservationRequest, completionHandler: ((AWSEC2CreateCapacityReservationResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateCapacityReservation service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a carrier gateway. For more information about carrier gateways, see Carrier gateways in the AWS Wavelength Developer Guide.

    See

    AWSEC2CreateCarrierGatewayRequest

    See

    AWSEC2CreateCarrierGatewayResult

    Declaration

    Objective-C

    - (id)createCarrierGateway:(nonnull AWSEC2CreateCarrierGatewayRequest *)request;

    Swift

    func createCarrierGateway(_ request: AWSEC2CreateCarrierGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateCarrierGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateCarrierGatewayResult.

  • Creates a carrier gateway. For more information about carrier gateways, see Carrier gateways in the AWS Wavelength Developer Guide.

    See

    AWSEC2CreateCarrierGatewayRequest

    See

    AWSEC2CreateCarrierGatewayResult

    Declaration

    Objective-C

    - (void)createCarrierGateway:
                (nonnull AWSEC2CreateCarrierGatewayRequest *)request
               completionHandler:
                   (void (^_Nullable)(AWSEC2CreateCarrierGatewayResult *_Nullable,
                                      NSError *_Nullable))completionHandler;

    Swift

    func createCarrierGateway(_ request: AWSEC2CreateCarrierGatewayRequest, completionHandler: ((AWSEC2CreateCarrierGatewayResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateCarrierGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a Client VPN endpoint. A Client VPN endpoint is the resource you create and configure to enable and manage client VPN sessions. It is the destination endpoint at which all client VPN sessions are terminated.

    See

    AWSEC2CreateClientVpnEndpointRequest

    See

    AWSEC2CreateClientVpnEndpointResult

    Declaration

    Objective-C

    - (id)createClientVpnEndpoint:
        (nonnull AWSEC2CreateClientVpnEndpointRequest *)request;

    Swift

    func createClientVpnEndpoint(_ request: AWSEC2CreateClientVpnEndpointRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateClientVpnEndpoint service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateClientVpnEndpointResult.

  • Creates a Client VPN endpoint. A Client VPN endpoint is the resource you create and configure to enable and manage client VPN sessions. It is the destination endpoint at which all client VPN sessions are terminated.

    See

    AWSEC2CreateClientVpnEndpointRequest

    See

    AWSEC2CreateClientVpnEndpointResult

    Declaration

    Objective-C

    - (void)
        createClientVpnEndpoint:
            (nonnull AWSEC2CreateClientVpnEndpointRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2CreateClientVpnEndpointResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func createClientVpnEndpoint(_ request: AWSEC2CreateClientVpnEndpointRequest, completionHandler: ((AWSEC2CreateClientVpnEndpointResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateClientVpnEndpoint service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Adds a route to a network to a Client VPN endpoint. Each Client VPN endpoint has a route table that describes the available destination network routes. Each route in the route table specifies the path for traffic to specific resources or networks.

    See

    AWSEC2CreateClientVpnRouteRequest

    See

    AWSEC2CreateClientVpnRouteResult

    Declaration

    Objective-C

    - (id)createClientVpnRoute:(nonnull AWSEC2CreateClientVpnRouteRequest *)request;

    Swift

    func createClientVpnRoute(_ request: AWSEC2CreateClientVpnRouteRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateClientVpnRoute service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateClientVpnRouteResult.

  • Adds a route to a network to a Client VPN endpoint. Each Client VPN endpoint has a route table that describes the available destination network routes. Each route in the route table specifies the path for traffic to specific resources or networks.

    See

    AWSEC2CreateClientVpnRouteRequest

    See

    AWSEC2CreateClientVpnRouteResult

    Declaration

    Objective-C

    - (void)createClientVpnRoute:
                (nonnull AWSEC2CreateClientVpnRouteRequest *)request
               completionHandler:
                   (void (^_Nullable)(AWSEC2CreateClientVpnRouteResult *_Nullable,
                                      NSError *_Nullable))completionHandler;

    Swift

    func createClientVpnRoute(_ request: AWSEC2CreateClientVpnRouteRequest, completionHandler: ((AWSEC2CreateClientVpnRouteResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateClientVpnRoute service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the internet-routable IP address of the customer gateway’s external interface. The IP address must be static and can be behind a device performing network address translation (NAT).

    For devices that use Border Gateway Protocol (BGP), you can also provide the device’s BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don’t have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

    Amazon EC2 supports all 4-byte ASN numbers in the range of 1 - 2147483647, with the exception of the following:

    • 7224 - reserved in the us-east-1 Region

    • 9059 - reserved in the eu-west-1 Region

    • 17943 - reserved in the ap-southeast-1 Region

    • 10124 - reserved in the ap-northeast-1 Region

    For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

    To create more than one customer gateway with the same VPN type, IP address, and BGP ASN, specify a unique device name for each customer gateway. Identical requests return information about the existing customer gateway and do not create new customer gateways.

    See

    AWSEC2CreateCustomerGatewayRequest

    See

    AWSEC2CreateCustomerGatewayResult

    Declaration

    Objective-C

    - (id)createCustomerGateway:
        (nonnull AWSEC2CreateCustomerGatewayRequest *)request;

    Swift

    func createCustomerGateway(_ request: AWSEC2CreateCustomerGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateCustomerGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateCustomerGatewayResult.

  • Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the internet-routable IP address of the customer gateway’s external interface. The IP address must be static and can be behind a device performing network address translation (NAT).

    For devices that use Border Gateway Protocol (BGP), you can also provide the device’s BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don’t have an ASN already, you can use a private ASN (in the 64512 - 65534 range).

    Amazon EC2 supports all 4-byte ASN numbers in the range of 1 - 2147483647, with the exception of the following:

    • 7224 - reserved in the us-east-1 Region

    • 9059 - reserved in the eu-west-1 Region

    • 17943 - reserved in the ap-southeast-1 Region

    • 10124 - reserved in the ap-northeast-1 Region

    For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.

    To create more than one customer gateway with the same VPN type, IP address, and BGP ASN, specify a unique device name for each customer gateway. Identical requests return information about the existing customer gateway and do not create new customer gateways.

    See

    AWSEC2CreateCustomerGatewayRequest

    See

    AWSEC2CreateCustomerGatewayResult

    Declaration

    Objective-C

    - (void)createCustomerGateway:
                (nonnull AWSEC2CreateCustomerGatewayRequest *)request
                completionHandler:
                    (void (^_Nullable)(AWSEC2CreateCustomerGatewayResult *_Nullable,
                                       NSError *_Nullable))completionHandler;

    Swift

    func createCustomerGateway(_ request: AWSEC2CreateCustomerGatewayRequest, completionHandler: ((AWSEC2CreateCustomerGatewayResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateCustomerGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a default subnet with a size /20 IPv4 CIDR block in the specified Availability Zone in your default VPC. You can have only one default subnet per Availability Zone. For more information, see Creating a Default Subnet in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateDefaultSubnetRequest

    See

    AWSEC2CreateDefaultSubnetResult

    Declaration

    Objective-C

    - (id)createDefaultSubnet:(nonnull AWSEC2CreateDefaultSubnetRequest *)request;

    Swift

    func createDefaultSubnet(_ request: AWSEC2CreateDefaultSubnetRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateDefaultSubnet service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateDefaultSubnetResult.

  • Creates a default subnet with a size /20 IPv4 CIDR block in the specified Availability Zone in your default VPC. You can have only one default subnet per Availability Zone. For more information, see Creating a Default Subnet in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateDefaultSubnetRequest

    See

    AWSEC2CreateDefaultSubnetResult

    Declaration

    Objective-C

    - (void)createDefaultSubnet:(nonnull AWSEC2CreateDefaultSubnetRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2CreateDefaultSubnetResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func createDefaultSubnet(_ request: AWSEC2CreateDefaultSubnetRequest, completionHandler: ((AWSEC2CreateDefaultSubnetResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateDefaultSubnet service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a default VPC with a size /16 IPv4 CIDR block and a default subnet in each Availability Zone. For more information about the components of a default VPC, see Default VPC and Default Subnets in the Amazon Virtual Private Cloud User Guide. You cannot specify the components of the default VPC yourself.

    If you deleted your previous default VPC, you can create a default VPC. You cannot have more than one default VPC per Region.

    If your account supports EC2-Classic, you cannot use this action to create a default VPC in a Region that supports EC2-Classic. If you want a default VPC in a Region that supports EC2-Classic, see “I really want a default VPC for my existing EC2 account. Is that possible?” in the Default VPCs FAQ.

    See

    AWSEC2CreateDefaultVpcRequest

    See

    AWSEC2CreateDefaultVpcResult

    Declaration

    Objective-C

    - (id)createDefaultVpc:(nonnull AWSEC2CreateDefaultVpcRequest *)request;

    Swift

    func createDefaultVpc(_ request: AWSEC2CreateDefaultVpcRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateDefaultVpc service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateDefaultVpcResult.

  • Creates a default VPC with a size /16 IPv4 CIDR block and a default subnet in each Availability Zone. For more information about the components of a default VPC, see Default VPC and Default Subnets in the Amazon Virtual Private Cloud User Guide. You cannot specify the components of the default VPC yourself.

    If you deleted your previous default VPC, you can create a default VPC. You cannot have more than one default VPC per Region.

    If your account supports EC2-Classic, you cannot use this action to create a default VPC in a Region that supports EC2-Classic. If you want a default VPC in a Region that supports EC2-Classic, see “I really want a default VPC for my existing EC2 account. Is that possible?” in the Default VPCs FAQ.

    See

    AWSEC2CreateDefaultVpcRequest

    See

    AWSEC2CreateDefaultVpcResult

    Declaration

    Objective-C

    - (void)createDefaultVpc:(nonnull AWSEC2CreateDefaultVpcRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2CreateDefaultVpcResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func createDefaultVpc(_ request: AWSEC2CreateDefaultVpcRequest, completionHandler: ((AWSEC2CreateDefaultVpcResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateDefaultVpc service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

    • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. To have your instance receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.

    • domain-name - If you’re using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you’re using AmazonProvidedDNS in another Region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, ExampleCompany.com). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.

    • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.

    • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.

    • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

    Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateDhcpOptionsRequest

    See

    AWSEC2CreateDhcpOptionsResult

    Declaration

    Objective-C

    - (id)createDhcpOptions:(nonnull AWSEC2CreateDhcpOptionsRequest *)request;

    Swift

    func createDhcpOptions(_ request: AWSEC2CreateDhcpOptionsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateDhcpOptions service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateDhcpOptionsResult.

  • Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.

    • domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. To have your instance receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.

    • domain-name - If you’re using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you’re using AmazonProvidedDNS in another Region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, ExampleCompany.com). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.

    • ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.

    • netbios-name-servers - The IP addresses of up to four NetBIOS name servers.

    • netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.

    Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateDhcpOptionsRequest

    See

    AWSEC2CreateDhcpOptionsResult

    Declaration

    Objective-C

    - (void)createDhcpOptions:(nonnull AWSEC2CreateDhcpOptionsRequest *)request
            completionHandler:
                (void (^_Nullable)(AWSEC2CreateDhcpOptionsResult *_Nullable,
                                   NSError *_Nullable))completionHandler;

    Swift

    func createDhcpOptions(_ request: AWSEC2CreateDhcpOptionsRequest, completionHandler: ((AWSEC2CreateDhcpOptionsResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateDhcpOptions service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • [IPv6 only] Creates an egress-only internet gateway for your VPC. An egress-only internet gateway is used to enable outbound communication over IPv6 from instances in your VPC to the internet, and prevents hosts outside of your VPC from initiating an IPv6 connection with your instance.

    See

    AWSEC2CreateEgressOnlyInternetGatewayRequest

    See

    AWSEC2CreateEgressOnlyInternetGatewayResult

    Declaration

    Objective-C

    - (id)createEgressOnlyInternetGateway:
        (nonnull AWSEC2CreateEgressOnlyInternetGatewayRequest *)request;

    Swift

    func createEgressOnlyInternetGateway(_ request: AWSEC2CreateEgressOnlyInternetGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateEgressOnlyInternetGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateEgressOnlyInternetGatewayResult.

  • [IPv6 only] Creates an egress-only internet gateway for your VPC. An egress-only internet gateway is used to enable outbound communication over IPv6 from instances in your VPC to the internet, and prevents hosts outside of your VPC from initiating an IPv6 connection with your instance.

    See

    AWSEC2CreateEgressOnlyInternetGatewayRequest

    See

    AWSEC2CreateEgressOnlyInternetGatewayResult

    Declaration

    Objective-C

    - (void)createEgressOnlyInternetGateway:
                (nonnull AWSEC2CreateEgressOnlyInternetGatewayRequest *)request
                          completionHandler:
                              (void (^_Nullable)(
                                  AWSEC2CreateEgressOnlyInternetGatewayResult
                                      *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func createEgressOnlyInternetGateway(_ request: AWSEC2CreateEgressOnlyInternetGatewayRequest, completionHandler: ((AWSEC2CreateEgressOnlyInternetGatewayResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateEgressOnlyInternetGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Launches an EC2 Fleet.

    You can create a single EC2 Fleet that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

    For more information, see Launching an EC2 Fleet in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateFleetRequest

    See

    AWSEC2CreateFleetResult

    Declaration

    Objective-C

    - (id)createFleet:(nonnull AWSEC2CreateFleetRequest *)request;

    Swift

    func createFleet(_ request: AWSEC2CreateFleetRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateFleet service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateFleetResult.

  • Launches an EC2 Fleet.

    You can create a single EC2 Fleet that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

    For more information, see Launching an EC2 Fleet in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateFleetRequest

    See

    AWSEC2CreateFleetResult

    Declaration

    Objective-C

    - (void)createFleet:(nonnull AWSEC2CreateFleetRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2CreateFleetResult *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func createFleet(_ request: AWSEC2CreateFleetRequest, completionHandler: ((AWSEC2CreateFleetResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateFleet service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates one or more flow logs to capture information about IP traffic for a specific network interface, subnet, or VPC.

    Flow log data for a monitored network interface is recorded as flow log records, which are log events consisting of fields that describe the traffic flow. For more information, see Flow Log Records in the Amazon Virtual Private Cloud User Guide.

    When publishing to CloudWatch Logs, flow log records are published to a log group, and each network interface has a unique log stream in the log group. When publishing to Amazon S3, flow log records for all of the monitored network interfaces are published to a single log file object that is stored in the specified bucket.

    For more information, see VPC Flow Logs in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateFlowLogsRequest

    See

    AWSEC2CreateFlowLogsResult

    Declaration

    Objective-C

    - (id)createFlowLogs:(nonnull AWSEC2CreateFlowLogsRequest *)request;

    Swift

    func createFlowLogs(_ request: AWSEC2CreateFlowLogsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateFlowLogs service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateFlowLogsResult.

  • Creates one or more flow logs to capture information about IP traffic for a specific network interface, subnet, or VPC.

    Flow log data for a monitored network interface is recorded as flow log records, which are log events consisting of fields that describe the traffic flow. For more information, see Flow Log Records in the Amazon Virtual Private Cloud User Guide.

    When publishing to CloudWatch Logs, flow log records are published to a log group, and each network interface has a unique log stream in the log group. When publishing to Amazon S3, flow log records for all of the monitored network interfaces are published to a single log file object that is stored in the specified bucket.

    For more information, see VPC Flow Logs in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateFlowLogsRequest

    See

    AWSEC2CreateFlowLogsResult

    Declaration

    Objective-C

    - (void)createFlowLogs:(nonnull AWSEC2CreateFlowLogsRequest *)request
         completionHandler:(void (^_Nullable)(AWSEC2CreateFlowLogsResult *_Nullable,
                                              NSError *_Nullable))completionHandler;

    Swift

    func createFlowLogs(_ request: AWSEC2CreateFlowLogsRequest, completionHandler: ((AWSEC2CreateFlowLogsResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateFlowLogs service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates an Amazon FPGA Image (AFI) from the specified design checkpoint (DCP).

    The create operation is asynchronous. To verify that the AFI is ready for use, check the output logs.

    An AFI contains the FPGA bitstream that is ready to download to an FPGA. You can securely deploy an AFI on multiple FPGA-accelerated instances. For more information, see the AWS FPGA Hardware Development Kit.

    See

    AWSEC2CreateFpgaImageRequest

    See

    AWSEC2CreateFpgaImageResult

    Declaration

    Objective-C

    - (id)createFpgaImage:(nonnull AWSEC2CreateFpgaImageRequest *)request;

    Swift

    func createFpgaImage(_ request: AWSEC2CreateFpgaImageRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateFpgaImage service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateFpgaImageResult.

  • Creates an Amazon FPGA Image (AFI) from the specified design checkpoint (DCP).

    The create operation is asynchronous. To verify that the AFI is ready for use, check the output logs.

    An AFI contains the FPGA bitstream that is ready to download to an FPGA. You can securely deploy an AFI on multiple FPGA-accelerated instances. For more information, see the AWS FPGA Hardware Development Kit.

    See

    AWSEC2CreateFpgaImageRequest

    See

    AWSEC2CreateFpgaImageResult

    Declaration

    Objective-C

    - (void)createFpgaImage:(nonnull AWSEC2CreateFpgaImageRequest *)request
          completionHandler:
              (void (^_Nullable)(AWSEC2CreateFpgaImageResult *_Nullable,
                                 NSError *_Nullable))completionHandler;

    Swift

    func createFpgaImage(_ request: AWSEC2CreateFpgaImageRequest, completionHandler: ((AWSEC2CreateFpgaImageResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateFpgaImage service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

    If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

    For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateImageRequest

    See

    AWSEC2CreateImageResult

    Declaration

    Objective-C

    - (id)createImage:(nonnull AWSEC2CreateImageRequest *)request;

    Swift

    func createImage(_ request: AWSEC2CreateImageRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateImage service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateImageResult.

  • Creates an Amazon EBS-backed AMI from an Amazon EBS-backed instance that is either running or stopped.

    If you customized your instance with instance store volumes or EBS volumes in addition to the root device volume, the new AMI contains block device mapping information for those volumes. When you launch an instance from this new AMI, the instance automatically launches with those additional volumes.

    For more information, see Creating Amazon EBS-Backed Linux AMIs in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateImageRequest

    See

    AWSEC2CreateImageResult

    Declaration

    Objective-C

    - (void)createImage:(nonnull AWSEC2CreateImageRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2CreateImageResult *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func createImage(_ request: AWSEC2CreateImageRequest, completionHandler: ((AWSEC2CreateImageResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateImage service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Exports a running or stopped instance to an Amazon S3 bucket.

    For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an Instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

    See

    AWSEC2CreateInstanceExportTaskRequest

    See

    AWSEC2CreateInstanceExportTaskResult

    Declaration

    Objective-C

    - (id)createInstanceExportTask:
        (nonnull AWSEC2CreateInstanceExportTaskRequest *)request;

    Swift

    func createInstanceExportTask(_ request: AWSEC2CreateInstanceExportTaskRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateInstanceExportTask service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateInstanceExportTaskResult.

  • Exports a running or stopped instance to an Amazon S3 bucket.

    For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an Instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

    See

    AWSEC2CreateInstanceExportTaskRequest

    See

    AWSEC2CreateInstanceExportTaskResult

    Declaration

    Objective-C

    - (void)createInstanceExportTask:
                (nonnull AWSEC2CreateInstanceExportTaskRequest *)request
                   completionHandler:
                       (void (^_Nullable)(
                           AWSEC2CreateInstanceExportTaskResult *_Nullable,
                           NSError *_Nullable))completionHandler;

    Swift

    func createInstanceExportTask(_ request: AWSEC2CreateInstanceExportTaskRequest, completionHandler: ((AWSEC2CreateInstanceExportTaskResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateInstanceExportTask service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates an internet gateway for use with a VPC. After creating the internet gateway, you attach it to a VPC using AttachInternetGateway.

    For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateInternetGatewayRequest

    See

    AWSEC2CreateInternetGatewayResult

    Declaration

    Objective-C

    - (id)createInternetGateway:
        (nonnull AWSEC2CreateInternetGatewayRequest *)request;

    Swift

    func createInternetGateway(_ request: AWSEC2CreateInternetGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateInternetGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateInternetGatewayResult.

  • Creates an internet gateway for use with a VPC. After creating the internet gateway, you attach it to a VPC using AttachInternetGateway.

    For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateInternetGatewayRequest

    See

    AWSEC2CreateInternetGatewayResult

    Declaration

    Objective-C

    - (void)createInternetGateway:
                (nonnull AWSEC2CreateInternetGatewayRequest *)request
                completionHandler:
                    (void (^_Nullable)(AWSEC2CreateInternetGatewayResult *_Nullable,
                                       NSError *_Nullable))completionHandler;

    Swift

    func createInternetGateway(_ request: AWSEC2CreateInternetGatewayRequest, completionHandler: ((AWSEC2CreateInternetGatewayResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateInternetGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#1 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

    You can have up to five thousand key pairs per Region.

    The key pair returned to you is available only in the Region in which you create it. If you prefer, you can create your own key pair using a third-party tool and upload it to any Region using ImportKeyPair.

    For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateKeyPairRequest

    See

    AWSEC2KeyPair

    Declaration

    Objective-C

    - (id)createKeyPair:(nonnull AWSEC2CreateKeyPairRequest *)request;

    Swift

    func createKeyPair(_ request: AWSEC2CreateKeyPairRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateKeyPair service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2KeyPair.

  • Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#1 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

    You can have up to five thousand key pairs per Region.

    The key pair returned to you is available only in the Region in which you create it. If you prefer, you can create your own key pair using a third-party tool and upload it to any Region using ImportKeyPair.

    For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateKeyPairRequest

    See

    AWSEC2KeyPair

    Declaration

    Objective-C

    - (void)createKeyPair:(nonnull AWSEC2CreateKeyPairRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2KeyPair *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func createKeyPair(_ request: AWSEC2CreateKeyPairRequest, completionHandler: ((AWSEC2KeyPair?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateKeyPair service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a launch template. A launch template contains the parameters to launch an instance. When you launch an instance using RunInstances, you can specify a launch template instead of providing the launch parameters in the request. For more information, see Launching an instance from a launch templatein the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateLaunchTemplateRequest

    See

    AWSEC2CreateLaunchTemplateResult

    Declaration

    Objective-C

    - (id)createLaunchTemplate:(nonnull AWSEC2CreateLaunchTemplateRequest *)request;

    Swift

    func createLaunchTemplate(_ request: AWSEC2CreateLaunchTemplateRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateLaunchTemplate service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateLaunchTemplateResult.

  • Creates a launch template. A launch template contains the parameters to launch an instance. When you launch an instance using RunInstances, you can specify a launch template instead of providing the launch parameters in the request. For more information, see Launching an instance from a launch templatein the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateLaunchTemplateRequest

    See

    AWSEC2CreateLaunchTemplateResult

    Declaration

    Objective-C

    - (void)createLaunchTemplate:
                (nonnull AWSEC2CreateLaunchTemplateRequest *)request
               completionHandler:
                   (void (^_Nullable)(AWSEC2CreateLaunchTemplateResult *_Nullable,
                                      NSError *_Nullable))completionHandler;

    Swift

    func createLaunchTemplate(_ request: AWSEC2CreateLaunchTemplateRequest, completionHandler: ((AWSEC2CreateLaunchTemplateResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateLaunchTemplate service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a new version for a launch template. You can specify an existing version of launch template from which to base the new version.

    Launch template versions are numbered in the order in which they are created. You cannot specify, change, or replace the numbering of launch template versions.

    For more information, see Managing launch template versionsin the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateLaunchTemplateVersionRequest

    See

    AWSEC2CreateLaunchTemplateVersionResult

    Declaration

    Objective-C

    - (id)createLaunchTemplateVersion:
        (nonnull AWSEC2CreateLaunchTemplateVersionRequest *)request;

    Swift

    func createLaunchTemplateVersion(_ request: AWSEC2CreateLaunchTemplateVersionRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateLaunchTemplateVersion service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateLaunchTemplateVersionResult.

  • Creates a new version for a launch template. You can specify an existing version of launch template from which to base the new version.

    Launch template versions are numbered in the order in which they are created. You cannot specify, change, or replace the numbering of launch template versions.

    For more information, see Managing launch template versionsin the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateLaunchTemplateVersionRequest

    See

    AWSEC2CreateLaunchTemplateVersionResult

    Declaration

    Objective-C

    - (void)createLaunchTemplateVersion:
                (nonnull AWSEC2CreateLaunchTemplateVersionRequest *)request
                      completionHandler:
                          (void (^_Nullable)(
                              AWSEC2CreateLaunchTemplateVersionResult *_Nullable,
                              NSError *_Nullable))completionHandler;

    Swift

    func createLaunchTemplateVersion(_ request: AWSEC2CreateLaunchTemplateVersionRequest, completionHandler: ((AWSEC2CreateLaunchTemplateVersionResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateLaunchTemplateVersion service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a static route for the specified local gateway route table.

    See

    AWSEC2CreateLocalGatewayRouteRequest

    See

    AWSEC2CreateLocalGatewayRouteResult

    Declaration

    Objective-C

    - (id)createLocalGatewayRoute:
        (nonnull AWSEC2CreateLocalGatewayRouteRequest *)request;

    Swift

    func createLocalGatewayRoute(_ request: AWSEC2CreateLocalGatewayRouteRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateLocalGatewayRoute service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateLocalGatewayRouteResult.

  • Creates a static route for the specified local gateway route table.

    See

    AWSEC2CreateLocalGatewayRouteRequest

    See

    AWSEC2CreateLocalGatewayRouteResult

    Declaration

    Objective-C

    - (void)
        createLocalGatewayRoute:
            (nonnull AWSEC2CreateLocalGatewayRouteRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2CreateLocalGatewayRouteResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func createLocalGatewayRoute(_ request: AWSEC2CreateLocalGatewayRouteRequest, completionHandler: ((AWSEC2CreateLocalGatewayRouteResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateLocalGatewayRoute service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Associates the specified VPC with the specified local gateway route table.

    See

    AWSEC2CreateLocalGatewayRouteTableVpcAssociationRequest

    See

    AWSEC2CreateLocalGatewayRouteTableVpcAssociationResult

    Declaration

    Objective-C

    - (id)createLocalGatewayRouteTableVpcAssociation:
        (nonnull AWSEC2CreateLocalGatewayRouteTableVpcAssociationRequest *)request;

    Swift

    func createLocalGatewayRouteTableVpcAssociation(_ request: AWSEC2CreateLocalGatewayRouteTableVpcAssociationRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateLocalGatewayRouteTableVpcAssociation service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateLocalGatewayRouteTableVpcAssociationResult.

  • Associates the specified VPC with the specified local gateway route table.

    See

    AWSEC2CreateLocalGatewayRouteTableVpcAssociationRequest

    See

    AWSEC2CreateLocalGatewayRouteTableVpcAssociationResult

    Declaration

    Objective-C

    - (void)
        createLocalGatewayRouteTableVpcAssociation:
            (nonnull AWSEC2CreateLocalGatewayRouteTableVpcAssociationRequest *)
                request
                                 completionHandler:
                                     (void (^_Nullable)(
                                         AWSEC2CreateLocalGatewayRouteTableVpcAssociationResult
                                             *_Nullable,
                                         NSError *_Nullable))completionHandler;

    Swift

    func createLocalGatewayRouteTableVpcAssociation(_ request: AWSEC2CreateLocalGatewayRouteTableVpcAssociationRequest, completionHandler: ((AWSEC2CreateLocalGatewayRouteTableVpcAssociationResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateLocalGatewayRouteTableVpcAssociation service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a managed prefix list. You can specify one or more entries for the prefix list. Each entry consists of a CIDR block and an optional description.

    You must specify the maximum number of entries for the prefix list. The maximum number of entries cannot be changed later.

    See

    AWSEC2CreateManagedPrefixListRequest

    See

    AWSEC2CreateManagedPrefixListResult

    Declaration

    Objective-C

    - (id)createManagedPrefixList:
        (nonnull AWSEC2CreateManagedPrefixListRequest *)request;

    Swift

    func createManagedPrefixList(_ request: AWSEC2CreateManagedPrefixListRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateManagedPrefixList service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateManagedPrefixListResult.

  • Creates a managed prefix list. You can specify one or more entries for the prefix list. Each entry consists of a CIDR block and an optional description.

    You must specify the maximum number of entries for the prefix list. The maximum number of entries cannot be changed later.

    See

    AWSEC2CreateManagedPrefixListRequest

    See

    AWSEC2CreateManagedPrefixListResult

    Declaration

    Objective-C

    - (void)
        createManagedPrefixList:
            (nonnull AWSEC2CreateManagedPrefixListRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2CreateManagedPrefixListResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func createManagedPrefixList(_ request: AWSEC2CreateManagedPrefixListRequest, completionHandler: ((AWSEC2CreateManagedPrefixListResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateManagedPrefixList service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a NAT gateway in the specified public subnet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. Internet-bound traffic from a private subnet can be routed to the NAT gateway, therefore enabling instances in the private subnet to connect to the internet. For more information, see NAT Gateways in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNatGatewayRequest

    See

    AWSEC2CreateNatGatewayResult

    Declaration

    Objective-C

    - (id)createNatGateway:(nonnull AWSEC2CreateNatGatewayRequest *)request;

    Swift

    func createNatGateway(_ request: AWSEC2CreateNatGatewayRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateNatGateway service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateNatGatewayResult.

  • Creates a NAT gateway in the specified public subnet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. Internet-bound traffic from a private subnet can be routed to the NAT gateway, therefore enabling instances in the private subnet to connect to the internet. For more information, see NAT Gateways in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNatGatewayRequest

    See

    AWSEC2CreateNatGatewayResult

    Declaration

    Objective-C

    - (void)createNatGateway:(nonnull AWSEC2CreateNatGatewayRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2CreateNatGatewayResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func createNatGateway(_ request: AWSEC2CreateNatGatewayRequest, completionHandler: ((AWSEC2CreateNatGatewayResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateNatGateway service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

    For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNetworkAclRequest

    See

    AWSEC2CreateNetworkAclResult

    Declaration

    Objective-C

    - (id)createNetworkAcl:(nonnull AWSEC2CreateNetworkAclRequest *)request;

    Swift

    func createNetworkAcl(_ request: AWSEC2CreateNetworkAclRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkAcl service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateNetworkAclResult.

  • Creates a network ACL in a VPC. Network ACLs provide an optional layer of security (in addition to security groups) for the instances in your VPC.

    For more information, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNetworkAclRequest

    See

    AWSEC2CreateNetworkAclResult

    Declaration

    Objective-C

    - (void)createNetworkAcl:(nonnull AWSEC2CreateNetworkAclRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2CreateNetworkAclResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func createNetworkAcl(_ request: AWSEC2CreateNetworkAclRequest, completionHandler: ((AWSEC2CreateNetworkAclResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkAcl service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

    We recommend that you leave room between the rule numbers (for example, 100, 110, 120, …), and not number them one right after the other (for example, 101, 102, 103, …). This makes it easier to add a rule between existing ones without having to renumber the rules.

    After you add an entry, you can’t modify it; you must either replace it, or create an entry and delete the old one.

    For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNetworkAclEntryRequest

    Declaration

    Objective-C

    - (id)createNetworkAclEntry:
        (nonnull AWSEC2CreateNetworkAclEntryRequest *)request;

    Swift

    func createNetworkAclEntry(_ request: AWSEC2CreateNetworkAclEntryRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkAclEntry service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will be nil.

  • Creates an entry (a rule) in a network ACL with the specified rule number. Each network ACL has a set of numbered ingress rules and a separate set of numbered egress rules. When determining whether a packet should be allowed in or out of a subnet associated with the ACL, we process the entries in the ACL according to the rule numbers, in ascending order. Each network ACL has a set of ingress rules and a separate set of egress rules.

    We recommend that you leave room between the rule numbers (for example, 100, 110, 120, …), and not number them one right after the other (for example, 101, 102, 103, …). This makes it easier to add a rule between existing ones without having to renumber the rules.

    After you add an entry, you can’t modify it; you must either replace it, or create an entry and delete the old one.

    For more information about network ACLs, see Network ACLs in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNetworkAclEntryRequest

    Declaration

    Objective-C

    - (void)createNetworkAclEntry:
                (nonnull AWSEC2CreateNetworkAclEntryRequest *)request
                completionHandler:
                    (void (^_Nullable)(NSError *_Nullable))completionHandler;

    Swift

    func createNetworkAclEntry(_ request: AWSEC2CreateNetworkAclEntryRequest, completionHandler: ((Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkAclEntry service method.

    completionHandler

    The completion handler to call when the load request is complete. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a network interface in the specified subnet.

    For more information about network interfaces, see Elastic Network Interfaces in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNetworkInterfaceRequest

    See

    AWSEC2CreateNetworkInterfaceResult

    Declaration

    Objective-C

    - (id)createNetworkInterface:
        (nonnull AWSEC2CreateNetworkInterfaceRequest *)request;

    Swift

    func createNetworkInterface(_ request: AWSEC2CreateNetworkInterfaceRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkInterface service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateNetworkInterfaceResult.

  • Creates a network interface in the specified subnet.

    For more information about network interfaces, see Elastic Network Interfaces in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateNetworkInterfaceRequest

    See

    AWSEC2CreateNetworkInterfaceResult

    Declaration

    Objective-C

    - (void)
        createNetworkInterface:
            (nonnull AWSEC2CreateNetworkInterfaceRequest *)request
             completionHandler:
                 (void (^_Nullable)(AWSEC2CreateNetworkInterfaceResult *_Nullable,
                                    NSError *_Nullable))completionHandler;

    Swift

    func createNetworkInterface(_ request: AWSEC2CreateNetworkInterfaceRequest, completionHandler: ((AWSEC2CreateNetworkInterfaceResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkInterface service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Grants an AWS-authorized account permission to attach the specified network interface to an instance in their account.

    You can grant permission to a single AWS account only, and only one account at a time.

    See

    AWSEC2CreateNetworkInterfacePermissionRequest

    See

    AWSEC2CreateNetworkInterfacePermissionResult

    Declaration

    Objective-C

    - (id)createNetworkInterfacePermission:
        (nonnull AWSEC2CreateNetworkInterfacePermissionRequest *)request;

    Swift

    func createNetworkInterfacePermission(_ request: AWSEC2CreateNetworkInterfacePermissionRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkInterfacePermission service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateNetworkInterfacePermissionResult.

  • Grants an AWS-authorized account permission to attach the specified network interface to an instance in their account.

    You can grant permission to a single AWS account only, and only one account at a time.

    See

    AWSEC2CreateNetworkInterfacePermissionRequest

    See

    AWSEC2CreateNetworkInterfacePermissionResult

    Declaration

    Objective-C

    - (void)createNetworkInterfacePermission:
                (nonnull AWSEC2CreateNetworkInterfacePermissionRequest *)request
                           completionHandler:
                               (void (^_Nullable)(
                                   AWSEC2CreateNetworkInterfacePermissionResult
                                       *_Nullable,
                                   NSError *_Nullable))completionHandler;

    Swift

    func createNetworkInterfacePermission(_ request: AWSEC2CreateNetworkInterfacePermissionRequest, completionHandler: ((AWSEC2CreateNetworkInterfacePermissionResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateNetworkInterfacePermission service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a placement group in which to launch instances. The strategy of the placement group determines how the instances are organized within the group.

    A cluster placement group is a logical grouping of instances within a single Availability Zone that benefit from low network latency, high network throughput. A spread placement group places instances on distinct hardware. A partition placement group places groups of instances in different partitions, where instances in one partition do not share the same hardware with instances in another partition.

    For more information, see Placement groups in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreatePlacementGroupRequest

    See

    AWSEC2CreatePlacementGroupResult

    Declaration

    Objective-C

    - (id)createPlacementGroup:(nonnull AWSEC2CreatePlacementGroupRequest *)request;

    Swift

    func createPlacementGroup(_ request: AWSEC2CreatePlacementGroupRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreatePlacementGroup service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreatePlacementGroupResult.

  • Creates a placement group in which to launch instances. The strategy of the placement group determines how the instances are organized within the group.

    A cluster placement group is a logical grouping of instances within a single Availability Zone that benefit from low network latency, high network throughput. A spread placement group places instances on distinct hardware. A partition placement group places groups of instances in different partitions, where instances in one partition do not share the same hardware with instances in another partition.

    For more information, see Placement groups in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreatePlacementGroupRequest

    See

    AWSEC2CreatePlacementGroupResult

    Declaration

    Objective-C

    - (void)createPlacementGroup:
                (nonnull AWSEC2CreatePlacementGroupRequest *)request
               completionHandler:
                   (void (^_Nullable)(AWSEC2CreatePlacementGroupResult *_Nullable,
                                      NSError *_Nullable))completionHandler;

    Swift

    func createPlacementGroup(_ request: AWSEC2CreatePlacementGroupRequest, completionHandler: ((AWSEC2CreatePlacementGroupResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreatePlacementGroup service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your Standard Reserved Instances, you can use the DescribeReservedInstances operation.

    Only Standard Reserved Instances can be sold in the Reserved Instance Marketplace. Convertible Reserved Instances cannot be sold.

    The Reserved Instance Marketplace matches sellers who want to resell Standard Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

    To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price to receive for them. Your Standard Reserved Instance listings then become available for purchase. To view the details of your Standard Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

    For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateReservedInstancesListingRequest

    See

    AWSEC2CreateReservedInstancesListingResult

    Declaration

    Objective-C

    - (id)createReservedInstancesListing:
        (nonnull AWSEC2CreateReservedInstancesListingRequest *)request;

    Swift

    func createReservedInstancesListing(_ request: AWSEC2CreateReservedInstancesListingRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateReservedInstancesListing service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateReservedInstancesListingResult.

  • Creates a listing for Amazon EC2 Standard Reserved Instances to be sold in the Reserved Instance Marketplace. You can submit one Standard Reserved Instance listing at a time. To get a list of your Standard Reserved Instances, you can use the DescribeReservedInstances operation.

    Only Standard Reserved Instances can be sold in the Reserved Instance Marketplace. Convertible Reserved Instances cannot be sold.

    The Reserved Instance Marketplace matches sellers who want to resell Standard Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances.

    To sell your Standard Reserved Instances, you must first register as a seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Standard Reserved Instances, and specify the upfront price to receive for them. Your Standard Reserved Instance listings then become available for purchase. To view the details of your Standard Reserved Instance listing, you can use the DescribeReservedInstancesListings operation.

    For more information, see Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateReservedInstancesListingRequest

    See

    AWSEC2CreateReservedInstancesListingResult

    Declaration

    Objective-C

    - (void)
        createReservedInstancesListing:
            (nonnull AWSEC2CreateReservedInstancesListingRequest *)request
                     completionHandler:
                         (void (^_Nullable)(
                             AWSEC2CreateReservedInstancesListingResult *_Nullable,
                             NSError *_Nullable))completionHandler;

    Swift

    func createReservedInstancesListing(_ request: AWSEC2CreateReservedInstancesListingRequest, completionHandler: ((AWSEC2CreateReservedInstancesListingResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateReservedInstancesListing service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a route in a route table within a VPC.

    You must specify one of the following targets: internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, egress-only internet gateway, or transit gateway.

    When determining how to route traffic, we use the route with the most specific match. For example, traffic is destined for the IPv4 address 192.0.2.3, and the route table includes the following two IPv4 routes:

    • 192.0.2.0/24 (goes to some target A)

    • 192.0.2.0/28 (goes to some target B)

    Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

    For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateRouteRequest

    See

    AWSEC2CreateRouteResult

    Declaration

    Objective-C

    - (id)createRoute:(nonnull AWSEC2CreateRouteRequest *)request;

    Swift

    func createRoute(_ request: AWSEC2CreateRouteRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateRoute service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateRouteResult.

  • Creates a route in a route table within a VPC.

    You must specify one of the following targets: internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, egress-only internet gateway, or transit gateway.

    When determining how to route traffic, we use the route with the most specific match. For example, traffic is destined for the IPv4 address 192.0.2.3, and the route table includes the following two IPv4 routes:

    • 192.0.2.0/24 (goes to some target A)

    • 192.0.2.0/28 (goes to some target B)

    Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

    For more information about route tables, see Route Tables in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateRouteRequest

    See

    AWSEC2CreateRouteResult

    Declaration

    Objective-C

    - (void)createRoute:(nonnull AWSEC2CreateRouteRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2CreateRouteResult *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func createRoute(_ request: AWSEC2CreateRouteRequest, completionHandler: ((AWSEC2CreateRouteResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateRoute service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

    For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateRouteTableRequest

    See

    AWSEC2CreateRouteTableResult

    Declaration

    Objective-C

    - (id)createRouteTable:(nonnull AWSEC2CreateRouteTableRequest *)request;

    Swift

    func createRouteTable(_ request: AWSEC2CreateRouteTableRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateRouteTable service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateRouteTableResult.

  • Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

    For more information, see Route Tables in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateRouteTableRequest

    See

    AWSEC2CreateRouteTableResult

    Declaration

    Objective-C

    - (void)createRouteTable:(nonnull AWSEC2CreateRouteTableRequest *)request
           completionHandler:
               (void (^_Nullable)(AWSEC2CreateRouteTableResult *_Nullable,
                                  NSError *_Nullable))completionHandler;

    Swift

    func createRouteTable(_ request: AWSEC2CreateRouteTableRequest, completionHandler: ((AWSEC2CreateRouteTableResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateRouteTable service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a security group.

    A security group acts as a virtual firewall for your instance to control inbound and outbound traffic. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

    When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can’t have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

    You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don’t specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

    You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

    For more information about VPC security group limits, see Amazon VPC Limits.

    See

    AWSEC2CreateSecurityGroupRequest

    See

    AWSEC2CreateSecurityGroupResult

    Declaration

    Objective-C

    - (id)createSecurityGroup:(nonnull AWSEC2CreateSecurityGroupRequest *)request;

    Swift

    func createSecurityGroup(_ request: AWSEC2CreateSecurityGroupRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateSecurityGroup service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateSecurityGroupResult.

  • Creates a security group.

    A security group acts as a virtual firewall for your instance to control inbound and outbound traffic. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

    When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can’t have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

    You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don’t specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

    You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

    For more information about VPC security group limits, see Amazon VPC Limits.

    See

    AWSEC2CreateSecurityGroupRequest

    See

    AWSEC2CreateSecurityGroupResult

    Declaration

    Objective-C

    - (void)createSecurityGroup:(nonnull AWSEC2CreateSecurityGroupRequest *)request
              completionHandler:
                  (void (^_Nullable)(AWSEC2CreateSecurityGroupResult *_Nullable,
                                     NSError *_Nullable))completionHandler;

    Swift

    func createSecurityGroup(_ request: AWSEC2CreateSecurityGroupRequest, completionHandler: ((AWSEC2CreateSecurityGroupResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateSecurityGroup service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

    When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

    You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

    To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

    Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

    You can tag your snapshots during creation. For more information, see Tagging your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.

    For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateSnapshotRequest

    See

    AWSEC2Snapshot

    Declaration

    Objective-C

    - (id)createSnapshot:(nonnull AWSEC2CreateSnapshotRequest *)request;

    Swift

    func createSnapshot(_ request: AWSEC2CreateSnapshotRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateSnapshot service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2Snapshot.

  • Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

    When a snapshot is created, any AWS Marketplace product codes that are associated with the source volume are propagated to the snapshot.

    You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your EBS volume at the time the snapshot command is issued; this may exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

    To create a snapshot for EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

    Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

    You can tag your snapshots during creation. For more information, see Tagging your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.

    For more information, see Amazon Elastic Block Store and Amazon EBS Encryption in the Amazon Elastic Compute Cloud User Guide.

    See

    AWSEC2CreateSnapshotRequest

    See

    AWSEC2Snapshot

    Declaration

    Objective-C

    - (void)createSnapshot:(nonnull AWSEC2CreateSnapshotRequest *)request
         completionHandler:(void (^_Nullable)(AWSEC2Snapshot *_Nullable,
                                              NSError *_Nullable))completionHandler;

    Swift

    func createSnapshot(_ request: AWSEC2CreateSnapshotRequest, completionHandler: ((AWSEC2Snapshot?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateSnapshot service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot each that is crash-consistent across the instance. Boot volumes can be excluded by changing the parameters.

    See

    AWSEC2CreateSnapshotsRequest

    See

    AWSEC2CreateSnapshotsResult

    Declaration

    Objective-C

    - (id)createSnapshots:(nonnull AWSEC2CreateSnapshotsRequest *)request;

    Swift

    func createSnapshots(_ request: AWSEC2CreateSnapshotsRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateSnapshots service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateSnapshotsResult.

  • Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot each that is crash-consistent across the instance. Boot volumes can be excluded by changing the parameters.

    See

    AWSEC2CreateSnapshotsRequest

    See

    AWSEC2CreateSnapshotsResult

    Declaration

    Objective-C

    - (void)createSnapshots:(nonnull AWSEC2CreateSnapshotsRequest *)request
          completionHandler:
              (void (^_Nullable)(AWSEC2CreateSnapshotsResult *_Nullable,
                                 NSError *_Nullable))completionHandler;

    Swift

    func createSnapshots(_ request: AWSEC2CreateSnapshotsRequest, completionHandler: ((AWSEC2CreateSnapshotsResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateSnapshots service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.

    See

    AWSEC2CreateSpotDatafeedSubscriptionRequest

    See

    AWSEC2CreateSpotDatafeedSubscriptionResult

    Declaration

    Objective-C

    - (id)createSpotDatafeedSubscription:
        (nonnull AWSEC2CreateSpotDatafeedSubscriptionRequest *)request;

    Swift

    func createSpotDatafeedSubscription(_ request: AWSEC2CreateSpotDatafeedSubscriptionRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateSpotDatafeedSubscription service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateSpotDatafeedSubscriptionResult.

  • Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per AWS account. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.

    See

    AWSEC2CreateSpotDatafeedSubscriptionRequest

    See

    AWSEC2CreateSpotDatafeedSubscriptionResult

    Declaration

    Objective-C

    - (void)
        createSpotDatafeedSubscription:
            (nonnull AWSEC2CreateSpotDatafeedSubscriptionRequest *)request
                     completionHandler:
                         (void (^_Nullable)(
                             AWSEC2CreateSpotDatafeedSubscriptionResult *_Nullable,
                             NSError *_Nullable))completionHandler;

    Swift

    func createSpotDatafeedSubscription(_ request: AWSEC2CreateSpotDatafeedSubscriptionRequest, completionHandler: ((AWSEC2CreateSpotDatafeedSubscriptionResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateSpotDatafeedSubscription service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.

  • Creates a subnet in a specified VPC.

    You must specify an IPv4 CIDR block for the subnet. After you create a subnet, you can’t change its CIDR block. The allowed block size is between a /16 netmask (65,536 IP addresses) and /28 netmask (16 IP addresses). The CIDR block must not overlap with the CIDR block of an existing subnet in the VPC.

    If you’ve associated an IPv6 CIDR block with your VPC, you can create a subnet with an IPv6 CIDR block that uses a /64 prefix length.

    AWS reserves both the first four and the last IPv4 address in each subnet’s CIDR block. They’re not available for use.

    If you add more than one subnet to a VPC, they’re set up in a star topology with a logical router in the middle.

    When you stop an instance in a subnet, it retains its private IPv4 address. It’s therefore possible to have a subnet with no running instances (they’re all stopped), but no remaining IP addresses available.

    For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateSubnetRequest

    See

    AWSEC2CreateSubnetResult

    Declaration

    Objective-C

    - (id)createSubnet:(nonnull AWSEC2CreateSubnetRequest *)request;

    Swift

    func createSubnet(_ request: AWSEC2CreateSubnetRequest) -> Any!

    Parameters

    request

    A container for the necessary parameters to execute the CreateSubnet service method.

    Return Value

    An instance of AWSTask. On successful execution, task.result will contain an instance of AWSEC2CreateSubnetResult.

  • Creates a subnet in a specified VPC.

    You must specify an IPv4 CIDR block for the subnet. After you create a subnet, you can’t change its CIDR block. The allowed block size is between a /16 netmask (65,536 IP addresses) and /28 netmask (16 IP addresses). The CIDR block must not overlap with the CIDR block of an existing subnet in the VPC.

    If you’ve associated an IPv6 CIDR block with your VPC, you can create a subnet with an IPv6 CIDR block that uses a /64 prefix length.

    AWS reserves both the first four and the last IPv4 address in each subnet’s CIDR block. They’re not available for use.

    If you add more than one subnet to a VPC, they’re set up in a star topology with a logical router in the middle.

    When you stop an instance in a subnet, it retains its private IPv4 address. It’s therefore possible to have a subnet with no running instances (they’re all stopped), but no remaining IP addresses available.

    For more information about subnets, see Your VPC and Subnets in the Amazon Virtual Private Cloud User Guide.

    See

    AWSEC2CreateSubnetRequest

    See

    AWSEC2CreateSubnetResult

    Declaration

    Objective-C

    - (void)createSubnet:(nonnull AWSEC2CreateSubnetRequest *)request
        completionHandler:(void (^_Nullable)(AWSEC2CreateSubnetResult *_Nullable,
                                             NSError *_Nullable))completionHandler;

    Swift

    func createSubnet(_ request: AWSEC2CreateSubnetRequest, completionHandler: ((AWSEC2CreateSubnetResult?, Error?) -> Void)? = nil)

    Parameters

    request

    A container for the necessary parameters to execute the CreateSubnet service method.

    completionHandler

    The completion handler to call when the load request is complete. response - A response object, or nil if the request failed. error - An error object that indicates why the request failed, or nil if the request was successful.