computing / Client / import_instance

import_instance

computing.Client.import_instance(**kwargs)

指定したOVFファイルの情報に基づいて、サーバーインポートを予約します。

1回のリクエストで1台のサーバーが予約可能です。

イメージ（VMDKファイル）は、別途アップロード領域へアップロードしてください（このAPIのレスポンスに含まれるタスクIDを指定します）。

サーバーの作成には、時間がかかることがあります。

API「DescribeInstances」のレスポンス値「instanceState」でサーバーのステータスを確認できます。

インポートしたサーバーは通常ほかのサーバー作成と同様に課金されますが、ニフクラの基本ディスク容量（Linux:30GB、Windows:80GB）を超えるディスクを持つ場合は100GB単位で追加料金が発生します。

インポートしたサーバーは、APIからの削除が可能です。

APIからの削除を禁止したい場合は、インポート完了後にAPI「ModifyInstanceAttribute」を実行してください。

See also: NIFCLOUD API Documentation

Request Syntax

response = client.import_instance(
    AccountingType='1'|'2',
    Architecture='string',
    Description='string',
    DiskImage=[
        {
            'Description': 'string',
            'RequestImage': {
                'Bytes': 123,
                'Format': 'string',
                'ImportManifestUrl': 'string'
            },
            'RequestVolume': {
                'Size': 123
            }
        },
    ],
    InstanceId='string',
    InstanceInitiatedShutdownBehavior='string',
    InstanceType='e2-mini'|'e-mini'|'h2-mini'|'mini'|'c2-small'|'c2r-small'|'c-small'|'e2-small'|'e2r-small'|'e-small'|'h2-small'|'h2r-small'|'small'|'c2-small2'|'c2r-small2'|'c-small2'|'e2-small2'|'e2r-small2'|'e-small2'|'h2-small2'|'h2r-small2'|'small2'|'c2-small4'|'c-small4'|'e2-small4'|'e-small4'|'h2-small4'|'h2r-small4'|'small4'|'e2-small8'|'e-small8'|'h2-small8'|'small8'|'e2-small16'|'e-small16'|'h2-small16'|'small16'|'c2-medium'|'c2r-medium'|'c-medium'|'e2-medium'|'e2r-medium'|'e-medium'|'h2-medium'|'h2r-medium'|'medium'|'c2-medium4'|'c2r-medium4'|'c-medium4'|'e2-medium4'|'e2r-medium4'|'e-medium4'|'h2-medium4'|'h2r-medium4'|'medium4'|'c2-medium8'|'c-medium8'|'e2-medium8'|'e-medium8'|'h2-medium8'|'h2r-medium8'|'medium8'|'e2-medium16'|'e-medium16'|'h2-medium16'|'medium16'|'e2-medium24'|'e-medium24'|'h2-medium24'|'medium24'|'c2-large'|'c2r-large'|'c-large'|'e2-large'|'e2r-large'|'e-large'|'h2-large'|'h2r-large'|'large'|'c2-large8'|'c-large8'|'e2-large8'|'e2r-large8'|'e-large8'|'h2-large8'|'h2r-large8'|'large8'|'e2-large16'|'e-large16'|'h2-large16'|'h2r-large16'|'large16'|'e2-large24'|'e-large24'|'h2-large24'|'large24'|'e2-large32'|'e-large32'|'h2-large32'|'large32'|'e2-extra-large8'|'e2r-extra-large8'|'e-extra-large8'|'h2-extra-large8'|'h2r-extra-large8'|'extra-large8'|'e2-extra-large16'|'e-extra-large16'|'h2-extra-large16'|'h2r-extra-large16'|'extra-large16'|'e2-extra-large24'|'e-extra-large24'|'h2-extra-large24'|'h2r-extra-large24'|'extra-large24'|'e2-extra-large32'|'e-extra-large32'|'h2-extra-large32'|'extra-large32'|'e2-extra-large48'|'e-extra-large48'|'h2-extra-large48'|'extra-large48'|'e2-double-large16'|'e2r-double-large16'|'e-double-large16'|'h2-double-large16'|'h2r-double-large16'|'double-large16'|'e2-double-large24'|'e-double-large24'|'h2-double-large24'|'h2r-double-large24'|'double-large24'|'e2-double-large32'|'e-double-large32'|'h2-double-large32'|'h2r-double-large32'|'double-large32'|'e2-double-large48'|'e-double-large48'|'h2-double-large48'|'double-large48'|'e2-double-large64'|'e-double-large64'|'h2-double-large64'|'double-large64'|'e2-double-large96'|'e-double-large96'|'h2-double-large96'|'double-large96'|'h2-triple-large32'|'h2r-triple-large32'|'triple-large32'|'h2-triple-large48'|'h2r-triple-large48'|'triple-large48'|'h2-triple-large64'|'triple-large64'|'h2-triple-large96'|'triple-large96'|'h2-triple-large128'|'triple-large128'|'h2-quad-large64'|'h2r-quad-large64'|'quad-large64'|'h2-quad-large96'|'quad-large96'|'h2-quad-large128'|'quad-large128'|'h2-quad-large256'|'quad-large256'|'h2-septa-large128'|'septa-large128'|'h2-septa-large256'|'septa-large256'|'h2-octa-large256'|'octa-large256'|'h2-octa-large384'|'octa-large384'|'h2-octa-large512'|'octa-large512',
    IpType='static'|'elastic'|'none',
    Monitoring={
        'Enabled': 'string'
    },
    NetworkInterface=[
        {
            'DeviceIndex': 123,
            'IpAddress': 'string',
            'ListOfRequestSecurityGroupId': [
                'string',
            ],
            'NetworkId': 'string',
            'NetworkName': 'string'
        },
    ],
    Ovf='string',
    Placement={
        'AvailabilityZone': 'string'
    },
    Platform='string',
    PrivateIpAddress='string',
    PublicIp='string',
    SecurityGroup=[
        'string',
    ],
    SubnetId='string',
    UserData={
        'Content': 'string'
    }
)

