/* * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ /* * Do not modify this file. This file is generated from the ec2-2016-11-15.normal.json service model. */ using System; using System.Collections.Generic; using System.Xml.Serialization; using System.Text; using System.IO; using System.Net; using Amazon.Runtime; using Amazon.Runtime.Internal; namespace Amazon.EC2.Model { /// /// Container for the parameters to the RegisterImage operation. /// Registers an AMI. When you're creating an AMI, this is the final step you must complete /// before you can launch an instance from the AMI. For more information about creating /// AMIs, see Create /// your own AMI in the Amazon Elastic Compute Cloud User Guide. /// /// /// /// For Amazon EBS-backed instances, CreateImage creates and registers the AMI /// in a single request, so you don't have to register the AMI yourself. We recommend /// that you always use CreateImage unless you have a specific reason to use RegisterImage. /// /// /// /// If needed, you can deregister an AMI at any time. Any modifications you make to an /// AMI backed by an instance store volume invalidates its registration. If you make changes /// to an image, deregister the previous image and register the new image. /// /// /// /// Register a snapshot of a root device volume /// /// /// /// You can use RegisterImage to create an Amazon EBS-backed Linux AMI from /// a snapshot of a root device volume. You specify the snapshot using a block device /// mapping. You can't set the encryption state of the volume using the block device mapping. /// If the snapshot is encrypted, or encryption by default is enabled, the root volume /// of an instance launched from the AMI is encrypted. /// /// /// /// For more information, see Create /// a Linux AMI from a snapshot and Use /// encryption with Amazon EBS-backed AMIs in the Amazon Elastic Compute Cloud /// User Guide. /// /// /// /// Amazon Web Services Marketplace product codes /// /// /// /// If any snapshots have Amazon Web Services Marketplace product codes, they are copied /// to the new AMI. /// /// /// /// Windows and some Linux distributions, such as Red Hat Enterprise Linux (RHEL) and /// SUSE Linux Enterprise Server (SLES), use the Amazon EC2 billing product code associated /// with an AMI to verify the subscription status for package updates. To create a new /// AMI for operating systems that require a billing product code, instead of registering /// the AMI, do the following to preserve the billing product code association: /// ///
  1. /// /// Launch an instance from an existing AMI with that billing product code. /// ///
  2. /// /// Customize the instance. /// ///
  3. /// /// Create an AMI from the instance using CreateImage. /// ///
/// /// If you purchase a Reserved Instance to apply to an On-Demand Instance that was launched /// from an AMI with a billing product code, make sure that the Reserved Instance has /// the matching billing product code. If you purchase a Reserved Instance without the /// matching billing product code, the Reserved Instance will not be applied to the On-Demand /// Instance. For information about how to obtain the platform details and billing information /// of an AMI, see Understand /// AMI billing information in the Amazon EC2 User Guide. /// ///
public partial class RegisterImageRequest : AmazonEC2Request { private ArchitectureValues _architecture; private List _billingProducts = new List(); private List _blockDeviceMappings = new List(); private BootModeValues _bootMode; private string _description; private bool? _enaSupport; private string _imageLocation; private ImdsSupportValues _imdsSupport; private string _kernelId; private string _name; private string _ramdiskId; private string _rootDeviceName; private string _sriovNetSupport; private TpmSupportValues _tpmSupport; private string _uefiData; private string _virtualizationType; /// /// Empty constructor used to set properties independently even when a simple constructor is available /// public RegisterImageRequest() { } /// /// Instantiates RegisterImageRequest with the parameterized properties /// /// The full path to your AMI manifest in Amazon S3 storage. The specified bucket must have the aws-exec-read canned access control list (ACL) to ensure that it can be accessed by Amazon EC2. For more information, see Canned ACLs in the Amazon S3 Service Developer Guide. public RegisterImageRequest(string imageLocation) { _imageLocation = imageLocation; } /// /// Gets and sets the property Architecture. /// /// The architecture of the AMI. /// /// /// /// Default: For Amazon EBS-backed AMIs, i386. For instance store-backed /// AMIs, the architecture specified in the manifest file. /// /// public ArchitectureValues Architecture { get { return this._architecture; } set { this._architecture = value; } } // Check to see if Architecture property is set internal bool IsSetArchitecture() { return this._architecture != null; } /// /// Gets and sets the property BillingProducts. /// /// The billing product codes. Your account must be authorized to specify billing product /// codes. /// /// /// /// If your account is not authorized to specify billing product codes, you can publish /// AMIs that include billable software and list them on the Amazon Web Services Marketplace. /// You must first register as a seller on the Amazon Web Services Marketplace. For more /// information, see Getting /// started as a seller and AMI-based /// products in the Amazon Web Services Marketplace Seller Guide. /// /// public List BillingProducts { get { return this._billingProducts; } set { this._billingProducts = value; } } // Check to see if BillingProducts property is set internal bool IsSetBillingProducts() { return this._billingProducts != null && this._billingProducts.Count > 0; } /// /// Gets and sets the property BlockDeviceMappings. /// /// The block device mapping entries. /// /// /// /// If you specify an Amazon EBS volume using the ID of an Amazon EBS snapshot, you can't /// specify the encryption state of the volume. /// /// /// /// If you create an AMI on an Outpost, then all backing snapshots must be on the same /// Outpost or in the Region of that Outpost. AMIs on an Outpost that include local snapshots /// can be used to launch instances on the same Outpost only. For more information, Amazon /// EBS local snapshots on Outposts in the Amazon EC2 User Guide. /// /// public List BlockDeviceMappings { get { return this._blockDeviceMappings; } set { this._blockDeviceMappings = value; } } // Check to see if BlockDeviceMappings property is set internal bool IsSetBlockDeviceMappings() { return this._blockDeviceMappings != null && this._blockDeviceMappings.Count > 0; } /// /// Gets and sets the property BootMode. /// /// The boot mode of the AMI. A value of uefi-preferred indicates that the /// AMI supports both UEFI and Legacy BIOS. /// /// /// /// The operating system contained in the AMI must be configured to support the specified /// boot mode. /// /// /// /// For more information, see Boot /// modes in the Amazon EC2 User Guide. /// /// public BootModeValues BootMode { get { return this._bootMode; } set { this._bootMode = value; } } // Check to see if BootMode property is set internal bool IsSetBootMode() { return this._bootMode != null; } /// /// Gets and sets the property Description. /// /// A description for your AMI. /// /// public string Description { get { return this._description; } set { this._description = value; } } // Check to see if Description property is set internal bool IsSetDescription() { return this._description != null; } /// /// Gets and sets the property EnaSupport. /// /// Set to true to enable enhanced networking with ENA for the AMI and any /// instances that you launch from the AMI. /// /// /// /// This option is supported only for HVM AMIs. Specifying this option with a PV AMI can /// make instances launched from the AMI unreachable. /// /// public bool EnaSupport { get { return this._enaSupport.GetValueOrDefault(); } set { this._enaSupport = value; } } // Check to see if EnaSupport property is set internal bool IsSetEnaSupport() { return this._enaSupport.HasValue; } /// /// Gets and sets the property ImageLocation. /// /// The full path to your AMI manifest in Amazon S3 storage. The specified bucket must /// have the aws-exec-read canned access control list (ACL) to ensure that /// it can be accessed by Amazon EC2. For more information, see Canned /// ACLs in the Amazon S3 Service Developer Guide. /// /// public string ImageLocation { get { return this._imageLocation; } set { this._imageLocation = value; } } // Check to see if ImageLocation property is set internal bool IsSetImageLocation() { return this._imageLocation != null; } /// /// Gets and sets the property ImdsSupport. /// /// Set to v2.0 to indicate that IMDSv2 is specified in the AMI. Instances /// launched from this AMI will have HttpTokens automatically set to required /// so that, by default, the instance requires that IMDSv2 is used when requesting instance /// metadata. In addition, HttpPutResponseHopLimit is set to 2. /// For more information, see Configure /// the AMI in the Amazon EC2 User Guide. /// /// /// /// If you set the value to v2.0, make sure that your AMI software can support /// IMDSv2. /// /// /// public ImdsSupportValues ImdsSupport { get { return this._imdsSupport; } set { this._imdsSupport = value; } } // Check to see if ImdsSupport property is set internal bool IsSetImdsSupport() { return this._imdsSupport != null; } /// /// Gets and sets the property KernelId. /// /// The ID of the kernel. /// /// public string KernelId { get { return this._kernelId; } set { this._kernelId = value; } } // Check to see if KernelId property is set internal bool IsSetKernelId() { return this._kernelId != null; } /// /// Gets and sets the property Name. /// /// A name for your AMI. /// /// /// /// Constraints: 3-128 alphanumeric characters, parentheses (()), square brackets ([]), /// spaces ( ), periods (.), slashes (/), dashes (-), single quotes ('), at-signs (@), /// or underscores(_) /// /// [AWSProperty(Required=true)] public string Name { get { return this._name; } set { this._name = value; } } // Check to see if Name property is set internal bool IsSetName() { return this._name != null; } /// /// Gets and sets the property RamdiskId. /// /// The ID of the RAM disk. /// /// public string RamdiskId { get { return this._ramdiskId; } set { this._ramdiskId = value; } } // Check to see if RamdiskId property is set internal bool IsSetRamdiskId() { return this._ramdiskId != null; } /// /// Gets and sets the property RootDeviceName. /// /// The device name of the root device volume (for example, /dev/sda1). /// /// public string RootDeviceName { get { return this._rootDeviceName; } set { this._rootDeviceName = value; } } // Check to see if RootDeviceName property is set internal bool IsSetRootDeviceName() { return this._rootDeviceName != null; } /// /// Gets and sets the property SriovNetSupport. /// /// Set to simple to enable enhanced networking with the Intel 82599 Virtual /// Function interface for the AMI and any instances that you launch from the AMI. /// /// /// /// There is no way to disable sriovNetSupport at this time. /// /// /// /// This option is supported only for HVM AMIs. Specifying this option with a PV AMI can /// make instances launched from the AMI unreachable. /// /// public string SriovNetSupport { get { return this._sriovNetSupport; } set { this._sriovNetSupport = value; } } // Check to see if SriovNetSupport property is set internal bool IsSetSriovNetSupport() { return this._sriovNetSupport != null; } /// /// Gets and sets the property TpmSupport. /// /// Set to v2.0 to enable Trusted Platform Module (TPM) support. For more /// information, see NitroTPM /// in the Amazon EC2 User Guide. /// /// public TpmSupportValues TpmSupport { get { return this._tpmSupport; } set { this._tpmSupport = value; } } // Check to see if TpmSupport property is set internal bool IsSetTpmSupport() { return this._tpmSupport != null; } /// /// Gets and sets the property UefiData. /// /// Base64 representation of the non-volatile UEFI variable store. To retrieve the UEFI /// data, use the GetInstanceUefiData /// command. You can inspect and modify the UEFI data by using the python-uefivars /// tool on GitHub. For more information, see UEFI /// Secure Boot in the Amazon EC2 User Guide. /// /// [AWSProperty(Min=0, Max=64000)] public string UefiData { get { return this._uefiData; } set { this._uefiData = value; } } // Check to see if UefiData property is set internal bool IsSetUefiData() { return this._uefiData != null; } /// /// Gets and sets the property VirtualizationType. /// /// The type of virtualization (hvm | paravirtual). /// /// /// /// Default: paravirtual /// /// public string VirtualizationType { get { return this._virtualizationType; } set { this._virtualizationType = value; } } // Check to see if VirtualizationType property is set internal bool IsSetVirtualizationType() { return this._virtualizationType != null; } } }