Parameters:

• AccountingType (string) –

• Architecture (string) –

• Description (string) –

• DiskImage (list) –

  • (dict) –

    • Description (string) –

    • RequestImage (dict) –

      • Bytes (integer) –

      • Format (string) –

      • ImportManifestUrl (string) –

    • RequestVolume (dict) –

      • Size (integer) –

• InstanceId (string) –

• InstanceInitiatedShutdownBehavior (string) –

• InstanceType (string) –

• IpType (string) –

• Monitoring (dict) –

  • Enabled (string) –

• NetworkInterface (list) –

  • (dict) –

    • DeviceIndex (integer) –

    • IpAddress (string) –

    • ListOfRequestSecurityGroupId (list) –

      • (string) –

    • NetworkId (string) –

    • NetworkName (string) –

• Ovf (string) – [REQUIRED]

• Placement (dict) –

  • AvailabilityZone (string) –

• Platform (string) –

• PrivateIpAddress (string) –

• PublicIp (string) –

• SecurityGroup (list) –

  • (string) –

• SubnetId (string) –

• UserData (dict) –

  • Content (string) –

Return type:

dict

Returns:

Response Syntax

{
    'ConversionTask': {
        'ConversionTaskId': 'string',
        'ExpirationTime': 'string',
        'ImportInstance': {
            'Description': 'string',
            'InstanceId': 'string',
            'InstanceUniqueId': 'string',
            'Volumes': [
                {
                    'AvailabilityZone': 'string',
                    'BytesConverted': 123,
                    'Image': {
                        'Format': 'string',
                        'Size': 123
                    },
                    'Status': 'string'
                },
            ]
        },
        'NetworkInterfaceSet': [
            {
                'Association': {
                    'IpOwnerId': 'string',
                    'PublicDnsName': 'string'
                },
                'Attachment': {
                    'AttachTime': 'string',
                    'AttachmentID': 'string',
                    'DeleteOnTermination': 'string',
                    'DeviceIndex': 'string',
                    'Status': 'string'
                },
                'Description': 'string',
                'GroupSet': 'string',
                'NetworkInterfaceId': 'string',
                'NiftyNetworkId': 'string',
                'NiftyNetworkName': 'string',
                'OwnerId': 'string',
                'PrivateDnsName': 'string',
                'PrivateIpAddressesSet': 'string',
                'SourceDestCheck': 'string',
                'Status': 'string',
                'SubnetId': 'string',
                'VpcId': 'string'
            },
        ],
        'State': 'string'
    }
}

Response Structure

• (dict) –

  • ConversionTask (dict) –

    • ConversionTaskId (string) –

    • ExpirationTime (string) –

    • ImportInstance (dict) –

      • Description (string) –

      • InstanceId (string) –

      • InstanceUniqueId (string) –

      • Volumes (list) –

        • (dict) –

          • AvailabilityZone (string) –

          • BytesConverted (integer) –

          • Image (dict) –

            • Format (string) –

            • Size (integer) –

          • Status (string) –

    • NetworkInterfaceSet (list) –

      • (dict) –

        • Association (dict) –

          • IpOwnerId (string) –

          • PublicDnsName (string) –

        • Attachment (dict) –

          • AttachTime (string) –

          • AttachmentID (string) –

          • DeleteOnTermination (string) –

          • DeviceIndex (string) –

          • Status (string) –

        • Description (string) –

        • GroupSet (string) –

        • NetworkInterfaceId (string) –

        • NiftyNetworkId (string) –

        • NiftyNetworkName (string) –

        • OwnerId (string) –

        • PrivateDnsName (string) –

        • PrivateIpAddressesSet (string) –

        • SourceDestCheck (string) –

        • Status (string) –

        • SubnetId (string) –

        • VpcId (string) –

    • State (string) –