を使用した Amazon EC2の例 AWS CLI - AWS Command Line Interface
アクション

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した Amazon EC2の例 AWS CLI

次のコード例は、Amazon AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示していますEC2。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。このリンクには、コンテキスト内でコードをセットアップして実行する方法の手順が記載されています。

トピック

アクション

次のコード例は、accept-address-transfer を使用する方法を示しています。

AWS CLI

アカウントに転送された Elastic IP アドレスを受け入れるには

次のaccept-address-transfer例では、指定された Elastic IP アドレスの アカウントへの移管を受け入れます。

aws ec2 accept-address-transfer \
    --address 100.21.184.216

出力:

{
    "AddressTransfer": {
        "PublicIp": "100.21.184.216",
        "AllocationId": "eipalloc-09ad461b0d03f6aaf",
        "TransferAccountId": "123456789012",
        "TransferOfferExpirationTimestamp": "2023-02-22T20:51:10.000Z",
        "TransferOfferAcceptedTimestamp": "2023-02-22T22:52:54.000Z",
        "AddressTransferStatus": "accepted"
    }
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレスを転送する」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスAcceptAddressTransfer」の「」を参照してください。 AWS CLI

次のコード例は、accept-reserved-instances-exchange-quote を使用する方法を示しています。

AWS CLI

コンバーティブルリザーブドインスタンスの交換を実行するには

この例では、指定された コンバーティブルリザーブドインスタンス の交換を実行します。

コマンド:

aws ec2 accept-reserved-instances-exchange-quote --reserved-instance-ids 7b8750c3-397e-4da4-bbcb-a45ebexample --target-configurations OfferingId=b747b472-423c-48f3-8cee-679bcexample

出力:

{
  "ExchangeId": "riex-e68ed3c1-8bc8-4c17-af77-811afexample"
}

次の例は、accept-transit-gateway-peering-attachment を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイピアリングアタッチメントを受け入れるには

次のaccept-transit-gateway-peering-attachment例では、指定された Transit Gateway ピアリングアタッチメントを受け入れます。--region パラメータは、アクセプタトランジットゲートウェイがあるリージョンを指定します。

aws ec2 accept-transit-gateway-peering-attachment \
    --transit-gateway-attachment-id tgw-attach-4455667788aabbccd \
    --region us-east-2

出力:

{
    "TransitGatewayPeeringAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd",
        "RequesterTgwInfo": {
            "TransitGatewayId": "tgw-123abc05e04123abc",
            "OwnerId": "123456789012",
            "Region": "us-west-2"
        },
        "AccepterTgwInfo": {
            "TransitGatewayId": "tgw-11223344aabbcc112",
            "OwnerId": "123456789012",
            "Region": "us-east-2"
        },
        "State": "pending",
        "CreationTime": "2019-12-09T11:38:31.000Z"
    }
}

詳細については、「 Transit Gateways Guide」の「Transit Gateway ピアリングアタッチメント」を参照してください。

次の例は、accept-transit-gateway-vpc-attachment を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイに をアタッチVPCするリクエストを受け入れるには。

次のaccept-transit-gateway-vpc-attachment例では、指定された添付ファイルに対するリクエストを受け入れます。

aws ec2 accept-transit-gateway-vpc-attachment \
    --transit-gateway-attachment-id tgw-attach-0a34fe6b4fEXAMPLE

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE",
        "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
        "VpcId": "vpc-07e8ffd50fEXAMPLE",
        "VpcOwnerId": "123456789012",
        "State": "pending",
        "SubnetIds": [
            "subnet-0752213d59EXAMPLE"
        ],
        "CreationTime": "2019-07-10T17:33:46.000Z",
        "Options": {
            "DnsSupport": "enable",
            "Ipv6Support": "disable"
        }
    }
}

詳細については、「 Transit Gateways ガイド」のVPC「 への Transit Gateway アタッチメント」を参照してください。

次の例は、accept-vpc-endpoint-connections を使用する方法を説明しています。

AWS CLI

インターフェイスエンドポイント接続リクエストを受け入れるには

この例では、指定されたエンドポイントサービスに対して指定されたエンドポイント接続リクエストを受け入れます。

コマンド:

aws ec2 accept-vpc-endpoint-connections --service-id vpce-svc-03d5ebb7d9579a2b3 --vpc-endpoint-ids vpce-0c1308d7312217abc

出力:

{
  "Unsuccessful": []
}

  • API 詳細については、「 コマンドリファレンスAcceptVpcEndpointConnections」の「」を参照してください。 AWS CLI

次のコード例は、accept-vpc-peering-connection を使用する方法を示しています。

AWS CLI

VPCピアリング接続を受け入れるには

この例では、指定されたVPCピアリング接続リクエストを受け入れます。

コマンド:

aws ec2 accept-vpc-peering-connection --vpc-peering-connection-id pcx-1a2b3c4d

出力:

{
  "VpcPeeringConnection": {
    "Status": {
      "Message": "Provisioning",
      "Code": "provisioning"
    },
    "Tags": [],
    "AccepterVpcInfo": {
      "OwnerId": "444455556666",
      "VpcId": "vpc-44455566",
      "CidrBlock": "10.0.1.0/28"
    },
    "VpcPeeringConnectionId": "pcx-1a2b3c4d",
    "RequesterVpcInfo": {
      "OwnerId": "444455556666",
      "VpcId": "vpc-111abc45",
      "CidrBlock": "10.0.0.0/28"
    }
  }
}

  • API 詳細については、「 コマンドリファレンスAcceptVpcPeeringConnection」の「」を参照してください。 AWS CLI

次の例は、advertise-byoip-cidr を使用する方法を説明しています。

AWS CLI

アドレス範囲をアドバタイズするには

次のadvertise-byoip-cidr例では、指定されたパブリックIPv4アドレス範囲をアドバタイズします。

aws ec2 advertise-byoip-cidr \
    --cidr 203.0.113.25/24

出力:

{
    "ByoipCidr": {
        "Cidr": "203.0.113.25/24",
        "StatusMessage": "ipv4pool-ec2-1234567890abcdef0",
        "State": "provisioned"
    }
}

  • API 詳細については、「 コマンドリファレンスAdvertiseByoipCidr」の「」を参照してください。 AWS CLI

次の例は、allocate-address を使用する方法を説明しています。

AWS CLI

例 1: Amazon のアドレスプールから Elastic IP アドレスを割り当てるには

次の allocate-address の例では、Elastic IP アドレスを割り当てています。Amazon は、Amazon のアドレスプールからアドレスEC2を選択します。

aws ec2 allocate-address

出力:

{
    "PublicIp": "70.224.234.241",
    "AllocationId": "eipalloc-01435ba59eEXAMPLE",
    "PublicIpv4Pool": "amazon",
    "NetworkBorderGroup": "us-west-2",
    "Domain": "vpc"
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレス」を参照してください。 EC2

例 2: Elastic IP アドレスを割り当て、インスタンスまたはネットワークボーダーグループと関連付けるには

次の allocate-address の例では、Elastic IP アドレスを割り当て、指定されたネットワークボーダーグループに関連付けます。

aws ec2 allocate-address \
    --network-border-group us-west-2-lax-1

出力:

{
    "PublicIp": "70.224.234.241",
    "AllocationId": "eipalloc-e03dd489ceEXAMPLE",
    "PublicIpv4Pool": "amazon",
    "NetworkBorderGroup": "us-west-2-lax-1",
    "Domain": "vpc"
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレス」を参照してください。 EC2

例 3: 所有するアドレスプールから Elastic IP アドレスを割り当てるには

次の allocate-address の例では、Amazon Web Services アカウントに入れたアドレスプールから Elastic IP アドレスを割り当てています。Amazon はアドレスプールからアドレスEC2を選択します。

aws ec2 allocate-address \
    --public-ipv4-pool ipv4pool-ec2-1234567890abcdef0

出力:

{
    "AllocationId": "eipalloc-02463d08ceEXAMPLE",
    "NetworkBorderGroup": "us-west-2",
    "CustomerOwnedIp": "18.218.95.81",
    "CustomerOwnedIpv4Pool": "ipv4pool-ec2-1234567890abcdef0",
    "Domain": "vpc"
    "NetworkBorderGroup": "us-west-2",
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレス」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスAllocateAddress」の「」を参照してください。 AWS CLI

次のコード例は、allocate-hosts を使用する方法を示しています。

AWS CLI

例 1: Dedicated Host を割り当てるには

次のallocate-hosts例では、m5.largeインスタンスを起動できるアeu-west-1aベイラビリティーゾーンに 1 つの Dedicated Host を割り当てます。デフォルトでは、Dedicated Host はターゲットインスタンスの起動のみを受け入れ、ホスト復旧をサポートしていません。

aws ec2 allocate-hosts \
    --instance-type m5.large \
    --availability-zone eu-west-1a \
    --quantity 1

出力:

{
    "HostIds": [
        "h-07879acf49EXAMPLE"
    ]
}

例 2: 自動配置とホスト復旧を有効にして Dedicated Host を割り当てるには

次のallocate-hosts例では、自動配置とホスト復旧を有効にして、アeu-west-1aベイラビリティーゾーンに 1 つの Dedicated Host を割り当てます。

aws ec2 allocate-hosts \
    --instance-type m5.large \
    --availability-zone eu-west-1a \
    --auto-placement on \
    --host-recovery on \
    --quantity 1

出力:

{
     "HostIds": [
         "h-07879acf49EXAMPLE"
     ]
}

例 3: タグを使用して Dedicated Host を割り当てるには

次のallocate-hosts例では、単一の Dedicated Host を割り当て、 という名前のキーpurposeと の値を持つタグを適用しますproduction。

aws ec2 allocate-hosts \
    --instance-type m5.large \
    --availability-zone eu-west-1a \
    --quantity 1 \
    --tag-specifications 'ResourceType=dedicated-host,Tags={Key=purpose,Value=production}'

出力:

{
    "HostIds": [
        "h-07879acf49EXAMPLE"
    ]
}

詳細については、Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイドの「専有ホストの割り当て」を参照してください。

  • API 詳細については、「 コマンドリファレンスAllocateHosts」の「」を参照してください。 AWS CLI

次のコード例は、allocate-ipam-pool-cidr を使用する方法を示しています。

AWS CLI

IPAM プールCIDRから を割り当てるには

次のallocate-ipam-pool-cidr例では、IPAMプールCIDRから を割り当てます。

(Linux):

aws ec2 allocate-ipam-pool-cidr \
    --ipam-pool-id ipam-pool-0533048da7d823723 \
    --netmask-length 24

(Windows):

aws ec2 allocate-ipam-pool-cidr ^
   --ipam-pool-id ipam-pool-0533048da7d823723 ^
   --netmask-length 24

出力:

{
    "IpamPoolAllocation": {
        "Cidr": "10.0.0.0/24",
        "IpamPoolAllocationId": "ipam-pool-alloc-018ecc28043b54ba38e2cd99943cebfbd",
        "ResourceType": "custom",
        "ResourceOwner": "123456789012"
    }
}

詳細については、「Amazon ユーザーガイド」の「IP アドレス空間を予約するためのプールCIDRへの の手動割り当て」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスAllocateIpamPoolCidr」の「」を参照してください。 AWS CLI

次の例は、apply-security-groups-to-client-vpn-target-network を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントのターゲットネットワークにセキュリティグループを適用するには

次のapply-security-groups-to-client-vpn-target-network例ではsg-01f6e627a89f4db32、指定されたターゲットネットワークとクライアントVPNエンドポイント間の関連付けにセキュリティグループを適用します。

aws ec2 apply-security-groups-to-client-vpn-target-network \
    --security-group-ids sg-01f6e627a89f4db32 \
    --vpc-id vpc-0e2110c2f324332e0 \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "SecurityGroupIds": [
        "sg-01f6e627a89f4db32"
    ]
}

詳細については、クライアント管理者ガイドの「ターゲットネットワーク」を参照してください。 AWS VPN

次の例は、assign-ipv6-addresses を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスに特定のIPv6アドレスを割り当てるには

この例では、指定されたIPv6アドレスを指定されたネットワークインターフェイスに割り当てます。

コマンド:

aws ec2 assign-ipv6-addresses --network-interface-id eni-38664473 --ipv6-addresses 2001:db8:1234:1a00:3304:8879:34cf:4071 2001:db8:1234:1a00:9691:9503:25ad:1761

出力:

{
  "AssignedIpv6Addresses": [
      "2001:db8:1234:1a00:3304:8879:34cf:4071",
      "2001:db8:1234:1a00:9691:9503:25ad:1761"
  ],
  "NetworkInterfaceId": "eni-38664473"
}

Amazon が選択したIPv6アドレスをネットワークインターフェイスに割り当てるには

この例では、指定されたネットワークインターフェイスに 2 つのIPv6アドレスを割り当てます。Amazon は、サブネットのIPv6CIDRブロック範囲内で使用可能なIPv6アドレスからこれらのIPv6アドレスを自動的に割り当てます。

コマンド:

aws ec2 assign-ipv6-addresses --network-interface-id eni-38664473 --ipv6-address-count 2

出力:

{
  "AssignedIpv6Addresses": [
      "2001:db8:1234:1a00:3304:8879:34cf:4071",
      "2001:db8:1234:1a00:9691:9503:25ad:1761"
  ],
  "NetworkInterfaceId": "eni-38664473"
}

  • API 詳細については、AWS CLI 「 コマンドリファレンス」のAssignIpv6Addresses」を参照してください。

次のコード例は、assign-private-ip-addresses を使用する方法を示しています。

AWS CLI

特定のセカンダリプライベート IP アドレスをネットワークインターフェイスに割り当てるには

この例では、指定されたセカンダリプライベート IP アドレスを指定されたネットワークインターフェイスに割り当てます。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 assign-private-ip-addresses --network-interface-id eni-e5aa89a3 --private-ip-addresses 10.0.0.82

Amazon がEC2選択したセカンダリプライベート IP アドレスをネットワークインターフェイスに割り当てるには

この例では、指定されたネットワークインターフェイスに 2 つのセカンダリプライベート IP アドレスを割り当てます。Amazon は、ネットワークインターフェイスが関連付けられているサブネットのCIDRブロック範囲内で使用可能な IP アドレスから、これらの IP アドレスEC2を自動的に割り当てます。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 assign-private-ip-addresses --network-interface-id eni-e5aa89a3 --secondary-private-ip-address-count 2

  • API 詳細については、「 コマンドリファレンスAssignPrivateIpAddresses」の「」を参照してください。 AWS CLI

次のコード例は、assign-private-nat-gateway-address を使用する方法を示しています。

AWS CLI

プライベート IP アドレスをプライベートNATゲートウェイに割り当てるには

次のassign-private-nat-gateway-address例では、指定されたプライベートNATゲートウェイに 2 つのプライベート IP アドレスを割り当てます。

aws ec2 assign-private-nat-gateway-address \
    --nat-gateway-id nat-1234567890abcdef0 \
    --private-ip-address-count 2

出力:

{
    "NatGatewayId": "nat-1234567890abcdef0",
    "NatGatewayAddresses": [
        {
            "NetworkInterfaceId": "eni-0065a61b324d1897a",
            "IsPrimary": false,
            "Status": "assigning"
        },
        {
            "NetworkInterfaceId": "eni-0065a61b324d1897a",
            "IsPrimary": false,
            "Status": "assigning"
        }
    ]
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

次の例は、associate-address を使用する方法を説明しています。

AWS CLI

EC2-Classic で Elastic IP アドレスを関連付けるには

この例では、Elastic IP アドレスを EC2-Classic のインスタンスに関連付けます。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 associate-address --instance-id i-07ffe74c7330ebf53 --public-ip 198.51.100.0

EC2- で Elastic IP アドレスを関連付けるにはVPC

この例では、Elastic IP アドレスを のインスタンスに関連付けますVPC。

コマンド:

aws ec2 associate-address --instance-id i-0b263919b6498b123 --allocation-id eipalloc-64d5890a

出力:

{
    "AssociationId": "eipassoc-2bebb745"
}

この例では、Elastic IP アドレスとネットワークインターフェイスを関連付けています。

コマンド:

aws ec2 associate-address --allocation-id eipalloc-64d5890a --network-interface-id eni-1a2b3c4d

この例では、ネットワークインターフェイスに関連付けられたプライベート IP アドレスに Elastic IP を関連付けています。

コマンド:

aws ec2 associate-address --allocation-id eipalloc-64d5890a --network-interface-id eni-1a2b3c4d --private-ip-address 10.0.0.85

  • API 詳細については、「 コマンドリファレンスAssociateAddress」の「」を参照してください。 AWS CLI

次の例は、associate-client-vpn-target-network を使用する方法を説明しています。

AWS CLI

ターゲットネットワークをクライアントVPNエンドポイントに関連付けるには

次のassociate-client-vpn-target-network例では、サブネットを指定されたクライアントVPNエンドポイントに関連付けます。

aws ec2 associate-client-vpn-target-network \
    --subnet-id subnet-0123456789abcabca \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "AssociationId": "cvpn-assoc-12312312312312312",
    "Status": {
        "Code": "associating"
    }
}

詳細については、AWS クライアントVPN管理者ガイドの「ターゲットネットワーク」を参照してください。

次の例は、associate-dhcp-options を使用する方法を説明しています。

AWS CLI

DHCPオプションセットを に関連付けるには VPC

この例では、指定されたDHCPオプションセットを指定された に関連付けますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 associate-dhcp-options --dhcp-options-id dopt-d9070ebb --vpc-id vpc-a01106c2

デフォルトのDHCPオプションセットを に関連付けるには VPC

この例では、デフォルトのDHCPオプションセットを指定された に関連付けますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 associate-dhcp-options --dhcp-options-id default --vpc-id vpc-a01106c2

  • API 詳細については、「 コマンドリファレンスAssociateDhcpOptions」の「」を参照してください。 AWS CLI

次の例は、associate-iam-instance-profile を使用する方法を説明しています。

AWS CLI

IAMインスタンスプロファイルをインスタンスに関連付けるには

この例では、 という名前のIAMインスタンスプロファイルをインスタンス admin-roleに関連付けますi-123456789abcde123。

コマンド:

aws ec2 associate-iam-instance-profile --instance-id i-123456789abcde123 --iam-instance-profile Name=admin-role

出力:

{
  "IamInstanceProfileAssociation": {
      "InstanceId": "i-123456789abcde123",
      "State": "associating",
      "AssociationId": "iip-assoc-0e7736511a163c209",
      "IamInstanceProfile": {
          "Id": "AIPAJBLK7RKJKWDXVHIEC",
          "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role"
      }
  }
}

  • API 詳細については、「 コマンドリファレンスAssociateIamInstanceProfile」の「」を参照してください。 AWS CLI

次のコード例は、associate-instance-event-window を使用する方法を示しています。

AWS CLI

例 1: 1 つ以上のインスタンスをイベントウィンドウに関連付けるには

次のassociate-instance-event-window例では、1 つ以上のインスタンスをイベントウィンドウに関連付けます。

aws ec2 associate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [
                "i-1234567890abcdef0",
                "i-0598c7d356eba48d7"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 2: インスタンスタグをイベントウィンドウに関連付けるには

次のassociate-instance-event-window例では、インスタンスタグをイベントウィンドウに関連付けます。instance-event-window-id パラメータを入力して、イベントウィンドウを指定します。インスタンスタグを関連付けるには、 association-targetパラメータを指定し、 パラメータ値に 1 つ以上のタグを指定します。

aws ec2 associate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [
                {
                    "Key": "k2",
                    "Value": "v2"
                },
                {
                    "Key": "k1",
                    "Value": "v1"
                }
            ],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 3: Dedicated Host をイベントウィンドウに関連付けるには

次のassociate-instance-event-window例では、Dedicated Host をイベントウィンドウに関連付けます。instance-event-window-id パラメータを入力して、イベントウィンドウを指定します。Dedicated Host を関連付けるには、 --association-targetパラメータを指定し、 パラメータ値には、1 つ以上の Dedicated Host を指定しますIDs。

aws ec2 associate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "DedicatedHostIds=h-029fa35a02b99801d"

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": [
                "h-029fa35a02b99801d"
            ]
        },
        "State": "creating"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

  • API 詳細については、「 コマンドリファレンスAssociateInstanceEventWindow」の「」を参照してください。 AWS CLI

次の例は、associate-ipam-resource-discovery を使用する方法を説明しています。

AWS CLI

リソース検出を に関連付けるには IPAM

この例では、ユーザーはIPAM委任管理者であり、リソース検出が別の AWS アカウントによって作成および共有されているため、 IPAMを使用して他のアカウントCIDRsが所有するリソースを管理およびモニタリングできます。

注記

このリクエストを完了するには、 で取得できるリソース検出 ID describe-ipam-resource-discoveriesと describe-ipams で取得できる IPAM ID が必要です。関連付けるリソース検出は、まず を使用してアカウントと共有されている必要があります AWS RAM。--region入力する IPAMは、関連付ける のホームリージョンと一致する必要があります。

次のassociate-ipam-resource-discovery例では、リソース検出を に関連付けますIPAM。

aws ec2 associate-ipam-resource-discovery \
    --ipam-id ipam-005f921c17ebd5107 \
    --ipam-resource-discovery-id ipam-res-disco-03e0406de76a044ee \
    --tag-specifications 'ResourceType=ipam-resource-discovery,Tags=[{Key=cost-center,Value=cc123}]' \
    --region us-east-1

出力:

{
    {
        "IpamResourceDiscoveryAssociation": {
            "OwnerId": "320805250157",
            "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-04382a6346357cf82",
            "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::320805250157:ipam-resource-discovery-association/ipam-res-disco-assoc-04382a6346357cf82",
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "IpamId": "ipam-005f921c17ebd5107",
            "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107",
            "IpamRegion": "us-east-1",
            "IsDefault": false,
            "ResourceDiscoveryStatus": "active",
            "State": "associate-in-progress",
            "Tags": []
        }
    }
}

リソース検出を関連付けると、他のアカウントによって作成されたリソースの IP アドレスをモニタリングおよび/または管理できます。詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

次のコード例は、associate-nat-gateway-address を使用する方法を示しています。

AWS CLI

Elastic IP アドレスをパブリックNATゲートウェイに関連付けるには

次のassociate-nat-gateway-address例では、指定された Elastic IP アドレスを指定されたパブリックNATゲートウェイに関連付けます。 はセカンダリプライベートIPv4アドレス AWS を自動的に割り当てます。

aws ec2 associate-nat-gateway-address \
    --nat-gateway-id nat-1234567890abcdef0 \
    --allocation-ids eipalloc-0be6ecac95EXAMPLE

出力:

{
    "NatGatewayId": "nat-1234567890abcdef0",
    "NatGatewayAddresses": [
        {
            "AllocationId": "eipalloc-0be6ecac95EXAMPLE",
            "NetworkInterfaceId": "eni-09cc4b2558794f7f9",
            "IsPrimary": false,
            "Status": "associating"
        }
    ]
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスAssociateNatGatewayAddress」の「」を参照してください。 AWS CLI

次の例は、associate-route-table を使用する方法を説明しています。

AWS CLI

ルートテーブルをサブネットに関連付けるには

この例では、指定されたルートテーブルを指定されたサブネットに関連付けます。

コマンド:

aws ec2 associate-route-table --route-table-id rtb-22574640 --subnet-id subnet-9d4a7b6c

出力:

{
    "AssociationId": "rtbassoc-781d0d1a"
}

  • API 詳細については、「 コマンドリファレンスAssociateRouteTable」の「」を参照してください。 AWS CLI

次のコード例は、associate-subnet-cidr-block を使用する方法を示しています。

AWS CLI

IPv6CIDRブロックをサブネットに関連付けるには

この例では、 IPv6CIDRブロックを指定されたサブネットに関連付けます。

コマンド:

aws ec2 associate-subnet-cidr-block --subnet-id subnet-5f46ec3b --ipv6-cidr-block 2001:db8:1234:1a00::/64

出力:

{
  "SubnetId": "subnet-5f46ec3b",
  "Ipv6CidrBlockAssociation": {
      "Ipv6CidrBlock": "2001:db8:1234:1a00::/64",
      "AssociationId": "subnet-cidr-assoc-3aa54053",
      "Ipv6CidrBlockState": {
          "State": "associating"
      }
  }
}

  • API 詳細については、「 コマンドリファレンスAssociateSubnetCidrBlock」の「」を参照してください。 AWS CLI

次の例は、associate-transit-gateway-multicast-domain を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイをマルチキャストドメインに関連付けるには

次のassociate-transit-gateway-multicast-domain例では、指定されたサブネットとアタッチメントを指定されたマルチキャストドメインに関連付けます。

aws ec2 associate-transit-gateway-multicast-domain \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \
    --transit-gateway-attachment-id tgw-attach-028c1dd0f8f5cbe8e \
    --subnet-ids subnet-000de86e3b49c932a \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE

出力:

{
    "Associations": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597",
        "TransitGatewayAttachmentId": "tgw-attach-028c1dd0f8f5cbe8e",
        "ResourceId": "vpc-01128d2c240c09bd5",
        "ResourceType": "vpc",
        "Subnets": [
            {
                "SubnetId": "subnet-000de86e3b49c932a",
                "State": "associating"
            }
        ]
    }
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストドメインの管理」を参照してください。

次のコード例は、associate-transit-gateway-route-table を使用する方法を示しています。

AWS CLI

トランジットゲートウェイルートテーブルをトランジットゲートウェイアタッチメントに関連付けるには

次の例では、指定された Transit Gateway ルートテーブルを指定されたVPCアタッチメントに関連付けます。

aws ec2 associate-transit-gateway-route-table \
    --transit-gateway-route-table-id tgw-rtb-002573ed1eEXAMPLE \
    --transit-gateway-attachment-id tgw-attach-0b5968d3b6EXAMPLE

出力:

{
    "Association": {
        "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE",
        "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE",
        "ResourceId": "vpc-0065acced4EXAMPLE",
        "ResourceType": "vpc",
        "State": "associating"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブルの関連付けAWS 」を参照してください。

次の例は、associate-vpc-cidr-block を使用する方法を説明しています。

AWS CLI

例 1: Amazon が提供するIPv6CIDRブロックを に関連付けるには VPC

次のassociate-vpc-cidr-block例では、 IPv6CIDRブロックを指定された に関連付けますVPC。

aws ec2 associate-vpc-cidr-block \
    --amazon-provided-ipv6-cidr-block \
    --ipv6-cidr-block-network-border-group us-west-2-lax-1  \
    --vpc-id vpc-8EXAMPLE

出力:

{
    "Ipv6CidrBlockAssociation": {
        "AssociationId": "vpc-cidr-assoc-0838ce7d9dEXAMPLE",
        "Ipv6CidrBlockState": {
            "State": "associating"
        },
        "NetworkBorderGroup": "us-west-2-lax-1"
    },
    "VpcId": "vpc-8EXAMPLE"
}

例 2: 追加のIPv4CIDRブロックを に関連付けるには VPC

次のassociate-vpc-cidr-block例では、 IPv4CIDRブロックを指定された 10.2.0.0/16に関連付けますVPC。

aws ec2 associate-vpc-cidr-block \
    --vpc-id vpc-1EXAMPLE \
    --cidr-block 10.2.0.0/16

出力:

{
    "CidrBlockAssociation": {
        "AssociationId": "vpc-cidr-assoc-2EXAMPLE",
        "CidrBlock": "10.2.0.0/16",
        "CidrBlockState": {
            "State": "associating"
        }
    },
    "VpcId": "vpc-1EXAMPLE"
}

  • API 詳細については、「 コマンドリファレンスAssociateVpcCidrBlock」の「」を参照してください。 AWS CLI

次のコード例は、attach-classic-link-vpc を使用する方法を示しています。

AWS CLI

EC2-Classic インスタンスを にリンク (アタッチ) するには VPC

この例では、VPCセキュリティグループ sg-1234567890 を介してインスタンス VPC i-88888888abcdef0 を vpc-12312312 にリンクします。

コマンド:

aws ec2 attach-classic-link-vpc --instance-id  i-1234567890abcdef0 --vpc-id vpc-88888888 --groups sg-12312312

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスAttachClassicLinkVpc」の「」を参照してください。 AWS CLI

次の例は、attach-internet-gateway を使用する方法を説明しています。

AWS CLI

インターネットゲートウェイを にアタッチするには VPC

次のattach-internet-gateway例では、指定されたインターネットゲートウェイを特定の にアタッチしますVPC。

aws ec2 attach-internet-gateway \
    --internet-gateway-id igw-0d0fb496b3EXAMPLE \
    --vpc-id vpc-0a60eb65b4EXAMPLE

このコマンドでは何も出力されません。

詳細については、「Amazon VPCユーザーガイド」の「インターネットゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスAttachInternetGateway」の「」を参照してください。 AWS CLI

次のコード例は、attach-network-interface を使用する方法を示しています。

AWS CLI

例 1: ネットワークインターフェイスをインスタンスにアタッチするには

次のattach-network-interface例では、指定されたネットワークインターフェイスを指定されたインスタンスにアタッチします。

aws ec2 attach-network-interface \
    --network-interface-id eni-0dc56a8d4640ad10a \
    --instance-id i-1234567890abcdef0 \
    --device-index 1

出力:

{
    "AttachmentId": "eni-attach-01a8fc87363f07cf9"
}

詳細については、「Amazon ユーザーガイド」の「Elastic Network Interface」を参照してください。 EC2

例 2: 複数のネットワークカードを持つインスタンスにネットワークインターフェイスをアタッチするには

次のattach-network-interface例では、指定されたネットワークインターフェイスを指定されたインスタンスとネットワークカードにアタッチします。

aws ec2 attach-network-interface \
    --network-interface-id eni-07483b1897541ad83 \
    --instance-id i-01234567890abcdef \
    --network-card-index 1 \
    --device-index 1

出力:

{
    "AttachmentId": "eni-attach-0fbd7ee87a88cd06c"
}

詳細については、「Amazon ユーザーガイド」の「Elastic Network Interface」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスAttachNetworkInterface」の「」を参照してください。 AWS CLI

次のコード例は、attach-verified-access-trust-provider を使用する方法を示しています。

AWS CLI

信頼プロバイダーをインスタンスにアタッチするには

次のattach-verified-access-trust-provider例では、指定された Verified Access 信頼プロバイダーを指定された Verified Access インスタンスにアタッチします。

aws ec2 attach-verified-access-trust-provider \
    --verified-access-instance-id vai-0ce000c0b7643abea \
    --verified-access-trust-provider-id vatp-0bb32de759a3e19e7

出力:

{
    "VerifiedAccessTrustProvider": {
        "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
        "Description": "",
        "TrustProviderType": "user",
        "UserTrustProviderType": "iam-identity-center",
        "PolicyReferenceName": "idc",
        "CreationTime": "2023-08-25T19:00:38",
        "LastUpdatedTime": "2023-08-25T19:00:38"
    },
    "VerifiedAccessInstance": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "",
        "VerifiedAccessTrustProviders": [
            {
                "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
                "TrustProviderType": "user",
                "UserTrustProviderType": "iam-identity-center"
            }
        ],
        "CreationTime": "2023-08-25T18:27:56",
        "LastUpdatedTime": "2023-08-25T18:27:56"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access インスタンス」を参照してください。 AWS

次の例は、attach-volume を使用する方法を説明しています。

AWS CLI

ボリュームをインスタンスにアタッチするには

このコマンド例では、ボリューム (vol-1234567890abcdef0) を としてインスタンス (i-01474ef662b89480) にアタッチします/dev/sdf。

コマンド:

aws ec2 attach-volume --volume-id vol-1234567890abcdef0 --instance-id i-01474ef662b89480 --device /dev/sdf

出力:

{
    "AttachTime": "YYYY-MM-DDTHH:MM:SS.000Z",
    "InstanceId": "i-01474ef662b89480",
    "VolumeId": "vol-1234567890abcdef0",
    "State": "attaching",
    "Device": "/dev/sdf"
}

  • API 詳細については、「 コマンドリファレンスAttachVolume」の「」を参照してください。 AWS CLI

次のコード例は、attach-vpn-gateway を使用する方法を示しています。

AWS CLI

仮想プライベートゲートウェイを にアタッチするには VPC

次のattach-vpn-gateway例では、指定された仮想プライベートゲートウェイを指定された にアタッチしますVPC。

aws ec2 attach-vpn-gateway \
    --vpn-gateway-id vgw-9a4cacf3 \
    --vpc-id vpc-a01106c2

出力:

{
    "VpcAttachment": {
        "State": "attaching",
        "VpcId": "vpc-a01106c2"
    }
}

  • API 詳細については、「 コマンドリファレンスAttachVpnGateway」の「」を参照してください。 AWS CLI

次のコード例は、authorize-client-vpn-ingress を使用する方法を示しています。

AWS CLI

クライアントVPNエンドポイントの承認ルールを追加するには

次のauthorize-client-vpn-ingress例では、すべてのクライアントがインターネット () にアクセスできるようにする進入承認ルールを追加します0.0.0.0/0。

aws ec2 authorize-client-vpn-ingress \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --target-network-cidr 0.0.0.0/0 \
    --authorize-all-groups

出力:

{
    "Status": {
        "Code": "authorizing"
    }
}

詳細については、AWS クライアントVPN管理者ガイドの「承認ルール」を参照してください。

  • API 詳細については、「 コマンドリファレンスAuthorizeClientVpnIngress」の「」を参照してください。 AWS CLI

次のコード例は、authorize-security-group-egress を使用する方法を示しています。

AWS CLI

特定のアドレス範囲へのアウトバウンドトラフィックを許可するルールを追加するには

このコマンド例では、TCPポート 80 で指定されたアドレス範囲へのアクセスを許可するルールを追加します。

コマンド (Linux):

aws ec2 authorize-security-group-egress --group-id sg-1a2b3c4d --ip-permissions IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges='[{CidrIp=10.0.0.0/16}]'

コマンド (Windows):

aws ec2 authorize-security-group-egress --group-id sg-1a2b3c4d --ip-permissions IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges=[{CidrIp=10.0.0.0/16}]

特定のセキュリティグループへのアウトバウンドトラフィックを許可するルールを追加するには

このコマンド例では、TCPポート 80 で指定されたセキュリティグループへのアクセスを許可するルールを追加します。

コマンド (Linux):

aws ec2 authorize-security-group-egress --group-id sg-1a2b3c4d --ip-permissions IpProtocol=tcp,FromPort=80,ToPort=80,UserIdGroupPairs='[{GroupId=sg-4b51a32f}]'

コマンド (Windows):

aws ec2 authorize-security-group-egress --group-id sg-1a2b3c4d --ip-permissions IpProtocol=tcp,FromPort=80,ToPort=80,UserIdGroupPairs=[{GroupId=sg-4b51a32f}]

  • API 詳細については、「 コマンドリファレンスAuthorizeSecurityGroupEgress」の「」を参照してください。 AWS CLI

次の例は、authorize-security-group-ingress を使用する方法を説明しています。

AWS CLI

例 1: インバウンドSSHトラフィックを許可するルールを追加するには

次のauthorize-security-group-ingress例では、TCPポート 22 () でインバウンドトラフィックを許可するルールを追加しますSSH。

aws ec2 authorize-security-group-ingress \
    --group-id sg-1234567890abcdef0 \
    --protocol tcp \
    --port 22 \
    --cidr 203.0.113.0/24

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-01afa97ef3e1bedfc",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "tcp",
            "FromPort": 22,
            "ToPort": 22,
            "CidrIpv4": "203.0.113.0/24"
        }
    ]
}

例 2: 別のセキュリティグループからのインバウンドHTTPトラフィックを許可するルールを追加するには

次のauthorize-security-group-ingress例では、ソースセキュリティグループ からのTCPポート 80 へのインバウンドアクセスを許可するルールを追加しますsg-1a2b3c4d。ソースグループは、同じ VPCまたはピアにある必要があります VPC (VPCピアリング接続が必要です）。着信トラフィックは、ソースセキュリティグループに関連付けられたインスタンスのプライベート IP アドレスに基づいて許可されます (パブリック IP アドレスまたは Elastic IP アドレスは考慮されません)。

aws ec2 authorize-security-group-ingress \
    --group-id sg-1234567890abcdef0 \
    --protocol tcp \
    --port 80 \
    --source-group sg-1a2b3c4d

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-01f4be99110f638a7",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "tcp",
            "FromPort": 80,
            "ToPort": 80,
            "ReferencedGroupInfo": {
                "GroupId": "sg-1a2b3c4d",
                "UserId": "123456789012"
            }
        }
    ]
}

例 3: 同じ呼び出しに複数のルールを追加するには

次のauthorize-security-group-ingress例では、 ip-permissionsパラメータを使用して 2 つのインバウンドルールを追加します。1 つはTCPポート 3389 (RDP) でインバウンドアクセスを有効にし、もう 1 つは ping/ を有効にしますICMP。

aws ec2 authorize-security-group-ingress --group-id sg-1234567890abcdef0 --ip-permissions IpProtocol=tcp,FromPort=3389,ToPort=3389,IpRanges"[{CidrIp=172.31.0.0/16}]" IpProtocol=icmp,FromPort=-1,ToPort=-1,IpRanges"[{CidrIp=172.31.0.0/16}]"

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-00e06e5d3690f29f3",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "tcp",
            "FromPort": 3389,
            "ToPort": 3389,
            "CidrIpv4": "172.31.0.0/16"
        },
        {
            "SecurityGroupRuleId": "sgr-0a133dd4493944b87",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "tcp",
            "FromPort": -1,
            "ToPort": -1,
            "CidrIpv4": "172.31.0.0/16"
        }
    ]
}

例 4: ICMPトラフィックのルールを追加するには

次のauthorize-security-group-ingress例では、 ip-permissionsパラメータを使用して、どこからでもICMPメッセージ Destination Unreachable: Fragmentation Needed and Don't Fragment was Set (タイプ 3、コード 4) を許可するインバウンドルールを追加します。

aws ec2 authorize-security-group-ingress --group-id sg-1234567890abcdef0 --ip-permissions IpProtocol=icmp,FromPort=3,ToPort=4,IpRanges=[{CidrIp=0.0.0.0/0}]"

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-0de3811019069b787",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "icmp",
            "FromPort": 3,
            "ToPort": 4,
            "CidrIpv4": "0.0.0.0/0"
        }
    ]
}

例 5: IPv6トラフィックのルールを追加するには

次のauthorize-security-group-ingress例では、 ip-permissionsパラメータを使用して、IPv6範囲 からのSSHアクセス (ポート 22) を許可するインバウンドルールを追加します2001:db8:1234:1a00::/64。

aws ec2 authorize-security-group-ingress --group-id sg-1234567890abcdef0 --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,Ipv6Ranges [{CidrIpv6=2001:db8:1234:1a00::/64}]"

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-0455bc68b60805563",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "tcp",
            "FromPort": 22,
            "ToPort": 22,
            "CidrIpv6": "2001:db8:1234:1a00::/64"
        }
    ]
}

例 6: ICMPv6トラフィックのルールを追加するには

次のauthorize-security-group-ingress例では、 ip-permissionsパラメータを使用して、どこからでもICMPv6トラフィックを許可するインバウンドルールを追加します。

aws ec2 authorize-security-group-ingress --group-id sg-1234567890abcdef0 --ip-permissions IpProtocol=icmpv6,Ipv6Ranges [{CidrIpv6=::/0}]"

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-04b612d9363ab6327",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "icmpv6",
            "FromPort": -1,
            "ToPort": -1,
            "CidrIpv6": "::/0"
        }
    ]
}

例 7: 説明付きのルールを追加する

次のauthorize-security-group-ingress例では、 ip-permissionsパラメータを使用して、指定されたIPv4アドレス範囲からのRDPトラフィックを許可するインバウンドルールを追加します。ルールには、後で特定できるように説明が含まれます。

aws ec2 authorize-security-group-ingress --group-id sg-1234567890abcdef0 --ip-permissions IpProtocol=tcp,FromPort=3389,ToPort=3389,IpRanges"[{CidrIp=203.0.113.0/24,Description='RDP access from NY office'}]"

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-0397bbcc01e974db3",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "tcp",
            "FromPort": 3389,
            "ToPort": 3389,
            "CidrIpv4": "203.0.113.0/24",
            "Description": "RDP access from NY office"
        }
    ]
}

例 8: プレフィックスリストを使用するインバウンドルールを追加するには

次のauthorize-security-group-ingress例では、 ip-permissionsパラメータを使用して、指定されたプレフィックスリストCIDRの範囲のすべてのトラフィックを許可するインバウンドルールを追加します。

aws ec2 authorize-security-group-ingress --group-id sg-04a351bfe432d4e71 --ip-permissions IpProtocol=all,PrefixListIds"[{PrefixListId=pl-002dc3ec097de1514}]"

出力:

{
    "Return": true,
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-09c74b32f677c6c7c",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "123456789012",
            "IsEgress": false,
            "IpProtocol": "-1",
            "FromPort": -1,
            "ToPort": -1,
            "PrefixListId": "pl-0721453c7ac4ec009"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「セキュリティグループ」を参照してください。 VPC

次の例は、bundle-instance を使用する方法を説明しています。

AWS CLI

インスタンスをバンドルするには

この例では、インスタンスを という名前のバケットi-1234567890abcdef0にバンドルしますbundletasks。アクセスキー の値を指定する前にIDs、 AWS 「アクセスキーの管理のベストプラクティス」のガイダンスを確認して従ってください。

コマンド:

aws ec2 bundle-instance --instance-id i-1234567890abcdef0 --bucket bundletasks --prefix winami --owner-akid AK12AJEXAMPLE --owner-sak example123example

出力:

{
  "BundleTask": {
    "UpdateTime": "2015-09-15T13:30:35.000Z",
    "InstanceId": "i-1234567890abcdef0",
    "Storage": {
      "S3": {
        "Prefix": "winami",
        "Bucket": "bundletasks"
      }
    },
    "State": "pending",
    "StartTime": "2015-09-15T13:30:35.000Z",
    "BundleId": "bun-294e041f"
  }
}

  • API 詳細については、「 コマンドリファレンスBundleInstance」の「」を参照してください。 AWS CLI

次の例は、cancel-bundle-task を使用する方法を説明しています。

AWS CLI

バンドルタスクをキャンセルするには

この例では、バンドルタスク をキャンセルしますbun-2a4e041c。

コマンド:

aws ec2 cancel-bundle-task --bundle-id bun-2a4e041c

出力:

{
  "BundleTask": {
    "UpdateTime": "2015-09-15T13:27:40.000Z",
    "InstanceId": "i-1234567890abcdef0",
    "Storage": {
      "S3": {
        "Prefix": "winami",
        "Bucket": "bundletasks"
      }
    },
    "State": "cancelling",
    "StartTime": "2015-09-15T13:24:35.000Z",
    "BundleId": "bun-2a4e041c"
  }
}

  • API 詳細については、「 コマンドリファレンスCancelBundleTask」の「」を参照してください。 AWS CLI

次のコード例は、cancel-capacity-reservation-fleets を使用する方法を示しています。

AWS CLI

キャパシティー予約フリートをキャンセルするには

次のcancel-capacity-reservation-fleets例では、指定されたキャパシティー予約フリートと、フリートが予約するキャパシティーをキャンセルします。フリートをキャンセルすると、そのステータスは に変わりcancelled、新しいキャパシティ予約を作成できなくなります。さらに、フリート内の個々のキャパシティ予約はすべてキャンセルされ、以前にリザーブドキャパシティで実行されていたインスタンスは共有キャパシティで正常に実行され続けます。

aws ec2 cancel-capacity-reservation-fleets \
    --capacity-reservation-fleet-ids crf-abcdef01234567890

出力:

{
    "SuccessfulFleetCancellations": [
        {
            "CurrentFleetState": "cancelling",
            "PreviousFleetState": "active",
            "CapacityReservationFleetId": "crf-abcdef01234567890"
        }
    ],
    "FailedFleetCancellations": []
}

キャパシティー予約フリートの詳細については、Amazon EC2ユーザーガイドの「キャパシティー予約フリート」を参照してください。

次のコード例は、cancel-capacity-reservation を使用する方法を示しています。

AWS CLI

キャパシティ予約をキャンセルするには

次のcancel-capacity-reservation例では、指定されたキャパシティ予約をキャンセルします。

aws ec2 cancel-capacity-reservation \
    --capacity-reservation-id cr-1234abcd56EXAMPLE

出力:

{
    "Return": true
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「キャパシティ予約のキャンセル」を参照してください。

  • API 詳細については、「 コマンドリファレンスCancelCapacityReservation」の「」を参照してください。 AWS CLI

次の例は、cancel-conversion-task を使用する方法を説明しています。

AWS CLI

インスタンスまたはボリュームのアクティブな変換をキャンセルするには

この例では、タスク ID import-i-fh95npoc に関連付けられたアップロードをキャンセルします。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 cancel-conversion-task --conversion-task-id import-i-fh95npoc

  • API 詳細については、「 コマンドリファレンスCancelConversionTask」の「」を参照してください。 AWS CLI

次の例は、cancel-export-task を使用する方法を説明しています。

AWS CLI

アクティブなエクスポートタスクをキャンセルするには

この例では、タスク ID 0 export-i-fgelti7 のアクティブなエクスポートタスクをキャンセルします。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 cancel-export-task --export-task-id export-i-fgelt0i7

  • API 詳細については、「 コマンドリファレンスCancelExportTask」の「」を参照してください。 AWS CLI

次の例は、cancel-image-launch-permission を使用する方法を説明しています。

AWS CLI

を Amazon Web Services アカウントAMIと共有することをキャンセルするには

次のcancel-image-launch-permission例では、指定された AMIの起動許可からアカウントを削除します。

aws ec2 cancel-image-launch-permission \
    --image-id ami-0123456789example \
    --region us-east-1

出力:

{
    "Return": true
}

詳細については、「Amazon ユーザーガイド」の「 を Amazon Web Services アカウントAMIと共有することをキャンセルするEC2」を参照してください。

  • API 詳細については、「 コマンドリファレンスCancelImageLaunchPermission」の「」を参照してください。 AWS CLI

次のコード例は、cancel-import-task を使用する方法を示しています。

AWS CLI

インポートタスクをキャンセルするには

次のcancel-import-task例では、指定されたイメージのインポートタスクをキャンセルします。

aws ec2 cancel-import-task \
    --import-task-id import-ami-1234567890abcdef0

出力:

{
    "ImportTaskId": "import-ami-1234567890abcdef0",
    "PreviousState": "active",
    "State": "deleting"
}

  • API 詳細については、「 コマンドリファレンスCancelImportTask」の「」を参照してください。 AWS CLI

次の例は、cancel-reserved-instances-listing を使用する方法を説明しています。

AWS CLI

リザーブドインスタンスのリストをキャンセルするには

次のcancel-reserved-instances-listing例では、指定されたリザーブドインスタンスのリストをキャンセルします。

aws ec2 cancel-reserved-instances-listing \
    --reserved-instances-listing-id 5ec28771-05ff-4b9b-aa31-9e57dexample

次のコード例は、cancel-spot-fleet-requests を使用する方法を示しています。

AWS CLI

例 1: スポットフリートリクエストをキャンセルし、関連付けられたインスタンスを終了するには

次のcancel-spot-fleet-requests例では、スポットフリートリクエストをキャンセルし、関連付けられたオンデマンドインスタンスとスポットインスタンスを終了します。

aws ec2 cancel-spot-fleet-requests \
    --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \
    --terminate-instances

出力:

{
    "SuccessfulFleetRequests": [
        {
            "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
            "CurrentSpotFleetRequestState": "cancelled_terminating",
            "PreviousSpotFleetRequestState": "active"
        }
    ],
    "UnsuccessfulFleetRequests": []
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「スポットフリートリクエストのキャンセル」を参照してください。

例 2: 関連付けられたインスタンスを終了せずにスポットフリートリクエストをキャンセルするには

次のcancel-spot-fleet-requests例では、関連付けられたオンデマンドインスタンスとスポットインスタンスを終了せずに、スポットフリートリクエストをキャンセルします。

aws ec2 cancel-spot-fleet-requests \
    --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \
    --no-terminate-instances

出力:

{
    "SuccessfulFleetRequests": [
        {
            "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
            "CurrentSpotFleetRequestState": "cancelled_running",
            "PreviousSpotFleetRequestState": "active"
        }
    ],
    "UnsuccessfulFleetRequests": []
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「スポットフリートリクエストのキャンセル」を参照してください。

  • API 詳細については、「 コマンドリファレンスCancelSpotFleetRequests」の「」を参照してください。 AWS CLI

次の例は、cancel-spot-instance-requests を使用する方法を説明しています。

AWS CLI

スポットインスタンスリクエストをキャンセルするには

このコマンド例では、スポットインスタンスリクエストをキャンセルします。

コマンド:

aws ec2 cancel-spot-instance-requests --spot-instance-request-ids sir-08b93456

出力:

{
    "CancelledSpotInstanceRequests": [
        {
            "State": "cancelled",
            "SpotInstanceRequestId": "sir-08b93456"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスCancelSpotInstanceRequests」の「」を参照してください。 AWS CLI

次のコード例は、confirm-product-instance を使用する方法を示しています。

AWS CLI

製品インスタンスを確認するには

この例では、指定された製品コードが指定されたインスタンスに関連付けられているかどうかを決定します。

コマンド:

aws ec2 confirm-product-instance --product-code 774F4FF8 --instance-id i-1234567890abcdef0

出力:

{
  "OwnerId": "123456789012"
}

  • API 詳細については、「 コマンドリファレンスConfirmProductInstance」の「」を参照してください。 AWS CLI

次のコード例は、copy-fpga-image を使用する方法を示しています。

AWS CLI

Amazon FPGAイメージをコピーするには

この例では、指定された を us-east-1リージョンAFIから現在のリージョン () にコピーしますeu-west-1。

コマンド:

aws ec2 copy-fpga-image --name copy-afi --source-fpga-image-id afi-0d123e123bfc85abc --source-region us-east-1 --region eu-west-1

出力:

{
  "FpgaImageId": "afi-06b12350a123fbabc"
}

  • API 詳細については、「 コマンドリファレンスCopyFpgaImage」の「」を参照してください。 AWS CLI

次の例は、copy-image を使用する方法を説明しています。

AWS CLI

例 1: を別のリージョンにコピーAMIするには

次のコマンドcopy-image例では、指定された を us-west-2リージョンAMIから us-east-1リージョンにコピーし、簡単な説明を追加します。

aws ec2 copy-image \
    --region us-east-1 \
    --name ami-name \
    --source-region us-west-2 \
    --source-image-id ami-066877671789bd71b \
    --description "This is my copied image."

出力:

{
    "ImageId": "ami-0123456789abcdefg"
}

詳細については、「Amazon ユーザーガイド」の「 のコピーAMI」を参照してください。 EC2

例 2: AMIを別のリージョンにコピーし、バッキングスナップショットを暗号化するには

次のcopy-imageコマンドは、指定された を us-west-2リージョンAMIから現在の リージョンにコピーし、指定されたKMSキーを使用してバッキングスナップショットを暗号化します。

aws ec2 copy-image \
    --source-region us-west-2 \
    --name ami-name \
    --source-image-id ami-066877671789bd71b \
    --encrypted \
    --kms-key-id alias/my-kms-key

出力:

{
    "ImageId": "ami-0123456789abcdefg"
}

詳細については、「Amazon ユーザーガイド」の「 のコピーAMI」を参照してください。 EC2

例 3: をコピーするときにユーザー定義AMIタグを含めるには AMI

次のcopy-imageコマンドは、 --copy-image-tagsパラメータを使用して、 のコピー時にユーザー定義AMIタグをコピーしますAMI。

aws ec2 copy-image \
    --region us-east-1 \
    --name ami-name \
    --source-region us-west-2 \
    --source-image-id ami-066877671789bd71b \
    --description "This is my copied image."
    --copy-image-tags

出力:

{
    "ImageId": "ami-0123456789abcdefg"
}

詳細については、「Amazon ユーザーガイド」の「 のコピーAMI」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスCopyImage」の「」を参照してください。 AWS CLI

次のコード例は、copy-snapshot を使用する方法を示しています。

AWS CLI

例 1: スナップショットを別のリージョンにコピーするには

次のコマンドcopy-snapshot例では、指定されたスナップショットを us-west-2リージョンから us-east-1リージョンにコピーし、簡単な説明を追加します。

aws ec2 copy-snapshot \
    --region us-east-1 \
    --source-region us-west-2 \
    --source-snapshot-id snap-066877671789bd71b \
    --description "This is my copied snapshot."

出力:

{
    "SnapshotId": "snap-066877671789bd71b"
}

詳細については、「Amazon ユーザーガイド」の「Amazon EBSスナップショットのコピー」を参照してください。 EC2

例 2: 暗号化されていないスナップショットをコピーして新しいスナップショットを暗号化するには

次のcopy-snapshotコマンドは、指定された暗号化されていないスナップショットをus-west-2リージョンから現在のリージョンにコピーし、指定されたKMSキーを使用して新しいスナップショットを暗号化します。

aws ec2 copy-snapshot \
    --source-region us-west-2 \
    --source-snapshot-id snap-066877671789bd71b \
    --encrypted \
    --kms-key-id alias/my-kms-key

出力:

{
    "SnapshotId": "snap-066877671789bd71b"
}

詳細については、「Amazon ユーザーガイド」の「Amazon EBSスナップショットのコピー」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスCopySnapshot」の「」を参照してください。 AWS CLI

次の例は、create-capacity-reservation-fleet を使用する方法を説明しています。

AWS CLI

キャパシティー予約フリートを作成するには

次のcreate-capacity-reservation-fleet例では、リクエストで指定されたインスタンスタイプのキャパシティー予約フリートを、指定された合計ターゲット容量まで作成します。キャパシティー予約フリートがキャパシティーを予約するインスタンスの数は、リクエストで指定する合計ターゲット容量とインスタンスタイプの重みによって異なります。使用するインスタンスタイプと、指定された各インスタンスタイプの優先度を指定します。

aws ec2 create-capacity-reservation-fleet \
--total-target-capacity 24 \
--allocation-strategy prioritized \
--instance-match-criteria open \
--tenancy default \
--end-date 2022-12-31T23:59:59.000Z \
--instance-type-specifications file://instanceTypeSpecification.json

instanceTypeSpecification.json の内容:

[
    {
        "InstanceType": "m5.xlarge",
        "InstancePlatform": "Linux/UNIX",
        "Weight": 3.0,
        "AvailabilityZone":"us-east-1a",
        "EbsOptimized": true,
        "Priority" : 1
    }
]

出力:

{
    "Status": "submitted",
    "TotalFulfilledCapacity": 0.0,
    "CapacityReservationFleetId": "crf-abcdef01234567890",
    "TotalTargetCapacity": 24
}

キャパシティー予約フリートの詳細については、Amazon EC2ユーザーガイドの「キャパシティー予約フリート」を参照してください。

インスタンスタイプの重みと合計ターゲット容量の詳細については、「Amazon ユーザーガイド」の「インスタンスタイプの重み」と「合計ターゲット容量」を参照してください。 EC2

指定されたインスタンスタイプの優先度の指定の詳細については、「Amazon EC2ユーザーガイド」の「配分戦略」と「インスタンスタイプの優先度」を参照してください。 https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/crfleet-concepts.html#instance-priority

次のコード例は、create-capacity-reservation を使用する方法を示しています。

AWS CLI

例 1: キャパシティ予約を作成するには

次のcreate-capacity-reservation例では、アeu-west-1aベイラビリティーゾーンにキャパシティ予約を作成し、Linux/Unix オペレーティングシステムを実行している 3 つのt2.mediumインスタンスを起動できます。デフォルトでは、キャパシティ予約はオープンインスタンスの一致基準で作成され、エフェメラルストレージはサポートされず、手動でキャンセルするまでアクティブのままになります。

aws ec2 create-capacity-reservation \
    --availability-zone eu-west-1a \
    --instance-type t2.medium \
    --instance-platform Linux/UNIX \
    --instance-count 3

出力:

{
    "CapacityReservation": {
        "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
        "EndDateType": "unlimited",
        "AvailabilityZone": "eu-west-1a",
        "InstanceMatchCriteria": "open",
        "EphemeralStorage": false,
        "CreateDate": "2019-08-16T09:27:35.000Z",
        "AvailableInstanceCount": 3,
        "InstancePlatform": "Linux/UNIX",
        "TotalInstanceCount": 3,
        "State": "active",
        "Tenancy": "default",
        "EbsOptimized": false,
        "InstanceType": "t2.medium"
    }
}

例 2: 指定された日付/時刻に自動的に終了するキャパシティーの予約を作成するには

次のcreate-capacity-reservation例では、アeu-west-1aベイラビリティーゾーンにキャパシティ予約を作成し、Linux/Unix オペレーティングシステムを実行している 3 つのm5.largeインスタンスを起動できます。このキャパシティ予約は、08/31/2019 の 23:59:59 に自動的に終了します。

aws ec2 create-capacity-reservation \
    --availability-zone eu-west-1a \
    --instance-type m5.large \
    --instance-platform Linux/UNIX \
    --instance-count 3 \
    --end-date-type limited \
    --end-date 2019-08-31T23:59:59Z

出力:

{
    "CapacityReservation": {
        "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
        "EndDateType": "limited",
        "AvailabilityZone": "eu-west-1a",
        "EndDate": "2019-08-31T23:59:59.000Z",
        "InstanceMatchCriteria": "open",
        "EphemeralStorage": false,
        "CreateDate": "2019-08-16T10:15:53.000Z",
        "AvailableInstanceCount": 3,
        "InstancePlatform": "Linux/UNIX",
        "TotalInstanceCount": 3,
        "State": "active",
        "Tenancy": "default",
        "EbsOptimized": false,
        "InstanceType": "m5.large"
    }
}

例 3: ターゲットインスタンスの起動のみを受け入れるキャパシティーの予約を作成するには

次のcreate-capacity-reservation例では、ターゲットインスタンスの起動のみを受け入れるキャパシティ予約を作成します。

aws ec2 create-capacity-reservation \
    --availability-zone eu-west-1a \
    --instance-type m5.large \
    --instance-platform Linux/UNIX \
    --instance-count 3 \
    --instance-match-criteria targeted

出力:

{
    "CapacityReservation": {
        "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
        "EndDateType": "unlimited",
        "AvailabilityZone": "eu-west-1a",
        "InstanceMatchCriteria": "targeted",
        "EphemeralStorage": false,
        "CreateDate": "2019-08-16T10:21:57.000Z",
        "AvailableInstanceCount": 3,
        "InstancePlatform": "Linux/UNIX",
        "TotalInstanceCount": 3,
        "State": "active",
        "Tenancy": "default",
        "EbsOptimized": false,
        "InstanceType": "m5.large"
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「キャパシティ予約の作成」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateCapacityReservation」の「」を参照してください。 AWS CLI

次の例は、create-carrier-gateway を使用する方法を説明しています。

AWS CLI

キャリアゲートウェイを作成するには

次のcreate-carrier-gateway例では、指定された のキャリアゲートウェイを作成しますVPC。

aws ec2 create-carrier-gateway \
    --vpc-id vpc-0c529aEXAMPLE1111

出力:

{
    "CarrierGateway": {
        "CarrierGatewayId": "cagw-0465cdEXAMPLE1111",
        "VpcId": "vpc-0c529aEXAMPLE1111",
        "State": "pending",
        "OwnerId": "123456789012"
    }
}

詳細については、AWS 「Wavelength ユーザーガイド」の「キャリアゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateCarrierGateway」の「」を参照してください。 AWS CLI

次の例は、create-client-vpn-endpoint を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントを作成するには

次のcreate-client-vpn-endpoint例では、相互認証を使用するクライアントVPNエンドポイントを作成し、クライアントCIDRブロックの値を指定します。

aws ec2 create-client-vpn-endpoint \
    --client-cidr-block "172.31.0.0/16" \
    --server-certificate-arn arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE \
    --authentication-options Type=certificate-authentication,MutualAuthentication={ClientRootCertificateChainArn=arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE} \
    --connection-log-options Enabled=false

出力:

{
    "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
    "Status": {
        "Code": "pending-associate"
    },
    "DnsName": "cvpn-endpoint-123456789123abcde.prod.clientvpn.ap-south-1.amazonaws.com"
}

詳細については、クライアントAWS VPN管理者ガイドの「クライアントVPNエンドポイント」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateClientVpnEndpoint」の「」を参照してください。 AWS CLI

次のコード例は、create-client-vpn-route を使用する方法を示しています。

AWS CLI

クライアントVPNエンドポイントのルートを作成するには

次のcreate-client-vpn-route例では、クライアントVPNエンドポイントの指定されたサブネットのインターネット (0.0.0.0/0) にルートを追加します。

aws ec2 create-client-vpn-route \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --destination-cidr-block 0.0.0.0/0  \
    --target-vpc-subnet-id subnet-0123456789abcabca

出力:

{
    "Status": {
        "Code": "creating"
    }
}

詳細については、AWS クライアントVPN管理者ガイドの「ルート」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateClientVpnRoute」の「」を参照してください。 AWS CLI

次の例は、create-coip-cidr を使用する方法を説明しています。

AWS CLI

カスタマー所有 IP (CoIP) アドレスの範囲を作成するには

次のcreate-coip-cidr例では、指定された CoIP プールに指定された CoIP アドレスの範囲を作成します。

aws ec2 create-coip-cidr \
    --cidr 15.0.0.0/24 \
    --coip-pool-id ipv4pool-coip-1234567890abcdefg

出力:

{
    "CoipCidr": {
        "Cidr": "15.0.0.0/24",
        "CoipPoolId": "ipv4pool-coip-1234567890abcdefg",
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890"
    }
}

CoIP の詳細については、AWS Outposts ユーザーガイドの「カスタマー所有の IP アドレス」を参照してください 。

  • API 詳細については、「 コマンドリファレンスCreateCoipCidr」の「」を参照してください。 AWS CLI

次の例は、create-coip-pool を使用する方法を説明しています。

AWS CLI

カスタマー所有 IP (CoIP) アドレスのプールを作成するには

次のcreate-coip-pool例では、指定されたローカルゲートウェイルートテーブルに CoIP アドレスの CoIP プールを作成します。

aws ec2 create-coip-pool \
    --local-gateway-route-table-id lgw-rtb-abcdefg1234567890

出力:

{
    "CoipPool": {
        "PoolId": "ipv4pool-coip-1234567890abcdefg",
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890",
        "PoolArn": "arn:aws:ec2:us-west-2:123456789012:coip-pool/ipv4pool-coip-1234567890abcdefg"
    }
}

CoIP の詳細については、AWS Outposts ユーザーガイドの「カスタマー所有の IP アドレス」を参照してください 。

  • API 詳細については、「 コマンドリファレンスCreateCoipPool」の「」を参照してください。 AWS CLI

次の例は、create-customer-gateway を使用する方法を説明しています。

AWS CLI

カスタマーゲートウェイを作成するには

この例では、外部インターフェイス用に指定された IP アドレスを持つカスタマーゲートウェイを作成します。

コマンド:

aws ec2 create-customer-gateway --type ipsec.1 --public-ip 12.1.2.3 --bgp-asn 65534

出力:

{
    "CustomerGateway": {
        "CustomerGatewayId": "cgw-0e11f167",
        "IpAddress": "12.1.2.3",
        "State": "available",
        "Type": "ipsec.1",
        "BgpAsn": "65534"
    }
}

  • API 詳細については、「 コマンドリファレンスCreateCustomerGateway」の「」を参照してください。 AWS CLI

次の例は、create-default-subnet を使用する方法を説明しています。

AWS CLI

デフォルトサブネットを作成するには

この例では、アベイラビリティーゾーン にデフォルトサブネットを作成しますus-east-2a。

コマンド:

 aws ec2 create-default-subnet --availability-zone us-east-2a

{
   "Subnet": {
       "AvailabilityZone": "us-east-2a",
       "Tags": [],
       "AvailableIpAddressCount": 4091,
       "DefaultForAz": true,
       "Ipv6CidrBlockAssociationSet": [],
       "VpcId": "vpc-1a2b3c4d",
       "State": "available",
       "MapPublicIpOnLaunch": true,
       "SubnetId": "subnet-1122aabb",
       "CidrBlock": "172.31.32.0/20",
       "AssignIpv6AddressOnCreation": false
   }
 }

  • API 詳細については、「 コマンドリファレンスCreateDefaultSubnet」の「」を参照してください。 AWS CLI

次の例は、create-default-vpc を使用する方法を説明しています。

AWS CLI

デフォルトを作成するには VPC

この例では、デフォルトの を作成しますVPC。

コマンド:

aws ec2 create-default-vpc

出力:

{
   "Vpc": {
       "VpcId": "vpc-8eaae5ea",
       "InstanceTenancy": "default",
       "Tags": [],
       "Ipv6CidrBlockAssociationSet": [],
       "State": "pending",
       "DhcpOptionsId": "dopt-af0c32c6",
       "CidrBlock": "172.31.0.0/16",
       "IsDefault": true
   }
 }

  • API 詳細については、「 コマンドリファレンスCreateDefaultVpc」の「」を参照してください。 AWS CLI

次のコード例は、create-dhcp-options を使用する方法を示しています。

AWS CLI

DHCPオプションのセットを作成するには

次のcreate-dhcp-options例では、ドメイン名、ドメインネームサーバー、Net BIOSノードタイプを指定する一連のDHCPオプションを作成します。

aws ec2 create-dhcp-options \
    --dhcp-configuration \
        "Key=domain-name-servers,Values=10.2.5.1,10.2.5.2" \
        "Key=domain-name,Values=example.com" \
        "Key=netbios-node-type,Values=2"

出力:

{
    "DhcpOptions": {
        "DhcpConfigurations": [
            {
                "Key": "domain-name",
                "Values": [
                    {
                        "Value": "example.com"
                    }
                ]
            },
            {
                "Key": "domain-name-servers",
                "Values": [
                    {
                        "Value": "10.2.5.1"
                    },
                    {
                        "Value": "10.2.5.2"
                    }
                ]
            },
            {
                "Key": "netbios-node-type",
                "Values": [
                    {
                        "Value": "2"
                    }
                ]
            }
        ],
        "DhcpOptionsId": "dopt-06d52773eff4c55f3"
    }
}

  • API 詳細については、「 コマンドリファレンスCreateDhcpOptions」の「」を参照してください。 AWS CLI

次の例は、create-egress-only-internet-gateway を使用する方法を説明しています。

AWS CLI

Egress-Only インターネットゲートウェイを作成するには

この例では、指定された の Egress-Only インターネットゲートウェイを作成しますVPC。

コマンド:

aws ec2 create-egress-only-internet-gateway --vpc-id vpc-0c62a468

出力:

{
  "EgressOnlyInternetGateway": {
      "EgressOnlyInternetGatewayId": "eigw-015e0e244e24dfe8a",
      "Attachments": [
          {
              "State": "attached",
              "VpcId": "vpc-0c62a468"
          }
      ]
  }
}

次の例は、create-fleet を使用する方法を説明しています。

AWS CLI

例 1: EC2 スポットインスタンスをデフォルトの購入モデルとして起動するフリートを作成するには

次のcreate-fleet例では、EC2フリートの起動に必要な最小パラメータを使用してフリートを作成します。起動テンプレート、ターゲット容量、デフォルトの購入モデルです。起動テンプレートは、起動テンプレート ID とバージョン番号によって識別されます。フリートのターゲット容量は 2 インスタンスで、デフォルトの購入モデルは です。これによりspot、フリートは 2 つのスポットインスタンスを起動します。

EC2 フリートを作成するときは、 JSON ファイルを使用して起動するインスタンスに関する情報を指定します。

aws ec2 create-fleet \
    --cli-input-json file://file_name.json

file_name.json の内容：

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        }
    }
    ],
    "TargetCapacitySpecification": {
        "TotalTargetCapacity": 2,
        "DefaultTargetCapacityType": "spot"
    }
}

出力:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

例 2: デフォルトの購入モデルとしてオンデマンドインスタンスを起動するEC2フリートを作成するには

次のcreate-fleet例では、EC2フリートの起動に必要な最小パラメータを使用してフリートを作成します。起動テンプレート、ターゲット容量、デフォルトの購入モデルです。起動テンプレートは、起動テンプレート ID とバージョン番号によって識別されます。フリートのターゲット容量は 2 インスタンスで、デフォルトの購入モデルは です。これによりon-demand、フリートは 2 つのオンデマンドインスタンスを起動します。

EC2 フリートを作成するときは、 JSON ファイルを使用して起動するインスタンスに関する情報を指定します。

aws ec2 create-fleet \
    --cli-input-json file://file_name.json

file_name.json の内容：

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        }
    }
    ],
    "TargetCapacitySpecification": {
    "TotalTargetCapacity": 2,
    "DefaultTargetCapacityType": "on-demand"
    }
}

出力:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

例 3: オンデマンドインスタンスをプライマリ容量として起動するEC2フリートを作成するには

次のcreate-fleet例では、フリートの合計ターゲット容量を EC2 2 インスタンス、ターゲット容量を 1 オンデマンドインスタンスに指定するフリートを作成します。デフォルトの購入モデルは ですspot。フリートは、指定されたとおりに 1 つのオンデマンドインスタンスを起動しますが、合計ターゲット容量を満たすには、さらに 1 つのインスタンスを起動する必要があります。差の購入モデルは TotalTargetCapacity - OnDemandTargetCapacity = として計算されDefaultTargetCapacityType、フリートは 1 つのスポットインスタンスを起動します。

EC2 フリートを作成するときは、 JSON ファイルを使用して起動するインスタンスに関する情報を指定します。

aws ec2 create-fleet \
    --cli-input-json file://file_name.json

file_name.json の内容：

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        }
    }
    ],
    "TargetCapacitySpecification": {
        "TotalTargetCapacity": 2,
        "OnDemandTargetCapacity":1,
        "DefaultTargetCapacityType": "spot"
    }
}

出力:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

例 4: 最低料金の配分戦略を使用してスポットインスタンスを起動するEC2フリートを作成するには

スポットインスタンスの配分戦略を指定しない場合、デフォルト配分戦略である lowest-price が使用されます。次のcreate-fleet例では、 lowest-price配分戦略を使用してEC2フリートを作成します。起動テンプレートをオーバーライドする 3 つの起動条件は、インスタンスタイプが異なりますが、加重容量とサブネットは同じです。合計ターゲット容量は 2 インスタンスで、デフォルトの購入モデルは ですspot。EC2 フリートは、最低価格の起動仕様のインスタンスタイプを使用して 2 つのスポットインスタンスを起動します。

EC2 フリートを作成するときは、 JSON ファイルを使用して起動するインスタンスに関する情報を指定します。

aws ec2 create-fleet \
    --cli-input-json file://file_name.jsonContents of file_name.json::

{
    "LaunchTemplateConfigs": [
    {
        "LaunchTemplateSpecification": {
        "LaunchTemplateId": "lt-0e8c754449b27161c",
        "Version": "1"
        },
        "Overrides": [
            {
                "InstanceType": "c4.large",
                "WeightedCapacity": 1,
                "SubnetId": "subnet-a4f6c5d3"
            },
            {
                "InstanceType": "c3.large",
                "WeightedCapacity": 1,
                "SubnetId": "subnet-a4f6c5d3"
            },
            {
                "InstanceType": "c5.large",
                "WeightedCapacity": 1,
                "SubnetId": "subnet-a4f6c5d3"
            }
        ]
    }
    ],
    "TargetCapacitySpecification": {
        "TotalTargetCapacity": 2,
        "DefaultTargetCapacityType": "spot"
    }
}

出力:

{
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

  • API 詳細については、「 コマンドリファレンスCreateFleet」の「」を参照してください。 AWS CLI

次の例は、create-flow-logs を使用する方法を説明しています。

AWS CLI

例 1: フローログを作成するには

次のcreate-flow-logs例では、指定されたネットワークインターフェイスで拒否されたすべてのトラフィックをキャプチャするフローログを作成します。フローログは、指定されたIAMロールのアクセス許可を使用して Logs CloudWatch のロググループに配信されます。

aws ec2 create-flow-logs \
    --resource-type NetworkInterface \
    --resource-ids eni-11223344556677889 \
    --traffic-type REJECT \
    --log-group-name my-flow-logs \
    --deliver-logs-permission-arn arn:aws:iam::123456789101:role/publishFlowLogs

出力:

{
    "ClientToken": "so0eNA2uSHUNlHI0S2cJ305GuIX1CezaRdGtexample",
    "FlowLogIds": [
        "fl-12345678901234567"
    ],
    "Unsuccessful": []
}

詳細については、「Amazon VPCユーザーガイドVPC」の「フローログ」を参照してください。

例 2: カスタム形式でフローログを作成するには

次のcreate-flow-logs例では、指定された のすべてのトラフィックをキャプチャするフローログVPCを作成し、フローログを Amazon S3 バケットに配信します。--log-format パラメータにより、フローログレコードのカスタム形式が指定されます。Windows でこのコマンドを実行するには、一重引用符 (') を二重引用符 (") に変更します。

aws ec2 create-flow-logs \
    --resource-type VPC \
    --resource-ids vpc-00112233344556677 \
    --traffic-type ALL \
    --log-destination-type s3 \
    --log-destination arn:aws:s3:::flow-log-bucket/my-custom-flow-logs/ \
    --log-format '${version} ${vpc-id} ${subnet-id} ${instance-id} ${srcaddr} ${dstaddr} ${srcport} ${dstport} ${protocol} ${tcp-flags} ${type} ${pkt-srcaddr} ${pkt-dstaddr}'

詳細については、「Amazon VPCユーザーガイドVPC」の「フローログ」を参照してください。

例 3: 1 分の最大集約間隔でフローログを作成するには

次のcreate-flow-logs例では、指定された のすべてのトラフィックをキャプチャするフローログVPCを作成し、フローログを Amazon S3 バケットに配信します。--max-aggregation-interval パラメータは、最大集約間隔を 60 秒 (1 分) に指定します。

aws ec2 create-flow-logs \
    --resource-type VPC \
    --resource-ids vpc-00112233344556677 \
    --traffic-type ALL \
    --log-destination-type s3 \
    --log-destination arn:aws:s3:::flow-log-bucket/my-custom-flow-logs/ \
    --max-aggregation-interval 60

詳細については、「Amazon VPCユーザーガイドVPC」の「フローログ」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateFlowLogs」の「」を参照してください。 AWS CLI

次のコード例は、create-fpga-image を使用する方法を示しています。

AWS CLI

Amazon FPGAイメージを作成するには

この例では、指定されたバケット内の指定された tarball AFIから を作成します。

コマンド:

aws ec2 create-fpga-image --name my-afi --description test-afi --input-storage-location Bucket=my-fpga-bucket,Key=dcp/17_12_22-103226.Developer_CL.tar --logs-storage-location Bucket=my-fpga-bucket,Key=logs

出力:

{
  "FpgaImageId": "afi-0d123e123bfc85abc",
  "FpgaImageGlobalId": "agfi-123cb27b5e84a0abc"
}

  • API 詳細については、「 コマンドリファレンスCreateFpgaImage」の「」を参照してください。 AWS CLI

次の例は、create-image を使用する方法を説明しています。

AWS CLI

例 1: Amazon EBS-backed インスタンスAMIから を作成するには

次のcreate-image例では、指定されたインスタンスAMIから を作成します。

aws ec2 create-image \
    --instance-id i-1234567890abcdef0 \
    --name "My server" \
    --description "An AMI for my server"

出力:

{
    "ImageId": "ami-abcdef01234567890"
}

のブロックデバイスマッピングの指定の詳細についてはAMI、Amazon ユーザーガイドの「 のブロックデバイスマッピングの指定AMI」を参照してください。 EC2

例 2: 再起動せずに Amazon EBS-backed インスタンスAMIから を作成するには

次のcreate-image例では、 を作成しAMI、--no-reboot パラメータを設定して、イメージが作成される前にインスタンスが再起動されないようにします。

aws ec2 create-image \
    --instance-id i-1234567890abcdef0 \
    --name "My server" \
    --no-reboot

出力:

{
    "ImageId": "ami-abcdef01234567890"
}

のブロックデバイスマッピングの指定の詳細についてはAMI、Amazon ユーザーガイドの「 のブロックデバイスマッピングの指定AMI」を参照してください。 EC2

例 3: 作成時に AMIおよび スナップショットにタグを付けるには

次のcreate-image例では、 を作成しAMI、 とスナップショットAMIに同じタグを付けます。 cost-center=cc123

aws ec2 create-image \
    --instance-id i-1234567890abcdef0 \
    --name "My server" \
    --tag-specifications "ResourceType=image,Tags=[{Key=cost-center,Value=cc123}]" "ResourceType=snapshot,Tags=[{Key=cost-center,Value=cc123}]"

出力:

{
    "ImageId": "ami-abcdef01234567890"
}

作成時のリソースのタグ付けの詳細については、「Amazon EC2 ユーザーガイド」の「リソース作成時にタグを追加する」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateImage」の「」を参照してください。 AWS CLI

次のコード例は、create-instance-connect-endpoint を使用する方法を示しています。

AWS CLI

EC2 Instance Connect Endpoint を作成するには

次のcreate-instance-connect-endpoint例では、指定されたサブネットに EC2 Instance Connect Endpoint を作成します。

aws ec2 create-instance-connect-endpoint \
    --region us-east-1 \
    --subnet-id subnet-0123456789example

出力:

{
    "VpcId": "vpc-0123abcd",
    "InstanceConnectEndpointArn": "arn:aws:ec2:us-east-1:111111111111:instance-connect-endpoint/eice-0123456789example",
    "AvailabilityZone": "us-east-1a",
    "NetworkInterfaceIds": [
        "eni-0123abcd"
    ],
    "PreserveClientIp": true,
    "Tags": [],
    "FipsDnsName": "eice-0123456789example.0123abcd.fips.ec2-instance-connect-endpoint.us-east-1.amazonaws.com",
    "StateMessage": "",
    "State": "create-complete",
    "DnsName": "eice-0123456789example.0123abcd.ec2-instance-connect-endpoint.us-east-1.amazonaws.com",
    "SubnetId": "subnet-0123abcd",
    "OwnerId": "111111111111",
    "SecurityGroupIds": [
        "sg-0123abcd"
    ],
    "InstanceConnectEndpointId": "eice-0123456789example",
    "CreatedAt": "2023-04-07T15:43:53.000Z"
}

詳細については、「Amazon ユーザーガイド」のEC2「インスタンス接続エンドポイントの作成」を参照してください。 EC2

次の例は、create-instance-event-window を使用する方法を説明しています。

AWS CLI

例 1: 時間範囲を持つイベントウィンドウを作成するには

次のcreate-instance-event-window例では、時間範囲を持つイベントウィンドウを作成します。また、cron-expression パラメータを指定することはできません。

aws ec2 create-instance-event-window \
    --region us-east-1 \
    --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \
    --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
    --name myEventWindowName

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "TimeRanges": [
            {
                "StartWeekDay": "monday",
                "StartHour": 2,
                "EndWeekDay": "wednesday",
                "EndHour": 8
            }
        ],
        "Name": "myEventWindowName",
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 2: cron 式を使用してイベントウィンドウを作成するには

次のcreate-instance-event-window例では、cron 式を使用してイベントウィンドウを作成します。また、time-range パラメータを指定することはできません。

aws ec2 create-instance-event-window \
    --region us-east-1 \
    --cron-expression "* 21-23 * * 2,3" \
    --tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
    --name myEventWindowName

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateInstanceEventWindow」の「」を参照してください。 AWS CLI

次の例は、create-instance-export-task を使用する方法を説明しています。

AWS CLI

インスタンスをエクスポートするには

このコマンド例では、インスタンス i-1234567890abcdef0 を Amazon S3 バケット myexportbucket にエクスポートするタスクを作成します。

コマンド:

aws ec2 create-instance-export-task --description "RHEL5 instance" --instance-id i-1234567890abcdef0 --target-environment vmware --export-to-s3-task DiskImageFormat=vmdk,ContainerFormat=ova,S3Bucket=myexportbucket,S3Prefix=RHEL5

出力:

{
    "ExportTask": {
        "State": "active",
        "InstanceExportDetails": {
            "InstanceId": "i-1234567890abcdef0",
            "TargetEnvironment": "vmware"
        },
        "ExportToS3Task": {
            "S3Bucket": "myexportbucket",
            "S3Key": "RHEL5export-i-fh8sjjsq.ova",
            "DiskImageFormat": "vmdk",
            "ContainerFormat": "ova"
        },
        "Description": "RHEL5 instance",
        "ExportTaskId": "export-i-fh8sjjsq"
    }
}

  • API 詳細については、「 コマンドリファレンスCreateInstanceExportTask」の「」を参照してください。 AWS CLI

次の例は、create-internet-gateway を使用する方法を説明しています。

AWS CLI

インターネットゲートウェイを作成するには

次のcreate-internet-gateway例では、タグ を使用してインターネットゲートウェイを作成しますName=my-igw。

aws ec2 create-internet-gateway \
    --tag-specifications ResourceType=internet-gateway,Tags=[{Key=Name,Value=my-igw}]

出力:

{
    "InternetGateway": {
        "Attachments": [],
        "InternetGatewayId": "igw-0d0fb496b3994d755",
        "OwnerId": "123456789012",
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-igw"
            }
        ]
    }
}

詳細については、「Amazon VPCユーザーガイド」の「インターネットゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateInternetGateway」の「」を参照してください。 AWS CLI

次の例は、create-ipam-pool を使用する方法を説明しています。

AWS CLI

IPAM プールを作成するには

次のcreate-ipam-pool例では、 IPAM プールを作成します。

(Linux):

aws ec2 create-ipam-pool \
    --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \
    --address-family ipv4 \
    --auto-import \
    --allocation-min-netmask-length 16 \
    --allocation-max-netmask-length 26 \
    --allocation-default-netmask-length 24 \
    --allocation-resource-tags "Key=Environment,Value=Preprod" \
    --tag-specifications 'ResourceType=ipam-pool,Tags=[{Key=Name,Value="Preprod pool"}]'

(Windows):

aws ec2 create-ipam-pool ^
    --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^
    --address-family ipv4 ^
    --auto-import ^
    --allocation-min-netmask-length 16 ^
    --allocation-max-netmask-length 26 ^
    --allocation-default-netmask-length 24 ^
    --allocation-resource-tags "Key=Environment,Value=Preprod" ^
    --tag-specifications ResourceType=ipam-pool,Tags=[{Key=Name,Value="Preprod pool"}]

出力:

{
    "IpamPool": {
        "OwnerId": "123456789012",
        "IpamPoolId": "ipam-pool-0533048da7d823723",
        "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0533048da7d823723",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38",
        "IpamScopeType": "private",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
        "IpamRegion": "us-east-1",
        "Locale": "None",
        "PoolDepth": 1,
        "State": "create-in-progress",
        "AutoImport": true,
        "AddressFamily": "ipv4",
        "AllocationMinNetmaskLength": 16,
        "AllocationMaxNetmaskLength": 26,
        "AllocationDefaultNetmaskLength": 24,
        "AllocationResourceTags": [
            {
                "Key": "Environment",
                "Value": "Preprod"
            }
        ],
        "Tags": [
            {
                "Key": "Name",
                "Value": "Preprod pool"
            }
        ]
    }
}

詳細については、「Amazon VPCIPAMユーザーガイド」の「IP アドレスプロビジョニングの計画」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateIpamPool」の「」を参照してください。 AWS CLI

次のコード例は、create-ipam-resource-discovery を使用する方法を示しています。

AWS CLI

リソース検出を作成するには

この例では、他の組織のIPAM管理者が組織内のリソースの IP アドレスを管理およびモニタリングできるように、リソース検出を作成して別の AWS 組織のIPAM管理者と共有したい委任管理者です。

[重要]

この例では、 オプション--regionと --operating-regionsオプションの両方が含まれています。これは、オプションはオプションですが、リソース検出を と正常に統合するために特定の方法で設定する必要があるためですIPAM。* はIPAM、検出するリソースがあるリージョンと一致する--operating-regions必要があります。IP アドレスIPAMを管理したくないリージョン (コンプライアンス上の理由など) がある場合は、それらを含めないでください。* は、関連付けIPAMる のホームリージョンと一致する--region必要があります。リソース検出IPAMは、 が作成されたのと同じリージョンで作成する必要があります。例えば、IPAM関連付ける が us-east-1 で作成された場合は、 リクエスト--region us-east-1に を含めます。 --regionおよび --operating-regionsオプションの両方が、コマンドを実行しているリージョンにデフォルトで含まれます。

この例では、 と統合する IPAM の運用リージョンにはus-west-1、、us-west-2、および が含まれますap-south-1。リソース検出を作成するときは、 us-west-1ではなく でリソース IP アドレスを検出IPAMしますus-west-2ap-south-1。そのため、リクエスト--operating-regions RegionName='us-west-1' RegionName='us-west-2'にのみ を含めます。

次のcreate-ipam-resource-discovery例では、 IPAMリソース検出を作成します。

aws ec2 create-ipam-resource-discovery \
    --description 'Example-resource-discovery' \
    --tag-specifications 'ResourceType=ipam-resource-discovery,Tags=[{Key=cost-center,Value=cc123}]' \
    --operating-regions RegionName='us-west-1' RegionName='us-west-2' \
    --region us-east-1

出力:

{
    "IpamResourceDiscovery":{
        "OwnerId": "149977607591",
        "IpamResourceDiscoveryId": "ipam-res-disco-0257046d8aa78b8bc",
        "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0257046d8aa78b8bc",
        "IpamResourceDiscoveryRegion": "us-east-1",
        "Description": "'Example-resource-discovery'",
        "OperatingRegions":[
            {"RegionName": "us-west-1"},
            {"RegionName": "us-west-2"},
            {"RegionName": "us-east-1"}
        ],
        "IsDefault": false,
        "State": "create-in-progress",
        "Tags": [
            {
                "Key": "cost-center",
                "Value": "cc123"
            }
        ]
}

リソース検出を作成したら、別のIPAM委任された管理者と共有できます。これは、 で実行できますcreate-resource-share。詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスCreateIpamResourceDiscovery」の「」を参照してください。 AWS CLI

次のコード例は、create-ipam-scope を使用する方法を示しています。

AWS CLI

IPAMスコープを作成するには

次のcreate-ipam-scope例では、 IPAMスコープを作成します。

(Linux):

aws ec2 create-ipam-scope \
    --ipam-id ipam-08440e7a3acde3908 \
    --description "Example description" \
    --tag-specifications 'ResourceType=ipam-scope,Tags=[{Key=Name,Value="Example name value"}]'

(Windows):

aws ec2 create-ipam-scope ^
    --ipam-id ipam-08440e7a3acde3908 ^
    --description "Example description" ^
    --tag-specifications ResourceType=ipam-scope,Tags=[{Key=Name,Value="Example name value"}]

出力:

{
    "IpamScope": {
        "OwnerId": "123456789012",
        "IpamScopeId": "ipam-scope-01c1ebab2b63bd7e4",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-01c1ebab2b63bd7e4",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
        "IpamRegion": "us-east-1",
        "IpamScopeType": "private",
        "IsDefault": false,
        "Description": "Example description",
        "PoolCount": 0,
        "State": "create-in-progress",
        "Tags": [
            {
                "Key": "Name",
                "Value": "Example name value"
            }
        ]
    }
}

詳細については、「Amazon VPC IPAM ユーザーガイド」の「追加のスコープを作成する」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateIpamScope」の「」を参照してください。 AWS CLI

次の例は、create-ipam を使用する方法を説明しています。

AWS CLI

を作成するには IPAM

次のcreate-ipam例では、 を作成しますIPAM。

(Linux):

aws ec2 create-ipam \
    --description "Example description" \
    --operating-regions "RegionName=us-east-2" "RegionName=us-west-1" \
    --tag-specifications 'ResourceType=ipam,Tags=[{Key=Name,Value=ExampleIPAM}]'

(Windows):

aws ec2 create-ipam ^
    --description "Example description" ^
    --operating-regions "RegionName=us-east-2" "RegionName=us-west-1" ^
    --tag-specifications ResourceType=ipam,Tags=[{Key=Name,Value=ExampleIPAM}]

出力:

{
    "Ipam": {
        "OwnerId": "123456789012",
        "IpamId": "ipam-036486dfa6af58ee0",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-036486dfa6af58ee0",
        "IpamRegion": "us-east-1",
        "PublicDefaultScopeId": "ipam-scope-071b8042b0195c183",
        "PrivateDefaultScopeId": "ipam-scope-0807405dece705a30",
        "ScopeCount": 2,
        "OperatingRegions": [
            {
                "RegionName": "us-east-2"
            },
            {
                "RegionName": "us-west-1"
            },
            {
                "RegionName": "us-east-1"
            }
        ],
        "State": "create-in-progress",
        "Tags": [
            {
                "Key": "Name",
                "Value": "ExampleIPAM"
            }
        ]
    }
}

詳細については、「Amazon ユーザーガイド」のIPAM「 の作成」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスCreateIpam」の「」を参照してください。 AWS CLI

次のコード例は、create-key-pair を使用する方法を示しています。

AWS CLI

キーペアを作成するには

この例では、MyKeyPair という名前のキーペアが作成されます。

コマンド:

aws ec2 create-key-pair --key-name MyKeyPair

出力は、プライベートキーとキーフィンガープリントASCIIのバージョンです。キーはファイルに保存する必要があります。

詳細については、「AWS コマンドラインインターフェイスユーザーガイド」でキーペアの使用方法を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateKeyPair」の「」を参照してください。 AWS CLI

次の例は、create-launch-template-version を使用する方法を説明しています。

AWS CLI

起動テンプレートのバージョンを作成するには

この例では、起動テンプレートのバージョン 1 に基づいて新しい起動テンプレートバージョンを作成し、別の AMI ID を指定します。

コマンド:

aws ec2 create-launch-template-version --launch-template-id lt-0abcd290751193123 --version-description WebVersion2 --source-version 1 --launch-template-data '{"ImageId":"ami-c998b6b2"}'

出力:

{
  "LaunchTemplateVersion": {
      "VersionDescription": "WebVersion2",
      "LaunchTemplateId": "lt-0abcd290751193123",
      "LaunchTemplateName": "WebServers",
      "VersionNumber": 2,
      "CreatedBy": "arn:aws:iam::123456789012:root",
      "LaunchTemplateData": {
          "ImageId": "ami-c998b6b2",
          "InstanceType": "t2.micro",
          "NetworkInterfaces": [
              {
                  "Ipv6Addresses": [
                      {
                          "Ipv6Address": "2001:db8:1234:1a00::123"
                      }
                  ],
                  "DeviceIndex": 0,
                  "SubnetId": "subnet-7b16de0c",
                  "AssociatePublicIpAddress": true
              }
          ]
      },
      "DefaultVersion": false,
      "CreateTime": "2017-12-01T13:35:46.000Z"
  }
}

  • API 詳細については、「 コマンドリファレンスCreateLaunchTemplateVersion」の「」を参照してください。 AWS CLI

次の例は、create-launch-template を使用する方法を説明しています。

AWS CLI

例 1: 起動テンプレートを作成するには

次のcreate-launch-template例では、インスタンス を起動するサブネットを指定する起動テンプレートを作成し、インスタンスにパブリック IP アドレスと IPv6 アドレスを割り当て、インスタンスのタグを作成します。

aws ec2 create-launch-template \
    --launch-template-name TemplateForWebServer \
    --version-description WebVersion1 \
    --launch-template-data '{"NetworkInterfaces":[{"AssociatePublicIpAddress":true,"DeviceIndex":0,"Ipv6AddressCount":1,"SubnetId":"subnet-7b16de0c"}],"ImageId":"ami-8c1be5f6","InstanceType":"t2.small","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"purpose","Value":"webserver"}]}]}'

出力:

{
    "LaunchTemplate": {
        "LatestVersionNumber": 1,
        "LaunchTemplateId": "lt-01238c059e3466abc",
        "LaunchTemplateName": "TemplateForWebServer",
        "DefaultVersionNumber": 1,
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2019-01-27T09:13:24.000Z"
    }
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「起動テンプレートからのインスタンスの起動」を参照してください。JSON形式のパラメータの引用については、 AWS コマンドラインインターフェイスユーザーガイドの「文字列の引用」を参照してください。

例 2: Amazon EC2 Auto Scaling の起動テンプレートを作成するには

次のcreate-launch-template例では、複数のタグとブロックデバイスマッピングを使用して起動テンプレートを作成し、インスタンスの起動時に追加のEBSボリュームを指定します。VPC Auto Scaling グループGroupsがインスタンスを起動する のセキュリティグループに対応する の値を指定します。Auto Scaling グループのプロパティとして VPCおよび サブネットを指定します。

aws ec2 create-launch-template \
    --launch-template-name TemplateForAutoScaling \
    --version-description AutoScalingVersion1 \
    --launch-template-data '{"NetworkInterfaces":[{"DeviceIndex":0,"AssociatePublicIpAddress":true,"Groups":["sg-7c227019,sg-903004f8"],"DeleteOnTermination":true}],"ImageId":"ami-b42209de","InstanceType":"m4.large","TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"environment","Value":"production"},{"Key":"purpose","Value":"webserver"}]},{"ResourceType":"volume","Tags":[{"Key":"environment","Value":"production"},{"Key":"cost-center","Value":"cc123"}]}],"BlockDeviceMappings":[{"DeviceName":"/dev/sda1","Ebs":{"VolumeSize":100}}]}' --region us-east-1

出力:

{
    "LaunchTemplate": {
        "LatestVersionNumber": 1,
        "LaunchTemplateId": "lt-0123c79c33a54e0abc",
        "LaunchTemplateName": "TemplateForAutoScaling",
        "DefaultVersionNumber": 1,
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2019-04-30T18:16:06.000Z"
    }
}

詳細については、「Amazon Auto Scaling ユーザーガイド」の「Auto Scaling グループの起動テンプレートの作成」を参照してください。 EC2 Auto Scaling JSON形式のパラメータの引用については、 AWS コマンドラインインターフェイスユーザーガイドの「文字列の引用」を参照してください。

例 3: EBSボリュームの暗号化を指定する起動テンプレートを作成するには

次のcreate-launch-template例では、暗号化されていないスナップショットから作成された暗号化されたEBSボリュームを含む起動テンプレートを作成します。また、作成時にボリュームにタグ付けしています。暗号化がデフォルトで無効になっている場合、次の例のように "Encrypted" オプションを指定する必要があります。"KmsKeyId" オプションを使用してカスタマー管理の を指定する場合はCMK、デフォルトで暗号化が有効になっている場合でも、 "Encrypted"オプションを指定する必要があります。

aws ec2 create-launch-template \
  --launch-template-name TemplateForEncryption \
  --launch-template-data file://config.json

config.json の内容:

{
    "BlockDeviceMappings":[
        {
            "DeviceName":"/dev/sda1",
            "Ebs":{
                "VolumeType":"gp2",
                "DeleteOnTermination":true,
                "SnapshotId":"snap-066877671789bd71b",
                "Encrypted":true,
                "KmsKeyId":"arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef"
            }
        }
    ],
    "ImageId":"ami-00068cd7555f543d5",
    "InstanceType":"c5.large",
    "TagSpecifications":[
        {
            "ResourceType":"volume",
            "Tags":[
                {
                    "Key":"encrypted",
                    "Value":"yes"
                }
            ]
        }
    ]
}

出力:

{
    "LaunchTemplate": {
        "LatestVersionNumber": 1,
        "LaunchTemplateId": "lt-0d5bd51bcf8530abc",
        "LaunchTemplateName": "TemplateForEncryption",
        "DefaultVersionNumber": 1,
        "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
        "CreateTime": "2020-01-07T19:08:36.000Z"
    }
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「スナップショットからの Amazon EBSボリュームの復元」および「デフォルトでの暗号化」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateLaunchTemplate」の「」を参照してください。 AWS CLI

次の例は、create-local-gateway-route-table-virtual-interface-group-association を使用する方法を説明しています。

AWS CLI

ローカルゲートウェイルートテーブルを仮想インターフェイス (VIFs) グループに関連付けるには

次のcreate-local-gateway-route-table-virtual-interface-group-association例では、指定されたローカルゲートウェイルートテーブルとVIFグループ間の関連付けを作成します。

aws ec2 create-local-gateway-route-table-virtual-interface-group-association \
    --local-gateway-route-table-id lgw-rtb-exampleidabcd1234 \
    --local-gateway-virtual-interface-group-id lgw-vif-grp-exampleid0123abcd

出力:

{
    "LocalGatewayRouteTableVirtualInterfaceGroupAssociation": {
        "LocalGatewayRouteTableVirtualInterfaceGroupAssociationId": "lgw-vif-grp-assoc-exampleid12345678",
        "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-exampleid0123abcd",
        "LocalGatewayId": "lgw-exampleid11223344",
        "LocalGatewayRouteTableId": "lgw-rtb-exampleidabcd1234",
        "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-exampleidabcd1234",
        "OwnerId": "111122223333",
        "State": "pending",
        "Tags": []
    }
}

詳細については、VIF「Outposts ユーザーガイド」の「グループの関連付けAWS 」を参照してください。

次のコード例は、create-local-gateway-route-table-vpc-association を使用する方法を示しています。

AWS CLI

VPCをルートテーブルに関連付けるには

次のcreate-local-gateway-route-table-vpc-association例では、指定された を指定されたローカルゲートウェイルートテーブルVPCに関連付けます。

aws ec2 create-local-gateway-route-table-vpc-association \
    --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE \
    --vpc-id vpc-07ef66ac71EXAMPLE

出力:

{
    "LocalGatewayRouteTableVpcAssociation": {
        "LocalGatewayRouteTableVpcAssociationId": "lgw-vpc-assoc-0ee765bcc8EXAMPLE",
        "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE",
        "LocalGatewayId": "lgw-09b493aa7cEXAMPLE",
        "VpcId": "vpc-07ef66ac71EXAMPLE",
        "State": "associated"
    }
}

次のコード例は、create-local-gateway-route-table を使用する方法を示しています。

AWS CLI

ローカルゲートウェイルートテーブルを作成するには

次のcreate-local-gateway-route-table例では、ダイレクトルーティングモードでローカルゲートウェイVPCルートテーブルを作成します。

aws ec2 create-local-gateway-route-table \
    --local-gateway-id lgw-1a2b3c4d5e6f7g8h9 \
    --mode direct-vpc-routing

出力:

{
    "LocalGatewayRouteTable": {
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890",
        "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-abcdefg1234567890",
        "LocalGatewayId": "lgw-1a2b3c4d5e6f7g8h9",
        "OutpostArn": "arn:aws:outposts:us-west-2:111122223333:outpost/op-021345abcdef67890",
        "OwnerId": "111122223333",
        "State": "pending",
        "Tags": [],
        "Mode": "direct-vpc-routing"
    }
}

詳細については、「AWS Outposts ユーザーガイド」の「ローカルゲートウェイテーブル」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateLocalGatewayRouteTable」の「」を参照してください。 AWS CLI

次のコード例は、create-local-gateway-route を使用する方法を示しています。

AWS CLI

ローカルゲートウェイルートテーブルの静的ルートを作成するには

次のcreate-local-gateway-route例では、指定されたローカルゲートウェイルートテーブルに指定されたルートを作成します。

aws ec2 create-local-gateway-route \
    --destination-cidr-block 0.0.0.0/0 \
    --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE

出力:

{
    "Route": {
        "DestinationCidrBlock": "0.0.0.0/0",
        "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE",
        "Type": "static",
        "State": "deleted",
        "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE"
    }
}

  • API 詳細については、「 コマンドリファレンスCreateLocalGatewayRoute」の「」を参照してください。 AWS CLI

次のコード例は、create-managed-prefix-list を使用する方法を示しています。

AWS CLI

プレフィックスリストを作成するには

次のcreate-managed-prefix-list例では、最大 10 個のエントリを持つIPv4プレフィックスリストを作成し、プレフィックスリストに 2 個のエントリを作成します。

aws ec2 create-managed-prefix-list \
    --address-family IPv4 \
    --max-entries 10 \
    --entries Cidr=10.0.0.0/16,Description=vpc-a Cidr=10.2.0.0/16,Description=vpc-b \
    --prefix-list-name vpc-cidrs

出力:

{
    "PrefixList": {
        "PrefixListId": "pl-0123456abcabcabc1",
        "AddressFamily": "IPv4",
        "State": "create-in-progress",
        "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1",
        "PrefixListName": "vpc-cidrs",
        "MaxEntries": 10,
        "Version": 1,
        "Tags": [],
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon VPCユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateManagedPrefixList」の「」を参照してください。 AWS CLI

次のコード例は、create-nat-gateway を使用する方法を示しています。

AWS CLI

例 1: パブリックNATゲートウェイを作成するには

次のcreate-nat-gateway例では、指定されたサブネットにパブリックNATゲートウェイを作成し、Elastic IP アドレスを指定された割り当て ID に関連付けます。パブリックNATゲートウェイを作成するときは、Elastic IP アドレスを関連付ける必要があります。

aws ec2 create-nat-gateway \
    --subnet-id subnet-0250c25a1fEXAMPLE \
    --allocation-id eipalloc-09ad461b0dEXAMPLE

出力:

{
    "NatGateway": {
        "CreateTime": "2021-12-01T22:22:38.000Z",
        "NatGatewayAddresses": [
            {
                "AllocationId": "eipalloc-09ad461b0dEXAMPLE"
            }
        ],
        "NatGatewayId": "nat-0c61bf8a12EXAMPLE",
        "State": "pending",
        "SubnetId": "subnet-0250c25a1fEXAMPLE",
        "VpcId": "vpc-0a60eb65b4EXAMPLE",
        "ConnectivityType": "public"
    }
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

例 2: プライベートNATゲートウェイを作成するには

次のcreate-nat-gateway例では、指定されたサブネットにプライベートNATゲートウェイを作成します。プライベートNATゲートウェイには、関連付けられた Elastic IP アドレスがありません。

aws ec2 create-nat-gateway \
    --subnet-id subnet-0250c25a1fEXAMPLE \
    --connectivity-type private

出力:

{
    "NatGateway": {
        "CreateTime": "2021-12-01T22:26:00.000Z",
        "NatGatewayAddresses": [
            {}
        ],
        "NatGatewayId": "nat-011b568379EXAMPLE",
        "State": "pending",
        "SubnetId": "subnet-0250c25a1fEXAMPLE",
        "VpcId": "vpc-0a60eb65b4EXAMPLE",
        "ConnectivityType": "private"
    }
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateNatGateway」の「」を参照してください。 AWS CLI

次のコード例は、create-network-acl-entry を使用する方法を示しています。

AWS CLI

ネットワークACLエントリを作成するには

この例では、指定されたネットワーク のエントリを作成しますACL。このルールは、UDPポート 53 () 上の任意のIPv4アドレス (0.0.0.0/0DNS) から、関連するサブネットへの進入トラフィックを許可します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 create-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 100 --protocol udp --port-range From=53,To=53 --cidr-block 0.0.0.0/0 --rule-action allow

この例では、TCPポート 80 () の任意のIPv6アドレス (::/0) からの進入トラフィックACLを許可する、指定されたネットワークのルールを作成しますHTTP。

コマンド:

aws ec2 create-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 120 --protocol tcp --port-range From=80,To=80 --ipv6-cidr-block ::/0 --rule-action allow

  • API 詳細については、「 コマンドリファレンスCreateNetworkAclEntry」の「」を参照してください。 AWS CLI

次のコード例は、create-network-acl を使用する方法を示しています。

AWS CLI

ネットワークを作成するには ACL

この例では、指定された ACLのネットワークを作成しますVPC。

コマンド:

aws ec2 create-network-acl --vpc-id vpc-a01106c2

出力:

{
    "NetworkAcl": {
        "Associations": [],
        "NetworkAclId": "acl-5fb85d36",
        "VpcId": "vpc-a01106c2",
        "Tags": [],
        "Entries": [
            {
                "CidrBlock": "0.0.0.0/0",
                "RuleNumber": 32767,
                "Protocol": "-1",
                "Egress": true,
                "RuleAction": "deny"
            },
            {
                "CidrBlock": "0.0.0.0/0",
                "RuleNumber": 32767,
                "Protocol": "-1",
                "Egress": false,
                "RuleAction": "deny"
            }
        ],
        "IsDefault": false
    }
}

  • API 詳細については、「 コマンドリファレンスCreateNetworkAcl」の「」を参照してください。 AWS CLI

次の例は、create-network-insights-access-scope を使用する方法を説明しています。

AWS CLI

ネットワークアクセススコープを作成するには

次のcreate-network-insights-access-scope例では、ネットワークアクセススコープを作成します。

aws ec2 create-network-insights-access-scope \
    --cli-input-json file://access-scope-file.json

access-scope-file.json の内容:

{
    "MatchPaths": [
        {
            "Source": {
                "ResourceStatement": {
                    "Resources": [
                        "vpc-abcd12e3"
                    ]
                }
            }
         }
    ],
    "ExcludePaths": [
        {
            "Source": {
                "ResourceStatement": {
                    "ResourceTypes": [
                        "AWS::EC2::InternetGateway"
                    ]
                }
            }
        }
    ]
}

出力:

{
    "NetworkInsightsAccessScope": {
        "NetworkInsightsAccessScopeId": "nis-123456789abc01234",
        "NetworkInsightsAccessScopeArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope/nis-123456789abc01234",
        "CreatedDate": "2022-01-25T19:20:28.796000+00:00",
        "UpdatedDate": "2022-01-25T19:20:28.797000+00:00"
    },
    "NetworkInsightsAccessScopeContent": {
        "NetworkInsightsAccessScopeId": "nis-123456789abc01234",
        "MatchPaths": [
            {
                "Source": {
                    "ResourceStatement": {
                        "Resources": [
                            "vpc-abcd12e3"
                        ]
                    }
                }
            }
        ],
        "ExcludePaths": [
            {
                "Source": {
                    "ResourceStatement": {
                        "ResourceTypes": [
                            "AWS::EC2::InternetGateway"
                        ]
                    }
                }
            }
        ]
    }
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次の例は、create-network-insights-path を使用する方法を説明しています。

AWS CLI

パスを作成するには

次のcreate-network-insights-path例では、パスを作成します。送信元は指定されたインターネットゲートウェイで、送信先は指定されたEC2インスタンスです。指定されたプロトコルとポートを使用して送信先に到達できるかどうかを確認するには、 start-network-insights-analysis コマンドを使用してパスを分析します。

aws ec2 create-network-insights-path \
    --source igw-0797cccdc9d73b0e5 \
    --destination i-0495d385ad28331c7 \
    --destination-port 22 \
    --protocol TCP

出力:

{
    "NetworkInsightsPaths": {
        "NetworkInsightsPathId": "nip-0b26f224f1d131fa8",
        "NetworkInsightsPathArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-path/nip-0b26f224f1d131fa8",
        "CreatedDate": "2021-01-20T22:43:46.933Z",
        "Source": "igw-0797cccdc9d73b0e5",
        "Destination": "i-0495d385ad28331c7",
        "Protocol": "tcp"
    }
}

詳細については、「Reachability Analyzer ガイド」の「 の使用開始 AWS CLI」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateNetworkInsightsPath」の「」を参照してください。 AWS CLI

次の例は、create-network-interface-permission を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスのアクセス許可を作成するには

この例では、ネットワークインターフェイスをインスタンス123456789012にアタッチするアクセス許可eni-1a2b3c4dを アカウントに付与します。

コマンド:

aws ec2 create-network-interface-permission --network-interface-id eni-1a2b3c4d --aws-account-id 123456789012 --permission INSTANCE-ATTACH

出力:

{
  "InterfacePermission": {
      "PermissionState": {
          "State": "GRANTED"
      },
      "NetworkInterfacePermissionId": "eni-perm-06fd19020ede149ea",
      "NetworkInterfaceId": "eni-1a2b3c4d",
      "Permission": "INSTANCE-ATTACH",
      "AwsAccountId": "123456789012"
  }
}

次のコード例は、create-network-interface を使用する方法を示しています。

AWS CLI

例 1: ネットワークインターフェイスのIPv4アドレスを指定するには

次のcreate-network-interface例では、指定されたプライマリIPv4アドレスを持つ指定されたサブネットのネットワークインターフェイスを作成します。

aws ec2 create-network-interface \
    --subnet-id subnet-00a24d0d67acf6333 \
    --description "my network interface" \
    --groups sg-09dfba7ed20cda78b \
    --private-ip-address 10.0.8.17

出力:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "Description": "my network interface",
        "Groups": [
            {
                "GroupName": "my-security-group",
                "GroupId": "sg-09dfba7ed20cda78b"
            }
        ],
        "InterfaceType": "interface",
        "Ipv6Addresses": [],
        "MacAddress": "06:6a:0f:9a:49:37",
        "NetworkInterfaceId": "eni-0492b355f0cf3b3f8",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.17",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-17.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.17"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b"
    }
}

例 2: アドレスと IPv4 アドレスを持つネットワークインターフェイスを作成するには IPv6

次のcreate-network-interface例では、Amazon によって選択されたIPv4アドレスとIPv6アドレスを使用して、指定されたサブネットのネットワークインターフェイスを作成しますEC2。

aws ec2 create-network-interface \
    --subnet-id subnet-00a24d0d67acf6333 \
    --description "my dual stack network interface" \
    --ipv6-address-count 1 \
    --groups sg-09dfba7ed20cda78b

出力:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "Description": "my dual stack network interface",
        "Groups": [
            {
                "GroupName": "my-security-group",
                "GroupId": "sg-09dfba7ed20cda78b"
            }
        ],
        "InterfaceType": "interface",
        "Ipv6Addresses": [
            {
                "Ipv6Address": "2600:1f13:cfe:3650:a1dc:237c:393a:4ba7",
                "IsPrimaryIpv6": false
            }
        ],
        "MacAddress": "06:b8:68:d2:b2:2d",
        "NetworkInterfaceId": "eni-05da417453f9a84bf",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.18",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.18"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b",
        "Ipv6Address": "2600:1f13:cfe:3650:a1dc:237c:393a:4ba7"
    }
}

例 3: 接続追跡設定オプションを使用してネットワークインターフェイスを作成するには

次のcreate-network-interface例では、ネットワークインターフェイスを作成し、アイドル状態の接続追跡タイムアウトを設定します。

aws ec2 create-network-interface \
    --subnet-id subnet-00a24d0d67acf6333 \
    --groups sg-02e57dbcfe0331c1b \
    --connection-tracking-specification TcpEstablishedTimeout=86400,UdpTimeout=60

出力:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "ConnectionTrackingConfiguration": {
            "TcpEstablishedTimeout": 86400,
            "UdpTimeout": 60
        },
        "Description": "",
        "Groups": [
            {
                "GroupName": "my-security-group",
                "GroupId": "sg-02e57dbcfe0331c1b"
            }
        ],
        "InterfaceType": "interface",
        "Ipv6Addresses": [],
        "MacAddress": "06:4c:53:de:6d:91",
        "NetworkInterfaceId": "eni-0c133586e08903d0b",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-94.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.94",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-94.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.94"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b"
    }
}

例 4: Elastic Fabric Adapter を作成するには

次のcreate-network-interface例では、 を作成しますEFA。

aws ec2 create-network-interface \
    --interface-type efa \
    --subnet-id subnet-00a24d0d67acf6333 \
    --description "my efa" \
    --groups sg-02e57dbcfe0331c1b

出力:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "Description": "my efa",
        "Groups": [
            {
                "GroupName": "my-efa-sg",
                "GroupId": "sg-02e57dbcfe0331c1b"
            }
        ],
        "InterfaceType": "efa",
        "Ipv6Addresses": [],
        "MacAddress": "06:d7:a4:f7:4d:57",
        "NetworkInterfaceId": "eni-034acc2885e862b65",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-180.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.180",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-180.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.180"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b"
    }
}

詳細については、「Amazon ユーザーガイド」の「Elastic Network Interface」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスCreateNetworkInterface」の「」を参照してください。 AWS CLI

次の例は、create-placement-group を使用する方法を説明しています。

AWS CLI

プレイスメントグループを作成するには

このコマンド例では、指定した名前のプレイスメントグループを作成します。

コマンド:

aws ec2 create-placement-group --group-name my-cluster --strategy cluster

パーティションプレイスメントグループを作成するには

このコマンド例では、5 つのパーティションHDFS-Group-Aを持つ という名前のパーティションプレイスメントグループを作成します。

コマンド:

aws ec2 create-placement-group --group-name HDFS-Group-A --strategy partition --partition-count 5

  • API 詳細については、「 コマンドリファレンスCreatePlacementGroup」の「」を参照してください。 AWS CLI

次のコード例は、create-replace-root-volume-task を使用する方法を示しています。

AWS CLI

例 1: ルートボリュームを初期起動状態に復元するには

次のcreate-replace-root-volume-task例では、インスタンス i-0123456789abcdefa のルートボリュームを初期起動状態に復元します。

aws ec2 create-replace-root-volume-task \
    --instance-id i-0123456789abcdefa

出力:

{
    "ReplaceRootVolumeTask":
    {
        "InstanceId": "i-0123456789abcdefa",
            "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd",
            "TaskState": "pending",
            "StartTime": "2022-03-14T15:06:38Z",
            "Tags": []
    }
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「ルートボリュームの置き換え」を参照してください。

例 2: ルートボリュームを特定のスナップショットに復元するには

次のcreate-replace-root-volume-task例では、インスタンス i-0123456789abcdefa のルートボリュームをスナップショット snap-0abcdef1234567890 に復元します。

aws ec2 create-replace-root-volume-task \
    --instance-id i-0123456789abcdefa \
    --snapshot-id  snap-0abcdef1234567890

出力:

{
    "ReplaceRootVolumeTask":
    {
        "InstanceId": "i-0123456789abcdefa",
        "ReplaceRootVolumeTaskId": "replacevol-0555566667777abcd",
        "TaskState": "pending",
        "StartTime": "2022-03-14T15:16:28Z",
        "Tags": []
    }
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「ルートボリュームの置き換え」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateReplaceRootVolumeTask」の「」を参照してください。 AWS CLI

次の例は、create-reserved-instances-listing を使用する方法を説明しています。

AWS CLI

Reserved Instance Marketplace でリザーブドインスタンスを一覧表示するには

次のcreate-reserved-instances-listing例では、Reserved Instance Marketplace で指定されたリザーブドインスタンスのリストを作成します。

aws ec2 create-reserved-instances-listing \
    --reserved-instances-id 5ec28771-05ff-4b9b-aa31-9e57dexample \
    --instance-count 3 \
    --price-schedules CurrencyCode=USD,Price=25.50 \
    --client-token 550e8400-e29b-41d4-a716-446655440000

次の例は、create-restore-image-task を使用する方法を説明しています。

AWS CLI

S3 バケットAMIから を復元するには

次のcreate-restore-image-task例では、S3 バケットAMIから を復元します。describe-store-image-tasks 出力S3ObjectKey `` and ``Bucketの の値を使用して、 のオブジェクトキーAMIと、 がコピーAMIされた S3 バケットの名前を指定し、復元された の名前を指定しますAMI。この名前は、このアカウントのリージョンAMIsで に対して一意である必要があります。復元された AMIは新しい AMI ID を受け取ります。

aws ec2 create-restore-image-task \
    --object-key ami-1234567890abcdef0.bin \
    --bucket my-ami-bucket \
    --name "New AMI Name"

出力:

{
    "ImageId": "ami-0eab20fe36f83e1a8"
}

S3 AMIを使用した の保存と復元の詳細については、Amazon EC2ユーザーガイドのS3 <https://docs.aws.amazon.com/AWS EC2/latestUserGuide//ami-store-restore.html> AMIを使用した の保存と復元」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateRestoreImageTask」の「」を参照してください。 AWS CLI

次のコード例は、create-route-table を使用する方法を示しています。

AWS CLI

ルートテーブルを作成するには

この例では、指定された のルートテーブルを作成しますVPC。

コマンド:

aws ec2 create-route-table --vpc-id vpc-a01106c2

出力:

{
    "RouteTable": {
        "Associations": [],
        "RouteTableId": "rtb-22574640",
        "VpcId": "vpc-a01106c2",
        "PropagatingVgws": [],
        "Tags": [],
        "Routes": [
            {
                "GatewayId": "local",
                "DestinationCidrBlock": "10.0.0.0/16",
                "State": "active"
            }
        ]
    }
}

  • API 詳細については、「 コマンドリファレンスCreateRouteTable」の「」を参照してください。 AWS CLI

次のコード例は、create-route を使用する方法を示しています。

AWS CLI

ルートを作成するには

この例では、指定されたルートテーブルのルートを作成します。ルートはすべてのIPv4トラフィック (0.0.0.0/0) に一致し、指定されたインターネットゲートウェイにルーティングされます。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 create-route --route-table-id rtb-22574640 --destination-cidr-block 0.0.0.0/0 --gateway-id igw-c0a643a9

このコマンド例では、ルートテーブル rtb-g8ff4ea2 にルートを作成します。ルートはIPv4CIDRブロック 10.0.0.0/16 のトラフィックに一致し、VPCピアリング接続 pcx-111aaa22 にルーティングされます。このルートにより、ピアリング接続VPCでトラフィックをVPCピアに誘導できます。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 create-route --route-table-id rtb-g8ff4ea2 --destination-cidr-block 10.0.0.0/16 --vpc-peering-connection-id pcx-1a2b3c4d

この例では、指定されたルートテーブルに、すべてのIPv6トラフィック (::/0) に一致するルートを作成し、指定された Egress-Only インターネットゲートウェイにルーティングします。

コマンド:

aws ec2 create-route --route-table-id rtb-dce620b8 --destination-ipv6-cidr-block ::/0 --egress-only-internet-gateway-id eigw-01eadbd45ecd7943f

  • API 詳細については、「 コマンドリファレンスCreateRoute」の「」を参照してください。 AWS CLI

次の例は、create-security-group を使用する方法を説明しています。

AWS CLI

EC2-Classic のセキュリティグループを作成するには

この例では、MySecurityGroup という名前のセキュリティグループが作成されます。

コマンド:

aws ec2 create-security-group --group-name MySecurityGroup --description "My security group"

出力:

{
    "GroupId": "sg-903004f8"
}

EC2- のセキュリティグループを作成するにはVPC

この例では、指定された MySecurityGroupに という名前のセキュリティグループを作成しますVPC。

コマンド:

aws ec2 create-security-group --group-name MySecurityGroup --description "My security group" --vpc-id vpc-1a2b3c4d

出力:

{
    "GroupId": "sg-903004f8"
}

詳細については、「AWS コマンドラインインターフェイスユーザーガイド」でセキュリティグループの使用方法を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateSecurityGroup」の「」を参照してください。 AWS CLI

次の例は、create-snapshot を使用する方法を説明しています。

AWS CLI

スナップショットを作成するには

このコマンド例では、ボリューム ID が のボリュームのスナップショットvol-1234567890abcdef0を作成し、スナップショットを識別するための簡単な説明を作成します。

コマンド:

aws ec2 create-snapshot --volume-id vol-1234567890abcdef0 --description "This is my root volume snapshot"

出力:

{
    "Description": "This is my root volume snapshot",
    "Tags": [],
    "Encrypted": false,
    "VolumeId": "vol-1234567890abcdef0",
    "State": "pending",
    "VolumeSize": 8,
    "StartTime": "2018-02-28T21:06:01.000Z",
    "Progress": "",
    "OwnerId": "012345678910",
    "SnapshotId": "snap-066877671789bd71b"
}

タグ付きのスナップショットを作成するには

このコマンド例では、スナップショットを作成し、 purpose=prod と costcenter=123 の 2 つのタグを適用します。

コマンド:

aws ec2 create-snapshot --volume-id vol-1234567890abcdef0 --description 'Prod backup' --tag-specifications 'ResourceType=snapshot,Tags=[{Key=purpose,Value=prod},{Key=costcenter,Value=123}]'

出力:

{
    "Description": "Prod backup",
    "Tags": [
        {
            "Value": "prod",
            "Key": "purpose"
        },
        {
            "Value": "123",
            "Key": "costcenter"
        }
     ],
     "Encrypted": false,
     "VolumeId": "vol-1234567890abcdef0",
     "State": "pending",
     "VolumeSize": 8,
     "StartTime": "2018-02-28T21:06:06.000Z",
     "Progress": "",
     "OwnerId": "012345678910",
     "SnapshotId": "snap-09ed24a70bc19bbe4"
 }

  • API 詳細については、「 コマンドリファレンスCreateSnapshot」の「」を参照してください。 AWS CLI

次のコード例は、create-snapshots を使用する方法を示しています。

AWS CLI

例 1: マルチボリュームスナップショットを作成するには

次のcreate-snapshots例では、指定されたインスタンスにアタッチされたすべてのボリュームのスナップショットを作成します。

aws ec2 create-snapshots \
    --instance-specification InstanceId=i-1234567890abcdef0 \
    --description "This is snapshot of a volume from my-instance"

出力:

{
    "Snapshots": [
        {
            "Description": "This is a snapshot of a volume from my-instance",
            "Tags": [],
            "Encrypted": false,
            "VolumeId": "vol-0a01d2d5a34697479",
            "State": "pending",
            "VolumeSize": 16,
            "StartTime": "2019-08-05T16:58:19.000Z",
            "Progress": "",
            "OwnerId": "123456789012",
            "SnapshotId": "snap-07f30e3909aa0045e"
        },
        {
            "Description": "This is a snapshot of a volume from my-instance",
            "Tags": [],
            "Encrypted": false,
            "VolumeId": "vol-02d0d4947008cb1a2",
            "State": "pending",
            "VolumeSize": 20,
            "StartTime": "2019-08-05T16:58:19.000Z",
            "Progress": "",
            "OwnerId": "123456789012",
            "SnapshotId": "snap-0ec20b602264aad48"
        },
        ...
    ]
}

例 2: ソースボリュームのタグを使用してマルチボリュームスナップショットを作成するには

次のcreate-snapshots例では、指定されたインスタンスにアタッチされたすべてのボリュームのスナップショットを作成し、各ボリュームのタグを対応するスナップショットにコピーします。

aws ec2 create-snapshots \
    --instance-specification InstanceId=i-1234567890abcdef0 \
    --copy-tags-from-source volume \
    --description "This is snapshot of a volume from my-instance"

出力:

{
    "Snapshots": [
        {
            "Description": "This is a snapshot of a volume from my-instance",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-volume"
                }
            ],
            "Encrypted": false,
            "VolumeId": "vol-02d0d4947008cb1a2",
            "State": "pending",
            "VolumeSize": 20,
            "StartTime": "2019-08-05T16:53:04.000Z",
            "Progress": "",
            "OwnerId": "123456789012",
            "SnapshotId": "snap-053bfaeb821a458dd"
        }
        ...
    ]
}

例 3: ルートボリュームを含まないマルチボリュームスナップショットを作成するには

次のcreate-snapshots例では、ルートボリュームを除く、指定されたインスタンスにアタッチされたすべてのボリュームのスナップショットを作成します。

aws ec2 create-snapshots \
    --instance-specification InstanceId=i-1234567890abcdef0,ExcludeBootVolume=true

出力例については、例 1 を参照してください。

例 4: マルチボリュームスナップショットを作成してタグを追加するには

次のcreate-snapshots例では、指定されたインスタンスにアタッチされたすべてのボリュームのスナップショットを作成し、各スナップショットに 2 つのタグを追加します。

aws ec2 create-snapshots \
    --instance-specification InstanceId=i-1234567890abcdef0 \
    --tag-specifications 'ResourceType=snapshot,Tags=[{Key=Name,Value=backup},{Key=costcenter,Value=123}]'

出力例については、例 1 を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateSnapshots」の「」を参照してください。 AWS CLI

次の例は、create-spot-datafeed-subscription を使用する方法を説明しています。

AWS CLI

スポットインスタンスのデータフィードを作成するには

次のcreate-spot-datafeed-subscription例では、スポットインスタンスのデータフィードを作成します。

aws ec2 create-spot-datafeed-subscription \
    --bucket my-bucket \
    --prefix spot-data-feed

出力:

{
    "SpotDatafeedSubscription": {
        "Bucket": "my-bucket",
        "OwnerId": "123456789012",
        "Prefix": "spot-data-feed",
        "State": "Active"
    }
}

データフィードは、指定した Amazon S3 バケットに保存されます。このデータフィードのファイル名の形式は次のとおりです。

my-bucket.s3.amazonaws.com/spot-data-feed/123456789012.YYYY-MM-DD-HH.n.abcd1234.gz

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「スポットインスタンスデータフィード」を参照してください。

次のコード例は、create-store-image-task を使用する方法を示しています。

AWS CLI

を S3 バケットに保存AMIするには

次のcreate-store-image-task例では、S3 バケットAMIに を保存します。の ID AMIと、 を保存する S3 バケットの名前を指定しますAMI。

aws ec2 create-store-image-task \
  --image-id ami-1234567890abcdef0 \
  --bucket my-ami-bucket

出力:

{
    "ObjectKey": "ami-1234567890abcdef0.bin"
}

詳細については、「Amazon ユーザーガイド」のS3 AMIを使用して を保存および復元する」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスCreateStoreImageTask」の「」を参照してください。 AWS CLI

次のコード例は、create-subnet-cidr-reservation を使用する方法を示しています。

AWS CLI

サブネットCIDR予約を作成するには

次のcreate-subnet-cidr-reservation例では、指定されたサブネットとCIDR範囲のサブネットCIDR予約を作成します。

aws ec2 create-subnet-cidr-reservation \
    --subnet-id subnet-03c51e2eEXAMPLE \
    --reservation-type prefix \
    --cidr 10.1.0.20/26

出力:

{
    "SubnetCidrReservation": {
        "SubnetCidrReservationId": "scr-044f977c4eEXAMPLE",
        "SubnetId": "subnet-03c51e2e6cEXAMPLE",
        "Cidr": "10.1.0.16/28",
        "ReservationType": "prefix",
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon ユーザーガイド」の「サブネットCIDR予約」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスCreateSubnetCidrReservation」の「」を参照してください。 AWS CLI

次のコード例は、create-subnet を使用する方法を示しています。

AWS CLI

例 1: IPv4CIDRブロックのみを使用してサブネットを作成するには

次のcreate-subnet例では、指定された IPv4 CIDR ブロックVPCを使用して、指定された にサブネットを作成します。

aws ec2 create-subnet \
    --vpc-id vpc-081ec835f3EXAMPLE \
    --cidr-block 10.0.0.0/24 \
    --tag-specifications ResourceType=subnet,Tags=[{Key=Name,Value=my-ipv4-only-subnet}]

出力:

{
    "Subnet": {
        "AvailabilityZone": "us-west-2a",
        "AvailabilityZoneId": "usw2-az2",
        "AvailableIpAddressCount": 251,
        "CidrBlock": "10.0.0.0/24",
        "DefaultForAz": false,
        "MapPublicIpOnLaunch": false,
        "State": "available",
        "SubnetId": "subnet-0e99b93155EXAMPLE",
        "VpcId": "vpc-081ec835f3EXAMPLE",
        "OwnerId": "123456789012",
        "AssignIpv6AddressOnCreation": false,
        "Ipv6CidrBlockAssociationSet": [],
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-ipv4-only-subnet"
            }
        ],
        "SubnetArn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0e99b93155EXAMPLE"
    }
}

例 2: IPv4と IPv6CIDRブロックの両方を持つサブネットを作成するには

次のcreate-subnet例では、指定された と IPv4IPv6CIDRブロックVPCを使用して、指定された にサブネットを作成します。

aws ec2 create-subnet \
    --vpc-id vpc-081ec835f3EXAMPLE \
    --cidr-block 10.0.0.0/24 \
    --ipv6-cidr-block 2600:1f16:cfe:3660::/64 \
    --tag-specifications ResourceType=subnet,Tags=[{Key=Name,Value=my-ipv4-ipv6-subnet}]

出力:

{
    "Subnet": {
        "AvailabilityZone": "us-west-2a",
        "AvailabilityZoneId": "usw2-az2",
        "AvailableIpAddressCount": 251,
        "CidrBlock": "10.0.0.0/24",
        "DefaultForAz": false,
        "MapPublicIpOnLaunch": false,
        "State": "available",
        "SubnetId": "subnet-0736441d38EXAMPLE",
        "VpcId": "vpc-081ec835f3EXAMPLE",
        "OwnerId": "123456789012",
        "AssignIpv6AddressOnCreation": false,
        "Ipv6CidrBlockAssociationSet": [
            {
                "AssociationId": "subnet-cidr-assoc-06c5f904499fcc623",
                "Ipv6CidrBlock": "2600:1f13:cfe:3660::/64",
                "Ipv6CidrBlockState": {
                    "State": "associating"
                }
            }
        ],
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-ipv4-ipv6-subnet"
            }
        ],
        "SubnetArn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0736441d38EXAMPLE"
    }
}

例 3: IPv6CIDRブロックのみを使用してサブネットを作成するには

次のcreate-subnet例では、指定された IPv6 CIDR ブロックVPCを使用して、指定された にサブネットを作成します。

aws ec2 create-subnet \
    --vpc-id vpc-081ec835f3EXAMPLE \
    --ipv6-native \
    --ipv6-cidr-block 2600:1f16:115:200::/64 \
    --tag-specifications ResourceType=subnet,Tags=[{Key=Name,Value=my-ipv6-only-subnet}]

出力:

{
    "Subnet": {
        "AvailabilityZone": "us-west-2a",
        "AvailabilityZoneId": "usw2-az2",
        "AvailableIpAddressCount": 0,
        "DefaultForAz": false,
        "MapPublicIpOnLaunch": false,
        "State": "available",
        "SubnetId": "subnet-03f720e7deEXAMPLE",
        "VpcId": "vpc-081ec835f3EXAMPLE",
        "OwnerId": "123456789012",
        "AssignIpv6AddressOnCreation": true,
        "Ipv6CidrBlockAssociationSet": [
            {
                "AssociationId": "subnet-cidr-assoc-01ef639edde556709",
                "Ipv6CidrBlock": "2600:1f13:cfe:3660::/64",
                "Ipv6CidrBlockState": {
                    "State": "associating"
                }
            }
        ],
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-ipv6-only-subnet"
            }
        ],
        "SubnetArn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-03f720e7deEXAMPLE"
    }
}

詳細については、「Amazon VPCユーザーガイドVPCs」の「 とサブネット」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateSubnet」の「」を参照してください。 AWS CLI

次の例は、create-tags を使用する方法を説明しています。

AWS CLI

例 1: リソースにタグを追加するには

次のcreate-tags例では、指定されたイメージStack=productionに タグを追加するか、タグキーAMIが である の既存のタグを上書きしますStack。

aws ec2 create-tags \
    --resources ami-1234567890abcdef0 \
    --tags Key=Stack,Value=production

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「これはトピックタイトルです」を参照してください。

例 2: 複数のリソースにタグを追加するには

次のcreate-tags例では、 AMIと インスタンスに 2 つのタグを追加 (または上書き) します。一方のタグでは、キー (webserver) はありますが値はありません (値は空文字列に設定されています)。もう一方のタグにはキー (stack) と値 (Production) があります。

aws ec2 create-tags \
    --resources ami-1a2b3c4d i-1234567890abcdef0 \
    --tags Key=webserver,Value=   Key=stack,Value=Production

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「これはトピックタイトルです」を参照してください。

例 3: 特殊文字を含むタグを追加するには

次の create-tags の例では、インスタンスにタグ [Group]=testを追加します。角括弧 ([、]) は特殊文字であり、エスケープする必要があります。以下の例でも、各環境に適した行継続文字を使用しています。

Windows を使用している場合、特殊文字を含む要素を二重引用符 (") で囲み、各二重引用符の前にバックスラッシュ (\) を付けます。

aws ec2 create-tags ^
    --resources i-1234567890abcdef0 ^
    --tags Key=\"[Group]\",Value=test

Windows を使用している場合は PowerShell、次のように、特殊文字を含む値を二重引用符 (") で囲み、各二重引用符の前にバックスラッシュ (\) を付けて、キーと値の構造全体を一重引用符 (') で囲みます。

aws ec2 create-tags `
    --resources i-1234567890abcdef0 `
    --tags 'Key=\"[Group]\",Value=test'

Linux または OS X を使用している場合は、次のように特殊文字を含む要素を二重引用符 (") で囲んだ後、キーと値の構造全体を一重引用符 (') で囲みます。

aws ec2 create-tags \
    --resources i-1234567890abcdef0 \
    --tags 'Key="[Group]",Value=test'

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「これはトピックタイトルです」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTags」の「」を参照してください。 AWS CLI

次の例は、create-traffic-mirror-filter-rule を使用する方法を説明しています。

AWS CLI

受信TCPトラフィックのフィルタールールを作成するには

次のcreate-traffic-mirror-filter-rule例では、すべての受信TCPトラフィックをミラーリングするために使用できるルールを作成します。このコマンドを実行する前に、 create-traffic-mirror-filterを使用して Traffic Mirror フィルターを作成します。

aws ec2 create-traffic-mirror-filter-rule \
    --description "TCP Rule" \
    --destination-cidr-block 0.0.0.0/0  \
    --protocol 6 \
    --rule-action accept \
    --rule-number 1 \
    --source-cidr-block 0.0.0.0/0 \
    --traffic-direction ingress \
    --traffic-mirror-filter-id tmf-04812ff784b25ae67

出力:

{
    "TrafficMirrorFilterRule": {
        "DestinationCidrBlock": "0.0.0.0/0",
        "TrafficMirrorFilterId": "tmf-04812ff784b25ae67",
        "TrafficMirrorFilterRuleId": "tmfr-02d20d996673f3732",
        "SourceCidrBlock": "0.0.0.0/0",
        "TrafficDirection": "ingress",
        "Description": "TCP Rule",
        "RuleNumber": 1,
        "RuleAction": "accept",
        "Protocol": 6
    },
    "ClientToken": "4752b573-40a6-4eac-a8a4-a72058761219"
}

詳細については、「トラフィックミラーリングガイド」の「トラフィックミラーフィルタの作成AWS 」を参照してください。

次のコード例は、create-traffic-mirror-filter を使用する方法を示しています。

AWS CLI

Traffic Mirror フィルターを作成するには

次のcreate-traffic-mirror-filter例では、Traffic Mirror フィルターを作成します。フィルターを作成したら、 create-traffic-mirror-filter-ruleを使用してフィルターにルールを追加します。

aws ec2 create-traffic-mirror-filter \
    --description "TCP Filter"

出力:

{
    "ClientToken": "28908518-100b-4987-8233-8c744EXAMPLE",
    "TrafficMirrorFilter": {
        "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
        "Description": "TCP Filter",
        "EgressFilterRules": [],
        "IngressFilterRules": [],
        "Tags": [],
        "NetworkServices": []
    }
}

詳細については、「 Traffic Mirroring Guide」の「Create a AWS Traffic Mirror Filter」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTrafficMirrorFilter」の「」を参照してください。 AWS CLI

次の例は、create-traffic-mirror-session を使用する方法を説明しています。

AWS CLI

Traffic Mirror セッションを作成するには

次のcreate-traffic-mirror-sessionコマンドは、指定されたソースとターゲットのトラフィックミラーセッションを 25 バイトのパケットに対して作成します。

aws ec2 create-traffic-mirror-session \
    --description "example session" \
    --traffic-mirror-target-id tmt-07f75d8feeEXAMPLE \
    --network-interface-id eni-070203f901EXAMPLE \
    --session-number 1  \
    --packet-length 25 \
    --traffic-mirror-filter-id tmf-04812ff784EXAMPLE

出力:

{
    "TrafficMirrorSession": {
        "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE",
        "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE",
        "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
        "NetworkInterfaceId": "eni-070203f901EXAMPLE",
        "OwnerId": "111122223333",
        "PacketLength": 25,
        "SessionNumber": 1,
        "VirtualNetworkId": 7159709,
        "Description": "example session",
        "Tags": []
    },
    "ClientToken": "5236cffc-ee13-4a32-bb5b-388d9da09d96"
}

詳細については、「 Traffic Mirroring Guide」の「Create a Traffic Mirror SessionAWS 」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTrafficMirrorSession」の「」を参照してください。 AWS CLI

次の例は、create-traffic-mirror-target を使用する方法を説明しています。

AWS CLI

Network Load Balancer トラフィックミラーターゲットを作成するには

次のcreate-traffic-mirror-target例では、Network Load Balancer トラフィックミラーターゲットを作成します。

aws ec2 create-traffic-mirror-target \
    --description "Example Network Load Balancer Target" \
    --network-load-balancer-arn arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/net/NLB/7cdec873EXAMPLE

出力:

{
    "TrafficMirrorTarget": {
        "Type": "network-load-balancer",
        "Tags": [],
        "Description": "Example Network Load Balancer Target",
        "OwnerId": "111122223333",
        "NetworkLoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:724145273726:loadbalancer/net/NLB/7cdec873EXAMPLE",
        "TrafficMirrorTargetId": "tmt-0dabe9b0a6EXAMPLE"
    },
    "ClientToken": "d5c090f5-8a0f-49c7-8281-72c796a21f72"
}

ネットワーク Traffic Mirror ターゲットを作成するには

次のcreate-traffic-mirror-target例では、ネットワークインターフェイス Traffic Mirror ターゲットを作成します。

aws ec2 create-traffic-mirror-target --description "ネットワークインターフェイスターゲット" --network-interface-id eni-eni-01f6f631eEXAMPLE

出力:

{
    "ClientToken": "5289a345-0358-4e62-93d5-47ef3061d65e",
    "TrafficMirrorTarget": {
        "Description": "Network interface target",
        "NetworkInterfaceId": "eni-01f6f631eEXAMPLE",
        "TrafficMirrorTargetId": "tmt-02dcdbe2abEXAMPLE",
        "OwnerId": "111122223333",
        "Type": "network-interface",
        "Tags": []
    }
}

詳細については、「 Traffic Mirroring Guide」の「Create a AWS Traffic Mirror Target」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTrafficMirrorTarget」の「」を参照してください。 AWS CLI

次の例は、create-transit-gateway-connect-peer を使用する方法を説明しています。

AWS CLI

Transit Gateway Connect ピアを作成するには

次のcreate-transit-gateway-connect-peer例では、Connect ピアを作成します。

aws ec2 create-transit-gateway-connect-peer \
    --transit-gateway-attachment-id tgw-attach-0f0927767cEXAMPLE \
    --peer-address 172.31.1.11 \
    --inside-cidr-blocks 169.254.6.0/29

出力:

{
    "TransitGatewayConnectPeer": {
        "TransitGatewayAttachmentId": "tgw-attach-0f0927767cEXAMPLE",
        "TransitGatewayConnectPeerId": "tgw-connect-peer-0666adbac4EXAMPLE",
        "State": "pending",
        "CreationTime": "2021-10-13T03:35:17.000Z",
        "ConnectPeerConfiguration": {
            "TransitGatewayAddress": "10.0.0.234",
            "PeerAddress": "172.31.1.11",
            "InsideCidrBlocks": [
                "169.254.6.0/29"
            ],
            "Protocol": "gre",
            "BgpConfigurations": [
                {
                    "TransitGatewayAsn": 64512,
                    "PeerAsn": 64512,
                    "TransitGatewayAddress": "169.254.6.2",
                    "PeerAddress": "169.254.6.1",
                    "BgpStatus": "down"
                },
                {
                    "TransitGatewayAsn": 64512,
                    "PeerAsn": 64512,
                    "TransitGatewayAddress": "169.254.6.3",
                    "PeerAddress": "169.254.6.1",
                    "BgpStatus": "down"
                }
            ]
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway Connect アタッチメント」および「Transit Gateway Connect ピア」を参照してください。

次のコード例は、create-transit-gateway-connect を使用する方法を示しています。

AWS CLI

Transit Gateway Connect アタッチメントを作成するには

次のcreate-transit-gateway-connect例では、指定されたアタッチメントの「gre」プロトコルを使用して Connect アタッチメントを作成します。

aws ec2 create-transit-gateway-connect \
    --transport-transit-gateway-attachment-id tgw-attach-0a89069f57EXAMPLE \
    --options "Protocol=gre"

出力:

{
    "TransitGatewayConnect": {
        "TransitGatewayAttachmentId": "tgw-attach-037012e5dcEXAMPLE",
        "TransportTransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE",
        "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
        "State": "pending",
        "CreationTime": "2021-03-09T19:59:17+00:00",
        "Options": {
            "Protocol": "gre"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway Connect アタッチメント」および「Transit Gateway Connect ピア」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTransitGatewayConnect」の「」を参照してください。 AWS CLI

次のコード例は、create-transit-gateway-multicast-domain を使用する方法を示しています。

AWS CLI

例 1: IGMP マルチキャストドメインを作成するには

次のcreate-transit-gateway-multicast-domain例では、指定されたトランジットゲートウェイのマルチキャストドメインを作成します。静的ソースを無効にすると、マルチキャストドメインに関連付けられたサブネット内のすべてのインスタンスがマルチキャストトラフィックを送信できます。少なくとも 1 人のメンバーがIGMPプロトコルを使用する場合は、IGMPv2サポートを有効にする必要があります。

aws ec2 create-transit-gateway-multicast-domain \
    --transit-gateway-id tgw-0bf0bffefaEXAMPLE \
    --options StaticSourcesSupport=disable,Igmpv2Support=enable

出力:

{
    "TransitGatewayMulticastDomain": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c9e29e2a7EXAMPLE",
        "TransitGatewayId": "tgw-0bf0bffefaEXAMPLE",
        "TransitGatewayMulticastDomainArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway-multicast-domain/tgw-mcast-domain-0c9e29e2a7EXAMPLE",
        "OwnerId": "123456789012",
        "Options": {
            "Igmpv2Support": "enable",
            "StaticSourcesSupport": "disable",
            "AutoAcceptSharedAssociations": "disable"
        },
        "State": "pending",
        "CreationTime": "2021-09-29T22:17:13.000Z"
    }
}

例 2: 静的マルチキャストドメインを作成するには

次のcreate-transit-gateway-multicast-domain例では、指定されたトランジットゲートウェイのマルチキャストドメインを作成します。静的ソースを有効にするには、ソースを静的に追加する必要があります。

aws ec2 create-transit-gateway-multicast-domain \
    --transit-gateway-id tgw-0bf0bffefaEXAMPLE \
    --options StaticSourcesSupport=enable,Igmpv2Support=disable

出力:

{
    "TransitGatewayMulticastDomain": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-000fb24d04EXAMPLE",
        "TransitGatewayId": "tgw-0bf0bffefaEXAMPLE",
        "TransitGatewayMulticastDomainArn": "arn:aws:ec2:us-west-2:123456789012:transit-gateway-multicast-domain/tgw-mcast-domain-000fb24d04EXAMPLE",
        "OwnerId": "123456789012",
        "Options": {
            "Igmpv2Support": "disable",
            "StaticSourcesSupport": "enable",
            "AutoAcceptSharedAssociations": "disable"
        },
        "State": "pending",
        "CreationTime": "2021-09-29T22:20:19.000Z"
    }
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストドメインの管理」を参照してください。

次の例は、create-transit-gateway-peering-attachment を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイピアリングアタッチメントを作成するには

次のcreate-transit-gateway-peering-attachment例では、指定された 2 つのトランジットゲートウェイ間にピアリングアタッチメントリクエストを作成します。

aws ec2 create-transit-gateway-peering-attachment \
    --transit-gateway-id tgw-123abc05e04123abc \
    --peer-transit-gateway-id tgw-11223344aabbcc112 \
    --peer-account-id 123456789012 \
    --peer-region us-east-2

出力:

{
    "TransitGatewayPeeringAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd",
        "RequesterTgwInfo": {
            "TransitGatewayId": "tgw-123abc05e04123abc",
            "OwnerId": "123456789012",
            "Region": "us-west-2"
        },
        "AccepterTgwInfo": {
            "TransitGatewayId": "tgw-11223344aabbcc112",
            "OwnerId": "123456789012",
            "Region": "us-east-2"
        },
        "State": "initiatingRequest",
        "CreationTime": "2019-12-09T11:38:05.000Z"
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway ピアリングアタッチメント」を参照してください。

次の例は、create-transit-gateway-policy-table を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイポリシーテーブルを作成するには

次のcreate-transit-gateway-policy-table例では、指定されたトランジットゲートウェイのトランジットゲートウェイポリシーテーブルを作成します。

aws ec2 create-transit-gateway-policy-table \
    --transit-gateway-id tgw-067f8505c18f0bd6e

出力:

{
    "TransitGatewayPolicyTable": {
        "TransitGatewayPolicyTableId": "tgw-ptb-0a16f134b78668a81",
        "TransitGatewayId": "tgw-067f8505c18f0bd6e",
        "State": "pending",
        "CreationTime": "2023-11-28T16:36:43+00:00"
    }
}

詳細については、「Transit Gateway ユーザーガイド」の「Transit Gateway ポリシーテーブル」を参照してください。

次のコード例は、create-transit-gateway-prefix-list-reference を使用する方法を示しています。

AWS CLI

プレフィックスリストへの参照を作成するには

次のcreate-transit-gateway-prefix-list-reference例では、指定された Transit Gateway ルートテーブルに指定されたプレフィックスリストへの参照を作成します。

aws ec2 create-transit-gateway-prefix-list-reference \
    --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \
    --prefix-list-id pl-11111122222222333 \
    --transit-gateway-attachment-id tgw-attach-aaaaaabbbbbb11111

出力:

{
    "TransitGatewayPrefixListReference": {
        "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123",
        "PrefixListId": "pl-11111122222222333",
        "PrefixListOwnerId": "123456789012",
        "State": "pending",
        "Blackhole": false,
        "TransitGatewayAttachment": {
            "TransitGatewayAttachmentId": "tgw-attach-aaaaaabbbbbb11111",
            "ResourceType": "vpc",
            "ResourceId": "vpc-112233445566aabbc"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「プレフィックスリストリファレンス」を参照してください。

次の例は、create-transit-gateway-route-table を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイルートテーブルを作成するには

次のcreate-transit-gateway-route-table例では、指定されたトランジットゲートウェイのルートテーブルを作成します。

aws ec2 create-transit-gateway-route-table \
    --transit-gateway-id tgw-0262a0e521EXAMPLE

出力:

{
    "TransitGatewayRouteTable": {
        "TransitGatewayRouteTableId": "tgw-rtb-0960981be7EXAMPLE",
        "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
        "State": "pending",
        "DefaultAssociationRouteTable": false,
        "DefaultPropagationRouteTable": false,
        "CreationTime": "2019-07-10T19:01:46.000Z"
    }
}

詳細については、「Transit Gateways ガイド」の「Transit Gateway ルートテーブルを作成する」を参照してください。

次の例は、create-transit-gateway-route を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイルートを作成するには

次のcreate-transit-gateway-route例では、指定されたルートテーブルに対して、指定された送信先を持つルートを作成します。

aws ec2 create-transit-gateway-route \
    --destination-cidr-block 10.0.2.0/24 \
    --transit-gateway-route-table-id tgw-rtb-0b6f6aaa01EXAMPLE \
    --transit-gateway-attachment-id tgw-attach-0b5968d3b6EXAMPLE

出力:

{
    "Route": {
        "DestinationCidrBlock": "10.0.2.0/24",
        "TransitGatewayAttachments": [
            {
                "ResourceId": "vpc-0065acced4EXAMPLE",
                "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE",
                "ResourceType": "vpc"
            }
        ],
        "Type": "static",
        "State": "active"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTransitGatewayRoute」の「」を参照してください。 AWS CLI

次のコード例は、create-transit-gateway-vpc-attachment を使用する方法を示しています。

AWS CLI

例 1: トランジットゲートウェイを に関連付けるには VPC

次のcreate-transit-gateway-vpc-attachment例では、指定された への Transit Gateway アタッチメントを作成しますVPC。

aws ec2 create-transit-gateway-vpc-attachment \
    --transit-gateway-id tgw-0262a0e521EXAMPLE \
    --vpc-id vpc-07e8ffd50f49335df \
    --subnet-id subnet-0752213d59EXAMPLE

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE",
        "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
        "VpcId": "vpc-07e8ffd50fEXAMPLE",
        "VpcOwnerId": "111122223333",
        "State": "pending",
        "SubnetIds": [
            "subnet-0752213d59EXAMPLE"
        ],
        "CreationTime": "2019-07-10T17:33:46.000Z",
        "Options": {
            "DnsSupport": "enable",
            "Ipv6Support": "disable"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「 への Transit Gateway アタッチメントを作成するVPC」を参照してください。

例 2: トランジットゲートウェイを 内の複数のサブネットに関連付けるには VPC

次のcreate-transit-gateway-vpc-attachment例では、指定された VPCおよび サブネットへの Transit Gateway アタッチメントを作成します。

aws ec2 create-transit-gateway-vpc-attachment \
    --transit-gateway-id tgw-02f776b1a7EXAMPLE  \
    --vpc-id vpc-3EXAMPLE \
    --subnet-ids "subnet-dEXAMPLE" "subnet-6EXAMPLE"

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-0e141e0bebEXAMPLE",
        "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
        "VpcId": "vpc-3EXAMPLE",
        "VpcOwnerId": "111122223333",
        "State": "pending",
        "SubnetIds": [
            "subnet-6EXAMPLE",
            "subnet-dEXAMPLE"
        ],
        "CreationTime": "2019-12-17T20:07:52.000Z",
        "Options": {
            "DnsSupport": "enable",
            "Ipv6Support": "disable"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「 へのトランジットゲートウェイアタッチメントを作成するVPC」を参照してください。

次の例は、create-transit-gateway を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイを作成するには

次のcreate-transit-gateway例では、トランジットゲートウェイを作成します。

aws ec2 create-transit-gateway \
    --description MyTGW \
    --options AmazonSideAsn=64516,AutoAcceptSharedAttachments=enable,DefaultRouteTableAssociation=enable,DefaultRouteTablePropagation=enable,VpnEcmpSupport=enable,DnsSupport=enable

出力:

{
    "TransitGateway": {
        "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
        "TransitGatewayArn": "arn:aws:ec2:us-east-2:111122223333:transit-gateway/tgw-0262a0e521EXAMPLE",
        "State": "pending",
        "OwnerId": "111122223333",
        "Description": "MyTGW",
        "CreationTime": "2019-07-10T14:02:12.000Z",
        "Options": {
            "AmazonSideAsn": 64516,
            "AutoAcceptSharedAttachments": "enable",
            "DefaultRouteTableAssociation": "enable",
            "AssociationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE",
            "DefaultRouteTablePropagation": "enable",
            "PropagationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE",
            "VpnEcmpSupport": "enable",
            "DnsSupport": "enable"
        }
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイの作成」を参照してください。

  • API 詳細については、「 コマンドリファレンスCreateTransitGateway」の「」を参照してください。 AWS CLI

次のコード例は、create-verified-access-endpoint を使用する方法を示しています。

AWS CLI

Verified Access エンドポイントを作成するには

次のcreate-verified-access-endpoint例では、指定された Verified Access グループの Verified Access エンドポイントを作成します。指定されたネットワークインターフェイスとセキュリティグループは、同じ に属している必要がありますVPC。

aws ec2 create-verified-access-endpoint \
    --verified-access-group-id vagr-0dbe967baf14b7235 \
    --endpoint-type network-interface \
    --attachment-type vpc \
    --domain-certificate-arn arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE \
    --application-domain example.com \
    --endpoint-domain-prefix my-ava-app \
    --security-group-ids sg-004915970c4c8f13a \
    --network-interface-options NetworkInterfaceId=eni-0aec70418c8d87a0f,Protocol=https,Port=443 \
    --tag-specifications ResourceType=verified-access-endpoint,Tags=[{Key=Name,Value=my-va-endpoint}]

出力:

{
    "VerifiedAccessEndpoint": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
        "VerifiedAccessEndpointId": "vae-066fac616d4d546f2",
        "ApplicationDomain": "example.com",
        "EndpointType": "network-interface",
        "AttachmentType": "vpc",
        "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE",
        "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com",
        "SecurityGroupIds": [
            "sg-004915970c4c8f13a"
        ],
        "NetworkInterfaceOptions": {
            "NetworkInterfaceId": "eni-0aec70418c8d87a0f",
            "Protocol": "https",
            "Port": 443
        },
        "Status": {
            "Code": "pending"
        },
        "Description": "",
        "CreationTime": "2023-08-25T20:54:43",
        "LastUpdatedTime": "2023-08-25T20:54:43",
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-va-endpoint"
            }
        ]
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access エンドポイント」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスCreateVerifiedAccessEndpoint」の「」を参照してください。 AWS CLI

次のコード例は、create-verified-access-group を使用する方法を示しています。

AWS CLI

Verified Access グループを作成するには

次のcreate-verified-access-group例では、指定された Verified Access インスタンスの Verified Access グループを作成します。

aws ec2 create-verified-access-group \
    --verified-access-instance-id vai-0ce000c0b7643abea \
    --tag-specifications ResourceType=verified-access-group,Tags=[{Key=Name,Value=my-va-group}]

出力:

{
    "VerifiedAccessGroup": {
        "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "",
        "Owner": "123456789012",
        "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235",
        "CreationTime": "2023-08-25T19:55:19",
        "LastUpdatedTime": "2023-08-25T19:55:19",
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-va-group"
            }
        ]
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access グループ」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスCreateVerifiedAccessGroup」の「」を参照してください。 AWS CLI

次の例は、create-verified-access-instance を使用する方法を説明しています。

AWS CLI

Verified Access インスタンスを作成するには

次のcreate-verified-access-instance例では、Name タグを使用して Verified Access インスタンスを作成します。

aws ec2 create-verified-access-instance \
    --tag-specifications ResourceType=verified-access-instance,Tags=[{Key=Name,Value=my-va-instance}]

出力:

{
    "VerifiedAccessInstance": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "",
        "VerifiedAccessTrustProviders": [],
        "CreationTime": "2023-08-25T18:27:56",
        "LastUpdatedTime": "2023-08-25T18:27:56",
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-va-instance"
            }
        ]
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access インスタンス」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスCreateVerifiedAccessInstance」の「」を参照してください。 AWS CLI

次のコード例は、create-verified-access-trust-provider を使用する方法を示しています。

AWS CLI

Verified Access 信頼プロバイダーを作成するには

次のcreate-verified-access-trust-provider例では、 AWS Identity Center を使用して Verified Access 信頼プロバイダーを設定します。

aws ec2 create-verified-access-trust-provider \
    --trust-provider-type user \
    --user-trust-provider-type iam-identity-center \
    --policy-reference-name idc \
    --tag-specifications ResourceType=verified-access-trust-provider,Tags=[{Key=Name,Value=my-va-trust-provider}]

出力:

{
    "VerifiedAccessTrustProvider": {
        "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
        "Description": "",
        "TrustProviderType": "user",
        "UserTrustProviderType": "iam-identity-center",
        "PolicyReferenceName": "idc",
        "CreationTime": "2023-08-25T18:40:36",
        "LastUpdatedTime": "2023-08-25T18:40:36",
        "Tags": [
            {
                "Key": "Name",
                "Value": "my-va-trust-provider"
            }
        ]
    }
}

詳細については、Verified Access ユーザーガイドの「Verified Access の信頼プロバイダーAWS 」を参照してください。

次のコード例は、create-volume を使用する方法を示しています。

AWS CLI

空の汎用 SSD (gp2) ボリュームを作成するには

次のcreate-volume例では、指定されたアベイラビリティーゾーンに 80 GiB の汎用 SSD (gp2) ボリュームを作成します。現在のリージョンは である必要があります。またはus-east-1、 --regionパラメータを追加してコマンドのリージョンを指定することもできます。

aws ec2 create-volume \
    --volume-type gp2 \
    --size 80 \
    --availability-zone us-east-1a

出力:

{
    "AvailabilityZone": "us-east-1a",
    "Tags": [],
    "Encrypted": false,
    "VolumeType": "gp2",
    "VolumeId": "vol-1234567890abcdef0",
    "State": "creating",
    "Iops": 240,
    "SnapshotId": "",
    "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z",
    "Size": 80
}

ボリュームタイプを指定しない場合、デフォルトのボリュームタイプは ですgp2。

aws ec2 create-volume \
    --size 80 \
    --availability-zone us-east-1a

例 2: スナップショットからプロビジョニングされた IOPS SSD (io1) ボリュームを作成するには

次のcreate-volume例では、指定されたスナップショットを使用して、指定されたアベイラビリティーゾーンIOPSに 1000 個のプロビジョニングされたプロビジョンド IOPS SSD (io1) ボリュームを作成します。

aws ec2 create-volume \
    --volume-type io1 \
    --iops 1000 \
    --snapshot-id snap-066877671789bd71b \
    --availability-zone us-east-1a

出力:

{
    "AvailabilityZone": "us-east-1a",
    "Tags": [],
    "Encrypted": false,
    "VolumeType": "io1",
    "VolumeId": "vol-1234567890abcdef0",
    "State": "creating",
    "Iops": 1000,
    "SnapshotId": "snap-066877671789bd71b",
    "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z",
    "Size": 500
}

例 3: 暗号化されたボリュームを作成するには

次のcreate-volume例では、デフォルトの を使用してCMKEBS暗号化されたボリュームを作成します。暗号化がデフォルトで無効になっている場合は、次のように --encryptedパラメータを指定する必要があります。

aws ec2 create-volume \
    --size 80 \
    --encrypted \
    --availability-zone us-east-1a

出力:

{
    "AvailabilityZone": "us-east-1a",
    "Tags": [],
    "Encrypted": true,
    "VolumeType": "gp2",
    "VolumeId": "vol-1234567890abcdef0",
    "State": "creating",
    "Iops": 240,
    "SnapshotId": "",
    "CreateTime": "YYYY-MM-DDTHH:MM:SS.000Z",
    "Size": 80
}

暗号化がデフォルトで有効になっている場合、次のコマンド例では、 --encryptedパラメータがなくても暗号化されたボリュームを作成します。

aws ec2 create-volume \
    --size 80 \
    --availability-zone us-east-1a

--kms-key-id パラメータを使用してカスタマー管理の を指定する場合はCMK、デフォルトで暗号化が有効になっている場合でも、 --encryptedパラメータを指定する必要があります。

aws ec2 create-volume \
    --volume-type gp2 \
    --size 80 \
    --encrypted \
    --kms-key-id 0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE \
    --availability-zone us-east-1a

例 4: タグを使用してボリュームを作成するには

次のcreate-volume例では、ボリュームを作成し、2 つのタグを追加します。

aws ec2 create-volume \
    --availability-zone us-east-1a \
    --volume-type gp2 \
    --size 80 \
    --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'

  • API 詳細については、「 コマンドリファレンスCreateVolume」の「」を参照してください。 AWS CLI

次のコード例は、create-vpc-endpoint-connection-notification を使用する方法を示しています。

AWS CLI

エンドポイント接続通知を作成するには

この例では、インターフェイスエンドポイントがサービスに接続され、エンドポイントがサービスに受け入れられたときに警告する、特定のエンドポイントサービスの通知を作成します。

コマンド:

aws ec2 create-vpc-endpoint-connection-notification --connection-notification-arn arn:aws:sns:us-east-2:123456789012:VpceNotification --connection-events Connect Accept --service-id vpce-svc-1237881c0d25a3abc

出力:

{
   "ConnectionNotification": {
       "ConnectionNotificationState": "Enabled",
       "ConnectionNotificationType": "Topic",
       "ServiceId": "vpce-svc-1237881c0d25a3abc",
       "ConnectionEvents": [
           "Accept",
           "Connect"
       ],
       "ConnectionNotificationId": "vpce-nfn-008776de7e03f5abc",
       "ConnectionNotificationArn": "arn:aws:sns:us-east-2:123456789012:VpceNotification"
   }
 }

次の例は、create-vpc-endpoint-service-configuration を使用する方法を説明しています。

AWS CLI

例 1: インターフェイスエンドポイントのエンドポイントサービス設定を作成するには

次のcreate-vpc-endpoint-service-configuration例では、Network Load Balancer を使用してVPCエンドポイントサービス設定を作成しますnlb-vpce。この例では、インターフェイスエンドポイントを介してサービスに接続するリクエストを受け入れる必要があることも指定しています。

aws ec2 create-vpc-endpoint-service-configuration \
    --network-load-balancer-arns arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/nlb-vpce/e94221227f1ba532 \
    --acceptance-required

出力:

{
   "ServiceConfiguration": {
       "ServiceType": [
           {
               "ServiceType": "Interface"
           }
       ],
       "NetworkLoadBalancerArns": [
           "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/nlb-vpce/e94221227f1ba532"
       ],
       "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-03d5ebb7d9579a2b3",
       "ServiceState": "Available",
       "ServiceId": "vpce-svc-03d5ebb7d9579a2b3",
       "AcceptanceRequired": true,
       "AvailabilityZones": [
           "us-east-1d"
       ],
       "BaseEndpointDnsNames": [
           "vpce-svc-03d5ebb7d9579a2b3.us-east-1.vpce.amazonaws.com"
       ]
   }
}

例 2: Gateway Load Balancer エンドポイントのエンドポイントサービス設定を作成するには

次のcreate-vpc-endpoint-service-configuration例では、Gateway Load Balancer を使用してVPCエンドポイントサービス設定を作成しますGWLBService。Gateway Load Balancer エンドポイントを介してサービスに接続するリクエストは自動的に受け入れられます。

aws ec2 create-vpc-endpoint-service-configuration \
    --gateway-load-balancer-arns arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/gwy/GWLBService/123123123123abcc \
    --no-acceptance-required

出力:

{
    "ServiceConfiguration": {
        "ServiceType": [
            {
                "ServiceType": "GatewayLoadBalancer"
            }
        ],
        "ServiceId": "vpce-svc-123123a1c43abc123",
        "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123",
        "ServiceState": "Available",
        "AvailabilityZones": [
            "us-east-1d"
        ],
        "AcceptanceRequired": false,
        "ManagesVpcEndpoints": false,
        "GatewayLoadBalancerArns": [
            "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/gwy/GWLBService/123123123123abcc"
        ]
    }
}

詳細については、「Amazon ユーザーガイド」の「 VPCエンドポイントサービス」を参照してください。 VPC

次のコード例は、create-vpc-endpoint を使用する方法を示しています。

AWS CLI

例 1: ゲートウェイエンドポイントを作成するには

次のcreate-vpc-endpoint例では、 us-east-1リージョンで VPCvpc-1a2b3c4dと Amazon S3 の間にゲートウェイVPCエンドポイントを作成し、ルートテーブルをエンドポイントrtb-11aa22bbに関連付けます。

aws ec2 create-vpc-endpoint \
    --vpc-id vpc-1a2b3c4d \
    --service-name com.amazonaws.us-east-1.s3 \
    --route-table-ids rtb-11aa22bb

出力:

{
    "VpcEndpoint": {
        "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"\*\",\"Action\":\"\*\",\"Resource\":\"\*\"}]}",
        "VpcId": "vpc-1a2b3c4d",
        "State": "available",
        "ServiceName": "com.amazonaws.us-east-1.s3",
        "RouteTableIds": [
            "rtb-11aa22bb"
        ],
        "VpcEndpointId": "vpc-1a2b3c4d",
        "CreationTimestamp": "2015-05-15T09:40:50Z"
    }
}

詳細については、「 AWS PrivateLink ガイド」の「ゲートウェイエンドポイントの作成」を参照してください。

例 2: インターフェイスエンドポイントを作成するには

次のcreate-vpc-endpoint例では、 us-east-1リージョンで VPCvpc-1a2b3c4dと Amazon S3 の間にインターフェイスVPCエンドポイントを作成します。コマンドは、サブネット にエンドポイントを作成しsubnet-1a2b3c4d、セキュリティグループ に関連付けsg-1a2b3c4d、キーが「Service」、値が「S3」のタグを追加します。

aws ec2 create-vpc-endpoint \
    --vpc-id vpc-1a2b3c4d \
    --vpc-endpoint-type Interface \
    --service-name com.amazonaws.us-east-1.s3 \
    --subnet-ids subnet-7b16de0c \
    --security-group-id sg-1a2b3c4d \
    --tag-specifications ResourceType=vpc-endpoint,Tags=[{Key=service,Value=S3}]

出力:

{
    "VpcEndpoint": {
        "VpcEndpointId": "vpce-1a2b3c4d5e6f1a2b3",
        "VpcEndpointType": "Interface",
        "VpcId": "vpc-1a2b3c4d",
        "ServiceName": "com.amazonaws.us-east-1.s3",
        "State": "pending",
        "RouteTableIds": [],
        "SubnetIds": [
            "subnet-1a2b3c4d"
        ],
        "Groups": [
            {
                "GroupId": "sg-1a2b3c4d",
                "GroupName": "default"
            }
        ],
        "PrivateDnsEnabled": false,
        "RequesterManaged": false,
        "NetworkInterfaceIds": [
            "eni-0b16f0581c8ac6877"
        ],
        "DnsEntries": [
            {
                "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg.s3.us-east-1.vpce.amazonaws.com",
                "HostedZoneId": "Z7HUB22UULQXV"
            },
            {
                "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg-us-east-1c.s3.us-east-1.vpce.amazonaws.com",
                "HostedZoneId": "Z7HUB22UULQXV"
            }
        ],
        "CreationTimestamp": "2021-03-05T14:46:16.030000+00:00",
        "Tags": [
            {
                "Key": "service",
                "Value": "S3"
            }
        ],
        "OwnerId": "123456789012"
    }
}

詳細については、「 ユーザーガイド」の「インターフェイスエンドポイントの作成 AWS PrivateLink」を参照してください。

例 3: Gateway Load Balancer エンドポイントを作成するには

次のcreate-vpc-endpoint例では、 VPCvpc-111122223333aabbcと の間に Gateway Load Balancer エンドポイントを作成し、Gateway Load Balancer を使用して設定されたサービスを作成します。

aws ec2 create-vpc-endpoint \
    --service-name com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123 \
    --vpc-endpoint-type GatewayLoadBalancer \
    --vpc-id vpc-111122223333aabbc \
    --subnet-ids subnet-0011aabbcc2233445

出力:

{
    "VpcEndpoint": {
        "VpcEndpointId": "vpce-aabbaabbaabbaabba",
        "VpcEndpointType": "GatewayLoadBalancer",
        "VpcId": "vpc-111122223333aabbc",
        "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123",
        "State": "pending",
        "SubnetIds": [
            "subnet-0011aabbcc2233445"
        ],
        "RequesterManaged": false,
        "NetworkInterfaceIds": [
            "eni-01010120203030405"
        ],
        "CreationTimestamp": "2020-11-11T08:06:03.522Z",
        "OwnerId": "123456789012"
    }
}

詳細については、「 ユーザーガイド」の「Gateway Load Balancer エンドポイント」を参照してください。 AWS PrivateLink

  • API 詳細については、「 コマンドリファレンスCreateVpcEndpoint」の「」を参照してください。 AWS CLI

次のコード例は、create-vpc-peering-connection を使用する方法を示しています。

AWS CLI

間でVPCピアリング接続を作成するには VPCs

この例では、vpc-1a2b3c4d VPCs と vpc-11122233 の間のピアリング接続をリクエストします。

コマンド:

aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233

出力:

{
    "VpcPeeringConnection": {
        "Status": {
            "Message": "Initiating Request to 444455556666",
            "Code": "initiating-request"
        },
        "Tags": [],
        "RequesterVpcInfo": {
            "OwnerId": "444455556666",
            "VpcId": "vpc-1a2b3c4d",
            "CidrBlock": "10.0.0.0/28"
        },
        "VpcPeeringConnectionId": "pcx-111aaa111",
        "ExpirationTime": "2014-04-02T16:13:36.000Z",
        "AccepterVpcInfo": {
            "OwnerId": "444455556666",
            "VpcId": "vpc-11122233"
        }
    }
}

VPC別のアカウントの とのVPCピアリング接続を作成するには

この例では、 アカウント 123456789012 に属する VPC (vpc-1a2b3c4d) と VPC (vpc-11122233) AWS の間のピアリング接続をリクエストします。

コマンド:

aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 --peer-owner-id 123456789012

VPC別のリージョンの とのVPCピアリング接続を作成するには

この例では、現在のリージョン (vpc-1a2b3c4d) VPCの とus-west-2、リージョンのアカウント VPC (vpc-11122233) の間のピアリング接続をリクエストします。

コマンド:

aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 --peer-region us-west-2

この例では、現在のリージョン (vpc-1a2b3c4d) VPCの と、us-west-2リージョンにある AWS アカウント 123456789012 に属する VPC (vpc-11122233) との間のピアリング接続をリクエストします。

コマンド:

aws ec2 create-vpc-peering-connection --vpc-id vpc-1a2b3c4d --peer-vpc-id vpc-11122233 --peer-owner-id 123456789012 --peer-region us-west-2

  • API 詳細については、「 コマンドリファレンスCreateVpcPeeringConnection」の「」を参照してください。 AWS CLI

次の例は、create-vpc を使用する方法を説明しています。

AWS CLI

例 1: を作成するには VPC

次のcreate-vpc例では、指定されたIPv4CIDRブロックと名前タグVPCを使用して を作成します。

aws ec2 create-vpc \
    --cidr-block 10.0.0.0/16 \
    --tag-specifications ResourceType=vpc,Tags=[{Key=Name,Value=MyVpc}]

出力:

{
    "Vpc": {
        "CidrBlock": "10.0.0.0/16",
        "DhcpOptionsId": "dopt-5EXAMPLE",
        "State": "pending",
        "VpcId": "vpc-0a60eb65b4EXAMPLE",
        "OwnerId": "123456789012",
        "InstanceTenancy": "default",
        "Ipv6CidrBlockAssociationSet": [],
        "CidrBlockAssociationSet": [
            {
                "AssociationId": "vpc-cidr-assoc-07501b79ecEXAMPLE",
                "CidrBlock": "10.0.0.0/16",
                "CidrBlockState": {
                    "State": "associated"
                }
            }
        ],
        "IsDefault": false,
        "Tags": [
            {
                "Key": "Name",
                "Value": MyVpc"
            }
        ]
    }
}

例 2: 専用テナンシーVPCで を作成するには

次のcreate-vpc例では、指定されたIPv4CIDRブロックと専用テナンシーVPCを使用して を作成します。

aws ec2 create-vpc \
    --cidr-block 10.0.0.0/16 \
    --instance-tenancy dedicated

出力:

{
    "Vpc": {
        "CidrBlock": "10.0.0.0/16",
        "DhcpOptionsId": "dopt-19edf471",
        "State": "pending",
        "VpcId": "vpc-0a53287fa4EXAMPLE",
        "OwnerId": "111122223333",
        "InstanceTenancy": "dedicated",
        "Ipv6CidrBlockAssociationSet": [],
        "CidrBlockAssociationSet": [
            {
                "AssociationId": "vpc-cidr-assoc-00b24cc1c2EXAMPLE",
                "CidrBlock": "10.0.0.0/16",
                "CidrBlockState": {
                    "State": "associated"
                }
            }
        ],
        "IsDefault": false
    }
}

例 3: IPv6CIDRブロックVPCを使用して を作成するには

次のcreate-vpc例では、Amazon が提供する IPv6 CIDR ブロックVPCを使用して を作成します。

aws ec2 create-vpc \
    --cidr-block 10.0.0.0/16 \
    --amazon-provided-ipv6-cidr-block

出力:

{
    "Vpc": {
        "CidrBlock": "10.0.0.0/16",
        "DhcpOptionsId": "dopt-dEXAMPLE",
        "State": "pending",
        "VpcId": "vpc-0fc5e3406bEXAMPLE",
        "OwnerId": "123456789012",
        "InstanceTenancy": "default",
        "Ipv6CidrBlockAssociationSet": [
            {
                "AssociationId": "vpc-cidr-assoc-068432c60bEXAMPLE",
                "Ipv6CidrBlock": "",
                "Ipv6CidrBlockState": {
                    "State": "associating"
                },
                "Ipv6Pool": "Amazon",
                "NetworkBorderGroup": "us-west-2"
            }
        ],
        "CidrBlockAssociationSet": [
            {
                "AssociationId": "vpc-cidr-assoc-0669f8f9f5EXAMPLE",
                "CidrBlock": "10.0.0.0/16",
                "CidrBlockState": {
                    "State": "associated"
                }
            }
        ],
        "IsDefault": false
    }
}

例 4: IPAM プールCIDRから VPCを使用して を作成するには

次のcreate-vpc例では、Amazon VPC IP Address Manager (IPAM) プールCIDRから VPCを使用して を作成します。

Linux および macOS:

aws ec2 create-vpc \
    --ipv4-ipam-pool-id ipam-pool-0533048da7d823723 \
    --tag-specifications ResourceType=vpc,Tags='[{Key=Environment,Value="Preprod"},{Key=Owner,Value="Build Team"}]'

Windows ：

aws ec2 create-vpc ^
    --ipv4-ipam-pool-id ipam-pool-0533048da7d823723 ^
    --tag-specifications ResourceType=vpc,Tags=[{Key=Environment,Value="Preprod"},{Key=Owner,Value="Build Team"}]

出力:

{
    "Vpc": {
        "CidrBlock": "10.0.1.0/24",
        "DhcpOptionsId": "dopt-2afccf50",
        "State": "pending",
        "VpcId": "vpc-010e1791024eb0af9",
        "OwnerId": "123456789012",
        "InstanceTenancy": "default",
        "Ipv6CidrBlockAssociationSet": [],
        "CidrBlockAssociationSet": [
            {
                "AssociationId": "vpc-cidr-assoc-0a77de1d803226d4b",
                "CidrBlock": "10.0.1.0/24",
                "CidrBlockState": {
                    "State": "associated"
                }
            }
        ],
        "IsDefault": false,
        "Tags": [
            {
                "Key": "Environment",
                "Value": "Preprod"
            },
            {
                "Key": "Owner",
                "Value": "Build Team"
            }
        ]
    }
}

詳細については、「Amazon ユーザーガイド」のVPCIPAM「プールを使用する を作成するCIDR」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスCreateVpc」の「」を参照してください。 AWS CLI

次の例は、create-vpn-connection-route を使用する方法を説明しています。

AWS CLI

VPN接続の静的ルートを作成するには

この例では、指定されたVPN接続の静的ルートを作成します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 create-vpn-connection-route --vpn-connection-id vpn-40f41529 --destination-cidr-block 11.12.0.0/16

  • API 詳細については、「 コマンドリファレンスCreateVpnConnectionRoute」の「」を参照してください。 AWS CLI

次のコード例は、create-vpn-connection を使用する方法を示しています。

AWS CLI

例 1: 動的ルーティングを使用してVPN接続を作成するには

次のcreate-vpn-connection例では、指定された仮想プライベートゲートウェイと指定されたカスタマーゲートウェイ間のVPN接続を作成し、VPN接続にタグを適用します。出力には、カスタマーゲートウェイデバイスの構成情報が XML形式で含まれます。

aws ec2 create-vpn-connection \
    --type ipsec.1 \
    --customer-gateway-id cgw-001122334455aabbc \
    --vpn-gateway-id vgw-1a1a1a1a1a1a2b2b2 \
    --tag-specification 'ResourceType=vpn-connection,Tags=[{Key=Name,Value=BGP-VPN}]'

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "...configuration information...",
        "CustomerGatewayId": "cgw-001122334455aabbc",
        "Category": "VPN",
        "State": "pending",
        "VpnConnectionId": "vpn-123123123123abcab",
        "VpnGatewayId": "vgw-1a1a1a1a1a1a2b2b2",
        "Options": {
            "EnableAcceleration": false,
            "StaticRoutesOnly": false,
            "LocalIpv4NetworkCidr": "0.0.0.0/0",
            "RemoteIpv4NetworkCidr": "0.0.0.0/0",
            "TunnelInsideIpVersion": "ipv4",
            "TunnelOptions": [
                {},
                {}
            ]
        },
        "Routes": [],
        "Tags": [
             {
                "Key": "Name",
                "Value": "BGP-VPN"
            }
        ]
    }
}

詳細については、AWS 「 Site-to-Site ユーザーガイド」の「Site-to-Site のVPN仕組み」を参照してください。 AWS VPN

例 2: 静的ルーティングを使用してVPN接続を作成するには

次のcreate-vpn-connection例では、指定された仮想プライベートゲートウェイと指定されたカスタマーゲートウェイ間のVPN接続を作成します。オプションは静的ルーティングを指定します。出力には、カスタマーゲートウェイデバイスの構成情報が XML形式で含まれます。

aws ec2 create-vpn-connection \
    --type ipsec.1 \
    --customer-gateway-id cgw-001122334455aabbc \
    --vpn-gateway-id vgw-1a1a1a1a1a1a2b2b2 \
    --options "{\"StaticRoutesOnly\":true}"

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "..configuration information...",
        "CustomerGatewayId": "cgw-001122334455aabbc",
        "Category": "VPN",
        "State": "pending",
        "VpnConnectionId": "vpn-123123123123abcab",
        "VpnGatewayId": "vgw-1a1a1a1a1a1a2b2b2",
        "Options": {
            "EnableAcceleration": false,
            "StaticRoutesOnly": true,
            "LocalIpv4NetworkCidr": "0.0.0.0/0",
            "RemoteIpv4NetworkCidr": "0.0.0.0/0",
            "TunnelInsideIpVersion": "ipv4",
            "TunnelOptions": [
                {},
                {}
            ]
        },
        "Routes": [],
        "Tags": []
    }
}

詳細については、AWS 「 Site-to-Site ユーザーガイド」の「Site-to-Site のVPN仕組み」を参照してください。 AWS VPN

例 3: VPN接続を作成し、独自の内部キーCIDRと事前共有キーを指定するには

次のcreate-vpn-connection例では、VPN接続を作成し、トンネルごとに内部 IP アドレスCIDRブロックとカスタム事前共有キーを指定します。指定された値はCustomerGatewayConfiguration情報で返されます。

aws ec2 create-vpn-connection \
    --type ipsec.1 \
    --customer-gateway-id cgw-001122334455aabbc \
    --vpn-gateway-id vgw-1a1a1a1a1a1a2b2b2 \
    --options TunnelOptions='[{TunnelInsideCidr=169.254.12.0/30,PreSharedKey=ExamplePreSharedKey1},{TunnelInsideCidr=169.254.13.0/30,PreSharedKey=ExamplePreSharedKey2}]'

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "..configuration information...",
        "CustomerGatewayId": "cgw-001122334455aabbc",
        "Category": "VPN",
        "State": "pending",
        "VpnConnectionId": "vpn-123123123123abcab",
        "VpnGatewayId": "vgw-1a1a1a1a1a1a2b2b2",
        "Options": {
            "EnableAcceleration": false,
            "StaticRoutesOnly": false,
            "LocalIpv4NetworkCidr": "0.0.0.0/0",
            "RemoteIpv4NetworkCidr": "0.0.0.0/0",
            "TunnelInsideIpVersion": "ipv4",
            "TunnelOptions": [
                {
                    "OutsideIpAddress": "203.0.113.3",
                    "TunnelInsideCidr": "169.254.12.0/30",
                    "PreSharedKey": "ExamplePreSharedKey1"
                },
                {
                    "OutsideIpAddress": "203.0.113.5",
                    "TunnelInsideCidr": "169.254.13.0/30",
                    "PreSharedKey": "ExamplePreSharedKey2"
                }
            ]
        },
        "Routes": [],
        "Tags": []
    }
}

詳細については、AWS 「 Site-to-Site ユーザーガイド」の「Site-to-Site のVPN仕組み」を参照してください。 AWS VPN

例 4: IPv6トラフィックをサポートするVPN接続を作成するには

次のcreate-vpn-connection例では、指定されたトランジットゲートウェイと指定されたカスタマーゲートウェイ間のIPv6トラフィックをサポートするVPN接続を作成します。両方のトンネルのトンネルオプションは、 IKE がネゴシエーションを開始 AWS する必要があることを指定します。

aws ec2 create-vpn-connection \
    --type ipsec.1 \
    --transit-gateway-id tgw-12312312312312312 \
    --customer-gateway-id cgw-001122334455aabbc \
    --options TunnelInsideIpVersion=ipv6,TunnelOptions=[{StartupAction=start},{StartupAction=start}]

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "..configuration information...",
        "CustomerGatewayId": "cgw-001122334455aabbc",
        "Category": "VPN",
        "State": "pending",
        "VpnConnectionId": "vpn-11111111122222222",
        "TransitGatewayId": "tgw-12312312312312312",
        "Options": {
            "EnableAcceleration": false,
            "StaticRoutesOnly": false,
            "LocalIpv6NetworkCidr": "::/0",
            "RemoteIpv6NetworkCidr": "::/0",
            "TunnelInsideIpVersion": "ipv6",
            "TunnelOptions": [
                {
                    "OutsideIpAddress": "203.0.113.3",
                    "StartupAction": "start"
                },
                {
                    "OutsideIpAddress": "203.0.113.5",
                    "StartupAction": "start"
                }
            ]
        },
        "Routes": [],
        "Tags": []
    }
}

詳細については、AWS 「 Site-to-Site ユーザーガイド」の「Site-to-Site のVPN仕組み」を参照してください。 AWS VPN

  • API 詳細については、「 コマンドリファレンスCreateVpnConnection」の「」を参照してください。 AWS CLI

次のコード例は、create-vpn-gateway を使用する方法を示しています。

AWS CLI

仮想プライベートゲートウェイを作成するには

この例では、仮想プライベートゲートウェイを作成します。

コマンド:

aws ec2 create-vpn-gateway --type ipsec.1

出力:

{
    "VpnGateway": {
        "AmazonSideAsn": 64512,
        "State": "available",
        "Type": "ipsec.1",
        "VpnGatewayId": "vgw-9a4cacf3",
        "VpcAttachments": []
    }
}

特定の Amazon 側で仮想プライベートゲートウェイを作成するには ASN

この例では、仮想プライベートゲートウェイを作成し、BGPセッションの Amazon 側の自律システム番号 (ASN) を指定します。

コマンド:

aws ec2 create-vpn-gateway --type ipsec.1 --amazon-side-asn 65001

出力:

{
    "VpnGateway": {
        "AmazonSideAsn": 65001,
        "State": "available",
        "Type": "ipsec.1",
        "VpnGatewayId": "vgw-9a4cacf3",
        "VpcAttachments": []
    }
}

  • API 詳細については、「 コマンドリファレンスCreateVpnGateway」の「」を参照してください。 AWS CLI

次のコード例は、delete-carrier-gateway を使用する方法を示しています。

AWS CLI

キャリアゲートウェイを削除するには

次のdelete-carrier-gateway例では、指定されたキャリアゲートウェイを削除します。

aws ec2 delete-carrier-gateway \
    --carrier-gateway-id cagw-0465cdEXAMPLE1111

出力:

{
    "CarrierGateway": {
        "CarrierGatewayId": "cagw-0465cdEXAMPLE1111",
        "VpcId": "vpc-0c529aEXAMPLE1111",
        "State": "deleting",
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon Virtual Private Cloud ユーザーガイド」の「キャリアゲートウェイ」を参照してください。 Amazon Virtual Private Cloud

  • API 詳細については、「 コマンドリファレンスDeleteCarrierGateway」の「」を参照してください。 AWS CLI

次のコード例は、delete-client-vpn-endpoint を使用する方法を示しています。

AWS CLI

クライアントVPNエンドポイントを削除するには

次のdelete-client-vpn-endpoint例では、指定されたクライアントVPNエンドポイントを削除します。

aws ec2 delete-client-vpn-endpoint \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "Status": {
        "Code": "deleting"
    }
}

詳細については、「 クライアント管理者ガイド」の「クライアントVPNエンドポイント」を参照してください。 AWS VPN

  • API 詳細については、「 コマンドリファレンスDeleteClientVpnEndpoint」の「」を参照してください。 AWS CLI

次の例は、delete-client-vpn-route を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントのルートを削除するには

次のdelete-client-vpn-route例では、クライアントVPNエンドポイントの指定されたサブネットの0.0.0.0/0ルートを削除します。

aws ec2 delete-client-vpn-route \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --destination-cidr-block 0.0.0.0/0 \
    --target-vpc-subnet-id subnet-0123456789abcabca

出力:

{
    "Status": {
        "Code": "deleting"
    }
}

詳細については、AWS クライアントVPN管理者ガイドの「ルート」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteClientVpnRoute」の「」を参照してください。 AWS CLI

次のコード例は、delete-coip-cidr を使用する方法を示しています。

AWS CLI

カスタマー所有 IP (CoIP) アドレスの範囲を削除するには

次のdelete-coip-cidr例では、指定された CoIP プール内の指定された範囲の CoIP アドレスを削除します。

aws ec2 delete-coip-cidr \
    --cidr 14.0.0.0/24 \
    --coip-pool-id ipv4pool-coip-1234567890abcdefg

出力:

{
    "CoipCidr": {
        "Cidr": "14.0.0.0/24",
        "CoipPoolId": "ipv4pool-coip-1234567890abcdefg",
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890"
    }
}

CoIP の詳細については、AWS Outposts ユーザーガイドの「カスタマー所有の IP アドレス」を参照してください 。

  • API 詳細については、「 コマンドリファレンスDeleteCoipCidr」の「」を参照してください。 AWS CLI

次の例は、delete-coip-pool を使用する方法を説明しています。

AWS CLI

カスタマー所有 IP (CoIP) アドレスのプールを削除するには

次のdelete-coip-pool例では、CoIP アドレスの CoIP プールを削除します。

aws ec2 delete-coip-pool \
    --coip-pool-id ipv4pool-coip-1234567890abcdefg

出力:

{
    "CoipPool": {
        "PoolId": "ipv4pool-coip-1234567890abcdefg",
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890",
        "PoolArn": "arn:aws:ec2:us-west-2:123456789012:coip-pool/ipv4pool-coip-1234567890abcdefg"
    }
}

CoIP の詳細については、AWS Outposts ユーザーガイドの「カスタマー所有の IP アドレス」を参照してください 。

  • API 詳細については、「 コマンドリファレンスDeleteCoipPool」の「」を参照してください。 AWS CLI

次のコード例は、delete-customer-gateway を使用する方法を示しています。

AWS CLI

カスタマーゲートウェイを削除するには

この例では、指定されたカスタマーゲートウェイを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-customer-gateway --customer-gateway-id cgw-0e11f167

  • API 詳細については、「 コマンドリファレンスDeleteCustomerGateway」の「」を参照してください。 AWS CLI

次の例は、delete-dhcp-options を使用する方法を説明しています。

AWS CLI

DHCPオプションセットを削除するには

この例では、指定されたDHCPオプションセットを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-dhcp-options --dhcp-options-id dopt-d9070ebb

  • API 詳細については、「 コマンドリファレンスDeleteDhcpOptions」の「」を参照してください。 AWS CLI

次の例は、delete-egress-only-internet-gateway を使用する方法を説明しています。

AWS CLI

Egress-Only インターネットゲートウェイを削除するには

この例では、指定された Egress-Only インターネットゲートウェイを削除します。

コマンド:

aws ec2 delete-egress-only-internet-gateway --egress-only-internet-gateway-id eigw-01eadbd45ecd7943f

出力:

{
  "ReturnCode": true
}

次のコード例は、delete-fleets を使用する方法を示しています。

AWS CLI

例 1: EC2 フリートを削除して関連するインスタンスを終了するには

次のdelete-fleets例では、指定されたEC2フリートを削除し、関連付けられたオンデマンドインスタンスとスポットインスタンスを終了します。

aws ec2 delete-fleets \
    --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \
    --terminate-instances

出力:

{
    "SuccessfulFleetDeletions": [
        {
            "CurrentFleetState": "deleted_terminating",
            "PreviousFleetState": "active",
            "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
        }
    ],
    "UnsuccessfulFleetDeletions": []
}

詳細については、Linux インスタンス用 Amazon EC2 Elastic Compute Cloud ユーザーガイドの「フリートの削除」を参照してください。

例 2: EC2 関連付けられたインスタンスを終了せずにフリートを削除するには

次のdelete-fleets例では、関連付けられたオンデマンドインスタンスとスポットインスタンスを終了せずに、指定されたEC2フリートを削除します。

aws ec2 delete-fleets \
    --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \
    --no-terminate-instances

出力:

{
    "SuccessfulFleetDeletions": [
        {
            "CurrentFleetState": "deleted_running",
            "PreviousFleetState": "active",
            "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
        }
    ],
    "UnsuccessfulFleetDeletions": []
}

詳細については、Linux インスタンス用 Amazon EC2 Elastic Compute Cloud ユーザーガイドの「フリートの削除」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteFleets」の「」を参照してください。 AWS CLI

次のコード例は、delete-flow-logs を使用する方法を示しています。

AWS CLI

フローログを削除するには

次のdelete-flow-logs例では、指定されたフローログを削除します。

aws ec2 delete-flow-logs --flow-log-id fl-11223344556677889

出力:

{
    "Unsuccessful": []
}

  • API 詳細については、「 コマンドリファレンスDeleteFlowLogs」の「」を参照してください。 AWS CLI

次の例は、delete-fpga-image を使用する方法を説明しています。

AWS CLI

Amazon FPGAイメージを削除するには

この例では、指定された を削除しますAFI。

コマンド:

aws ec2 delete-fpga-image --fpga-image-id afi-06b12350a123fbabc

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスDeleteFpgaImage」の「」を参照してください。 AWS CLI

次のコード例は、delete-instance-connect-endpoint を使用する方法を示しています。

AWS CLI

EC2 Instance Connect Endpoint を削除するには

次のdelete-instance-connect-endpoint例では、指定された EC2 Instance Connect Endpoint を削除します。

aws ec2 delete-instance-connect-endpoint \
    --instance-connect-endpoint-id eice-03f5e49b83924bbc7

出力:

{
    "InstanceConnectEndpoint": {
        "OwnerId": "111111111111",
        "InstanceConnectEndpointId": "eice-0123456789example",
        "InstanceConnectEndpointArn": "arn:aws:ec2:us-east-1:111111111111:instance-connect-endpoint/eice-0123456789example",
        "State": "delete-in-progress",
        "StateMessage": "",
        "NetworkInterfaceIds": [],
        "VpcId": "vpc-0123abcd",
        "AvailabilityZone": "us-east-1d",
        "CreatedAt": "2023-02-07T12:05:37+00:00",
        "SubnetId": "subnet-0123abcd"
    }
}

詳細については、「Amazon ユーザーガイド」のEC2「インスタンス接続エンドポイントの削除」を参照してください。 EC2

次のコード例は、delete-instance-event-window を使用する方法を示しています。

AWS CLI

例 1: イベントウィンドウを削除するには

次のdelete-instance-event-window例では、イベントウィンドウを削除します。

aws ec2 delete-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890

出力:

{
    "InstanceEventWindowState": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "State": "deleting"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 2: イベントウィンドウを強制的に削除するには

次のdelete-instance-event-window例では、イベントウィンドウが現在ターゲットに関連付けられている場合、強制的にイベントウィンドウを削除します。

aws ec2 delete-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --force-delete

出力:

{
    "InstanceEventWindowState": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "State": "deleting"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteInstanceEventWindow」の「」を参照してください。 AWS CLI

次のコード例は、delete-internet-gateway を使用する方法を示しています。

AWS CLI

インターネットゲートウェイを削除するには

次のdelete-internet-gateway例では、指定されたインターネットゲートウェイを削除します。

aws ec2 delete-internet-gateway \
    --internet-gateway-id igw-0d0fb496b3EXAMPLE

このコマンドでは何も出力されません。

詳細については、「Amazon VPCユーザーガイド」の「インターネットゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteInternetGateway」の「」を参照してください。 AWS CLI

次の例は、delete-ipam-pool を使用する方法を説明しています。

AWS CLI

IPAM プールを削除するには

この例では、不要になったIPAMプールを削除したいが、プールにCIDRプロビジョニングされたプールがあるIPAM委任管理者です。--cascade オプションを使用していなければ、プールがCIDRsプロビジョニングされている場合はプールを削除できないため、 を使用します--cascade。

このリクエストを完了するには：

で取得できるIPAMプール ID が必要ですdescribe-ipam-pools。 はIPAMホームリージョン--regionである必要があります。

次のdelete-ipam-pool例では、 AWS アカウントのIPAMプールを削除します。

aws ec2 delete-ipam-pool \
    --ipam-pool-id ipam-pool-050c886a3ca41cd5b \
    --cascade \
    --region us-east-1

出力:

{
    "IpamPool": {
        "OwnerId": "320805250157",
        "IpamPoolId": "ipam-pool-050c886a3ca41cd5b",
        "IpamPoolArn": "arn:aws:ec2::320805250157:ipam-pool/ipam-pool-050c886a3ca41cd5b",
        "IpamScopeArn": "arn:aws:ec2::320805250157:ipam-scope/ipam-scope-0a158dde35c51107b",
        "IpamScopeType": "private",
        "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107",
        "IpamRegion": "us-east-1",
        "Locale": "None",
        "PoolDepth": 1,
        "State": "delete-in-progress",
        "Description": "example",
        "AutoImport": false,
        "AddressFamily": "ipv4",
        "AllocationMinNetmaskLength": 0,
        "AllocationMaxNetmaskLength": 32
    }
}

詳細については、「Amazon ユーザーガイド」の「プールの削除」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスDeleteIpamPool」の「」を参照してください。 AWS CLI

次のコード例は、delete-ipam-resource-discovery を使用する方法を示しています。

AWS CLI

リソース検出を削除するには

この例では、委任IPAMされた管理者が、組織外のアカウントIPAMと統合するプロセス中に、別のIPAM管理者と共有するために作成したデフォルト以外のリソース検出を削除したいと考えています。

このリクエストを完了するには：

は、リソース検出を作成したリージョン--regionである必要があります。 の場合、デフォルトのリソース検出を削除することはできません"IsDefault": true。デフォルトのリソース検出は、 を作成するアカウントで自動的に作成されるものですIPAM。デフォルトのリソース検出を削除するには、 を削除する必要がありますIPAM。

次のdelete-ipam-resource-discovery例では、リソース検出を削除します。

aws ec2 delete-ipam-resource-discovery \
    --ipam-resource-discovery-id ipam-res-disco-0e39761475298ee0f \
    --region us-east-1

出力:

{
    "IpamResourceDiscovery": {
        "OwnerId": "149977607591",
        "IpamResourceDiscoveryId": "ipam-res-disco-0e39761475298ee0f",
        "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0e39761475298ee0f",
        "IpamResourceDiscoveryRegion": "us-east-1",
        "OperatingRegions": [
            {
                "RegionName": "us-east-1"
            }
        ],
        "IsDefault": false,
        "State": "delete-in-progress"
    }
}

リソース検出の詳細については、「Amazon VPC IPAM ユーザーガイド」の「リソース検出の操作」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteIpamResourceDiscovery」の「」を参照してください。 AWS CLI

次の例は、delete-ipam-scope を使用する方法を説明しています。

AWS CLI

IPAMスコープを削除するには

次のdelete-ipam-scope例では、 を削除しますIPAM。

aws ec2 delete-ipam-scope \
    --ipam-scope-id ipam-scope-01c1ebab2b63bd7e4

出力:

{
    "IpamScope": {
        "OwnerId": "123456789012",
        "IpamScopeId": "ipam-scope-01c1ebab2b63bd7e4",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-01c1ebab2b63bd7e4",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
        "IpamRegion": "us-east-1",
        "IpamScopeType": "private",
        "IsDefault": false,
        "Description": "Example description",
        "PoolCount": 0,
        "State": "delete-in-progress"
    }
}

詳細については、「Amazon ユーザーガイド」の「スコープの削除」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスDeleteIpamScope」の「」を参照してください。 AWS CLI

次のコード例は、delete-ipam を使用する方法を示しています。

AWS CLI

を削除するには IPAM

次のdelete-ipam例では、 を削除しますIPAM。

aws ec2 delete-ipam \
    --ipam-id ipam-036486dfa6af58ee0

出力:

{
    "Ipam": {
        "OwnerId": "123456789012",
        "IpamId": "ipam-036486dfa6af58ee0",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-036486dfa6af58ee0",
        "IpamRegion": "us-east-1",
        "PublicDefaultScopeId": "ipam-scope-071b8042b0195c183",
        "PrivateDefaultScopeId": "ipam-scope-0807405dece705a30",
        "ScopeCount": 2,
        "OperatingRegions": [
            {
                "RegionName": "us-east-1"
            },
            {
                "RegionName": "us-east-2"
            },
            {
                "RegionName": "us-west-1"
            }
        ],
        "State": "delete-in-progress"
    }
}

詳細については、「Amazon ユーザーガイド」の「 の削除IPAM」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスDeleteIpam」の「」を参照してください。 AWS CLI

次のコード例は、delete-key-pair を使用する方法を示しています。

AWS CLI

キーペアを削除するには

次のdelete-key-pair例では、指定されたキーペアを削除します。

aws ec2 delete-key-pair \
    --key-name my-key-pair

出力:

{
    "Return": true,
    "KeyPairId": "key-03c8d3aceb53b507"
}

詳細については、「 コマンドラインインターフェイスユーザーガイド」の「キーペアの作成と削除」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスDeleteKeyPair」の「」を参照してください。 AWS CLI

次の例は、delete-launch-template-versions を使用する方法を説明しています。

AWS CLI

起動テンプレートのバージョンを削除するには

この例では、指定された起動テンプレートのバージョンを削除します。

コマンド:

aws ec2 delete-launch-template-versions --launch-template-id lt-0abcd290751193123 --versions 1

出力:

{
  "UnsuccessfullyDeletedLaunchTemplateVersions": [],
  "SuccessfullyDeletedLaunchTemplateVersions": [
      {
          "LaunchTemplateName": "TestVersion",
          "VersionNumber": 1,
          "LaunchTemplateId": "lt-0abcd290751193123"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDeleteLaunchTemplateVersions」の「」を参照してください。 AWS CLI

次の例は、delete-launch-template を使用する方法を説明しています。

AWS CLI

起動テンプレートを削除するには

次の例では、指定した起動テンプレートを削除しています。

コマンド:

aws ec2 delete-launch-template --launch-template-id lt-0abcd290751193123

出力:

{
  "LaunchTemplate": {
      "LatestVersionNumber": 2,
      "LaunchTemplateId": "lt-0abcd290751193123",
      "LaunchTemplateName": "TestTemplate",
      "DefaultVersionNumber": 2,
      "CreatedBy": "arn:aws:iam::123456789012:root",
      "CreateTime": "2017-11-23T16:46:25.000Z"
  }
}

  • API 詳細については、「 コマンドリファレンスDeleteLaunchTemplate」の「」を参照してください。 AWS CLI

次の例は、delete-local-gateway-route-table-virtual-interface-group-association を使用する方法を説明しています。

AWS CLI

仮想インターフェイス (VIFs) グループからローカルゲートウェイルートテーブルの関連付けを解除するには

次のdelete-local-gateway-route-table-virtual-interface-group-association例では、指定されたローカルゲートウェイルートテーブルとVIFグループ間の関連付けを削除します。

aws ec2 delete-local-gateway-route-table-virtual-interface-group-association \
    --local-gateway-route-table-virtual-interface-group-association-id lgw-vif-grp-assoc-exampleid12345678

出力:

{
    "LocalGatewayRouteTableVirtualInterfaceGroupAssociation": {
        "LocalGatewayRouteTableVirtualInterfaceGroupAssociationId": "lgw-vif-grp-assoc-exampleid12345678",
        "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-exampleid0123abcd",
        "LocalGatewayId": "lgw-exampleid11223344",
        "LocalGatewayRouteTableId": "lgw-rtb-exampleidabcd1234",
        "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-exampleidabcd1234",
        "OwnerId": "111122223333",
        "State": "disassociating",
        "Tags": []
    }
}

詳細については、VIF「Outposts ユーザーガイド」の「グループの関連付けAWS 」を参照してください。

次の例は、delete-local-gateway-route-table-vpc-association を使用する方法を説明しています。

AWS CLI

ローカルゲートウェイルートテーブルと の関連付けを解除するには VPC

次のdelete-local-gateway-route-table-vpc-association例では、指定されたローカルゲートウェイルートテーブルと の間の関連付けを削除しますVPC。

aws ec2 delete-local-gateway-route-table-vpc-association \
    --local-gateway-route-table-vpc-association-id vpc-example0123456789

出力:

{
    "LocalGatewayRouteTableVpcAssociation": {
        "LocalGatewayRouteTableVpcAssociationId": "lgw-vpc-assoc-abcd1234wxyz56789",
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890",
        "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:555555555555:local-gateway-route-table/lgw-rtb-abcdefg1234567890",
        "LocalGatewayId": "lgw-exampleid01234567",
        "VpcId": "vpc-example0123456789",
        "OwnerId": "555555555555",
        "State": "disassociating"
    }
}

詳細については、VPC「Outposts ユーザーガイド」の「 の関連付けAWS 」を参照してください。

次の例は、delete-local-gateway-route-table を使用する方法を説明しています。

AWS CLI

ローカルゲートウェイルートテーブルを削除するには

次のdelete-local-gateway-route-table例では、ダイレクトルーティングモードでローカルゲートウェイVPCルートテーブルを作成します。

aws ec2 delete-local-gateway-route-table \
    --local-gateway-route-table-id lgw-rtb-abcdefg1234567890

出力:

{
    "LocalGatewayRouteTable": {
        "LocalGatewayRouteTableId": "lgw-rtb-abcdefg1234567890",
        "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:111122223333:local-gateway-route-table/lgw-rtb-abcdefg1234567890",
        "LocalGatewayId": "lgw-1a2b3c4d5e6f7g8h9",
        "OutpostArn": "arn:aws:outposts:us-west-2:111122223333:outpost/op-021345abcdef67890",
        "OwnerId": "111122223333",
        "State": "deleting",
        "Tags": [],
        "Mode": "direct-vpc-routing"
    }
}

詳細については、「AWS Outposts ユーザーガイド」の「ローカルゲートウェイテーブル」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteLocalGatewayRouteTable」の「」を参照してください。 AWS CLI

次の例は、delete-local-gateway-route を使用する方法を説明しています。

AWS CLI

ローカルゲートウェイルートテーブルからルートを削除するには

次のdelete-local-gateway-route例では、指定されたローカルゲートウェイルートテーブルから指定されたルートを削除します。

aws ec2 delete-local-gateway-route \
    --destination-cidr-block 0.0.0.0/0 \
    --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE

出力:

{
    "Route": {
        "DestinationCidrBlock": "0.0.0.0/0",
        "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE",
        "Type": "static",
        "State": "deleted",
        "LocalGatewayRouteTableId": "lgw-rtb-059615ef7EXAMPLE"
    }
}

  • API 詳細については、「 コマンドリファレンスDeleteLocalGatewayRoute」の「」を参照してください。 AWS CLI

次の例は、delete-managed-prefix-list を使用する方法を説明しています。

AWS CLI

プレフィックスリストを削除するには

次のdelete-managed-prefix-list例では、指定されたプレフィックスリストを削除します。

aws ec2 delete-managed-prefix-list \
    --prefix-list-id pl-0123456abcabcabc1

出力:

{
    "PrefixList": {
        "PrefixListId": "pl-0123456abcabcabc1",
        "AddressFamily": "IPv4",
        "State": "delete-in-progress",
        "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1",
        "PrefixListName": "test",
        "MaxEntries": 10,
        "Version": 1,
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon VPCユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteManagedPrefixList」の「」を参照してください。 AWS CLI

次の例は、delete-nat-gateway を使用する方法を説明しています。

AWS CLI

NATゲートウェイを削除するには

この例では、NATゲートウェイ を削除しますnat-04ae55e711cec5680。

コマンド:

aws ec2 delete-nat-gateway --nat-gateway-id nat-04ae55e711cec5680

出力:

{
   "NatGatewayId": "nat-04ae55e711cec5680"
}

  • API 詳細については、「 コマンドリファレンスDeleteNatGateway」の「」を参照してください。 AWS CLI

次の例は、delete-network-acl-entry を使用する方法を説明しています。

AWS CLI

ネットワークACLエントリを削除するには

この例では、指定されたネットワーク から進入ルール番号 100 を削除しますACL。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 100

  • API 詳細については、「 コマンドリファレンスDeleteNetworkAclEntry」の「」を参照してください。 AWS CLI

次のコード例は、delete-network-acl を使用する方法を示しています。

AWS CLI

ネットワークを削除するには ACL

この例では、指定されたネットワーク を削除しますACL。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-network-acl --network-acl-id acl-5fb85d36

  • API 詳細については、「 コマンドリファレンスDeleteNetworkAcl」の「」を参照してください。 AWS CLI

次の例は、delete-network-insights-access-scope-analysis を使用する方法を説明しています。

AWS CLI

ネットワークアクセススコープ分析を削除するには

次のdelete-network-insights-access-scope-analysis例では、指定されたネットワークアクセススコープ分析を削除します。

aws ec2 delete-network-insights-access-scope-analysis \
    --network-insights-access-scope-analysis-id nisa-01234567891abcdef

出力:

{
    "NetworkInsightsAccessScopeAnalysisId": "nisa-01234567891abcdef
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次の例は、delete-network-insights-access-scope を使用する方法を説明しています。

AWS CLI

ネットワークアクセススコープを削除するには

次のdelete-network-insights-access-scope例では、指定されたネットワークアクセススコープを削除します。

aws ec2 delete-network-insights-access-scope \
    --network-insights-access-scope-id nis-123456789abc01234

出力:

{
    "NetworkInsightsAccessScopeId": "nis-123456789abc01234"
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次のコード例は、delete-network-insights-analysis を使用する方法を示しています。

AWS CLI

パス分析を削除するには

次のdelete-network-insights-analysis例では、指定された分析を削除します。

aws ec2 delete-network-insights-analysis \
    --network-insights-analysis-id nia-02207aa13eb480c7a

出力:

{
    "NetworkInsightsAnalysisId": "nia-02207aa13eb480c7a"
}

詳細については、「Reachability Analyzer ガイド」の「 の使用開始 AWS CLI」を参照してください。

次のコード例は、delete-network-insights-path を使用する方法を示しています。

AWS CLI

パスを削除するには

次のdelete-network-insights-path例では、指定されたパスを削除します。パスを削除する前に、 delete-network-insights-analysis コマンドを使用してすべての分析を削除する必要があります。

aws ec2 delete-network-insights-path \
    --network-insights-path-id nip-0b26f224f1d131fa8

出力:

{
    "NetworkInsightsPathId": "nip-0b26f224f1d131fa8"
}

詳細については、「Reachability Analyzer ガイド」の「 の使用開始 AWS CLI」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteNetworkInsightsPath」の「」を参照してください。 AWS CLI

次の例は、delete-network-interface-permission を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスのアクセス許可を削除するには

この例では、指定されたネットワークインターフェイスのアクセス許可を削除します。

コマンド:

aws ec2 delete-network-interface-permission --network-interface-permission-id eni-perm-06fd19020ede149ea

出力:

{
  "Return": true
}

次のコード例は、delete-network-interface を使用する方法を示しています。

AWS CLI

ネットワークインターフェイスを削除するには

この例では、指定されたネットワークインターフェイスを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-network-interface --network-interface-id eni-e5aa89a3

  • API 詳細については、「 コマンドリファレンスDeleteNetworkInterface」の「」を参照してください。 AWS CLI

次の例は、delete-placement-group を使用する方法を説明しています。

AWS CLI

プレイスメントグループを削除するには

このコマンド例では、指定されたプレイスメントグループを削除します。

コマンド:

aws ec2 delete-placement-group --group-name my-cluster

  • API 詳細については、「 コマンドリファレンスDeletePlacementGroup」の「」を参照してください。 AWS CLI

次の例は、delete-queued-reserved-instances を使用する方法を説明しています。

AWS CLI

キューに入れられた購入を削除するには

次のdelete-queued-reserved-instances例では、購入キューに入れられた指定されたリザーブドインスタンスを削除します。

aws ec2 delete-queued-reserved-instances \
    --reserved-instances-ids af9f760e-6f91-4559-85f7-4980eexample

出力:

{
    "SuccessfulQueuedPurchaseDeletions": [
        {
            "ReservedInstancesId": "af9f760e-6f91-4559-85f7-4980eexample"
        }
    ],
    "FailedQueuedPurchaseDeletions": []
}

次のコード例は、delete-route-table を使用する方法を示しています。

AWS CLI

ルートテーブルを削除するには

この例では、指定されたルートテーブルを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-route-table --route-table-id rtb-22574640

  • API 詳細については、「 コマンドリファレンスDeleteRouteTable」の「」を参照してください。 AWS CLI

次のコード例は、delete-route を使用する方法を示しています。

AWS CLI

ルートを削除するには

この例では、指定されたルートテーブルから指定されたルートを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-route --route-table-id rtb-22574640 --destination-cidr-block 0.0.0.0/0

  • API 詳細については、「 コマンドリファレンスDeleteRoute」の「」を参照してください。 AWS CLI

次の例は、delete-security-group を使用する方法を説明しています。

AWS CLI

〔EC2-Classic] セキュリティグループを削除するには

この例では、MySecurityGroup という名前のセキュリティグループを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-security-group --group-name MySecurityGroup

〔EC2-VPC] セキュリティグループを削除するには

この例では、sg-903004f8 という ID のセキュリティグループを削除します。名前で EC2-VPC のセキュリティグループを参照することはできません。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-security-group --group-id sg-903004f8

詳細については、「AWS コマンドラインインターフェイスユーザーガイド」でセキュリティグループの使用方法を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteSecurityGroup」の「」を参照してください。 AWS CLI

次のコード例は、delete-snapshot を使用する方法を示しています。

AWS CLI

スナップショットを削除するには

このコマンド例は、スナップショット ID が snap-1234567890abcdef0 のスナップショットを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-snapshot --snapshot-id snap-1234567890abcdef0

  • API 詳細については、「 コマンドリファレンスDeleteSnapshot」の「」を参照してください。 AWS CLI

次の例は、delete-spot-datafeed-subscription を使用する方法を説明しています。

AWS CLI

スポットインスタンスのデータフィードサブスクリプションをキャンセルするには

このコマンド例では、アカウントのスポットデータフィードサブスクリプションを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-spot-datafeed-subscription

次のコード例は、delete-subnet-cidr-reservation を使用する方法を示しています。

AWS CLI

サブネットCIDR予約を削除するには

次のdelete-subnet-cidr-reservation例では、指定されたサブネットCIDR予約を削除します。

aws ec2 delete-subnet-cidr-reservation \
    --subnet-cidr-reservation-id scr-044f977c4eEXAMPLE

出力:

{
    "DeletedSubnetCidrReservation": {
        "SubnetCidrReservationId": "scr-044f977c4eEXAMPLE",
        "SubnetId": "subnet-03c51e2e6cEXAMPLE",
        "Cidr": "10.1.0.16/28",
        "ReservationType": "prefix",
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon ユーザーガイド」の「サブネットCIDR予約」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDeleteSubnetCidrReservation」の「」を参照してください。 AWS CLI

次のコード例は、delete-subnet を使用する方法を示しています。

AWS CLI

サブネットを削除するには

この例では、指定されたサブネットを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-subnet --subnet-id subnet-9d4a7b6c

  • API 詳細については、「 コマンドリファレンスDeleteSubnet」の「」を参照してください。 AWS CLI

次のコード例は、delete-tags を使用する方法を示しています。

AWS CLI

例 1: リソースからタグを削除するには

次のdelete-tags例では、指定したイメージStack=Testから タグを削除します。値とキー名の両方を指定すると、タグの値が指定された値と一致する場合にのみタグが削除されます。

aws ec2 delete-tags \
    --resources ami-1234567890abcdef0 \
    --tags Key=Stack,Value=Test

タグの値を指定するのはオプションです。次のdelete-tags例では、タグのタグ値に関係なく、指定されたインスタンスpurposeからキー名を持つタグを削除します。

aws ec2 delete-tags \
    --resources i-1234567890abcdef0 \
    --tags Key=purpose

空の文字列をタグ値として指定すると、タグの値が空の文字列である場合にのみタグが削除されます。次のdelete-tags例では、削除するタグのタグ値として空の文字列を指定します。

aws ec2 delete-tags \
    --resources i-1234567890abcdef0 \
    --tags Key=Name,Value=

例 2: 複数のリソースからタグを削除するには

次のdelete-tags例では、 インスタンスと の両方からタグ「Purpose=Test」を削除しますAMI。前の例に示すように、 コマンドからタグ値を省略できます。

aws ec2 delete-tags \
    --resources i-1234567890abcdef0 ami-1234567890abcdef0 \
    --tags Key=Purpose

  • API 詳細については、「 コマンドリファレンスDeleteTags」の「」を参照してください。 AWS CLI

次のコード例は、delete-traffic-mirror-filter-rule を使用する方法を示しています。

AWS CLI

トラフィックミラーフィルタールールを削除するには

次のdelete-traffic-mirror-filter-rule例では、指定されたトラフィックミラーフィルタールールを削除します。

aws ec2 delete-traffic-mirror-filter-rule \
    --traffic-mirror-filter-rule-id tmfr-081f71283bEXAMPLE

出力:

{
    "TrafficMirrorFilterRuleId": "tmfr-081f71283bEXAMPLE"
}

詳細については、「トラフィックミラーリングガイド」の「トラフィックミラーフィルタールールの変更AWS 」を参照してください。

次の例は、delete-traffic-mirror-filter を使用する方法を説明しています。

AWS CLI

トラフィックミラーフィルターを削除するには

次のdelete-traffic-mirror-filter例では、指定されたトラフィックミラーフィルターを削除します。

aws ec2 delete-traffic-mirror-filter \
    --traffic-mirror-filter-id tmf-0be0b25fcdEXAMPLE

出力:

{
    "TrafficMirrorFilterId": "tmf-0be0b25fcdEXAMPLE"
}

詳細については、「トラフィックミラーリングガイド」の「トラフィックミラーフィルタの削除AWS 」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteTrafficMirrorFilter」の「」を参照してください。 AWS CLI

次のコード例は、delete-traffic-mirror-session を使用する方法を示しています。

AWS CLI

トラフィックミラーセッションを削除するには

次のdelete-traffic-mirror-session例では、指定されたトラフィックミラーセッションを削除します。

aws ec2 delete-traffic-mirror-session \
    --traffic-mirror-session-id tms-0af3141ce5EXAMPLE

出力:

{
    "TrafficMirrorSessionId": "tms-0af3141ce5EXAMPLE"
}

詳細については、「 Traffic Mirroring Guide」の「Delete a Traffic Mirror SessionAWS 」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteTrafficMirrorSession」の「」を参照してください。 AWS CLI

次のコード例は、delete-traffic-mirror-target を使用する方法を示しています。

AWS CLI

トラフィックミラーターゲットを削除するには

次のdelete-traffic-mirror-target例では、指定されたトラフィックミラーターゲットを削除します。

aws ec2 delete-traffic-mirror-target \
    --traffic-mirror-target-id tmt-060f48ce9EXAMPLE

出力:

{
    "TrafficMirrorTargetId": "tmt-060f48ce9EXAMPLE"
}

詳細については、トラフィックミラーリングガイドの「トラフィックミラーターゲットの削除AWS 」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteTrafficMirrorTarget」の「」を参照してください。 AWS CLI

次の例は、delete-transit-gateway-connect-peer を使用する方法を説明しています。

AWS CLI

Transit Gateway Connect ピアを削除するには

次のdelete-transit-gateway-connect-peer例では、指定された Connect ピアを削除します。

aws ec2 delete-transit-gateway-connect-peer \
    --transit-gateway-connect-peer-id tgw-connect-peer-0666adbac4EXAMPLE

出力:

{
    "TransitGatewayConnectPeer": {
        "TransitGatewayAttachmentId": "tgw-attach-0f0927767cEXAMPLE",
        "TransitGatewayConnectPeerId": "tgw-connect-peer-0666adbac4EXAMPLE",
        "State": "deleting",
        "CreationTime": "2021-10-13T03:35:17.000Z",
        "ConnectPeerConfiguration": {
            "TransitGatewayAddress": "10.0.0.234",
            "PeerAddress": "172.31.1.11",
            "InsideCidrBlocks": [
                "169.254.6.0/29"
            ],
            "Protocol": "gre",
            "BgpConfigurations": [
                {
                    "TransitGatewayAsn": 64512,
                    "PeerAsn": 64512,
                    "TransitGatewayAddress": "169.254.6.2",
                    "PeerAddress": "169.254.6.1",
                    "BgpStatus": "down"
                },
                {
                    "TransitGatewayAsn": 64512,
                    "PeerAsn": 64512,
                    "TransitGatewayAddress": "169.254.6.3",
                    "PeerAddress": "169.254.6.1",
                    "BgpStatus": "down"
                }
            ]
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway Connect アタッチメント」および「Transit Gateway Connect ピア」を参照してください。

次の例は、delete-transit-gateway-connect を使用する方法を説明しています。

AWS CLI

Transit Gateway Connect アタッチメントを削除するには

次のdelete-transit-gateway-connect例では、指定された Connect アタッチメントを削除します。

aws ec2 delete-transit-gateway-connect \
    --transit-gateway-attachment-id tgw-attach-037012e5dcEXAMPLE

出力:

{
    "TransitGatewayConnect": {
        "TransitGatewayAttachmentId": "tgw-attach-037012e5dcEXAMPLE",
        "TransportTransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE",
        "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
        "State": "deleting",
        "CreationTime": "2021-03-09T19:59:17+00:00",
        "Options": {
            "Protocol": "gre"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway Connect アタッチメント」および「Transit Gateway Connect ピア」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteTransitGatewayConnect」の「」を参照してください。 AWS CLI

次の例は、delete-transit-gateway-multicast-domain を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイマルチキャストドメインを削除するには

次のdelete-transit-gateway-multicast-domain例では、指定されたマルチキャストドメインを削除します。

aws ec2 delete-transit-gateway-multicast-domain \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE

出力:

{
    "TransitGatewayMulticastDomain": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-02bb79002bEXAMPLE",
        "TransitGatewayId": "tgw-0d88d2d0d5EXAMPLE",
        "State": "deleting",
        "CreationTime": "2019-11-20T22:02:03.000Z"
    }
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストドメインの管理」を参照してください。

次の例は、delete-transit-gateway-peering-attachment を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイピアリングアタッチメントを削除するには

次のdelete-transit-gateway-peering-attachment例では、指定された Transit Gateway ピアリングアタッチメントを削除します。

aws ec2 delete-transit-gateway-peering-attachment \
    --transit-gateway-attachment-id tgw-attach-4455667788aabbccd

出力:

{
    "TransitGatewayPeeringAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd",
        "RequesterTgwInfo": {
            "TransitGatewayId": "tgw-123abc05e04123abc",
            "OwnerId": "123456789012",
            "Region": "us-west-2"
        },
        "AccepterTgwInfo": {
            "TransitGatewayId": "tgw-11223344aabbcc112",
            "OwnerId": "123456789012",
            "Region": "us-east-2"
        },
        "State": "deleting",
        "CreationTime": "2019-12-09T11:38:31.000Z"
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway ピアリングアタッチメント」を参照してください。

次の例は、delete-transit-gateway-policy-table を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイポリシーテーブルを削除するには

次のdelete-transit-gateway-policy-table例では、指定された Transit Gateway ポリシーテーブルを削除します。

aws ec2 delete-transit-gateway-policy-table \
    --transit-gateway-policy-table-id tgw-ptb-0a16f134b78668a81

出力:

{
    "TransitGatewayPolicyTables": [
        {
            "TransitGatewayPolicyTableId": "tgw-ptb-0a16f134b78668a81",
            "TransitGatewayId": "tgw-067f8505c18f0bd6e",
            "State": "deleting",
            "CreationTime": "2023-11-28T16:36:43+00:00",
            "Tags": []
        }
    ]
}

詳細については、「Transit Gateway ユーザーガイド」の「Transit Gateway ポリシーテーブル」を参照してください。

次の例は、delete-transit-gateway-prefix-list-reference を使用する方法を説明しています。

AWS CLI

プレフィックスリストリファレンスを削除するには

次のdelete-transit-gateway-prefix-list-reference例では、指定されたプレフィックスリストリファレンスを削除します。

aws ec2 delete-transit-gateway-prefix-list-reference \
    --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \
    --prefix-list-id pl-11111122222222333

出力:

{
    "TransitGatewayPrefixListReference": {
        "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123",
        "PrefixListId": "pl-11111122222222333",
        "PrefixListOwnerId": "123456789012",
        "State": "deleting",
        "Blackhole": false,
        "TransitGatewayAttachment": {
            "TransitGatewayAttachmentId": "tgw-attach-aabbccddaabbccaab",
            "ResourceType": "vpc",
            "ResourceId": "vpc-112233445566aabbc"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「プレフィックスリストリファレンス」を参照してください。

次の例は、delete-transit-gateway-route-table を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイルートテーブルを削除するには

次のdelete-transit-gateway-route-table例では、指定された Transit Gateway ルートテーブルを削除します。

aws ec2  delete-transit-gateway-route-table \
    --transit-gateway-route-table-id tgw-rtb-0b6f6aaa01EXAMPLE

出力:

{
    "TransitGatewayRouteTable": {
        "TransitGatewayRouteTableId": "tgw-rtb-0b6f6aaa01EXAMPLE",
        "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
        "State": "deleting",
        "DefaultAssociationRouteTable": false,
        "DefaultPropagationRouteTable": false,
        "CreationTime": "2019-07-17T20:27:26.000Z"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブルの削除」を参照してください。

次のコード例は、delete-transit-gateway-route を使用する方法を示しています。

AWS CLI

ルートテーブルからCIDRブロックを削除するには

次のdelete-transit-gateway-route例では、指定された Transit Gateway ルートテーブルから CIDRブロックを削除します。

aws ec2 delete-transit-gateway-route \
    --transit-gateway-route-table-id tgw-rtb-0b6f6aaa01EXAMPLE \
    --destination-cidr-block 10.0.2.0/24

出力:

{
    "Route": {
        "DestinationCidrBlock": "10.0.2.0/24",
        "TransitGatewayAttachments": [
            {
                "ResourceId": "vpc-0065acced4EXAMPLE",
                "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE",
                "ResourceType": "vpc"
            }
        ],
        "Type": "static",
        "State": "deleted"
    }
}

詳細については、「 Transit Gateways ガイド」の「静的ルートの削除」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteTransitGatewayRoute」の「」を参照してください。 AWS CLI

次のコード例は、delete-transit-gateway-vpc-attachment を使用する方法を示しています。

AWS CLI

トランジットゲートウェイアタッチメントを削除するには VPC

次のdelete-transit-gateway-vpc-attachment例では、指定されたVPC添付ファイルを削除します。

aws ec2 delete-transit-gateway-vpc-attachment \
    --transit-gateway-attachment-id tgw-attach-0d2c54bdbEXAMPLE

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-0d2c54bdb3EXAMPLE",
        "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
        "VpcId": "vpc-0065acced4f61c651",
        "VpcOwnerId": "111122223333",
        "State": "deleting",
        "CreationTime": "2019-07-17T16:04:27.000Z"
    }
}

詳細については、「 Transit Gateways ガイド」のVPC「添付ファイルの削除」を参照してください。

次のコード例は、delete-transit-gateway を使用する方法を示しています。

AWS CLI

トランジットゲートウェイを削除するには

次のdelete-transit-gateway例では、指定されたトランジットゲートウェイを削除します。

aws ec2  delete-transit-gateway \
    --transit-gateway-id tgw-01f04542b2EXAMPLE

出力:

{
    "TransitGateway": {
        "TransitGatewayId": "tgw-01f04542b2EXAMPLE",
        "State": "deleting",
        "OwnerId": "123456789012",
        "Description": "Example Transit Gateway",
        "CreationTime": "2019-08-27T15:04:35.000Z",
        "Options": {
            "AmazonSideAsn": 64515,
            "AutoAcceptSharedAttachments": "disable",
            "DefaultRouteTableAssociation": "enable",
            "AssociationDefaultRouteTableId": "tgw-rtb-0ce7a6948fEXAMPLE",
            "DefaultRouteTablePropagation": "enable",
            "PropagationDefaultRouteTableId": "tgw-rtb-0ce7a6948fEXAMPLE",
            "VpnEcmpSupport": "enable",
            "DnsSupport": "enable"
        }
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイの削除」を参照してください。

  • API 詳細については、「 コマンドリファレンスDeleteTransitGateway」の「」を参照してください。 AWS CLI

次のコード例は、delete-verified-access-endpoint を使用する方法を示しています。

AWS CLI

Verified Access エンドポイントを削除するには

次のdelete-verified-access-endpoint例では、指定された Verified Access エンドポイントを削除します。

aws ec2 delete-verified-access-endpoint \
    --verified-access-endpoint-id vae-066fac616d4d546f2

出力:

{
    "VerifiedAccessEndpoint": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
        "VerifiedAccessEndpointId": "vae-066fac616d4d546f2",
        "ApplicationDomain": "example.com",
        "EndpointType": "network-interface",
        "AttachmentType": "vpc",
        "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE",
        "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com",
        "SecurityGroupIds": [
            "sg-004915970c4c8f13a"
        ],
        "NetworkInterfaceOptions": {
            "NetworkInterfaceId": "eni-0aec70418c8d87a0f",
            "Protocol": "https",
            "Port": 443
        },
        "Status": {
            "Code": "deleting"
        },
        "Description": "Testing Verified Access",
        "CreationTime": "2023-08-25T20:54:43",
        "LastUpdatedTime": "2023-08-25T22:46:32"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access エンドポイント」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスDeleteVerifiedAccessEndpoint」の「」を参照してください。 AWS CLI

次のコード例は、delete-verified-access-group を使用する方法を示しています。

AWS CLI

Verified Access グループを削除するには

次のdelete-verified-access-group例では、指定された Verified Access グループを削除します。

aws ec2 delete-verified-access-group \
    --verified-access-group-id vagr-0dbe967baf14b7235

出力:

{
    "VerifiedAccessGroup": {
        "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "Testing Verified Access",
        "Owner": "123456789012",
        "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235",
        "CreationTime": "2023-08-25T19:55:19",
        "LastUpdatedTime": "2023-08-25T22:49:03",
        "DeletionTime": "2023-08-26T00:58:31"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access グループ」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスDeleteVerifiedAccessGroup」の「」を参照してください。 AWS CLI

次のコード例は、delete-verified-access-instance を使用する方法を示しています。

AWS CLI

Verified Access インスタンスを削除するには

次のdelete-verified-access-instance例では、指定された Verified Access インスタンスを削除します。

aws ec2 delete-verified-access-instance \
    --verified-access-instance-id vai-0ce000c0b7643abea

出力:

{
    "VerifiedAccessInstance": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "Testing Verified Access",
        "VerifiedAccessTrustProviders": [],
        "CreationTime": "2023-08-25T18:27:56",
        "LastUpdatedTime": "2023-08-26T01:00:18"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access インスタンス」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスDeleteVerifiedAccessInstance」の「」を参照してください。 AWS CLI

次のコード例は、delete-verified-access-trust-provider を使用する方法を示しています。

AWS CLI

Verified Access 信頼プロバイダーを削除するには

次のdelete-verified-access-trust-provider例では、指定された Verified Access 信頼プロバイダーを削除します。

aws ec2 delete-verified-access-trust-provider \
    --verified-access-trust-provider-id vatp-0bb32de759a3e19e7

出力:

{
    "VerifiedAccessTrustProvider": {
        "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
        "Description": "Testing Verified Access",
        "TrustProviderType": "user",
        "UserTrustProviderType": "iam-identity-center",
        "PolicyReferenceName": "idc",
        "CreationTime": "2023-08-25T18:40:36",
        "LastUpdatedTime": "2023-08-25T18:40:36"
    }
}

詳細については、Verified Access ユーザーガイドの「Verified Access の信頼プロバイダーAWS 」を参照してください。

次の例は、delete-volume を使用する方法を説明しています。

AWS CLI

ボリュームを削除するには

このコマンド例では、ボリューム ID が の使用可能なボリュームを削除しますvol-049df61146c4d7901。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-volume --volume-id vol-049df61146c4d7901

  • API 詳細については、「 コマンドリファレンスDeleteVolume」の「」を参照してください。 AWS CLI

次のコード例は、delete-vpc-endpoint-connection-notifications を使用する方法を示しています。

AWS CLI

エンドポイント接続通知を削除するには

この例では、指定されたエンドポイント接続通知を削除します。

コマンド:

aws ec2 delete-vpc-endpoint-connection-notifications --connection-notification-ids vpce-nfn-008776de7e03f5abc

出力:

{
  "Unsuccessful": []
}

次のコード例は、delete-vpc-endpoint-service-configurations を使用する方法を示しています。

AWS CLI

エンドポイントサービス設定を削除するには

この例では、指定されたエンドポイントサービス設定を削除します。

コマンド:

aws ec2 delete-vpc-endpoint-service-configurations --service-ids vpce-svc-03d5ebb7d9579a2b3

出力:

{
   "Unsuccessful": []
}

次のコード例は、delete-vpc-endpoints を使用する方法を示しています。

AWS CLI

エンドポイントを削除するには

この例では、エンドポイント vpce-aa22bb33 と vpce-1a2b3c4d を削除します。コマンドが部分的に成功または失敗した場合、失敗した項目のリストが返されます。コマンドが成功すると、返されるリストは空になります。

コマンド:

aws ec2 delete-vpc-endpoints --vpc-endpoint-ids vpce-aa22bb33 vpce-1a2b3c4d

出力:

{
  "Unsuccessful": []
}

  • API 詳細については、「 コマンドリファレンスDeleteVpcEndpoints」の「」を参照してください。 AWS CLI

次のコード例は、delete-vpc-peering-connection を使用する方法を示しています。

AWS CLI

VPCピアリング接続を削除するには

この例では、指定されたVPCピアリング接続を削除します。

コマンド:

aws ec2 delete-vpc-peering-connection --vpc-peering-connection-id pcx-1a2b3c4d

出力:

{
    "Return": true
}

  • API 詳細については、「 コマンドリファレンスDeleteVpcPeeringConnection」の「」を参照してください。 AWS CLI

次の例は、delete-vpc を使用する方法を説明しています。

AWS CLI

を削除するには VPC

この例では、指定された を削除しますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-vpc --vpc-id vpc-a01106c2

  • API 詳細については、「 コマンドリファレンスDeleteVpc」の「」を参照してください。 AWS CLI

次のコード例は、delete-vpn-connection-route を使用する方法を示しています。

AWS CLI

VPN接続から静的ルートを削除するには

この例では、指定されたVPN接続から指定された静的ルートを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-vpn-connection-route --vpn-connection-id vpn-40f41529 --destination-cidr-block 11.12.0.0/16

  • API 詳細については、「 コマンドリファレンスDeleteVpnConnectionRoute」の「」を参照してください。 AWS CLI

次のコード例は、delete-vpn-connection を使用する方法を示しています。

AWS CLI

VPN接続を削除するには

この例では、指定されたVPN接続を削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-vpn-connection --vpn-connection-id vpn-40f41529

  • API 詳細については、「 コマンドリファレンスDeleteVpnConnection」の「」を参照してください。 AWS CLI

次のコード例は、delete-vpn-gateway を使用する方法を示しています。

AWS CLI

仮想プライベートゲートウェイを削除するには

この例では、指定された仮想プライベートゲートウェイを削除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 delete-vpn-gateway --vpn-gateway-id vgw-9a4cacf3

  • API 詳細については、「 コマンドリファレンスDeleteVpnGateway」の「」を参照してください。 AWS CLI

次のコード例は、deprovision-byoip-cidr を使用する方法を示しています。

AWS CLI

IP アドレス範囲を使用から削除するには

次の例では、指定されたアドレス範囲を での使用から削除します AWS。

aws ec2 deprovision-byoip-cidr \
    --cidr 203.0.113.25/24

出力:

{
    "ByoipCidr": {
        "Cidr": "203.0.113.25/24",
        "State": "pending-deprovision"
    }
}

  • API 詳細については、「 コマンドリファレンスDeprovisionByoipCidr」の「」を参照してください。 AWS CLI

次のコード例は、deprovision-ipam-pool-cidr を使用する方法を示しています。

AWS CLI

IPAM プールのプロビジョニングを解除するには CIDR

次のdeprovision-ipam-pool-cidr例では、プロビジョニングCIDRされた をIPAMプールにプロビジョニング解除します。

(Linux):

aws ec2 deprovision-ipam-pool-cidr \
    --ipam-pool-id ipam-pool-02ec043a19bbe5d08 \
    --cidr 11.0.0.0/16

(Windows):

aws ec2 deprovision-ipam-pool-cidr ^
    --ipam-pool-id ipam-pool-02ec043a19bbe5d08 ^
    --cidr 11.0.0.0/16

出力:

{
    "IpamPoolCidr": {
        "Cidr": "11.0.0.0/16",
        "State": "pending-deprovision"
    }
}

詳細については、「Amazon ユーザーガイド」の「プールのプロビジョニングCIDRs解除」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスDeprovisionIpamPoolCidr」の「」を参照してください。 AWS CLI

次の例は、deregister-image を使用する方法を説明しています。

AWS CLI

の登録を解除するには AMI

この例では、指定された を登録解除しますAMI。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 deregister-image --image-id ami-4fa54026

  • API 詳細については、「 コマンドリファレンスDeregisterImage」の「」を参照してください。 AWS CLI

次のコード例は、deregister-instance-event-notification-attributes を使用する方法を示しています。

AWS CLI

例 1: イベント通知からすべてのタグを削除するには

次のderegister-instance-event-notification-attributes例ではIncludeAllTagsOfInstance=true、 を IncludeAllTagsOfInstanceに設定する効果がある を削除しますfalse。

aws ec2 deregister-instance-event-notification-attributes \
    --instance-tag-attribute IncludeAllTagsOfInstance=true

出力:

{
    "InstanceTagAttribute": {
        "InstanceTagKeys": [],
        "IncludeAllTagsOfInstance": true
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのスケジュールされたイベント」を参照してください。

例 2: イベント通知から特定のタグを削除するには

次のderegister-instance-event-notification-attributes例では、イベント通知に含まれるタグから指定されたタグを削除します。イベント通知に含まれる残りのタグを記述するには、 を使用しますdescribe-instance-event-notification-attributes。

aws ec2 deregister-instance-event-notification-attributes \
    --instance-tag-attribute InstanceTagKeys="tag-key2"

出力:

{
    "InstanceTagAttribute": {
        "InstanceTagKeys": [
            "tag-key2"
        ],
        "IncludeAllTagsOfInstance": false
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのスケジュールされたイベント」を参照してください。

次の例は、deregister-transit-gateway-multicast-group-members を使用する方法を説明しています。

AWS CLI

マルチキャストグループからグループメンバーの登録を解除するには

この例では、指定されたネットワークインターフェイスグループメンバーをトランジットゲートウェイマルチキャストグループから登録解除します。

aws ec2 deregister-transit-gateway-multicast-group-members \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE \
    --group-ip-address 224.0.1.0 \
    --network-interface-ids eni-0e246d3269EXAMPLE

出力:

{
    "DeregisteredMulticastGroupMembers": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef7EXAMPLE",
        "RegisteredNetworkInterfaceIds": [
            "eni-0e246d3269EXAMPLE"
        ],
        "GroupIpAddress": "224.0.1.0"
    }
}

詳細については、「 Transit Gateways ユーザーガイド」の「マルチキャストグループからメンバーを登録解除する」を参照してください。 AWS

次のコード例は、deregister-transit-gateway-multicast-group-source を使用する方法を示しています。

AWS CLI

Transit Gateway マルチキャストグループからソースを登録解除するには

この例では、指定されたネットワークインターフェイスグループソースをマルチキャストグループから登録解除します。

aws ec2 register-transit-gateway-multicast-group-sources \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \
    --group-ip-address 224.0.1.0 \
    --network-interface-ids eni-07f290fc3c090cbae

出力:

{
    "DeregisteredMulticastGroupSources": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597",
        "DeregisteredNetworkInterfaceIds": [
            "eni-07f290fc3c090cbae"
        ],
        "GroupIpAddress": "224.0.1.0"
    }
}

詳細については、「 Transit Gateways ユーザーガイド」の「マルチキャストグループからソースを登録解除する」を参照してください。 AWS

次のコード例は、describe-account-attributes を使用する方法を示しています。

AWS CLI

AWS アカウントのすべての属性を記述するには

この例では、 AWS アカウントの属性について説明します。

コマンド:

aws ec2 describe-account-attributes

出力:

{
    "AccountAttributes": [
        {
            "AttributeName": "vpc-max-security-groups-per-interface",
            "AttributeValues": [
                {
                    "AttributeValue": "5"
                }
            ]
        },
        {
            "AttributeName": "max-instances",
            "AttributeValues": [
                {
                    "AttributeValue": "20"
                }
            ]
        },
        {
            "AttributeName": "supported-platforms",
            "AttributeValues": [
                {
                    "AttributeValue": "EC2"
                },
                {
                    "AttributeValue": "VPC"
                }
            ]
        },
        {
            "AttributeName": "default-vpc",
            "AttributeValues": [
                {
                    "AttributeValue": "none"
                }
            ]
        },
        {
            "AttributeName": "max-elastic-ips",
            "AttributeValues": [
                {
                    "AttributeValue": "5"
                }
            ]
        },
        {
            "AttributeName": "vpc-max-elastic-ips",
            "AttributeValues": [
                {
                    "AttributeValue": "5"
                }
            ]
        }
    ]
}

AWS アカウントの単一の属性を記述するには

この例では、 AWS アカウントの supported-platforms 属性について説明します。

コマンド:

aws ec2 describe-account-attributes --attribute-names supported-platforms

出力:

{
    "AccountAttributes": [
        {
            "AttributeName": "supported-platforms",
            "AttributeValues": [
                {
                    "AttributeValue": "EC2"
                },
                {
                    "AttributeValue": "VPC"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeAccountAttributes」の「」を参照してください。 AWS CLI

次のコード例は、describe-address-transfers を使用する方法を示しています。

AWS CLI

Elastic IP アドレス転送を記述するには

次のdescribe-address-transfers例では、指定された Elastic IP アドレスの Elastic IP アドレス転送について説明します。

aws ec2 describe-address-transfers \
    --allocation-ids eipalloc-09ad461b0d03f6aaf

出力:

{
    "AddressTransfers": [
        {
            "PublicIp": "100.21.184.216",
            "AllocationId": "eipalloc-09ad461b0d03f6aaf",
            "TransferAccountId": "123456789012",
            "TransferOfferExpirationTimestamp": "2023-02-22T22:51:01.000Z",
            "AddressTransferStatus": "pending"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレスの転送」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDescribeAddressTransfers」の「」を参照してください。 AWS CLI

次のコード例は、describe-addresses-attribute を使用する方法を示しています。

AWS CLI

Elastic IP アドレスに関連付けられたドメイン名の属性を表示するには

次のdescribe-addresses-attribute例では、Elastic IP アドレスに関連付けられたドメイン名の属性を返します。

Linux ：

aws ec2 describe-addresses-attribute \
    --allocation-ids eipalloc-abcdef01234567890 \
    --attribute domain-name

Windows ：

aws ec2 describe-addresses-attribute ^
    --allocation-ids eipalloc-abcdef01234567890 ^
    --attribute domain-name

出力:

{
    "Addresses": [
        {
            "PublicIp": "192.0.2.0",
            "AllocationId": "eipalloc-abcdef01234567890",
            "PtrRecord": "example.com."
        }
    ]
}

Elastic IP アドレスの属性を表示するには、まずドメイン名を Elastic IP アドレスに関連付ける必要があります。詳細については、「Amazon EC2 ユーザーガイドDNS」または「 コマンドリファレンス」の「E メールアプリケーションにリバースAWS CLIを使用する」を参照してください。 modify-address-attribute

  • API 詳細については、「 コマンドリファレンスDescribeAddressesAttribute」の「」を参照してください。 AWS CLI

次のコード例は、describe-addresses を使用する方法を示しています。

AWS CLI

例 1: すべての Elastic IP アドレスに関する詳細を取得するには

次の describe addresses の例では、Elastic IP アドレスに関する詳細が表示されます。

aws ec2 describe-addresses

出力:

{
    "Addresses": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "PublicIp": "198.51.100.0",
            "PublicIpv4Pool": "amazon",
            "Domain": "standard"
        },
        {
            "Domain": "vpc",
            "PublicIpv4Pool": "amazon",
            "InstanceId": "i-1234567890abcdef0",
            "NetworkInterfaceId": "eni-12345678",
            "AssociationId": "eipassoc-12345678",
            "NetworkInterfaceOwnerId": "123456789012",
            "PublicIp": "203.0.113.0",
            "AllocationId": "eipalloc-12345678",
            "PrivateIpAddress": "10.0.1.241"
        }
    ]
}

例 2: EC2- の Elastic IP アドレスの詳細を取得するにはVPC

次のdescribe-addresses例では、 のインスタンスで使用する Elastic IP アドレスの詳細を表示しますVPC。

aws ec2 describe-addresses \
    --filters "Name=domain,Values=vpc"

出力:

{
    "Addresses": [
        {
            "Domain": "vpc",
            "PublicIpv4Pool": "amazon",
            "InstanceId": "i-1234567890abcdef0",
            "NetworkInterfaceId": "eni-12345678",
            "AssociationId": "eipassoc-12345678",
            "NetworkInterfaceOwnerId": "123456789012",
            "PublicIp": "203.0.113.0",
            "AllocationId": "eipalloc-12345678",
            "PrivateIpAddress": "10.0.1.241"
        }
    ]
}

例 3: 割り当て ID で指定された Elastic IP アドレスに関する詳細を取得するには

次のdescribe-addresses例では、 EC2- のインスタンスに関連付けられている、指定された割り当て ID を持つ Elastic IP アドレスの詳細を表示しますVPC。

aws ec2 describe-addresses \
    --allocation-ids eipalloc-282d9641

出力:

{
    "Addresses": [
        {
            "Domain": "vpc",
            "PublicIpv4Pool": "amazon",
            "InstanceId": "i-1234567890abcdef0",
            "NetworkInterfaceId": "eni-1a2b3c4d",
            "AssociationId": "eipassoc-123abc12",
            "NetworkInterfaceOwnerId": "1234567891012",
            "PublicIp": "203.0.113.25",
            "AllocationId": "eipalloc-282d9641",
            "PrivateIpAddress": "10.251.50.12"
        }
    ]
}

例 4: VPCプライベート IP アドレスで指定された Elastic IP アドレスの詳細を取得するには

次のdescribe-addresses例では、 EC2- の特定のプライベート IP アドレスに関連付けられた Elastic IP アドレスの詳細を表示しますVPC。

aws ec2 describe-addresses \
    --filters "Name=private-ip-address,Values=10.251.50.12"

例 5: EC2-Classic の Elastic IP アドレスの詳細を取得するには

TThe 次のdescribe-addresses例では、EC2-Classic で使用する Elastic IP アドレスの詳細を表示します。

aws ec2 describe-addresses \
    --filters "Name=domain,Values=standard"

出力:

{
    "Addresses": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "PublicIp": "203.0.110.25",
            "PublicIpv4Pool": "amazon",
            "Domain": "standard"
        }
    ]
}

例 6: パブリック IP アドレスで指定された Elastic IP アドレスに関する詳細を取得するには

次のdescribe-addresses例では、EC2-Classic のインスタンス203.0.110.25に関連付けられている値 を持つ Elastic IP アドレスの詳細を表示します。

aws ec2 describe-addresses \
    --public-ips 203.0.110.25

出力:

{
    "Addresses": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "PublicIp": "203.0.110.25",
            "PublicIpv4Pool": "amazon",
            "Domain": "standard"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeAddresses」の「」を参照してください。 AWS CLI

次のコード例は、describe-aggregate-id-format を使用する方法を示しています。

AWS CLI

リージョン内のすべてのリソースタイプの長い ID 形式設定を記述するには

次のdescribe-aggregate-id-format例では、現在のリージョンの全体的なロング ID 形式ステータスについて説明します。Deadline 値は、これらのリソースが短縮 ID 形式から長い ID 形式に永続的に切り替える期限が切れたことを示します。UseLongIdsAggregated 値は、すべてのIAMユーザーとIAMロールがすべてのリソースタイプに長い ID 形式を使用するように設定されていることを示します。

aws ec2 describe-aggregate-id-format

出力:

{
    "UseLongIdsAggregated": true,
    "Statuses": [
        {
            "Deadline": "2018-08-13T02:00:00.000Z",
            "Resource": "network-interface-attachment",
            "UseLongIds": true
        },
        {
            "Deadline": "2016-12-13T02:00:00.000Z",
            "Resource": "instance",
            "UseLongIds": true
        },
        {
            "Deadline": "2018-08-13T02:00:00.000Z",
            "Resource": "elastic-ip-association",
            "UseLongIds": true
        },
        ...
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeAggregateIdFormat」の「」を参照してください。 AWS CLI

次のコード例は、describe-availability-zones を使用する方法を示しています。

AWS CLI

アベイラビリティーゾーンを説明するには

次の describe-availability-zones の例では、利用可能なアベイラビリティーゾーンの詳細が表示されます。レスポンスには、現在のリージョンのアベイラビリティーゾーンのみが含まれます。この例では、デフォルトの us-west-2 (オレゴン) リージョンのプロファイルを使用しています。

aws ec2 describe-availability-zones

出力:

{
    "AvailabilityZones": [
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2a",
            "ZoneId": "usw2-az1",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2b",
            "ZoneId": "usw2-az2",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2c",
            "ZoneId": "usw2-az3",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2d",
            "ZoneId": "usw2-az4",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opted-in",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2-lax-1a",
            "ZoneId": "usw2-lax1-az1",
            "GroupName": "us-west-2-lax-1",
            "NetworkBorderGroup": "us-west-2-lax-1"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeAvailabilityZones」の「」を参照してください。 AWS CLI

次の例は、describe-aws-network-performance-metric-subscription を使用する方法を説明しています。

AWS CLI

メトリクスサブスクリプションを記述するには

次のdescribe-aws-network-performance-metric-subscriptions例では、メトリクスサブスクリプションについて説明します。

aws ec2 describe-aws-network-performance-metric-subscriptions

出力:

{
    "Subscriptions": [
        {
            "Source": "us-east-1",
            "Destination": "eu-west-1",
            "Metric": "aggregate-latency",
            "Statistic": "p50",
            "Period": "five-minutes"
        }
    ]
}

詳細については、「インフラストラクチャパフォーマンスユーザーガイド」の「サブスクリプションの管理」を参照してください。

次の例は、describe-aws-network-performance-metric-subscriptions を使用する方法を説明しています。

AWS CLI

メトリクスサブスクリプションを記述するには

次のdescribe-aws-network-performance-metric-subscriptions例では、メトリクスサブスクリプションについて説明します。

aws ec2 describe-aws-network-performance-metric-subscriptions

出力:

{
    "Subscriptions": [
        {
            "Source": "us-east-1",
            "Destination": "eu-west-1",
            "Metric": "aggregate-latency",
            "Statistic": "p50",
            "Period": "five-minutes"
        }
    ]
}

詳細については、「インフラストラクチャパフォーマンスユーザーガイド」の「サブスクリプションの管理」を参照してください。

次の例は、describe-bundle-tasks を使用する方法を説明しています。

AWS CLI

バンドルタスクを記述するには

この例では、すべてのバンドルタスクについて説明します。

コマンド:

aws ec2 describe-bundle-tasks

出力:

{
  "BundleTasks": [
    {
      "UpdateTime": "2015-09-15T13:26:54.000Z",
      "InstanceId": "i-1234567890abcdef0",
      "Storage": {
        "S3": {
            "Prefix": "winami",
            "Bucket": "bundletasks"
        }
      },
      "State": "bundling",
      "StartTime": "2015-09-15T13:24:35.000Z",
      "Progress": "3%",
      "BundleId": "bun-2a4e041c"
    }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeBundleTasks」の「」を参照してください。 AWS CLI

次のコード例は、describe-byoip-cidrs を使用する方法を示しています。

AWS CLI

プロビジョニングされたアドレス範囲を記述するには

次のdescribe-byoip-cidrs例では、 で使用するためにプロビジョニングしたパブリックIPv4アドレス範囲の詳細を表示します AWS。

aws ec2 describe-byoip-cidrs

出力:

{
    "ByoipCidrs": [
        {
            "Cidr": "203.0.113.25/24",
            "StatusMessage": "ipv4pool-ec2-1234567890abcdef0",
            "State": "provisioned"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeByoipCidrs」の「」を参照してください。 AWS CLI

次のコード例は、describe-capacity-reservation-fleets を使用する方法を示しています。

AWS CLI

キャパシティー予約フリートを表示するには

次のdescribe-capacity-reservation-fleets例では、指定されたキャパシティー予約フリートの設定とキャパシティー情報を一覧表示します。また、フリート内の個々のキャパシティーの予約に関する詳細も一覧表示されます。

aws ec2 describe-capacity-reservation-fleets \
    --capacity-reservation-fleet-ids crf-abcdef01234567890

出力:

{
    "CapacityReservationFleets": [
        {
            "Status": "active",
            "EndDate": "2022-12-31T23:59:59.000Z",
            "InstanceMatchCriteria": "open",
            "Tags": [],
            "CapacityReservationFleetId": "crf-abcdef01234567890",
            "Tenancy": "default",
            "InstanceTypeSpecifications": [
                {
                    "CapacityReservationId": "cr-1234567890abcdef0",
                    "AvailabilityZone": "us-east-1a",
                    "FulfilledCapacity": 5.0,
                    "Weight": 1.0,
                    "CreateDate": "2022-07-02T08:34:33.398Z",
                    "InstancePlatform": "Linux/UNIX",
                    "TotalInstanceCount": 5,
                    "Priority": 1,
                    "EbsOptimized": true,
                    "InstanceType": "m5.xlarge"
                }
            ],
            "TotalTargetCapacity": 5,
            "TotalFulfilledCapacity": 5.0,
            "CreateTime": "2022-07-02T08:34:33.397Z",
            "AllocationStrategy": "prioritized"
        }
    ]
}

キャパシティー予約フリートの詳細については、Amazon EC2ユーザーガイドの「キャパシティー予約フリート」を参照してください。

次のコード例は、describe-capacity-reservations を使用する方法を示しています。

AWS CLI

例 1: 1 つ以上のキャパシティ予約を記述するには

次のdescribe-capacity-reservations例では、現在の AWS リージョンのすべてのキャパシティ予約に関する詳細を表示します。

aws ec2 describe-capacity-reservations

出力:

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
            "EndDateType": "unlimited",
            "AvailabilityZone": "eu-west-1a",
            "InstanceMatchCriteria": "open",
            "Tags": [],
            "EphemeralStorage": false,
            "CreateDate": "2019-08-16T09:03:18.000Z",
            "AvailableInstanceCount": 1,
            "InstancePlatform": "Linux/UNIX",
            "TotalInstanceCount": 1,
            "State": "active",
            "Tenancy": "default",
            "EbsOptimized": true,
            "InstanceType": "a1.medium"
        },
        {
            "CapacityReservationId": "cr-abcdEXAMPLE9876ef ",
            "EndDateType": "unlimited",
            "AvailabilityZone": "eu-west-1a",
            "InstanceMatchCriteria": "open",
            "Tags": [],
            "EphemeralStorage": false,
            "CreateDate": "2019-08-07T11:34:19.000Z",
            "AvailableInstanceCount": 3,
            "InstancePlatform": "Linux/UNIX",
            "TotalInstanceCount": 3,
            "State": "cancelled",
            "Tenancy": "default",
            "EbsOptimized": true,
            "InstanceType": "m5.large"
        }
    ]
}

例 2: 1 つ以上のキャパシティ予約を記述するには

次のdescribe-capacity-reservations例では、指定されたキャパシティ予約の詳細を表示します。

aws ec2 describe-capacity-reservations \
    --capacity-reservation-ids cr-1234abcd56EXAMPLE

出力:

{
    "CapacityReservations": [
        {
            "CapacityReservationId": "cr-1234abcd56EXAMPLE",
            "EndDateType": "unlimited",
            "AvailabilityZone": "eu-west-1a",
            "InstanceMatchCriteria": "open",
            "Tags": [],
            "EphemeralStorage": false,
            "CreateDate": "2019-08-16T09:03:18.000Z",
            "AvailableInstanceCount": 1,
            "InstancePlatform": "Linux/UNIX",
            "TotalInstanceCount": 1,
            "State": "active",
            "Tenancy": "default",
            "EbsOptimized": true,
            "InstanceType": "a1.medium"
        }
    ]
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「キャパシティ予約の表示」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeCapacityReservations」の「」を参照してください。 AWS CLI

次のコード例は、describe-carrier-gateways を使用する方法を示しています。

AWS CLI

すべてのキャリアゲートウェイを記述するには

次のdescribe-carrier-gateways例では、すべてのキャリアゲートウェイを一覧表示します。

aws ec2 describe-carrier-gateways

出力:

{
    "CarrierGateways": [
        {
            "CarrierGatewayId": "cagw-0465cdEXAMPLE1111",
            "VpcId": "vpc-0c529aEXAMPLE",
            "State": "available",
            "OwnerId": "123456789012",
            "Tags": [
                {

                    "Key": "example",
                    "Value": "tag"
                }
            ]
        }
    ]
}

詳細については、Amazon Virtual Private Cloud ユーザーガイドの「キャリアゲートウェイ＜https://docs.aws.amazon.com/vpc/latest/userguide/Carrier_Gateway.html>」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeCarrierGateways」の「」を参照してください。 AWS CLI

次のコード例は、describe-classic-link-instances を使用する方法を示しています。

AWS CLI

リンクされた EC2-Classic インスタンスを記述するには

この例では、リンクされたすべての EC2-Classic インスタンスを一覧表示します。

コマンド:

aws ec2 describe-classic-link-instances

出力:

{
        "Instances": [
                {
                        "InstanceId": "i-1234567890abcdef0",
                        "VpcId": "vpc-88888888",
                        "Groups": [
                                {
                                        "GroupId": "sg-11122233"
                                }
                        ],
                        "Tags": [
                                {
                                        "Value": "ClassicInstance",
                                        "Key": "Name"
                                }
                        ]
                },
                {
                        "InstanceId": "i-0598c7d356eba48d7",
                        "VpcId": "vpc-12312312",
                        "Groups": [
                                {
                                        "GroupId": "sg-aabbccdd"
                                }
                        ],
                        "Tags": [
                                {
                                        "Value": "ClassicInstance2",
                                        "Key": "Name"
                                }
                        ]
                }
        ]
}

この例では、リンクされたすべての EC2-Classic インスタンスを一覧表示し、vpc-88888888 VPC にリンクされたインスタンスのみを含むようにレスポンスをフィルタリングします。

コマンド:

aws ec2 describe-classic-link-instances --filter "Name=vpc-id,Values=vpc-88888888"

出力:

{
        "Instances": [
                {
                        "InstanceId": "i-1234567890abcdef0",
                        "VpcId": "vpc-88888888",
                        "Groups": [
                                {
                                        "GroupId": "sg-11122233"
                                }
                        ],
                        "Tags": [
                                {
                                        "Value": "ClassicInstance",
                                        "Key": "Name"
                                }
                        ]
                }
        ]
}

  • API 詳細については、「 コマンドリファレンスDescribeClassicLinkInstances」の「」を参照してください。 AWS CLI

次の例は、describe-client-vpn-authorization-rules を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントの承認ルールを記述するには

次のdescribe-client-vpn-authorization-rules例では、指定されたクライアントVPNエンドポイントの認証ルールの詳細を表示します。

aws ec2 describe-client-vpn-authorization-rules \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "AuthorizationRules": [
        {
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "GroupId": "",
            "AccessAll": true,
            "DestinationCidr": "0.0.0.0/0",
            "Status": {
                "Code": "active"
            }
        }
    ]
}

詳細については、AWS クライアントVPN管理者ガイドの「承認ルール」を参照してください。

次の例は、describe-client-vpn-connections を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントへの接続を記述するには

次のdescribe-client-vpn-connections例では、指定されたクライアントVPNエンドポイントへのクライアント接続の詳細を表示します。

aws ec2 describe-client-vpn-connections \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "Connections": [
        {
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "Timestamp": "2019-08-12 07:58:34",
            "ConnectionId": "cvpn-connection-0e03eb24267165acd",
            "ConnectionEstablishedTime": "2019-08-12 07:57:14",
            "IngressBytes": "32302",
            "EgressBytes": "5696",
            "IngressPackets": "332",
            "EgressPackets": "67",
            "ClientIp": "172.31.0.225",
            "CommonName": "client1.domain.tld",
            "Status": {
                "Code": "terminated"
            },
            "ConnectionEndTime": "2019-08-12 07:58:34"
        },
        {
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "Timestamp": "2019-08-12 08:02:54",
            "ConnectionId": "cvpn-connection-00668867a40f18253",
            "ConnectionEstablishedTime": "2019-08-12 08:02:53",
            "IngressBytes": "2951",
            "EgressBytes": "2611",
            "IngressPackets": "9",
            "EgressPackets": "6",
            "ClientIp": "172.31.0.226",
            "CommonName": "client1.domain.tld",
            "Status": {
                "Code": "active"
            },
            "ConnectionEndTime": "-"
        }
    ]
}

詳細については、クライアントAWS VPN管理者ガイドの「クライアント接続」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeClientVpnConnections」の「」を参照してください。 AWS CLI

次のコード例は、describe-client-vpn-endpoints を使用する方法を示しています。

AWS CLI

クライアントVPNエンドポイントを記述するには

次のdescribe-client-vpn-endpoints例では、すべてのクライアントVPNエンドポイントの詳細を表示します。

aws ec2 describe-client-vpn-endpoints

出力:

{
    "ClientVpnEndpoints": [
        {
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "Description": "Endpoint for Admin access",
            "Status": {
                "Code": "available"
            },
            "CreationTime": "2020-11-13T11:37:27",
            "DnsName": "*.cvpn-endpoint-123456789123abcde.prod.clientvpn.ap-south-1.amazonaws.com",
            "ClientCidrBlock": "172.31.0.0/16",
            "DnsServers": [
                "8.8.8.8"
            ],
            "SplitTunnel": false,
            "VpnProtocol": "openvpn",
            "TransportProtocol": "udp",
            "VpnPort": 443,
            "ServerCertificateArn": "arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "AuthenticationOptions": [
                {
                    "Type": "certificate-authentication",
                    "MutualAuthentication": {
                        "ClientRootCertificateChain": "arn:aws:acm:ap-south-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
                    }
                }
            ],
            "ConnectionLogOptions": {
                "Enabled": true,
                "CloudwatchLogGroup": "Client-vpn-connection-logs",
                "CloudwatchLogStream": "cvpn-endpoint-123456789123abcde-ap-south-1-2020/11/13-FCD8HEMVaCcw"
            },
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Client VPN"
                }
            ],
            "SecurityGroupIds": [
                "sg-aabbcc11223344567"
            ],
            "VpcId": "vpc-a87f92c1",
            "SelfServicePortalUrl": "https://self-service.clientvpn.amazonaws.com/endpoints/cvpn-endpoint-123456789123abcde",
            "ClientConnectOptions": {
                 "Enabled": false
            }
        }
    ]
}

詳細については、「 クライアント管理者ガイド」の「クライアントVPNエンドポイント」を参照してください。 AWS VPN

  • API 詳細については、「 コマンドリファレンスDescribeClientVpnEndpoints」の「」を参照してください。 AWS CLI

次の例は、describe-client-vpn-routes を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントのルートを記述するには

次のdescribe-client-vpn-routes例では、指定されたクライアントVPNエンドポイントのルートに関する詳細を表示します。

aws ec2 describe-client-vpn-routes \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "Routes": [
        {
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "DestinationCidr": "10.0.0.0/16",
            "TargetSubnet": "subnet-0123456789abcabca",
            "Type": "Nat",
            "Origin": "associate",
            "Status": {
                "Code": "active"
            },
            "Description": "Default Route"
        },
        {
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "DestinationCidr": "0.0.0.0/0",
            "TargetSubnet": "subnet-0123456789abcabca",
            "Type": "Nat",
            "Origin": "add-route",
            "Status": {
                "Code": "active"
            }
        }
    ]
}

詳細については、AWS クライアントVPN管理者ガイドの「ルート」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeClientVpnRoutes」の「」を参照してください。 AWS CLI

次の例は、describe-client-vpn-target-networks を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントのターゲットネットワークを記述するには

次のdescribe-client-vpn-target-networks例では、指定されたクライアントVPNエンドポイントのターゲットネットワークに関する詳細を表示します。

aws ec2 describe-client-vpn-target-networks \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "ClientVpnTargetNetworks": [
        {
            "AssociationId": "cvpn-assoc-012e837060753dc3d",
            "VpcId": "vpc-11111222222333333",
            "TargetNetworkId": "subnet-0123456789abcabca",
            "ClientVpnEndpointId": "cvpn-endpoint-123456789123abcde",
            "Status": {
                "Code": "associating"
            },
            "SecurityGroups": [
                "sg-012345678910abcab"
            ]
        }
    ]
}

詳細については、クライアントAWS VPN管理者ガイドの「ターゲットネットワーク」を参照してください。

次のコード例は、describe-coip-pools を使用する方法を示しています。

AWS CLI

顧客所有の IP アドレスプールを記述するには

次のdescribe-coip-pools例では、 AWS アカウントの顧客所有の IP アドレスプールについて説明します。

aws ec2 describe-coip-pools

出力:

{
    "CoipPools": [
        {
            "PoolId": "ipv4pool-coip-123a45678bEXAMPLE",
            "PoolCidrs": [
                "0.0.0.0/0"
            ],
            "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE",
            "PoolArn": "arn:aws:ec2:us-west-2:123456789012:coip-pool/ipv4pool-coip-123a45678bEXAMPLE"
        }
    ]
}

CoIP の詳細については、AWS Outposts ユーザーガイドの「カスタマー所有の IP アドレス」を参照してください 。

  • API 詳細については、「 コマンドリファレンスDescribeCoipPools」の「」を参照してください。 AWS CLI

次の例は、describe-conversion-tasks を使用する方法を説明しています。

AWS CLI

変換タスクのステータスを表示するには

この例では、ID import-i-ffvko9js の変換タスクのステータスを返します。

コマンド:

aws ec2 describe-conversion-tasks --conversion-task-ids import-i-ffvko9js

出力:

{
    "ConversionTasks": [
        {
            "ConversionTaskId": "import-i-ffvko9js",
            "ImportInstance": {
                "InstanceId": "i-1234567890abcdef0",
                "Volumes": [
                    {
                        "Volume": {
                            "Id": "vol-049df61146c4d7901",
                            "Size": 16
                        },
                        "Status": "completed",
                        "Image": {
                            "Size": 1300687360,
                            "ImportManifestUrl": "https://s3.amazonaws.com/myimportbucket/411443cd-d620-4f1c-9d66-13144EXAMPLE/RHEL5.vmdkmanifest.xml?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE&Expires=140EXAMPLE&Signature=XYNhznHNgCqsjDxL9wRL%2FJvEXAMPLE",
                            "Format": "VMDK"
                        },
                        "BytesConverted": 1300682960,
                        "AvailabilityZone": "us-east-1d"
                    }
                ]
            },
            "ExpirationTime": "2014-05-14T22:06:23Z",
            "State": "completed"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeConversionTasks」の「」を参照してください。 AWS CLI

次のコード例は、describe-customer-gateways を使用する方法を示しています。

AWS CLI

カスタマーゲートウェイを記述するには

この例では、カスタマーゲートウェイについて説明します。

コマンド:

aws ec2 describe-customer-gateways

出力:

{
    "CustomerGateways": [
        {
            "CustomerGatewayId": "cgw-b4dc3961",
            "IpAddress": "203.0.113.12",
            "State": "available",
            "Type": "ipsec.1",
            "BgpAsn": "65000"
        },
        {
            "CustomerGatewayId": "cgw-0e11f167",
            "IpAddress": "12.1.2.3",
            "State": "available",
            "Type": "ipsec.1",
            "BgpAsn": "65534"
        }
    ]
}

特定のカスタマーゲートウェイを記述するには

この例では、指定されたカスタマーゲートウェイについて説明します。

コマンド:

aws ec2 describe-customer-gateways --customer-gateway-ids cgw-0e11f167

出力:

{
    "CustomerGateways": [
        {
            "CustomerGatewayId": "cgw-0e11f167",
            "IpAddress": "12.1.2.3",
            "State": "available",
            "Type": "ipsec.1",
            "BgpAsn": "65534"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeCustomerGateways」の「」を参照してください。 AWS CLI

次のコード例は、describe-dhcp-options を使用する方法を示しています。

AWS CLI

例 1: DHCPオプションを記述するには

次のdescribe-dhcp-options例では、DHCPオプションの詳細を取得します。

aws ec2 describe-dhcp-options

出力:

{
    "DhcpOptions": [
        {
            "DhcpConfigurations": [
                {
                    "Key": "domain-name",
                    "Values": [
                        {
                            "Value": "us-east-2.compute.internal"
                        }
                    ]
                },
                {
                    "Key": "domain-name-servers",
                    "Values": [
                        {
                            "Value": "AmazonProvidedDNS"
                        }
                    ]
                }
            ],
            "DhcpOptionsId": "dopt-19edf471",
            "OwnerId": "111122223333"
        },
        {
            "DhcpConfigurations": [
                {
                    "Key": "domain-name",
                    "Values": [
                        {
                            "Value": "us-east-2.compute.internal"
                        }
                    ]
                },
                {
                    "Key": "domain-name-servers",
                    "Values": [
                        {
                            "Value": "AmazonProvidedDNS"
                        }
                    ]
                }
            ],
            "DhcpOptionsId": "dopt-fEXAMPLE",
            "OwnerId": "111122223333"
        }
    ]
}

詳細については、「 ユーザーガイド」のDHCP「オプションセットの使用」を参照してください。 AWS VPC

例 2: DHCPオプションを記述して出力をフィルタリングするには

次のdescribe-dhcp-options例では、DHCPオプションについて説明し、 フィルターを使用して、ドメインネームサーバーexample.comに があるDHCPオプションのみを返します。この例では、 --queryパラメータを使用して、設定情報と ID のみを出力に表示します。

aws ec2 describe-dhcp-options \
    --filters Name=key,Values=domain-name-servers Name=value,Values=example.com \
    --query "DhcpOptions[*].[DhcpConfigurations,DhcpOptionsId]"

出力:

[
    [
        [
            {
                "Key": "domain-name",
                "Values": [
                    {
                        "Value": "example.com"
                    }
                ]
            },
            {
                "Key": "domain-name-servers",
                "Values": [
                    {
                        "Value": "172.16.16.16"
                    }
                ]
            }
        ],
        "dopt-001122334455667ab"
    ]
]

詳細については、「 ユーザーガイド」のDHCP「オプションセットの使用」を参照してください。 AWS VPC

  • API 詳細については、「 コマンドリファレンスDescribeDhcpOptions」の「」を参照してください。 AWS CLI

次のコード例は、describe-egress-only-internet-gateways を使用する方法を示しています。

AWS CLI

Egress-Only インターネットゲートウェイを記述するには

この例では、Egress-Only インターネットゲートウェイについて説明します。

コマンド:

aws ec2 describe-egress-only-internet-gateways

出力:

{
  "EgressOnlyInternetGateways": [
      {
          "EgressOnlyInternetGatewayId": "eigw-015e0e244e24dfe8a",
          "Attachments": [
              {
                  "State": "attached",
                  "VpcId": "vpc-0c62a468"
              }
          ]
      }
  ]
}

次の例は、describe-elastic-gpus を使用する方法を説明しています。

AWS CLI

Elastic を記述するには GPU

コマンド:

aws ec2 describe-elastic-gpus --elastic-gpu-ids egpu-12345678901234567890abcdefghijkl

  • API 詳細については、「 コマンドリファレンスDescribeElasticGpus」の「」を参照してください。 AWS CLI

次の例は、describe-export-image-tasks を使用する方法を説明しています。

AWS CLI

イメージのエクスポートタスクをモニタリングするには

次のdescribe-export-image-tasks例では、指定されたイメージのエクスポートタスクのステータスをチェックします。Amazon S3 の結果のイメージファイルは ですmy-export-bucket/exports/export-ami-1234567890abcdef0.vmdk。

aws ec2 describe-export-image-tasks \
    --export-image-task-ids export-ami-1234567890abcdef0

進行中のイメージのエクスポートタスクの出力。

{
    "ExportImageTasks": [
        {
            "ExportImageTaskId": "export-ami-1234567890abcdef0"
            "Progress": "21",
            "S3ExportLocation": {
                "S3Bucket": "my-export-bucket",
                "S3Prefix": "exports/"
            },
            "Status": "active",
            "StatusMessage": "updating"
        }
    ]
}

完了したイメージのエクスポートタスクの出力。

{
    "ExportImageTasks": [
        {
            "ExportImageTaskId": "export-ami-1234567890abcdef0"
            "S3ExportLocation": {
                "S3Bucket": "my-export-bucket",
                "S3Prefix": "exports/"
            },
            "Status": "completed"
        }
    ]
}

詳細については、VM Import/Export ユーザーガイドの「 から AMI VM をエクスポートする」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeExportImageTasks」の「」を参照してください。 AWS CLI

次のコード例は、describe-export-tasks を使用する方法を示しています。

AWS CLI

インスタンスのエクスポートタスクの詳細を一覧表示するには

この例では、ID export-i-fh8sjjsq のエクスポートタスクについて説明します。

コマンド:

aws ec2 describe-export-tasks --export-task-ids export-i-fh8sjjsq

出力:

{
    "ExportTasks": [
        {
            "State": "active",
            "InstanceExportDetails": {
                "InstanceId": "i-1234567890abcdef0",
                "TargetEnvironment": "vmware"
            },
            "ExportToS3Task": {
                "S3Bucket": "myexportbucket",
                "S3Key": "RHEL5export-i-fh8sjjsq.ova",
                "DiskImageFormat": "vmdk",
                "ContainerFormat": "ova"
            },
            "Description": "RHEL5 instance",
            "ExportTaskId": "export-i-fh8sjjsq"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeExportTasks」の「」を参照してください。 AWS CLI

次のコード例は、describe-fast-launch-images を使用する方法を示しています。

AWS CLI

高速起動用にAMIs設定された Windows の詳細を記述するには

次のdescribe-fast-launch-images例では、リソースタイプ、スナップショット設定、起動テンプレートの詳細、並列起動の最大数、AMI所有者 ID、高速起動設定の状態、状態が変更された理由、状態変更が発生した時刻など、高速起動用に設定されたアカウントAMIs内の各 の詳細について説明します。

aws ec2 describe-fast-launch-images

出力:

{
    "FastLaunchImages": [
        {
            "ImageId": "ami-01234567890abcedf",
            "ResourceType": "snapshot",
            "SnapshotConfiguration": {},
            "LaunchTemplate": {
                "LaunchTemplateId": "lt-01234567890abcedf",
                "LaunchTemplateName": "EC2FastLaunchDefaultResourceCreation-a8c6215d-94e6-441b-9272-dbd1f87b07e2",
                "Version": "1"
            },
            "MaxParallelLaunches": 6,
            "OwnerId": "0123456789123",
            "State": "enabled",
            "StateTransitionReason": "Client.UserInitiated",
            "StateTransitionTime": "2022-01-27T22:20:06.552000+00:00"
        }
    ]
}

高速起動AMI用に Windows を設定する方法の詳細については、「Amazon EC2 ユーザーガイド」の「高速起動AMI用に を設定する」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeFastLaunchImages」の「」を参照してください。 AWS CLI

次の例は、describe-fast-snapshot-restores を使用する方法を説明しています。

AWS CLI

高速スナップショット復元を記述するには

次のdescribe-fast-snapshot-restores例では、 状態の高速スナップショット復元の詳細を表示しますdisabled。

aws ec2 describe-fast-snapshot-restores \
    --filters Name=state,Values=disabled

出力:

{
    "FastSnapshotRestores": [
        {
            "SnapshotId": "snap-1234567890abcdef0",
            "AvailabilityZone": "us-west-2c",
            "State": "disabled",
            "StateTransitionReason": "Client.UserInitiated - Lifecycle state transition",
            "OwnerId": "123456789012",
            "EnablingTime": "2020-01-25T23:57:49.596Z",
            "OptimizingTime": "2020-01-25T23:58:25.573Z",
            "EnabledTime": "2020-01-25T23:59:29.852Z",
            "DisablingTime": "2020-01-26T00:40:56.069Z",
            "DisabledTime": "2020-01-26T00:41:27.390Z"
        }
    ]
}

次のdescribe-fast-snapshot-restores例では、すべての高速スナップショット復元について説明します。

aws ec2 describe-fast-snapshot-restores

  • API 詳細については、「 コマンドリファレンスDescribeFastSnapshotRestores」の「」を参照してください。 AWS CLI

次の例は、describe-fleet-history を使用する方法を説明しています。

AWS CLI

EC2フリート履歴を記述するには

次のdescribe-fleet-history例では、指定した時刻から指定したEC2フリートの履歴を返します。出力は、実行中のインスタンスが 2 EC2 つあるフリート用です。

aws ec2 describe-fleet-history \
    --fleet-id fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \
    --start-time 2020-09-01T00:00:00Z

出力:

{
    "HistoryRecords": [
        {
            "EventInformation": {
                "EventSubType": "submitted"
            },
            "EventType": "fleetRequestChange",
            "Timestamp": "2020-09-01T18:26:05.000Z"
        },
        {
            "EventInformation": {
                "EventSubType": "active"
            },
            "EventType": "fleetRequestChange",
            "Timestamp": "2020-09-01T18:26:15.000Z"
        },
        {
            "EventInformation": {
                "EventDescription": "t2.small, ami-07c8bc5c1ce9598c3, ...",
                "EventSubType": "progress"
            },
            "EventType": "fleetRequestChange",
            "Timestamp": "2020-09-01T18:26:17.000Z"
        },
        {
            "EventInformation": {
                "EventDescription": "{\"instanceType\":\"t2.small\", ...}",
                "EventSubType": "launched",
                "InstanceId": "i-083a1c446e66085d2"
            },
            "EventType": "instanceChange",
            "Timestamp": "2020-09-01T18:26:17.000Z"
        },
        {
            "EventInformation": {
                "EventDescription": "{\"instanceType\":\"t2.small\", ...}",
                "EventSubType": "launched",
                "InstanceId": "i-090db02406cc3c2d6"
            },
            "EventType": "instanceChange",
            "Timestamp": "2020-09-01T18:26:17.000Z"
        }
    ],
    "LastEvaluatedTime": "2020-09-01T19:10:19.000Z",
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE",
    "StartTime": "2020-08-31T23:53:20.000Z"
}

詳細については、Linux インスタンス用 Amazon EC2 Elastic Compute Cloud ユーザーガイドの「フリートの管理」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeFleetHistory」の「」を参照してください。 AWS CLI

次のコード例は、describe-fleet-instances を使用する方法を示しています。

AWS CLI

EC2フリートの実行中のインスタンスを記述するには

次のdescribe-fleet-instances例では、指定されたEC2フリートの実行中のインスタンスについて説明します。

aws ec2 describe-fleet-instances \
    --fleet-id 12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE

出力:

{
    "ActiveInstances": [
        {
            "InstanceId": "i-090db02406cc3c2d6",
            "InstanceType": "t2.small",
            "SpotInstanceRequestId": "sir-a43gtpfk",
            "InstanceHealth": "healthy"
        },
        {
            "InstanceId": "i-083a1c446e66085d2",
            "InstanceType": "t2.small",
            "SpotInstanceRequestId": "sir-iwcit2nj",
            "InstanceHealth": "healthy"
        }
    ],
    "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE"
}

詳細については、Linux インスタンス用 Amazon EC2 Elastic Compute Cloud ユーザーガイドの「フリートの管理」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeFleetInstances」の「」を参照してください。 AWS CLI

次の例は、describe-fleets を使用する方法を説明しています。

AWS CLI

フリートEC2を記述するには

次のdescribe-fleets例では、指定されたEC2フリートについて説明します。

aws ec2 describe-fleets \
    --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE

出力:

{
    "Fleets": [
        {
            "ActivityStatus": "pending_fulfillment",
            "CreateTime": "2020-09-01T18:26:05.000Z",
            "FleetId": "fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE",
            "FleetState": "active",
            "ExcessCapacityTerminationPolicy": "termination",
            "FulfilledCapacity": 0.0,
            "FulfilledOnDemandCapacity": 0.0,
            "LaunchTemplateConfigs": [
                {
                    "LaunchTemplateSpecification": {
                        "LaunchTemplateId": "lt-0e632f2855a979cd5",
                        "Version": "1"
                    }
                }
            ],
            "TargetCapacitySpecification": {
                "TotalTargetCapacity": 2,
                "OnDemandTargetCapacity": 0,
                "SpotTargetCapacity": 2,
                "DefaultTargetCapacityType": "spot"
            },
            "TerminateInstancesWithExpiration": false,
            "Type": "maintain",
            "ReplaceUnhealthyInstances": false,
            "SpotOptions": {
                "AllocationStrategy": "lowestPrice",
                "InstanceInterruptionBehavior": "terminate",
                "InstancePoolsToUseCount": 1
            },
            "OnDemandOptions": {
                "AllocationStrategy": "lowestPrice"
            }
        }
    ]
}

詳細については、Linux インスタンス用 Amazon EC2 Elastic Compute Cloud ユーザーガイドの「フリートの管理」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeFleets」の「」を参照してください。 AWS CLI

次のコード例は、describe-flow-logs を使用する方法を示しています。

AWS CLI

例 1: すべてのフローログを記述するには

次のdescribe-flow-logs例では、すべてのフローログの詳細を表示します。

aws ec2 describe-flow-logs

出力:

{
    "FlowLogs": [
        {
            "CreationTime": "2018-02-21T13:22:12.644Z",
            "DeliverLogsPermissionArn": "arn:aws:iam::123456789012:role/flow-logs-role",
            "DeliverLogsStatus": "SUCCESS",
            "FlowLogId": "fl-aabbccdd112233445",
            "MaxAggregationInterval": 600,
            "FlowLogStatus": "ACTIVE",
            "LogGroupName": "FlowLogGroup",
            "ResourceId": "subnet-12345678901234567",
            "TrafficType": "ALL",
            "LogDestinationType": "cloud-watch-logs",
            "LogFormat": "${version} ${account-id} ${interface-id} ${srcaddr} ${dstaddr} ${srcport} ${dstport} ${protocol} ${packets} ${bytes} ${start} ${end} ${action} ${log-status}"
        },
        {
            "CreationTime": "2020-02-04T15:22:29.986Z",
            "DeliverLogsStatus": "SUCCESS",
            "FlowLogId": "fl-01234567890123456",
            "MaxAggregationInterval": 60,
            "FlowLogStatus": "ACTIVE",
            "ResourceId": "vpc-00112233445566778",
            "TrafficType": "ACCEPT",
            "LogDestinationType": "s3",
            "LogDestination": "arn:aws:s3:::my-flow-log-bucket/custom",
            "LogFormat": "${version} ${vpc-id} ${subnet-id} ${instance-id} ${interface-id} ${account-id} ${type} ${srcaddr} ${dstaddr} ${srcport} ${dstport} ${pkt-srcaddr} ${pkt-dstaddr} ${protocol} ${bytes} ${packets} ${start} ${end} ${action} ${tcp-flags} ${log-status}"
        }
    ]
}

例 2: フローログのサブセットを記述するには

次のdescribe-flow-logs例では、フィルターを使用して、Amazon CloudWatch Logs の指定されたロググループにあるフローログの詳細のみを表示します。

aws ec2 describe-flow-logs \
    --filter "Name=log-group-name,Values=MyFlowLogs"

  • API 詳細については、「 コマンドリファレンスDescribeFlowLogs」の「」を参照してください。 AWS CLI

次のコード例は、describe-fpga-image-attribute を使用する方法を示しています。

AWS CLI

Amazon FPGAイメージの属性を記述するには

この例では、指定された のロード許可について説明しますAFI。

コマンド:

aws ec2 describe-fpga-image-attribute --fpga-image-id afi-0d123e123bfc85abc --attribute loadPermission

出力:

{
  "FpgaImageAttribute": {
      "FpgaImageId": "afi-0d123e123bfc85abc",
      "LoadPermissions": [
          {
              "UserId": "123456789012"
          }
      ]
  }
}

  • API 詳細については、「 コマンドリファレンスDescribeFpgaImageAttribute」の「」を参照してください。 AWS CLI

次の例は、describe-fpga-images を使用する方法を説明しています。

AWS CLI

Amazon FPGAイメージを記述するには

この例ではAFIs、アカウント が所有する について説明します123456789012。

コマンド:

aws ec2 describe-fpga-images --filters Name=owner-id,Values=123456789012

出力:

{
  "FpgaImages": [
      {
          "UpdateTime": "2017-12-22T12:09:14.000Z",
          "Name": "my-afi",
          "PciId": {
              "SubsystemVendorId": "0xfedd",
              "VendorId": "0x1d0f",
              "DeviceId": "0xf000",
              "SubsystemId": "0x1d51"
          },
          "FpgaImageGlobalId": "agfi-123cb27b5e84a0abc",
          "Public": false,
          "State": {
              "Code": "available"
          },
          "ShellVersion": "0x071417d3",
          "OwnerId": "123456789012",
          "FpgaImageId": "afi-0d123e123bfc85abc",
          "CreateTime": "2017-12-22T11:43:33.000Z",
          "Description": "my-afi"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeFpgaImages」の「」を参照してください。 AWS CLI

次の例は、describe-host-reservation-offerings を使用する方法を説明しています。

AWS CLI

Dedicated Host の予約サービスについて説明するには

この例では、購入可能な M4 インスタンスファミリーの Dedicated Host 予約について説明します。

コマンド:

aws ec2 describe-host-reservation-offerings --filter Name=instance-family,Values=m4

出力:

{
  "OfferingSet": [
      {
          "HourlyPrice": "1.499",
          "OfferingId": "hro-03f707bf363b6b324",
          "InstanceFamily": "m4",
          "PaymentOption": "NoUpfront",
          "UpfrontPrice": "0.000",
          "Duration": 31536000
      },
      {
          "HourlyPrice": "1.045",
          "OfferingId": "hro-0ef9181cabdef7a02",
          "InstanceFamily": "m4",
          "PaymentOption": "NoUpfront",
          "UpfrontPrice": "0.000",
          "Duration": 94608000
      },
      {
          "HourlyPrice": "0.714",
          "OfferingId": "hro-04567a15500b92a51",
          "InstanceFamily": "m4",
          "PaymentOption": "PartialUpfront",
          "UpfrontPrice": "6254.000",
          "Duration": 31536000
      },
      {
          "HourlyPrice": "0.484",
          "OfferingId": "hro-0d5d7a9d23ed7fbfe",
          "InstanceFamily": "m4",
          "PaymentOption": "PartialUpfront",
          "UpfrontPrice": "12720.000",
          "Duration": 94608000
      },
      {
          "HourlyPrice": "0.000",
          "OfferingId": "hro-05da4108ca998c2e5",
          "InstanceFamily": "m4",
          "PaymentOption": "AllUpfront",
          "UpfrontPrice": "23913.000",
          "Duration": 94608000
      },
      {
          "HourlyPrice": "0.000",
          "OfferingId": "hro-0a9f9be3b95a3dc8f",
          "InstanceFamily": "m4",
          "PaymentOption": "AllUpfront",
          "UpfrontPrice": "12257.000",
          "Duration": 31536000
      }
  ]
}

次の例は、describe-host-reservations を使用する方法を説明しています。

AWS CLI

アカウント内の Dedicated Host 予約を記述するには

この例では、 アカウントの Dedicated Host 予約について説明します。

コマンド:

aws ec2 describe-host-reservations

出力:

{
  "HostReservationSet": [
      {
          "Count": 1,
          "End": "2019-01-10T12:14:09Z",
          "HourlyPrice": "1.499",
          "InstanceFamily": "m4",
          "OfferingId": "hro-03f707bf363b6b324",
          "PaymentOption": "NoUpfront",
          "State": "active",
          "HostIdSet": [
              "h-013abcd2a00cbd123"
          ],
          "Start": "2018-01-10T12:14:09Z",
          "HostReservationId": "hr-0d418a3a4ffc669ae",
          "UpfrontPrice": "0.000",
          "Duration": 31536000
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeHostReservations」の「」を参照してください。 AWS CLI

次の例は、describe-hosts を使用する方法を説明しています。

AWS CLI

Dedicated Hosts の詳細を表示するには

次のdescribe-hosts例では、 AWS アカウント内の available Dedicated Hosts の詳細を表示します。

aws ec2 describe-hosts --filter "Name=state,Values=available"

出力:

{
    "Hosts": [
        {
            "HostId": "h-07879acf49EXAMPLE",
            "Tags": [
                {
                    "Value": "production",
                    "Key": "purpose"
                }
            ],
            "HostProperties": {
                "Cores": 48,
                "TotalVCpus": 96,
                "InstanceType": "m5.large",
                "Sockets": 2
            },
            "Instances": [],
            "State": "available",
            "AvailabilityZone": "eu-west-1a",
            "AvailableCapacity": {
                "AvailableInstanceCapacity": [
                    {
                        "AvailableCapacity": 48,
                        "InstanceType": "m5.large",
                        "TotalCapacity": 48
                    }
                ],
                "AvailableVCpus": 96
            },
            "HostRecovery": "on",
            "AllocationTime": "2019-08-19T08:57:44.000Z",
            "AutoPlacement": "off"
        }
    ]
}

詳細については、Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイドの「専有ホストの表示」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeHosts」の「」を参照してください。 AWS CLI

次の例は、describe-iam-instance-profile-associations を使用する方法を説明しています。

AWS CLI

IAMインスタンスプロファイルの関連付けを記述するには

この例では、すべてのIAMインスタンスプロファイルの関連付けについて説明します。

コマンド:

aws ec2 describe-iam-instance-profile-associations

出力:

{
  "IamInstanceProfileAssociations": [
      {
          "InstanceId": "i-09eb09efa73ec1dee",
          "State": "associated",
          "AssociationId": "iip-assoc-0db249b1f25fa24b8",
          "IamInstanceProfile": {
              "Id": "AIPAJVQN4F5WVLGCJDRGM",
              "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role"
          }
      },
      {
          "InstanceId": "i-0402909a2f4dffd14",
          "State": "associating",
          "AssociationId": "iip-assoc-0d1ec06278d29f44a",
          "IamInstanceProfile": {
              "Id": "AGJAJVQN4F5WVLGCJABCM",
              "Arn": "arn:aws:iam::123456789012:instance-profile/user1-role"
          }
      }
   ]
}

次のコード例は、describe-id-format を使用する方法を示しています。

AWS CLI

例 1: リソースの ID 形式を記述するには

次のdescribe-id-format例では、セキュリティグループの ID 形式について説明します。

aws ec2 describe-id-format \
    --resource security-group

次の出力例では、 Deadline値は、このリソースタイプが短い ID 形式から長い ID 形式に永続的に切り替える期限が 2018 年 8 月 15 日 00:00 UTCに期限切れになったことを示します。

{
    "Statuses": [
        {
            "Deadline": "2018-08-15T00:00:00.000Z",
            "Resource": "security-group",
            "UseLongIds": true
        }
    ]
}

例 2: すべてのリソースの ID 形式を記述するには

次のdescribe-id-format例では、すべてのリソースタイプの ID 形式について説明します。ショート ID 形式をサポートしたすべてのリソースタイプは、ロング ID 形式を使用するように切り替えられました。

aws ec2 describe-id-format

  • API 詳細については、「 コマンドリファレンスDescribeIdFormat」の「」を参照してください。 AWS CLI

次のコード例は、describe-identity-id-format を使用する方法を示しています。

AWS CLI

IAMロールの ID 形式を記述するには

次のdescribe-identity-id-format例では、アカウントのロールによって作成されたインスタンスが受信した ID 形式について説明しますIAMEC2Role AWS 。

aws ec2 describe-identity-id-format \
    --principal-arn arn:aws:iam::123456789012:role/my-iam-role \
    --resource instance

次の出力は、このロールによって作成されたインスタンスが長い ID IDs 形式で を受信することを示しています。

{
    "Statuses": [
        {
            "Deadline": "2016-12-15T00:00:00Z",
            "Resource": "instance",
            "UseLongIds": true
        }
    ]
}

IAMユーザーの ID 形式を記述するには

次のdescribe-identity-id-format例では、 AdminUser AWS アカウントのIAMユーザーが作成したスナップショットが受信した ID 形式について説明します。

aws ec2 describe-identity-id-format \
    --principal-arn arn:aws:iam::123456789012:user/AdminUser \
    --resource snapshot

出力は、このユーザーが作成したスナップショットが長い ID IDs 形式で受信されることを示します。

{
    "Statuses": [
        {
            "Deadline": "2016-12-15T00:00:00Z",
            "Resource": "snapshot",
            "UseLongIds": true
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeIdentityIdFormat」の「」を参照してください。 AWS CLI

次のコード例は、describe-image-attribute を使用する方法を示しています。

AWS CLI

の起動許可を記述するには AMI

この例では、指定された の起動許可について説明しますAMI。

コマンド:

aws ec2 describe-image-attribute --image-id ami-5731123e --attribute launchPermission

出力:

{
    "LaunchPermissions": [
        {
            "UserId": "123456789012"
        }
    ],
    "ImageId": "ami-5731123e",
}

の製品コードを記述するには AMI

この例では、指定された の製品コードについて説明しますAMI。これには製品コードAMIがないことに注意してください。

コマンド:

aws ec2 describe-image-attribute --image-id ami-5731123e --attribute productCodes

出力:

{
    "ProductCodes": [],
    "ImageId": "ami-5731123e",
}

  • API 詳細については、「 コマンドリファレンスDescribeImageAttribute」の「」を参照してください。 AWS CLI

次の例は、describe-images を使用する方法を説明しています。

AWS CLI

例 1: を記述するには AMI

次のdescribe-images例では、指定されたリージョンAMIで指定された について説明します。

aws ec2 describe-images \
    --region us-east-1 \
    --image-ids ami-1234567890EXAMPLE

出力:

{
    "Images": [
        {
            "VirtualizationType": "hvm",
            "Description": "Provided by Red Hat, Inc.",
            "PlatformDetails": "Red Hat Enterprise Linux",
            "EnaSupport": true,
            "Hypervisor": "xen",
            "State": "available",
            "SriovNetSupport": "simple",
            "ImageId": "ami-1234567890EXAMPLE",
            "UsageOperation": "RunInstances:0010",
            "BlockDeviceMappings": [
                {
                    "DeviceName": "/dev/sda1",
                    "Ebs": {
                        "SnapshotId": "snap-111222333444aaabb",
                        "DeleteOnTermination": true,
                        "VolumeType": "gp2",
                        "VolumeSize": 10,
                        "Encrypted": false
                    }
                }
            ],
            "Architecture": "x86_64",
            "ImageLocation": "123456789012/RHEL-8.0.0_HVM-20190618-x86_64-1-Hourly2-GP2",
            "RootDeviceType": "ebs",
            "OwnerId": "123456789012",
            "RootDeviceName": "/dev/sda1",
            "CreationDate": "2019-05-10T13:17:12.000Z",
            "Public": true,
            "ImageType": "machine",
            "Name": "RHEL-8.0.0_HVM-20190618-x86_64-1-Hourly2-GP2"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「Amazon マシンイメージ (AMI）」を参照してください。 EC2

例 2: フィルターAMIsに基づいて を記述するには

次のdescribe-images例では、Amazon AMIsが提供する Windows のうち、Amazon によってバックアップされている Windows について説明しますEBS。

aws ec2 describe-images \
    --owners amazon \
    --filters "Name=platform,Values=windows" "Name=root-device-type,Values=ebs"

describe-images の出力例については、例 1 を参照してください。

フィルターを使用したその他の例については、「Amazon EC2 ユーザーガイド」の「リソースの一覧表示とフィルタリング」を参照してください。

例 3: タグAMIsに基づいて を記述するには

次のdescribe-images例では、 タグ AMIs を持つすべての について説明しますType=Custom。この例では、 --queryパラメータを使用して AMI のみを表示しますIDs。

aws ec2 describe-images \
    --filters "Name=tag:Type,Values=Custom" \
    --query 'Images[*].[ImageId]' \
    --output text

出力:

ami-1234567890EXAMPLE
ami-0abcdef1234567890

タグフィルターを使用するその他の例については、「Amazon ユーザーガイド」の「タグの使用」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeImages」の「」を参照してください。 AWS CLI

次の例は、describe-import-image-tasks を使用する方法を説明しています。

AWS CLI

イメージのインポートタスクをモニタリングするには

次のdescribe-import-image-tasks例では、指定されたイメージのインポートタスクのステータスをチェックします。

aws ec2 describe-import-image-tasks \
    --import-task-ids import-ami-1234567890abcdef0

進行中のイメージのインポートタスクの出力。

{
    "ImportImageTasks": [
        {
            "ImportTaskId": "import-ami-1234567890abcdef0",
            "Progress": "28",
            "SnapshotDetails": [
                {
                    "DiskImageSize": 705638400.0,
                    "Format": "ova",
                    "Status": "completed",
                    "UserBucket": {
                        "S3Bucket": "my-import-bucket",
                        "S3Key": "vms/my-server-vm.ova"
                    }
                }
            ],
            "Status": "active",
            "StatusMessage": "converting"
        }
    ]
}

完了したイメージのインポートタスクの出力。結果の ID AMIは によって提供されますImageId。

{
    "ImportImageTasks": [
        {
            "ImportTaskId": "import-ami-1234567890abcdef0",
            "ImageId": "ami-1234567890abcdef0",
            "SnapshotDetails": [
                {
                    "DiskImageSize": 705638400.0,
                    "Format": "ova",
                    "SnapshotId": "snap-1234567890abcdef0"
                    "Status": "completed",
                    "UserBucket": {
                        "S3Bucket": "my-import-bucket",
                        "S3Key": "vms/my-server-vm.ova"
                    }
                }
            ],
            "Status": "completed"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeImportImageTasks」の「」を参照してください。 AWS CLI

次のコード例は、describe-import-snapshot-tasks を使用する方法を示しています。

AWS CLI

スナップショットのインポートタスクをモニタリングするには

次のdescribe-import-snapshot-tasks例では、指定されたスナップショットのインポートタスクのステータスをチェックします。

aws ec2 describe-import-snapshot-tasks \
    --import-task-ids import-snap-1234567890abcdef0

進行中のスナップショットのインポートタスクの出力：

{
    "ImportSnapshotTasks": [
        {
            "Description": "My server VMDK",
            "ImportTaskId": "import-snap-1234567890abcdef0",
            "SnapshotTaskDetail": {
                "Description": "My server VMDK",
                "DiskImageSize": "705638400.0",
                "Format": "VMDK",
                "Progress": "42",
                "Status": "active",
                "StatusMessage": "downloading/converting",
                "UserBucket": {
                    "S3Bucket": "my-import-bucket",
                    "S3Key": "vms/my-server-vm.vmdk"
                }
            }
        }
    ]
}

完了したスナップショットのインポートタスクの出力。結果のスナップショットの ID は によって提供されますSnapshotId。

{
    "ImportSnapshotTasks": [
        {
            "Description": "My server VMDK",
            "ImportTaskId": "import-snap-1234567890abcdef0",
            "SnapshotTaskDetail": {
                "Description": "My server VMDK",
                "DiskImageSize": "705638400.0",
                "Format": "VMDK",
                "SnapshotId": "snap-1234567890abcdef0"
                "Status": "completed",
                "UserBucket": {
                    "S3Bucket": "my-import-bucket",
                    "S3Key": "vms/my-server-vm.vmdk"
                }
            }
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeImportSnapshotTasks」の「」を参照してください。 AWS CLI

次のコード例は、describe-instance-attribute を使用する方法を示しています。

AWS CLI

インスタンスタイプを記述するには

この例では、指定されたインスタンスのインスタンスタイプについて説明します。

コマンド:

aws ec2 describe-instance-attribute --instance-id i-1234567890abcdef0 --attribute instanceType

出力:

{
    "InstanceId": "i-1234567890abcdef0"
    "InstanceType": {
        "Value": "t1.micro"
    }
}

disableApiTermination 属性を記述するには

この例では、指定されたインスタンスの disableApiTermination 属性について説明します。

コマンド:

aws ec2 describe-instance-attribute --instance-id i-1234567890abcdef0 --attribute disableApiTermination

出力:

{
"InstanceId": "i-1234567890abcdef0"
    "DisableApiTermination": {
        "Value": "false"
    }
}

インスタンスのブロックデバイスマッピングを記述するには

この例では、指定されたインスタンスの blockDeviceMapping 属性について説明します。

コマンド:

aws ec2 describe-instance-attribute --instance-id i-1234567890abcdef0 --attribute blockDeviceMapping

出力:

{
    "InstanceId": "i-1234567890abcdef0"
    "BlockDeviceMappings": [
        {
            "DeviceName": "/dev/sda1",
            "Ebs": {
                "Status": "attached",
                "DeleteOnTermination": true,
                "VolumeId": "vol-049df61146c4d7901",
                "AttachTime": "2013-05-17T22:42:34.000Z"
            }
        },
        {
            "DeviceName": "/dev/sdf",
            "Ebs": {
                "Status": "attached",
                "DeleteOnTermination": false,
                "VolumeId": "vol-049df61146c4d7901",
                "AttachTime": "2013-09-10T23:07:00.000Z"
            }
        }
    ],
}

  • API 詳細については、「 コマンドリファレンスDescribeInstanceAttribute」の「」を参照してください。 AWS CLI

次の例は、describe-instance-connect-endpoints を使用する方法を説明しています。

AWS CLI

EC2 Instance Connect Endpoint を記述するには

次のdescribe-instance-connect-endpoints例では、指定された EC2 Instance Connect Endpoint について説明します。

aws ec2 describe-instance-connect-endpoints \
    --region us-east-1 \
    --instance-connect-endpoint-ids eice-0123456789example

出力:

{
    "InstanceConnectEndpoints": [
        {
            "OwnerId": "111111111111",
            "InstanceConnectEndpointId": "eice-0123456789example",
            "InstanceConnectEndpointArn": "arn:aws:ec2:us-east-1:111111111111:instance-connect-endpoint/eice-0123456789example",
            "State": "create-complete",
            "StateMessage": "",
            "DnsName": "eice-0123456789example.b67b86ba.ec2-instance-connect-endpoint.us-east-1.amazonaws.com",
            "NetworkInterfaceIds": [
                "eni-0123456789example"
            ],
            "VpcId": "vpc-0123abcd",
            "AvailabilityZone": "us-east-1d",
            "CreatedAt": "2023-02-07T12:05:37+00:00",
            "SubnetId": "subnet-0123abcd",
            "Tags": []
        }
    ]
}

詳細については、「Amazon ユーザーガイド」のEC2「インスタンス接続エンドポイントの作成」を参照してください。 EC2

次のコード例は、describe-instance-credit-specifications を使用する方法を示しています。

AWS CLI

1 つ以上のインスタンスCPUを使用するためのクレジットオプションを記述するには

次のdescribe-instance-credit-specifications例では、指定されたインスタンスのCPUクレジットオプションについて説明します。

aws ec2 describe-instance-credit-specifications \
    --instance-ids i-1234567890abcdef0

出力:

{
    "InstanceCreditSpecifications": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "CpuCredits": "unlimited"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「バーストパフォーマンスインスタンスの使用」を参照してください。 EC2

次の例は、describe-instance-event-notification-attributes を使用する方法を説明しています。

AWS CLI

スケジュールされたイベント通知のタグを記述するには

次のdescribe-instance-event-notification-attributes例では、スケジュールされたイベント通知に表示されるタグについて説明します。

aws ec2 describe-instance-event-notification-attributes

出力:

{
    "InstanceTagAttribute": {
        "InstanceTagKeys": [],
        "IncludeAllTagsOfInstance": true
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのスケジュールされたイベント」を参照してください。

次のコード例は、describe-instance-event-windows を使用する方法を示しています。

AWS CLI

例 1: すべてのイベントウィンドウを記述するには

次のdescribe-instance-event-windows例では、指定したリージョンのすべてのイベントウィンドウについて説明します。

aws ec2 describe-instance-event-windows \
    --region us-east-1

出力:

{
    "InstanceEventWindows": [
        {
            "InstanceEventWindowId": "iew-0abcdef1234567890",
            "Name": "myEventWindowName",
            "CronExpression": "* 21-23 * * 2,3",
            "AssociationTarget": {
                "InstanceIds": [
                    "i-1234567890abcdef0",
                    "i-0598c7d356eba48d7"
                ],
                "Tags": [],
                "DedicatedHostIds": []
            },
            "State": "active",
            "Tags": []
        }

        ...

    ],
    "NextToken": "9d624e0c-388b-4862-a31e-a85c64fc1d4a"
}

例 2: 特定のイベントウィンドウを記述するには

次のdescribe-instance-event-windows例では、 instance-event-windowパラメータを使用して特定のイベントウィンドウを記述することで、特定のイベントを記述します。

aws ec2 describe-instance-event-windows \
    --region us-east-1 \
    --instance-event-window-ids iew-0abcdef1234567890

出力:

{
    "InstanceEventWindows": [
        {
            "InstanceEventWindowId": "iew-0abcdef1234567890",
            "Name": "myEventWindowName",
            "CronExpression": "* 21-23 * * 2,3",
            "AssociationTarget": {
                "InstanceIds": [
                    "i-1234567890abcdef0",
                    "i-0598c7d356eba48d7"
                ],
                "Tags": [],
                "DedicatedHostIds": []
            },
            "State": "active",
            "Tags": []
        }
}

例 3: 1 つ以上のフィルターに一致するイベントウィンドウを記述するには

次のdescribe-instance-event-windows例では、 filterパラメータを使用して 1 つ以上のフィルターに一致するイベントウィンドウについて説明します。instance-id フィルターは、指定されたインスタンスに関連付けられているすべてのイベントウィンドウを記述するために使用されます。フィルタを使用すると、直接的な一致が評価されます。ただし、instance-id フィルターの場合は異なります。インスタンス ID に直接一致しない場合、インスタンスのタグや Dedicated Host ID (インスタンスが Dedicated Host の場合) など、イベントウィンドウとの間接的な関連付けにフォールバックします。

aws ec2 describe-instance-event-windows \
    --region us-east-1 \
    --filters Name=instance-id,Values=i-1234567890abcdef0 \
    --max-results 100 \
    --next-token <next-token-value>

出力:

{
    "InstanceEventWindows": [
        {
            "InstanceEventWindowId": "iew-0dbc0adb66f235982",
            "TimeRanges": [
                {
                    "StartWeekDay": "sunday",
                    "StartHour": 2,
                    "EndWeekDay": "sunday",
                    "EndHour": 8
                }
            ],
            "Name": "myEventWindowName",
            "AssociationTarget": {
                "InstanceIds": [],
                "Tags": [],
                "DedicatedHostIds": [
                    "h-0140d9a7ecbd102dd"
                ]
            },
            "State": "active",
            "Tags": []
        }
    ]
}

出力例では、インスタンスは Dedicated Host にあり、これはイベントウィンドウに関連付けられています。

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「考慮事項」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeInstanceEventWindows」の「」を参照してください。 AWS CLI

次のコード例は、describe-instance-status を使用する方法を示しています。

AWS CLI

インスタンスのステータスを表示するには

次の describe-instance-status の例では、指定したインスタンスの現在のステータスを示しています。

aws ec2 describe-instance-status \
    --instance-ids i-1234567890abcdef0

出力:

{
    "InstanceStatuses": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "InstanceState": {
                "Code": 16,
                "Name": "running"
            },
            "AvailabilityZone": "us-east-1d",
            "SystemStatus": {
                "Status": "ok",
                "Details": [
                    {
                        "Status": "passed",
                        "Name": "reachability"
                    }
                ]
            },
            "InstanceStatus": {
                "Status": "ok",
                "Details": [
                    {
                        "Status": "passed",
                        "Name": "reachability"
                    }
                ]
            }
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「インスタンスのステータスのモニタリング」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeInstanceStatus」の「」を参照してください。 AWS CLI

次のコード例は、describe-instance-topology を使用する方法を示しています。

AWS CLI

すべてのインスタンスのインスタンストポロジーを記述するには

次のdescribe-instance-topology例では、このコマンドでサポートされているインスタンスタイプに一致するすべてのインスタンスのトポロジーについて説明します。

aws ec2 describe-instance-topology \
    --region us-west-2

出力:

{
    "Instances": [
        {
            "InstanceId": "i-1111111111example",
            "InstanceType": "p4d.24xlarge",
            "GroupName": "my-ml-cpg",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-2222222222example",
            "InstanceType": "p4d.24xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-2222222222example",
                "nn-3333333333example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        },
        {
            "InstanceId": "i-3333333333example",
            "InstanceType": "trn1.32xlarge",
            "NetworkNodes": [
                "nn-1212121212example",
                "nn-1211122211example",
                "nn-1311133311example"
            ],
            "ZoneId": "usw2-az4",
            "AvailabilityZone": "us-west-2d"
        },
        {
            "InstanceId": "i-444444444example",
            "InstanceType": "trn1.2xlarge",
            "NetworkNodes": [
                "nn-1111111111example",
                "nn-5434334334example",
                "nn-1235301234example"
            ],
            "ZoneId": "usw2-az2",
            "AvailabilityZone": "us-west-2a"
        }
    ],
    "NextToken": "SomeEncryptedToken"
}

その他の例を含む詳細については、「Amazon ユーザーガイド」の「Amazon EC2インスタンストポロジー」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeInstanceTopology」の「」を参照してください。 AWS CLI

次の例は、describe-instance-type-offerings を使用する方法を説明しています。

AWS CLI

例 1: リージョンで提供されるインスタンスタイプを一覧表示するには

次のdescribe-instance-type-offerings例では、 のデフォルトリージョンとして設定された リージョンで提供されるインスタンスタイプを一覧表示します AWS CLI。

aws ec2 describe-instance-type-offerings

別のリージョンで提供されているインスタンスタイプを一覧表示するには、 --regionパラメータを使用してリージョンを指定します。

aws ec2 describe-instance-type-offerings \
    --region us-east-2

出力:

{
  "InstanceTypeOfferings": [
      {
          "InstanceType": "m5.2xlarge",
          "LocationType": "region",
          "Location": "us-east-2"
      },
      {
          "InstanceType": "t3.micro",
          "LocationType": "region",
          "Location": "us-east-2"
      },
      ...
  ]
}

例 2: アベイラビリティーゾーンで提供されるインスタンスタイプを一覧表示するには

次のdescribe-instance-type-offerings例では、指定されたアベイラビリティーゾーンで提供されるインスタンスタイプを一覧表示します。アベイラビリティーゾーンは、指定されたリージョンにある必要があります。

aws ec2 describe-instance-type-offerings \
    --location-type availability-zone \
    --filters Name=location,Values=us-east-2a \
    --region us-east-2

例 3: インスタンスタイプがサポートされているかどうかを確認するには

次のdescribe-instance-type-offeringsコマンドは、c5.xlargeインスタンスタイプが指定されたリージョンでサポートされているかどうかを示します。

aws ec2 describe-instance-type-offerings \
    --filters Name=instance-type,Values=c5.xlarge \
    --region us-east-2

次のdescribe-instance-type-offerings例では、指定されたリージョンでサポートされているすべての C5 インスタンスタイプを一覧表示します。

aws ec2 describe-instance-type-offerings \
    --filters Name=instance-type,Values=c5* \
    --query "InstanceTypeOfferings[].InstanceType" \
    --region us-east-2

出力:

[
    "c5d.12xlarge",
    "c5d.9xlarge",
    "c5n.xlarge",
    "c5.xlarge",
    "c5d.metal",
    "c5n.metal",
    "c5.large",
    "c5d.2xlarge",
    "c5n.4xlarge",
    "c5.2xlarge",
    "c5n.large",
    "c5n.9xlarge",
    "c5d.large",
    "c5.18xlarge",
    "c5d.18xlarge",
    "c5.12xlarge",
    "c5n.18xlarge",
    "c5.metal",
    "c5d.4xlarge",
    "c5.24xlarge",
    "c5d.xlarge",
    "c5n.2xlarge",
    "c5d.24xlarge",
    "c5.9xlarge",
    "c5.4xlarge"
]

次のコード例は、describe-instance-types を使用する方法を示しています。

AWS CLI

例 1: インスタンスタイプを説明するには

次の describe-instance-types の例では、指定されたインスタンスタイプの詳細を表示します。

aws ec2 describe-instance-types \
    --instance-types t2.micro

出力:

{
    "InstanceTypes": [
        {
            "InstanceType": "t2.micro",
            "CurrentGeneration": true,
            "FreeTierEligible": true,
            "SupportedUsageClasses": [
                "on-demand",
                "spot"
            ],
            "SupportedRootDeviceTypes": [
                "ebs"
            ],
            "BareMetal": false,
            "Hypervisor": "xen",
            "ProcessorInfo": {
                "SupportedArchitectures": [
                    "i386",
                    "x86_64"
                ],
                "SustainedClockSpeedInGhz": 2.5
            },
            "VCpuInfo": {
                "DefaultVCpus": 1,
                "DefaultCores": 1,
                "DefaultThreadsPerCore": 1,
                "ValidCores": [
                    1
                ],
                "ValidThreadsPerCore": [
                    1
                ]
            },
            "MemoryInfo": {
                "SizeInMiB": 1024
            },
            "InstanceStorageSupported": false,
            "EbsInfo": {
                "EbsOptimizedSupport": "unsupported",
                "EncryptionSupport": "supported"
            },
            "NetworkInfo": {
                "NetworkPerformance": "Low to Moderate",
                "MaximumNetworkInterfaces": 2,
                "Ipv4AddressesPerInterface": 2,
                "Ipv6AddressesPerInterface": 2,
                "Ipv6Supported": true,
                "EnaSupport": "unsupported"
            },
            "PlacementGroupInfo": {
                "SupportedStrategies": [
                    "partition",
                    "spread"
                ]
            },
            "HibernationSupported": false,
            "BurstablePerformanceSupported": true,
            "DedicatedHostsSupported": false,
            "AutoRecoverySupported": true
        }
    ]
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスタイプ」を参照してください。

例 2: 使用可能なインスタンスタイプをフィルタリングするには

フィルターを指定して、特定の特性を持つインスタンスタイプに結果を絞り込めます。次の describe-instance-types の例では、休止状態をサポートするインスタンスタイプを一覧表示しています。

aws ec2 describe-instance-types \
    --filters Name=hibernation-supported,Values=true --query 'InstanceTypes[*].InstanceType'

出力:

[
    "m5.8xlarge",
    "r3.large",
    "c3.8xlarge",
    "r5.large",
    "m4.4xlarge",
    "c4.large",
    "m5.xlarge",
    "m4.xlarge",
    "c3.large",
    "c4.8xlarge",
    "c4.4xlarge",
    "c5.xlarge",
    "c5.12xlarge",
    "r5.4xlarge",
    "c5.4xlarge"
]

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスタイプ」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeInstanceTypes」の「」を参照してください。 AWS CLI

次の例は、describe-instances を使用する方法を説明しています。

AWS CLI

例 1: インスタンスを説明するには

次の describe-instances の例では、指定したインスタンスを示しています。

aws ec2 describe-instances \
    --instance-ids i-1234567890abcdef0

出力:

{
    "Reservations": [
        {
            "Groups": [],
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "ami-0abcdef1234567890",
                    "InstanceId": "i-1234567890abcdef0",
                    "InstanceType": "t3.nano",
                    "KeyName": "my-key-pair",
                    "LaunchTime": "2022-11-15T10:48:59+00:00",
                    "Monitoring": {
                        "State": "disabled"
                    },
                    "Placement": {
                        "AvailabilityZone": "us-east-2a",
                        "GroupName": "",
                        "Tenancy": "default"
                    },
                    "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                    "PrivateIpAddress": "10-0-0-157",
                    "ProductCodes": [],
                    "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com",
                    "PublicIpAddress": "34.253.223.13",
                    "State": {
                        "Code": 16,
                        "Name": "running"
                    },
                    "StateTransitionReason": "",
                    "SubnetId": "subnet-04a636d18e83cfacb",
                    "VpcId": "vpc-1234567890abcdef0",
                    "Architecture": "x86_64",
                    "BlockDeviceMappings": [
                        {
                            "DeviceName": "/dev/xvda",
                            "Ebs": {
                                "AttachTime": "2022-11-15T10:49:00+00:00",
                                "DeleteOnTermination": true,
                                "Status": "attached",
                                "VolumeId": "vol-02e6ccdca7de29cf2"
                            }
                        }
                    ],
                    "ClientToken": "1234abcd-1234-abcd-1234-d46a8903e9bc",
                    "EbsOptimized": true,
                    "EnaSupport": true,
                    "Hypervisor": "xen",
                    "IamInstanceProfile": {
                        "Arn": "arn:aws:iam::111111111111:instance-profile/AmazonSSMRoleForInstancesQuickSetup",
                        "Id": "111111111111111111111"
                    },
                    "NetworkInterfaces": [
                        {
                            "Association": {
                                "IpOwnerId": "amazon",
                                "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com",
                                "PublicIp": "34.253.223.13"
                            },
                            "Attachment": {
                                "AttachTime": "2022-11-15T10:48:59+00:00",
                                "AttachmentId": "eni-attach-1234567890abcdefg",
                                "DeleteOnTermination": true,
                                "DeviceIndex": 0,
                                "Status": "attached",
                                "NetworkCardIndex": 0
                            },
                            "Description": "",
                            "Groups": [
                                {
                                    "GroupName": "launch-wizard-146",
                                    "GroupId": "sg-1234567890abcdefg"
                                }
                            ],
                            "Ipv6Addresses": [],
                            "MacAddress": "00:11:22:33:44:55",
                            "NetworkInterfaceId": "eni-1234567890abcdefg",
                            "OwnerId": "104024344472",
                            "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                            "PrivateIpAddress": "10-0-0-157",
                            "PrivateIpAddresses": [
                                {
                                    "Association": {
                                        "IpOwnerId": "amazon",
                                        "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com",
                                        "PublicIp": "34.253.223.13"
                                    },
                                    "Primary": true,
                                    "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                                    "PrivateIpAddress": "10-0-0-157"
                                }
                            ],
                            "SourceDestCheck": true,
                            "Status": "in-use",
                            "SubnetId": "subnet-1234567890abcdefg",
                            "VpcId": "vpc-1234567890abcdefg",
                            "InterfaceType": "interface"
                        }
                    ],
                    "RootDeviceName": "/dev/xvda",
                    "RootDeviceType": "ebs",
                    "SecurityGroups": [
                        {
                            "GroupName": "launch-wizard-146",
                            "GroupId": "sg-1234567890abcdefg"
                        }
                    ],
                    "SourceDestCheck": true,
                    "Tags": [
                        {
                            "Key": "Name",
                            "Value": "my-instance"
                        }
                    ],
                    "VirtualizationType": "hvm",
                    "CpuOptions": {
                        "CoreCount": 1,
                        "ThreadsPerCore": 2
                    },
                    "CapacityReservationSpecification": {
                        "CapacityReservationPreference": "open"
                    },
                    "HibernationOptions": {
                        "Configured": false
                    },
                    "MetadataOptions": {
                        "State": "applied",
                        "HttpTokens": "optional",
                        "HttpPutResponseHopLimit": 1,
                        "HttpEndpoint": "enabled",
                        "HttpProtocolIpv6": "disabled",
                        "InstanceMetadataTags": "enabled"
                    },
                    "EnclaveOptions": {
                        "Enabled": false
                    },
                    "PlatformDetails": "Linux/UNIX",
                    "UsageOperation": "RunInstances",
                    "UsageOperationUpdateTime": "2022-11-15T10:48:59+00:00",
                    "PrivateDnsNameOptions": {
                        "HostnameType": "ip-name",
                        "EnableResourceNameDnsARecord": true,
                        "EnableResourceNameDnsAAAARecord": false
                    },
                    "MaintenanceOptions": {
                        "AutoRecovery": "default"
                    }
                }
            ],
            "OwnerId": "111111111111",
            "ReservationId": "r-1234567890abcdefg"
        }
    ]
}

例 2: 指定したタイプのインスタンスをフィルタリングするには

次の describe-instances の例では、フィルターを使用して、指定されたタイプのインスタンスに結果の範囲を限定しています。

aws ec2 describe-instances \
    --filters Name=instance-type,Values=m5.large

出力例については、例 1 を参照してください。

詳細については、「Amazon ユーザーガイド」の「 を使用したリストとフィルタリングCLI」を参照してください。 EC2

例 3: 指定したタイプとアベイラビリティーゾーンでインスタンスをフィルタリングするには

次の describe-instances の例では、複数のフィルターを使用して、指定されたアベイラビリティーゾーンにある、指定されたタイプのインスタンスに結果を絞り込みます。

aws ec2 describe-instances \
    --filters Name=instance-type,Values=t2.micro,t3.micro Name=availability-zone,Values=us-east-2c

出力例については、例 1 を参照してください。

例 4: JSON ファイルを使用して、指定されたタイプとアベイラビリティーゾーンのインスタンスをフィルタリングするには

次のdescribe-instances例では、JSON入力ファイルを使用して、前の例と同じフィルタリングを実行します。フィルターがより複雑になると、JSONファイルで簡単に指定できます。

aws ec2 describe-instances \
    --filters file://filters.json

filters.json の内容:

[
    {
        "Name": "instance-type",
        "Values": ["t2.micro", "t3.micro"]
    },
    {
        "Name": "availability-zone",
        "Values": ["us-east-2c"]
    }
]

出力例については、例 1 を参照してください。

例 5: 指定した Owner タグを持つインスタンスをフィルタリングするには

次の describe-instances の例では、タグフィルターを使用して、タグ値に関係なく、指定されたタグキー (Owner) のタグを持つインスタンスに結果を絞り込みます。

aws ec2 describe-instances \
    --filters "Name=tag-key,Values=Owner"

出力例については、例 1 を参照してください。

例 6: 指定した my-team タグ値を持つインスタンスをフィルタリングするには

次の describe-instances の例では、タグフィルターを使用して、タグキーに関係なく、指定されたタグ値 (my-team) のタグを持つインスタンスに結果を絞り込みます。

aws ec2 describe-instances \
    --filters "Name=tag-value,Values=my-team"

出力例については、例 1 を参照してください。

例 7: 指定した Owner タグと my-team 値を持つインスタンスをフィルタリングするには

次の describe-instances の例では、タグフィルターを使用して、指定したタグ (Owner=my-team) を持つインスタンスに結果を絞り込みます。

aws ec2 describe-instances \
    --filters "Name=tag:Owner,Values=my-team"

出力例については、例 1 を参照してください。

例 8: すべてのインスタンスIDsのインスタンスとサブネットのみを表示するには

次のdescribe-instances例では、 --queryパラメータを使用して、IDsすべてのインスタンスのインスタンスとサブネットのみを JSON形式で表示します。

Linux および macOS:

aws ec2 describe-instances \
    --query 'Reservations[*].Instances[*].{Instance:InstanceId,Subnet:SubnetId}' \
    --output json

Windows ：

aws ec2 describe-instances ^
    --query "Reservations[*].Instances[*].{Instance:InstanceId,Subnet:SubnetId}" ^
    --output json

出力:

[
    {
        "Instance": "i-057750d42936e468a",
        "Subnet": "subnet-069beee9b12030077"
    },
    {
        "Instance": "i-001efd250faaa6ffa",
        "Subnet": "subnet-0b715c6b7db68927a"
    },
    {
        "Instance": "i-027552a73f021f3bd",
        "Subnet": "subnet-0250c25a1f4e15235"
    }
    ...
]

例 9: 指定されたタイプのインスタンスをフィルタリングし、そのインスタンスのみを表示するには IDs

次のdescribe-instances例では、フィルターを使用して、指定されたタイプのインスタンスに結果をスコープし、 --queryパラメータを使用してインスタンス のみを表示しますIDs。

aws ec2 describe-instances \
    --filters "Name=instance-type,Values=t2.micro" \
    --query "Reservations[*].Instances[*].[InstanceId]" \
    --output text

出力:

i-031c0dc19de2fb70c
i-00d8bff789a736b75
i-0b715c6b7db68927a
i-0626d4edd54f1286d
i-00b8ae04f9f99908e
i-0fc71c25d2374130c

例 10: 指定されたタイプのインスタンスをフィルタリングし、そのインスタンス IDs、アベイラビリティーゾーン、および指定されたタグ値のみを表示するには

次の describe-instances の例では、tag-key という名前のタグを持つインスタンスのインスタンス ID、アベイラビリティーゾーン、および Name タグの値を表形式で表示します。

Linux および macOS:

aws ec2 describe-instances \
    --filters Name=tag-key,Values=Name \
    --query 'Reservations[*].Instances[*].{Instance:InstanceId,AZ:Placement.AvailabilityZone,Name:Tags[?Key==`Name`]|[0].Value}' \
    --output table

Windows ：

aws ec2 describe-instances ^
    --filters Name=tag-key,Values=Name ^
    --query "Reservations[*].Instances[*].{Instance:InstanceId,AZ:Placement.AvailabilityZone,Name:Tags[?Key=='Name']|[0].Value}" ^
    --output table

出力:

-------------------------------------------------------------
|                     DescribeInstances                     |
+--------------+-----------------------+--------------------+
|      AZ      |       Instance        |        Name        |
+--------------+-----------------------+--------------------+
|  us-east-2b  |  i-057750d42936e468a  |  my-prod-server    |
|  us-east-2a  |  i-001efd250faaa6ffa  |  test-server-1     |
|  us-east-2a  |  i-027552a73f021f3bd  |  test-server-2     |
+--------------+-----------------------+--------------------+

例 11: パーティションプレイスメントグループ内のインスタンスを説明するには

次の describe-instances の例では、指定したインスタンスを示しています。出力にはインスタンスのプレイスメント情報が含まれています。この情報にはインスタンスのプレイスメントグループ名とパーティション番号が含まれます。

aws ec2 describe-instances \
    --instance-ids i-0123a456700123456 \
    --query "Reservations[*].Instances[*].Placement"

出力:

[
    [
        {
            "AvailabilityZone": "us-east-1c",
            "GroupName": "HDFS-Group-A",
            "PartitionNumber": 3,
            "Tenancy": "default"
        }

    ]
]

詳細については、「Amazon EC2 ユーザーガイド」の「プレイスメントグループのインスタンスの説明」を参照してください。

例 12: 指定したプレイスメントグループとパーティション番号を持つインスタンスでフィルタリングするには

次の describe-instances の例では、指定したプレイスメントグループとパーティション番号のインスタンスのみに結果をフィルタリングします。

aws ec2 describe-instances \
    --filters "Name=placement-group-name,Values=HDFS-Group-A" "Name=placement-partition-number,Values=7"

次の例では、出力の関連情報のみが表示されます。

"Instances": [
    {
        "InstanceId": "i-0123a456700123456",
        "InstanceType": "r4.large",
        "Placement": {
            "AvailabilityZone": "us-east-1c",
            "GroupName": "HDFS-Group-A",
            "PartitionNumber": 7,
            "Tenancy": "default"
        }
    },
    {
        "InstanceId": "i-9876a543210987654",
        "InstanceType": "r4.large",
        "Placement": {
            "AvailabilityZone": "us-east-1c",
            "GroupName": "HDFS-Group-A",
            "PartitionNumber": 7,
            "Tenancy": "default"
        }
    ],

詳細については、「Amazon EC2 ユーザーガイド」の「プレイスメントグループのインスタンスの説明」を参照してください。

例 13: インスタンスメタデータのタグへのアクセスを許可するように設定されているインスタンスに絞り込むには

次の describe-instances の例では、インスタンスメタデータからインスタンスタグへのアクセスを許可するように設定されているインスタンスのみに結果をフィルタリングします。

aws ec2 describe-instances \
    --filters "Name=metadata-options.instance-metadata-tags,Values=enabled" \
    --query "Reservations[*].Instances[*].InstanceId" \
    --output text

次のような出力が予想されます。

i-1234567890abcdefg
i-abcdefg1234567890
i-11111111aaaaaaaaa
i-aaaaaaaa111111111

詳細については、「Amazon ユーザーガイド」の「インスタンスメタデータでのインスタンスタグの使用」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeInstances」の「」を参照してください。 AWS CLI

次の例は、describe-internet-gateways を使用する方法を説明しています。

AWS CLI

インターネットゲートウェイを記述するには

次のdescribe-internet-gateways例では、指定されたインターネットゲートウェイについて説明します。

aws ec2 describe-internet-gateways \
    --internet-gateway-ids igw-0d0fb496b3EXAMPLE

出力:

{
    "InternetGateways": [
        {
            "Attachments": [
                {
                    "State": "available",
                    "VpcId": "vpc-0a60eb65b4EXAMPLE"
                }
            ],
            "InternetGatewayId": "igw-0d0fb496b3EXAMPLE",
            "OwnerId": "123456789012",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-igw"
                }
            ]
        }
    ]
}

詳細については、「Amazon VPCユーザーガイド」の「インターネットゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeInternetGateways」の「」を参照してください。 AWS CLI

次のコード例は、describe-ipam-pools を使用する方法を示しています。

AWS CLI

IPAM プールの詳細を表示するには

次のdescribe-ipam-pools例は、プールの詳細を示しています。

(Linux):

aws ec2 describe-ipam-pools \
    --filters Name=owner-id,Values=123456789012 Name=ipam-scope-id,Values=ipam-scope-02fc38cd4c48e7d38

(Windows):

aws ec2 describe-ipam-pools ^
    --filters Name=owner-id,Values=123456789012 Name=ipam-scope-id,Values=ipam-scope-02fc38cd4c48e7d38

出力:

{
    "IpamPools": [
        {
            "OwnerId": "123456789012",
            "IpamPoolId": "ipam-pool-02ec043a19bbe5d08",
            "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-02ec043a19bbe5d08",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38",
            "IpamScopeType": "private",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
            "IpamRegion": "us-east-1",
            "Locale": "None",
            "PoolDepth": 1,
            "State": "create-complete",
            "AutoImport": true,
            "AddressFamily": "ipv4",
            "AllocationMinNetmaskLength": 16,
            "AllocationMaxNetmaskLength": 26,
            "AllocationDefaultNetmaskLength": 24,
            "AllocationResourceTags": [
                {
                    "Key": "Environment",
                    "Value": "Preprod"
                }
            ],
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Preprod pool"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeIpamPools」の「」を参照してください。 AWS CLI

次の例は、describe-ipam-resource-discoveries を使用する方法を説明しています。

AWS CLI

例 1: リソース検出の詳細を表示する

この例では、管理者が組織内のリソースの IP アドレスを管理およびモニタリングできるように、リソース検出を作成して別の AWS 組織のIPAM管理者と共有IPAMしたい委任管理者です。

この例は、次の場合に便利です。

リソース検出を作成しようとしましたが、上限の 1 に達したというエラーが表示されました。リソース検出を既に作成していて、アカウントで表示したい場合があることに気づきます。 によって検出されていないリソースがリージョンにありますIPAM。リソースに--operating-regions定義されている を表示し、適切なリージョンを運用リージョンとして追加して、そのリソースを検出できるようにします。

次のdescribe-ipam-resource-discoveries例では、 AWS アカウント内のリソース検出の詳細を一覧表示します。 AWS リージョンごとに 1 つのリソース検出を設定できます。

aws ec2 describe-ipam-resource-discoveries \
    --region us-east-1

出力:

{
    "IpamResourceDiscoveries": [
        {
            "OwnerId": "149977607591",
            "IpamResourceDiscoveryId": "ipam-res-disco-0f8bdee9067137c0d",
            "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0f8bdee9067137c0d",
            "IpamResourceDiscoveryRegion": "us-east-1",
            "OperatingRegions": [
                {
                    "RegionName": "us-east-1"
                }
            ],
            "IsDefault": false,
            "State": "create-complete",
            "Tags": []
    }
]
}

詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

例 2: リソース検出のみを表示する IDs

次のdescribe-ipam-resource-discoveries例では、アカウント内のリソース検出の ID を一覧表示します AWS 。 AWS リージョンごとに 1 つのリソース検出を設定できます。

aws ec2 describe-ipam-resource-discoveries \
    --query "IpamResourceDiscoveries[*].IpamResourceDiscoveryId" \
    --output text

出力:

ipam-res-disco-0481e39b242860333

詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

次の例は、describe-ipam-resource-discovery-associations を使用する方法を説明しています。

AWS CLI

とのすべてのリソース検出の関連付けを表示するには IPAM

この例では、他のアカウントを と統合IPAMするために、リソース検出を に関連付けたIPAM委任管理者ですIPAM。IPAM がリソース検出の運用リージョン内のリソースを期待どおりに検出していないことに気付きました。リソース検出のステータスと状態をチェックして、リソース検出を作成したアカウントがまだアクティブであり、リソース検出がまだ共有されていることを確認します。

は、 のホームリージョン--regionである必要がありますIPAM。

次のdescribe-ipam-resource-discovery-associations例では、 AWS アカウントのリソース検出の関連付けを一覧表示します。

aws ec2 describe-ipam-resource-discovery-associations \
    --region us-east-1

出力:

{
    "IpamResourceDiscoveryAssociations": [
        {
            "OwnerId": "320805250157",
            "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-05e6b45eca5bf5cf7",
            "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::320805250157:ipam-resource-discovery-association/ipam-res-disco-assoc-05e6b45eca5bf5cf7",
            "IpamResourceDiscoveryId": "ipam-res-disco-0f4ef577a9f37a162",
            "IpamId": "ipam-005f921c17ebd5107",
            "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107",
            "IpamRegion": "us-east-1",
            "IsDefault": true,
            "ResourceDiscoveryStatus": "active",
            "State": "associate-complete",
            "Tags": []
        },
        {
            "OwnerId": "149977607591",
            "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-0dfd21ae189ab5f62",
            "IpamResourceDiscoveryAssociationArn": "arn:aws:ec2::149977607591:ipam-resource-discovery-association/ipam-res-disco-assoc-0dfd21ae189ab5f62",
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "IpamId": "ipam-005f921c17ebd5107",
            "IpamArn": "arn:aws:ec2::149977607591:ipam/ipam-005f921c17ebd5107",
            "IpamRegion": "us-east-1",
            "IsDefault": false,
            "ResourceDiscoveryStatus": "active",
            "State": "create-complete",
            "Tags": []
        }
    ]
}

この例では、このコマンドを実行した後、デフォルト以外のリソース検出が 1 つ ("IsDefault": false ``) that is ``"ResourceDiscoveryStatus": "not-found" と ) あることに気づきます"State": "create-complete"。リソース検出所有者のアカウントは閉鎖されました。別のケースで、 が "ResourceDiscoveryStatus": "not-found"と であることがわかった場合は"State": "associate-complete"、次のいずれかが発生したことを示します。

リソース検出は、リソース検出所有者によって削除されました。リソース検出所有者は、リソース検出の共有を解除しました。

詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

次の例は、describe-ipam-scopes を使用する方法を説明しています。

AWS CLI

IPAMスコープの詳細を表示するには

次のdescribe-ipam-scopes例は、スコープの詳細を示しています。

aws ec2 describe-ipam-scopes \
    --filters Name=owner-id,Values=123456789012 Name=ipam-id,Values=ipam-08440e7a3acde3908

出力:

{
    "IpamScopes": [
        {
            "OwnerId": "123456789012",
            "IpamScopeId": "ipam-scope-02fc38cd4c48e7d38",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
            "IpamRegion": "us-east-1",
            "IpamScopeType": "private",
            "IsDefault": true,
            "PoolCount": 2,
            "State": "create-complete",
            "Tags": []
        },
        {
            "OwnerId": "123456789012",
            "IpamScopeId": "ipam-scope-0b9eed026396dbc16",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-0b9eed026396dbc16",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
            "IpamRegion": "us-east-1",
            "IpamScopeType": "public",
            "IsDefault": true,
            "PoolCount": 0,
            "State": "create-complete",
            "Tags": []
        },
        {
            "OwnerId": "123456789012",
            "IpamScopeId": "ipam-scope-0f1aff29486355c22",
            "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-0f1aff29486355c22",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
            "IpamRegion": "us-east-1",
            "IpamScopeType": "private",
            "IsDefault": false,
            "Description": "Example description",
            "PoolCount": 0,
            "State": "create-complete",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Example name value"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeIpamScopes」の「」を参照してください。 AWS CLI

次の例は、describe-ipams を使用する方法を説明しています。

AWS CLI

の詳細を表示するには IPAM

次のdescribe-ipams例は、 の詳細を示していますIPAM。

aws ec2 describe-ipams \
    --filters Name=owner-id,Values=123456789012

出力:

{
    "Ipams": [
        {
            "OwnerId": "123456789012",
            "IpamId": "ipam-08440e7a3acde3908",
            "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
            "IpamRegion": "us-east-1",
            "PublicDefaultScopeId": "ipam-scope-0b9eed026396dbc16",
            "PrivateDefaultScopeId": "ipam-scope-02fc38cd4c48e7d38",
            "ScopeCount": 3,
            "OperatingRegions": [
                {
                    "RegionName": "us-east-1"
                },
                {
                    "RegionName": "us-east-2"
                },
                {
                    "RegionName": "us-west-1"
                }
            ],
            "State": "create-complete",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "ExampleIPAM"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeIpams」の「」を参照してください。 AWS CLI

次のコード例は、describe-ipv6-pools を使用する方法を示しています。

AWS CLI

IPv6 アドレスプールを記述するには

次のdescribe-ipv6-pools例では、すべてのIPv6アドレスプールの詳細を表示します。

aws ec2 describe-ipv6-pools

出力:

{
    "Ipv6Pools": [
        {
            "PoolId": "ipv6pool-ec2-012345abc12345abc",
            "PoolCidrBlocks": [
                {
                    "Cidr": "2001:db8:123::/48"
                }
            ],
            "Tags": [
                {
                    "Key": "pool-1",
                    "Value": "public"
                }
            ]
        }
    ]
}

  • API 詳細については、AWS CLI 「 コマンドリファレンスDescribeIpv6Pools」を参照してください。

次の例は、describe-key-pairs を使用する方法を説明しています。

AWS CLI

キーペアを表示するには

次の describe-key-pairs の例では、指定されたキーペアの情報が表示されます。

aws ec2 describe-key-pairs \
    --key-names my-key-pair

出力:

{
    "KeyPairs": [
        {
            "KeyPairId": "key-0b94643da6EXAMPLE",
            "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca:9f:f5:f1:6f",
            "KeyName": "my-key-pair",
            "KeyType": "rsa",
            "Tags": [],
            "CreateTime": "2022-05-27T21:51:16.000Z"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「パブリックキーの説明」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeKeyPairs」の「」を参照してください。 AWS CLI

次の例は、describe-launch-template-versions を使用する方法を説明しています。

AWS CLI

起動テンプレートのバージョンを記述するには

この例では、指定された起動テンプレートのバージョンについて説明します。

コマンド:

aws ec2 describe-launch-template-versions --launch-template-id lt-068f72b72934aff71

出力:

{
  "LaunchTemplateVersions": [
      {
          "LaunchTemplateId": "lt-068f72b72934aff71",
          "LaunchTemplateName": "Webservers",
          "VersionNumber": 3,
          "CreatedBy": "arn:aws:iam::123456789102:root",
          "LaunchTemplateData": {
              "KeyName": "kp-us-east",
              "ImageId": "ami-6057e21a",
              "InstanceType": "t2.small",
              "NetworkInterfaces": [
                  {
                      "SubnetId": "subnet-7b16de0c",
                      "DeviceIndex": 0,
                      "Groups": [
                          "sg-7c227019"
                      ]
                  }
              ]
          },
          "DefaultVersion": false,
          "CreateTime": "2017-11-20T13:19:54.000Z"
      },
      {
          "LaunchTemplateId": "lt-068f72b72934aff71",
          "LaunchTemplateName": "Webservers",
          "VersionNumber": 2,
          "CreatedBy": "arn:aws:iam::123456789102:root",
          "LaunchTemplateData": {
              "KeyName": "kp-us-east",
              "ImageId": "ami-6057e21a",
              "InstanceType": "t2.medium",
              "NetworkInterfaces": [
                  {
                      "SubnetId": "subnet-1a2b3c4d",
                      "DeviceIndex": 0,
                      "Groups": [
                          "sg-7c227019"
                      ]
                  }
              ]
          },
          "DefaultVersion": false,
          "CreateTime": "2017-11-20T13:12:32.000Z"
      },
      {
          "LaunchTemplateId": "lt-068f72b72934aff71",
          "LaunchTemplateName": "Webservers",
          "VersionNumber": 1,
          "CreatedBy": "arn:aws:iam::123456789102:root",
          "LaunchTemplateData": {
              "UserData": "",
              "KeyName": "kp-us-east",
              "ImageId": "ami-aabbcc11",
              "InstanceType": "t2.medium",
              "NetworkInterfaces": [
                  {
                      "SubnetId": "subnet-7b16de0c",
                      "DeviceIndex": 0,
                      "DeleteOnTermination": false,
                      "Groups": [
                          "sg-7c227019"
                      ],
                      "AssociatePublicIpAddress": true
                  }
              ]
          },
          "DefaultVersion": true,
          "CreateTime": "2017-11-20T12:52:33.000Z"
      }
  ]
}

次の例は、describe-launch-templates を使用する方法を説明しています。

AWS CLI

起動テンプレートを記述するには

この例では、起動テンプレートについて説明します。

コマンド:

aws ec2 describe-launch-templates

出力:

{
  "LaunchTemplates": [
      {
          "LatestVersionNumber": 2,
          "LaunchTemplateId": "lt-0e06d290751193123",
          "LaunchTemplateName": "TemplateForWebServer",
          "DefaultVersionNumber": 2,
          "CreatedBy": "arn:aws:iam::123456789012:root",
          "CreateTime": "2017-11-27T09:30:23.000Z"
      },
      {
          "LatestVersionNumber": 6,
          "LaunchTemplateId": "lt-0c45b5e061ec98456",
          "LaunchTemplateName": "DBServersTemplate",
          "DefaultVersionNumber": 1,
          "CreatedBy": "arn:aws:iam::123456789012:root",
          "CreateTime": "2017-11-20T09:25:22.000Z"
      },
      {
          "LatestVersionNumber": 1,
          "LaunchTemplateId": "lt-0d47d774e8e52dabc",
          "LaunchTemplateName": "MyLaunchTemplate2",
          "DefaultVersionNumber": 1,
          "CreatedBy": "arn:aws:iam::123456789012:root",
          "CreateTime": "2017-11-02T12:06:21.000Z"
      },
      {
          "LatestVersionNumber": 3,
          "LaunchTemplateId": "lt-01e5f948eb4f589d6",
          "LaunchTemplateName": "testingtemplate2",
          "DefaultVersionNumber": 1,
          "CreatedBy": "arn:aws:sts::123456789012:assumed-role/AdminRole/i-03ee35176e2e5aabc",
          "CreateTime": "2017-12-01T08:19:48.000Z"
      },
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeLaunchTemplates」の「」を参照してください。 AWS CLI

次のコード例は、describe-local-gateway-route-table-virtual-interface-group-associations を使用する方法を示しています。

AWS CLI

仮想インターフェイスグループとローカルゲートウェイルートテーブル間の関連付けを記述するには

次のdescribe-local-gateway-route-table-virtual-interface-group-associations例では、仮想インターフェイスグループと AWS アカウントのローカルゲートウェイルートテーブル間の関連付けについて説明します。

aws ec2 describe-local-gateway-route-table-virtual-interface-group-associations

出力:

{
    "LocalGatewayRouteTableVirtualInterfaceGroupAssociations": [
        {
            "LocalGatewayRouteTableVirtualInterfaceGroupAssociationId": "lgw-vif-grp-assoc-07145b276bEXAMPLE",
            "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE",
            "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE",
            "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE",
            "LocalGatewayRouteTableArn": "arn:aws:ec2:us-west-2:123456789012:local-gateway-route-table/lgw-rtb-059615ef7dEXAMPLE",
            "OwnerId": "123456789012",
            "State": "associated",
            "Tags": []
        }
    ]
}

詳細については、「Outposts ユーザーガイド」の「ローカルゲートウェイの使用」を参照してください。 AWS

次の例は、describe-local-gateway-route-table-vpc-associations を使用する方法を説明しています。

AWS CLI

VPCsとローカルゲートウェイルートテーブルの関連付けを記述するには

次のdescribe-local-gateway-route-table-vpc-associations例では、 VPCsとローカルゲートウェイルートテーブル間の指定された関連付けに関する情報を表示します。

aws ec2 describe-local-gateway-route-table-vpc-associations \
    --local-gateway-route-table-vpc-association-ids lgw-vpc-assoc-0e0f27af15EXAMPLE

出力:

{
    "LocalGatewayRouteTableVpcAssociation": {
        "LocalGatewayRouteTableVpcAssociationId": "lgw-vpc-assoc-0e0f27af1EXAMPLE",
        "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE",
        "LocalGatewayId": "lgw-09b493aa7cEXAMPLE",
        "VpcId": "vpc-0efe9bde08EXAMPLE",
        "State": "associated"
    }
}

詳細については、「 Outposts ユーザーガイド」の「ローカルゲートウェイテーブル」を参照してください。

次のコード例は、describe-local-gateway-route-tables を使用する方法を示しています。

AWS CLI

ローカルゲートウェイルートテーブルを記述するには

次のdescribe-local-gateway-route-tables例では、ローカルゲートウェイルートテーブルの詳細を表示します。

aws ec2 describe-local-gateway-route-tables

出力:

{
    "LocalGatewayRouteTables": [
        {
            "LocalGatewayRouteTableId": "lgw-rtb-059615ef7deEXAMPLE",
            "LocalGatewayId": "lgw-09b493aa7cEXAMPLE",
            "OutpostArn": "arn:aws:outposts:us-west-2:111122223333:outpost/op-0dc11b66edEXAMPLE",
            "State": "available"
        }
    ]
}

次のコード例は、describe-local-gateway-virtual-interface-groups を使用する方法を示しています。

AWS CLI

ローカルゲートウェイ仮想インターフェイスグループを記述するには

次のdescribe-local-gateway-virtual-interface-groups例では、 AWS アカウントのローカルゲートウェイ仮想インターフェイスグループについて説明します。

aws ec2 describe-local-gateway-virtual-interface-groups

出力:

{
    "LocalGatewayVirtualInterfaceGroups": [
        {
            "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE",
            "LocalGatewayVirtualInterfaceIds": [
                "lgw-vif-01a23bc4d5EXAMPLE",
                "lgw-vif-543ab21012EXAMPLE"
            ],
            "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE",
            "OwnerId": "123456789012",
            "Tags": []
        }
    ]
}

詳細については、「Outposts ユーザーガイド」の「ローカルゲートウェイの使用」を参照してください。 AWS

次のコード例は、describe-local-gateway-virtual-interfaces を使用する方法を示しています。

AWS CLI

ローカルゲートウェイ仮想インターフェイスを記述するには

次のdescribe-local-gateway-virtual-interfaces例では、 AWS アカウントのローカルゲートウェイ仮想インターフェイスについて説明します。

aws ec2 describe-local-gateway-virtual-interfaces

出力:

{
    "LocalGatewayVirtualInterfaces": [
        {
            "LocalGatewayVirtualInterfaceId": "lgw-vif-01a23bc4d5EXAMPLE",
            "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE",
            "Vlan": 2410,
            "LocalAddress": "0.0.0.0/0",
            "PeerAddress": "0.0.0.0/0",
            "LocalBgpAsn": 65010,
            "PeerBgpAsn": 65000,
            "OwnerId": "123456789012",
            "Tags": []
        },
        {
            "LocalGatewayVirtualInterfaceId": "lgw-vif-543ab21012EXAMPLE",
            "LocalGatewayId": "lgw-0ab1c23d4eEXAMPLE",
            "Vlan": 2410,
            "LocalAddress": "0.0.0.0/0",
            "PeerAddress": "0.0.0.0/0",
            "LocalBgpAsn": 65010,
            "PeerBgpAsn": 65000,
            "OwnerId": "123456789012",
            "Tags": []
        }
    ]
}

詳細については、「Outposts ユーザーガイド」の「ローカルゲートウェイの使用」を参照してください。 AWS

次のコード例は、describe-local-gateways を使用する方法を示しています。

AWS CLI

ローカルゲートウェイを記述するには

次のdescribe-local-gateways例では、使用可能なローカルゲートウェイの詳細を表示します。

aws ec2 describe-local-gateways

出力:

{
    "LocalGateways": [
        {
            "LocalGatewayId": "lgw-09b493aa7cEXAMPLE",
            "OutpostArn": "arn:aws:outposts:us-west-2:123456789012:outpost/op-0dc11b66ed59f995a",
            "OwnerId": "123456789012",
            "State": "available"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeLocalGateways」の「」を参照してください。 AWS CLI

次の例は、describe-locked-snapshots を使用する方法を説明しています。

AWS CLI

スナップショットのロックステータスを記述するには

次のdescribe-locked-snapshots例では、指定されたスナップショットのロックステータスについて説明します。

aws ec2 describe-locked-snapshots \
    --snapshot-ids snap-0b5e733b4a8df6e0d

出力:

{
    "Snapshots": [
        {
            "OwnerId": "123456789012",
            "SnapshotId": "snap-0b5e733b4a8df6e0d",
            "LockState": "governance",
            "LockDuration": 365,
            "LockCreatedOn": "2024-05-05T00:56:06.208000+00:00",
            "LockDurationStartTime": "2024-05-05T00:56:06.208000+00:00",
            "LockExpiresOn": "2025-05-05T00:56:06.208000+00:00"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「スナップショットロック」を参照してください。 EBS

  • API 詳細については、「 コマンドリファレンスDescribeLockedSnapshots」の「」を参照してください。 AWS CLI

次のコード例は、describe-managed-prefix-lists を使用する方法を示しています。

AWS CLI

マネージドプレフィックスリストを記述するには

次のdescribe-managed-prefix-lists例では、 AWS アカウント が所有するプレフィックスリストについて説明します123456789012。

aws ec2 describe-managed-prefix-lists \
    --filters Name=owner-id,Values=123456789012

出力:

{
    "PrefixLists": [
        {
            "PrefixListId": "pl-11223344556677aab",
            "AddressFamily": "IPv6",
            "State": "create-complete",
            "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-11223344556677aab",
            "PrefixListName": "vpc-ipv6-cidrs",
            "MaxEntries": 25,
            "Version": 1,
            "Tags": [],
            "OwnerId": "123456789012"
        },
        {
            "PrefixListId": "pl-0123456abcabcabc1",
            "AddressFamily": "IPv4",
            "State": "active",
            "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1",
            "PrefixListName": "vpc-cidrs",
            "MaxEntries": 10,
            "Version": 1,
            "Tags": [],
            "OwnerId": "123456789012"
      }
  ]
}

詳細については、「Amazon ユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDescribeManagedPrefixLists」の「」を参照してください。 AWS CLI

次のコード例は、describe-moving-addresses を使用する方法を示しています。

AWS CLI

移動するアドレスを記述するには

この例では、移動するすべての Elastic IP アドレスについて説明します。

コマンド:

aws ec2 describe-moving-addresses

出力:

{
  "MovingAddressStatuses": [
    {
      "PublicIp": "198.51.100.0",
      "MoveStatus": "MovingToVpc"
    }
  ]
}

この例では、 EC2-VPC プラットフォームに移動するすべてのアドレスについて説明します。

コマンド:

aws ec2 describe-moving-addresses --filters Name=moving-status,Values=MovingToVpc

  • API 詳細については、「 コマンドリファレンスDescribeMovingAddresses」の「」を参照してください。 AWS CLI

次のコード例は、describe-nat-gateways を使用する方法を示しています。

AWS CLI

例 1: パブリックNATゲートウェイを記述するには

次のdescribe-nat-gateways例では、指定されたパブリックNATゲートウェイについて説明します。

aws ec2 describe-nat-gateways \
    --nat-gateway-id nat-01234567890abcdef

出力:

{
    "NatGateways": [
        {
            "CreateTime": "2023-08-25T01:56:51.000Z",
            "NatGatewayAddresses": [
                {
                    "AllocationId": "eipalloc-0790180cd2EXAMPLE",
                    "NetworkInterfaceId": "eni-09cc4b2558794f7f9",
                    "PrivateIp": "10.0.0.211",
                    "PublicIp": "54.85.121.213",
                    "AssociationId": "eipassoc-04d295cc9b8815b24",
                    "IsPrimary": true,
                    "Status": "succeeded"
                },
                {
                    "AllocationId": "eipalloc-0be6ecac95EXAMPLE",
                    "NetworkInterfaceId": "eni-09cc4b2558794f7f9",
                    "PrivateIp": "10.0.0.74",
                    "PublicIp": "3.211.231.218",
                    "AssociationId": "eipassoc-0f96bdca17EXAMPLE",
                    "IsPrimary": false,
                    "Status": "succeeded"
                }
            ],
            "NatGatewayId": "nat-01234567890abcdef",
            "State": "available",
            "SubnetId": "subnet-655eab5f08EXAMPLE",
            "VpcId": "vpc-098eb5ef58EXAMPLE",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "public-nat"
                }
            ],
            "ConnectivityType": "public"
        }
    ]
}

例 2: プライベートNATゲートウェイを記述するには

次のdescribe-nat-gateways例では、指定されたプライベートNATゲートウェイについて説明します。

aws ec2 describe-nat-gateways \
    --nat-gateway-id nat-1234567890abcdef0

出力:

{
    "NatGateways": [
        {
            "CreateTime": "2023-08-25T00:50:05.000Z",
            "NatGatewayAddresses": [
                {
                    "NetworkInterfaceId": "eni-0065a61b324d1897a",
                    "PrivateIp": "10.0.20.240",
                    "IsPrimary": true,
                    "Status": "succeeded"
                },
                {
                    "NetworkInterfaceId": "eni-0065a61b324d1897a",
                    "PrivateIp": "10.0.20.33",
                    "IsPrimary": false,
                    "Status": "succeeded"
                },
                {
                    "NetworkInterfaceId": "eni-0065a61b324d1897a",
                    "PrivateIp": "10.0.20.197",
                    "IsPrimary": false,
                    "Status": "succeeded"
                }
            ],
            "NatGatewayId": "nat-1234567890abcdef0",
            "State": "available",
            "SubnetId": "subnet-08fc749671EXAMPLE",
            "VpcId": "vpc-098eb5ef58EXAMPLE",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "private-nat"
                }
            ],
            "ConnectivityType": "private"
        }
    ]
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeNatGateways」の「」を参照してください。 AWS CLI

次の例は、describe-network-acls を使用する方法を説明しています。

AWS CLI

ネットワークを記述するには ACLs

次のdescribe-network-acls例では、ネットワーク の詳細を取得しますACLs。

aws ec2 describe-network-acls

出力:

{
    "NetworkAcls": [
        {
            "Associations": [
                {
                    "NetworkAclAssociationId": "aclassoc-0c1679dc41EXAMPLE",
                    "NetworkAclId": "acl-0ea1f54ca7EXAMPLE",
                    "SubnetId": "subnet-0931fc2fa5EXAMPLE"
                }
            ],
            "Entries": [
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": true,
                    "Protocol": "-1",
                    "RuleAction": "allow",
                    "RuleNumber": 100
                },
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": true,
                    "Protocol": "-1",
                    "RuleAction": "deny",
                    "RuleNumber": 32767
                },
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": false,
                    "Protocol": "-1",
                    "RuleAction": "allow",
                    "RuleNumber": 100
                },
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": false,
                    "Protocol": "-1",
                    "RuleAction": "deny",
                    "RuleNumber": 32767
                }
            ],
            "IsDefault": true,
            "NetworkAclId": "acl-0ea1f54ca7EXAMPLE",
            "Tags": [],
            "VpcId": "vpc-06e4ab6c6cEXAMPLE",
            "OwnerId": "111122223333"
        },
        {
            "Associations": [],
            "Entries": [
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": true,
                    "Protocol": "-1",
                    "RuleAction": "allow",
                    "RuleNumber": 100
                },
                {
                    "Egress": true,
                    "Ipv6CidrBlock": "::/0",
                    "Protocol": "-1",
                    "RuleAction": "allow",
                    "RuleNumber": 101
                },
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": true,
                    "Protocol": "-1",
                    "RuleAction": "deny",
                    "RuleNumber": 32767
                },
                {
                    "Egress": true,
                    "Ipv6CidrBlock": "::/0",
                    "Protocol": "-1",
                    "RuleAction": "deny",
                    "RuleNumber": 32768
                },
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": false,
                    "Protocol": "-1",
                    "RuleAction": "allow",
                    "RuleNumber": 100
                },
                {
                    "Egress": false,
                    "Ipv6CidrBlock": "::/0",
                    "Protocol": "-1",
                    "RuleAction": "allow",
                    "RuleNumber": 101
                },
                {
                    "CidrBlock": "0.0.0.0/0",
                    "Egress": false,
                    "Protocol": "-1",
                    "RuleAction": "deny",
                    "RuleNumber": 32767
                },
                {
                    "Egress": false,
                    "Ipv6CidrBlock": "::/0",
                    "Protocol": "-1",
                    "RuleAction": "deny",
                    "RuleNumber": 32768
                }
            ],
            "IsDefault": true,
            "NetworkAclId": "acl-0e2a78e4e2EXAMPLE",
            "Tags": [],
            "VpcId": "vpc-03914afb3eEXAMPLE",
            "OwnerId": "111122223333"
        }
    ]
}

詳細については、「 ユーザーガイド」の「ネットワークACLsAWS VPC」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeNetworkAcls」の「」を参照してください。 AWS CLI

次のコード例は、describe-network-insights-access-scope-analyses を使用する方法を示しています。

AWS CLI

Network Insights アクセススコープ分析を記述するには

次のdescribe-network-insights-access-scope-analyses例では、 AWS アカウントのアクセススコープ分析について説明します。

aws ec2 describe-network-insights-access-scope-analyses \
    --region us-east-1

出力:

{
    "NetworkInsightsAccessScopeAnalyses": [
        {
            "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789111",
            "NetworkInsightsAccessScopeAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope-analysis/nisa-123456789111",
            "NetworkInsightsAccessScopeId": "nis-123456789222",
            "Status": "succeeded",
            "StartDate": "2022-01-25T19:45:36.842000+00:00",
            "FindingsFound": "true",
            "Tags": []
        }
    ]
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次のコード例は、describe-network-insights-access-scopes を使用する方法を示しています。

AWS CLI

Network Insights アクセススコープを記述するには

次のdescribe-network-insights-access-scopes例では、 AWS アカウントのアクセス範囲分析について説明します。

aws ec2 describe-network-insights-access-scopes \
    --region us-east-1

出力:

{
    "NetworkInsightsAccessScopes": [
        {
            "NetworkInsightsAccessScopeId": "nis-123456789111",
            "NetworkInsightsAccessScopeArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope/nis-123456789111",
            "CreatedDate": "2021-11-29T21:12:41.416000+00:00",
            "UpdatedDate": "2021-11-29T21:12:41.416000+00:00",
            "Tags": []
        }
    ]
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次のコード例は、describe-network-insights-analyses を使用する方法を示しています。

AWS CLI

パス分析の結果を表示するには

次のdescribe-network-insights-analyses例では、指定された分析について説明します。この例では、送信元はインターネットゲートウェイ、送信先はEC2インスタンス、プロトコルは ですTCP。分析は成功し (Status は succeeded）、パスに到達できません (NetworkPathFound は )false。説明コードENI_SG_RULES_MISMATCHは、インスタンスのセキュリティグループに、送信先ポートでのトラフィックを許可するルールが含まれていないことを示します。

aws ec2 describe-network-insights-analyses \
    --network-insights-analysis-ids nia-02207aa13eb480c7a

出力:

{
    "NetworkInsightsAnalyses": [
        {
            "NetworkInsightsAnalysisId": "nia-02207aa13eb480c7a",
            "NetworkInsightsAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-analysis/nia-02207aa13eb480c7a",
            "NetworkInsightsPathId": "nip-0b26f224f1d131fa8",
            "StartDate": "2021-01-20T22:58:37.495Z",
            "Status": "succeeded",
            "NetworkPathFound": false,
            "Explanations": [
                {
                    "Direction": "ingress",
                    "ExplanationCode": "ENI_SG_RULES_MISMATCH",
                    "NetworkInterface": {
                        "Id": "eni-0a25edef15a6cc08c",
                        "Arn": "arn:aws:ec2:us-east-1:123456789012:network-interface/eni-0a25edef15a6cc08c"
                    },
                    "SecurityGroups": [
                        {
                            "Id": "sg-02f0d35a850ba727f",
                            "Arn": "arn:aws:ec2:us-east-1:123456789012:security-group/sg-02f0d35a850ba727f"
                        }
                    ],
                    "Subnet": {
                        "Id": "subnet-004ff41eccb4d1194",
                        "Arn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-004ff41eccb4d1194"
                    },
                    "Vpc": {
                        "Id": "vpc-f1663d98ad28331c7",
                        "Arn": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-f1663d98ad28331c7"
                    }
                }
            ],
            "Tags": []
        }
    ]
}

詳細については、「Reachability Analyzer ガイド」の「 の使用開始 AWS CLI」を参照してください。

次のコード例は、describe-network-insights-paths を使用する方法を示しています。

AWS CLI

パスを記述するには

次のdescribe-network-insights-paths例では、指定されたパスについて説明します。

aws ec2 describe-network-insights-paths \
    --network-insights-path-ids nip-0b26f224f1d131fa8

出力:

{
    "NetworkInsightsPaths": [
        {
            "NetworkInsightsPathId": "nip-0b26f224f1d131fa8",
            "NetworkInsightsPathArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-path/nip-0b26f224f1d131fa8",
            "CreatedDate": "2021-01-20T22:43:46.933Z",
            "Source": "igw-0797cccdc9d73b0e5",
            "Destination": "i-0495d385ad28331c7",
            "Protocol": "tcp"
        }
    ]
}

詳細については、「Reachability Analyzer ガイド」の「 の使用開始 AWS CLI」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeNetworkInsightsPaths」の「」を参照してください。 AWS CLI

次の例は、describe-network-interface-attribute を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスのアタッチメント属性を記述するには

このコマンド例は、指定されたネットワークインターフェイスの attachment 属性を記述します。

コマンド:

aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute attachment

出力:

{
  "NetworkInterfaceId": "eni-686ea200",
  "Attachment": {
      "Status": "attached",
      "DeviceIndex": 0,
      "AttachTime": "2015-05-21T20:02:20.000Z",
      "InstanceId": "i-1234567890abcdef0",
      "DeleteOnTermination": true,
      "AttachmentId": "eni-attach-43348162",
      "InstanceOwnerId": "123456789012"
  }
}

ネットワークインターフェイスの説明属性を記述するには

このコマンド例は、指定されたネットワークインターフェイスの description 属性を記述します。

コマンド:

aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute description

出力:

{
  "NetworkInterfaceId": "eni-686ea200",
  "Description": {
      "Value": "My description"
  }
}

ネットワークインターフェイスの groupSet 属性を記述するには

このコマンド例は、指定されたネットワークインターフェイスの groupSet 属性を記述します。

コマンド:

aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute groupSet

出力:

{
  "NetworkInterfaceId": "eni-686ea200",
  "Groups": [
      {
          "GroupName": "my-security-group",
          "GroupId": "sg-903004f8"
      }
  ]
}

ネットワークインターフェイスの sourceDestCheck 属性を記述するには

このコマンド例は、指定されたネットワークインターフェイスの sourceDestCheck 属性を記述します。

コマンド:

aws ec2 describe-network-interface-attribute --network-interface-id eni-686ea200 --attribute sourceDestCheck

出力:

{
  "NetworkInterfaceId": "eni-686ea200",
  "SourceDestCheck": {
      "Value": true
  }
}

次の例は、describe-network-interface-permissions を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスのアクセス許可を記述するには

この例では、すべてのネットワークインターフェイスのアクセス許可について説明します。

コマンド:

aws ec2 describe-network-interface-permissions

出力:

{
  "NetworkInterfacePermissions": [
      {
          "PermissionState": {
              "State": "GRANTED"
          },
          "NetworkInterfacePermissionId": "eni-perm-06fd19020ede149ea",
          "NetworkInterfaceId": "eni-b909511a",
          "Permission": "INSTANCE-ATTACH",
          "AwsAccountId": "123456789012"
      }
  ]
}

次のコード例は、describe-network-interfaces を使用する方法を示しています。

AWS CLI

ネットワークインターフェイスを記述するには

この例では、すべてのネットワークインターフェイスについて説明します。

コマンド:

aws ec2 describe-network-interfaces

出力:

{
  "NetworkInterfaces": [
      {
          "Status": "in-use",
          "MacAddress": "02:2f:8f:b0:cf:75",
          "SourceDestCheck": true,
          "VpcId": "vpc-a01106c2",
          "Description": "my network interface",
          "Association": {
              "PublicIp": "203.0.113.12",
              "AssociationId": "eipassoc-0fbb766a",
              "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com",
              "IpOwnerId": "123456789012"
          },
          "NetworkInterfaceId": "eni-e5aa89a3",
          "PrivateIpAddresses": [
              {
                  "PrivateDnsName": "ip-10-0-1-17.ec2.internal",
                  "Association": {
                      "PublicIp": "203.0.113.12",
                      "AssociationId": "eipassoc-0fbb766a",
                      "PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com",
                      "IpOwnerId": "123456789012"
                  },
                  "Primary": true,
                  "PrivateIpAddress": "10.0.1.17"
              }
          ],
          "RequesterManaged": false,
          "Ipv6Addresses": [],
          "PrivateDnsName": "ip-10-0-1-17.ec2.internal",
          "AvailabilityZone": "us-east-1d",
          "Attachment": {
              "Status": "attached",
              "DeviceIndex": 1,
              "AttachTime": "2013-11-30T23:36:42.000Z",
              "InstanceId": "i-1234567890abcdef0",
              "DeleteOnTermination": false,
              "AttachmentId": "eni-attach-66c4350a",
              "InstanceOwnerId": "123456789012"
          },
          "Groups": [
              {
                  "GroupName": "default",
                  "GroupId": "sg-8637d3e3"
              }
          ],
          "SubnetId": "subnet-b61f49f0",
          "OwnerId": "123456789012",
          "TagSet": [],
          "PrivateIpAddress": "10.0.1.17"
      },
      {
          "Status": "in-use",
          "MacAddress": "02:58:f5:ef:4b:06",
          "SourceDestCheck": true,
          "VpcId": "vpc-a01106c2",
          "Description": "Primary network interface",
          "Association": {
              "PublicIp": "198.51.100.0",
              "IpOwnerId": "amazon"
          },
          "NetworkInterfaceId": "eni-f9ba99bf",
          "PrivateIpAddresses": [
              {
                  "Association": {
                      "PublicIp": "198.51.100.0",
                      "IpOwnerId": "amazon"
                  },
                  "Primary": true,
                  "PrivateIpAddress": "10.0.1.149"
              }
          ],
          "RequesterManaged": false,
          "Ipv6Addresses": [],
          "AvailabilityZone": "us-east-1d",
          "Attachment": {
              "Status": "attached",
              "DeviceIndex": 0,
              "AttachTime": "2013-11-30T23:35:33.000Z",
              "InstanceId": "i-0598c7d356eba48d7",
              "DeleteOnTermination": true,
              "AttachmentId": "eni-attach-1b9db777",
              "InstanceOwnerId": "123456789012"
          },
          "Groups": [
              {
                  "GroupName": "default",
                  "GroupId": "sg-8637d3e3"
              }
          ],
          "SubnetId": "subnet-b61f49f0",
          "OwnerId": "123456789012",
          "TagSet": [],
          "PrivateIpAddress": "10.0.1.149"
      }
  ]
}

この例では、キー Purposeと値 を持つタグを持つネットワークインターフェイスについて説明しますProd。

コマンド:

aws ec2 describe-network-interfaces --filters Name=tag:Purpose,Values=Prod

出力:

{
  "NetworkInterfaces": [
      {
          "Status": "available",
          "MacAddress": "12:2c:bd:f9:bf:17",
          "SourceDestCheck": true,
          "VpcId": "vpc-8941ebec",
          "Description": "ProdENI",
          "NetworkInterfaceId": "eni-b9a5ac93",
          "PrivateIpAddresses": [
              {
                  "PrivateDnsName": "ip-10-0-1-55.ec2.internal",
                  "Primary": true,
                  "PrivateIpAddress": "10.0.1.55"
              },
              {
                  "PrivateDnsName": "ip-10-0-1-117.ec2.internal",
                  "Primary": false,
                  "PrivateIpAddress": "10.0.1.117"
              }
          ],
          "RequesterManaged": false,
          "PrivateDnsName": "ip-10-0-1-55.ec2.internal",
          "AvailabilityZone": "us-east-1d",
          "Ipv6Addresses": [],
          "Groups": [
              {
                  "GroupName": "MySG",
                  "GroupId": "sg-905002f5"
              }
          ],
          "SubnetId": "subnet-31d6c219",
          "OwnerId": "123456789012",
          "TagSet": [
              {
                  "Value": "Prod",
                  "Key": "Purpose"
              }
          ],
          "PrivateIpAddress": "10.0.1.55"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeNetworkInterfaces」の「」を参照してください。 AWS CLI

次の例は、describe-placement-groups を使用する方法を説明しています。

AWS CLI

プレイスメントグループを記述するには

このコマンド例では、すべてのプレイスメントグループについて説明します。

コマンド:

aws ec2 describe-placement-groups

出力:

{
    "PlacementGroups": [
        {
            "GroupName": "my-cluster",
            "State": "available",
            "Strategy": "cluster"
        },
        ...
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribePlacementGroups」の「」を参照してください。 AWS CLI

次の例は、describe-prefix-lists を使用する方法を説明しています。

AWS CLI

プレフィックスリストを記述するには

この例では、リージョンで使用可能なプレフィックスリストをすべて一覧表示します。

コマンド:

aws ec2 describe-prefix-lists

出力:

{
  "PrefixLists": [
    {
      "PrefixListName": "com.amazonaws.us-east-1.s3",
      "Cidrs": [
        "54.231.0.0/17"
      ],
      "PrefixListId": "pl-63a5400a"
    }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribePrefixLists」の「」を参照してください。 AWS CLI

次のコード例は、describe-principal-id-format を使用する方法を示しています。

AWS CLI

長い ID 形式が有効になっているIAMユーザーとロールの ID 形式を記述するには

次のdescribe-principal-id-format例では、長い ID 形式が有効になっているルートユーザー、すべてのIAMロール、およびすべてのIAMユーザーの ID 形式について説明します。

aws ec2 describe-principal-id-format \
    --resource instance

出力:

{
    "Principals": [
        {
            "Arn": "arn:aws:iam::123456789012:root",
            "Statuses": [
                {
                    "Deadline": "2016-12-15T00:00:00.000Z",
                    "Resource": "reservation",
                    "UseLongIds": true
                },
                {
                    "Deadline": "2016-12-15T00:00:00.000Z",
                    "Resource": "instance",
                    "UseLongIds": true
                },
                {
                    "Deadline": "2016-12-15T00:00:00.000Z",
                    "Resource": "volume",
                    "UseLongIds": true
                },
            ]
        },
        ...
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribePrincipalIdFormat」の「」を参照してください。 AWS CLI

次のコード例は、describe-public-ipv4-pools を使用する方法を示しています。

AWS CLI

パブリックIPv4アドレスプールを記述するには

次のdescribe-public-ipv4-pools例では、 Bring Your Own IP Addresses () を使用してパブリックアドレス範囲をプロビジョニングしたときに作成されたIPv4アドレスプールの詳細を表示しますBYOIP。

aws ec2 describe-public-ipv4-pools

出力:

{
    "PublicIpv4Pools": [
        {
            "PoolId": "ipv4pool-ec2-1234567890abcdef0",
            "PoolAddressRanges": [
                {
                    "FirstAddress": "203.0.113.0",
                    "LastAddress": "203.0.113.255",
                    "AddressCount": 256,
                    "AvailableAddressCount": 256
                }
            ],
            "TotalAddressCount": 256,
            "TotalAvailableAddressCount": 256
        }
    ]
}

  • API 詳細については、AWS CLI 「 コマンドリファレンスDescribePublicIpv4Pools」を参照してください。

次のコード例は、describe-regions を使用する方法を示しています。

AWS CLI

例 1: 有効になっているすべてのリージョンを説明するには

次の describe-regions の例は、アカウントで有効なすべてのリージョンを説明しています。

aws ec2 describe-regions

出力:

{
    "Regions": [
        {
            "Endpoint": "ec2.eu-north-1.amazonaws.com",
            "RegionName": "eu-north-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-south-1.amazonaws.com",
            "RegionName": "ap-south-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-west-3.amazonaws.com",
            "RegionName": "eu-west-3",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-west-2.amazonaws.com",
            "RegionName": "eu-west-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-west-1.amazonaws.com",
            "RegionName": "eu-west-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-northeast-3.amazonaws.com",
            "RegionName": "ap-northeast-3",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-northeast-2.amazonaws.com",
            "RegionName": "ap-northeast-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-northeast-1.amazonaws.com",
            "RegionName": "ap-northeast-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.sa-east-1.amazonaws.com",
            "RegionName": "sa-east-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ca-central-1.amazonaws.com",
            "RegionName": "ca-central-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-southeast-1.amazonaws.com",
            "RegionName": "ap-southeast-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-southeast-2.amazonaws.com",
            "RegionName": "ap-southeast-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-central-1.amazonaws.com",
            "RegionName": "eu-central-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-east-1.amazonaws.com",
            "RegionName": "us-east-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-east-2.amazonaws.com",
            "RegionName": "us-east-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-west-1.amazonaws.com",
            "RegionName": "us-west-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-west-2.amazonaws.com",
            "RegionName": "us-west-2",
            "OptInStatus": "opt-in-not-required"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「リージョンとゾーン」を参照してください。 EC2

例 2: エンドポイント名に特定の文字列が含まれる有効なリージョンを説明するには

次の describe-regions の例では、エンドポイントに「us」という文字列が含まれる、有効にしたすべてのリージョンを説明しています。

aws ec2 describe-regions \
    --filters "Name=endpoint,Values=*us*"

出力:

{
    "Regions": [
        {
            "Endpoint": "ec2.us-east-1.amazonaws.com",
            "RegionName": "us-east-1"
        },
        {
            "Endpoint": "ec2.us-east-2.amazonaws.com",
            "RegionName": "us-east-2"
        },
        {
            "Endpoint": "ec2.us-west-1.amazonaws.com",
            "RegionName": "us-west-1"
        },
        {
            "Endpoint": "ec2.us-west-2.amazonaws.com",
            "RegionName": "us-west-2"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「リージョンとゾーン」を参照してください。 EC2

例 3: すべてのリージョンを説明するには

次の describe-regions の例では、無効になっているリージョンを含め、使用可能なすべてのリージョンについて説明しています。

aws ec2 describe-regions \
    --all-regions

出力:

{
    "Regions": [
        {
            "Endpoint": "ec2.eu-north-1.amazonaws.com",
            "RegionName": "eu-north-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-south-1.amazonaws.com",
            "RegionName": "ap-south-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-west-3.amazonaws.com",
            "RegionName": "eu-west-3",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-west-2.amazonaws.com",
            "RegionName": "eu-west-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-west-1.amazonaws.com",
            "RegionName": "eu-west-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-northeast-3.amazonaws.com",
            "RegionName": "ap-northeast-3",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.me-south-1.amazonaws.com",
            "RegionName": "me-south-1",
            "OptInStatus": "not-opted-in"
        },
        {
            "Endpoint": "ec2.ap-northeast-2.amazonaws.com",
            "RegionName": "ap-northeast-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-northeast-1.amazonaws.com",
            "RegionName": "ap-northeast-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.sa-east-1.amazonaws.com",
            "RegionName": "sa-east-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ca-central-1.amazonaws.com",
            "RegionName": "ca-central-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-east-1.amazonaws.com",
            "RegionName": "ap-east-1",
            "OptInStatus": "not-opted-in"
        },
        {
            "Endpoint": "ec2.ap-southeast-1.amazonaws.com",
            "RegionName": "ap-southeast-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.ap-southeast-2.amazonaws.com",
            "RegionName": "ap-southeast-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.eu-central-1.amazonaws.com",
            "RegionName": "eu-central-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-east-1.amazonaws.com",
            "RegionName": "us-east-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-east-2.amazonaws.com",
            "RegionName": "us-east-2",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-west-1.amazonaws.com",
            "RegionName": "us-west-1",
            "OptInStatus": "opt-in-not-required"
        },
        {
            "Endpoint": "ec2.us-west-2.amazonaws.com",
            "RegionName": "us-west-2",
            "OptInStatus": "opt-in-not-required"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「リージョンとゾーン」を参照してください。 EC2

例 4: リージョン名だけを一覧表示するには

次の describe-regions の例では、--query パラメータを使用して出力をフィルタリングし、リージョンの名前のみをテキストとして返します。

aws ec2 describe-regions \
    --all-regions \
    --query "Regions[].{Name:RegionName}" \
    --output text

出力:

eu-north-1
ap-south-1
eu-west-3
eu-west-2
eu-west-1
ap-northeast-3
ap-northeast-2
me-south-1
ap-northeast-1
sa-east-1
ca-central-1
ap-east-1
ap-southeast-1
ap-southeast-2
eu-central-1
us-east-1
us-east-2
us-west-1
us-west-2

詳細については、「Amazon ユーザーガイド」の「リージョンとゾーン」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeRegions」の「」を参照してください。 AWS CLI

次の例は、describe-replace-root-volume-tasks を使用する方法を説明しています。

AWS CLI

例 1: 特定のルートボリューム置換タスクに関する情報を表示するには

次のdescribe-replace-root-volume-tasks例では、ルートボリューム置換タスク replacevol-0111122223333abcd について説明します。

aws ec2 describe-replace-root-volume-tasks \
    --replace-root-volume-task-ids replacevol-0111122223333abcd

出力:

{
    "ReplaceRootVolumeTasks": [
        {
            "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd",
            "Tags": [],
            "InstanceId": "i-0123456789abcdefa",
            "TaskState": "succeeded",
            "StartTime": "2022-03-14T15:16:28Z",
            "CompleteTime": "2022-03-14T15:16:52Z"
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「ルートボリュームの置き換え」を参照してください。

例 2: 特定のインスタンスのすべてのルートボリューム置換タスクに関する情報を表示するには

次のdescribe-replace-root-volume-tasks例では、インスタンス i-0123456789abcdefa のすべてのルートボリューム置換タスクについて説明します。

aws ec2 describe-replace-root-volume-tasks \
    --filters Name=instance-id,Values=i-0123456789abcdefa

出力:

{
    "ReplaceRootVolumeTasks": [
        {
            "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd",
            "Tags": [],
            "InstanceId": "i-0123456789abcdefa",
            "TaskState": "succeeded",
            "StartTime": "2022-03-14T15:06:38Z",
            "CompleteTime": "2022-03-14T15:07:03Z"
        },
        {
            "ReplaceRootVolumeTaskId": "replacevol-0444455555555abcd",
            "Tags": [],
            "InstanceId": "i-0123456789abcdefa",
            "TaskState": "succeeded",
            "StartTime": "2022-03-14T15:16:28Z",
            "CompleteTime": "2022-03-14T15:16:52Z"
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「ルートボリュームの置き換え」を参照してください。

次のコード例は、describe-reserved-instances-listings を使用する方法を示しています。

AWS CLI

リザーブドインスタンスのリストを記述するには

次のdescribe-reserved-instances-listings例では、指定されたリザーブドインスタンスのリストに関する情報を取得します。

aws ec2 describe-reserved-instances-listings \
    --reserved-instances-listing-id 5ec28771-05ff-4b9b-aa31-9e57dexample

このコマンドでは何も出力されません。

次のコード例は、describe-reserved-instances-modifications を使用する方法を示しています。

AWS CLI

リザーブドインスタンスの変更を記述するには

このコマンド例では、アカウントに対して送信されたすべての リザーブドインスタンス 変更リクエストについて説明します。

コマンド:

aws ec2 describe-reserved-instances-modifications

出力:

{
    "ReservedInstancesModifications": [
        {
            "Status": "fulfilled",
            "ModificationResults": [
                {
                    "ReservedInstancesId": "93bbbca2-62f1-4d9d-b225-16bada29e6c7",
                    "TargetConfiguration": {
                        "AvailabilityZone": "us-east-1b",
                        "InstanceType": "m1.large",
                        "InstanceCount": 3
                    }
                },
                {
                     "ReservedInstancesId": "1ba8e2e3-aabb-46c3-bcf5-3fe2fda922e6",
                     "TargetConfiguration": {
                         "AvailabilityZone": "us-east-1d",
                         "InstanceType": "m1.xlarge",
                         "InstanceCount": 1
                     }
                 }
            ],
            "EffectiveDate": "2015-08-12T17:00:00.000Z",
            "CreateDate": "2015-08-12T17:52:52.630Z",
            "UpdateDate": "2015-08-12T18:08:06.698Z",
            "ClientToken": "c9adb218-3222-4889-8216-0cf0e52dc37e:
            "ReservedInstancesModificationId": "rimod-d3ed4335-b1d3-4de6-ab31-0f13aaf46687",
            "ReservedInstancesIds": [
                {
                    "ReservedInstancesId": "b847fa93-e282-4f55-b59a-1342f5bd7c02"
                }
            ]
        }
    ]
}

次のコード例は、describe-reserved-instances-offerings を使用する方法を示しています。

AWS CLI

リザーブドインスタンス の提供内容を記述するには

このコマンド例は、 リージョンで購入可能なすべての リザーブドインスタンス を記述します。

コマンド:

aws ec2 describe-reserved-instances-offerings

出力:

{
  "ReservedInstancesOfferings": [
      {
          "OfferingType": "Partial Upfront",
          "AvailabilityZone": "us-east-1b",
          "InstanceTenancy": "default",
          "PricingDetails": [],
          "ProductDescription": "Red Hat Enterprise Linux",
          "UsagePrice": 0.0,
          "RecurringCharges": [
              {
                  "Amount": 0.088,
                  "Frequency": "Hourly"
              }
          ],
          "Marketplace": false,
          "CurrencyCode": "USD",
          "FixedPrice": 631.0,
          "Duration": 94608000,
          "ReservedInstancesOfferingId": "9a06095a-bdc6-47fe-a94a-2a382f016040",
          "InstanceType": "c1.medium"
      },
      {
          "OfferingType": "PartialUpfront",
          "AvailabilityZone": "us-east-1b",
          "InstanceTenancy": "default",
          "PricingDetails": [],
          "ProductDescription": "Linux/UNIX",
          "UsagePrice": 0.0,
          "RecurringCharges": [
              {
                  "Amount": 0.028,
                  "Frequency": "Hourly"
              }
          ],
          "Marketplace": false,
          "CurrencyCode": "USD",
          "FixedPrice": 631.0,
          "Duration": 94608000,
          "ReservedInstancesOfferingId": "bfbefc6c-0d10-418d-b144-7258578d329d",
          "InstanceType": "c1.medium"
      },
  ...
}

オプションを使用して リザーブドインスタンス サービスを説明するには

この例では、t1.micro インスタンスタイプ、Windows (Amazon VPC) 製品、および の高使用率製品 AWS を指定して、 が提供するリザーブドインスタンスを一覧表示します。

コマンド:

aws ec2 describe-reserved-instances-offerings --no-include-marketplace --instance-type "t1.micro" --product-description "Windows (Amazon VPC)" --offering-type "no upfront"

出力:

{
    "ReservedInstancesOfferings": [
      {
          "OfferingType": "No Upfront",
          "AvailabilityZone": "us-east-1b",
          "InstanceTenancy": "default",
          "PricingDetails": [],
          "ProductDescription": "Windows",
          "UsagePrice": 0.0,
          "RecurringCharges": [
              {
                  "Amount": 0.015,
                  "Frequency": "Hourly"
              }
          ],
          "Marketplace": false,
          "CurrencyCode": "USD",
          "FixedPrice": 0.0,
          "Duration": 31536000,
          "ReservedInstancesOfferingId": "c48ab04c-fe69-4f94-8e39-a23842292823",
          "InstanceType": "t1.micro"
      },

              ...
      {
          "OfferingType": "No Upfront",
          "AvailabilityZone": "us-east-1d",
          "InstanceTenancy": "default",
          "PricingDetails": [],
          "ProductDescription": "Windows (Amazon VPC)",
          "UsagePrice": 0.0,
          "RecurringCharges": [
              {
                  "Amount": 0.015,
                  "Frequency": "Hourly"
              }
          ],
          "Marketplace": false,
          "CurrencyCode": "USD",
          "FixedPrice": 0.0,
          "Duration": 31536000,
          "ReservedInstancesOfferingId": "3a98bf7d-2123-42d4-b4f5-8dbec4b06dc6",
          "InstanceType": "t1.micro"
      }
    ]
}

次のコード例は、describe-reserved-instances を使用する方法を示しています。

AWS CLI

リザーブドインスタンス を記述するには

このコマンド例では、所有する リザーブドインスタンス について説明します。

コマンド:

aws ec2 describe-reserved-instances

出力:

{
  "ReservedInstances": [
      {
          "ReservedInstancesId": "b847fa93-e282-4f55-b59a-1342fexample",
          "OfferingType": "No Upfront",
          "AvailabilityZone": "us-west-1c",
          "End": "2016-08-14T21:34:34.000Z",
          "ProductDescription": "Linux/UNIX",
          "UsagePrice": 0.00,
          "RecurringCharges": [
              {
                  "Amount": 0.104,
                  "Frequency": "Hourly"
              }
          ],
          "Start": "2015-08-15T21:34:35.086Z",
          "State": "active",
          "FixedPrice": 0.0,
          "CurrencyCode": "USD",
          "Duration": 31536000,
          "InstanceTenancy": "default",
          "InstanceType": "m3.medium",
          "InstanceCount": 2
      },
      ...
  ]
}

フィルターを使用して リザーブドインスタンス を記述するには

この例では、us-west-1c に 3 年間の t2.micro Linux/UNIX リザーブドインスタンスのみを含めるようにレスポンスをフィルタリングします。

コマンド:

aws ec2 describe-reserved-instances --filters Name=duration,Values=94608000 Name=instance-type,Values=t2.micro Name=product-description,Values=Linux/UNIX Name=availability-zone,Values=us-east-1e

出力:

{
    "ReservedInstances": [
        {
            "ReservedInstancesId": "f127bd27-edb7-44c9-a0eb-0d7e09259af0",
            "OfferingType": "All Upfront",
            "AvailabilityZone": "us-east-1e",
            "End": "2018-03-26T21:34:34.000Z",
            "ProductDescription": "Linux/UNIX",
            "UsagePrice": 0.00,
            "RecurringCharges": [],
            "Start": "2015-03-27T21:34:35.848Z",
            "State": "active",
            "FixedPrice": 151.0,
            "CurrencyCode": "USD",
            "Duration": 94608000,
            "InstanceTenancy": "default",
            "InstanceType": "t2.micro",
            "InstanceCount": 1
        }
    ]
}

詳細については、 AWS コマンドラインインターフェイスユーザーガイドの「Amazon EC2 インスタンスの使用」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeReservedInstances」の「」を参照してください。 AWS CLI

次の例は、describe-route-tables を使用する方法を説明しています。

AWS CLI

ルートテーブルを記述するには

次のdescribe-route-tables例では、ルートテーブルの詳細を取得します。

aws ec2 describe-route-tables

出力:

{
    "RouteTables": [
        {
            "Associations": [
                {
                    "Main": true,
                    "RouteTableAssociationId": "rtbassoc-0df3f54e06EXAMPLE",
                    "RouteTableId": "rtb-09ba434c1bEXAMPLE"
                }
            ],
            "PropagatingVgws": [],
            "RouteTableId": "rtb-09ba434c1bEXAMPLE",
            "Routes": [
                {
                    "DestinationCidrBlock": "10.0.0.0/16",
                    "GatewayId": "local",
                    "Origin": "CreateRouteTable",
                    "State": "active"
                },
                {
                    "DestinationCidrBlock": "0.0.0.0/0",
                    "NatGatewayId": "nat-06c018cbd8EXAMPLE",
                    "Origin": "CreateRoute",
                    "State": "blackhole"
                }
            ],
            "Tags": [],
            "VpcId": "vpc-0065acced4EXAMPLE",
            "OwnerId": "111122223333"
        },
        {
            "Associations": [
                {
                    "Main": true,
                    "RouteTableAssociationId": "rtbassoc-9EXAMPLE",
                    "RouteTableId": "rtb-a1eec7de"
                }
            ],
            "PropagatingVgws": [],
            "RouteTableId": "rtb-a1eec7de",
            "Routes": [
                {
                    "DestinationCidrBlock": "172.31.0.0/16",
                    "GatewayId": "local",
                    "Origin": "CreateRouteTable",
                    "State": "active"
                },
                {
                    "DestinationCidrBlock": "0.0.0.0/0",
                    "GatewayId": "igw-fEXAMPLE",
                    "Origin": "CreateRoute",
                    "State": "active"
                }
            ],
            "Tags": [],
            "VpcId": "vpc-3EXAMPLE",
            "OwnerId": "111122223333"
        },
        {
            "Associations": [
                {
                    "Main": false,
                    "RouteTableAssociationId": "rtbassoc-0b100c28b2EXAMPLE",
                    "RouteTableId": "rtb-07a98f76e5EXAMPLE",
                    "SubnetId": "subnet-0d3d002af8EXAMPLE"
                }
            ],
            "PropagatingVgws": [],
            "RouteTableId": "rtb-07a98f76e5EXAMPLE",
            "Routes": [
                {
                    "DestinationCidrBlock": "10.0.0.0/16",
                    "GatewayId": "local",
                    "Origin": "CreateRouteTable",
                    "State": "active"
                },
                {
                    "DestinationCidrBlock": "0.0.0.0/0",
                    "GatewayId": "igw-06cf664d80EXAMPLE",
                    "Origin": "CreateRoute",
                    "State": "active"
                }
            ],
            "Tags": [],
            "VpcId": "vpc-0065acced4EXAMPLE",
            "OwnerId": "111122223333"
        }
    ]
}

詳細については、「 ユーザーガイド」の「ルートテーブルの使用」を参照してください。 AWS VPC

  • API 詳細については、「 コマンドリファレンスDescribeRouteTables」の「」を参照してください。 AWS CLI

次のコード例は、describe-scheduled-instance-availability を使用する方法を示しています。

AWS CLI

使用可能なスケジュールを記述するには

この例では、指定した日付から毎週日曜日に行われるスケジュールについて説明します。

コマンド:

aws ec2 describe-scheduled-instance-availability --recurrence Frequency=Weekly,Interval=1,OccurrenceDays=[1] --first-slot-start-time-range EarliestTime=2016-01-31T00:00:00Z,LatestTime=2016-01-31T04:00:00Z

出力:

{
  "ScheduledInstanceAvailabilitySet": [
    {
        "AvailabilityZone": "us-west-2b",
        "TotalScheduledInstanceHours": 1219,
        "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...",
        "MinTermDurationInDays": 366,
        "AvailableInstanceCount": 20,
        "Recurrence": {
            "OccurrenceDaySet": [
                1
            ],
            "Interval": 1,
            "Frequency": "Weekly",
            "OccurrenceRelativeToEnd": false
        },
        "Platform": "Linux/UNIX",
        "FirstSlotStartTime": "2016-01-31T00:00:00Z",
        "MaxTermDurationInDays": 366,
        "SlotDurationInHours": 23,
        "NetworkPlatform": "EC2-VPC",
        "InstanceType": "c4.large",
        "HourlyPrice": "0.095"
    },
    ...
  ]
}

結果を絞り込むには、オペレーティングシステム、ネットワーク、インスタンスタイプを指定するフィルターを追加できます。

コマンド:

--filters Name=platform,Values=Linux/UNIX Name=network-platform,Values=EC2-VPC Name=instance-type,Values=c4.large

次のコード例は、describe-scheduled-instances を使用する方法を示しています。

AWS CLI

スケジュールされたインスタンスを記述するには

この例では、指定されたスケジュールされたインスタンスについて説明します。

コマンド:

aws ec2 describe-scheduled-instances --scheduled-instance-ids sci-1234-1234-1234-1234-123456789012

出力:

{
  "ScheduledInstanceSet": [
      {
          "AvailabilityZone": "us-west-2b",
          "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012",
          "HourlyPrice": "0.095",
          "CreateDate": "2016-01-25T21:43:38.612Z",
          "Recurrence": {
              "OccurrenceDaySet": [
                  1
              ],
              "Interval": 1,
              "Frequency": "Weekly",
              "OccurrenceRelativeToEnd": false,
              "OccurrenceUnit": ""
          },
          "Platform": "Linux/UNIX",
          "TermEndDate": "2017-01-31T09:00:00Z",
          "InstanceCount": 1,
          "SlotDurationInHours": 32,
          "TermStartDate": "2016-01-31T09:00:00Z",
          "NetworkPlatform": "EC2-VPC",
          "TotalScheduledInstanceHours": 1696,
          "NextSlotStartTime": "2016-01-31T09:00:00Z",
          "InstanceType": "c4.large"
      }
  ]
}

この例では、スケジュールされたすべてのインスタンスについて説明します。

コマンド:

aws ec2 describe-scheduled-instances

  • API 詳細については、「 コマンドリファレンスDescribeScheduledInstances」の「」を参照してください。 AWS CLI

次の例は、describe-security-group-references を使用する方法を説明しています。

AWS CLI

セキュリティグループの参照を記述するには

この例では、 のセキュリティグループリファレンスについて説明しますsg-bbbb2222。レスポンスは、セキュリティグループsg-bbbb2222が VPC のセキュリティグループによって参照されていることを示しますvpc-aaaaaaaa。

コマンド:

aws ec2 describe-security-group-references --group-id sg-bbbbb22222

出力:

{
  "SecurityGroupsReferenceSet": [
    {
      "ReferencingVpcId": "vpc-aaaaaaaa ",
      "GroupId": "sg-bbbbb22222",
      "VpcPeeringConnectionId": "pcx-b04deed9"
    }
  ]
}

次のコード例は、describe-security-group-rules を使用する方法を示しています。

AWS CLI

例 1: セキュリティグループのセキュリティグループルールを記述するには

次のdescribe-security-group-rules例では、指定されたセキュリティグループのセキュリティグループルールについて説明します。filters オプションを使用して、結果を特定のセキュリティグループにスコープします。

aws ec2 describe-security-group-rules \
    --filters Name="group-id",Values="sg-1234567890abcdef0"

出力:

{
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-abcdef01234567890",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "111122223333",
            "IsEgress": false,
            "IpProtocol": "-1",
            "FromPort": -1,
            "ToPort": -1,
            "ReferencedGroupInfo": {
                "GroupId": "sg-1234567890abcdef0",
                "UserId": "111122223333"
            },
            "Tags": []
        },
        {
            "SecurityGroupRuleId": "sgr-bcdef01234567890a",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "111122223333",
            "IsEgress": true,
            "IpProtocol": "-1",
            "FromPort": -1,
            "ToPort": -1,
            "CidrIpv6": "::/0",
            "Tags": []
        },
        {
            "SecurityGroupRuleId": "sgr-cdef01234567890ab",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "111122223333",
            "IsEgress": true,
            "IpProtocol": "-1",
            "FromPort": -1,
            "ToPort": -1,
            "CidrIpv4": "0.0.0.0/0",
            "Tags": []
        }
    ]
}

例 2: セキュリティグループルールを記述するには

次のdescribe-security-group-rules例では、指定されたセキュリティグループルールについて説明します。

aws ec2 describe-security-group-rules \
    --security-group-rule-ids sgr-cdef01234567890ab

出力:

{
    "SecurityGroupRules": [
        {
            "SecurityGroupRuleId": "sgr-cdef01234567890ab",
            "GroupId": "sg-1234567890abcdef0",
            "GroupOwnerId": "111122223333",
            "IsEgress": true,
            "IpProtocol": "-1",
            "FromPort": -1,
            "ToPort": -1,
            "CidrIpv4": "0.0.0.0/0",
            "Tags": []
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「セキュリティグループのルール」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDescribeSecurityGroupRules」の「」を参照してください。 AWS CLI

次のコード例は、describe-security-groups を使用する方法を示しています。

AWS CLI

例 1: セキュリティグループを説明するには

次の describe-security-groups の例では、指定したセキュリティグループを示しています。

aws ec2 describe-security-groups \
    --group-ids sg-903004f8

出力:

{
    "SecurityGroups": [
        {
            "IpPermissionsEgress": [
                {
                    "IpProtocol": "-1",
                    "IpRanges": [
                        {
                            "CidrIp": "0.0.0.0/0"
                        }
                    ],
                    "UserIdGroupPairs": [],
                    "PrefixListIds": []
                }
            ],
            "Description": "My security group",
            "Tags": [
                {
                    "Value": "SG1",
                    "Key": "Name"
                }
            ],
            "IpPermissions": [
                {
                    "IpProtocol": "-1",
                    "IpRanges": [],
                    "UserIdGroupPairs": [
                        {
                            "UserId": "123456789012",
                            "GroupId": "sg-903004f8"
                        }
                    ],
                    "PrefixListIds": []
                },
                {
                    "PrefixListIds": [],
                    "FromPort": 22,
                    "IpRanges": [
                        {
                            "Description": "Access from NY office",
                            "CidrIp": "203.0.113.0/24"
                        }
                    ],
                    "ToPort": 22,
                    "IpProtocol": "tcp",
                    "UserIdGroupPairs": []
                    }
            ],
            "GroupName": "MySecurityGroup",
            "VpcId": "vpc-1a2b3c4d",
            "OwnerId": "123456789012",
            "GroupId": "sg-903004f8",
        }
    ]
}

例 2: 特定のルールを持つセキュリティグループを説明するには

次のdescribe-security-groups例では、フィルターを使用して、SSHトラフィックを許可するルール (ポート 22) と、すべてのアドレスからのトラフィックを許可するルール () を持つセキュリティグループに結果を絞り込みます0.0.0.0/0。例では、--query パラメータを使用してセキュリティグループの名前のみを表示しています。セキュリティグループが結果で返されるようにするには、すべてのフィルターに一致する必要があります。ただし、1 つのルールがすべてのフィルターに一致する必要はありません。例えば、出力は、特定の IP アドレスからのSSHトラフィックを許可するルールと、すべてのアドレスからのHTTPトラフィックを許可する別のルールを持つセキュリティグループを返します。

aws ec2 describe-security-groups \
    --filters Name=ip-permission.from-port,Values=22 Name=ip-permission.to-port,Values=22 Name=ip-permission.cidr,Values='0.0.0.0/0' \
    --query "SecurityGroups[*].[GroupName]" \
    --output text

出力:

default
my-security-group
web-servers
launch-wizard-1

例 3: タグに基づいてセキュリティグループを説明するには

次の describe-security-groups の例では、フィルターを使用して、セキュリティグループ名に test が含まれ、タグ Test=To-delete が付けられているセキュリティグループに結果を絞り込みます。この例では、 --queryパラメータを使用して、セキュリティグループの名前と IDs のみを表示します。

aws ec2 describe-security-groups \
    --filters Name=group-name,Values=*test* Name=tag:Test,Values=To-delete \
    --query "SecurityGroups[*].{Name:GroupName,ID:GroupId}"

出力:

[
    {
        "Name": "testfornewinstance",
        "ID": "sg-33bb22aa"
    },
    {
        "Name": "newgrouptest",
        "ID": "sg-1a2b3c4d"
    }
]

タグフィルターを使用するその他の例については、「Amazon ユーザーガイド」の「タグの使用」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeSecurityGroups」の「」を参照してください。 AWS CLI

次のコード例は、describe-snapshot-attribute を使用する方法を示しています。

AWS CLI

スナップショットのスナップショット属性を記述するには

次のdescribe-snapshot-attribute例では、スナップショットを共有するアカウントを一覧表示します。

aws ec2 describe-snapshot-attribute \
    --snapshot-id snap-01234567890abcedf \
    --attribute createVolumePermission

出力:

{
    "SnapshotId": "snap-01234567890abcedf",
    "CreateVolumePermissions": [
        {
            "UserId": "123456789012"
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「Amazon EBSスナップショットの共有」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeSnapshotAttribute」の「」を参照してください。 AWS CLI

次のコード例は、describe-snapshot-tier-status を使用する方法を示しています。

AWS CLI

アーカイブされたスナップショットに関するアーカイブ情報を表示するには

次のdescribe-snapshot-tier-status例では、アーカイブされたスナップショットに関するアーカイブ情報を提供します。

aws ec2 describe-snapshot-tier-status \
    --filters "Name=snapshot-id, Values=snap-01234567890abcedf"

出力:

{
    "SnapshotTierStatuses": [
        {
            "Status": "completed",
            "ArchivalCompleteTime": "2021-09-15T17:33:16.147Z",
            "LastTieringProgress": 100,
            "Tags": [],
            "VolumeId": "vol-01234567890abcedf",
            "LastTieringOperationState": "archival-completed",
            "StorageTier": "archive",
            "OwnerId": "123456789012",
            "SnapshotId": "snap-01234567890abcedf",
            "LastTieringStartTime": "2021-09-15T16:44:37.574Z"
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「アーカイブされたスナップショットを表示する」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeSnapshotTierStatus」の「」を参照してください。 AWS CLI

次のコード例は、describe-snapshots を使用する方法を示しています。

AWS CLI

例 1: スナップショットを説明するには

次の describe-snapshots の例では、指定したスナップショットを示しています。

aws ec2 describe-snapshots \
    --snapshot-ids snap-1234567890abcdef0

出力:

{
    "Snapshots": [
        {
            "Description": "This is my snapshot",
            "Encrypted": false,
            "VolumeId": "vol-049df61146c4d7901",
            "State": "completed",
            "VolumeSize": 8,
            "StartTime": "2019-02-28T21:28:32.000Z",
            "Progress": "100%",
            "OwnerId": "012345678910",
            "SnapshotId": "snap-01234567890abcdef",
            "Tags": [
                {
                    "Key": "Stack",
                    "Value": "test"
                }
            ]
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「Amazon EBSスナップショット」を参照してください。 EC2

例 2: フィルターに基づいてスナップショットを説明するには

次のdescribe-snapshots例では、フィルターを使用して、 AWS アカウントが所有する pending状態のスナップショットに結果を絞り込みます。この例では、 --queryパラメータを使用して、スナップショットIDsとスナップショットの開始時刻のみを表示します。

aws ec2 describe-snapshots \
    --owner-ids self \
    --filters Name=status,Values=pending \
    --query "Snapshots[*].{ID:SnapshotId,Time:StartTime}"

出力:

[
    {
        "ID": "snap-1234567890abcdef0",
        "Time": "2019-08-04T12:48:18.000Z"
    },
    {
        "ID": "snap-066877671789bd71b",
        "Time": "2019-08-04T02:45:16.000Z
    },
    ...
]

次の describe-snapshots の例では、フィルターを使用して、指定したボリュームから作成されたスナップショットに結果を絞っています。この例では、 --queryパラメータを使用してスナップショット のみを表示しますIDs。

aws ec2 describe-snapshots \
    --filters Name=volume-id,Values=049df61146c4d7901 \
    --query "Snapshots[*].[SnapshotId]" \
    --output text

出力:

snap-1234567890abcdef0
snap-08637175a712c3fb9
...

フィルターを使用したその他の例については、「Amazon EC2 ユーザーガイド」の「リソースの一覧表示とフィルタリング」を参照してください。

例 3: タグに基づいてスナップショットを説明するには

次の describe-snapshots の例では、タグフィルターを使用して、結果の範囲をタグ Stack=Prod を含むスナップショットに限定しています。

aws ec2 describe-snapshots \
    --filters Name=tag:Stack,Values=prod

describe-snapshots の出力例については、例 1 を参照してください。

タグフィルターを使用するその他の例については、「Amazon ユーザーガイド」の「タグの使用」を参照してください。 EC2

例 4: 日付に基づいてスナップショットを説明するには

次のdescribe-snapshots例では、JMESPath式を使用して、指定した日付より前に AWS アカウントによって作成されたすべてのスナップショットを記述します。スナップショット のみが表示されますIDs。

aws ec2 describe-snapshots \
    --owner-ids 012345678910 \
    --query "Snapshots[?(StartTime<='2020-03-31')].[SnapshotId]"

フィルターを使用したその他の例については、「Amazon EC2 ユーザーガイド」の「リソースの一覧表示とフィルタリング」を参照してください。

例 5: アーカイブされたスナップショットのみを表示するには

次の describe-snapshots の例では、アーカイブ階層に保存されたスナップショットのみを説明しています。

aws ec2 describe-snapshots \
    --filters "Name=storage-tier,Values=archive"

出力:

{
    "Snapshots": [
        {
            "Description": "Snap A",
            "Encrypted": false,
            "VolumeId": "vol-01234567890aaaaaa",
            "State": "completed",
            "VolumeSize": 8,
            "StartTime": "2021-09-07T21:00:00.000Z",
            "Progress": "100%",
            "OwnerId": "123456789012",
            "SnapshotId": "snap-01234567890aaaaaa",
            "StorageTier": "archive",
            "Tags": []
        },
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「アーカイブされたスナップショットを表示する」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeSnapshots」の「」を参照してください。 AWS CLI

次の例は、describe-spot-datafeed-subscription を使用する方法を説明しています。

AWS CLI

アカウントのスポットインスタンスデータフィードサブスクリプションを記述するには

このコマンド例は、アカウントのデータフィードを記述します。

コマンド:

aws ec2 describe-spot-datafeed-subscription

出力:

{
    "SpotDatafeedSubscription": {
        "OwnerId": "123456789012",
        "Prefix": "spotdata",
        "Bucket": "my-s3-bucket",
        "State": "Active"
    }
}

次の例は、describe-spot-fleet-instances を使用する方法を説明しています。

AWS CLI

スポットフリートに関連付けられたスポットインスタンスを記述するには

このコマンド例では、指定したスポットフリートに関連付けられているスポットインスタンスを一覧表示します。

コマンド:

aws ec2 describe-spot-fleet-instances --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE

出力:

{
  "ActiveInstances": [
      {
          "InstanceId": "i-1234567890abcdef0",
          "InstanceType": "m3.medium",
          "SpotInstanceRequestId": "sir-08b93456"
      },
      ...
  ],
  "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
}

  • API 詳細については、「 コマンドリファレンスDescribeSpotFleetInstances」の「」を参照してください。 AWS CLI

次の例は、describe-spot-fleet-request-history を使用する方法を説明しています。

AWS CLI

スポットフリートの履歴を記述するには

このコマンド例は、指定された時刻から、指定されたスポットフリートの履歴を返します。

コマンド:

aws ec2 describe-spot-fleet-request-history --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE --start-time 2015-05-26T00:00:00Z

次の出力例は、スポットフリートの 2 つのスポットインスタンスの正常な起動を示しています。

出力:

{
  "HistoryRecords": [
      {
          "Timestamp": "2015-05-26T23:17:20.697Z",
          "EventInformation": {
              "EventSubType": "submitted"
          },
          "EventType": "fleetRequestChange"
      },
      {
          "Timestamp": "2015-05-26T23:17:20.873Z",
          "EventInformation": {
              "EventSubType": "active"
          },
          "EventType": "fleetRequestChange"
      },
      {
          "Timestamp": "2015-05-26T23:21:21.712Z",
          "EventInformation": {
              "InstanceId": "i-1234567890abcdef0",
              "EventSubType": "launched"
          },
          "EventType": "instanceChange"
      },
      {
          "Timestamp": "2015-05-26T23:21:21.816Z",
          "EventInformation": {
              "InstanceId": "i-1234567890abcdef1",
              "EventSubType": "launched"
          },
          "EventType": "instanceChange"
      }
  ],
  "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
  "NextToken": "CpHNsscimcV5oH7bSbub03CI2Qms5+ypNpNm+53MNlR0YcXAkp0xFlfKf91yVxSExmbtma3awYxMFzNA663ZskT0AHtJ6TCb2Z8bQC2EnZgyELbymtWPfpZ1ZbauVg+P+TfGlWxWWB/Vr5dk5d4LfdgA/DRAHUrYgxzrEXAMPLE=",
  "StartTime": "2015-05-26T00:00:00Z"
}

次の例は、describe-spot-fleet-requests を使用する方法を説明しています。

AWS CLI

スポットフリートリクエストを記述するには

この例では、すべてのスポットフリートリクエストについて説明します。

コマンド:

aws ec2 describe-spot-fleet-requests

出力:

{
  "SpotFleetRequestConfigs": [
      {
          "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
          "SpotFleetRequestConfig": {
              "TargetCapacity": 20,
              "LaunchSpecifications": [
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "cc2.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  },
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "r3.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  }
              ],
              "SpotPrice": "0.05",
              "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role"
          },
          "SpotFleetRequestState": "active"
      },
      {
          "SpotFleetRequestId": "sfr-306341ed-9739-402e-881b-ce47bEXAMPLE",
          "SpotFleetRequestConfig": {
              "TargetCapacity": 20,
              "LaunchSpecifications": [
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-6e7f829e",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "m3.medium",
                      "ImageId": "ami-1a2b3c4d"
                  }
              ],
              "SpotPrice": "0.05",
              "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role"
          },
          "SpotFleetRequestState": "active"
      }
  ]
}

スポットフリートリクエストを記述するには

この例では、指定されたスポットフリートリクエストについて説明します。

コマンド:

aws ec2 describe-spot-fleet-requests --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE

出力:

{
  "SpotFleetRequestConfigs": [
      {
          "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
          "SpotFleetRequestConfig": {
              "TargetCapacity": 20,
              "LaunchSpecifications": [
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "cc2.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  },
                  {
                      "EbsOptimized": false,
                      "NetworkInterfaces": [
                          {
                              "SubnetId": "subnet-a61dafcf",
                              "DeviceIndex": 0,
                              "DeleteOnTermination": false,
                              "AssociatePublicIpAddress": true,
                              "SecondaryPrivateIpAddressCount": 0
                          }
                      ],
                      "InstanceType": "r3.8xlarge",
                      "ImageId": "ami-1a2b3c4d"
                  }
              ],
              "SpotPrice": "0.05",
              "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role"
          },
          "SpotFleetRequestState": "active"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeSpotFleetRequests」の「」を参照してください。 AWS CLI

次の例は、describe-spot-instance-requests を使用する方法を説明しています。

AWS CLI

例 1: スポットインスタンスリクエストを記述するには

次のdescribe-spot-instance-requests例では、指定されたスポットインスタンスリクエストについて説明します。

aws ec2 describe-spot-instance-requests \
    --spot-instance-request-ids sir-08b93456

出力:

{
    "SpotInstanceRequests": [
        {
            "CreateTime": "2018-04-30T18:14:55.000Z",
            "InstanceId": "i-1234567890abcdef1",
            "LaunchSpecification": {
                "InstanceType": "t2.micro",
                "ImageId": "ami-003634241a8fcdec0",
                "KeyName": "my-key-pair",
                "SecurityGroups": [
                    {
                        "GroupName": "default",
                        "GroupId": "sg-e38f24a7"
                    }
                ],
                "BlockDeviceMappings": [
                    {
                        "DeviceName": "/dev/sda1",
                        "Ebs": {
                            "DeleteOnTermination": true,
                            "SnapshotId": "snap-0e54a519c999adbbd",
                            "VolumeSize": 8,
                            "VolumeType": "standard",
                            "Encrypted": false
                        }
                    }
                ],
                "NetworkInterfaces": [
                    {
                        "DeleteOnTermination": true,
                        "DeviceIndex": 0,
                        "SubnetId": "subnet-049df61146c4d7901"
                    }
                ],
                "Placement": {
                    "AvailabilityZone": "us-east-2b",
                    "Tenancy": "default"
                },
                "Monitoring": {
                    "Enabled": false
                }
            },
            "LaunchedAvailabilityZone": "us-east-2b",
            "ProductDescription": "Linux/UNIX",
            "SpotInstanceRequestId": "sir-08b93456",
            "SpotPrice": "0.010000"
            "State": "active",
            "Status": {
                "Code": "fulfilled",
                "Message": "Your Spot request is fulfilled.",
                "UpdateTime": "2018-04-30T18:16:21.000Z"
            },
            "Tags": [],
            "Type": "one-time",
            "InstanceInterruptionBehavior": "terminate"
        }
    ]
}

例 2: フィルターに基づいてスポットインスタンスリクエストを記述するには

次のdescribe-spot-instance-requests例では、フィルターを使用して、指定されたアベイラビリティーゾーン内の指定されたインスタンスタイプのスポットインスタンスリクエストに結果を絞り込みます。この例では、 --queryパラメータを使用してインスタンス のみを表示しますIDs。

aws ec2 describe-spot-instance-requests \
    --filters Name=launch.instance-type,Values=m3.medium Name=launched-availability-zone,Values=us-east-2a \
    --query "SpotInstanceRequests[*].[InstanceId]" \
    --output text

出力:

i-057750d42936e468a
i-001efd250faaa6ffa
i-027552a73f021f3bd
...

フィルターを使用したその他の例については、「Amazon Elastic Compute Cloud ユーザーガイド」の「リソースの一覧表示とフィルタリング」を参照してください。

例 3: タグに基づいてスポットインスタンスリクエストを記述するには

次のdescribe-spot-instance-requests例では、タグフィルターを使用して、タグ を持つスポットインスタンスリクエストに結果を絞り込みますcost-center=cc123。

aws ec2 describe-spot-instance-requests \
    --filters Name=tag:cost-center,Values=cc123

describe-spot-instance-requests の出力例については、例 1 を参照してください。

タグフィルターを使用するその他の例については、「Amazon ユーザーガイド」の「タグの使用」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeSpotInstanceRequests」の「」を参照してください。 AWS CLI

次のコード例は、describe-spot-price-history を使用する方法を示しています。

AWS CLI

スポット料金履歴を記述するには

このコマンド例は、1 月の特定の日の m1.xlarge インスタンスのスポット料金履歴を返します。

コマンド:

aws ec2 describe-spot-price-history --instance-types m1.xlarge --start-time 2014-01-06T07:08:09 --end-time 2014-01-06T08:09:10

出力:

{
  "SpotPriceHistory": [
          {
              "Timestamp": "2014-01-06T07:10:55.000Z",
              "ProductDescription": "SUSE Linux",
              "InstanceType": "m1.xlarge",
              "SpotPrice": "0.087000",
              "AvailabilityZone": "us-west-1b"
          },
          {
              "Timestamp": "2014-01-06T07:10:55.000Z",
              "ProductDescription": "SUSE Linux",
              "InstanceType": "m1.xlarge",
              "SpotPrice": "0.087000",
              "AvailabilityZone": "us-west-1c"
          },
          {
              "Timestamp": "2014-01-06T05:42:36.000Z",
              "ProductDescription": "SUSE Linux (Amazon VPC)",
              "InstanceType": "m1.xlarge",
              "SpotPrice": "0.087000",
              "AvailabilityZone": "us-west-1a"
      },
      ...
}

Linux/UNIXAmazon のスポット料金履歴を記述するには VPC

このコマンド例は、1 月の特定の日の m1.xlarge、Linux/UNIXAmazon VPCインスタンスのスポット料金履歴を返します。

コマンド:

aws ec2 describe-spot-price-history --instance-types m1.xlarge --product-description "Linux/UNIX (Amazon VPC)" --start-time 2014-01-06T07:08:09 --end-time 2014-01-06T08:09:10

出力:

{
  "SpotPriceHistory": [
      {
          "Timestamp": "2014-01-06T04:32:53.000Z",
          "ProductDescription": "Linux/UNIX (Amazon VPC)",
          "InstanceType": "m1.xlarge",
          "SpotPrice": "0.080000",
          "AvailabilityZone": "us-west-1a"
      },
      {
          "Timestamp": "2014-01-05T11:28:26.000Z",
          "ProductDescription": "Linux/UNIX (Amazon VPC)",
          "InstanceType": "m1.xlarge",
          "SpotPrice": "0.080000",
          "AvailabilityZone": "us-west-1c"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeSpotPriceHistory」の「」を参照してください。 AWS CLI

次のコード例は、describe-stale-security-groups を使用する方法を示しています。

AWS CLI

古いセキュリティグループを記述するには

この例では、 の古いセキュリティグループルールについて説明しますvpc-11223344。レスポンスは、アカウントの sg-5fa68d3a にピア sg-279ab042で を参照する古い進入SSHルールがありVPC、アカウントの sg-fe6fba9aにピア sg-ef6fba8bで を参照する古い進入SSHルールがあることを示していますVPC。

コマンド:

aws ec2 describe-stale-security-groups --vpc-id vpc-11223344

出力:

{
  "StaleSecurityGroupSet": [
      {
          "VpcId": "vpc-11223344",
          "StaleIpPermissionsEgress": [
              {
                  "ToPort": 22,
                  "FromPort": 22,
                  "UserIdGroupPairs": [
                      {
                          "VpcId": "vpc-7a20e51f",
                          "GroupId": "sg-ef6fba8b",
                          "VpcPeeringConnectionId": "pcx-b04deed9",
                          "PeeringStatus": "active"
                      }
                  ],
                  "IpProtocol": "tcp"
              }
          ],
          "GroupName": "MySG1",
          "StaleIpPermissions": [],
          "GroupId": "sg-fe6fba9a",
          "Description": MySG1"
      },
      {
          "VpcId": "vpc-11223344",
          "StaleIpPermissionsEgress": [],
          "GroupName": "MySG2",
          "StaleIpPermissions": [
              {
                  "ToPort": 22,
                  "FromPort": 22,
                  "UserIdGroupPairs": [
                      {
                          "VpcId": "vpc-7a20e51f",
                          "GroupId": "sg-279ab042",
                          "Description": "Access from pcx-b04deed9",
                          "VpcPeeringConnectionId": "pcx-b04deed9",
                          "PeeringStatus": "active"
                      }
                  ],
                  "IpProtocol": "tcp"
              }
          ],
          "GroupId": "sg-5fa68d3a",
          "Description": "MySG2"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスDescribeStaleSecurityGroups」の「」を参照してください。 AWS CLI

次の例は、describe-store-image-tasks を使用する方法を説明しています。

AWS CLI

AMIストアタスクの進行状況を記述するには

次のdescribe-store-image-tasks例では、 AMIストアタスクの進行状況について説明します。

aws ec2 describe-store-image-tasks

出力:

{
    "AmiId": "ami-1234567890abcdef0",
    "Bucket": "my-ami-bucket",
    "ProgressPercentage": 17,
    "S3ObjectKey": "ami-1234567890abcdef0.bin",
    "StoreTaskState": "InProgress",
    "StoreTaskFailureReason": null,
    "TaskStartTime": "2022-01-01T01:01:01.001Z"
}

S3 AMIを使用した の保存と復元の詳細については、Amazon EC2ユーザーガイドのS3 <https://docs.aws.amazon.com/AWS EC2/latest/UserGuide/ami-store-restore.html> AMIを使用した の保存と復元」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeStoreImageTasks」の「」を参照してください。 AWS CLI

次の例は、describe-subnets を使用する方法を説明しています。

AWS CLI

例 1: すべてのサブネットを説明するには

次の describe-subnets の例では、サブネットの詳細を示します。

aws ec2 describe-subnets

出力:

{
    "Subnets": [
        {
            "AvailabilityZone": "us-east-1d",
            "AvailabilityZoneId": "use1-az2",
            "AvailableIpAddressCount": 4089,
            "CidrBlock": "172.31.80.0/20",
            "DefaultForAz": true,
            "MapPublicIpOnLaunch": false,
            "MapCustomerOwnedIpOnLaunch": true,
            "State": "available",
            "SubnetId": "subnet-0bb1c79de3EXAMPLE",
            "VpcId": "vpc-0ee975135dEXAMPLE",
            "OwnerId": "111122223333",
            "AssignIpv6AddressOnCreation": false,
            "Ipv6CidrBlockAssociationSet": [],
            "CustomerOwnedIpv4Pool:": 'pool-2EXAMPLE',
            "SubnetArn": "arn:aws:ec2:us-east-2:111122223333:subnet/subnet-0bb1c79de3EXAMPLE",
            "EnableDns64": false,
            "Ipv6Native": false,
            "PrivateDnsNameOptionsOnLaunch": {
                "HostnameType": "ip-name",
                "EnableResourceNameDnsARecord": false,
                "EnableResourceNameDnsAAAARecord": false
            }
        },
        {
            "AvailabilityZone": "us-east-1d",
            "AvailabilityZoneId": "use1-az2",
            "AvailableIpAddressCount": 4089,
            "CidrBlock": "172.31.80.0/20",
            "DefaultForAz": true,
            "MapPublicIpOnLaunch": true,
            "MapCustomerOwnedIpOnLaunch": false,
            "State": "available",
            "SubnetId": "subnet-8EXAMPLE",
            "VpcId": "vpc-3EXAMPLE",
            "OwnerId": "1111222233333",
            "AssignIpv6AddressOnCreation": false,
            "Ipv6CidrBlockAssociationSet": [],
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "MySubnet"
                }
            ],
            "SubnetArn": "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-8EXAMPLE",
            "EnableDns64": false,
            "Ipv6Native": false,
            "PrivateDnsNameOptionsOnLaunch": {
                "HostnameType": "ip-name",
                "EnableResourceNameDnsARecord": false,
                "EnableResourceNameDnsAAAARecord": false
            }
        }
    ]
}

詳細については、「 AWS VPCユーザーガイド」の「 VPCsとサブネットの使用」を参照してください。

例 2: 特定の のサブネットを記述するには VPC

次のdescribe-subnets例では、フィルターを使用して、指定された のサブネットの詳細を取得しますVPC。

aws ec2 describe-subnets \
    --filters "Name=vpc-id,Values=vpc-3EXAMPLE"

出力:

{
    "Subnets": [
        {
            "AvailabilityZone": "us-east-1d",
            "AvailabilityZoneId": "use1-az2",
            "AvailableIpAddressCount": 4089,
            "CidrBlock": "172.31.80.0/20",
            "DefaultForAz": true,
            "MapPublicIpOnLaunch": true,
            "MapCustomerOwnedIpOnLaunch": false,
            "State": "available",
            "SubnetId": "subnet-8EXAMPLE",
            "VpcId": "vpc-3EXAMPLE",
            "OwnerId": "1111222233333",
            "AssignIpv6AddressOnCreation": false,
            "Ipv6CidrBlockAssociationSet": [],
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "MySubnet"
                }
            ],
            "SubnetArn": "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-8EXAMPLE",
            "EnableDns64": false,
            "Ipv6Native": false,
            "PrivateDnsNameOptionsOnLaunch": {
                "HostnameType": "ip-name",
                "EnableResourceNameDnsARecord": false,
                "EnableResourceNameDnsAAAARecord": false
            }
        }
    ]
}

詳細については、「 AWS VPCユーザーガイド」の「 VPCsとサブネットの使用」を参照してください。

例 3: 特定のタグを持つサブネットを説明するには

次のdescribe-subnets例では、 フィルターを使用して タグを持つサブネットの詳細を取得しCostCenter=123、 --queryパラメータを使用してこの タグを持つサブネットIDsのサブネットを表示します。

aws ec2 describe-subnets \
    --filters "Name=tag:CostCenter,Values=123" \
    --query "Subnets[*].SubnetId" \
    --output text

出力:

subnet-0987a87c8b37348ef
subnet-02a95061c45f372ee
subnet-03f720e7de2788d73

詳細については、「Amazon VPC ユーザーガイド」の「 VPCsとサブネットの使用」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeSubnets」の「」を参照してください。 AWS CLI

次の例は、describe-tags を使用する方法を説明しています。

AWS CLI

例 1: 1 つのリソースのすべてのタグを記述するには

次のdescribe-tags例では、指定されたインスタンスのタグについて説明します。

aws ec2 describe-tags \
    --filters "Name=resource-id,Values=i-1234567890abcdef8"

出力:

{
    "Tags": [
        {
            "ResourceType": "instance",
            "ResourceId": "i-1234567890abcdef8",
            "Value": "Test",
            "Key": "Stack"
        },
        {
            "ResourceType": "instance",
            "ResourceId": "i-1234567890abcdef8",
            "Value": "Beta Server",
            "Key": "Name"
        }
    ]
}

例 2: リソースタイプのすべてのタグを記述するには

次のdescribe-tags例では、ボリュームのタグについて説明します。

aws ec2 describe-tags \
    --filters "Name=resource-type,Values=volume"

出力:

{
    "Tags": [
        {
            "ResourceType": "volume",
            "ResourceId": "vol-1234567890abcdef0",
            "Value": "Project1",
            "Key": "Purpose"
        },
        {
            "ResourceType": "volume",
            "ResourceId": "vol-049df61146c4d7901",
            "Value": "Logs",
            "Key": "Purpose"
        }
    ]
}

例 3: すべてのタグを記述するには

次のdescribe-tags例では、すべてのリソースのタグについて説明します。

aws ec2 describe-tags

例 4: タグキーに基づいてリソースのタグを記述するには

次のdescribe-tags例では、キー のタグを持つリソースのタグについて説明しますStack。

aws ec2 describe-tags \
    --filters Name=key,Values=Stack

出力:

{
    "Tags": [
        {
            "ResourceType": "volume",
            "ResourceId": "vol-027552a73f021f3b",
            "Value": "Production",
            "Key": "Stack"
        },
        {
            "ResourceType": "instance",
            "ResourceId": "i-1234567890abcdef8",
            "Value": "Test",
            "Key": "Stack"
        }
    ]
}

例 5: タグキーとタグ値に基づいてリソースのタグを記述するには

次のdescribe-tags例では、タグ を持つリソースのタグについて説明しますStack=Test。

aws ec2 describe-tags \
    --filters Name=key,Values=Stack Name=value,Values=Test

出力:

{
    "Tags": [
        {
            "ResourceType": "image",
            "ResourceId": "ami-3ac336533f021f3bd",
            "Value": "Test",
            "Key": "Stack"
        },
        {
            "ResourceType": "instance",
            "ResourceId": "i-1234567890abcdef8",
            "Value": "Test",
            "Key": "Stack"
        }
    ]
}

次のdescribe-tags例では、代替構文を使用して、タグ を持つリソースを記述しますStack=Test。

aws ec2 describe-tags \
    --filters "Name=tag:Stack,Values=Test"

次のdescribe-tags例では、 キーを持つタグPurposeがあり、値を持たないすべてのインスタンスのタグについて説明します。

aws ec2 describe-tags \
    --filters "Name=resource-type,Values=instance" "Name=key,Values=Purpose" "Name=value,Values="

出力:

{
    "Tags": [
        {
            "ResourceType": "instance",
            "ResourceId": "i-1234567890abcdef5",
            "Value": null,
            "Key": "Purpose"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeTags」の「」を参照してください。 AWS CLI

次のコード例は、describe-traffic-mirror-filters を使用する方法を示しています。

AWS CLI

トラフィックミラーフィルターを表示するには

次のdescribe-traffic-mirror-filters例では、すべてのトラフィックミラーフィルターの詳細を表示します。

aws ec2 describe-traffic-mirror-filters

出力:

{
    "TrafficMirrorFilters": [
        {
            "TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE",
            "IngressFilterRules": [
                {
                    "TrafficMirrorFilterRuleId": "tmfr-0ca76e0e08EXAMPLE",
                    "TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE",
                    "TrafficDirection": "ingress",
                    "RuleNumber": 100,
                    "RuleAction": "accept",
                    "Protocol": 6,
                    "DestinationCidrBlock": "10.0.0.0/24",
                    "SourceCidrBlock": "10.0.0.0/24",
                    "Description": "TCP Rule"
                }
            ],
            "EgressFilterRules": [],
            "NetworkServices": [],
            "Description": "Example filter",
            "Tags": []
        }
    ]
}

詳細については、「トラフィックミラーリングガイド」の「トラフィックミラーフィルターを表示する」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeTrafficMirrorFilters」の「」を参照してください。 AWS CLI

次の例は、describe-traffic-mirror-sessions を使用する方法を説明しています。

AWS CLI

Traffic Mirror セッションを記述するには

次のdescribe-traffic-mirror-sessions例では、Traffic Mirror セッションの詳細を表示します。

aws ec2 describe-traffic-mirror-sessions

出力:

{
    "TrafficMirrorSessions": [
        {
            "Tags": [],
            "VirtualNetworkId": 42,
            "OwnerId": "111122223333",
            "Description": "TCP Session",
            "NetworkInterfaceId": "eni-0a471a5cf3EXAMPLE",
            "TrafficMirrorTargetId": "tmt-0dabe9b0a6EXAMPLE",
            "TrafficMirrorFilterId": "tmf-083e18f985EXAMPLE",
            "PacketLength": 20,
            "SessionNumber": 1,
            "TrafficMirrorSessionId": "tms-0567a4c684EXAMPLE"
        },
        {
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "tag test"
                }
            ],
            "VirtualNetworkId": 13314501,
            "OwnerId": "111122223333",
            "Description": "TCP Session",
            "NetworkInterfaceId": "eni-0a471a5cf3EXAMPLE",
            "TrafficMirrorTargetId": "tmt-03665551cbEXAMPLE",
            "TrafficMirrorFilterId": "tmf-06c787846cEXAMPLE",
            "SessionNumber": 2,
            "TrafficMirrorSessionId": "tms-0060101cf8EXAMPLE"
        }
    ]
}

詳細については、トラフィックミラーリングガイドの「トラフィックミラーセッションの詳細を表示するAWS 」を参照してください。

次の例は、describe-traffic-mirror-targets を使用する方法を説明しています。

AWS CLI

トラフィックミラーターゲットを記述するには

次のdescribe-traffic-mirror-targets例では、指定されたトラフィックミラーターゲットに関する情報を表示します。

aws ec2 describe-traffic-mirror-targets \
    --traffic-mirror-target-ids tmt-0dabe9b0a6EXAMPLE

出力:

{
    "TrafficMirrorTargets": [
        {
            "TrafficMirrorTargetId": "tmt-0dabe9b0a6EXAMPLE",
            "NetworkLoadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:111122223333:loadbalancer/net/NLB/7cdec873fEXAMPLE",
            "Type": "network-load-balancer",
            "Description": "Example Network Load Balancer target",
            "OwnerId": "111122223333",
            "Tags": []
        }
    ]
}

詳細については、「Amazon トラフィックミラーリングガイド」の「トラフィックミラーターゲット」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDescribeTrafficMirrorTargets」の「」を参照してください。 AWS CLI

次の例は、describe-transit-gateway-attachments を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイアタッチメントを表示するには

次のdescribe-transit-gateway-attachments例では、トランジットゲートウェイアタッチメントの詳細を表示します。

aws ec2 describe-transit-gateway-attachments

出力:

{
    "TransitGatewayAttachments": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-01f8100bc7EXAMPLE",
            "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
            "TransitGatewayOwnerId": "123456789012",
            "ResourceOwnerId": "123456789012",
            "ResourceType": "vpc",
            "ResourceId": "vpc-3EXAMPLE",
            "State": "available",
            "Association": {
                "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE",
                "State": "associated"
            },
            "CreationTime": "2019-08-26T14:59:25.000Z",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Example"
                }
            ]
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-0b5968d3b6EXAMPLE",
            "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
            "TransitGatewayOwnerId": "123456789012",
            "ResourceOwnerId": "123456789012",
            "ResourceType": "vpc",
            "ResourceId": "vpc-0065acced4EXAMPLE",
            "State": "available",
            "Association": {
                "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE",
                "State": "associated"
            },
            "CreationTime": "2019-08-07T17:03:07.000Z",
            "Tags": []
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-08e0bc912cEXAMPLE",
            "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
            "TransitGatewayOwnerId": "123456789012",
            "ResourceOwnerId": "123456789012",
            "ResourceType": "direct-connect-gateway",
            "ResourceId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
            "State": "available",
            "Association": {
                "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE",
                "State": "associated"
            },
            "CreationTime": "2019-08-14T20:27:44.000Z",
            "Tags": []
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE",
            "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
            "TransitGatewayOwnerId": "123456789012",
            "ResourceOwnerId": "123456789012",
            "ResourceType": "direct-connect-gateway",
            "ResourceId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE",
            "State": "available",
            "Association": {
                "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE",
                "State": "associated"
            },
            "CreationTime": "2019-08-14T20:33:02.000Z",
            "Tags": []
        }
    ]
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイの使用」を参照してください。

次のコード例は、describe-transit-gateway-connect-peers を使用する方法を示しています。

AWS CLI

Transit Gateway Connect ピアを記述するには

次のdescribe-transit-gateway-connect-peers例では、指定された Connect ピアについて説明します。

aws ec2 describe-transit-gateway-connect-peers \
    --transit-gateway-connect-peer-ids tgw-connect-peer-0666adbac4EXAMPLE

出力:

{
    "TransitGatewayConnectPeers": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-0f0927767cEXAMPLE",
            "TransitGatewayConnectPeerId": "tgw-connect-peer-0666adbac4EXAMPLE",
            "State": "available",
            "CreationTime": "2021-10-13T03:35:17.000Z",
            "ConnectPeerConfiguration": {
                "TransitGatewayAddress": "10.0.0.234",
                "PeerAddress": "172.31.1.11",
                "InsideCidrBlocks": [
                    "169.254.6.0/29"
                ],
                "Protocol": "gre",
                "BgpConfigurations": [
                    {
                        "TransitGatewayAsn": 64512,
                        "PeerAsn": 64512,
                        "TransitGatewayAddress": "169.254.6.2",
                        "PeerAddress": "169.254.6.1",
                        "BgpStatus": "down"
                    },
                    {
                        "TransitGatewayAsn": 64512,
                        "PeerAsn": 64512,
                        "TransitGatewayAddress": "169.254.6.3",
                        "PeerAddress": "169.254.6.1",
                        "BgpStatus": "down"
                    }
                ]
            },
            "Tags": []
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway Connect アタッチメント」および「Transit Gateway Connect ピア」を参照してください。

次の例は、describe-transit-gateway-connects を使用する方法を説明しています。

AWS CLI

Transit Gateway Connect アタッチメントを記述するには

次のdescribe-transit-gateway-connects例では、指定された Connect アタッチメントについて説明します。

aws ec2 describe-transit-gateway-connects \
    --transit-gateway-attachment-ids tgw-attach-037012e5dcEXAMPLE

出力:

{
    "TransitGatewayConnects": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-037012e5dcEXAMPLE",
            "TransportTransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE",
            "TransitGatewayId": "tgw-02f776b1a7EXAMPLE",
            "State": "available",
            "CreationTime": "2021-03-09T19:59:17+00:00",
            "Options": {
                "Protocol": "gre"
            },
            "Tags": []
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway Connect アタッチメント」および「Transit Gateway Connect ピア」を参照してください。

次のコード例は、describe-transit-gateway-multicast-domains を使用する方法を示しています。

AWS CLI

トランジットゲートウェイマルチキャストドメインを記述するには

次のdescribe-transit-gateway-multicast-domains例では、すべてのトランジットゲートウェイマルチキャストドメインの詳細を表示します。

aws ec2 describe-transit-gateway-multicast-domains

出力:

{

    "TransitGatewayMulticastDomains": [
        {
            "TransitGatewayMulticastDomainId": "tgw-mcast-domain-000fb24d04EXAMPLE",
            "TransitGatewayId": "tgw-0bf0bffefaEXAMPLE",
            "TransitGatewayMulticastDomainArn": "arn:aws:ec2:us-east-1:123456789012:transit-gateway-multicast-domain/tgw-mcast-domain-000fb24d04EXAMPLE",
            "OwnerId": "123456789012",
            "Options": {
                "Igmpv2Support": "disable",
                "StaticSourcesSupport": "enable",
                "AutoAcceptSharedAssociations": "disable"
            },
            "State": "available",
            "CreationTime": "2019-12-10T18:32:50+00:00",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "mc1"
                }
            ]
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストドメインの管理」を参照してください。

次の例は、describe-transit-gateway-peering-attachments を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイピアリングアタッチメントを記述するには

次のdescribe-transit-gateway-peering-attachments例では、トランジットゲートウェイピアリングアタッチメントの詳細を表示します。

aws ec2 describe-transit-gateway-peering-attachments

出力:

{
    "TransitGatewayPeeringAttachments": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd",
            "RequesterTgwInfo": {
                "TransitGatewayId": "tgw-123abc05e04123abc",
                "OwnerId": "123456789012",
                "Region": "us-west-2"
            },
            "AccepterTgwInfo": {
                "TransitGatewayId": "tgw-11223344aabbcc112",
                "OwnerId": "123456789012",
                "Region": "us-east-2"
            },
            "State": "pendingAcceptance",
            "CreationTime": "2019-12-09T11:38:05.000Z",
            "Tags": []
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway ピアリングアタッチメント」を参照してください。

次の例は、describe-transit-gateway-policy-tables を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイポリシーテーブルを記述するには

次のdescribe-transit-gateway-policy-tables例では、指定された Transit Gateway ポリシーテーブルについて説明します。

aws ec2 describe-transit-gateway-policy-tables \
    --transit-gateway-policy-table-ids tgw-ptb-0a16f134b78668a81

出力:

{
    "TransitGatewayPolicyTables": [
        {
            "TransitGatewayPolicyTableId": "tgw-ptb-0a16f134b78668a81",
            "TransitGatewayId": "tgw-067f8505c18f0bd6e",
            "State": "available",
            "CreationTime": "2023-11-28T16:36:43+00:00",
            "Tags": []
        }
    ]
}

詳細については、「Transit Gateway ユーザーガイド」の「Transit Gateway ポリシーテーブル」を参照してください。

次のコード例は、describe-transit-gateway-route-tables を使用する方法を示しています。

AWS CLI

トランジットゲートウェイルートテーブルを記述するには

次のdescribe-transit-gateway-route-tables例では、トランジットゲートウェイルートテーブルの詳細を表示します。

aws ec2 describe-transit-gateway-route-tables

出力:

{
    "TransitGatewayRouteTables": [
        {
            "TransitGatewayRouteTableId": "tgw-rtb-0ca78a549EXAMPLE",
            "TransitGatewayId": "tgw-0bc994abffEXAMPLE",
            "State": "available",
            "DefaultAssociationRouteTable": true,
            "DefaultPropagationRouteTable": true,
            "CreationTime": "2018-11-28T14:24:49.000Z",
            "Tags": []
        },
        {
            "TransitGatewayRouteTableId": "tgw-rtb-0e8f48f148EXAMPLE",
            "TransitGatewayId": "tgw-0043d72bb4EXAMPLE",
            "State": "available",
            "DefaultAssociationRouteTable": true,
            "DefaultPropagationRouteTable": true,
            "CreationTime": "2018-11-28T14:24:00.000Z",
            "Tags": []
        }
    ]
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブルの表示」を参照してください。

次のコード例は、describe-transit-gateway-vpc-attachments を使用する方法を示しています。

AWS CLI

トランジットゲートウェイアタッチメントを記述するには VPC

次のdescribe-transit-gateway-vpc-attachments例では、トランジットゲートウェイVPCアタッチメントの詳細を表示します。

aws ec2 describe-transit-gateway-vpc-attachments

出力:

{
    "TransitGatewayVpcAttachments": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-0a08e88308EXAMPLE",
            "TransitGatewayId": "tgw-0043d72bb4EXAMPLE",
            "VpcId": "vpc-0f501f7ee8EXAMPLE",
            "VpcOwnerId": "111122223333",
            "State": "available",
            "SubnetIds": [
                "subnet-045d586432EXAMPLE",
                "subnet-0a0ad478a6EXAMPLE"
            ],
            "CreationTime": "2019-02-13T11:04:02.000Z",
            "Options": {
                "DnsSupport": "enable",
                "Ipv6Support": "disable"
            },
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "attachment name"
                }
            ]
        }
    ]
}

詳細については、「 Transit Gateways ガイド」のVPC「添付ファイルの表示」を参照してください。

次のコード例は、describe-transit-gateways を使用する方法を示しています。

AWS CLI

トランジットゲートウェイを記述するには

次のdescribe-transit-gateways例では、トランジットゲートウェイの詳細を取得します。

aws ec2 describe-transit-gateways

出力:

{
    "TransitGateways": [
        {
            "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
            "TransitGatewayArn": "arn:aws:ec2:us-east-2:111122223333:transit-gateway/tgw-0262a0e521EXAMPLE",
            "State": "available",
            "OwnerId": "111122223333",
            "Description": "MyTGW",
            "CreationTime": "2019-07-10T14:02:12.000Z",
            "Options": {
                "AmazonSideAsn": 64516,
                "AutoAcceptSharedAttachments": "enable",
                "DefaultRouteTableAssociation": "enable",
                "AssociationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE",
                "DefaultRouteTablePropagation": "enable",
                "PropagationDefaultRouteTableId": "tgw-rtb-018774adf3EXAMPLE",
                "VpnEcmpSupport": "enable",
                "DnsSupport": "enable"
            },
            "Tags": []
        },
        {
            "TransitGatewayId": "tgw-0fb8421e2dEXAMPLE",
            "TransitGatewayArn": "arn:aws:ec2:us-east-2:111122223333:transit-gateway/tgw-0fb8421e2da853bf3",
            "State": "available",
            "OwnerId": "111122223333",
            "CreationTime": "2019-03-15T22:57:33.000Z",
            "Options": {
                "AmazonSideAsn": 65412,
                "AutoAcceptSharedAttachments": "disable",
                "DefaultRouteTableAssociation": "enable",
                "AssociationDefaultRouteTableId": "tgw-rtb-06a241a3d8EXAMPLE",
                "DefaultRouteTablePropagation": "enable",
                "PropagationDefaultRouteTableId": "tgw-rtb-06a241a3d8EXAMPLE",
                "VpnEcmpSupport": "enable",
                "DnsSupport": "enable"
            },
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "TGW1"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeTransitGateways」の「」を参照してください。 AWS CLI

次のコード例は、describe-verified-access-endpoints を使用する方法を示しています。

AWS CLI

Verified Access エンドポイントを記述するには

次のdelete-verified-access-endpoints例では、指定された Verified Access エンドポイントについて説明します。

aws ec2 describe-verified-access-endpoints \
    --verified-access-endpoint-ids vae-066fac616d4d546f2

出力:

{
    "VerifiedAccessEndpoints": [
        {
            "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
            "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
            "VerifiedAccessEndpointId": "vae-066fac616d4d546f2",
            "ApplicationDomain": "example.com",
            "EndpointType": "network-interface",
            "AttachmentType": "vpc",
            "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE",
            "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com",
            "SecurityGroupIds": [
                "sg-004915970c4c8f13a"
            ],
            "NetworkInterfaceOptions": {
                "NetworkInterfaceId": "eni-0aec70418c8d87a0f",
                "Protocol": "https",
                "Port": 443
            },
            "Status": {
                "Code": "active"
            },
            "Description": "",
            "CreationTime": "2023-08-25T20:54:43",
            "LastUpdatedTime": "2023-08-25T22:17:26",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-va-endpoint"
                }
            ]
        }
    ]
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access エンドポイント」を参照してください。 AWS

次の例は、describe-verified-access-groups を使用する方法を説明しています。

AWS CLI

Verified Access グループを記述するには

次のdescribe-verified-access-groups例では、指定された Verified Access グループについて説明します。

aws ec2 describe-verified-access-groups \
    --verified-access-group-ids vagr-0dbe967baf14b7235

出力:

{
    "VerifiedAccessGroups": [
        {
            "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
            "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
            "Description": "Testing Verified Access",
            "Owner": "123456789012",
            "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235",
            "CreationTime": "2023-08-25T19:55:19",
            "LastUpdatedTime": "2023-08-25T22:17:25",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-va-group"
                }
            ]
        }
    ]
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access グループ」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスDescribeVerifiedAccessGroups」の「」を参照してください。 AWS CLI

次のコード例は、describe-verified-access-instance-logging-configurations を使用する方法を示しています。

AWS CLI

Verified Access インスタンスのログ記録設定を記述するには

次のdescribe-verified-access-instance-logging-configurations例では、指定された Verified Access インスタンスのログ記録設定について説明します。

aws ec2 describe-verified-access-instance-logging-configurations \
    --verified-access-instance-ids vai-0ce000c0b7643abea

出力:

{
    "LoggingConfigurations": [
        {
            "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
            "AccessLogs": {
                "S3": {
                    "Enabled": false
                },
                "CloudWatchLogs": {
                    "Enabled": true,
                    "DeliveryStatus": {
                        "Code": "success"
                    },
                    "LogGroup": "my-log-group"
                },
                "KinesisDataFirehose": {
                    "Enabled": false
                },
                "LogVersion": "ocsf-1.0.0-rc.2",
                "IncludeTrustContext": false
            }
        }
    ]
}

詳細については、「 Verified Access ユーザーガイド」の「Verified Access ログ」を参照してください。 AWS

次のコード例は、describe-verified-access-instances を使用する方法を示しています。

AWS CLI

Verified Access インスタンスを記述するには

次のdescribe-verified-access-instances例では、指定された Verified Access インスタンスについて説明します。

aws ec2 describe-verified-access-instances \
    --verified-access-instance-ids vai-0ce000c0b7643abea

出力:

{
    "VerifiedAccessInstances": [
        {
            "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
            "Description": "Testing Verified Access",
            "VerifiedAccessTrustProviders": [
                {
                    "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
                    "TrustProviderType": "user",
                    "UserTrustProviderType": "iam-identity-center"
                }
            ],
            "CreationTime": "2023-08-25T18:27:56",
            "LastUpdatedTime": "2023-08-25T19:03:32",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-ava-instance"
                }
            ]
        }
    ]
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access インスタンス」を参照してください。 AWS

次の例は、describe-verified-access-trust-providers を使用する方法を説明しています。

AWS CLI

Verified Access 信頼プロバイダーを記述するには

次のdescribe-verified-access-trust-providers例では、指定された Verified Access 信頼プロバイダーについて説明します。

aws ec2 describe-verified-access-trust-providers \
    --verified-access-trust-provider-ids vatp-0bb32de759a3e19e7

出力:

{
    "VerifiedAccessTrustProviders": [
        {
            "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
            "Description": "Testing Verified Access",
            "TrustProviderType": "user",
            "UserTrustProviderType": "iam-identity-center",
            "PolicyReferenceName": "idc",
            "CreationTime": "2023-08-25T19:00:38",
            "LastUpdatedTime": "2023-08-25T19:03:32",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-va-trust-provider"
                }
            ]
        }
    ]
}

詳細については、Verified Access ユーザーガイドの「Verified Access の信頼プロバイダーAWS 」を参照してください。

次の例は、describe-volume-attribute を使用する方法を説明しています。

AWS CLI

ボリューム属性を記述するには

このコマンド例では、ID を持つボリュームの autoEnableIo 属性を記述しますvol-049df61146c4d7901。

コマンド:

aws ec2 describe-volume-attribute --volume-id vol-049df61146c4d7901 --attribute autoEnableIO

出力:

{
    "AutoEnableIO": {
        "Value": false
    },
    "VolumeId": "vol-049df61146c4d7901"
}

  • API 詳細については、「 コマンドリファレンスDescribeVolumeAttribute」の「」を参照してください。 AWS CLI

次の例は、describe-volume-status を使用する方法を説明しています。

AWS CLI

1 つのボリュームのステータスを記述するには

このコマンド例では、ボリューム のステータスについて説明しますvol-1234567890abcdef0。

コマンド:

aws ec2 describe-volume-status --volume-ids vol-1234567890abcdef0

出力:

{
    "VolumeStatuses": [
        {
            "VolumeStatus": {
                "Status": "ok",
                "Details": [
                    {
                        "Status": "passed",
                        "Name": "io-enabled"
                    },
                    {
                        "Status": "not-applicable",
                        "Name": "io-performance"
                    }
                ]
            },
            "AvailabilityZone": "us-east-1a",
            "VolumeId": "vol-1234567890abcdef0",
            "Actions": [],
            "Events": []
        }
    ]
}

障害が発生したボリュームのステータスを記述するには

このコマンド例は、障害が発生したすべてのボリュームのステータスを記述します。この出力例では、障害のあるボリュームはありません。

コマンド:

aws ec2 describe-volume-status --filters Name=volume-status.status,Values=impaired

出力:

{
    "VolumeStatuses": []
}

ステータスチェックに失敗したボリュームがある場合 (ステータスに障害がある）、「Amazon EC2ユーザーガイド」の「障害のあるボリュームの操作」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeVolumeStatus」の「」を参照してください。 AWS CLI

次のコード例は、describe-volumes-modifications を使用する方法を示しています。

AWS CLI

ボリュームの変更ステータスを記述するには

次のdescribe-volumes-modifications例では、指定したボリュームのボリューム変更ステータスについて説明します。

aws ec2 describe-volumes-modifications \
    --volume-ids vol-1234567890abcdef0

出力:

{
    "VolumeModification": {
        "TargetSize": 150,
        "TargetVolumeType": "io1",
        "ModificationState": "optimizing",
        "VolumeId": " vol-1234567890abcdef0",
        "TargetIops": 100,
        "StartTime": "2019-05-17T11:27:19.000Z",
        "Progress": 70,
        "OriginalVolumeType": "io1",
        "OriginalIops": 100,
        "OriginalSize": 100
    }
}

  • API 詳細については、「 コマンドリファレンスDescribeVolumesModifications」の「」を参照してください。 AWS CLI

次の例は、describe-volumes を使用する方法を説明しています。

AWS CLI

例 1: ボリュームを記述するには

次のdescribe-volumes例では、現在のリージョンで指定されたボリュームについて説明します。

aws ec2 describe-volumes \
    --volume-ids vol-049df61146c4d7901 vol-1234567890abcdef0

出力:

{
    "Volumes": [
        {
            "AvailabilityZone": "us-east-1a",
            "Attachments": [
                {
                    "AttachTime": "2013-12-18T22:35:00.000Z",
                    "InstanceId": "i-1234567890abcdef0",
                    "VolumeId": "vol-049df61146c4d7901",
                    "State": "attached",
                    "DeleteOnTermination": true,
                    "Device": "/dev/sda1"
                }
            ],
            "Encrypted": true,
            "KmsKeyId": "arn:aws:kms:us-east-2a:123456789012:key/8c5b2c63-b9bc-45a3-a87a-5513eEXAMPLE,
            "VolumeType": "gp2",
            "VolumeId": "vol-049df61146c4d7901",
            "State": "in-use",
            "Iops": 100,
            "SnapshotId": "snap-1234567890abcdef0",
            "CreateTime": "2019-12-18T22:35:00.084Z",
            "Size": 8
        },
        {
            "AvailabilityZone": "us-east-1a",
            "Attachments": [],
            "Encrypted": false,
            "VolumeType": "gp2",
            "VolumeId": "vol-1234567890abcdef0",
            "State": "available",
            "Iops": 300,
            "SnapshotId": "",
            "CreateTime": "2020-02-27T00:02:41.791Z",
            "Size": 100
        }
    ]
}

例 2: 特定のインスタンスにアタッチされているボリュームを記述するには

次のdescribe-volumes例では、指定されたインスタンスにアタッチされ、インスタンスの終了時に削除されるように設定されたすべてのボリュームについて説明します。

aws ec2 describe-volumes \
    --region us-east-1 \
    --filters Name=attachment.instance-id,Values=i-1234567890abcdef0 Name=attachment.delete-on-termination,Values=true

describe-volumes の出力例については、例 1 を参照してください。

例 3: 特定のアベイラビリティーゾーンで使用可能なボリュームを記述するには

次のdescribe-volumes例では、ステータスが availableで、指定されたアベイラビリティーゾーンにあるすべてのボリュームについて説明します。

aws ec2 describe-volumes \
    --filters Name=status,Values=available Name=availability-zone,Values=us-east-1a

describe-volumes の出力例については、例 1 を参照してください。

例 4: タグに基づいてボリュームを記述するには

次のdescribe-volumes例では、 タグキーNameと で始まる値を持つすべてのボリュームについて説明しますTest。その後、出力は、ボリュームIDsのタグと のみを表示するクエリでフィルタリングされます。

aws ec2 describe-volumes \
    --filters Name=tag:Name,Values=Test* \
    --query "Volumes[*].{ID:VolumeId,Tag:Tags}"

出力:

[
    {
       "Tag": [
           {
               "Value": "Test2",
               "Key": "Name"
           }
       ],
       "ID": "vol-1234567890abcdef0"
   },
   {
       "Tag": [
           {
               "Value": "Test1",
               "Key": "Name"
           }
       ],
       "ID": "vol-049df61146c4d7901"
    }
]

タグフィルターを使用するその他の例については、「Amazon ユーザーガイド」の「タグの使用」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDescribeVolumes」の「」を参照してください。 AWS CLI

次の例は、describe-vpc-attribute を使用する方法を説明しています。

AWS CLI

enableDnsSupport 属性を記述するには

この例では、 enableDnsSupport 属性について説明します。この属性は、 でDNS解決が有効になっているかどうかを示しますVPC。この属性が の場合true、Amazon DNSサーバーはインスタンスのDNSホスト名を対応する IP アドレスに解決します。それ以外の場合は解決しません。

コマンド:

aws ec2 describe-vpc-attribute --vpc-id vpc-a01106c2 --attribute enableDnsSupport

出力:

{
    "VpcId": "vpc-a01106c2",
    "EnableDnsSupport": {
        "Value": true
    }
}

enableDnsHostnames 属性を記述するには

この例では、 enableDnsHostnames 属性について説明します。この属性は、 で起動されたインスタンスがDNSホスト名VPCを取得するかどうかを示します。この属性が の場合true、 のインスタンスはDNSホスト名VPCを取得します。それ以外の場合は取得しません。

コマンド:

aws ec2 describe-vpc-attribute --vpc-id vpc-a01106c2 --attribute enableDnsHostnames

出力:

{
    "VpcId": "vpc-a01106c2",
    "EnableDnsHostnames": {
        "Value": true
    }
}

  • API 詳細については、「 コマンドリファレンスDescribeVpcAttribute」の「」を参照してください。 AWS CLI

次の例は、describe-vpc-classic-link-dns-support を使用する方法を説明しています。

AWS CLI

のサポートを記述 ClassicLink DNSするには VPCs

この例では、 ClassicLink DNSすべての のサポートステータスについて説明しますVPCs。

コマンド:

aws ec2 describe-vpc-classic-link-dns-support

出力:

{
  "Vpcs": [
    {
      "VpcId": "vpc-88888888",
      "ClassicLinkDnsSupported": true
    },
    {
      "VpcId": "vpc-1a2b3c4d",
      "ClassicLinkDnsSupported": false
    }
  ]
}

次の例は、describe-vpc-classic-link を使用する方法を説明しています。

AWS CLI

ClassicLink のステータスを記述するには VPCs

この例では、vpc-88888888 ClassicLink のステータスを一覧表示します。

コマンド:

aws ec2 describe-vpc-classic-link --vpc-id vpc-88888888

出力:

{
  "Vpcs": [
    {
      "ClassicLinkEnabled": true,
      "VpcId": "vpc-88888888",
      "Tags": [
        {
          "Value": "classiclinkvpc",
          "Key": "Name"
        }
      ]
    }
  ]
}

この例ではVPCs、Classiclink に対して有効になっている のみを一覧表示します ( のフィルター値は にis-classic-link-enabled設定されていますtrue）。

コマンド:

aws ec2 describe-vpc-classic-link --filter "Name=is-classic-link-enabled,Values=true"

  • API 詳細については、「 コマンドリファレンスDescribeVpcClassicLink」の「」を参照してください。 AWS CLI

次のコード例は、describe-vpc-endpoint-connection-notifications を使用する方法を示しています。

AWS CLI

エンドポイント接続通知を記述するには

次のdescribe-vpc-endpoint-connection-notifications例では、すべてのエンドポイント接続通知について説明します。

aws ec2 describe-vpc-endpoint-connection-notifications

出力:

{
   "ConnectionNotificationSet": [
       {
           "ConnectionNotificationState": "Enabled",
           "ConnectionNotificationType": "Topic",
           "ConnectionEvents": [
               "Accept",
               "Reject",
               "Delete",
               "Connect"
           ],
           "ConnectionNotificationId": "vpce-nfn-04bcb952bc8af7abc",
           "ConnectionNotificationArn": "arn:aws:sns:us-east-1:123456789012:VpceNotification",
           "VpcEndpointId": "vpce-0324151a02f327123"
       }
   ]
 }

次のコード例は、describe-vpc-endpoint-connections を使用する方法を示しています。

AWS CLI

VPCエンドポイント接続を記述するには

この例では、エンドポイントサービスへのインターフェイスエンドポイント接続について説明し、結果をフィルタリングして であるエンドポイントを表示しますPendingAcceptance。

コマンド:

aws ec2 describe-vpc-endpoint-connections --filters Name=vpc-endpoint-state,Values=pendingAcceptance

出力:

{
  "VpcEndpointConnections": [
      {
          "VpcEndpointId": "vpce-0abed31004e618123",
          "ServiceId": "vpce-svc-0abced088d20def56",
          "CreationTimestamp": "2017-11-30T10:00:24.350Z",
          "VpcEndpointState": "pendingAcceptance",
          "VpcEndpointOwner": "123456789012"
      }
  ]
}

次のコード例は、describe-vpc-endpoint-service-configurations を使用する方法を示しています。

AWS CLI

エンドポイントサービス設定を記述するには

次のdescribe-vpc-endpoint-service-configurations例では、エンドポイントサービスの設定について説明します。

aws ec2 describe-vpc-endpoint-service-configurations

出力:

{
    "ServiceConfigurations": [
        {
            "ServiceType": [
                {
                    "ServiceType": "GatewayLoadBalancer"
                }
            ],
            "ServiceId": "vpce-svc-012d33a1c4321cabc",
            "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-012d33a1c4321cabc",
            "ServiceState": "Available",
            "AvailabilityZones": [
                "us-east-1d"
            ],
            "AcceptanceRequired": false,
            "ManagesVpcEndpoints": false,
            "GatewayLoadBalancerArns": [
                "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/gwy/GWLBService/123210844e429123"
            ],
            "Tags": []
        },
        {
            "ServiceType": [
                {
                    "ServiceType": "Interface"
                }
            ],
            "ServiceId": "vpce-svc-123cabc125efa123",
            "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123cabc125efa123",
            "ServiceState": "Available",
            "AvailabilityZones": [
                "us-east-1a"
            ],
            "AcceptanceRequired": true,
            "ManagesVpcEndpoints": false,
            "NetworkLoadBalancerArns": [
                "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/net/NLBforService/1238753950b25123"
            ],
            "BaseEndpointDnsNames": [
                "vpce-svc-123cabc125efa123.us-east-1.vpce.amazonaws.com"
            ],
            "PrivateDnsName": "example.com",
            "PrivateDnsNameConfiguration": {
                "State": "failed",
                "Type": "TXT",
                "Value": "vpce:qUAth3FdeABCApUiXabc",
                "Name": "_1d367jvbg34znqvyefrj"
            },
            "Tags": []
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「 VPCエンドポイントサービス」を参照してください。 VPC

次のコード例は、describe-vpc-endpoint-service-permissions を使用する方法を示しています。

AWS CLI

エンドポイントサービスのアクセス許可を記述するには

この例では、指定されたエンドポイントサービスのアクセス許可について説明します。

コマンド:

aws ec2 describe-vpc-endpoint-service-permissions --service-id vpce-svc-03d5ebb7d9579a2b3

出力:

{
   "AllowedPrincipals": [
       {
           "PrincipalType": "Account",
           "Principal": "arn:aws:iam::123456789012:root"
       }
   ]
}

次のコード例は、describe-vpc-endpoint-services を使用する方法を示しています。

AWS CLI

例 1: すべてのVPCエンドポイントサービスを記述するには

次のdescribe-vpc-endpoint-services「」の例では、 AWS リージョンのすべてのVPCエンドポイントサービスを一覧表示します。

aws ec2 describe-vpc-endpoint-services

出力:

{
    "ServiceDetails": [
        {
            "ServiceType": [
                {
                    "ServiceType": "Gateway"
                }
            ],
            "AcceptanceRequired": false,
            "ServiceName": "com.amazonaws.us-east-1.dynamodb",
            "VpcEndpointPolicySupported": true,
            "Owner": "amazon",
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
                "us-east-1f"
            ],
            "BaseEndpointDnsNames": [
                "dynamodb.us-east-1.amazonaws.com"
            ]
        },
        {
            "ServiceType": [
                {
                    "ServiceType": "Interface"
                }
            ],
            "PrivateDnsName": "ec2.us-east-1.amazonaws.com",
            "ServiceName": "com.amazonaws.us-east-1.ec2",
            "VpcEndpointPolicySupported": false,
            "Owner": "amazon",
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
                "us-east-1f"
            ],
            "AcceptanceRequired": false,
            "BaseEndpointDnsNames": [
                "ec2.us-east-1.vpce.amazonaws.com"
            ]
        },
        {
            "ServiceType": [
                {
                    "ServiceType": "Interface"
                }
            ],
            "PrivateDnsName": "ssm.us-east-1.amazonaws.com",
            "ServiceName": "com.amazonaws.us-east-1.ssm",
            "VpcEndpointPolicySupported": true,
            "Owner": "amazon",
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e"
            ],
            "AcceptanceRequired": false,
            "BaseEndpointDnsNames": [
                "ssm.us-east-1.vpce.amazonaws.com"
            ]
        }
    ],
    "ServiceNames": [
        "com.amazonaws.us-east-1.dynamodb",
        "com.amazonaws.us-east-1.ec2",
        "com.amazonaws.us-east-1.ec2messages",
        "com.amazonaws.us-east-1.elasticloadbalancing",
        "com.amazonaws.us-east-1.kinesis-streams",
        "com.amazonaws.us-east-1.s3",
        "com.amazonaws.us-east-1.ssm"
    ]
}

詳細については、「 ユーザーガイド」の「使用可能な AWS サービス名を表示する AWS PrivateLink」を参照してください。

例 2: エンドポイントサービスの詳細を記述するには

次のdescribe-vpc-endpoint-services「」の例では、Amazon S3 インターフェイスエンドポイントのスリッチの詳細を一覧表示します。

aws ec2 describe-vpc-endpoint-services \
    --filter "Name=service-type,Values=Interface" Name=service-name,Values=com.amazonaws.us-east-1.s3

出力:

{
    "ServiceDetails": [
        {
            "ServiceName": "com.amazonaws.us-east-1.s3",
            "ServiceId": "vpce-svc-081d84efcdEXAMPLE",
            "ServiceType": [
                {
                    "ServiceType": "Interface"
                }
            ],
            "AvailabilityZones": [
                "us-east-1a",
                "us-east-1b",
                "us-east-1c",
                "us-east-1d",
                "us-east-1e",
            "us-east-1f"
            ],
            "Owner": "amazon",
            "BaseEndpointDnsNames": [
                "s3.us-east-1.vpce.amazonaws.com"
            ],
            "VpcEndpointPolicySupported": true,
            "AcceptanceRequired": false,
            "ManagesVpcEndpoints": false,
            "Tags": []
        }
    ],
    "ServiceNames": [
        "com.amazonaws.us-east-1.s3"
    ]
}

詳細については、「 ユーザーガイド」の「使用可能な AWS サービス名を表示する AWS PrivateLink」を参照してください。

  • API 詳細については、「 コマンドリファレンスDescribeVpcEndpointServices」の「」を参照してください。 AWS CLI

次のコード例は、describe-vpc-endpoints を使用する方法を示しています。

AWS CLI

VPCエンドポイントを記述するには

次のdescribe-vpc-endpoints例では、すべてのVPCエンドポイントの詳細を表示します。

aws ec2 describe-vpc-endpoints

出力:

{
    "VpcEndpoints": [
        {
            "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":\"*\",\"Action\":\"*\",\"Resource\":\"*\"}]}",
            "VpcId": "vpc-aabb1122",
            "NetworkInterfaceIds": [],
            "SubnetIds": [],
            "PrivateDnsEnabled": true,
            "State": "available",
            "ServiceName": "com.amazonaws.us-east-1.dynamodb",
            "RouteTableIds": [
                "rtb-3d560345"
            ],
            "Groups": [],
            "VpcEndpointId": "vpce-032a826a",
            "VpcEndpointType": "Gateway",
            "CreationTimestamp": "2017-09-05T20:41:28Z",
            "DnsEntries": [],
            "OwnerId": "123456789012"
        },
        {
            "PolicyDocument": "{\n  \"Statement\": [\n    {\n      \"Action\": \"*\", \n      \"Effect\": \"Allow\", \n      \"Principal\": \"*\", \n      \"Resource\": \"*\"\n    }\n  ]\n}",
            "VpcId": "vpc-1a2b3c4d",
            "NetworkInterfaceIds": [
                "eni-2ec2b084",
                "eni-1b4a65cf"
            ],
            "SubnetIds": [
                "subnet-d6fcaa8d",
                "subnet-7b16de0c"
            ],
            "PrivateDnsEnabled": false,
            "State": "available",
            "ServiceName": "com.amazonaws.us-east-1.elasticloadbalancing",
            "RouteTableIds": [],
            "Groups": [
                {
                    "GroupName": "default",
                    "GroupId": "sg-54e8bf31"
                }
            ],
            "VpcEndpointId": "vpce-0f89a33420c1931d7",
            "VpcEndpointType": "Interface",
            "CreationTimestamp": "2017-09-05T17:55:27.583Z",
            "DnsEntries": [
                {
                    "HostedZoneId": "Z7HUB22UULQXV",
                    "DnsName": "vpce-0f89a33420c1931d7-bluzidnv.elasticloadbalancing.us-east-1.vpce.amazonaws.com"
                },
                {
                    "HostedZoneId": "Z7HUB22UULQXV",
                    "DnsName": "vpce-0f89a33420c1931d7-bluzidnv-us-east-1b.elasticloadbalancing.us-east-1.vpce.amazonaws.com"
                },
                {
                    "HostedZoneId": "Z7HUB22UULQXV",
                    "DnsName": "vpce-0f89a33420c1931d7-bluzidnv-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com"
                }
            ],
            "OwnerId": "123456789012"
        },
        {
            "VpcEndpointId": "vpce-aabbaabbaabbaabba",
            "VpcEndpointType": "GatewayLoadBalancer",
            "VpcId": "vpc-111122223333aabbc",
            "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123",
            "State": "available",
            "SubnetIds": [
                "subnet-0011aabbcc2233445"
            ],
            "RequesterManaged": false,
            "NetworkInterfaceIds": [
                "eni-01010120203030405"
            ],
            "CreationTimestamp": "2020-11-11T08:06:03.522Z",
            "Tags": [],
            "OwnerId": "123456789012"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「 VPCエンドポイント」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDescribeVpcEndpoints」の「」を参照してください。 AWS CLI

次の例は、describe-vpc-peering-connections を使用する方法を説明しています。

AWS CLI

VPCピアリング接続を記述するには

この例では、すべてのVPCピアリング接続について説明します。

コマンド:

aws ec2 describe-vpc-peering-connections

出力:

{
    "VpcPeeringConnections": [
        {
            "Status": {
                "Message": "Active",
                "Code": "active"
            },
            "Tags": [
                {
                    "Value": "Peering-1",
                    "Key": "Name"
                }
            ],
            "AccepterVpcInfo": {
                "OwnerId": "111122223333",
                "VpcId": "vpc-1a2b3c4d",
                "CidrBlock": "10.0.1.0/28"
            },
            "VpcPeeringConnectionId": "pcx-11122233",
            "RequesterVpcInfo": {
                "PeeringOptions": {
                    "AllowEgressFromLocalVpcToRemoteClassicLink": false,
                    "AllowEgressFromLocalClassicLinkToRemoteVpc": false
                },
                "OwnerId": "444455556666",
                "VpcId": "vpc-123abc45",
                "CidrBlock": "192.168.0.0/16"
            }
        },
        {
            "Status": {
                "Message": "Pending Acceptance by 444455556666",
                "Code": "pending-acceptance"
            },
            "Tags": [],
            "RequesterVpcInfo": {
                "PeeringOptions": {
                    "AllowEgressFromLocalVpcToRemoteClassicLink": false,
                    "AllowEgressFromLocalClassicLinkToRemoteVpc": false
                },
                "OwnerId": "444455556666",
                "VpcId": "vpc-11aa22bb",
                "CidrBlock": "10.0.0.0/28"
            },
            "VpcPeeringConnectionId": "pcx-abababab",
            "ExpirationTime": "2014-04-03T09:12:43.000Z",
            "AccepterVpcInfo": {
                "OwnerId": "444455556666",
                "VpcId": "vpc-33cc44dd"
            }
        }
    ]
}

特定のVPCピアリング接続を記述するには

この例では、保留中の承諾状態にあるすべてのVPCピアリング接続について説明します。

コマンド:

aws ec2 describe-vpc-peering-connections --filters Name=status-code,Values=pending-acceptance

この例では、 Owner=Finance タグを持つすべてのVPCピアリング接続について説明します。

コマンド:

aws ec2 describe-vpc-peering-connections --filters Name=tag:Owner,Values=Finance

この例では、指定した vpc-1a2b3c4d VPCに対してリクエストしたすべてのVPCピアリング接続について説明します。

コマンド:

aws ec2 describe-vpc-peering-connections --filters Name=requester-vpc-info.vpc-id,Values=vpc-1a2b3c4d

次のコード例は、describe-vpcs を使用する方法を示しています。

AWS CLI

例 1: すべての を記述するには VPCs

次のdescribe-vpcs例では、 の詳細を取得しますVPCs。

aws ec2 describe-vpcs

出力:

{
    "Vpcs": [
        {
            "CidrBlock": "30.1.0.0/16",
            "DhcpOptionsId": "dopt-19edf471",
            "State": "available",
            "VpcId": "vpc-0e9801d129EXAMPLE",
            "OwnerId": "111122223333",
            "InstanceTenancy": "default",
            "CidrBlockAssociationSet": [
                {
                    "AssociationId": "vpc-cidr-assoc-062c64cfafEXAMPLE",
                    "CidrBlock": "30.1.0.0/16",
                    "CidrBlockState": {
                        "State": "associated"
                    }
                }
            ],
            "IsDefault": false,
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Not Shared"
                }
            ]
        },
        {
            "CidrBlock": "10.0.0.0/16",
            "DhcpOptionsId": "dopt-19edf471",
            "State": "available",
            "VpcId": "vpc-06e4ab6c6cEXAMPLE",
            "OwnerId": "222222222222",
            "InstanceTenancy": "default",
            "CidrBlockAssociationSet": [
                {
                    "AssociationId": "vpc-cidr-assoc-00b17b4eddEXAMPLE",
                    "CidrBlock": "10.0.0.0/16",
                    "CidrBlockState": {
                        "State": "associated"
                    }
                }
            ],
            "IsDefault": false,
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Shared VPC"
                }
            ]
        }
    ]
}

例 2: 指定された を記述するには VPC

次のdescribe-vpcs例では、指定された の詳細を取得しますVPC。

aws ec2 describe-vpcs \
    --vpc-ids vpc-06e4ab6c6cEXAMPLE

出力:

{
    "Vpcs": [
        {
            "CidrBlock": "10.0.0.0/16",
            "DhcpOptionsId": "dopt-19edf471",
            "State": "available",
            "VpcId": "vpc-06e4ab6c6cEXAMPLE",
            "OwnerId": "111122223333",
            "InstanceTenancy": "default",
            "CidrBlockAssociationSet": [
                {
                    "AssociationId": "vpc-cidr-assoc-00b17b4eddEXAMPLE",
                    "CidrBlock": "10.0.0.0/16",
                    "CidrBlockState": {
                        "State": "associated"
                    }
                }
            ],
            "IsDefault": false,
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "Shared VPC"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeVpcs」の「」を参照してください。 AWS CLI

次の例は、describe-vpn-connections を使用する方法を説明しています。

AWS CLI

例 1: VPN接続を記述するには

次のdescribe-vpn-connections例では、すべての Site-to-Site VPN接続について説明します。

aws ec2 describe-vpn-connections

出力:

{
    "VpnConnections": [
        {
            "CustomerGatewayConfiguration": "...configuration information...",
            "CustomerGatewayId": "cgw-01234567abcde1234",
            "Category": "VPN",
            "State": "available",
            "Type": "ipsec.1",
            "VpnConnectionId": "vpn-1122334455aabbccd",
            "TransitGatewayId": "tgw-00112233445566aab",
            "Options": {
                "EnableAcceleration": false,
                "StaticRoutesOnly": true,
                "LocalIpv4NetworkCidr": "0.0.0.0/0",
                "RemoteIpv4NetworkCidr": "0.0.0.0/0",
                "TunnelInsideIpVersion": "ipv4"
            },
            "Routes": [],
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "CanadaVPN"
                }
            ],
            "VgwTelemetry": [
                {
                    "AcceptedRouteCount": 0,
                    "LastStatusChange": "2020-07-29T10:35:11.000Z",
                    "OutsideIpAddress": "203.0.113.3",
                    "Status": "DOWN",
                    "StatusMessage": ""
                },
                {
                    "AcceptedRouteCount": 0,
                    "LastStatusChange": "2020-09-02T09:09:33.000Z",
                    "OutsideIpAddress": "203.0.113.5",
                    "Status": "UP",
                    "StatusMessage": ""
                }
            ]
        }
    ]
}

詳細については、AWS 「 Site-to-Site ユーザーガイド」の「Site-to-Site のVPN仕組み」を参照してください。 AWS VPN

例 2: 使用可能なVPN接続を記述するには

次のdescribe-vpn-connections例では、 状態の Site-to-Site VPN接続について説明しますavailable。

aws ec2 describe-vpn-connections \
    --filters "Name=state,Values=available"

詳細については、AWS 「 Site-to-Site ユーザーガイド」の「Site-to-Site のVPN仕組み」を参照してください。 AWS VPN

  • API 詳細については、「 コマンドリファレンスDescribeVpnConnections」の「」を参照してください。 AWS CLI

次の例は、describe-vpn-gateways を使用する方法を説明しています。

AWS CLI

仮想プライベートゲートウェイを記述するには

この例では、仮想プライベートゲートウェイについて説明します。

コマンド:

aws ec2 describe-vpn-gateways

出力:

{
    "VpnGateways": [
        {
            "State": "available",
            "Type": "ipsec.1",
            "VpnGatewayId": "vgw-f211f09b",
            "VpcAttachments": [
                {
                    "State": "attached",
                    "VpcId": "vpc-98eb5ef5"
                }
            ]
        },
        {
            "State": "available",
            "Type": "ipsec.1",
            "VpnGatewayId": "vgw-9a4cacf3",
            "VpcAttachments": [
                {
                    "State": "attaching",
                    "VpcId": "vpc-a01106c2"
                }
            ]
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスDescribeVpnGateways」の「」を参照してください。 AWS CLI

次の例は、detach-classic-link-vpc を使用する方法を説明しています。

AWS CLI

から EC2-Classic インスタンスのリンクを解除 (デタッチ) するには VPC

この例では、インスタンス i-0598c7d356eba48d7 を vpc-88888888 VPC からリンク解除します。

コマンド:

aws ec2 detach-classic-link-vpc --instance-id i-0598c7d356eba48d7 --vpc-id vpc-88888888

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスDetachClassicLinkVpc」の「」を参照してください。 AWS CLI

次のコード例は、detach-internet-gateway を使用する方法を示しています。

AWS CLI

からインターネットゲートウェイをデタッチするには VPC

次のdetach-internet-gateway例では、指定されたインターネットゲートウェイを特定の からデタッチしますVPC。

aws ec2 detach-internet-gateway \
    --internet-gateway-id igw-0d0fb496b3EXAMPLE \
    --vpc-id vpc-0a60eb65b4EXAMPLE

このコマンドでは何も出力されません。

詳細については、「Amazon VPCユーザーガイド」の「インターネットゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスDetachInternetGateway」の「」を参照してください。 AWS CLI

次の例は、detach-network-interface を使用する方法を説明しています。

AWS CLI

インスタンスからネットワークインターフェイスをデタッチするには

この例では、指定されたネットワークインターフェイスを指定されたインスタンスからデタッチします。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 detach-network-interface --attachment-id eni-attach-66c4350a

  • API 詳細については、「 コマンドリファレンスDetachNetworkInterface」の「」を参照してください。 AWS CLI

次の例は、detach-verified-access-trust-provider を使用する方法を説明しています。

AWS CLI

インスタンスから信頼プロバイダーをデタッチするには

次のdetach-verified-access-trust-provider例では、指定された Verified Access 信頼プロバイダーを指定された Verified Access インスタンスからデタッチします。

aws ec2 detach-verified-access-trust-provider \
    --verified-access-instance-id vai-0ce000c0b7643abea \
    --verified-access-trust-provider-id vatp-0bb32de759a3e19e7

出力:

{
    "VerifiedAccessTrustProvider": {
        "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
        "Description": "Testing Verified Access",
        "TrustProviderType": "user",
        "UserTrustProviderType": "iam-identity-center",
        "PolicyReferenceName": "idc",
        "CreationTime": "2023-08-25T19:00:38",
        "LastUpdatedTime": "2023-08-25T19:00:38"
    },
    "VerifiedAccessInstance": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "Testing Verified Access",
        "VerifiedAccessTrustProviders": [],
        "CreationTime": "2023-08-25T18:27:56",
        "LastUpdatedTime": "2023-08-25T18:27:56"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access インスタンス」を参照してください。 AWS

次の例は、detach-volume を使用する方法を説明しています。

AWS CLI

インスタンスからボリュームをデタッチするには

このコマンド例では、アタッチされているインスタンスからボリューム (vol-049df61146c4d7901) をデタッチします。

コマンド:

aws ec2 detach-volume --volume-id vol-1234567890abcdef0

出力:

{
    "AttachTime": "2014-02-27T19:23:06.000Z",
    "InstanceId": "i-1234567890abcdef0",
    "VolumeId": "vol-049df61146c4d7901",
    "State": "detaching",
    "Device": "/dev/sdb"
}

  • API 詳細については、「 コマンドリファレンスDetachVolume」の「」を参照してください。 AWS CLI

次のコード例は、detach-vpn-gateway を使用する方法を示しています。

AWS CLI

仮想プライベートゲートウェイを からデタッチするには VPC

この例では、指定された仮想プライベートゲートウェイを指定された からデタッチしますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 detach-vpn-gateway --vpn-gateway-id vgw-9a4cacf3 --vpc-id vpc-a01106c2

  • API 詳細については、「 コマンドリファレンスDetachVpnGateway」の「」を参照してください。 AWS CLI

次のコード例は、disable-address-transfer を使用する方法を示しています。

AWS CLI

Elastic IP アドレス転送を無効にするには

次のdisable-address-transfer例では、指定された Elastic IP アドレスの Elastic IP アドレス転送を無効にします。

aws ec2 disable-address-transfer \
    --allocation-id eipalloc-09ad461b0d03f6aaf

出力:

{
    "AddressTransfer": {
        "PublicIp": "100.21.184.216",
        "AllocationId": "eipalloc-09ad461b0d03f6aaf",
        "AddressTransferStatus": "disabled"
    }
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレスの転送」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスDisableAddressTransfer」の「」を参照してください。 AWS CLI

次のコード例は、disable-aws-network-performance-metric-subscription を使用する方法を示しています。

AWS CLI

メトリクスサブスクリプションを無効にするには

次のdisable-aws-network-performance-metric-subscription例では、指定された送信元リージョンと送信先リージョン間のネットワークレイテンシーの集計モニタリングを無効にします。

aws ec2 disable-aws-network-performance-metric-subscription \
    --source us-east-1 \
    --destination eu-west-1 \
    --metric aggregate-latency \
    --statistic p50

出力:

{
    "Output": true
}

詳細については、「インフラストラクチャパフォーマンスユーザーガイド」の「サブスクリプションの管理」を参照してください。

次のコード例は、disable-ebs-encryption-by-default を使用する方法を示しています。

AWS CLI

EBS暗号化をデフォルトで無効にするには

次のdisable-ebs-encryption-by-default例では、現在のリージョンの AWS アカウントのEBS暗号化をデフォルトで無効にします。

aws ec2 disable-ebs-encryption-by-default

出力:

{
    "EbsEncryptionByDefault": false
}

次のコード例は、disable-fast-launch を使用する方法を示しています。

AWS CLI

イメージの高速起動を中止するには

次のdisable-fast-launch例では、指定された での高速起動を中止しAMI、事前プロビジョニングされた既存のスナップショットをクリーンアップします。

aws ec2 disable-fast-launch \
    --image-id ami-01234567890abcedf

出力:

{
    "ImageId": "ami-01234567890abcedf",
    "ResourceType": "snapshot",
    "SnapshotConfiguration": {},
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-01234567890abcedf",
        "LaunchTemplateName": "EC2FastLaunchDefaultResourceCreation-a8c6215d-94e6-441b-9272-dbd1f87b07e2",
        "Version": "1"
    },
    "MaxParallelLaunches": 6,
    "OwnerId": "0123456789123",
    "State": "disabling",
    "StateTransitionReason": "Client.UserInitiated",
    "StateTransitionTime": "2022-01-27T22:47:29.265000+00:00"
}

高速起動AMI用に Windows を設定する方法の詳細については、「Amazon EC2 ユーザーガイド」の「高速起動AMI用に を設定する」を参照してください。

  • API 詳細については、「 コマンドリファレンスDisableFastLaunch」の「」を参照してください。 AWS CLI

次のコード例は、disable-fast-snapshot-restores を使用する方法を示しています。

AWS CLI

高速スナップショット復元を無効にするには

次のdisable-fast-snapshot-restores例では、指定されたアベイラビリティーゾーン内の指定されたスナップショットの高速スナップショット復元を無効にします。

aws ec2 disable-fast-snapshot-restores \
    --availability-zones us-east-2a \
    --source-snapshot-ids snap-1234567890abcdef0

出力:

{
    "Successful": [
        {
            "SnapshotId": "snap-1234567890abcdef0"
            "AvailabilityZone": "us-east-2a",
            "State": "disabling",
            "StateTransitionReason": "Client.UserInitiated",
            "OwnerId": "123456789012",
            "EnablingTime": "2020-01-25T23:57:49.602Z"
        }
    ],
    "Unsuccessful": []
}

  • API 詳細については、「 コマンドリファレンスDisableFastSnapshotRestores」の「」を参照してください。 AWS CLI

次のコード例は、disable-image-block-public-access を使用する方法を示しています。

AWS CLI

指定されたリージョンAMIsで のパブリックアクセスのブロックを無効にするには

次のdisable-image-block-public-access例では、指定したリージョンAMIsのアカウントレベルで のブロックパブリックアクセスを無効にします。

aws ec2 disable-image-block-public-access \
    --region us-east-1

出力:

{
    "ImageBlockPublicAccessState": "unblocked"
}

詳細については、「Amazon ユーザーガイド」の「 へのパブリックアクセスのブロックAMIs」を参照してください。 EC2

次のコード例は、disable-image-deprecation を使用する方法を示しています。

AWS CLI

の非推奨をキャンセルするには AMI

次のdisable-image-deprecation例では、 の非推奨をキャンセルしAMI、describe-images出力から DeprecationTimeフィールドを削除します。この手順を実行するには、AMI所有者である必要があります。

aws ec2 disable-image-deprecation \
    --image-id ami-1234567890abcdef0

出力:

{
    "RequestID": "11aabb229-4eac-35bd-99ed-be587EXAMPLE",
    "Return": "true"
}

詳細については、「Amazon EC2ユーザーガイド」のAMI「＜https://docs.aws.amazon.com/AWS EC2/latest/UserGuide/ami-deprecate.html#deprecate-ami> を廃止する」を参照してください。

  • API 詳細については、「 コマンドリファレンスDisableImageDeprecation」の「」を参照してください。 AWS CLI

次の例は、disable-image を使用する方法を説明しています。

AWS CLI

を無効にするには AMI

次のdisable-image例では、指定された を無効にしますAMI。

aws ec2 disable-image \
    --image-id ami-1234567890abcdef0

出力:

{
    "Return": "true"
}

詳細については、「Amazon ユーザーガイド」のAMI「 を無効にする」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDisableImage」の「」を参照してください。 AWS CLI

次のコード例は、disable-ipam-organization-admin-account を使用する方法を示しています。

AWS CLI

委任されたIPAM管理者を無効にするには

特定のシナリオでは、 AWS Organizations IPAMと統合します。これを行うと、 AWS Organizations 管理アカウントは Organizations AWS メンバーアカウントをIPAM管理者として委任します。

この例では、管理者アカウントを委任した AWS Organizations IPAM 管理アカウントであり、そのアカウントをIPAM管理者として無効にします。

このリクエストを行う--regionときは、 の任意の AWS リージョンを使用できます。最初に管理者を委任したリージョン、 がIPAM作成されたリージョン、またはIPAM運用リージョンを使用する必要はありません。委任された管理者アカウントを無効にすると、いつでも再度有効にすることも、新しいアカウントをIPAM管理者として委任することもできます。

次のdisable-ipam-organization-admin-account例では、アカウントの委任管理者を無効にIPAMします AWS 。

aws ec2 disable-ipam-organization-admin-account \
    --delegated-admin-account-id 320805250157 \
    --region ap-south-1

出力:

{
    "Success": true
}

詳細については、「Amazon ユーザーガイド」の AWS 「組織内のアカウントIPAMとの統合」を参照してください。 VPC IPAM

次のコード例は、disable-serial-console-access を使用する方法を示しています。

AWS CLI

アカウントのEC2シリアルコンソールへのアクセスを無効にするには

次のdisable-serial-console-access例では、シリアルコンソールへのアカウントアクセスを無効にします。

aws ec2 disable-serial-console-access

出力:

{
    "SerialConsoleAccessEnabled": false
}

詳細については、「Amazon ユーザーガイド」のEC2「シリアルコンソール」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスDisableSerialConsoleAccess」の「」を参照してください。 AWS CLI

次の例は、disable-snapshot-block-public-access を使用する方法を説明しています。

AWS CLI

スナップショットのパブリックアクセスブロックを無効にするには

次のdisable-snapshot-block-public-access例では、スナップショットのパブリックアクセスのブロックを無効にして、スナップショットのパブリック共有を許可します。

aws ec2 disable-snapshot-block-public-access

出力:

{
    "State": "unblocked"
}

詳細については、「Amazon EBSユーザーガイド」の「スナップショットのパブリックアクセスのブロック」を参照してください。

次の例は、disable-transit-gateway-route-table-propagation を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイアタッチメントを無効にして、指定された伝達ルートテーブルにルートを伝達するには

次のdisable-transit-gateway-route-table-propagation例では、指定されたアタッチメントを無効にして、指定された伝播ルートテーブルにルートを伝播します。

aws ec2 disable-transit-gateway-route-table-propagation \
    --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \
    --transit-gateway-attachment-id tgw-attach-09b52ccdb5EXAMPLE

出力:

{
    "Propagation": {
        "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
        "ResourceId": "vpc-4d7de228",
        "ResourceType": "vpc",
        "TransitGatewayRouteTableId": "tgw-rtb-0a823edbdeEXAMPLE",
        "State": "disabled"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

次のコード例は、disable-vgw-route-propagation を使用する方法を示しています。

AWS CLI

ルート伝達を無効にするには

この例では、指定された仮想プライベートゲートウェイが静的ルートを指定されたルートテーブルに伝達することを無効にします。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 disable-vgw-route-propagation --route-table-id rtb-22574640 --gateway-id vgw-9a4cacf3

  • API 詳細については、「 コマンドリファレンスDisableVgwRoutePropagation」の「」を参照してください。 AWS CLI

次のコード例は、disable-vpc-classic-link-dns-support を使用する方法を示しています。

AWS CLI

のサポートを無効にする ClassicLink DNSには VPC

この例では、 ClassicLink DNS のサポートを無効にしますvpc-88888888。

コマンド:

aws ec2 disable-vpc-classic-link-dns-support --vpc-id vpc-88888888

出力:

{
  "Return": true
}

次のコード例は、disable-vpc-classic-link を使用する方法を示しています。

AWS CLI

ClassicLink の を無効にするには VPC

この例では、vpc-8888888 ClassicLink に対して を無効にします。

コマンド:

aws ec2 disable-vpc-classic-link --vpc-id vpc-88888888

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスDisableVpcClassicLink」の「」を参照してください。 AWS CLI

次のコード例は、disassociate-address を使用する方法を示しています。

AWS CLI

EC2-Classic で Elastic IP アドレスの関連付けを解除するには

この例では、EC2-Classic のインスタンスから Elastic IP アドレスの関連付けを解除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 disassociate-address --public-ip 198.51.100.0

EC2- で Elastic IP アドレスの関連付けを解除するにはVPC

この例では、Elastic IP アドレスと のインスタンスの関連付けを解除しますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 disassociate-address --association-id eipassoc-2bebb745

  • API 詳細については、「 コマンドリファレンスDisassociateAddress」の「」を参照してください。 AWS CLI

次の例は、disassociate-client-vpn-target-network を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントからネットワークの関連付けを解除するには

次のdisassociate-client-vpn-target-network例では、指定されたクライアントVPNエンドポイントの関連付け ID に関連付けられているターゲットネットワークのcvpn-assoc-12312312312312312関連付けを解除します。

aws ec2 disassociate-client-vpn-target-network \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --association-id cvpn-assoc-12312312312312312

出力:

{
    "AssociationId": "cvpn-assoc-12312312312312312",
    "Status": {
        "Code": "disassociating"
    }
}

詳細については、クライアント管理者ガイドの「ターゲットネットワーク」を参照してください。 AWS VPN

次の例は、disassociate-iam-instance-profile を使用する方法を説明しています。

AWS CLI

IAMインスタンスプロファイルの関連付けを解除するには

この例では、IAMインスタンスプロファイルと関連付け ID の関連付けを解除しますiip-assoc-05020b59952902f5f。

コマンド:

aws ec2 disassociate-iam-instance-profile --association-id iip-assoc-05020b59952902f5f

出力:

{
  "IamInstanceProfileAssociation": {
      "InstanceId": "i-123456789abcde123",
      "State": "disassociating",
      "AssociationId": "iip-assoc-05020b59952902f5f",
      "IamInstanceProfile": {
          "Id": "AIPAI5IVIHMFFYY2DKV5Y",
          "Arn": "arn:aws:iam::123456789012:instance-profile/admin-role"
      }
  }
}

次の例は、disassociate-instance-event-window を使用する方法を説明しています。

AWS CLI

例 1: イベントウィンドウから 1 つ以上のインスタンスの関連付けを解除するには

次のdisassociate-instance-event-window例では、イベントウィンドウから 1 つ以上のインスタンスの関連付けを解除します。instance-event-window-id パラメータを指定して、イベントウィンドウを指定します。インスタンスの関連付けを解除するには、 association-targetパラメータを指定し、 パラメータ値に 1 つ以上のインスタンス を指定しますIDs。

aws ec2 disassociate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 2: イベントウィンドウからインスタンスタグの関連付けを解除するには

次のdisassociate-instance-event-window例では、イベントウィンドウからインスタンスタグの関連付けを解除します。instance-event-window-id パラメータを指定して、イベントウィンドウを指定します。インスタンスタグの関連付けを解除するには、association-target パラメータを使用し、その値に 1 つ以上のタグを指定します。

aws ec2 disassociate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 3: Dedicated Host とイベントウィンドウの関連付けを解除するには

次のdisassociate-instance-event-window例では、Dedicated Host とイベントウィンドウの関連付けを解除します。instance-event-window-id パラメータを指定して、イベントウィンドウを指定します。Dedicated Host の関連付けを解除するには、 association-targetパラメータを指定し、 パラメータ値に 1 つ以上の Dedicated Host を指定しますIDs。

aws ec2 disassociate-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --association-target DedicatedHostIds=h-029fa35a02b99801d

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating"
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

次の例は、disassociate-ipam-resource-discovery を使用する方法を説明しています。

AWS CLI

からリソース検出の関連付けを解除するには IPAM

この例では、委任された管理者アカウントであり、 IPAM からIPAMリソース検出の関連付けを解除しますIPAM。describe コマンドを実行し、 "ResourceDiscoveryStatus": "not-found"と の関連付けを解除してIPAM、他の関連付けのためのスペースを確保したいことに気付きました。

次のdisassociate-ipam-resource-discovery例では、 AWS アカウントのIPAMリソース検出の関連付けを解除します。

aws ec2 disassociate-ipam-resource-discovery \
    --ipam-resource-discovery-association-id ipam-res-disco-assoc-04382a6346357cf82 \
    --region us-east-1

出力:

{
    "IpamResourceDiscoveryAssociation": {
        "OwnerId": "320805250157",
        "IpamResourceDiscoveryAssociationId": "ipam-res-disco-assoc-04382a6346357cf82",
        "IpamResourceDiscoveryAssociationArn":             "arn:aws:ec2::320805250157:ipam-resource-discovery-association/ipam-res-disco-assoc-04382a6346357cf82",
        "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
        "IpamId": "ipam-005f921c17ebd5107",
        "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107",
        "IpamRegion": "us-east-1",
        "IsDefault": false,
        "ResourceDiscoveryStatus": "not-found",
        "State": "disassociate-in-progress"
    }
}

詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

次の例は、disassociate-nat-gateway-address を使用する方法を説明しています。

AWS CLI

パブリックNATゲートウェイから Elastic IP アドレスの関連付けを解除するには

次のdisassociate-nat-gateway-address例では、指定された Elastic IP アドレスと指定されたパブリックNATゲートウェイの関連付けを解除します。

aws ec2 disassociate-nat-gateway-address \
    --nat-gateway-id nat-1234567890abcdef0 \
    --association-ids eipassoc-0f96bdca17EXAMPLE

出力:

{
    "NatGatewayId": "nat-1234567890abcdef0",
    "NatGatewayAddresses": [
        {
            "AllocationId": "eipalloc-0be6ecac95EXAMPLE",
            "NetworkInterfaceId": "eni-09cc4b2558794f7f9",
            "PrivateIp": "10.0.0.74",
            "PublicIp": "3.211.231.218",
            "AssociationId": "eipassoc-0f96bdca17EXAMPLE",
            "IsPrimary": false,
            "Status": "disassociating"
        }
    ]
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

次のコード例は、disassociate-route-table を使用する方法を示しています。

AWS CLI

ルートテーブルの関連付けを解除するには

この例では、指定されたサブネットから指定されたルートテーブルの関連付けを解除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 disassociate-route-table --association-id rtbassoc-781d0d1a

  • API 詳細については、「 コマンドリファレンスDisassociateRouteTable」の「」を参照してください。 AWS CLI

次の例は、disassociate-subnet-cidr-block を使用する方法を説明しています。

AWS CLI

サブネットから IPv6CIDRブロックの関連付けを解除するには

この例では、 IPv6CIDRブロックの関連付け ID を使用して、サブネットから CIDRブロックの関連付けを解除します。

コマンド:

aws ec2 disassociate-subnet-cidr-block --association-id subnet-cidr-assoc-3aa54053

出力:

{
  "SubnetId": "subnet-5f46ec3b",
  "Ipv6CidrBlockAssociation": {
      "Ipv6CidrBlock": "2001:db8:1234:1a00::/64",
      "AssociationId": "subnet-cidr-assoc-3aa54053",
      "Ipv6CidrBlockState": {
          "State": "disassociating"
      }
  }
}

  • API 詳細については、「 コマンドリファレンスDisassociateSubnetCidrBlock」の「」を参照してください。 AWS CLI

次の例は、disassociate-transit-gateway-multicast-domain を使用する方法を説明しています。

AWS CLI

マルチキャストドメインからサブネットの関連付けを解除するには

次のdisassociate-transit-gateway-multicast-domain例では、指定されたマルチキャストドメインからサブネットの関連付けを解除します。

aws ec2 disassociate-transit-gateway-multicast-domain \
    --transit-gateway-attachment-id tgw-attach-070e571cd1EXAMPLE \
    --subnet-id subnet-000de86e3bEXAMPLE \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE

出力:

{
    "Associations": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef7EXAMPLE",
        "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE",
        "ResourceId": "vpc-7EXAMPLE",
        "ResourceType": "vpc",
        "Subnets": [
            {
                "SubnetId": "subnet-000de86e3bEXAMPLE",
                "State": "disassociating"
            }
        ]
    }
}

詳細については、「トランジットゲートウェイガイド」の「マルチキャストの使用」を参照してください。

次のコード例は、disassociate-transit-gateway-route-table を使用する方法を示しています。

AWS CLI

リソースアタッチメントからトランジットゲートウェイルートテーブルの関連付けを解除するには

次のdisassociate-transit-gateway-route-table例では、指定されたアタッチメントと Transit Gateway ルートテーブルの関連付けを解除します。

aws ec2 disassociate-transit-gateway-route-table \
    --transit-gateway-route-table-id tgw-rtb-002573ed1eEXAMPLE \
    --transit-gateway-attachment-id tgw-attach-08e0bc912cEXAMPLE

出力:

{
    "Association": {
        "TransitGatewayRouteTableId": "tgw-rtb-002573ed1eEXAMPLE",
        "TransitGatewayAttachmentId": "tgw-attach-08e0bc912cEXAMPLE",
        "ResourceId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
        "ResourceType": "direct-connect-gateway",
        "State": "disassociating"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

次の例は、disassociate-vpc-cidr-block を使用する方法を説明しています。

AWS CLI

IPv6CIDRブロックと の関連付けを解除するには VPC

この例では、 IPv6CIDRブロックの関連付け ID VPCを使用して、 ブロックと の関連付けを解除しますCIDR。

コマンド:

aws ec2 disassociate-vpc-cidr-block --association-id vpc-cidr-assoc-eca54085

出力:

{
  "Ipv6CidrBlockAssociation": {
      "Ipv6CidrBlock": "2001:db8:1234:1a00::/56",
      "AssociationId": "vpc-cidr-assoc-eca54085",
      "Ipv6CidrBlockState": {
          "State": "disassociating"
      }
  },
  "VpcId": "vpc-a034d6c4"
}

IPv4CIDRブロックと の関連付けを解除するには VPC

この例では、 IPv4CIDRブロックと の関連付けを解除しますVPC。

コマンド:

aws ec2 disassociate-vpc-cidr-block --association-id vpc-cidr-assoc-0287ac6b

出力:

{
  "CidrBlockAssociation": {
      "AssociationId": "vpc-cidr-assoc-0287ac6b",
      "CidrBlock": "172.18.0.0/16",
      "CidrBlockState": {
          "State": "disassociating"
      }
  },
  "VpcId": "vpc-27621243"
}

  • API 詳細については、「 コマンドリファレンスDisassociateVpcCidrBlock」の「」を参照してください。 AWS CLI

次のコード例は、enable-address-transfer を使用する方法を示しています。

AWS CLI

Elastic IP アドレス転送を有効にするには

次のenable-address-transfer例では、指定された Elastic IP アドレスの指定されたアカウントへの Elastic IP アドレス転送を有効にします。

aws ec2 enable-address-transfer \
    --allocation-id eipalloc-09ad461b0d03f6aaf \
    --transfer-account-id 123456789012

出力:

{
     "AddressTransfer": {
        "PublicIp": "100.21.184.216",
        "AllocationId": "eipalloc-09ad461b0d03f6aaf",
        "TransferAccountId": "123456789012",
        "TransferOfferExpirationTimestamp": "2023-02-22T20:51:01.000Z",
        "AddressTransferStatus": "pending"
    }
}

詳細については、「Amazon ユーザーガイド」の「Elastic IP アドレスを転送する」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスEnableAddressTransfer」の「」を参照してください。 AWS CLI

次の例は、enable-aws-network-performance-metric-subscription を使用する方法を説明しています。

AWS CLI

メトリクスサブスクリプションを有効にするには

次のenable-aws-network-performance-metric-subscription例では、指定された送信元リージョンと送信先リージョン間のネットワークレイテンシーの集計をモニタリングできます。

aws ec2 enable-aws-network-performance-metric-subscription \
    --source us-east-1 \
    --destination eu-west-1 \
    --metric aggregate-latency \
    --statistic p50

出力:

{
    "Output": true
}

詳細については、「インフラストラクチャパフォーマンスユーザーガイド」の「サブスクリプションの管理」を参照してください。

次の例は、enable-ebs-encryption-by-default を使用する方法を説明しています。

AWS CLI

EBS暗号化をデフォルトで有効にするには

次のenable-ebs-encryption-by-default例では、現在のリージョンの AWS アカウントに対してデフォルトでEBS暗号化を有効にします。

aws ec2 enable-ebs-encryption-by-default

出力:

{
    "EbsEncryptionByDefault": true
}

  • API 詳細については、「 コマンドリファレンスEnableEbsEncryptionByDefault」の「」を参照してください。 AWS CLI

次の例は、enable-fast-launch を使用する方法を説明しています。

AWS CLI

イメージの高速起動を開始するには

次のenable-fast-launch例では、指定された で高速起動を開始し、起動する並列インスタンスの最大数を 6 AMIに設定します。の事前プロビジョニングに使用するリソースのタイプAMIはsnapshot、デフォルト値でもある に設定されます。

aws ec2 enable-fast-launch \
    --image-id ami-01234567890abcedf \
    --max-parallel-launches 6 \
    --resource-type snapshot

出力:

{
    "ImageId": "ami-01234567890abcedf",
    "ResourceType": "snapshot",
    "SnapshotConfiguration": {
        "TargetResourceCount": 10
    },
    "LaunchTemplate": {},
    "MaxParallelLaunches": 6,
    "OwnerId": "0123456789123",
    "State": "enabling",
    "StateTransitionReason": "Client.UserInitiated",
    "StateTransitionTime": "2022-01-27T22:16:03.199000+00:00"
}

高速起動AMI用に Windows を設定する方法の詳細については、「Amazon EC2 ユーザーガイド」の「高速起動AMI用に を設定する」を参照してください。

  • API 詳細については、「 コマンドリファレンスEnableFastLaunch」の「」を参照してください。 AWS CLI

次の例は、enable-fast-snapshot-restores を使用する方法を説明しています。

AWS CLI

高速スナップショット復元を有効にするには

次のenable-fast-snapshot-restores例では、指定されたアベイラビリティーゾーンで指定されたスナップショットの高速スナップショット復元を有効にします。

aws ec2 enable-fast-snapshot-restores \
    --availability-zones us-east-2a us-east-2b \
    --source-snapshot-ids snap-1234567890abcdef0

出力:

{
    "Successful": [
        {
            "SnapshotId": "snap-1234567890abcdef0"
            "AvailabilityZone": "us-east-2a",
            "State": "enabling",
            "StateTransitionReason": "Client.UserInitiated",
            "OwnerId": "123456789012",
            "EnablingTime": "2020-01-25T23:57:49.602Z"
        },
        {
            "SnapshotId": "snap-1234567890abcdef0"
            "AvailabilityZone": "us-east-2b",
            "State": "enabling",
            "StateTransitionReason": "Client.UserInitiated",
            "OwnerId": "123456789012",
            "EnablingTime": "2020-01-25T23:57:49.596Z"
        }
    ],
    "Unsuccessful": []
}

  • API 詳細については、「 コマンドリファレンスEnableFastSnapshotRestores」の「」を参照してください。 AWS CLI

次のコード例は、enable-image-block-public-access を使用する方法を示しています。

AWS CLI

指定されたリージョンAMIsで のパブリックアクセスのブロックを有効にするには

次のenable-image-block-public-access例では、指定したリージョンAMIsのアカウントレベルで のパブリックアクセスのブロックを有効にします。

aws ec2 enable-image-block-public-access \
    --region us-east-1 \
    --image-block-public-access-state block-new-sharing

出力:

{
    "ImageBlockPublicAccessState": "block-new-sharing"
}

詳細については、「Amazon ユーザーガイド」の「 へのパブリックアクセスのブロックAMIs」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスEnableImageBlockPublicAccess」の「」を参照してください。 AWS CLI

次の例は、enable-image-deprecation を使用する方法を説明しています。

AWS CLI

例 1: を非推奨にするには AMI

次のenable-image-deprecation例では、特定の日付と時刻AMIに を非推奨にします。秒の値を指定すると、Amazon は秒を最も近い分にEC2四捨五入します。この手順を実行するには、AMI所有者である必要があります。

aws ec2 enable-image-deprecation \
    --image-id ami-1234567890abcdef0 \
    --deprecate-at "2022-10-15T13:17:12.000Z"

出力:

{
    "RequestID": "59dbff89-35bd-4eac-99ed-be587EXAMPLE",
    "Return": "true"
}

詳細については、「Amazon EC2ユーザーガイド」のAMI「＜https://docs.aws.amazon.com/AWS EC2/latest/UserGuide/ami-deprecate.html#deprecate-ami> を廃止する」を参照してください。

  • API 詳細については、「 コマンドリファレンスEnableImageDeprecation」の「」を参照してください。 AWS CLI

次の例は、enable-image を使用する方法を説明しています。

AWS CLI

を有効にするには AMI

次のenable-image例では、指定された を有効にしますAMI。

aws ec2 enable-image \
    --image-id ami-1234567890abcdef0

出力:

{
    "Return": "true"
}

詳細については、「Amazon ユーザーガイド」の「 の無効化AMI」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスEnableImage」の「」を参照してください。 AWS CLI

次の例は、enable-ipam-organization-admin-account を使用する方法を説明しています。

AWS CLI

Organizations AWS と統合し、メンバーアカウントをIPAMアカウントとして委任するには

次のenable-ipam-organization-admin-account例では、 AWS Organizations IPAMと統合し、メンバーアカウントをIPAMアカウントとして委任します。

aws ec2 enable-ipam-organization-admin-account \
    --delegated-admin-account-id 320805250157

出力:

{
    "Success": true
}

詳細については、「Amazon VPCIPAMユーザーガイド」のAWS 「組織IPAMとの統合」を参照してください。

次のコード例は、enable-reachability-analyzer-organization-sharing を使用する方法を示しています。

AWS CLI

Reachability Analyzer の信頼されたアクセスを有効にするには

次のenable-reachability-analyzer-organization-sharing例では、Reachability Analyzer の信頼されたアクセスを有効にします。

aws ec2 enable-reachability-analyzer-organization-sharing

このコマンドでは何も出力されません。

詳細については、「Reachability Analyzer ユーザーガイド」の「クロスアカウント分析」を参照してください。

次の例は、enable-serial-console-access を使用する方法を説明しています。

AWS CLI

アカウントのシリアルコンソールへのアクセスを有効にするには

次のenable-serial-console-access例では、シリアルコンソールへのアカウントアクセスを有効にします。

aws ec2 enable-serial-console-access

出力:

{
    "SerialConsoleAccessEnabled": true
}

詳細については、「Amazon ユーザーガイド」のEC2「シリアルコンソール」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスEnableSerialConsoleAccess」の「」を参照してください。 AWS CLI

次の例は、enable-snapshot-block-public-access を使用する方法を説明しています。

AWS CLI

スナップショットのパブリックアクセスブロックを有効にするには

次のenable-snapshot-block-public-access例では、スナップショットのすべてのパブリック共有をブロックします。

aws ec2 enable-snapshot-block-public-access \
    --state block-all-sharing

出力:

{
    "State": "block-all-sharing"
}

詳細については、「Amazon EBSユーザーガイド」の「スナップショットのパブリックアクセスのブロック」を参照してください。

次の例は、enable-transit-gateway-route-table-propagation を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイアタッチメントが指定された伝播ルートテーブルにルートを伝播できるようにするには

次のenable-transit-gateway-route-table-propagation例では、指定されたアタッチメントが指定された伝播ルートテーブルにルートを伝播できるようにします。

aws ec2 enable-transit-gateway-route-table-propagation \
    --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \
    --transit-gateway-attachment-id tgw-attach-09b52ccdb5EXAMPLE

出力:

{
    "Propagation": {
        "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
        "ResourceId": "vpc-4d7de228",
        "ResourceType": "vpc",
        "TransitGatewayRouteTableId": "tgw-rtb-0a823edbdeEXAMPLE",
        "State": "disabled"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

次の例は、enable-vgw-route-propagation を使用する方法を説明しています。

AWS CLI

ルート伝達を有効にするには

この例では、指定された仮想プライベートゲートウェイが、指定されたルートテーブルに静的ルートを伝播できるようにします。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 enable-vgw-route-propagation --route-table-id rtb-22574640 --gateway-id vgw-9a4cacf3

  • API 詳細については、「 コマンドリファレンスEnableVgwRoutePropagation」の「」を参照してください。 AWS CLI

次のコード例は、enable-volume-io を使用する方法を示しています。

AWS CLI

ボリュームの I/O を有効にするには

この例では、ボリューム で I/O を有効にしますvol-1234567890abcdef0。

コマンド:

aws ec2 enable-volume-io --volume-id vol-1234567890abcdef0

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスEnableVolumeIo」の「」を参照してください。 AWS CLI

次の例は、enable-vpc-classic-link-dns-support を使用する方法を説明しています。

AWS CLI

のサポートを有効にする ClassicLink DNSには VPC

この例では、 のサポートを有効にします ClassicLink DNSvpc-88888888。

コマンド:

aws ec2 enable-vpc-classic-link-dns-support --vpc-id vpc-88888888

出力:

{
  "Return": true
}

次のコード例は、enable-vpc-classic-link を使用する方法を示しています。

AWS CLI

VPCの を有効にするには ClassicLink

この例では、 で vpc-8888888 を有効にします ClassicLink。

コマンド:

aws ec2 enable-vpc-classic-link --vpc-id vpc-88888888

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスEnableVpcClassicLink」の「」を参照してください。 AWS CLI

次の例は、export-client-vpn-client-certificate-revocation-list を使用する方法を説明しています。

AWS CLI

クライアント証明書失効リストをエクスポートするには

次のexport-client-vpn-client-certificate-revocation-list例では、指定されたクライアントVPNエンドポイントのクライアント証明書失効リストをエクスポートします。この例では、読みやすくするために出力がテキスト形式で返されます。

aws ec2 export-client-vpn-client-certificate-revocation-list \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --output text

出力:

-----BEGIN X509 CRL-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END X509 CRL-----
STATUS      pending

詳細については、「クライアント管理者ガイド」の「クライアント証明書失効リスト」を参照してください。 AWS VPN

次のコード例は、export-client-vpn-client-configuration を使用する方法を示しています。

AWS CLI

クライアント設定をエクスポートするには

次のexport-client-vpn-client-configuration例では、指定されたクライアントVPNエンドポイントのクライアント設定をエクスポートします。この例では、読みやすくするために出力がテキスト形式で返されます。

aws ec2 export-client-vpn-client-configuration \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --output text

出力:

client
dev tun
proto udp
remote cvpn-endpoint-123456789123abcde.prod.clientvpn.ap-south-1.amazonaws.com 443
remote-random-hostname
resolv-retry infinite
nobind
persist-key
persist-tun
remote-cert-tls server
cipher AES-256-GCM
verb 3
<ca>
-----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----
</ca>
reneg-sec 0

詳細については、「 クライアント管理者ガイド」の「クライアントVPNエンドポイント」を参照してください。 AWS VPN

次のコード例は、export-image を使用する方法を示しています。

AWS CLI

から VM をエクスポートするには AMI

次のexport-image例では、指定された を指定された形式でAMI指定されたバケットにエクスポートします。

aws ec2 export-image \
    --image-id ami-1234567890abcdef0 \
    --disk-image-format VMDK \
    --s3-export-location S3Bucket=my-export-bucket,S3Prefix=exports/

出力:

{
    "DiskImageFormat": "vmdk",
    "ExportImageTaskId": "export-ami-1234567890abcdef0"
    "ImageId": "ami-1234567890abcdef0",
    "RoleName": "vmimport",
    "Progress": "0",
    "S3ExportLocation": {
        "S3Bucket": "my-export-bucket",
        "S3Prefix": "exports/"
    },
    "Status": "active",
    "StatusMessage": "validating"
}

  • API 詳細については、「 コマンドリファレンスExportImage」の「」を参照してください。 AWS CLI

次の例は、get-associated-ipv6-pool-cidrs を使用する方法を説明しています。

AWS CLI

IPv6 アドレスプールの関連付けを取得するには

次のget-associated-ipv6-pool-cidrs例では、指定されたIPv6アドレスプールの関連付けを取得します。

aws ec2 get-associated-ipv6-pool-cidrs \
    --pool-id ipv6pool-ec2-012345abc12345abc

出力:

{
    "Ipv6CidrAssociations": [
        {
            "Ipv6Cidr": "2001:db8:1234:1a00::/56",
            "AssociatedResource": "vpc-111111222222333ab"
        }
    ]
}

次の例は、get-aws-network-performance-data を使用する方法を説明しています。

AWS CLI

ネットワークパフォーマンスデータを取得するには

次のget-aws-network-performance-data例では、指定された期間内の指定されたリージョン間のネットワークパフォーマンスに関するデータを取得します。

aws ec2 get-aws-network-performance-data \
    --start-time 2022-10-26T12:00:00.000Z \
    --end-time 2022-10-26T12:30:00.000Z \
    --data-queries Id=my-query,Source=us-east-1,Destination=eu-west-1,Metric=aggregate-latency,Statistic=p50,Period=five-minutes

出力:

{
    "DataResponses": [
        {
            "Id": "my-query",
            "Source": "us-east-1",
            "Destination": "eu-west-1",
            "Metric": "aggregate-latency",
            "Statistic": "p50",
            "Period": "five-minutes",
            "MetricPoints": [
                {
                    "StartDate": "2022-10-26T12:00:00+00:00",
                    "EndDate": "2022-10-26T12:05:00+00:00",
                    "Value": 62.44349,
                    "Status": "OK"
                },
                {
                    "StartDate": "2022-10-26T12:05:00+00:00",
                    "EndDate": "2022-10-26T12:10:00+00:00",
                    "Value": 62.483498,
                    "Status": "OK"
                },
                {
                    "StartDate": "2022-10-26T12:10:00+00:00",
                    "EndDate": "2022-10-26T12:15:00+00:00",
                    "Value": 62.51248,
                    "Status": "OK"
                },
                {
                    "StartDate": "2022-10-26T12:15:00+00:00",
                    "EndDate": "2022-10-26T12:20:00+00:00",
                    "Value": 62.635475,
                    "Status": "OK"
                },
                {
                    "StartDate": "2022-10-26T12:20:00+00:00",
                    "EndDate": "2022-10-26T12:25:00+00:00",
                    "Value": 62.733974,
                    "Status": "OK"
                },
                {
                    "StartDate": "2022-10-26T12:25:00+00:00",
                    "EndDate": "2022-10-26T12:30:00+00:00",
                    "Value": 62.773975,
                    "Status": "OK"
                },
                {
                    "StartDate": "2022-10-26T12:30:00+00:00",
                    "EndDate": "2022-10-26T12:35:00+00:00",
                    "Value": 62.75349,
                    "Status": "OK"
                }
            ]
        }
    ]
}

詳細については、「インフラストラクチャパフォーマンスユーザーガイド」の「ネットワークパフォーマンスのモニタリング」を参照してください。

  • API 詳細については、「 コマンドリファレンスGetAwsNetworkPerformanceData」の「」を参照してください。 AWS CLI

次のコード例は、get-capacity-reservation-usage を使用する方法を示しています。

AWS CLI

AWS アカウント間でキャパシティ予約の使用状況を表示するには

次のget-capacity-reservation-usage例では、指定されたキャパシティ予約の使用情報を表示します。

aws ec2 get-capacity-reservation-usage \
    --capacity-reservation-id cr-1234abcd56EXAMPLE

出力:

{
    "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
    "InstanceUsages": [
        {
            "UsedInstanceCount": 1,
            "AccountId": "123456789012"
        }
    ],
    "AvailableInstanceCount": 4,
    "TotalInstanceCount": 5,
    "State": "active",
    "InstanceType": "t2.medium"
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「共有キャパシティーの予約使用状況の表示」を参照してください。

  • API 詳細については、「 コマンドリファレンスGetCapacityReservationUsage」の「」を参照してください。 AWS CLI

次のコード例は、get-coip-pool-usage を使用する方法を示しています。

AWS CLI

顧客所有の IP アドレスプールの使用状況を取得するには

次のget-coip-pool-usage例では、指定されたカスタマー所有 IP アドレスプールの使用状況の詳細を取得します。

aws ec2 get-coip-pool-usage \
    --pool-id ipv4pool-coip-123a45678bEXAMPLE

出力:

{
    "CoipPoolId": "ipv4pool-coip-123a45678bEXAMPLE",
    "CoipAddressUsages": [
        {
            "CoIp": "0.0.0.0"
        },
        {
            "AllocationId": "eipalloc-123ab45c6dEXAMPLE",
            "AwsAccountId": "123456789012",
            "CoIp": "0.0.0.0"
        },
        {
            "AllocationId": "eipalloc-123ab45c6dEXAMPLE",
            "AwsAccountId": "123456789111",
            "CoIp": "0.0.0.0"
        }
    ],
    "LocalGatewayRouteTableId": "lgw-rtb-059615ef7dEXAMPLE"
}

CoIP の詳細については、AWS Outposts ユーザーガイドの「カスタマー所有の IP アドレス」を参照してください 。

  • API 詳細については、「 コマンドリファレンスGetCoipPoolUsage」の「」を参照してください。 AWS CLI

次のコード例は、get-console-output を使用する方法を示しています。

AWS CLI

例 1: コンソール出力を取得するには

次のget-console-output例では、指定された Linux インスタンスのコンソール出力を取得します。

aws ec2 get-console-output \
    --instance-id i-1234567890abcdef0

出力:

{
    "InstanceId": "i-1234567890abcdef0",
    "Timestamp": "2013-07-25T21:23:53.000Z",
    "Output": "..."
}

詳細については、「Amazon ユーザーガイド」の「インスタンスコンソール出力」を参照してください。 EC2

例 2: 最新のコンソール出力を取得するには

次のget-console-output例では、指定された Linux インスタンスの最新のコンソール出力を取得します。

aws ec2 get-console-output \
    --instance-id i-1234567890abcdef0 \
    --latest \
    --output text

出力:

i-1234567890abcdef0 [    0.000000] Command line: root=LABEL=/ console=tty1 console=ttyS0 selinux=0 nvme_core.io_timeout=4294967295
[    0.000000] x86/fpu: Supporting XSAVE feature 0x001: 'x87 floating point registers'
[    0.000000] x86/fpu: Supporting XSAVE feature 0x002: 'SSE registers'
[    0.000000] x86/fpu: Supporting XSAVE feature 0x004: 'AVX registers'
...
Cloud-init v. 0.7.6 finished at Wed, 09 May 2018 19:01:13 +0000. Datasource DataSourceEc2.  Up 21.50 seconds
Amazon Linux AMI release 2018.03
Kernel 4.14.26-46.32.amzn1.x

詳細については、「Amazon ユーザーガイド」の「インスタンスコンソールの出力」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスGetConsoleOutput」の「」を参照してください。 AWS CLI

次のコード例は、get-console-screenshot を使用する方法を示しています。

AWS CLI

実行中のインスタンスのスクリーンショットを取得するには

次のget-console-screenshot例では、指定したインスタンスのスクリーンショットを .jpg 形式で取得します。スクリーンショットは Base64-encodedされた文字列として返されます。

aws ec2 get-console-screenshot \
    --instance-id i-1234567890abcdef0

出力:

{
    "ImageData": "997987/8kgj49ikjhewkwwe0008084EXAMPLE",
    "InstanceId": "i-1234567890abcdef0"
}

  • API 詳細については、「 コマンドリファレンスGetConsoleScreenshot」の「」を参照してください。 AWS CLI

次の例は、get-default-credit-specification を使用する方法を説明しています。

AWS CLI

デフォルトのクレジットオプションを記述するには

次のget-default-credit-specification例では、T2 インスタンスのデフォルトのクレジットオプションについて説明します。

aws ec2 get-default-credit-specification \
    --instance-family t2

出力:

{
    "InstanceFamilyCreditSpecification": {
        "InstanceFamily": "t2",
        "CpuCredits": "standard"
    }
}

次のコード例は、get-ebs-default-kms-key-id を使用する方法を示しています。

AWS CLI

EBS暗号化CMKのデフォルトを記述するには

次のget-ebs-default-kms-key-id例では、 AWS アカウントのEBS暗号化CMKのデフォルトについて説明します。

aws ec2 get-ebs-default-kms-key-id

出力には、 エイリアス CMKで AWS 管理される であるCMKEBS暗号化のデフォルトが表示されますalias/aws/ebs。

{
    "KmsKeyId": "alias/aws/ebs"
}

次の出力は、EBS暗号化CMKのカスタムを示しています。

{
    "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE"
}

  • API 詳細については、「 コマンドリファレンスGetEbsDefaultKmsKeyId」の「」を参照してください。 AWS CLI

次のコード例は、get-ebs-encryption-by-default を使用する方法を示しています。

AWS CLI

EBS暗号化がデフォルトで有効になっているかどうかを記述するには

次のget-ebs-encryption-by-default例は、現在のリージョンの AWS アカウントでEBS暗号化がデフォルトで有効になっているかどうかを示します。

aws ec2 get-ebs-encryption-by-default

次の出力は、EBS暗号化がデフォルトで無効になっていることを示しています。

{
    "EbsEncryptionByDefault": false
}

次の出力は、EBS暗号化がデフォルトで有効になっていることを示しています。

{
    "EbsEncryptionByDefault": true
}

  • API 詳細については、「 コマンドリファレンスGetEbsEncryptionByDefault」の「」を参照してください。 AWS CLI

次のコード例は、get-flow-logs-integration-template を使用する方法を示しています。

AWS CLI

VPCフローログと Amazon Athena の統合を自動化する CloudFormation テンプレートを作成するには

次のget-flow-logs-integration-template例では、VPCフローログと Amazon Athena の統合を自動化する CloudFormation テンプレートを作成します。

Linux ：

aws ec2 get-flow-logs-integration-template \
    --flow-log-id fl-1234567890abcdef0 \
    --config-delivery-s3-destination-arn arn:aws:s3:::DOC-EXAMPLE-BUCKET \
    --integrate-services AthenaIntegrations='[{IntegrationResultS3DestinationArn=arn:aws:s3:::DOC-EXAMPLE-BUCKET,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00},{IntegrationResultS3DestinationArn=arn:aws:s3:::DOC-EXAMPLE-BUCKET,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00}]'

Windows ：

aws ec2 get-flow-logs-integration-template ^
    --flow-log-id fl-1234567890abcdef0 ^
    --config-delivery-s3-destination-arn arn:aws:s3:::DOC-EXAMPLE-BUCKET ^
    --integrate-services AthenaIntegrations=[{IntegrationResultS3DestinationArn=arn:aws:s3:::DOC-EXAMPLE-BUCKET,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00},{IntegrationResultS3DestinationArn=arn:aws:s3:::DOC-EXAMPLE-BUCKET,PartitionLoadFrequency=none,PartitionStartDate=2021-07-21T00:40:00,PartitionEndDate=2021-07-21T00:42:00}]

出力:

{
    "Result": "https://DOC-EXAMPLE-BUCKET.s3.us-east-2.amazonaws.com/VPCFlowLogsIntegrationTemplate_fl-1234567890abcdef0_Wed%20Jul%2021%2000%3A57%3A56%20UTC%202021.yml"
}

CloudFormation テンプレートの使用の詳細については、「 ユーザーガイド」の AWS CloudFormation 「 テンプレートの使用AWS CloudFormation 」を参照してください。

Amazon Athena とフローログの使用については、「Amazon Amazon Virtual Private Cloudユーザーガイド」の「Amazon Athena を使用したフローログのクエリ」を参照してください。

次の例は、get-groups-for-capacity-reservation を使用する方法を説明しています。

AWS CLI

キャパシティーの予約 を使用してリソースグループを一覧表示するには

次のget-groups-for-capacity-reservation例では、指定されたキャパシティ予約が追加されたリソースグループを一覧表示します。

aws ec2 get-groups-for-capacity-reservation \
    --capacity-reservation-id cr-1234abcd56EXAMPLE

出力:

{
    "CapacityReservationsGroup": [
        {
            "GroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/my-resource-group",
            "OwnerId": "123456789012"
        }
    ]
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「キャパシティ予約の使用」を参照してください。

次のコード例は、get-host-reservation-purchase-preview を使用する方法を示しています。

AWS CLI

Dedicated Host 予約の購入プレビューを取得するには

この例では、アカウント内の指定された Dedicated Host の指定された Dedicated Host 予約のコストをプレビューします。

コマンド:

aws ec2 get-host-reservation-purchase-preview --offering-id hro-03f707bf363b6b324 --host-id-set h-013abcd2a00cbd123

出力:

{
  "TotalHourlyPrice": "1.499",
  "Purchase": [
      {
          "HourlyPrice": "1.499",
          "InstanceFamily": "m4",
          "PaymentOption": "NoUpfront",
          "HostIdSet": [
              "h-013abcd2a00cbd123"
          ],
          "UpfrontPrice": "0.000",
          "Duration": 31536000
      }
  ],
  "TotalUpfrontPrice": "0.000"
}

次のコード例は、get-image-block-public-access-state を使用する方法を示しています。

AWS CLI

指定されたリージョンの AMIsのブロックパブリックアクセス状態を取得するには

次のget-image-block-public-access-state例では、指定されたリージョンAMIsのアカウントレベルで のブロックパブリックアクセス状態を取得します。

aws ec2 get-image-block-public-access-state \
    --region us-east-1

出力:

{
    "ImageBlockPublicAccessState": "block-new-sharing"
}

詳細については、「Amazon ユーザーガイド」の「 へのパブリックアクセスのブロックAMIs」を参照してください。 EC2

次のコード例は、get-instance-types-from-instance-requirements を使用する方法を示しています。

AWS CLI

指定された属性に一致するインスタンスタイプをプレビューするには

次のget-instance-types-from-instance-requirements例では、まず --generate-cli-skeletonパラメータを使用して指定できるすべての属性のリストを生成し、そのリストを JSON ファイルに保存します。次に、 JSON ファイルを使用して、一致したインスタンスタイプをプレビューする属性をカスタマイズします。

可能なすべての属性を生成し、出力をJSONファイルに直接保存するには、次のコマンドを使用します。

aws ec2 get-instance-types-from-instance-requirements \
    --region us-east-1 \
    --generate-cli-skeleton input > attributes.json

出力:

{
    "DryRun": true,
    "ArchitectureTypes": [
        "x86_64_mac"
    ],
    "VirtualizationTypes": [
        "paravirtual"
    ],
    "InstanceRequirements": {
        "VCpuCount": {
            "Min": 0,
            "Max": 0
        },
        "MemoryMiB": {
            "Min": 0,
            "Max": 0
        },
        "CpuManufacturers": [
            "intel"
        ],
        "MemoryGiBPerVCpu": {
            "Min": 0.0,
            "Max": 0.0
        },
        "ExcludedInstanceTypes": [
            ""
        ],
        "InstanceGenerations": [
            "current"
        ],
        "SpotMaxPricePercentageOverLowestPrice": 0,
        "OnDemandMaxPricePercentageOverLowestPrice": 0,
        "BareMetal": "included",
        "BurstablePerformance": "excluded",
        "RequireHibernateSupport": true,
        "NetworkInterfaceCount": {
            "Min": 0,
            "Max": 0
        },
        "LocalStorage": "required",
        "LocalStorageTypes": [
            "hdd"
        ],
        "TotalLocalStorageGB": {
            "Min": 0.0,
            "Max": 0.0
        },
        "BaselineEbsBandwidthMbps": {
            "Min": 0,
            "Max": 0
        },
        "AcceleratorTypes": [
            "inference"
        ],
        "AcceleratorCount": {
            "Min": 0,
            "Max": 0
        },
        "AcceleratorManufacturers": [
            "xilinx"
        ],
        "AcceleratorNames": [
            "t4"
        ],
        "AcceleratorTotalMemoryMiB": {
            "Min": 0,
            "Max": 0
        }
    },
    "MaxResults": 0,
    "NextToken": ""
}

JSON ファイルを設定します。ArchitectureTypes、VirtualizationTypes、VCpuCount、および MemoryMiB の値を指定する必要があります。他の属性は省略できます。省略すると、デフォルト値が使用されます。各属性とそのデフォルト値の説明については、 get-instance-types-from「-instance-requirements <https://docs.aws.amazon.com/cli/latest/reference/ec2/get-instance-types-from-instance-requirements.html>」を参照してください。

で指定された属性を持つインスタンスタイプをプレビューしますattributes.json。--cli-input-json パラメータを使用して、JSONファイルの名前とパスを指定します。次のリクエストでは、出力はテーブルとしてフォーマットされます。

aws ec2 get-instance-types-from-instance-requirements \
    --cli-input-json file://attributes.json \
    --output table

attributes.json ファイルの内容。

{

    "ArchitectureTypes": [
        "x86_64"
    ],
    "VirtualizationTypes": [
        "hvm"
    ],
    "InstanceRequirements": {
        "VCpuCount": {
            "Min": 4,
            "Max": 6
        },
        "MemoryMiB": {
            "Min": 2048
        },
        "InstanceGenerations": [
            "current"
        ]
    }
}

出力:

------------------------------------------
|GetInstanceTypesFromInstanceRequirements|
+----------------------------------------+
||             InstanceTypes            ||
|+--------------------------------------+|
||             InstanceType             ||
|+--------------------------------------+|
||  c4.xlarge                           ||
||  c5.xlarge                           ||
||  c5a.xlarge                          ||
||  c5ad.xlarge                         ||
||  c5d.xlarge                          ||
||  c5n.xlarge                          ||
||  d2.xlarge                           ||
...

属性ベースのインスタンスタイプの選択の詳細については、「Amazon ユーザーガイド」の「属性ベースのインスタンスタイプの選択の仕組み」を参照してください。 EC2

次のコード例は、get-instance-uefi-data を使用する方法を示しています。

AWS CLI

インスタンスからUEFIデータを取得するには

次のget-instance-uefi-data例では、インスタンスからUEFIデータを取得します。出力が空の場合、インスタンスにはUEFIデータは含まれません。

aws ec2 get-instance-uefi-data \
    --instance-id i-0123456789example

出力:

{
    "InstanceId": "i-0123456789example",
    "UefiData": "QU1aTlVFRkkf+uLXAAAAAHj5a7fZ9+3dBzxXb/.
    <snipped>
    AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD4L/J/AODshho="
}

詳細については、「Amazon ユーザーガイド」のUEFI「セキュアブート」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスGetInstanceUefiData」の「」を参照してください。 AWS CLI

次の例は、get-ipam-address-history を使用する方法を説明しています。

AWS CLI

の履歴を取得するには CIDR

次のget-ipam-address-history例では、 の履歴を取得しますCIDR。

(Linux):

aws ec2 get-ipam-address-history \
   --cidr 10.0.0.0/16 \
   --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \
   --start-time 2021-12-08T01:00:00.000Z \
   --end-time 2021-12-10T01:00:00.000Z

(Windows):

aws ec2 get-ipam-address-history ^
   --cidr 10.0.0.0/16 ^
   --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^
   --start-time 2021-12-08T01:00:00.000Z ^
   --end-time 2021-12-10T01:00:00.000Z

出力:

{
    "HistoryRecords": [
        {
            "ResourceOwnerId": "123456789012",
            "ResourceRegion": "us-west-1",
            "ResourceType": "vpc",
            "ResourceId": "vpc-06cbefa9ee907e1c0",
            "ResourceCidr": "10.0.0.0/16",
            "ResourceName": "Demo",
            "ResourceComplianceStatus": "unmanaged",
            "ResourceOverlapStatus": "overlapping",
            "VpcId": "vpc-06cbefa9ee907e1c0",
            "SampledStartTime": "2021-12-08T19:54:57.675000+00:00"
        },
        {
            "ResourceOwnerId": "123456789012",
            "ResourceRegion": "us-east-2",
            "ResourceType": "vpc",
            "ResourceId": "vpc-042702f474812c9ad",
            "ResourceCidr": "10.0.0.0/16",
            "ResourceName": "test",
            "ResourceComplianceStatus": "unmanaged",
            "ResourceOverlapStatus": "overlapping",
            "VpcId": "vpc-042702f474812c9ad",
            "SampledStartTime": "2021-12-08T19:54:59.019000+00:00"
        },
        {
            "ResourceOwnerId": "123456789012",
            "ResourceRegion": "us-east-2",
            "ResourceType": "vpc",
            "ResourceId": "vpc-042b8a44f64267d67",
            "ResourceCidr": "10.0.0.0/16",
            "ResourceName": "tester",
            "ResourceComplianceStatus": "unmanaged",
            "ResourceOverlapStatus": "overlapping",
            "VpcId": "vpc-042b8a44f64267d67",
            "SampledStartTime": "2021-12-08T19:54:59.019000+00:00"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「IP アドレスの履歴を表示する」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスGetIpamAddressHistory」の「」を参照してください。 AWS CLI

次のコード例は、get-ipam-discovered-accounts を使用する方法を示しています。

AWS CLI

によって検出されたアカウントを表示するには IPAM

このシナリオでは、 が検出するリソースを所有する AWS アカウントを表示したいIPAM委任管理者IPAMです。

--discovery-region は、モニタリング対象アカウントのステータスを表示するIPAM運用リージョンです。例えば、IPAM運用リージョンが 3 つある場合、このリクエストを 3 回実行して、それらの特定のリージョンのそれぞれの検出に固有のタイムスタンプを表示することができます。

次のget-ipam-discovered-accounts例では、 IPAMが検出するリソースを所有する AWS アカウントを一覧表示します。

aws ec2 get-ipam-discovered-accounts \
   --ipam-resource-discovery-id ipam-res-disco-0365d2977fc1672fe \
   --discovery-region us-east-1

出力:

{
    "IpamDiscoveredAccounts": [
        {
            "AccountId": "149977607591",
            "DiscoveryRegion": "us-east-1",
            "LastAttemptedDiscoveryTime": "2024-02-09T19:04:31.379000+00:00",
            "LastSuccessfulDiscoveryTime": "2024-02-09T19:04:31.379000+00:00"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「組織外のアカウントIPAMとの統合」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスGetIpamDiscoveredAccounts」の「」を参照してください。 AWS CLI

次のコード例は、get-ipam-discovered-public-addresses を使用する方法を示しています。

AWS CLI

検出されたパブリック IP アドレスを表示するには

この例では、委任された管理者であり、 IPAM によって検出されたリソースの IP アドレスを表示するとしますIPAM。リソース検出 ID は で取得できますdescribe-ipam-resource-discoveries。

次のget-ipam-discovered-public-addresses例は、リソース検出で検出されたパブリック IP アドレスを示しています。

aws ec2 get-ipam-discovered-public-addresses \
    --ipam-resource-discovery-id ipam-res-disco-0f4ef577a9f37a162 \
    --address-region us-east-1 \
    --region us-east-1

出力:

{
    "IpamDiscoveredPublicAddresses": [
        {
           "IpamResourceDiscoveryId": "ipam-res-disco-0f4ef577a9f37a162",
            "AddressRegion": "us-east-1",
            "Address": "54.208.155.7",
            "AddressOwnerId": "320805250157",
            "AssociationStatus": "associated",
            "AddressType": "ec2-public-ip",
            "VpcId": "vpc-073b294916198ce49",
            "SubnetId": "subnet-0b6c8a8839e9a4f15",
            "NetworkInterfaceId": "eni-081c446b5284a5e06",
            "NetworkInterfaceDescription": "",
            "InstanceId": "i-07459a6fca5b35823",
            "Tags": {},
            "NetworkBorderGroup": "us-east-1c",
            "SecurityGroups": [
                {
                    "GroupName": "launch-wizard-2",
                    "GroupId": "sg-0a489dd6a65c244ce"
                }
            ],
            "SampleTime": "2024-04-05T15:13:59.228000+00:00"
        },
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0f4ef577a9f37a162",
            "AddressRegion": "us-east-1",
            "Address": "44.201.251.218",
            "AddressOwnerId": "470889052923",
            "AssociationStatus": "associated",
            "AddressType": "ec2-public-ip",
            "VpcId": "vpc-6c31a611",
            "SubnetId": "subnet-062f47608b99834b1",
            "NetworkInterfaceId": "eni-024845359c2c3ae9b",
            "NetworkInterfaceDescription": "",
            "InstanceId": "i-04ef786d9c4e03f41",
            "Tags": {},
            "NetworkBorderGroup": "us-east-1a",
            "SecurityGroups": [
                {
                    "GroupName": "launch-wizard-32",
                    "GroupId": "sg-0ed1a426e96a68374"
                }
            ],
            "SampleTime": "2024-04-05T15:13:59.145000+00:00"
        }
}

詳細については、「Amazon ユーザーガイド」の「パブリック IP インサイトを表示する」を参照してください。 VPC IPAM

次のコード例は、get-ipam-discovered-resource-cidrs を使用する方法を示しています。

AWS CLI

によってCIDRs検出された IP アドレスを表示するには IPAM

この例では、 が検出するCIDRsリソースの IP アドレスに関連する詳細を表示したいIPAM委任管理者IPAMです。

このリクエストを完了するには：

選択したリソース検出は、 に関連付ける必要がありますIPAM。 --resource-regionは、リソースが作成された AWS リージョンです。

次のget-ipam-discovered-resource-cidrs例では、 IPAMが検出するリソースの IP アドレスを一覧表示します。

aws ec2 get-ipam-discovered-resource-cidrs \
   --ipam-resource-discovery-id ipam-res-disco-0365d2977fc1672fe \
   --resource-region us-east-1

出力:

{
    {
        "IpamDiscoveredResourceCidrs": [
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "ResourceRegion": "us-east-1",
            "ResourceId": "vpc-0c974c95ca7ceef4a",
            "ResourceOwnerId": "149977607591",
            "ResourceCidr": "172.31.0.0/16",
            "ResourceType": "vpc",
            "ResourceTags": [],
            "IpUsage": 0.375,
            "VpcId": "vpc-0c974c95ca7ceef4a",
            "SampleTime": "2024-02-09T19:15:16.529000+00:00"
        },
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "ResourceRegion": "us-east-1",
            "ResourceId": "subnet-07fe028119082a8c1",
            "ResourceOwnerId": "149977607591",
            "ResourceCidr": "172.31.0.0/20",
            "ResourceType": "subnet",
            "ResourceTags": [],
            "IpUsage": 0.0012,
            "VpcId": "vpc-0c974c95ca7ceef4a",
            "SampleTime": "2024-02-09T19:15:16.529000+00:00"
        },
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "ResourceRegion": "us-east-1",
            "ResourceId": "subnet-0a96893763984cc4e",
            "ResourceOwnerId": "149977607591",
            "ResourceCidr": "172.31.64.0/20",
            "ResourceType": "subnet",
            "ResourceTags": [],
            "IpUsage": 0.0012,
            "VpcId": "vpc-0c974c95ca7ceef4a",
            "SampleTime": "2024-02-09T19:15:16.529000+00:00"
        }
    }
}

詳細については、「Amazon ユーザーガイド」の「リソース別のCIDR使用状況のモニタリング」を参照してください。 VPC IPAM

次の例は、get-ipam-pool-allocations を使用する方法を説明しています。

AWS CLI

プールからCIDRs割り当てられた を取得するには IPAM

次のget-ipam-pool-allocations例では、IPAMプールからCIDRs割り当てられた を取得します。

(Linux):

aws ec2 get-ipam-pool-allocations \
    --ipam-pool-id ipam-pool-0533048da7d823723 \
    --filters Name=ipam-pool-allocation-id,Values=ipam-pool-alloc-0e6186d73999e47389266a5d6991e6220

(Windows):

aws ec2 get-ipam-pool-allocations ^
    --ipam-pool-id ipam-pool-0533048da7d823723 ^
    --filters Name=ipam-pool-allocation-id,Values=ipam-pool-alloc-0e6186d73999e47389266a5d6991e6220

出力:

{
    "IpamPoolAllocations": [
        {
            "Cidr": "10.0.0.0/16",
            "IpamPoolAllocationId": "ipam-pool-alloc-0e6186d73999e47389266a5d6991e6220",
            "ResourceType": "custom",
            "ResourceOwner": "123456789012"
        }
    ]
}

  • API 詳細については、「 コマンドリファレンスGetIpamPoolAllocations」の「」を参照してください。 AWS CLI

次の例は、get-ipam-pool-cidrs を使用する方法を説明しています。

AWS CLI

プールにCIDRsプロビジョニングされた を取得するには IPAM

次のget-ipam-pool-cidrs例では、 をIPAMプールにCIDRsプロビジョニングします。

(Linux):

aws ec2 get-ipam-pool-cidrs \
    --ipam-pool-id ipam-pool-0533048da7d823723 \
    --filters 'Name=cidr,Values=10.*'

(Windows):

aws ec2 get-ipam-pool-cidrs ^
    --ipam-pool-id ipam-pool-0533048da7d823723 ^
    --filters Name=cidr,Values=10.*

出力:

{
    "IpamPoolCidr": {
        "Cidr": "10.0.0.0/24",
        "State": "provisioned"
    }
}

  • API 詳細については、「 コマンドリファレンスGetIpamPoolCidrs」の「」を参照してください。 AWS CLI

次の例は、get-ipam-resource-cidrs を使用する方法を説明しています。

AWS CLI

リソースCIDRsに割り当てられた を取得するには

次のget-ipam-resource-cidrs例では、リソースCIDRsに割り当てられた を取得します。

(Linux):

aws ec2 get-ipam-resource-cidrs \
    --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \
    --filters Name=management-state,Values=unmanaged

(Windows):

aws ec2 get-ipam-resource-cidrs ^
    --ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^
    --filters Name=management-state,Values=unmanaged

出力:

{
    "IpamResourceCidrs": [
        {
            "IpamId": "ipam-08440e7a3acde3908",
            "IpamScopeId": "ipam-scope-02fc38cd4c48e7d38",
            "ResourceRegion": "us-east-2",
            "ResourceOwnerId": "123456789012",
            "ResourceId": "vpc-621b8709",
            "ResourceName": "Default AWS VPC",
            "ResourceCidr": "172.33.0.0/16",
            "ResourceType": "vpc",
            "ResourceTags": [
                {
                    "Key": "Environment",
                    "Value": "Test"
                },
                {
                    "Key": "Name",
                    "Value": "Default AWS VPC"
                }
            ],
            "IpUsage": 0.0039,
            "ComplianceStatus": "unmanaged",
            "ManagementState": "unmanaged",
            "OverlapStatus": "nonoverlapping",
            "VpcId": "vpc-621b8709"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「リソース別のCIDR使用状況のモニタリング」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスGetIpamResourceCidrs」の「」を参照してください。 AWS CLI

次の例は、get-launch-template-data を使用する方法を説明しています。

AWS CLI

起動テンプレートのインスタンスデータを取得するには

この例では、指定されたインスタンスに関するデータを取得し、 --queryオプションを使用して の内容を返しますLaunchTemplateData。出力をベースとして使用して、新しい起動テンプレートや起動テンプレートのバージョンを作成できます。

コマンド:

aws ec2 get-launch-template-data --instance-id i-0123d646e8048babc --query 'LaunchTemplateData'

出力:

{
      "Monitoring": {},
      "ImageId": "ami-8c1be5f6",
      "BlockDeviceMappings": [
          {
              "DeviceName": "/dev/xvda",
              "Ebs": {
                  "DeleteOnTermination": true
              }
          }
      ],
      "EbsOptimized": false,
      "Placement": {
          "Tenancy": "default",
          "GroupName": "",
          "AvailabilityZone": "us-east-1a"
      },
      "InstanceType": "t2.micro",
      "NetworkInterfaces": [
          {
              "Description": "",
              "NetworkInterfaceId": "eni-35306abc",
              "PrivateIpAddresses": [
                  {
                      "Primary": true,
                      "PrivateIpAddress": "10.0.0.72"
                  }
              ],
              "SubnetId": "subnet-7b16de0c",
              "Groups": [
                  "sg-7c227019"
              ],
              "Ipv6Addresses": [
                  {
                      "Ipv6Address": "2001:db8:1234:1a00::123"
                  }
              ],
              "PrivateIpAddress": "10.0.0.72"
          }
      ]
}

  • API 詳細については、「 コマンドリファレンスGetLaunchTemplateData」の「」を参照してください。 AWS CLI

次のコード例は、get-managed-prefix-list-associations を使用する方法を示しています。

AWS CLI

プレフィックスリストの関連付けを取得するには

次のget-managed-prefix-list-associations例では、指定されたプレフィックスリストに関連付けられているリソースを取得します。

aws ec2 get-managed-prefix-list-associations \
    --prefix-list-id pl-0123456abcabcabc1

出力:

{
    "PrefixListAssociations": [
        {
            "ResourceId": "sg-0abc123456abc12345",
            "ResourceOwner": "123456789012"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。 VPC

次のコード例は、get-managed-prefix-list-entries を使用する方法を示しています。

AWS CLI

プレフィックスリストのエントリを取得するには

以下は、指定されたプレフィックスリストのエントリget-managed-prefix-list-entriesを取得します。

aws ec2 get-managed-prefix-list-entries \
    --prefix-list-id pl-0123456abcabcabc1

出力:

{
    "Entries": [
        {
            "Cidr": "10.0.0.0/16",
            "Description": "vpc-a"
        },
        {
            "Cidr": "10.2.0.0/16",
            "Description": "vpc-b"
        }
    ]
}

詳細については、「Amazon ユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスGetManagedPrefixListEntries」の「」を参照してください。 AWS CLI

次の例は、get-network-insights-access-scope-analysis-findings を使用する方法を説明しています。

AWS CLI

Network Insights アクセススコープ分析の結果を取得するには

次のget-network-insights-access-scope-analysis-findings例では、 AWS アカウントで選択したスコープ分析結果を取得します。

aws ec2 get-network-insights-access-scope-analysis-findings \
    --region us-east-1 \
    --network-insights-access-scope-analysis-id nis \
    --nis-123456789111

出力:

{
    "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789222",
    "AnalysisFindings": [
        {
            "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789222",
            "NetworkInsightsAccessScopeId": "nis-123456789111",
            "FindingComponents": [
                {
                    "SequenceNumber": 1,
                    "Component": {
                        "Id": "eni-02e3d42d5cceca67d",
                        "Arn": "arn:aws:ec2:us-east-1:936459623503:network-interface/eni-02e3d32d9cceca17d"
                    },
                    "OutboundHeader": {
                        "DestinationAddresses": [
                            "0.0.0.0/5",
                            "11.0.0.0/8",
                            "12.0.0.0/6",
                            "128.0.0.0/3",
                            "16.0.0.0/4",
                            "160.0.0.0/5",
                            "168.0.0.0/6",
                            "172.0.0.0/12"
                            "8.0.0.0/7"
                        ],
                        "DestinationPortRanges": [
                            {
                                "From": 0,
                                "To": 65535
                            }
                        ],
                        "Protocol": "6",
                        "SourceAddresses": [
                            "10.0.2.253/32"
                        ],
                        "SourcePortRanges": [
                            {
                                "From": 0,
                                "To": 65535
                            }
                        ]
                    }, [etc]
                ]
            }
        }
    ]
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次のコード例は、get-network-insights-access-scope-content を使用する方法を示しています。

AWS CLI

Network Insights アクセススコープコンテンツを取得するには

次のget-network-insights-access-scope-content例では、 AWS アカウント内の選択したスコープ分析 ID のコンテンツを取得します。

aws ec2 get-network-insights-access-scope-content \
    --region us-east-1 \
    --network-insights-access-scope-id nis-123456789222

出力:

{
    "NetworkInsightsAccessScopeContent": {
        "NetworkInsightsAccessScopeId": "nis-123456789222",
        "MatchPaths": [
            {
                "Source": {
                    "ResourceStatement": {
                        "ResourceTypes": [
                            "AWS::EC2::NetworkInterface"
                        ]
                    }
                },
                "Destination": {
                    "ResourceStatement": {
                        "ResourceTypes": [
                            "AWS::EC2::InternetGateway"
                        ]
                    }
                }
            }
        ]
    }
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次の例は、get-password-data を使用する方法を説明しています。

AWS CLI

暗号化されたパスワードを取得するには

この例では、暗号化されたパスワードを取得します。

コマンド:

aws ec2 get-password-data --instance-id i-1234567890abcdef0

出力:

{
    "InstanceId": "i-1234567890abcdef0",
    "Timestamp": "2013-08-07T22:18:38.000Z",
    "PasswordData": "gSlJFq+VpcZXqy+iktxMF6NyxQ4qCrT4+gaOuNOenX1MmgXPTj7XEXAMPLE
UQ+YeFfb+L1U4C4AKv652Ux1iRB3CPTYP7WmU3TUnhsuBd+p6LVk7T2lKUml6OXbk6WPW1VYYm/TRPB1
e1DQ7PY4an/DgZT4mwcpRFigzhniQgDDeO1InvSDcwoUTwNs0Y1S8ouri2W4n5GNlriM3Q0AnNVelVz/
53TkDtxbNoU606M1gK9zUWSxqEgwvbV2j8c5rP0WCuaMWSFl4ziDu4bd7q+4RSyi8NUsVWnKZ4aEZffu
DPGzKrF5yLlf3etP2L4ZR6CvG7K1hx7VKOQVN32Dajw=="
}

復号されたパスワードを取得するには

この例では、復号されたパスワードを取得します。

コマンド:

aws ec2 get-password-data --instance-id  i-1234567890abcdef0 --priv-launch-key C:\Keys\MyKeyPair.pem

出力:

{
    "InstanceId": "i-1234567890abcdef0",
    "Timestamp": "2013-08-30T23:18:05.000Z",
    "PasswordData": "&ViJ652e*u"
}

  • API 詳細については、「 コマンドリファレンスGetPasswordData」の「」を参照してください。 AWS CLI

次の例は、get-reserved-instances-exchange-quote を使用する方法を説明しています。

AWS CLI

コンバーティブルリザーブドインスタンスの交換の見積りを取得するには

この例では、指定された コンバーティブルリザーブドインスタンス の交換情報を取得します。

コマンド:

aws ec2 get-reserved-instances-exchange-quote --reserved-instance-ids 7b8750c3-397e-4da4-bbcb-a45ebexample --target-configurations OfferingId=6fea5434-b379-434c-b07b-a7abexample

出力:

{
  "CurrencyCode": "USD",
  "ReservedInstanceValueSet": [
      {
          "ReservedInstanceId": "7b8750c3-397e-4da4-bbcb-a45ebexample",
          "ReservationValue": {
              "RemainingUpfrontValue": "0.000000",
              "HourlyPrice": "0.027800",
              "RemainingTotalValue": "730.556200"
          }
      }
  ],
  "PaymentDue": "424.983828",
  "TargetConfigurationValueSet": [
      {
          "TargetConfiguration": {
              "InstanceCount": 5,
              "OfferingId": "6fea5434-b379-434c-b07b-a7abexample"
          },
          "ReservationValue": {
              "RemainingUpfrontValue": "424.983828",
              "HourlyPrice": "0.016000",
              "RemainingTotalValue": "845.447828"
          }
      }
  ],
  "IsValidExchange": true,
  "OutputReservedInstancesWillExpireAt": "2020-10-01T13:03:39Z",
  "ReservedInstanceValueRollup": {
      "RemainingUpfrontValue": "0.000000",
      "HourlyPrice": "0.027800",
      "RemainingTotalValue": "730.556200"
  },
  "TargetConfigurationValueRollup": {
      "RemainingUpfrontValue": "424.983828",
      "HourlyPrice": "0.016000",
      "RemainingTotalValue": "845.447828"
  }
}

次の例は、get-security-groups-for-vpc を使用する方法を説明しています。

AWS CLI

指定した のネットワークインターフェイスに関連付けることができるセキュリティグループを表示するにはVPC。

次のget-security-groups-for-vpc例は、 のネットワークインターフェイスに関連付けることができるセキュリティグループを示していますVPC。

aws ec2 get-security-groups-for-vpc \
    --vpc-id vpc-6c31a611 \
    --region us-east-1

出力:

{
    "SecurityGroupForVpcs": [
        {
            "Description": "launch-wizard-36 created 2022-08-29T15:59:35.338Z",
            "GroupName": "launch-wizard-36",
            "OwnerId": "470889052923",
            "GroupId": "sg-007e0c3027ee885f5",
            "Tags": [],
            "PrimaryVpcId": "vpc-6c31a611"
        },
        {
            "Description": "launch-wizard-18 created 2024-01-19T20:22:27.527Z",
            "GroupName": "launch-wizard-18",
            "OwnerId": "470889052923",
            "GroupId": "sg-0147193bef51c9eef",
            "Tags": [],
            "PrimaryVpcId": "vpc-6c31a611"
        }
}

  • API 詳細については、「 コマンドリファレンスGetSecurityGroupsForVpc」の「」を参照してください。 AWS CLI

次のコード例は、get-serial-console-access-status を使用する方法を示しています。

AWS CLI

シリアルコンソールへのアカウントアクセスのステータスを表示するには

次のget-serial-console-access-status例では、アカウントでシリアルコンソールアクセスを有効にするかどうかを決定します。

aws ec2 get-serial-console-access-status

出力:

{
    "SerialConsoleAccessEnabled": true
}

詳細については、「Amazon ユーザーガイド」のEC2「シリアルコンソール」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスGetSerialConsoleAccessStatus」の「」を参照してください。 AWS CLI

次のコード例は、get-snapshot-block-public-access-state を使用する方法を示しています。

AWS CLI

スナップショットのブロックパブリックアクセスの現在の状態を取得するには

次のget-snapshot-block-public-access-state例では、スナップショットのブロックパブリックアクセスの現在の状態を取得します。

aws ec2 get-snapshot-block-public-access-state

出力:

{
    "State": "block-all-sharing"
}

詳細については、「Amazon EBSユーザーガイド」の「スナップショットのパブリックアクセスのブロック」を参照してください。

次のコード例は、get-spot-placement-scores を使用する方法を示しています。

AWS CLI

指定された要件のスポットプレイスメントスコアを計算するには

次のget-spot-placement-scores例では、まず パラメータを使用してスポットプレイスメントスコア設定に指定できるすべての--generate-cli-skeletonパラメータのリストを生成し、そのリストを JSON ファイルに保存します。次に、 JSON ファイルを使用して、スポットプレイスメントスコアの計算に使用する要件を設定します。

スポットプレイスメントスコア設定に指定できるすべてのパラメータを生成し、出力を JSON ファイルに直接保存します。

aws ec2 get-spot-placement-scores \
    --region us-east-1 \
    --generate-cli-skeleton input > attributes.json

出力:

{
    "InstanceTypes": [
        ""
    ],
    "TargetCapacity": 0,
    "TargetCapacityUnitType": "vcpu",
    "SingleAvailabilityZone": true,
    "RegionNames": [
        ""
    ],
    "InstanceRequirementsWithMetadata": {
        "ArchitectureTypes": [
            "x86_64_mac"
        ],
        "VirtualizationTypes": [
            "hvm"
        ],
        "InstanceRequirements": {
            "VCpuCount": {
                "Min": 0,
                "Max": 0
            },
            "MemoryMiB": {
                "Min": 0,
                "Max": 0
            },
            "CpuManufacturers": [
                "amd"
            ],
            "MemoryGiBPerVCpu": {
                "Min": 0.0,
                "Max": 0.0
            },
            "ExcludedInstanceTypes": [
                ""
            ],
            "InstanceGenerations": [
                "previous"
            ],
            "SpotMaxPricePercentageOverLowestPrice": 0,
            "OnDemandMaxPricePercentageOverLowestPrice": 0,
            "BareMetal": "excluded",
            "BurstablePerformance": "excluded",
            "RequireHibernateSupport": true,
            "NetworkInterfaceCount": {
                "Min": 0,
                "Max": 0
            },
            "LocalStorage": "included",
            "LocalStorageTypes": [
                "hdd"
            ],
            "TotalLocalStorageGB": {
                "Min": 0.0,
                "Max": 0.0
            },
            "BaselineEbsBandwidthMbps": {
                "Min": 0,
                "Max": 0
            },
            "AcceleratorTypes": [
                "fpga"
            ],
            "AcceleratorCount": {
                "Min": 0,
                "Max": 0
            },
            "AcceleratorManufacturers": [
                "amd"
            ],
            "AcceleratorNames": [
                "vu9p"
            ],
            "AcceleratorTotalMemoryMiB": {
                "Min": 0,
                "Max": 0
            }
        }
    },
    "DryRun": true,
    "MaxResults": 0,
    "NextToken": ""
}

JSON ファイルを設定します。TargetCapacity の値を指定する必要があります。各パラメータとそのデフォルト値の説明については、「スポットプレイスメントスコアの計算 (AWS CLI) <https://docs.aws.amazon.com//latest AWS EC2/UserGuide/spot-placement-score.html#calculate-sps-cli＞」を参照してください。

で指定された要件のスポットプレイスメントスコアを計算しますattributes.json。--cli-input-json パラメータを使用して、JSONファイルの名前とパスを指定します。

aws ec2 get-spot-placement-scores \
    --region us-east-1 \
    --cli-input-json file://attributes.json

SingleAvailabilityZone が に設定されている場合false、または省略された場合に出力されます (省略した場合、デフォルトで になりますfalse）。リージョンのスコア付きリストが返されます。

"Recommendation": [
    {
        "Region": "us-east-1",
        "Score": 7
    },
    {
        "Region": "us-west-1",
        "Score": 5
    },
   ...

が に設定されている場合SingleAvailabilityZoneは出力しますtrue。 SingleAvailability ゾーンのスコア付きリストが返されます。

"Recommendation": [
    {
        "Region": "us-east-1",
        "AvailabilityZoneId": "use1-az1"
        "Score": 8
    },
    {
        "Region": "us-east-1",
        "AvailabilityZoneId": "usw2-az3"
        "Score": 6
    },
   ...

スポットプレイスメントスコアの計算、および設定例の詳細については、「Amazon ユーザーガイド」の「スポットプレイスメントスコアの計算」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスGetSpotPlacementScores」の「」を参照してください。 AWS CLI

次の例は、get-subnet-cidr-reservations を使用する方法を説明しています。

AWS CLI

サブネットCIDR予約に関する情報を取得するには

次のget-subnet-cidr-reservations例では、指定されたサブネットCIDR予約に関する情報を表示します。

aws ec2 get-subnet-cidr-reservations \
    --subnet-id subnet-03c51e2e6cEXAMPLE

出力:

{
    "SubnetIpv4CidrReservations": [
        {
            "SubnetCidrReservationId": "scr-044f977c4eEXAMPLE",
            "SubnetId": "subnet-03c51e2e6cEXAMPLE",
            "Cidr": "10.1.0.16/28",
            "ReservationType": "prefix",
            "OwnerId": "123456789012"
        }
    ],
    "SubnetIpv6CidrReservations": []
}

詳細については、「Amazon ユーザーガイド」の「サブネットCIDR予約」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスGetSubnetCidrReservations」の「」を参照してください。 AWS CLI

次の例は、get-transit-gateway-attachment-propagations を使用する方法を説明しています。

AWS CLI

指定されたリソースアタッチメントがルートを伝達するルートテーブルを一覧表示するには

次のget-transit-gateway-attachment-propagations例では、指定されたリソースアタッチメントがルートを伝播するルートテーブルを一覧表示します。

aws ec2 get-transit-gateway-attachment-propagations \
    --transit-gateway-attachment-id tgw-attach-09fbd47ddfEXAMPLE

出力:

{
    "TransitGatewayAttachmentPropagations": [
        {
            "TransitGatewayRouteTableId": "tgw-rtb-0882c61b97EXAMPLE",
            "State": "enabled"
        }
    ]
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

次の例は、get-transit-gateway-multicast-domain-associations を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイマルチキャストドメインの関連付けに関する情報を表示するには

次のget-transit-gateway-multicast-domain-associations例では、指定されたマルチキャストドメインの関連付けを返します。

aws ec2 get-transit-gateway-multicast-domain-associations \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef7EXAMPLE

出力:

{
    "MulticastDomainAssociations": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-028c1dd0f8EXAMPLE",
            "ResourceId": "vpc-01128d2c24EXAMPLE",
            "ResourceType": "vpc",
            "Subnet": {
                "SubnetId": "subnet-000de86e3bEXAMPLE",
                "State": "associated"
            }
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE",
            "ResourceId": "vpc-7EXAMPLE",
            "ResourceType": "vpc",
            "Subnet": {
                "SubnetId": "subnet-4EXAMPLE",
                "State": "associated"
            }
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE",
            "ResourceId": "vpc-7EXAMPLE",
            "ResourceType": "vpc",
            "Subnet": {
                "SubnetId": "subnet-5EXAMPLE",
                "State": "associated"
            }
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE",
            "ResourceId": "vpc-7EXAMPLE",
            "ResourceType": "vpc",
            "Subnet": {
                "SubnetId": "subnet-aEXAMPLE",
                "State": "associated"
            }
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-070e571cd1EXAMPLE",
            "ResourceId": "vpc-7EXAMPLE",
            "ResourceType": "vpc",
            "Subnet": {
                "SubnetId": "subnet-fEXAMPLE",
                "State": "associated"
            }
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストドメインの管理」を参照してください。

次の例は、get-transit-gateway-prefix-list-references を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイルートテーブルでプレフィックスリスト参照を取得するには

次のget-transit-gateway-prefix-list-references例では、指定された Transit Gateway ルートテーブルのプレフィックスリスト参照を取得し、特定のプレフィックスリストの ID でフィルタリングします。

aws ec2 get-transit-gateway-prefix-list-references \
    --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \
    --filters Name=prefix-list-id,Values=pl-11111122222222333

出力:

{
    "TransitGatewayPrefixListReferences": [
        {
            "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123",
            "PrefixListId": "pl-11111122222222333",
            "PrefixListOwnerId": "123456789012",
            "State": "available",
            "Blackhole": false,
            "TransitGatewayAttachment": {
                "TransitGatewayAttachmentId": "tgw-attach-aabbccddaabbccaab",
                "ResourceType": "vpc",
                "ResourceId": "vpc-112233445566aabbc"
            }
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「プレフィックスリストリファレンス」を参照してください。

次の例は、get-transit-gateway-route-table-associations を使用する方法を説明しています。

AWS CLI

指定された Transit Gateway ルートテーブルの関連付けに関する情報を取得するには

次のget-transit-gateway-route-table-associations例では、指定された Transit Gateway ルートテーブルの関連付けに関する情報を表示します。

aws ec2 get-transit-gateway-route-table-associations \
    --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE

出力:

{
    "Associations": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
            "ResourceId": "vpc-4d7de228",
            "ResourceType": "vpc",
            "State": "associating"
        }
    ]
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

次のコード例は、get-transit-gateway-route-table-propagations を使用する方法を示しています。

AWS CLI

指定された Transit Gateway ルートテーブルのルートテーブル伝達に関する情報を表示するには

次のget-transit-gateway-route-table-propagations例では、指定されたルートテーブルのルートテーブル伝達を返します。

aws ec2 get-transit-gateway-route-table-propagations \
    --transit-gateway-route-table-id tgw-rtb-002573ed1eEXAMPLE

出力:

{
    "TransitGatewayRouteTablePropagations": [
        {
            "TransitGatewayAttachmentId": "tgw-attach-01f8100bc7EXAMPLE",
            "ResourceId": "vpc-3EXAMPLE",
            "ResourceType": "vpc",
            "State": "enabled"
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-08e0bc912cEXAMPLE",
            "ResourceId": "11460968-4ac1-4fd3-bdb2-00599EXAMPLE",
            "ResourceType": "direct-connect-gateway",
            "State": "enabled"
        },
        {
            "TransitGatewayAttachmentId": "tgw-attach-0a89069f57EXAMPLE",
            "ResourceId": "8384da05-13ce-4a91-aada-5a1baEXAMPLE",
            "ResourceType": "direct-connect-gateway",
            "State": "enabled"
        }
    ]
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

次のコード例は、get-verified-access-endpoint-policy を使用する方法を示しています。

AWS CLI

エンドポイントの Verified Access ポリシーを取得するには

次のget-verified-access-endpoint-policy例では、指定されたエンドポイントの Verified Access ポリシーを取得します。

aws ec2 get-verified-access-endpoint-policy \
    --verified-access-endpoint-id vae-066fac616d4d546f2

出力:

{
    "PolicyEnabled": true,
    "PolicyDocument": "permit(principal,action,resource)\nwhen {\n    context.identity.groups.contains(\"finance\") &&\n    context.identity.email_verified == true\n};"
}

詳細については、「 Verified Access ユーザーガイド」の「Verified Access ポリシー」を参照してください。 AWS

次の例は、get-verified-access-group-policy を使用する方法を説明しています。

AWS CLI

グループの Verified Access ポリシーを取得するには

次のget-verified-access-group-policy例では、指定されたグループの Verified Access ポリシーを取得します。

aws ec2 get-verified-access-group-policy \
    --verified-access-group-id vagr-0dbe967baf14b7235

出力:

{
    "PolicyEnabled": true,
    "PolicyDocument": "permit(principal,action,resource)\nwhen {\n    context.identity.groups.contains(\"finance\") &&\n    context.identity.email_verified == true\n};"
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access グループ」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスGetVerifiedAccessGroupPolicy」の「」を参照してください。 AWS CLI

次の例は、get-vpn-connection-device-sample-configuration を使用する方法を説明しています。

AWS CLI

サンプル設定ファイルをダウンロードするには

次のget-vpn-connection-device-sample-configuration例では、指定されたサンプル設定ファイルをダウンロードします。サンプル設定ファイルを使用してゲートウェイデバイスを一覧表示するには、 get-vpn-connection-device-types コマンドを呼び出します。

aws ec2 get-vpn-connection-device-sample-configuration \
    --vpn-connection-id vpn-123456789abc01234 \
    --vpn-connection-device-type-id 5fb390ba

出力:

{
    "VpnConnectionDeviceSampleConfiguration": "contents-of-the-sample-configuration-file"
}

詳細については、 Site-to-Site ユーザーガイドの「設定ファイルのダウンロード」を参照してください。 AWS VPN

次の例は、get-vpn-connection-device-types を使用する方法を説明しています。

AWS CLI

サンプル設定ファイルを使用してゲートウェイデバイスを一覧表示するには

次のget-vpn-connection-device-types例では、サンプル設定ファイルがある Palo Alto Networks のゲートウェイデバイスを一覧表示します。

aws ec2 get-vpn-connection-device-types \
    --query "VpnConnectionDeviceTypes[?Vendor==`Palo Alto Networks`]"

出力:

[
    {
        "VpnConnectionDeviceTypeId": "754a6372",
        "Vendor": "Palo Alto Networks",
        "Platform": "PA Series",
        "Software": "PANOS 4.1.2+"
    },
    {
        "VpnConnectionDeviceTypeId": "9612cbed",
        "Vendor": "Palo Alto Networks",
        "Platform": "PA Series",
        "Software": "PANOS 4.1.2+ (GUI)"
    },
    {
        "VpnConnectionDeviceTypeId": "5fb390ba",
        "Vendor": "Palo Alto Networks",
        "Platform": "PA Series",
        "Software": "PANOS 7.0+"
    }
]

詳細については、「 Site-to-Site ユーザーガイド」の「設定ファイルのダウンロード」を参照してください。 AWS VPN

  • API 詳細については、「 コマンドリファレンスGetVpnConnectionDeviceTypes」の「」を参照してください。 AWS CLI

次のコード例は、import-client-vpn-client-certificate-revocation-list を使用する方法を示しています。

AWS CLI

クライアント証明書失効リストをインポートするには

次のimport-client-vpn-client-certificate-revocation-list例では、ローカルコンピュータ上の ファイルの場所を指定して、クライアント証明書失効リストをクライアントVPNエンドポイントにインポートします。

aws ec2 import-client-vpn-client-certificate-revocation-list \
    --certificate-revocation-list file:///path/to/crl.pem \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde

出力:

{
    "Return": true
}

詳細については、「クライアント管理者ガイド」の「クライアント証明書失効リスト」を参照してください。 AWS VPN

次の例は、import-image を使用する方法を説明しています。

AWS CLI

VM イメージファイルを としてインポートするには AMI

次のimport-image例では、指定された をインポートしますOVA。

aws ec2 import-image \
  --disk-containers Format=ova,UserBucket="{S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.ova}"

出力:

{
    "ImportTaskId": "import-ami-1234567890abcdef0",
    "Progress": "2",
    "SnapshotDetails": [
        {
            "DiskImageSize": 0.0,
            "Format": "ova",
            "UserBucket": {
                "S3Bucket": "my-import-bucket",
                "S3Key": "vms/my-server-vm.ova"
            }
        }
    ],
    "Status": "active",
    "StatusMessage": "pending"
}

  • API 詳細については、「 コマンドリファレンスImportImage」の「」を参照してください。 AWS CLI

次のコード例は、import-key-pair を使用する方法を示しています。

AWS CLI

パブリックキーをインポートするには

まず、選択したツールでキーペアを生成します。例えば、次の ssh-keygen コマンドを使用します。

コマンド:

ssh-keygen -t rsa -C "my-key" -f ~/.ssh/my-key

出力:

Generating public/private rsa key pair.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/ec2-user/.ssh/my-key.
Your public key has been saved in /home/ec2-user/.ssh/my-key.pub.
...

このコマンド例では、指定されたパブリックキーをインポートします。

コマンド:

aws ec2 import-key-pair --key-name "my-key" --public-key-material fileb://~/.ssh/my-key.pub

出力:

{
  "KeyName": "my-key",
  "KeyFingerprint": "1f:51:ae:28:bf:89:e9:d8:1f:25:5d:37:2d:7d:b8:ca"
}

  • API 詳細については、「 コマンドリファレンスImportKeyPair」の「」を参照してください。 AWS CLI

次のコード例は、import-snapshot を使用する方法を示しています。

AWS CLI

スナップショットをインポートするには

次のimport-snapshot例では、指定されたディスクをスナップショットとしてインポートします。

aws ec2 import-snapshot \
    --description "My server VMDK" \
    --disk-container Format=VMDK,UserBucket={S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.vmdk}

出力:

{
    "Description": "My server VMDK",
    "ImportTaskId": "import-snap-1234567890abcdef0",
    "SnapshotTaskDetail": {
        "Description": "My server VMDK",
        "DiskImageSize": "0.0",
        "Format": "VMDK",
        "Progress": "3",
        "Status": "active",
        "StatusMessage": "pending"
        "UserBucket": {
            "S3Bucket": "my-import-bucket",
            "S3Key": "vms/my-server-vm.vmdk"
        }
    }
}

  • API 詳細については、「 コマンドリファレンスImportSnapshot」の「」を参照してください。 AWS CLI

次の例は、list-images-in-recycle-bin を使用する方法を説明しています。

AWS CLI

ごみ箱内のイメージを一覧表示するには

次のlist-images-in-recycle-bin例では、ごみ箱に現在保持されているすべてのイメージを一覧表示します。

aws ec2 list-images-in-recycle-bin

出力:

{
    "Images": [
        {
            "RecycleBinEnterTime": "2022-03-14T15:35:08.000Z",
            "Description": "Monthly AMI One",
            "RecycleBinExitTime": "2022-03-15T15:35:08.000Z",
            "Name": "AMI_01",
            "ImageId": "ami-0111222333444abcd"
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「ごみ箱AMIsからの復旧」を参照してください。

  • API 詳細については、「 コマンドリファレンスListImagesInRecycleBin」の「」を参照してください。 AWS CLI

次の例は、list-snapshots-in-recycle-bin を使用する方法を説明しています。

AWS CLI

ごみ箱にスナップショットを表示するには

次のlist-snapshots-in-recycle-bin例では、スナップショット ID、スナップショットの説明、スナップショットが作成されたボリュームの ID、スナップショットが削除されてごみ箱に入った日時、保持期間が終了する日時など、ごみ箱内のスナップショットに関する情報を示します。

aws ec2 list-snapshots-in-recycle-bin \
    --snapshot-id snap-01234567890abcdef

出力:

{
    "SnapshotRecycleBinInfo": [
        {
            "Description": "Monthly data backup snapshot",
            "RecycleBinEnterTime": "2022-12-01T13:00:00.000Z",
            "RecycleBinExitTime": "2022-12-15T13:00:00.000Z",
            "VolumeId": "vol-abcdef09876543210",
            "SnapshotId": "snap-01234567890abcdef"
        }
    ]
}

Amazon のごみ箱の詳細についてはEBS、「Amazon EC2ユーザーガイド」の「ごみ箱からスナップショットを復元する」を参照してください。

  • API 詳細については、「 コマンドリファレンスListSnapshotsInRecycleBin」の「」を参照してください。 AWS CLI

次の例は、lock-snapshot を使用する方法を説明しています。

AWS CLI

例 1: ガバナンスモードでスナップショットをロックするには

次のlock-snapshot例では、指定されたスナップショットをガバナンスモードでロックします。

aws ec2 lock-snapshot \
    --snapshot-id snap-0b5e733b4a8df6e0d \
    --lock-mode governance \
    --lock-duration 365

出力:

{
    "SnapshotId": "snap-0b5e733b4a8df6e0d",
    "LockState": "governance",
    "LockDuration": 365,
    "LockCreatedOn": "2024-05-05T00:56:06.208000+00:00",
    "LockExpiresOn": "2025-05-05T00:56:06.208000+00:00",
    "LockDurationStartTime": "2024-05-05T00:56:06.208000+00:00"
}

詳細については、「Amazon ユーザーガイド」の「スナップショットロック」を参照してください。 EBS

例 2: コンプライアンスモードでスナップショットをロックするには

次のlock-snapshot例では、指定されたスナップショットをコンプライアンスモードでロックします。

aws ec2 lock-snapshot \
    --snapshot-id snap-0163a8524c5b9901f \
    --lock-mode compliance \
    --cool-off-period 24 \
    --lock-duration 365

出力:

{
    "SnapshotId": "snap-0b5e733b4a8df6e0d",
    "LockState": "compliance-cooloff",
    "LockDuration": 365,
    "CoolOffPeriod": 24,
    "CoolOffPeriodExpiresOn": "2024-05-06T01:02:20.527000+00:00",
    "LockCreatedOn": "2024-05-05T01:02:20.527000+00:00",
    "LockExpiresOn": "2025-05-05T01:02:20.527000+00:00",
    "LockDurationStartTime": "2024-05-05T01:02:20.527000+00:00"
}

詳細については、「Amazon ユーザーガイド」の「スナップショットロック」を参照してください。 EBS

  • API 詳細については、「 コマンドリファレンスLockSnapshot」の「」を参照してください。 AWS CLI

次の例は、modify-address-attribute を使用する方法を説明しています。

AWS CLI

Elastic IP アドレスに関連付けられたドメイン名属性を変更するには

次のmodify-address-attribute例では、Elastic IP アドレスのドメイン名属性を変更します。

Linux ：

aws ec2 modify-address-attribute \
    --allocation-id eipalloc-abcdef01234567890 \
    --domain-name example.com

Windows ：

aws ec2 modify-address-attribute ^
    --allocation-id eipalloc-abcdef01234567890 ^
    --domain-name example.com

出力:

{
    "Addresses": [
        {
            "PublicIp": "192.0.2.0",
            "AllocationId": "eipalloc-abcdef01234567890",
            "PtrRecord": "example.net."
            "PtrRecordUpdate": {
                "Value": "example.com.",
                "Status": "PENDING"
        }
    ]
}

保留中の変更をモニタリングし、Elastic IP アドレスの変更属性を表示するには、 コマンドリファレンスのdescribe-addresses-attribute「」を参照してください。 AWS CLI

  • API 詳細については、「 コマンドリファレンスModifyAddressAttribute」の「」を参照してください。 AWS CLI

次のコード例は、modify-availability-zone-group を使用する方法を示しています。

AWS CLI

ゾーングループを有効にするには

次のmodify-availability-zone-group例では、指定されたゾーングループを有効にします。

aws ec2 modify-availability-zone-group \
    --group-name us-west-2-lax-1 \
    --opt-in-status opted-in

出力:

{
    "Return": true
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「リージョンとゾーン」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyAvailabilityZoneGroup」の「」を参照してください。 AWS CLI

次のコード例は、modify-capacity-reservation-fleet を使用する方法を示しています。

AWS CLI

例 1: キャパシティー予約フリートの合計ターゲット容量を変更するには

次のmodify-capacity-reservation-fleet例では、指定されたキャパシティー予約フリートの合計ターゲット容量を変更します。キャパシティー予約フリートの総ターゲット容量を変更すると、フリートは、新しい総ターゲット容量を満たすように、自動的に新しいキャパシティー予約を作成したり、フリート内の既存のキャパシティー予約を変更またはキャンセルしたりします。フリートのステータスが modifying の間は、他の変更を試みることはできません。

aws ec2 modify-capacity-reservation-fleet \
    --capacity-reservation-fleet-id crf-01234567890abcedf \
    --total-target-capacity 160

出力:

{
    "Return": true
}

例 2: キャパシティー予約フリートの終了日を変更するには

次のmodify-capacity-reservation-fleet例では、指定されたキャパシティー予約フリートの終了日を変更します。フリートの終了日を変更すると、個々のキャパシティー予約の終了日もそれに応じて更新されます。フリートのステータスが modifying の間は、他の変更を試みることはできません。

aws ec2 modify-capacity-reservation-fleet \
    --capacity-reservation-fleet-id crf-01234567890abcedf \
    --end-date 2022-07-04T23:59:59.000Z

出力:

{
    "Return": true
}

キャパシティー予約フリートの詳細については、Amazon EC2ユーザーガイドの「キャパシティー予約フリート」を参照してください。

次の例は、modify-capacity-reservation を使用する方法を説明しています。

AWS CLI

例 1: 既存のキャパシティ予約で予約されているインスタンスの数を変更するには

次のmodify-capacity-reservation例では、キャパシティ予約がキャパシティを予約するインスタンスの数を変更します。

aws ec2 modify-capacity-reservation \
    --capacity-reservation-id cr-1234abcd56EXAMPLE \
    --instance-count 5

出力:

{
    "Return": true
}

例 2: 既存のキャパシティ予約の終了日時を変更するには

次のmodify-capacity-reservation例では、既存のキャパシティ予約を指定された日時で終了するように変更します。

aws ec2 modify-capacity-reservation \
    --capacity-reservation-id cr-1234abcd56EXAMPLE \
    --end-date-type limited \
    --end-date 2019-08-31T23:59:59Z

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「キャパシティ予約の変更」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyCapacityReservation」の「」を参照してください。 AWS CLI

次の例は、modify-client-vpn-endpoint を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントを変更するには

次のmodify-client-vpn-endpoint例では、指定されたクライアントVPNエンドポイントのクライアント接続ログ記録を有効にします。

aws ec2 modify-client-vpn-endpoint \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --connection-log-options Enabled=true,CloudwatchLogGroup=ClientVPNLogs

出力:

{
    "Return": true
}

詳細については、クライアントAWS VPN管理者ガイドの「クライアントVPNエンドポイント」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyClientVpnEndpoint」の「」を参照してください。 AWS CLI

次のコード例は、modify-default-credit-specification を使用する方法を示しています。

AWS CLI

デフォルトのクレジットオプションを変更するには

次のmodify-default-credit-specification例では、T2 インスタンスのデフォルトのクレジットオプションを変更します。

aws ec2 modify-default-credit-specification \
    --instance-family t2 \
    --cpu-credits unlimited

出力:

{
    "InstanceFamilyCreditSpecification": {
        "InstanceFamily": "t2",
        "CpuCredits": "unlimited"
    }
}

次のコード例は、modify-ebs-default-kms-key-id を使用する方法を示しています。

AWS CLI

EBS暗号化CMKのデフォルトを設定するには

次のmodify-ebs-default-kms-key-id例では、現在のリージョンの AWS アカウントのEBS暗号化CMKのデフォルトCMKとして指定された を設定します。

aws ec2 modify-ebs-default-kms-key-id \
    --kms-key-id alias/my-cmk

出力:

{
    "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/0ea3fef3-80a7-4778-9d8c-1c0c6EXAMPLE"
}

  • API 詳細については、「 コマンドリファレンスModifyEbsDefaultKmsKeyId」の「」を参照してください。 AWS CLI

次のコード例は、modify-fleet を使用する方法を示しています。

AWS CLI

フリートEC2をスケーリングするには

次のmodify-fleet例では、指定されたEC2フリートのターゲット容量を変更します。指定された値が現在の容量より大きい場合、EC2フリートは追加のインスタンスを起動します。指定された値が現在の容量よりも小さい場合、EC2フリートはオープンリクエストをキャンセルし、終了ポリシーが の場合terminate、EC2フリートは新しいターゲット容量を超えるインスタンスをすべて終了します。

aws ec2 modify-fleet \
    --fleet-ids fleet-12a34b55-67cd-8ef9-ba9b-9208dEXAMPLE \
    --target-capacity-specification TotalTargetCapacity=5

出力:

{
    "Return": true
}

詳細については、Linux インスタンス用 Amazon EC2 Elastic Compute Cloud ユーザーガイドの「フリートの管理」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyFleet」の「」を参照してください。 AWS CLI

次のコード例は、modify-fpga-image-attribute を使用する方法を示しています。

AWS CLI

Amazon FPGAイメージの属性を変更するには

この例では、指定した のアカウント ID 123456789012にロード許可を追加しますAFI。

コマンド:

aws ec2 modify-fpga-image-attribute --attribute loadPermission --fpga-image-id afi-0d123e123bfc85abc --load-permission Add=[{UserId=123456789012}]

出力:

{
  "FpgaImageAttribute": {
      "FpgaImageId": "afi-0d123e123bfc85abc",
      "LoadPermissions": [
          {
              "UserId": "123456789012"
          }
      ]
  }
}

  • API 詳細については、「 コマンドリファレンスModifyFpgaImageAttribute」の「」を参照してください。 AWS CLI

次のコード例は、modify-hosts を使用する方法を示しています。

AWS CLI

例 1: Dedicated Host の自動配置を有効にするには

次のmodify-hosts例では、Dedicated Host の自動配置を有効にして、インスタンスタイプ設定に一致するターゲット未設定のインスタンス起動を受け入れます。

aws ec2 modify-hosts \
    --host-id h-06c2f189b4EXAMPLE \
    --auto-placement on

出力:

{
    "Successful": [
        "h-06c2f189b4EXAMPLE"
    ],
    "Unsuccessful": []
}

例 2: Dedicated Host のホスト復旧を有効にするには

次のmodify-hosts例では、指定された Dedicated Host のホスト復旧を有効にします。

aws ec2 modify-hosts \
    --host-id h-06c2f189b4EXAMPLE \
    --host-recovery on

出力:

{
    "Successful": [
        "h-06c2f189b4EXAMPLE"
    ],
    "Unsuccessful": []
}

詳細については、Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイドの「専有ホストの自動配置の変更」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyHosts」の「」を参照してください。 AWS CLI

次のコード例は、modify-id-format を使用する方法を示しています。

AWS CLI

リソースの長い ID 形式を有効にするには

次のmodify-id-format例では、 instanceリソースタイプの長い ID 形式を有効にします。

aws ec2 modify-id-format \
    --resource instance \
    --use-long-ids

リソースの長い ID 形式を無効にするには

次のmodify-id-format例では、 instanceリソースタイプの長い ID 形式を無効にします。

aws ec2 modify-id-format \
    --resource instance \
    --no-use-long-ids

次のmodify-id-format例では、オプトイン期間内のサポートされているすべてのリソースタイプで長い ID 形式を有効にします。

aws ec2 modify-id-format \
    --resource all-current \
    --use-long-ids

  • API 詳細については、「 コマンドリファレンスModifyIdFormat」の「」を参照してください。 AWS CLI

次のコード例は、modify-identity-id-format を使用する方法を示しています。

AWS CLI

IAMロールがリソースに長いIDs時間使用できるようにするには

次のmodify-identity-id-format例では、アカウントのIAMロールEC2Roleがinstanceリソースタイプ AWS に長い ID 形式を使用できるようにします。

aws ec2 modify-identity-id-format \
    --principal-arn arn:aws:iam::123456789012:role/EC2Role \
    --resource instance \
    --use-long-ids

IAMユーザーがリソースに対してより長いIDs時間を使用できるようにするには

次のmodify-identity-id-format例では、アカウントのIAMユーザーが volumeリソースタイプAdminUser AWS に長い ID 形式を使用できるようにします。

aws ec2 modify-identity-id-format \
    --principal-arn arn:aws:iam::123456789012:user/AdminUser \
    --resource volume \
    --use-long-ids

次のmodify-identity-id-format例では、 AWS アカウントのIAMユーザーが、オプトイン期間内のサポートされているすべてのリソースタイプAdminUserで長い ID 形式を使用できるようにします。

aws ec2 modify-identity-id-format \
    --principal-arn arn:aws:iam::123456789012:user/AdminUser \
    --resource all-current \
    --use-long-ids

  • API 詳細については、「 コマンドリファレンスModifyIdentityIdFormat」の「」を参照してください。 AWS CLI

次のコード例は、modify-image-attribute を使用する方法を示しています。

AWS CLI

例 1: をAMI公開するには

次のmodify-instance-attribute例では、指定された をAMIパブリックにします。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{Group=all}]"

このコマンドでは何も出力されません。

例 2: をAMIプライベートにするには

次のmodify-instance-attribute例では、指定された をAMIプライベートにします。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{Group=all}]"

このコマンドでは何も出力されません。

例 3: AWS アカウントに起動許可を付与するには

次のmodify-instance-attribute例では、指定された AWS アカウントに起動許可を付与します。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Add=[{UserId=123456789012}]"

このコマンドでは何も出力されません。

例 4: AWS アカウントから起動許可を削除するには

次のmodify-instance-attribute例では、指定された AWS アカウントから起動許可を削除します。

aws ec2 modify-image-attribute \
    --image-id ami-5731123e \
    --launch-permission "Remove=[{UserId=123456789012}]"

  • API 詳細については、「 コマンドリファレンスModifyImageAttribute」の「」を参照してください。 AWS CLI

次のコード例は、modify-instance-attribute を使用する方法を示しています。

AWS CLI

例 1: インスタンスタイプを変更するには

次のmodify-instance-attribute例では、指定されたインスタンスのインスタンスタイプを変更します。インスタンスは stopped の状態である必要があります。

aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --instance-type "{\"Value\": \"m1.small\"}"

このコマンドでは何も出力されません。

例 2: インスタンスで拡張ネットワーキングを有効にするには

次のmodify-instance-attribute例では、指定したインスタンスの拡張ネットワーキングを有効にします。インスタンスは stopped の状態である必要があります。

aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --sriov-net-support simple

このコマンドでは何も出力されません。

例 3: sourceDestCheck 属性を変更するには

次のmodify-instance-attribute例では、指定されたインスタンスの sourceDestCheck 属性を に設定しますtrue。インスタンスは にある必要がありますVPC。

aws ec2 modify-instance-attribute --instance-id i-1234567890abcdef0 --source-dest-check "{\"Value\": true}"

このコマンドでは何も出力されません。

例 4: ルートボリュームの deleteOnTermination 属性を変更するには

次のmodify-instance-attribute例では、指定された Amazon EBS-backed インスタンスのルートボリュームの deleteOnTermination 属性を に設定しますfalse。デフォルトでは、この属性はルートボリュームtrue用です。

コマンド:

aws ec2 modify-instance-attribute \
  --instance-id i-1234567890abcdef0 \
  --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]"

このコマンドでは何も出力されません。

例 5: インスタンスにアタッチされたユーザーデータを変更するには

次のmodify-instance-attribute例では、 UserData 指定したインスタンスの UserData.txtとして ファイルの内容を追加します。

元のファイルの内容UserData.txt：

#!/bin/bash
yum update -y
service httpd start
chkconfig httpd on

ファイルの内容は base64 でエンコードされている必要があります。最初のコマンドはテキストファイルを base64 に変換し、新しいファイルとして保存します。

コマンドの Linux/macOS バージョン：

base64 UserData.txt > UserData.base64.txt

このコマンドでは何も出力されません。

コマンドの Windows バージョン：

certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txt

出力:

Input Length = 67
Output Length = 152
CertUtil: -encode command completed successfully.

これで、次のCLIコマンドでそのファイルを参照できます。

aws ec2 modify-instance-attribute \
    --instance-id=i-09b5a14dbca622e76 \
    --attribute userData --value file://UserData.base64.txt

このコマンドでは何も出力されません。

詳細については、「 ユーザーガイド」の「 ユーザーデータと AWS CLI EC2」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyInstanceAttribute」の「」を参照してください。 AWS CLI

次の例は、modify-instance-capacity-reservation-attributes を使用する方法を説明しています。

AWS CLI

例 1: インスタンスのキャパシティ予約のターゲット設定を変更するには

次のmodify-instance-capacity-reservation-attributes例では、停止したインスタンスを変更して、特定のキャパシティ予約をターゲットにします。

aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id i-EXAMPLE8765abcd4e \
    --capacity-reservation-specification 'CapacityReservationTarget={CapacityReservationId= cr-1234abcd56EXAMPLE }'

出力:

{
    "Return": true
}

例 2: インスタンスのキャパシティ予約のターゲット設定を変更するには

次のmodify-instance-capacity-reservation-attributes例では、指定されたキャパシティ予約をターゲットとする停止したインスタンスを変更して、一致する属性 (インスタンスタイプ、プラットフォーム、アベイラビリティーゾーン) とオープンインスタンス一致基準を持つキャパシティ予約で起動します。

aws ec2 modify-instance-capacity-reservation-attributes \
    --instance-id i-EXAMPLE8765abcd4e \
    --capacity-reservation-specification 'CapacityReservationPreference=open'

出力:

{
    "Return": true
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのキャパシティ予約設定の変更」を参照してください。

次のコード例は、modify-instance-credit-specification を使用する方法を示しています。

AWS CLI

インスタンスCPUの使用に対するクレジットオプションを変更するには

この例では、指定されたリージョンで指定されたインスタンスCPUを使用するためのクレジットオプションを「無制限」に変更します。有効なクレジットオプションは「標準」と「無制限」です。

コマンド:

aws ec2 modify-instance-credit-specification --instance-credit-specification "InstanceId=i-1234567890abcdef0,CpuCredits=unlimited"

出力:

{
  "SuccessfulInstanceCreditSpecifications": [
    {
      "InstanceId": "i-1234567890abcdef0"
    }
  ],
  "UnsuccessfulInstanceCreditSpecifications": []
}

次のコード例は、modify-instance-event-start-time を使用する方法を示しています。

AWS CLI

インスタンスのイベント開始時刻を変更するには

次のmodify-instance-event-start-timeコマンドは、指定したインスタンスのイベント開始時刻を変更する方法を示しています。--instance-event-id パラメータを使用してイベント ID を指定します。--not-before パラメータを使用して、新しい日付と時刻を指定します。

aws ec2 modify-instance-event-start-time --instance-id i-1234567890abcdef0 --instance-event-id instance-event-0abcdef1234567890 --not-before 2019-03-25T10:00:00.000

出力:

"Event": {
    "InstanceEventId": "instance-event-0abcdef1234567890",
    "Code": "system-reboot",
    "Description": "scheduled reboot",
    "NotAfter": "2019-03-25T12:00:00.000Z",
    "NotBefore": "2019-03-25T10:00:00.000Z",
    "NotBeforeDeadline": "2019-04-22T21:00:00.000Z"
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「再起動が予定されているインスタンスの使用」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyInstanceEventStartTime」の「」を参照してください。 AWS CLI

次のコード例は、modify-instance-event-window を使用する方法を示しています。

AWS CLI

例 1: イベントウィンドウの時間範囲を変更するには

次のmodify-instance-event-window例では、イベントウィンドウの時間範囲を変更します。time-range パラメータにより時間範囲を変更します。また、cron-expression パラメータを指定することはできません。

aws ec2 modify-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890
    --time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "TimeRanges": [
            {
                "StartWeekDay": "monday",
                "StartHour": 2,
                "EndWeekDay": "wednesday",
                "EndHour": 8
            }
        ],
        "Name": "myEventWindowName",
        "AssociationTarget": {
            "InstanceIds": [
                "i-0abcdef1234567890",
                "i-0be35f9acb8ba01f0"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 2: イベントウィンドウの時間範囲のセットを変更するには

次のmodify-instance-event-window例では、イベントウィンドウの時間範囲を変更します。time-range パラメータにより時間範囲を変更します。また、cron-expression パラメータを指定することはできません。

aws ec2 modify-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8},
        {"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]'

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "TimeRanges": [
            {
                "StartWeekDay": "monday",
                "StartHour": 2,
                "EndWeekDay": "wednesday",
                "EndHour": 8
            },
            {
                "StartWeekDay": "thursday",
                "StartHour": 2,
                "EndWeekDay": "friday",
                "EndHour": 8
            }
        ],
        "Name": "myEventWindowName",
        "AssociationTarget": {
            "InstanceIds": [
                "i-0abcdef1234567890",
                "i-0be35f9acb8ba01f0"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

例 3: イベントウィンドウの cron 式を変更するには

次のmodify-instance-event-window例では、イベントウィンドウの cron 式を変更します。cron-expression パラメータにより cron 式を変更します。また、time-range パラメータを指定することはできません。

aws ec2 modify-instance-event-window \
    --region us-east-1 \
    --instance-event-window-id iew-0abcdef1234567890 \
    --cron-expression "* 21-23 * * 2,3"

出力:

{
    "InstanceEventWindow": {
        "InstanceEventWindowId": "iew-0abcdef1234567890",
        "Name": "myEventWindowName",
        "CronExpression": "* 21-23 * * 2,3",
        "AssociationTarget": {
            "InstanceIds": [
                "i-0abcdef1234567890",
                "i-0be35f9acb8ba01f0"
            ],
            "Tags": [],
            "DedicatedHostIds": []
        },
        "State": "creating",
        "Tags": [
            {
                "Key": "K1",
                "Value": "V1"
            }
        ]
    }
}

イベントウィンドウの制約については、「Amazon EC2 ユーザーガイド」の「スケジュールされたイベント」セクションの「考慮事項」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyInstanceEventWindow」の「」を参照してください。 AWS CLI

次の例は、modify-instance-maintenance-options を使用する方法を説明しています。

AWS CLI

例 1: インスタンスの復旧動作を無効にするには

次のmodify-instance-maintenance-options例では、実行中または停止中のインスタンスの簡易自動復旧を無効にします。

aws ec2 modify-instance-maintenance-options \
    --instance-id i-0abcdef1234567890 \
    --auto-recovery disabled

出力:

{
    "InstanceId": "i-0abcdef1234567890",
    "AutoRecovery": "disabled"
}

詳細については、「Linux インスタンス用 Amazon ユーザーガイド」の「インスタンスの復旧EC2」を参照してください。

例 2: インスタンスの復旧動作をデフォルトに設定するには

次のmodify-instance-maintenance-options例では、自動復旧動作をデフォルトに設定し、サポートされているインスタンスタイプの簡易自動復旧を有効にします。

aws ec2 modify-instance-maintenance-options \
    --instance-id i-0abcdef1234567890 \
    --auto-recovery default

出力:

{
    "InstanceId": "i-0abcdef1234567890",
    "AutoRecovery": "default"
}

詳細については、「Linux インスタンス用 Amazon ユーザーガイド」の「インスタンスの復旧EC2」を参照してください。

次のコード例は、modify-instance-metadata-options を使用する方法を示しています。

AWS CLI

例 1: を有効にするには IMDSv2

次のmodify-instance-metadata-options例では、指定されたインスタンスIMDSv2で の使用を設定します。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-tokens required \
    --http-endpoint enabled

出力:

{
    "InstanceId": "i-1234567898abcdef0",
    "InstanceMetadataOptions": {
        "State": "pending",
        "HttpTokens": "required",
        "HttpPutResponseHopLimit": 1,
        "HttpEndpoint": "enabled"
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスメタデータとユーザーデータ」を参照してください。

例 2: インスタンスメタデータを無効にするには

次のmodify-instance-metadata-options例では、指定したインスタンスでインスタンスメタデータのすべてのバージョンの使用を無効にします。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-endpoint disabled

出力:

{
    "InstanceId": "i-1234567898abcdef0",
    "InstanceMetadataOptions": {
        "State": "pending",
        "HttpTokens": "required",
        "HttpPutResponseHopLimit": 1,
        "HttpEndpoint": "disabled"
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスメタデータとユーザーデータ」を参照してください。

例 3: インスタンスのインスタンスメタデータIPv6エンドポイントを有効にするには

次のmodify-instance-metadata-options例は、インスタンスメタデータサービスのIPv6エンドポイントを有効にする方法を示しています。

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567898abcdef0 \
    --http-protocol-ipv6 enabled \
    --http-endpoint enabled

出力:

{
    "InstanceId": "i-1234567898abcdef0",
    "InstanceMetadataOptions": {
        "State": "pending",
        "HttpTokens": "required",
        "HttpPutResponseHopLimit": 1,
        "HttpEndpoint": "enabled",
        HttpProtocolIpv6": "enabled"
    }
}

デフォルトでは、IPv6エンドポイントは無効になっています。これは、 IPv6のみのサブネットでインスタンスを起動した場合にも当てはまります。のIPv6エンドポイントIMDSは、Nitro System 上に構築されたインスタンスでのみアクセスできます。詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスメタデータとユーザーデータ」を参照してください。

次のコード例は、modify-instance-placement を使用する方法を示しています。

AWS CLI

例 1: Dedicated Host とのインスタンスのアフィニティを削除するには

次のmodify-instance-placement例では、Dedicated Host とのインスタンスのアフィニティを削除し、そのインスタンスタイプをサポートするアカウント内の利用可能な Dedicated Host でインスタンスを起動できるようにします。

aws ec2 modify-instance-placement \
    --instance-id i-0e6ddf6187EXAMPLE \
    --affinity default

出力:

{
    "Return": true
}

例 2: インスタンスと指定された Dedicated Host の間にアフィニティを確立するには

次のmodify-instance-placement例では、インスタンスと Dedicated Host の間に起動関係を確立します。インスタンスは、指定された Dedicated Host でのみ実行できます。

aws ec2 modify-instance-placement \
    --instance-id i-0e6ddf6187EXAMPLE \
    --affinity host \
    --host-id i-0e6ddf6187EXAMPLE

出力:

{
    "Return": true
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのテナンシーとアフィニティの変更」を参照してください。

例 3: インスタンスをプレイスメントグループに移動するには

次のmodify-instance-placement例では、インスタンスをプレイスメントグループに移動し、インスタンスを停止し、インスタンスのプレイスメントを変更してから、インスタンスを再起動します。

aws ec2 stop-instances \
    --instance-ids i-0123a456700123456

aws ec2 modify-instance-placement \
    --instance-id i-0123a456700123456 \
    --group-name MySpreadGroup

aws ec2 start-instances \
    --instance-ids i-0123a456700123456

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのプレイスメントグループの変更」を参照してください。

例 4: プレイスメントグループからインスタンスを削除するには

次のmodify-instance-placement例では、インスタンスを停止し、インスタンスの配置を変更してからインスタンスを再起動することで、プレイスメントグループからインスタンスを削除します。次の例では、プレイスメントグループ名に空の文字列 ("") を指定して、インスタンスがプレイスメントグループ内に配置されないことを示します。

インスタンスを停止します。

aws ec2 stop-instances \
    --instance-ids i-0123a456700123456

配置を変更します (Windows コマンドプロンプト、Linux、macOS )。

aws ec2 modify-instance-placement \
    --instance-id i-0123a456700123456 \
    --group-name ""

配置を変更する (Windows PowerShell):

aws ec2 modify-instance-placement `
    --instance-id i-0123a456700123456 `
    --group-name """"

インスタンスを再起動します。

aws ec2 start-instances \
    --instance-ids i-0123a456700123456

出力:

{
    "Return": true
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのテナンシーとアフィニティの変更」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyInstancePlacement」の「」を参照してください。 AWS CLI

次の例は、modify-ipam-pool を使用する方法を説明しています。

AWS CLI

IPAM プールを変更するには

次のmodify-ipam-pool例では、IPAMプールを変更します。

(Linux):

aws ec2 modify-ipam-pool \
    --ipam-pool-id ipam-pool-0533048da7d823723 \
    --add-allocation-resource-tags "Key=Owner,Value=Build Team" \
    --clear-allocation-default-netmask-length \
    --allocation-min-netmask-length 14

(Windows):

aws ec2 modify-ipam-pool ^
    --ipam-pool-id ipam-pool-0533048da7d823723 ^
    --add-allocation-resource-tags "Key=Owner,Value=Build Team" ^
    --clear-allocation-default-netmask-length ^
    --allocation-min-netmask-length 14

出力:

{
    "IpamPool": {
        "OwnerId": "123456789012",
        "IpamPoolId": "ipam-pool-0533048da7d823723",
        "IpamPoolArn": "arn:aws:ec2::123456789012:ipam-pool/ipam-pool-0533048da7d823723",
        "IpamScopeArn": "arn:aws:ec2::123456789012:ipam-scope/ipam-scope-02fc38cd4c48e7d38",
        "IpamScopeType": "private",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
        "IpamRegion": "us-east-1",
        "Locale": "None",
        "PoolDepth": 1,
        "State": "modify-complete",
        "AutoImport": true,
        "AddressFamily": "ipv4",
        "AllocationMinNetmaskLength": 14,
        "AllocationMaxNetmaskLength": 26,
        "AllocationResourceTags": [
            {
                "Key": "Environment",
                "Value": "Preprod"
            },
            {
                "Key": "Owner",
                "Value": "Build Team"
            }
        ]
    }
}

詳細については、「Amazon ユーザーガイド」の「プールの編集」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスModifyIpamPool」の「」を参照してください。 AWS CLI

次の例は、modify-ipam-resource-cidr を使用する方法を説明しています。

AWS CLI

リソースCIDRに割り当てられた を変更するには

次のmodify-ipam-resource-cidr例では、リソース を変更しますCIDR。

(Linux):

aws ec2 modify-ipam-resource-cidr \
    --current-ipam-scope-id ipam-scope-02fc38cd4c48e7d38 \
    --destination-ipam-scope-id ipam-scope-0da34c61fd189a141 \
    --resource-id vpc-010e1791024eb0af9 \
    --resource-cidr 10.0.1.0/24 \
    --resource-region us-east-1 \
    --monitored

(Windows):

aws ec2 modify-ipam-resource-cidr ^
    --current-ipam-scope-id ipam-scope-02fc38cd4c48e7d38 ^
    --destination-ipam-scope-id ipam-scope-0da34c61fd189a141 ^
    --resource-id vpc-010e1791024eb0af9 ^
    --resource-cidr 10.0.1.0/24 ^
    --resource-region us-east-1 ^
    --monitored

出力:

{
    "IpamResourceCidr": {
        "IpamId": "ipam-08440e7a3acde3908",
        "IpamScopeId": "ipam-scope-0da34c61fd189a141",
        "IpamPoolId": "ipam-pool-0533048da7d823723",
        "ResourceRegion": "us-east-1",
        "ResourceOwnerId": "123456789012",
        "ResourceId": "vpc-010e1791024eb0af9",
        "ResourceCidr": "10.0.1.0/24",
        "ResourceType": "vpc",
        "ResourceTags": [
            {
                "Key": "Environment",
                "Value": "Preprod"
            },
            {
                "Key": "Owner",
                "Value": "Build Team"
            }
        ],
        "IpUsage": 0.0,
        "ComplianceStatus": "noncompliant",
        "ManagementState": "managed",
        "OverlapStatus": "overlapping",
        "VpcId": "vpc-010e1791024eb0af9"
    }
}

リソースの移動の詳細については、「Amazon VPC IPAM ユーザーガイド」の「スコープCIDRs間でリソースを移動する」を参照してください。

モニタリング状態の変更の詳細については、「Amazon ユーザーガイド」の「リソースのモニタリング状態CIDRsの変更」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスModifyIpamResourceCidr」の「」を参照してください。 AWS CLI

次のコード例は、modify-ipam-resource-discovery を使用する方法を示しています。

AWS CLI

リソース検出のオペレーションリージョンを変更するには

この例では、リソース検出の運用リージョンを変更したいIPAM委任管理者です。

このリクエストを完了するには：

デフォルトのリソース検出を変更することはできません。また、リソース検出の所有者である必要があります。 で取得できるリソース検出 ID が必要ですdescribe-ipam-resource-discoveries。

次のmodify-ipam-resource-discovery例では、アカウントのデフォルト以外のリソース検出を変更します AWS 。

aws ec2 modify-ipam-resource-discovery \
    --ipam-resource-discovery-id ipam-res-disco-0f4ef577a9f37a162 \
    --add-operating-regions RegionName='us-west-1' \
    --remove-operating-regions RegionName='us-east-2' \
    --region us-east-1

出力:

{
    "IpamResourceDiscovery": {
        "OwnerId": "149977607591",
        "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
        "IpamResourceDiscoveryArn": "arn:aws:ec2::149977607591:ipam-resource-discovery/ipam-res-disco-0365d2977fc1672fe",
        "IpamResourceDiscoveryRegion": "us-east-1",
        "Description": "Example",
        "OperatingRegions": [
            {
                "RegionName": "us-east-1"
            },
            {
                "RegionName": "us-west-1"
            }
        ],
        "IsDefault": false,
        "State": "modify-in-progress"
    }
}

詳細については、「Amazon VPC IPAM ユーザーガイド」の「リソース検出の操作」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyIpamResourceDiscovery」の「」を参照してください。 AWS CLI

次のコード例は、modify-ipam-scope を使用する方法を示しています。

AWS CLI

スコープの説明を変更するには

このシナリオでは、 IPAMスコープの説明を変更したいIPAM委任管理者です。

このリクエストを完了するには、 で取得できるスコープ ID が必要ですdescribe-ipam-scopes。

次のmodify-ipam-scope例では、スコープの説明を更新します。

aws ec2 modify-ipam-scope \
    --ipam-scope-id ipam-scope-0d3539a30b57dcdd1 \
    --description example \
    --region us-east-1

出力:

{
"IpamScope": {
        "OwnerId": "320805250157",
        "IpamScopeId": "ipam-scope-0d3539a30b57dcdd1",
        "IpamScopeArn": "arn:aws:ec2::320805250157:ipam-scope/ipam-scope-0d3539a30b57dcdd1",
        "IpamArn": "arn:aws:ec2::320805250157:ipam/ipam-005f921c17ebd5107",
        "IpamRegion": "us-east-1",
        "IpamScopeType": "public",
        "IsDefault": true,
        "Description": "example",
        "PoolCount": 1,
        "State": "modify-in-progress"
    }
}

スコープの詳細については、「Amazon VPC IPAM ユーザーガイド」の「 のIPAM仕組み」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyIpamScope」の「」を参照してください。 AWS CLI

次のコード例は、modify-ipam を使用する方法を示しています。

AWS CLI

を変更するには IPAM

次のmodify-ipam例では、 オペレーションリージョンIPAMを追加して を変更します。

(Linux):

aws ec2 modify-ipam \
    --ipam-id ipam-08440e7a3acde3908 \
    --add-operating-regions RegionName=us-west-2

(Windows):

aws ec2 modify-ipam ^
    --ipam-id ipam-08440e7a3acde3908 ^
    --add-operating-regions RegionName=us-west-2

出力:

{
    "Ipam": {
        "OwnerId": "123456789012",
        "IpamId": "ipam-08440e7a3acde3908",
        "IpamArn": "arn:aws:ec2::123456789012:ipam/ipam-08440e7a3acde3908",
        "IpamRegion": "us-east-1",
        "PublicDefaultScopeId": "ipam-scope-0b9eed026396dbc16",
        "PrivateDefaultScopeId": "ipam-scope-02fc38cd4c48e7d38",
        "ScopeCount": 3,
        "OperatingRegions": [
            {
                "RegionName": "us-east-1"
            },
            {
                "RegionName": "us-east-2"
            },
            {
                "RegionName": "us-west-1"
            },
            {
                "RegionName": "us-west-2"
            }
        ],
        "State": "modify-in-progress"
    }
}

  • API 詳細については、「 コマンドリファレンスModifyIpam」の「」を参照してください。 AWS CLI

次の例は、modify-launch-template を使用する方法を説明しています。

AWS CLI

デフォルトの起動テンプレートのバージョンを変更するには

この例では、指定された起動テンプレートのバージョン 2 をデフォルトバージョンとして指定します。

コマンド:

aws ec2 modify-launch-template --launch-template-id lt-0abcd290751193123 --default-version 2

出力:

{
  "LaunchTemplate": {
      "LatestVersionNumber": 2,
      "LaunchTemplateId": "lt-0abcd290751193123",
      "LaunchTemplateName": "WebServers",
      "DefaultVersionNumber": 2,
      "CreatedBy": "arn:aws:iam::123456789012:root",
      "CreateTime": "2017-12-01T13:35:46.000Z"
  }
}

  • API 詳細については、「 コマンドリファレンスModifyLaunchTemplate」の「」を参照してください。 AWS CLI

次の例は、modify-managed-prefix-list を使用する方法を説明しています。

AWS CLI

プレフィックスリストを変更するには

次のmodify-managed-prefix-list例では、指定されたプレフィックスリストにエントリを追加します。

aws ec2 modify-managed-prefix-list \
    --prefix-list-id pl-0123456abcabcabc1 \
    --add-entries Cidr=10.1.0.0/16,Description=vpc-c \
    --current-version 1

出力:

{
    "PrefixList": {
        "PrefixListId": "pl-0123456abcabcabc1",
        "AddressFamily": "IPv4",
        "State": "modify-in-progress",
        "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1",
        "PrefixListName": "vpc-cidrs",
        "MaxEntries": 10,
        "Version": 1,
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon ユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。 VPC

  • API 詳細については、「 コマンドリファレンスModifyManagedPrefixList」の「」を参照してください。 AWS CLI

次の例は、modify-network-interface-attribute を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスのアタッチメント属性を変更するには

このコマンド例では、指定されたネットワークインターフェイスの attachment 属性を変更します。

コマンド:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --attachment AttachmentId=eni-attach-43348162,DeleteOnTermination=false

ネットワークインターフェイスの説明属性を変更するには

このコマンド例では、指定されたネットワークインターフェイスの description 属性を変更します。

コマンド:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --description "My description"

ネットワークインターフェイスの groupSet 属性を変更するには

このコマンド例では、指定されたネットワークインターフェイスの groupSet 属性を変更します。

コマンド:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --groups sg-903004f8 sg-1a2b3c4d

ネットワークインターフェイスの sourceDestCheck 属性を変更するには

このコマンド例では、指定されたネットワークインターフェイスの sourceDestCheck 属性を変更します。

コマンド:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --no-source-dest-check

次のコード例は、modify-private-dns-name-options を使用する方法を示しています。

AWS CLI

インスタンスホスト名のオプションを変更するには

次のmodify-private-dns-name-options例では、DNSA レコードを持つインスタンスホスト名のDNSクエリに応答するオプションを無効にします。

aws ec2 modify-private-dns-name-options \
    --instance-id i-1234567890abcdef0 \
    --no-enable-resource-name-dns-a-record

出力:

{
    "Return": true
}

詳細については、「Amazon ユーザーガイド」の「Amazon EC2インスタンスのホスト名タイプ」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスModifyPrivateDnsNameOptions」の「」を参照してください。 AWS CLI

次のコード例は、modify-reserved-instances を使用する方法を示しています。

AWS CLI

リザーブドインスタンス を変更するには

このコマンド例では、リザーブドインスタンスを同じリージョン内の別のアベイラビリティーゾーンに移動します。

コマンド:

aws ec2 modify-reserved-instances --reserved-instances-ids b847fa93-e282-4f55-b59a-1342f5bd7c02 --target-configurations AvailabilityZone=us-west-1c,Platform=EC2-Classic,InstanceCount=10

出力:

{
  "ReservedInstancesModificationId": "rimod-d3ed4335-b1d3-4de6-ab31-0f13aaf46687"
}

リザーブドインスタンス のネットワークプラットフォームを変更するには

このコマンド例では、EC2-Classic リザーブドインスタンス を EC2- に変換しますVPC。

コマンド:

aws ec2 modify-reserved-instances --reserved-instances-ids f127bd27-edb7-44c9-a0eb-0d7e09259af0 --target-configurations AvailabilityZone=us-west-1c,Platform=EC2-VPC,InstanceCount=5

出力:

{
  "ReservedInstancesModificationId": "rimod-82fa9020-668f-4fb6-945d-61537009d291"
}

詳細については、「Amazon EC2ユーザーガイド」の「リザーブドインスタンスの変更」を参照してください。

リザーブドインスタンス のインスタンスサイズを変更するには

このコマンド例では、us-west-1c に 10 m1.small Linux/UNIX インスタンスを持つリザーブドインスタンスを変更して、8 m1.small インスタンスを 2 m1.large インスタンスにし、残りの 2 m1.small を同じアベイラビリティーゾーンに 1 m1.medium インスタンスにします。コマンド:

aws ec2 modify-reserved-instances --reserved-instances-ids 1ba8e2e3-3556-4264-949e-63ee671405a9 --target-configurations AvailabilityZone=us-west-1c,Platform=EC2-Classic,InstanceCount=2,InstanceType=m1.large AvailabilityZone=us-west-1c,Platform=EC2-Classic,InstanceCount=1,InstanceType=m1.medium

出力:

{
    "ReservedInstancesModificationId": "rimod-acc5f240-080d-4717-b3e3-1c6b11fa00b6"
}

詳細については、「Amazon ユーザーガイド」の「予約のインスタンスサイズの変更EC2」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyReservedInstances」の「」を参照してください。 AWS CLI

次の例は、modify-security-group-rules を使用する方法を説明しています。

AWS CLI

セキュリティグループルールを変更してルールの説明、IP プロトコル、および CidrIpv4 アドレス範囲を更新するには

次のmodify-security-group-rules例では、指定されたセキュリティグループルールの説明、IP プロトコル、およびIPV4CIDR範囲を更新します。security-group-rules パラメータを使用して、指定されたセキュリティグループルールの更新を入力します。 はすべてのプロトコル-1を指定します。

aws ec2 modify-security-group-rules \
    --group-id sg-1234567890abcdef0 \
    --security-group-rules SecurityGroupRuleId=sgr-abcdef01234567890,SecurityGroupRule='{Description=test,IpProtocol=-1,CidrIpv4=0.0.0.0/0}'

出力:

{
    "Return": true
}

セキュリティグループルールの詳細については、「Amazon ユーザーガイド」の「セキュリティグループルール」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスModifySecurityGroupRules」の「」を参照してください。 AWS CLI

次の例は、modify-snapshot-attribute を使用する方法を説明しています。

AWS CLI

例 1: スナップショット属性を変更するには

次のmodify-snapshot-attribute例では、指定されたスナップショットの createVolumePermission 属性を更新し、指定されたユーザーのボリューム許可を削除します。

aws ec2 modify-snapshot-attribute \
    --snapshot-id snap-1234567890abcdef0 \
    --attribute createVolumePermission \
    --operation-type remove \
    --user-ids 123456789012

例 2: スナップショットを公開するには

次のmodify-snapshot-attribute例では、指定されたスナップショットをパブリックにします。

aws ec2 modify-snapshot-attribute \
    --snapshot-id snap-1234567890abcdef0 \
    --attribute createVolumePermission \
    --operation-type add \
    --group-names all

  • API 詳細については、「 コマンドリファレンスModifySnapshotAttribute」の「」を参照してください。 AWS CLI

次のコード例は、modify-snapshot-tier を使用する方法を示しています。

AWS CLI

例 1: スナップショットをアーカイブするには

次のmodify-snapshot-tier例では、指定されたスナップショットをアーカイブします。

aws ec2 modify-snapshot-tier \
    --snapshot-id snap-01234567890abcedf \
    --storage-tier archive

出力:

{
    "SnapshotId": "snap-01234567890abcedf",
    "TieringStartTime": "2021-09-15T16:44:37.574Z"
}

TieringStartTime レスポンスパラメータは、アーカイブプロセスが開始された日時をUTC時間形式 (YYYY-MM-DDTHH:MM:SSZ) で示します。

スナップショットのアーカイブの詳細については、「Amazon ユーザーガイド」の「Amazon EBSスナップショットのアーカイブ」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスModifySnapshotTier」の「」を参照してください。 AWS CLI

次のコード例は、modify-spot-fleet-request を使用する方法を示しています。

AWS CLI

スポットフリートリクエストを変更するには

このコマンド例では、指定されたスポットフリートリクエストのターゲット容量を更新します。

コマンド:

aws ec2 modify-spot-fleet-request --target-capacity 20 --spot-fleet-request-id sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE

出力:

{
    "Return": true
}

このコマンド例では、結果としてスポットインスタンスを終了せずに、指定されたスポットフリートリクエストのターゲット容量を減らします。

コマンド:

aws ec2 modify-spot-fleet-request --target-capacity 10 --excess-capacity-termination-policy NoTermination --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE

出力:

{
    "Return": true
}

  • API 詳細については、「 コマンドリファレンスModifySpotFleetRequest」の「」を参照してください。 AWS CLI

次の例は、modify-subnet-attribute を使用する方法を説明しています。

AWS CLI

サブネットのパブリックIPv4アドレス動作を変更するには

この例では、サブネット-1a2b3c4d を変更して、このサブネットで起動されたすべてのインスタンスにパブリックIPv4アドレスが割り当てられるように指定します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 modify-subnet-attribute --subnet-id subnet-1a2b3c4d --map-public-ip-on-launch

サブネットのIPv6アドレス動作を変更するには

この例では、サブネット-1a2b3c4d を変更して、このサブネットで起動されたすべてのインスタンスにサブネットの範囲からのIPv6アドレスが割り当てられるように指定します。

コマンド:

aws ec2 modify-subnet-attribute --subnet-id subnet-1a2b3c4d --assign-ipv6-address-on-creation

詳細については、AWS 「Virtual Private Cloud ユーザーガイド」の「 VPCでの IP アドレス指定」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifySubnetAttribute」の「」を参照してください。 AWS CLI

次のコード例は、modify-traffic-mirror-filter-network-services を使用する方法を示しています。

AWS CLI

Traffic Mirror フィルターにネットワークサービスを追加するには

次のmodify-traffic-mirror-filter-network-services例では、指定されたフィルターに Amazon DNSネットワークサービスを追加します。

aws ec2 modify-traffic-mirror-filter-network-services \
    --traffic-mirror-filter-id tmf-04812ff784EXAMPLE \
    --add-network-service amazon-dns

出力:

{
    "TrafficMirrorFilter": {
        "Tags": [
            {
                "Key": "Name",
                "Value": "Production"
            }
        ],
        "EgressFilterRules": [],
        "NetworkServices": [
            "amazon-dns"
        ],
        "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
        "IngressFilterRules": [
            {
                "SourceCidrBlock": "0.0.0.0/0",
                "RuleNumber": 1,
                "DestinationCidrBlock": "0.0.0.0/0",
                "Description": "TCP Rule",
                "Protocol": 6,
                "TrafficDirection": "ingress",
                "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
                "RuleAction": "accept",
                "TrafficMirrorFilterRuleId": "tmf-04812ff784EXAMPLE"
            }
        ]
    }
}

詳細については、トラフィックミラーリングガイドの「トラフィックミラーフィルタネットワークサービスの変更AWS 」を参照してください。

次のコード例は、modify-traffic-mirror-filter-rule を使用する方法を示しています。

AWS CLI

トラフィックミラーフィルタールールを変更するには

次のmodify-traffic-mirror-filter-rule例では、指定されたトラフィックミラーフィルタールールの説明を変更します。

aws ec2 modify-traffic-mirror-filter-rule \
    --traffic-mirror-filter-rule-id tmfr-0ca76e0e08EXAMPLE \
    --description "TCP Rule"

出力:

{
    "TrafficMirrorFilterRule": {
        "TrafficMirrorFilterRuleId": "tmfr-0ca76e0e08EXAMPLE",
        "TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE",
        "TrafficDirection": "ingress",
        "RuleNumber": 100,
        "RuleAction": "accept",
        "Protocol": 6,
        "DestinationCidrBlock": "10.0.0.0/24",
        "SourceCidrBlock": "10.0.0.0/24",
        "Description": "TCP Rule"
    }
}

詳細については、「トラフィックミラーリングガイド」の「トラフィックミラーフィルタールールの変更AWS 」を参照してください。

次の例は、modify-traffic-mirror-session を使用する方法を説明しています。

AWS CLI

トラフィックミラーセッションを変更するには

次のmodify-traffic-mirror-session例では、トラフィックミラーセッションの説明とミラーリングするパケット数を変更します。

aws ec2 modify-traffic-mirror-session \
    --description "Change packet length" \
    --traffic-mirror-session-id tms-08a33b1214EXAMPLE \
    --remove-fields "packet-length"

出力:

{
    "TrafficMirrorSession": {
        "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE",
        "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE",
        "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
        "NetworkInterfaceId": "eni-070203f901EXAMPLE",
        "OwnerId": "111122223333",
        "SessionNumber": 1,
        "VirtualNetworkId": 7159709,
        "Description": "Change packet length",
        "Tags": []
    }
}

詳細については、「トラフィックミラーリングガイド」の「トラフィックミラーセッションの変更」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyTrafficMirrorSession」の「」を参照してください。 AWS CLI

次の例は、modify-transit-gateway-prefix-list-reference を使用する方法を説明しています。

AWS CLI

プレフィックスリストへの参照を変更するには

次のmodify-transit-gateway-prefix-list-reference例では、トラフィックがルーティングされるアタッチメントを変更することで、指定されたルートテーブルのプレフィックスリスト参照を変更します。

aws ec2 modify-transit-gateway-prefix-list-reference \
    --transit-gateway-route-table-id tgw-rtb-0123456789abcd123 \
    --prefix-list-id pl-11111122222222333 \
    --transit-gateway-attachment-id tgw-attach-aabbccddaabbccaab

出力:

{
    "TransitGatewayPrefixListReference": {
        "TransitGatewayRouteTableId": "tgw-rtb-0123456789abcd123",
        "PrefixListId": "pl-11111122222222333",
        "PrefixListOwnerId": "123456789012",
        "State": "modifying",
        "Blackhole": false,
        "TransitGatewayAttachment": {
            "TransitGatewayAttachmentId": "tgw-attach-aabbccddaabbccaab",
            "ResourceType": "vpc",
            "ResourceId": "vpc-112233445566aabbc"
        }
    }
}

詳細については、「 Transit Gateways ガイド」の「プレフィックスリストリファレンス」を参照してください。

次のコード例は、modify-transit-gateway-vpc-attachment を使用する方法を示しています。

AWS CLI

Transit Gateway アタッチメントを変更するには VPC

次のmodify-transit-gateway-vpc-attachment例では、指定された Transit Gateway VPCアタッチメントにサブネットを追加します。

aws ec2 modify-transit-gateway-vpc-attachment \
    --transit-gateway-attachment-id tgw-attach-09fbd47ddfEXAMPLE \
    --add-subnet-ids subnet-0e51f45802EXAMPLE

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-09fbd47ddfEXAMPLE",
        "TransitGatewayId": "tgw-0560315ccfEXAMPLE",
        "VpcId": "vpc-5eccc927",
        "VpcOwnerId": "111122223333",
        "State": "modifying",
        "SubnetIds": [
            "subnet-0e51f45802EXAMPLE",
            "subnet-1EXAMPLE"
        ],
        "CreationTime": "2019-08-08T16:47:38.000Z",
        "Options": {
            "DnsSupport": "enable",
            "Ipv6Support": "disable"
        }
    }
}

詳細については、「 Transit Gateways ガイドVPC」の「 への Transit Gateway アタッチメント」を参照してください。

次のコード例は、modify-transit-gateway を使用する方法を示しています。

AWS CLI

トランジットゲートウェイを変更するには

次のmodify-transit-gateway例では、VPNアタッチメントECMPのサポートを有効にして、指定されたトランジットゲートウェイを変更します。

aws ec2 modify-transit-gateway \
    --transit-gateway-id tgw-111111222222aaaaa \
    --options VpnEcmpSupport=enable

出力:

{
    "TransitGateway": {
        "TransitGatewayId": "tgw-111111222222aaaaa",
        "TransitGatewayArn": "64512",
        "State": "modifying",
        "OwnerId": "123456789012",
        "CreationTime": "2020-04-30T08:41:37.000Z",
        "Options": {
            "AmazonSideAsn": 64512,
            "AutoAcceptSharedAttachments": "disable",
            "DefaultRouteTableAssociation": "enable",
            "AssociationDefaultRouteTableId": "tgw-rtb-0123456789abcd123",
            "DefaultRouteTablePropagation": "enable",
            "PropagationDefaultRouteTableId": "tgw-rtb-0123456789abcd123",
            "VpnEcmpSupport": "enable",
            "DnsSupport": "enable"
        }
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイ」を参照してください。

  • API 詳細については、「 コマンドリファレンスModifyTransitGateway」の「」を参照してください。 AWS CLI

次の例は、modify-verified-access-endpoint-policy を使用する方法を説明しています。

AWS CLI

エンドポイントの Verified Access ポリシーを設定するには

次のmodify-verified-access-endpoint-policy例では、指定された Verified Access ポリシーを指定された Verified Access エンドポイントに追加します。

aws ec2 modify-verified-access-endpoint-policy \
    --verified-access-endpoint-id vae-066fac616d4d546f2 \
    --policy-enabled \
    --policy-document file://policy.txt

policy.txt の内容:

permit(principal,action,resource)
when {
    context.identity.groups.contains("finance") &&
    context.identity.email.verified == true
};

出力:

{
    "PolicyEnabled": true,
    "PolicyDocument": "permit(principal,action,resource)\nwhen {\n    context.identity.groups.contains(\"finance\") &&\n    context.identity.email_verified == true\n};"
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access ポリシー」を参照してください。 AWS

次のコード例は、modify-verified-access-endpoint を使用する方法を示しています。

AWS CLI

Verified Access エンドポイントの設定を変更するには

次のmodify-verified-access-endpoint例では、指定された説明を指定された Verified Access エンドポイントに追加します。

aws ec2 modify-verified-access-endpoint \
    --verified-access-endpoint-id vae-066fac616d4d546f2 \
    --description "Testing Verified Access"

出力:

{
    "VerifiedAccessEndpoint": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
        "VerifiedAccessEndpointId": "vae-066fac616d4d546f2",
        "ApplicationDomain": "example.com",
        "EndpointType": "network-interface",
        "AttachmentType": "vpc",
        "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE",
        "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com",
        "SecurityGroupIds": [
            "sg-004915970c4c8f13a"
        ],
        "NetworkInterfaceOptions": {
            "NetworkInterfaceId": "eni-0aec70418c8d87a0f",
            "Protocol": "https",
            "Port": 443
        },
        "Status": {
            "Code": "updating"
        },
        "Description": "Testing Verified Access",
        "CreationTime": "2023-08-25T20:54:43",
        "LastUpdatedTime": "2023-08-25T22:46:32"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access エンドポイント」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスModifyVerifiedAccessEndpoint」の「」を参照してください。 AWS CLI

次の例は、modify-verified-access-group-policy を使用する方法を説明しています。

AWS CLI

グループの Verified Access ポリシーを設定するには

次のmodify-verified-access-group-policy例では、指定された Verified Access ポリシーを指定された Verified Access グループに追加します。

aws ec2 modify-verified-access-group-policy \
    --verified-access-group-id vagr-0dbe967baf14b7235 \
    --policy-enabled \
    --policy-document file://policy.txt

policy.txt の内容:

permit(principal,action,resource)
when {
    context.identity.groups.contains("finance") &&
    context.identity.email.verified == true
};

出力:

{
    "PolicyEnabled": true,
    "PolicyDocument": "permit(principal,action,resource)\nwhen {\n    context.identity.groups.contains(\"finance\") &&\n    context.identity.email_verified == true\n};"
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access グループ」を参照してください。 AWS

次のコード例は、modify-verified-access-group を使用する方法を示しています。

AWS CLI

Verified Access グループの設定を変更するには

次のmodify-verified-access-group例では、指定された説明を指定された Verified Access グループに追加します。

aws ec2 modify-verified-access-group \
    --verified-access-group-id vagr-0dbe967baf14b7235 \
    --description "Testing Verified Access"

出力:

{
    "VerifiedAccessGroup": {
        "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "Testing Verified Access",
        "Owner": "123456789012",
        "VerifiedAccessGroupArn": "arn:aws:ec2:us-east-2:123456789012:verified-access-group/vagr-0dbe967baf14b7235",
        "CreationTime": "2023-08-25T19:55:19",
        "LastUpdatedTime": "2023-08-25T22:17:25"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access グループ」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスModifyVerifiedAccessGroup」の「」を参照してください。 AWS CLI

次の例は、modify-verified-access-instance-logging-configuration を使用する方法を説明しています。

AWS CLI

Verified Access インスタンスのログ記録を有効にするには

次のmodify-verified-access-instance-logging-configuration例では、指定された Verified Access インスタンスのアクセスログ記録を有効にします。ログは指定された Logs CloudWatch ロググループに配信されます。

aws ec2 modify-verified-access-instance-logging-configuration \
    --verified-access-instance-id vai-0ce000c0b7643abea \
    --access-logs CloudWatchLogs={Enabled=true,LogGroup=my-log-group}

出力:

{
    "LoggingConfiguration": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "AccessLogs": {
            "S3": {
                "Enabled": false
            },
            "CloudWatchLogs": {
                "Enabled": true,
                "DeliveryStatus": {
                    "Code": "success"
                },
                "LogGroup": "my-log-group"
            },
            "KinesisDataFirehose": {
                "Enabled": false
            },
            "LogVersion": "ocsf-1.0.0-rc.2",
            "IncludeTrustContext": false
        }
    }
}

詳細については、「 Verified Access ユーザーガイド」の「Verified Access ログ」を参照してください。 AWS

次のコード例は、modify-verified-access-instance を使用する方法を示しています。

AWS CLI

Verified Access インスタンスの設定を変更するには

次のmodify-verified-access-instance例では、指定された説明を指定された Verified Access インスタンスに追加します。

aws ec2 modify-verified-access-instance \
    --verified-access-instance-id vai-0ce000c0b7643abea \
    --description "Testing Verified Access"

出力:

{
    "VerifiedAccessInstance": {
        "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
        "Description": "Testing Verified Access",
        "VerifiedAccessTrustProviders": [
            {
                "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
                "TrustProviderType": "user",
                "UserTrustProviderType": "iam-identity-center"
            }
        ],
        "CreationTime": "2023-08-25T18:27:56",
        "LastUpdatedTime": "2023-08-25T22:41:04"
    }
}

詳細については、「Verified Access ユーザーガイド」の「Verified Access インスタンス」を参照してください。 AWS

  • API 詳細については、「 コマンドリファレンスModifyVerifiedAccessInstance」の「」を参照してください。 AWS CLI

次のコード例は、modify-verified-access-trust-provider を使用する方法を示しています。

AWS CLI

Verified Access 信頼プロバイダーの設定を変更するには

次のmodify-verified-access-trust-provider例では、指定された説明を指定された Verified Access 信頼プロバイダーに追加します。

aws ec2 modify-verified-access-trust-provider \
    --verified-access-trust-provider-id vatp-0bb32de759a3e19e7 \
    --description "Testing Verified Access"

出力:

{
    "VerifiedAccessTrustProvider": {
        "VerifiedAccessTrustProviderId": "vatp-0bb32de759a3e19e7",
        "Description": "Testing Verified Access",
        "TrustProviderType": "user",
        "UserTrustProviderType": "iam-identity-center",
        "PolicyReferenceName": "idc",
        "CreationTime": "2023-08-25T19:00:38",
        "LastUpdatedTime": "2023-08-25T19:18:21"
    }
}

詳細については、Verified Access ユーザーガイドの「Verified Access の信頼プロバイダーAWS 」を参照してください。

次の例は、modify-volume-attribute を使用する方法を説明しています。

AWS CLI

ボリューム属性を変更するには

この例では、ID を持つボリュームの autoEnableIo 属性を vol-1234567890abcdef0 に設定しますtrue。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 modify-volume-attribute --volume-id vol-1234567890abcdef0 --auto-enable-io

  • API 詳細については、「 コマンドリファレンスModifyVolumeAttribute」の「」を参照してください。 AWS CLI

次のコード例は、modify-volume を使用する方法を示しています。

AWS CLI

例 1: ボリュームのサイズを変更してボリュームを変更するには

次のmodify-volume例では、指定したボリュームのサイズを 150GBに変更します。

コマンド:

aws ec2 modify-volume --size 150 --volume-id vol-1234567890abcdef0

出力:

{
    "VolumeModification": {
        "TargetSize": 150,
        "TargetVolumeType": "io1",
        "ModificationState": "modifying",
        "VolumeId": " vol-1234567890abcdef0",
        "TargetIops": 100,
        "StartTime": "2019-05-17T11:27:19.000Z",
        "Progress": 0,
        "OriginalVolumeType": "io1",
        "OriginalIops": 100,
        "OriginalSize": 100
    }
}

例 2: タイプ、サイズ、IOPS値を変更してボリュームを変更するには

次のmodify-volume例では、ボリュームタイプをプロビジョンド IOPS に変更しSSD、ターゲットIOPSレートを 10000 に設定し、ボリュームサイズを 350GBに設定します。

aws ec2 modify-volume \
    --volume-type io1 \
    --iops 10000 \
    --size 350 \
    --volume-id vol-1234567890abcdef0

出力:

{
    "VolumeModification": {
        "TargetSize": 350,
        "TargetVolumeType": "io1",
        "ModificationState": "modifying",
        "VolumeId": "vol-0721c1a9d08c93bf6",
        "TargetIops": 10000,
        "StartTime": "2019-05-17T11:38:57.000Z",
        "Progress": 0,
        "OriginalVolumeType": "gp2",
        "OriginalIops": 150,
        "OriginalSize": 50
    }
}

  • API 詳細については、「 コマンドリファレンスModifyVolume」の「」を参照してください。 AWS CLI

次の例は、modify-vpc-attribute を使用する方法を説明しています。

AWS CLI

enableDnsSupport 属性を変更するには

この例では、 enableDnsSupport 属性を変更します。この属性は、 でDNS解決が有効になっているかどうかを示しますVPC。この属性が の場合true、Amazon DNSサーバーはインスタンスのDNSホスト名を対応する IP アドレスに解決します。それ以外の場合は解決しません。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 modify-vpc-attribute --vpc-id vpc-a01106c2 --enable-dns-support "{\"Value\":false}"

enableDnsHostnames 属性を変更するには

この例では、 enableDnsHostnames 属性を変更します。この属性は、 で起動されたインスタンスがDNSホスト名VPCを取得するかどうかを示します。この属性が の場合true、 のインスタンスはDNSホスト名VPCを取得します。それ以外の場合は取得しません。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 modify-vpc-attribute --vpc-id vpc-a01106c2 --enable-dns-hostnames "{\"Value\":false}"

  • API 詳細については、「 コマンドリファレンスModifyVpcAttribute」の「」を参照してください。 AWS CLI

次の例は、modify-vpc-endpoint-connection-notification を使用する方法を説明しています。

AWS CLI

エンドポイント接続通知を変更するには

この例では、指定されたエンドポイント接続通知のSNSトピックを変更します。

コマンド:

aws ec2 modify-vpc-endpoint-connection-notification --connection-notification-id vpce-nfn-008776de7e03f5abc --connection-events Accept Reject --connection-notification-arn arn:aws:sns:us-east-2:123456789012:mytopic

出力:

{
   "ReturnValue": true
}

次の例は、modify-vpc-endpoint-service-configuration を使用する方法を説明しています。

AWS CLI

エンドポイントサービスの設定を変更するには

この例では、指定されたエンドポイントサービスの承諾要件を変更します。

コマンド:

aws ec2 modify-vpc-endpoint-service-configuration --service-id vpce-svc-09222513e6e77dc86 --no-acceptance-required

出力:

{
   "ReturnValue": true
}

次のコード例は、modify-vpc-endpoint-service-payer-responsibility を使用する方法を示しています。

AWS CLI

支払者の責任を変更するには

次のmodify-vpc-endpoint-service-payer-responsibility例では、指定されたエンドポイントサービスの支払者の責任を変更します。

aws ec2 modify-vpc-endpoint-service-payer-responsibility \
    --service-id vpce-svc-071afff70666e61e0 \
    --payer-responsibility ServiceOwner

このコマンドでは何も出力されません。

次のコード例は、modify-vpc-endpoint-service-permissions を使用する方法を示しています。

AWS CLI

エンドポイントサービスのアクセス許可を変更するには

この例では、 AWS アカウントが指定されたエンドポイントサービスに接続するためのアクセス許可を追加します。

コマンド:

aws ec2 modify-vpc-endpoint-service-permissions --service-id vpce-svc-03d5ebb7d9579a2b3 --add-allowed-principals '["arn:aws:iam::123456789012:root"]'

出力:

{
   "ReturnValue": true
}

この例では、特定のIAMユーザー (admin) が指定されたエンドポイントサービスに接続するためのアクセス許可を追加します。

コマンド:

aws ec2 modify-vpc-endpoint-service-permissions --service-id vpce-svc-03d5ebb7d9579a2b3 --add-allowed-principals '["arn:aws:iam::123456789012:user/admin"]'

次の例は、modify-vpc-endpoint を使用する方法を説明しています。

AWS CLI

ゲートウェイエンドポイントを変更するには

この例では、ルートテーブルをエンドポイントrtb-aaa222bbに関連付け、ポリシードキュメントをリセットvpce-1a2b3c4dすることで、ゲートウェイエンドポイントを変更します。

コマンド:

aws ec2 modify-vpc-endpoint --vpc-endpoint-id vpce-1a2b3c4d --add-route-table-ids rtb-aaa222bb --reset-policy

出力:

{
  "Return": true
}

インターフェイスエンドポイントを変更するには

この例では、エンドポイントsubnet-d6fcaa8dにサブネットvpce-0fe5b17a0707d6fa5を追加してインターフェイスエンドポイントを変更します。

コマンド:

aws ec2 modify-vpc-endpoint --vpc-endpoint-id vpce-0fe5b17a0707d6fa5 --add-subnet-id subnet-d6fcaa8d

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスModifyVpcEndpoint」の「」を参照してください。 AWS CLI

次のコード例は、modify-vpc-peering-connection-options を使用する方法を示しています。

AWS CLI

ローカル接続からVPCピアリング ClassicLink 接続を介した通信を有効にするには

この例では、ピアリング接続 の場合pcx-aaaabbb、リクエスタの所有者VPCはVPCピア接続オプションを変更して、ローカル ClassicLink 接続がピア と通信できるようにしますVPC。

コマンド:

aws ec2 modify-vpc-peering-connection-options --vpc-peering-connection-id pcx-aaaabbbb --requester-peering-connection-options AllowEgressFromLocalClassicLinkToRemoteVpc=true

出力:

{
  "RequesterPeeringConnectionOptions": {
      "AllowEgressFromLocalClassicLinkToRemoteVpc": true
  }
}

ローカル接続からリモート接続VPCへのVPCピア接続を介した通信を有効にするには ClassicLink

この例では、アクセプタの所有者がVPCピアリング接続オプションVPCを変更して、ローカル がピア ClassicLink の接続とVPC通信できるようにしますVPC。

コマンド:

aws ec2 modify-vpc-peering-connection-options --vpc-peering-connection-id pcx-aaaabbbb --accepter-peering-connection-options AllowEgressFromLocalVpcToRemoteClassicLink=true

出力:

{
  "AccepterPeeringConnectionOptions": {
    "AllowEgressFromLocalVpcToRemoteClassicLink": true
  }
}

VPCピアリング接続のDNS解決サポートを有効にするには

この例では、リクエスタの所有者は のVPCピアリング接続オプションを変更pcx-aaaabbbbして、ピア VPC のインスタンスからクエリを実行するときに、ローカル がパブリックDNSホスト名をプライベート IP アドレスにVPC解決できるようにしますVPC。

コマンド:

aws ec2 modify-vpc-peering-connection-options --vpc-peering-connection-id pcx-aaaabbbb --requester-peering-connection-options AllowDnsResolutionFromRemoteVpc=true

出力:

{
  "RequesterPeeringConnectionOptions": {
      "AllowDnsResolutionFromRemoteVpc": true
  }
}

次のコード例は、modify-vpc-tenancy を使用する方法を示しています。

AWS CLI

のテナンシーを変更するには VPC

この例では、 のテナンシーを VPCvpc-1a2b3c4dに変更しますdefault。

コマンド:

aws ec2 modify-vpc-tenancy --vpc-id vpc-1a2b3c4d --instance-tenancy default

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスModifyVpcTenancy」の「」を参照してください。 AWS CLI

次の例は、modify-vpn-connection-options を使用する方法を説明しています。

AWS CLI

VPN接続オプションを変更するには

次のmodify-vpn-connection-options例では、指定されたVPN接続のIPv4CIDRカスタマーゲートウェイ側のローカル を変更します。

aws ec2 modify-vpn-connection-options \
    --vpn-connection-id vpn-1122334455aabbccd \
    --local-ipv4-network-cidr 10.0.0.0/16

出力:

{
    "VpnConnections": [
        {
            "CustomerGatewayConfiguration": "...configuration information...",
            "CustomerGatewayId": "cgw-01234567abcde1234",
            "Category": "VPN",
            "State": "modifying",
            "Type": "ipsec.1",
            "VpnConnectionId": "vpn-1122334455aabbccd",
            "TransitGatewayId": "tgw-00112233445566aab",
            "Options": {
                "EnableAcceleration": false,
                "StaticRoutesOnly": true,
                "LocalIpv4NetworkCidr": "10.0.0.0/16",
                "RemoteIpv4NetworkCidr": "0.0.0.0/0",
                "TunnelInsideIpVersion": "ipv4"
            },
            "Routes": [],
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "CanadaVPN"
                }
            ],
            "VgwTelemetry": [
                {
                    "AcceptedRouteCount": 0,
                    "LastStatusChange": "2020-07-29T10:35:11.000Z",
                    "OutsideIpAddress": "203.0.113.3",
                    "Status": "DOWN",
                    "StatusMessage": ""
                },
                {
                    "AcceptedRouteCount": 0,
                    "LastStatusChange": "2020-09-02T09:09:33.000Z",
                    "OutsideIpAddress": "203.0.113.5",
                    "Status": "UP",
                    "StatusMessage": ""
                }
            ]
        }
    ]
}

詳細については、 Site-to-Site ユーザーガイドの「Site-to-Site VPN接続オプションの変更」を参照してください。 AWS VPN

  • API 詳細については、「 コマンドリファレンスModifyVpnConnectionOptions」の「」を参照してください。 AWS CLI

次の例は、modify-vpn-connection を使用する方法を説明しています。

AWS CLI

VPN接続を変更するには

次のmodify-vpn-connection例では、仮想プライベートゲートウェイ VPNvpn-12345678901234567への接続のターゲットゲートウェイを変更しますvgw-11223344556677889。

aws ec2 modify-vpn-connection \
    --vpn-connection-id vpn-12345678901234567 \
    --vpn-gateway-id vgw-11223344556677889

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "...configuration information...",
        "CustomerGatewayId": "cgw-aabbccddee1122334",
        "Category": "VPN",
        "State": "modifying",
        "Type": "ipsec.1",
        "VpnConnectionId": "vpn-12345678901234567",
        "VpnGatewayId": "vgw-11223344556677889",
        "Options": {
            "StaticRoutesOnly": false
        },
        "VgwTelemetry": [
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-07-17T07:34:00.000Z",
                "OutsideIpAddress": "18.210.3.222",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN"
            },
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-07-20T21:20:16.000Z",
                "OutsideIpAddress": "34.193.129.33",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN"
            }
        ]
    }
}

  • API 詳細については、「 コマンドリファレンスModifyVpnConnection」の「」を参照してください。 AWS CLI

次のコード例は、modify-vpn-tunnel-certificate を使用する方法を示しています。

AWS CLI

VPNトンネル証明書をローテーションするには

次のmodify-vpn-tunnel-certificate例では、VPN接続の指定されたトンネルの証明書をローテーションします。

aws ec2 modify-vpn-tunnel-certificate \
    --vpn-tunnel-outside-ip-address 203.0.113.17 \
    --vpn-connection-id vpn-12345678901234567

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": ...configuration information...,
        "CustomerGatewayId": "cgw-aabbccddee1122334",
        "Category": "VPN",
        "State": "modifying",
        "Type": "ipsec.1",
        "VpnConnectionId": "vpn-12345678901234567",
        "VpnGatewayId": "vgw-11223344556677889",
        "Options": {
            "StaticRoutesOnly": false
        },
        "VgwTelemetry": [
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-09-11T17:27:14.000Z",
                "OutsideIpAddress": "203.0.113.17",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN",
                "CertificateArn": "arn:aws:acm:us-east-1:123456789101:certificate/c544d8ce-20b8-4fff-98b0-example"
            },
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-09-11T17:26:47.000Z",
                "OutsideIpAddress": "203.0.114.18",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN",
                "CertificateArn": "arn:aws:acm:us-east-1:123456789101:certificate/5ab64566-761b-4ad3-b259-example"
            }
        ]
    }
}

  • API 詳細については、「 コマンドリファレンスModifyVpnTunnelCertificate」の「」を参照してください。 AWS CLI

次の例は、modify-vpn-tunnel-options を使用する方法を説明しています。

AWS CLI

VPN接続のトンネルオプションを変更するには

次のmodify-vpn-tunnel-options例では、指定されたトンネルとVPN接続で許可される Diffie-Hellman グループを更新します。

aws ec2 modify-vpn-tunnel-options \
    --vpn-connection-id vpn-12345678901234567 \
    --vpn-tunnel-outside-ip-address 203.0.113.17 \
    --tunnel-options Phase1DHGroupNumbers=[{Value=14},{Value=15},{Value=16},{Value=17},{Value=18}],Phase2DHGroupNumbers=[{Value=14},{Value=15},{Value=16},{Value=17},{Value=18}]

出力:

{
    "VpnConnection": {
        "CustomerGatewayConfiguration": "...configuration information...",
        "CustomerGatewayId": "cgw-aabbccddee1122334",
        "Category": "VPN",
        "State": "available",
        "Type": "ipsec.1",
        "VpnConnectionId": "vpn-12345678901234567",
        "VpnGatewayId": "vgw-11223344556677889",
        "Options": {
            "StaticRoutesOnly": false,
            "TunnelOptions": [
                {
                    "OutsideIpAddress": "203.0.113.17",
                    "Phase1DHGroupNumbers": [
                        {
                            "Value": 14
                        },
                        {
                            "Value": 15
                        },
                        {
                            "Value": 16
                        },
                        {
                            "Value": 17
                        },
                        {
                            "Value": 18
                        }
                    ],
                    "Phase2DHGroupNumbers": [
                        {
                            "Value": 14
                        },
                        {
                            "Value": 15
                        },
                        {
                            "Value": 16
                        },
                        {
                            "Value": 17
                        },
                        {
                            "Value": 18
                        }
                    ]
                },
                {
                    "OutsideIpAddress": "203.0.114.19"
                }
            ]
        },
        "VgwTelemetry": [
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-09-10T21:56:54.000Z",
                "OutsideIpAddress": "203.0.113.17",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN"
            },
            {
                "AcceptedRouteCount": 0,
                "LastStatusChange": "2019-09-10T21:56:43.000Z",
                "OutsideIpAddress": "203.0.114.19",
                "Status": "DOWN",
                "StatusMessage": "IPSEC IS DOWN"
            }
        ]
    }
}

  • API 詳細については、「 コマンドリファレンスModifyVpnTunnelOptions」の「」を参照してください。 AWS CLI

次のコード例は、monitor-instances を使用する方法を示しています。

AWS CLI

インスタンスの詳細モニタリングを有効にするには

このコマンド例は、指定されたインスタンスの詳細モニタリングを有効にします。

コマンド:

aws ec2 monitor-instances --instance-ids i-1234567890abcdef0

出力:

{
  "InstanceMonitorings": [
      {
          "InstanceId": "i-1234567890abcdef0",
          "Monitoring": {
              "State": "pending"
          }
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスMonitorInstances」の「」を参照してください。 AWS CLI

次の例は、move-address-to-vpc を使用する方法を説明しています。

AWS CLI

アドレスを EC2- に移動するにはVPC

この例では、Elastic IP アドレス 54.123.4.56 を EC2-VPC プラットフォームに移動します。

コマンド:

aws ec2 move-address-to-vpc --public-ip 54.123.4.56

出力:

{
  "Status": "MoveInProgress"
}

  • API 詳細については、「 コマンドリファレンスMoveAddressToVpc」の「」を参照してください。 AWS CLI

次のコード例は、move-byoip-cidr-to-ipam を使用する方法を示しています。

AWS CLI

BYOIPCIDRを に転送するには IPAM

次のmove-byoip-cidr-to-ipam例では、 BYOIPCIDRを に転送しますIPAM。

(Linux):

aws ec2 move-byoip-cidr-to-ipam \
    --region us-west-2 \
    --ipam-pool-id ipam-pool-0a03d430ca3f5c035 \
    --ipam-pool-owner 111111111111 \
    --cidr 130.137.249.0/24

(Windows):

aws ec2 move-byoip-cidr-to-ipam ^
    --region us-west-2 ^
    --ipam-pool-id ipam-pool-0a03d430ca3f5c035 ^
    --ipam-pool-owner 111111111111 ^
    --cidr 130.137.249.0/24

出力:

{
    "ByoipCidr": {
        "Cidr": "130.137.249.0/24",
        "State": "pending-transfer"
    }
}

詳細については、「Amazon ユーザーガイド」の「チュートリアル: 既存の を BYOIPIPv4CIDRIPAMに転送する」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスMoveByoipCidrToIpam」の「」を参照してください。 AWS CLI

次のコード例は、network-insights-access-scope を使用する方法を示しています。

AWS CLI

Network Insights アクセススコープを作成するには

次のcreate-network-insights-access-scope例では、 AWS アカウントにネットワークインサイトアクセススコープを作成します。

aws ec2 create-network-insights-access-scope \
    --cli-input-json file://access-scope-file.json

access-scope-file.json の内容:

{
    {
        "MatchPaths": [
            {
                "Source": {
                    "ResourceStatement": {
                         "Resources": [
                            "vpc-abcd12e3"
                        ]
                    }
                }
            }
        ],
        "ExcludePaths": [
            {
                "Source": {
                    "ResourceStatement": {
                        "ResourceTypes": [
                            "AWS::EC2::InternetGateway"
                        ]
                    }
                }
            }
        ]
    }
}

出力:

{
    "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789111"
    }{
    "NetworkInsightsAccessScope": {
        "NetworkInsightsAccessScopeId": "nis-123456789222",
        "NetworkInsightsAccessScopeArn": "arn:aws:ec2:us-east-1:123456789222:network-insights-access-scope/nis-123456789222",
        "CreatedDate": "2022-01-25T19:20:28.796000+00:00",
        "UpdatedDate": "2022-01-25T19:20:28.797000+00:00"
    },
    "NetworkInsightsAccessScopeContent": {
        "NetworkInsightsAccessScopeId": "nis-04c0c0fbca737c404",
        "MatchPaths": [
            {
                "Source": {
                    "ResourceStatement": {
                        "Resources": [
                            "vpc-abcd12e3"
                        ]
                    }
                }
            }
        ],
        "ExcludePaths": [
            {
                "Source": {
                    "ResourceStatement": {
                        "ResourceTypes": [
                            "AWS::EC2::InternetGateway"
                        ]
                    }
                }
            }
        ]
    }
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

  • API 詳細については、「 コマンドリファレンスNetworkInsightsAccessScope」の「」を参照してください。 AWS CLI

次の例は、provision-byoip-cidr を使用する方法を説明しています。

AWS CLI

アドレス範囲をプロビジョニングするには

次のprovision-byoip-cidr例では、 で使用するパブリック IP アドレス範囲をプロビジョニングします AWS。

aws ec2 provision-byoip-cidr \
    --cidr 203.0.113.25/24 \
    --cidr-authorization-context Message="$text_message",Signature="$signed_message"

出力:

{
    "ByoipCidr": {
        "Cidr": "203.0.113.25/24",
        "State": "pending-provision"
    }
}

認証コンテキストのメッセージ文字列の作成の詳細については、「Amazon EC2 ユーザーガイド」の「独自の IP アドレスを使用する」を参照してください。

  • API 詳細については、「 コマンドリファレンスProvisionByoipCidr」の「」を参照してください。 AWS CLI

次のコード例は、provision-ipam-pool-cidr を使用する方法を示しています。

AWS CLI

をIPAMプールCIDRにプロビジョニングするには

次のprovision-ipam-pool-cidr例では、 を IPAM プールCIDRにプロビジョニングします。

(Linux):

aws ec2 provision-ipam-pool-cidr \
    --ipam-pool-id ipam-pool-0533048da7d823723 \
    --cidr 10.0.0.0/24

(Windows):

aws ec2 provision-ipam-pool-cidr ^
    --ipam-pool-id ipam-pool-0533048da7d823723 ^
    --cidr 10.0.0.0/24

出力:

{
    "IpamPoolCidr": {
        "Cidr": "10.0.0.0/24",
        "State": "pending-provision"
    }
}

詳細については、「Amazon ユーザーガイド」の「プールCIDRsへのプロビジョニング」を参照してください。 VPC IPAM

  • API 詳細については、「 コマンドリファレンスProvisionIpamPoolCidr」の「」を参照してください。 AWS CLI

次の例は、purchase-host-reservation を使用する方法を説明しています。

AWS CLI

Dedicated Host 予約を購入するには

この例では、アカウント内の指定された Dedicated Host に対して指定された Dedicated Host 予約サービスを購入します。

コマンド:

aws ec2 purchase-host-reservation --offering-id hro-03f707bf363b6b324 --host-id-set h-013abcd2a00cbd123

出力:

{
  "TotalHourlyPrice": "1.499",
  "Purchase": [
      {
          "HourlyPrice": "1.499",
          "InstanceFamily": "m4",
          "PaymentOption": "NoUpfront",
          "HostIdSet": [
              "h-013abcd2a00cbd123"
          ],
          "HostReservationId": "hr-0d418a3a4ffc669ae",
          "UpfrontPrice": "0.000",
          "Duration": 31536000
      }
  ],
  "TotalUpfrontPrice": "0.000"
}

  • API 詳細については、「 コマンドリファレンスPurchaseHostReservation」の「」を参照してください。 AWS CLI

次のコード例は、purchase-reserved-instances-offering を使用する方法を示しています。

AWS CLI

リザーブドインスタンス サービスを購入するには

このコマンド例は、リザーブドインスタンス サービスの購入を示し、サービス ID とインスタンス数を指定します。

コマンド:

aws ec2 purchase-reserved-instances-offering --reserved-instances-offering-id ec06327e-dd07-46ee-9398-75b5fexample --instance-count 3

出力:

{
  "ReservedInstancesId": "af9f760e-6f91-4559-85f7-4980eexample"
}

次のコード例は、purchase-scheduled-instances を使用する方法を示しています。

AWS CLI

スケジュールされたインスタンスを購入するには

この例では、スケジュールされたインスタンスを購入します。

コマンド:

aws ec2 purchase-scheduled-instances --purchase-requests file://purchase-request.json

購入リクエスト.json:

[
    {
        "PurchaseToken": "eyJ2IjoiMSIsInMiOjEsImMiOi...",
        "InstanceCount": 1
    }
]

出力:

{
  "ScheduledInstanceSet": [
      {
          "AvailabilityZone": "us-west-2b",
          "ScheduledInstanceId": "sci-1234-1234-1234-1234-123456789012",
          "HourlyPrice": "0.095",
          "CreateDate": "2016-01-25T21:43:38.612Z",
          "Recurrence": {
              "OccurrenceDaySet": [
                  1
              ],
              "Interval": 1,
              "Frequency": "Weekly",
              "OccurrenceRelativeToEnd": false,
              "OccurrenceUnit": ""
          },
          "Platform": "Linux/UNIX",
          "TermEndDate": "2017-01-31T09:00:00Z",
          "InstanceCount": 1,
          "SlotDurationInHours": 32,
          "TermStartDate": "2016-01-31T09:00:00Z",
          "NetworkPlatform": "EC2-VPC",
          "TotalScheduledInstanceHours": 1696,
          "NextSlotStartTime": "2016-01-31T09:00:00Z",
          "InstanceType": "c4.large"
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスPurchaseScheduledInstances」の「」を参照してください。 AWS CLI

次の例は、reboot-instances を使用する方法を説明しています。

AWS CLI

Amazon EC2インスタンスを再起動するには

この例では、指定のインスタンスを再起動します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 reboot-instances --instance-ids i-1234567890abcdef5

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」でインスタンスの再起動方法を参照してください。

  • API 詳細については、「 コマンドリファレンスRebootInstances」の「」を参照してください。 AWS CLI

次の例は、register-image を使用する方法を説明しています。

AWS CLI

例 1: マニフェストファイルAMIを使用して を登録するには

次のregister-image例では、Amazon S3 で指定されたマニフェストファイルAMIを使用して を登録します。 Amazon S3

aws ec2 register-image \
    --name my-image \
    --image-location my-s3-bucket/myimage/image.manifest.xml

出力:

{
    "ImageId": "ami-1234567890EXAMPLE"
}

詳細については、「Amazon ユーザーガイド」の「Amazon マシンイメージ (AMI）」を参照してください。 EC2

例 2: ルートデバイスのスナップショットAMIを使用して を登録するには

次のregister-image例では、EBSルートボリュームの指定されたスナップショットAMIをデバイス として使用して を登録します/dev/xvda。ブロックデバイスマッピングには、デバイス として空の 100 GiB EBSボリュームも含まれます/dev/xvdf。

aws ec2 register-image \
    --name my-image \
    --root-device-name /dev/xvda \
    --block-device-mappings DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0db2cf683925d191f} DeviceName=/dev/xvdf,Ebs={VolumeSize=100}

出力:

{
    "ImageId": "ami-1a2b3c4d5eEXAMPLE"
}

詳細については、「Amazon ユーザーガイド」の「Amazon マシンイメージ (AMI）」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスRegisterImage」の「」を参照してください。 AWS CLI

次の例は、register-instance-event-notification-attributes を使用する方法を説明しています。

AWS CLI

例 1: イベント通知にすべてのタグを含めるには

次のregister-instance-event-notification-attributes例では、イベント通知にすべてのタグを含めます。

aws ec2 register-instance-event-notification-attributes \
    --instance-tag-attribute IncludeAllTagsOfInstance=true

出力:

{
    "InstanceTagAttribute": {
        "InstanceTagKeys": [],
        "IncludeAllTagsOfInstance": true
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのスケジュールされたイベント」を参照してください。

例 2: イベント通知に特定のタグを含めるには

次のregister-instance-event-notification-attributes例では、イベント通知に指定されたタグを含めます。が の場合IncludeAllTagsOfInstance、タグを指定することはできませんtrue。

aws ec2 register-instance-event-notification-attributes \
    --instance-tag-attribute InstanceTagKeys="tag-key1","tag-key2"

出力:

{
    "InstanceTagAttribute": {
        "InstanceTagKeys": [
            "tag-key1",
            "tag-key2"
        ],
        "IncludeAllTagsOfInstance": false
    }
}

詳細については、「Linux インスタンス用 Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスのスケジュールされたイベント」を参照してください。

次のコード例は、register-transit-gateway-multicase-group-sources を使用する方法を示しています。

AWS CLI

ソースをトランジットゲートウェイマルチキャストグループに登録するには。

次のregister-transit-gateway-multicast-group-sources例では、指定されたネットワークインターフェイスグループソースをマルチキャストグループに登録します。

aws ec2 register-transit-gateway-multicast-group-sources \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \
    --group-ip-address 224.0.1.0 \
    --network-interface-ids eni-07f290fc3c090cbae

出力:

{
    "RegisteredMulticastGroupSources": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597",
        "RegisteredNetworkInterfaceIds": [
            "eni-07f290fc3c090cbae"
        ],
        "GroupIpAddress": "224.0.1.0"
    }
}

詳細については、「 Transit Gateways ユーザーガイド」の「マルチキャストグループへのソースの登録AWS 」を参照してください。

次の例は、register-transit-gateway-multicast-group-members を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイマルチキャストドメインの関連付けに関する情報を表示するには

次のregister-transit-gateway-multicast-group-members例では、指定されたマルチキャストドメインの関連付けを返します。

aws ec2 register-transit-gateway-multicast-group-members \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \
    --group-ip-address 224.0.1.0 \
    --network-interface-ids eni-0e246d32695012e81

出力:

{
    "RegisteredMulticastGroupMembers": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597",
        "RegisteredNetworkInterfaceIds": [
            "eni-0e246d32695012e81"
        ],
        "GroupIpAddress": "224.0.1.0"
    }
}

詳細については、「Transit Gateways ユーザーガイド」の「マルチキャストドメインの管理」を参照してください。

次のコード例は、register-transit-gateway-multicast-group-sources を使用する方法を示しています。

AWS CLI

ソースをトランジットゲートウェイマルチキャストグループに登録するには。

次のregister-transit-gateway-multicast-group-sources例では、指定されたネットワークインターフェイスグループソースをマルチキャストグループに登録します。

aws ec2 register-transit-gateway-multicast-group-sources \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-0c4905cef79d6e597 \
    --group-ip-address 224.0.1.0 \
    --network-interface-ids eni-07f290fc3c090cbae

出力:

{
    "RegisteredMulticastGroupSources": {
        "TransitGatewayMulticastDomainId": "tgw-mcast-domain-0c4905cef79d6e597",
        "RegisteredNetworkInterfaceIds": [
            "eni-07f290fc3c090cbae"
        ],
        "GroupIpAddress": "224.0.1.0"
    }
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストドメインの管理」を参照してください。

次の例は、reject-transit-gateway-peering-attachment を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイピアリングアタッチメントを拒否するには

次のreject-transit-gateway-peering-attachment例では、指定された Transit Gateway ピアリングアタッチメントリクエストを拒否します。--region パラメータは、アクセプタトランジットゲートウェイがあるリージョンを指定します。

aws ec2 reject-transit-gateway-peering-attachment \
    --transit-gateway-attachment-id tgw-attach-4455667788aabbccd \
    --region us-east-2

出力:

{
    "TransitGatewayPeeringAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-4455667788aabbccd",
        "RequesterTgwInfo": {
            "TransitGatewayId": "tgw-123abc05e04123abc",
            "OwnerId": "123456789012",
            "Region": "us-west-2"
        },
        "AccepterTgwInfo": {
            "TransitGatewayId": "tgw-11223344aabbcc112",
            "OwnerId": "123456789012",
            "Region": "us-east-2"
        },
        "State": "rejecting",
        "CreationTime": "2019-12-09T11:50:31.000Z"
    }
}

詳細については、「 Transit Gateways ガイド」の「Transit Gateway ピアリングアタッチメント」を参照してください。

次のコード例は、reject-transit-gateway-vpc-attachment を使用する方法を示しています。

AWS CLI

トランジットゲートウェイアタッチメントを拒否するには VPC

次のreject-transit-gateway-vpc-attachment例では、指定された Transit Gateway VPCアタッチメントを拒否します。

aws ec2 reject-transit-gateway-vpc-attachment \
    --transit-gateway-attachment-id tgw-attach-0a34fe6b4fEXAMPLE

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE",
        "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
        "VpcId": "vpc-07e8ffd50fEXAMPLE",
        "VpcOwnerId": "111122223333",
        "State": "pending",
        "SubnetIds": [
            "subnet-0752213d59EXAMPLE"
        ],
        "CreationTime": "2019-07-10T17:33:46.000Z",
        "Options": {
            "DnsSupport": "enable",
            "Ipv6Support": "disable"
        }
    }
}

詳細については、「 Transit Gateways ガイドVPC」の「 への Transit Gateway アタッチメント」を参照してください。

次の例は、reject-transit-gateway-vpc-attachments を使用する方法を説明しています。

AWS CLI

トランジットゲートウェイアタッチメントを拒否するには VPC

次のreject-transit-gateway-vpc-attachment例では、指定された Transit Gateway VPCアタッチメントを拒否します。

aws ec2 reject-transit-gateway-vpc-attachment \
    --transit-gateway-attachment-id tgw-attach-0a34fe6b4fEXAMPLE

出力:

{
    "TransitGatewayVpcAttachment": {
        "TransitGatewayAttachmentId": "tgw-attach-0a34fe6b4fEXAMPLE",
        "TransitGatewayId": "tgw-0262a0e521EXAMPLE",
        "VpcId": "vpc-07e8ffd50fEXAMPLE",
        "VpcOwnerId": "111122223333",
        "State": "pending",
        "SubnetIds": [
            "subnet-0752213d59EXAMPLE"
        ],
        "CreationTime": "2019-07-10T17:33:46.000Z",
        "Options": {
            "DnsSupport": "enable",
            "Ipv6Support": "disable"
        }
    }
}

詳細については、「 Transit Gateways ガイドVPC」の「 への Transit Gateway アタッチメント」を参照してください。

次のコード例は、reject-vpc-endpoint-connections を使用する方法を示しています。

AWS CLI

インターフェイスエンドポイント接続リクエストを拒否するには

この例では、指定されたエンドポイントサービスに対して指定されたエンドポイント接続リクエストを拒否します。

コマンド:

aws ec2 reject-vpc-endpoint-connections --service-id vpce-svc-03d5ebb7d9579a2b3 --vpc-endpoint-ids vpce-0c1308d7312217abc

出力:

{
  "Unsuccessful": []
}

  • API 詳細については、「 コマンドリファレンスRejectVpcEndpointConnections」の「」を参照してください。 AWS CLI

次のコード例は、reject-vpc-peering-connection を使用する方法を示しています。

AWS CLI

VPCピアリング接続を拒否するには

この例では、指定されたVPCピアリング接続リクエストを拒否します。

コマンド:

aws ec2 reject-vpc-peering-connection --vpc-peering-connection-id pcx-1a2b3c4d

出力:

{
    "Return": true
}

  • API 詳細については、「 コマンドリファレンスRejectVpcPeeringConnection」の「」を参照してください。 AWS CLI

次のコード例は、release-address を使用する方法を示しています。

AWS CLI

EC2-Classic の Elastic IP アドレスを解放するには

この例では、EC2-Classic のインスタンスで使用する Elastic IP アドレスをリリースします。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 release-address --public-ip 198.51.100.0

EC2- の Elastic IP アドレスを解放するにはVPC

この例では、 のインスタンスで使用する Elastic IP アドレスをリリースしますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 release-address --allocation-id eipalloc-64d5890a

  • API 詳細については、「 コマンドリファレンスReleaseAddress」の「」を参照してください。 AWS CLI

次の例は、release-hosts を使用する方法を説明しています。

AWS CLI

アカウントから専有ホストを解放するには

アカウントから専有ホストを解放するには。ホスト上にあるインスタンスは、ホストを解放する前に停止または終了する必要があります。

コマンド:

aws ec2 release-hosts --host-id=h-0029d6e3cacf1b3da

出力:

{
    "Successful":  [
        "h-0029d6e3cacf1b3da"
         ],
  "Unsuccessful": []

 }

  • API 詳細については、「 コマンドリファレンスReleaseHosts」の「」を参照してください。 AWS CLI

次のコード例は、release-ipam-pool-allocation を使用する方法を示しています。

AWS CLI

IPAM プール割り当てを解放するには

この例では、プールを削除しようとしたが、IPAMプールに割り当てがある間はプールを削除できないというエラーを受け取ったIPAM委任管理者です。このコマンドを使用してプール割り当てを解放します。

次の点に注意してください。

このコマンドはカスタム割り当てにのみ使用できます。リソースを削除せずにリソースの割り当てを削除するには、 を使用してモニタリング状態を false に設定しますmodify-ipam-resource-cidr。このリクエストを完了するには、 で取得できるIPAMプール ID が必要ですdescribe-ipam-pools。また、 で取得できる割り当て ID も必要ですget-ipam-pool-allocations。割り当てを 1 つずつ削除しない場合は、IPAMプールを削除する--cascade optionときに を使用して、プール内の割り当てをすべて自動的に解放できます。このコマンドを実行する前に、いくつかの前提条件があります。詳細については、「Amazon VPCIPAMユーザーガイド」の--region「割り当てを解放する」を参照してください。このコマンドを実行する は、割り当てがあるIPAMプールのロケールである必要があります。

次のrelease-ipam-pool-allocation例では、IPAMプール割り当てをリリースします。

aws ec2 release-ipam-pool-allocation \
    --ipam-pool-id ipam-pool-07bdd12d7c94e4693 \
    --cidr 10.0.0.0/23 \
    --ipam-pool-allocation-id ipam-pool-alloc-0e66a1f730da54791b99465b79e7d1e89 \
    --region us-west-1

出力:

{
    "Success": true
}

割り当てを解放したら、 を実行することができますdelete-ipam-pool。

  • API 詳細については、「 コマンドリファレンスReleaseIpamPoolAllocation」の「」を参照してください。 AWS CLI

次の例は、replace-iam-instance-profile-association を使用する方法を説明しています。

AWS CLI

IAMインスタンスのインスタンスプロファイルを置き換えるには

この例では、 の関連付けで表されるIAMインスタンスプロファイルを、 という名前iip-assoc-060bae234aac2e7faのIAMインスタンスプロファイルに置き換えますAdminRole。

aws ec2 replace-iam-instance-profile-association \
    --iam-instance-profile Name=AdminRole \
    --association-id iip-assoc-060bae234aac2e7fa

出力:

{
    "IamInstanceProfileAssociation": {
        "InstanceId": "i-087711ddaf98f9489",
        "State": "associating",
        "AssociationId": "iip-assoc-0b215292fab192820",
        "IamInstanceProfile": {
            "Id": "AIPAJLNLDX3AMYZNWYYAY",
            "Arn": "arn:aws:iam::123456789012:instance-profile/AdminRole"
        }
    }
}

次のコード例は、replace-network-acl-association を使用する方法を示しています。

AWS CLI

サブネットACLに関連付けられたネットワークを置き換えるには

この例では、指定されたネットワークACLを、指定されたネットワーク関連付けのサブネットACLに関連付けます。

コマンド:

aws ec2 replace-network-acl-association --association-id aclassoc-e5b95c8c --network-acl-id acl-5fb85d36

出力:

{
    "NewAssociationId": "aclassoc-3999875b"
}

  • API 詳細については、「 コマンドリファレンスReplaceNetworkAclAssociation」の「」を参照してください。 AWS CLI

次のコード例は、replace-network-acl-entry を使用する方法を示しています。

AWS CLI

ネットワークACLエントリを置き換えるには

この例では、指定されたネットワーク のエントリを置き換えますACL。新しいルール 100 では、UDPポート 53 (DNS) の 203.0.113.12/24 から関連するサブネットへのイングレストラフィックが許可されています。

コマンド:

aws ec2 replace-network-acl-entry --network-acl-id acl-5fb85d36 --ingress --rule-number 100 --protocol udp --port-range From=53,To=53 --cidr-block 203.0.113.12/24 --rule-action allow

  • API 詳細については、「 コマンドリファレンスReplaceNetworkAclEntry」の「」を参照してください。 AWS CLI

次の例は、replace-route-table-association を使用する方法を説明しています。

AWS CLI

サブネットに関連付けられているルートテーブルを置き換えるには

この例では、指定されたルートテーブルを、指定されたルートテーブルの関連付けのサブネットに関連付けます。

コマンド:

aws ec2 replace-route-table-association --association-id rtbassoc-781d0d1a --route-table-id rtb-22574640

出力:

{
    "NewAssociationId": "rtbassoc-3a1f0f58"
}

  • API 詳細については、「 コマンドリファレンスReplaceRouteTableAssociation」の「」を参照してください。 AWS CLI

次のコード例は、replace-route を使用する方法を示しています。

AWS CLI

ルートを置き換えるには

この例では、指定されたルートテーブル内の指定されたルートを置き換えます。新しいルートは、指定された に一致しCIDR、指定された仮想プライベートゲートウェイにトラフィックを送信します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 replace-route --route-table-id rtb-22574640 --destination-cidr-block 10.0.0.0/16 --gateway-id vgw-9a4cacf3

  • API 詳細については、「 コマンドリファレンスReplaceRoute」の「」を参照してください。 AWS CLI

次の例は、replace-transit-gateway-route を使用する方法を説明しています。

AWS CLI

指定された Transit Gateway ルートテーブル内の指定されたルートを置き換えるには

次のreplace-transit-gateway-route例では、指定された Transit Gateway ルートテーブルのルートを置き換えます。

aws ec2 replace-transit-gateway-route \
    --destination-cidr-block 10.0.2.0/24 \
    --transit-gateway-attachment-id tgw-attach-09b52ccdb5EXAMPLE \
    --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE

出力:

{
    "Route": {
        "DestinationCidrBlock": "10.0.2.0/24",
        "TransitGatewayAttachments": [
            {
                "ResourceId": "vpc-4EXAMPLE",
                "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
                "ResourceType": "vpc"
            }
        ],
        "Type": "static",
        "State": "active"
    }
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

  • API 詳細については、「 コマンドリファレンスReplaceTransitGatewayRoute」の「」を参照してください。 AWS CLI

次のコード例は、report-instance-status を使用する方法を示しています。

AWS CLI

インスタンスのステータスフィードバックを報告するには

このコマンド例は、指定されたインスタンスのステータスフィードバックを報告します。

コマンド:

aws ec2 report-instance-status --instances i-1234567890abcdef0 --status impaired --reason-codes unresponsive

  • API 詳細については、「 コマンドリファレンスReportInstanceStatus」の「」を参照してください。 AWS CLI

次の例は、request-spot-fleet を使用する方法を説明しています。

AWS CLI

最低料金でサブネット内のスポットフリートをリクエストするには

このコマンド例では、サブネットによってのみ異なる 2 つの起動仕様を持つスポットフリートリクエストを作成します。スポットフリートは、最低料金で指定されたサブネットでインスタンスを起動します。インスタンスがデフォルトの で起動されるとVPC、デフォルトでパブリック IP アドレスを受け取ります。インスタンスがデフォルト以外の で起動された場合VPC、デフォルトではパブリック IP アドレスは受信されません。

スポットフリートリクエストでは、同じアベイラビリティーゾーンから異なるサブネットを指定することはできません。

コマンド:

aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json

Config.json:

{
  "SpotPrice": "0.04",
  "TargetCapacity": 2,
  "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
  "LaunchSpecifications": [
      {
          "ImageId": "ami-1a2b3c4d",
          "KeyName": "my-key-pair",
          "SecurityGroups": [
              {
                  "GroupId": "sg-1a2b3c4d"
              }
          ],
          "InstanceType": "m3.medium",
          "SubnetId": "subnet-1a2b3c4d, subnet-3c4d5e6f",
          "IamInstanceProfile": {
              "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
          }
      }
  ]
}

出力:

{
  "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE"
}

最低価格のアベイラビリティーゾーンでスポットフリートをリクエストするには

このコマンド例では、アベイラビリティーゾーンによってのみ異なる 2 つの起動仕様を持つスポットフリートリクエストを作成します。スポットフリートは、指定されたアベイラビリティーゾーンで最低料金でインスタンスを起動します。アカウントが EC2-VPC のみをサポートしている場合、Amazon はアベイラビリティーゾーンのデフォルトサブネットでスポットインスタンスEC2を起動します。アカウントが EC2-Classic をサポートしている場合、Amazon はアベイラビリティーゾーンの EC2-Classic でインスタンスEC2を起動します。

コマンド:

aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json

Config.json:

{
  "SpotPrice": "0.04",
  "TargetCapacity": 2,
  "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
  "LaunchSpecifications": [
      {
          "ImageId": "ami-1a2b3c4d",
          "KeyName": "my-key-pair",
          "SecurityGroups": [
              {
                  "GroupId": "sg-1a2b3c4d"
              }
          ],
          "InstanceType": "m3.medium",
          "Placement": {
              "AvailabilityZone": "us-west-2a, us-west-2b"
          },
          "IamInstanceProfile": {
              "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
          }
      }
  ]
}

サブネットでスポットインスタンスを起動し、パブリック IP アドレスを割り当てるには

このコマンド例では、デフォルト以外の で起動されたインスタンスにパブリックアドレスを割り当てますVPC。ネットワークインターフェイスを指定するときは、ネットワークインターフェイスを使用してサブネット ID とセキュリティグループ ID を含める必要があることに注意してください。

コマンド:

aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json

Config.json:

{
  "SpotPrice": "0.04",
  "TargetCapacity": 2,
  "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
  "LaunchSpecifications": [
      {
          "ImageId": "ami-1a2b3c4d",
          "KeyName": "my-key-pair",
          "InstanceType": "m3.medium",
          "NetworkInterfaces": [
              {
                  "DeviceIndex": 0,
                  "SubnetId": "subnet-1a2b3c4d",
                  "Groups": [ "sg-1a2b3c4d" ],
                  "AssociatePublicIpAddress": true
              }
          ],
          "IamInstanceProfile": {
              "Arn": "arn:aws:iam::880185128111:instance-profile/my-iam-role"
          }
      }
  ]
}

分散配分戦略を使用してスポットフリートをリクエストするには

このコマンド例では、分散配分戦略を使用して 30 個のインスタンスを起動するスポットフリートリクエストを作成します。起動仕様はインスタンスタイプによって異なります。スポットフリートは、各タイプのインスタンスが 10 個になるように、起動仕様全体にインスタンスを分散します。

コマンド:

aws ec2 request-spot-fleet --spot-fleet-request-config file://config.json

Config.json:

{
  "SpotPrice": "0.70",
  "TargetCapacity": 30,
  "AllocationStrategy": "diversified",
  "IamFleetRole": "arn:aws:iam::123456789012:role/my-spot-fleet-role",
  "LaunchSpecifications": [
      {
          "ImageId": "ami-1a2b3c4d",
          "InstanceType": "c4.2xlarge",
          "SubnetId": "subnet-1a2b3c4d"
      },
      {
          "ImageId": "ami-1a2b3c4d",
          "InstanceType": "m3.2xlarge",
          "SubnetId": "subnet-1a2b3c4d"
      },
      {
          "ImageId": "ami-1a2b3c4d",
          "InstanceType": "r3.2xlarge",
          "SubnetId": "subnet-1a2b3c4d"
      }
  ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「スポットフリートリクエスト」を参照してください。

  • API 詳細については、「 コマンドリファレンスRequestSpotFleet」の「」を参照してください。 AWS CLI

次のコード例は、request-spot-instances を使用する方法を示しています。

AWS CLI

スポットインスタンスをリクエストするには

このコマンド例では、指定したアベイラビリティーゾーンの 5 つのインスタンスに対して 1 回限りのスポットインスタンスリクエストを作成します。アカウントが EC2-VPC のみをサポートしている場合、Amazon は指定されたアベイラビリティーゾーンのデフォルトサブネットでインスタンスEC2を起動します。アカウントが EC2-Classic をサポートしている場合、Amazon は指定されたアベイラビリティーゾーンの EC2-Classic でインスタンスEC2を起動します。

コマンド:

aws ec2 request-spot-instances --spot-price "0.03" --instance-count 5 --type "one-time" --launch-specification file://specification.json

Specification.json:

{
  "ImageId": "ami-1a2b3c4d",
  "KeyName": "my-key-pair",
  "SecurityGroupIds": [ "sg-1a2b3c4d" ],
  "InstanceType": "m3.medium",
  "Placement": {
    "AvailabilityZone": "us-west-2a"
  },
  "IamInstanceProfile": {
      "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
  }
}

出力:

{
  "SpotInstanceRequests": [
      {
          "Status": {
              "UpdateTime": "2014-03-25T20:54:21.000Z",
              "Code": "pending-evaluation",
              "Message": "Your Spot request has been submitted for review, and is pending evaluation."
          },
          "ProductDescription": "Linux/UNIX",
          "SpotInstanceRequestId": "sir-df6f405d",
          "State": "open",
          "LaunchSpecification": {
              "Placement": {
                  "AvailabilityZone": "us-west-2a"
              },
              "ImageId": "ami-1a2b3c4d",
              "KeyName": "my-key-pair",
              "SecurityGroups": [
                  {
                      "GroupName": "my-security-group",
                      "GroupId": "sg-1a2b3c4d"
                  }
              ],
              "Monitoring": {
                  "Enabled": false
              },
              "IamInstanceProfile": {
                  "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
              },
              "InstanceType": "m3.medium"
          },
          "Type": "one-time",
          "CreateTime": "2014-03-25T20:54:20.000Z",
          "SpotPrice": "0.050000"
      },
      ...
  ]
}

このコマンド例では、指定したサブネット内の 5 つのインスタンスに対して 1 回限りのスポットインスタンスリクエストを作成します。Amazon は、指定されたサブネットでインスタンスEC2を起動します。VPC がデフォルト以外の の場合VPC、インスタンスはデフォルトでパブリック IP アドレスを受信しません。

コマンド:

aws ec2 request-spot-instances --spot-price "0.050" --instance-count 5 --type "one-time" --launch-specification file://specification.json

Specification.json:

{
  "ImageId": "ami-1a2b3c4d",
  "SecurityGroupIds": [ "sg-1a2b3c4d" ],
  "InstanceType": "m3.medium",
  "SubnetId": "subnet-1a2b3c4d",
  "IamInstanceProfile": {
      "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
  }
}

出力:

{
  "SpotInstanceRequests": [
      {
          "Status": {
             "UpdateTime": "2014-03-25T22:21:58.000Z",
             "Code": "pending-evaluation",
             "Message": "Your Spot request has been submitted for review, and is pending evaluation."
          },
          "ProductDescription": "Linux/UNIX",
          "SpotInstanceRequestId": "sir-df6f405d",
          "State": "open",
          "LaunchSpecification": {
             "Placement": {
                 "AvailabilityZone": "us-west-2a"
             }
             "ImageId": "ami-1a2b3c4d"
             "SecurityGroups": [
                 {
                     "GroupName": "my-security-group",
                     "GroupID": "sg-1a2b3c4d"
                 }
             ]
             "SubnetId": "subnet-1a2b3c4d",
             "Monitoring": {
                 "Enabled": false
             },
             "IamInstanceProfile": {
                 "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
             },
             "InstanceType": "m3.medium",
         },
         "Type": "one-time",
         "CreateTime": "2014-03-25T22:21:58.000Z",
         "SpotPrice": "0.050000"
      },
      ...
  ]
}

この例では、デフォルト以外の で起動するスポットインスタンスにパブリック IP アドレスを割り当てますVPC。ネットワークインターフェイスを指定するときは、ネットワークインターフェイスを使用してサブネット ID とセキュリティグループ ID を含める必要があることに注意してください。

コマンド:

aws ec2 request-spot-instances --spot-price "0.050" --instance-count 1 --type "one-time" --launch-specification file://specification.json

Specification.json:

{
  "ImageId": "ami-1a2b3c4d",
  "KeyName": "my-key-pair",
  "InstanceType": "m3.medium",
  "NetworkInterfaces": [
    {
      "DeviceIndex": 0,
      "SubnetId": "subnet-1a2b3c4d",
      "Groups": [ "sg-1a2b3c4d" ],
      "AssociatePublicIpAddress": true
    }
  ],
  "IamInstanceProfile": {
      "Arn": "arn:aws:iam::123456789012:instance-profile/my-iam-role"
  }
}

  • API 詳細については、「 コマンドリファレンスRequestSpotInstances」の「」を参照してください。 AWS CLI

次のコード例は、reset-address-attribute を使用する方法を示しています。

AWS CLI

Elastic IP アドレスに関連付けられたドメイン名属性をリセットするには

次のreset-address-attribute例では、Elastic IP アドレスのドメイン名属性をリセットします。

Linux ：

aws ec2 reset-address-attribute \
    --allocation-id eipalloc-abcdef01234567890 \
    --attribute domain-name

Windows ：

aws ec2 reset-address-attribute ^
    --allocation-id eipalloc-abcdef01234567890 ^
    --attribute domain-name

出力:

{
    "Addresses": [
        {
            "PublicIp": "192.0.2.0",
            "AllocationId": "eipalloc-abcdef01234567890",
            "PtrRecord": "example.com."
            "PtrRecordUpdate": {
                "Value": "example.net.",
                "Status": "PENDING"
        }
    ]
}

保留中の変更をモニタリングするには、 コマンドリファレンスdescribe-addresses-attributeの「」を参照してください。 AWS CLI

  • API 詳細については、「 コマンドリファレンスResetAddressAttribute」の「」を参照してください。 AWS CLI

次のコード例は、reset-ebs-default-kms-key-id を使用する方法を示しています。

AWS CLI

EBS暗号化CMKのデフォルトをリセットするには

次のreset-ebs-default-kms-key-id例では、現在のリージョンの AWS アカウントのEBS暗号化CMKのデフォルトをリセットします。

aws ec2 reset-ebs-default-kms-key-id

出力:

{
   "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/8c5b2c63-b9bc-45a3-a87a-5513eEXAMPLE"
}

  • API 詳細については、「 コマンドリファレンスResetEbsDefaultKmsKeyId」の「」を参照してください。 AWS CLI

次の例は、reset-fpga-image-attribute を使用する方法を説明しています。

AWS CLI

Amazon FPGAイメージの属性をリセットするには

この例では、指定された のロード許可をリセットしますAFI。

コマンド:

aws ec2 reset-fpga-image-attribute --fpga-image-id afi-0d123e123bfc85abc --attribute loadPermission

出力:

{
  "Return": true
}

  • API 詳細については、「 コマンドリファレンスResetFpgaImageAttribute」の「」を参照してください。 AWS CLI

次の例は、reset-image-attribute を使用する方法を説明しています。

AWS CLI

launchPermission 属性をリセットするには

この例では、指定された の launchPermission 属性をデフォルト値AMIにリセットします。デフォルトでは、 AMIsはプライベートです。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 reset-image-attribute --image-id ami-5731123e --attribute launchPermission

  • API 詳細については、「 コマンドリファレンスResetImageAttribute」の「」を参照してください。 AWS CLI

次の例は、reset-instance-attribute を使用する方法を説明しています。

AWS CLI

sourceDestCheck 属性をリセットするには

この例では、指定されたインスタンスの sourceDestCheck 属性をリセットします。インスタンスは にある必要がありますVPC。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 reset-instance-attribute --instance-id i-1234567890abcdef0 --attribute sourceDestCheck

カーネル属性をリセットするには

この例では、指定されたインスタンスの kernel 属性をリセットします。インスタンスは stopped の状態である必要があります。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 reset-instance-attribute --instance-id i-1234567890abcdef0 --attribute kernel

ramdisk 属性をリセットするには

この例では、指定されたインスタンスの ramdisk 属性をリセットします。インスタンスは stopped の状態である必要があります。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 reset-instance-attribute --instance-id i-1234567890abcdef0 --attribute ramdisk

  • API 詳細については、「 コマンドリファレンスResetInstanceAttribute」の「」を参照してください。 AWS CLI

次のコード例は、reset-network-interface-attribute を使用する方法を示しています。

AWS CLI

ネットワークインターフェイス属性をリセットするには

次のreset-network-interface-attribute例では、送信元/送信先チェック属性の値を にリセットしますtrue。

aws ec2 reset-network-interface-attribute \
    --network-interface-id eni-686ea200 \
    --source-dest-check

このコマンドでは何も出力されません。

次の例は、reset-snapshot-attribute を使用する方法を説明しています。

AWS CLI

スナップショット属性をリセットするには

この例では、スナップショット のボリューム作成アクセス許可をリセットしますsnap-1234567890abcdef0。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 reset-snapshot-attribute --snapshot-id snap-1234567890abcdef0 --attribute createVolumePermission

  • API 詳細については、「 コマンドリファレンスResetSnapshotAttribute」の「」を参照してください。 AWS CLI

次のコード例は、restore-address-to-classic を使用する方法を示しています。

AWS CLI

アドレスを EC2-Classic に復元するには

この例では、Elastic IP アドレス 198.51.100.0 を EC2-Classic プラットフォームに復元します。

コマンド:

aws ec2 restore-address-to-classic --public-ip 198.51.100.0

出力:

{
  "Status": "MoveInProgress",
  "PublicIp": "198.51.100.0"
}

  • API 詳細については、「 コマンドリファレンスRestoreAddressToClassic」の「」を参照してください。 AWS CLI

次のコード例は、restore-image-from-recycle-bin を使用する方法を示しています。

AWS CLI

ごみ箱からイメージを復元するには

次のrestore-image-from-recycle-bin例では、ごみ箱から AMI ami-0111222333444abcd を復元します。

aws ec2 restore-image-from-recycle-bin \
    --image-id ami-0111222333444abcd

出力:

{
    "Return": true
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「ごみ箱AMIsからの復旧」を参照してください。

  • API 詳細については、「 コマンドリファレンスRestoreImageFromRecycleBin」の「」を参照してください。 AWS CLI

次の例は、restore-managed-prefix-list-version を使用する方法を説明しています。

AWS CLI

us-west-2**プレフィックスリストのバージョンを復元するには**

以下では、指定されたプレフィックスリストのバージョン 1 からエントリをrestore-managed-prefix-list-version復元します。

aws ec2 restore-managed-prefix-list-version \
    --prefix-list-id pl-0123456abcabcabc1 \
    --current-version 2 \
    --previous-version 1

出力:

{
    "PrefixList": {
        "PrefixListId": "pl-0123456abcabcabc1",
        "AddressFamily": "IPv4",
        "State": "restore-in-progress",
        "PrefixListArn": "arn:aws:ec2:us-west-2:123456789012:prefix-list/pl-0123456abcabcabc1",
        "PrefixListName": "vpc-cidrs",
        "MaxEntries": 10,
        "Version": 2,
        "OwnerId": "123456789012"
    }
}

詳細については、「Amazon VPCユーザーガイド」の「マネージドプレフィックスリスト」を参照してください。

次の例は、restore-snapshot-from-recycle-bin を使用する方法を説明しています。

AWS CLI

ごみ箱からスナップショットを復元するには

次のrestore-snapshot-from-recycle-bin例では、ごみ箱からスナップショットを復元します。ごみ箱からスナップショットを復元すると、そのスナップショットはすぐに使用でき、ごみ箱から削除されます。復元されたスナップショットは、アカウント内の他のスナップショットと同じ方法で使用できます。

aws ec2 restore-snapshot-from-recycle-bin \
    --snapshot-id snap-01234567890abcdef

このコマンドでは何も出力されません。

Amazon のごみ箱の詳細についてはEBS、「Amazon EC2ユーザーガイド」の「ごみ箱からスナップショットを復元する」を参照してください。

次のコード例は、restore-snapshot-tier を使用する方法を示しています。

AWS CLI

例 1: アーカイブされたスナップショットを永続的に復元するには

次のrestore-snapshot-tier例では、指定されたスナップショットを完全に復元します。を指定--snapshot-idし、 permanent-restoreオプションを含めます。

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf \
    --permanent-restore

出力:

{
    "SnapshotId": "snap-01234567890abcedf",
    "IsPermanentRestore": true
}

スナップショットのアーカイブの詳細については、「Amazon EC2ユーザーガイド」の「Amazon EBSスナップショットのアーカイブ <https://docs.aws.amazon.com AWS EC2//latestUserGuide//snapshot-archive.html>」を参照してください。

例 2: アーカイブされたスナップショットを一時的に復元するには

次のrestore-snapshot-tier例では、指定されたスナップショットを一時的に復元します。--permanent-restore オプションを省略します。を指定--snapshot-idし、 にはスナップショットを復元する日数temporary-restore-daysを指定します。 は日数で指定temporary-restore-daysする必要があります。指定できる範囲は 1から です180。値を指定しないと、デフォルトで 1 に設定されます。

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf \
    --temporary-restore-days 5

出力:

{
    "SnapshotId": "snap-01234567890abcedf",
    "RestoreDuration": 5,
    "IsPermanentRestore": false
}

スナップショットのアーカイブの詳細については、「Amazon EC2ユーザーガイド」の「Amazon EBSスナップショットのアーカイブ <https://docs.aws.amazon.com AWS EC2//latestUserGuide//snapshot-archive.html>」を参照してください。

例 3: 復元期間を変更するには

次のrestore-snapshot-tier例では、指定したスナップショットの復元期間を 10日間に変更します。

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf
    --temporary-restore-days 10

出力:

{
    "SnapshotId": "snap-01234567890abcedf",
    "RestoreDuration": 10,
    "IsPermanentRestore": false
}

スナップショットのアーカイブの詳細については、「Amazon EC2ユーザーガイド」の「Amazon EBSスナップショットのアーカイブ <https://docs.aws.amazon.com AWS EC2//latestUserGuide//snapshot-archive.html>」を参照してください。

例 4: 復元タイプを変更するには

次のrestore-snapshot-tier例では、指定されたスナップショットの復元タイプを一時から永続的に変更します。

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf
    --permanent-restore

出力:

{
    "SnapshotId": "snap-01234567890abcedf",
    "IsPermanentRestore": true
}

スナップショットのアーカイブの詳細については、「Amazon EC2ユーザーガイド」の「Amazon EBSスナップショットのアーカイブ <https://docs.aws.amazon.com AWS EC2//latestUserGuide//snapshot-archive.html>」を参照してください。

  • API 詳細については、「 コマンドリファレンスRestoreSnapshotTier」の「」を参照してください。 AWS CLI

次のコード例は、revoke-client-vpn-ingress を使用する方法を示しています。

AWS CLI

クライアントVPNエンドポイントの承認ルールを取り消すには

次のrevoke-client-vpn-ingress例では、すべてのグループのインターネットアクセス (0.0.0.0/0) のルールを取り消します。

aws ec2 revoke-client-vpn-ingress \
    --client-vpn-endpoint-id cvpn-endpoint-123456789123abcde \
    --target-network-cidr 0.0.0.0/0 --revoke-all-groups

出力:

{
    "Status": {
        "Code": "revoking"
    }
}

詳細については、AWS クライアントVPN管理者ガイドの「承認ルール」を参照してください。

  • API 詳細については、「 コマンドリファレンスRevokeClientVpnIngress」の「」を参照してください。 AWS CLI

次の例は、revoke-security-group-egress を使用する方法を説明しています。

AWS CLI

例 1: 特定のアドレス範囲へのアウトバウンドトラフィックを許可するルールを削除するには

次のコマンドrevoke-security-group-egress例では、TCPポート 80 で指定されたアドレス範囲へのアクセスを許可するルールを削除します。

aws ec2 revoke-security-group-egress \
    --group-id sg-026c12253ce15eff7 \
    --ip-permissions [{IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges=[{CidrIp=10.0.0.0/16}]

このコマンドでは何も出力されません。

詳細については、「Amazon ユーザーガイド」の「セキュリティグループ」を参照してください。 EC2

例 2: 特定のセキュリティグループへのアウトバウンドトラフィックを許可するルールを削除するには

次のコマンドrevoke-security-group-egress例では、TCPポート 80 で指定されたセキュリティグループへのアクセスを許可するルールを削除します。

aws ec2 revoke-security-group-egress \
    --group-id sg-026c12253ce15eff7 \
    --ip-permissions '[{"IpProtocol": "tcp", "FromPort": 443, "ToPort": 443,"UserIdGroupPairs": [{"GroupId": "sg-06df23a01ff2df86d"}]}]'

このコマンドでは何も出力されません。

詳細については、「Amazon ユーザーガイド」の「セキュリティグループ」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスRevokeSecurityGroupEgress」の「」を参照してください。 AWS CLI

次のコード例は、revoke-security-group-ingress を使用する方法を示しています。

AWS CLI

例 1: セキュリティグループからルールを削除するには

次のrevoke-security-group-ingress例では、デフォルトの の指定されたセキュリティグループから203.0.113.0/24、アドレス範囲のTCPポート 22 アクセスを削除しますVPC。

aws ec2 revoke-security-group-ingress \
    --group-name mySecurityGroup
    --protocol tcp \
    --port 22 \
    --cidr 203.0.113.0/24

このコマンドが成功すると、出力は生成されません。

詳細については、「Amazon ユーザーガイド」の「セキュリティグループ」を参照してください。 EC2

例 2: IP アクセス許可セットを使用してルールを削除するには

次のrevoke-security-group-ingress例では、 ip-permissionsパラメータを使用して、ICMPメッセージを許可するインバウンドルール Destination Unreachable: Fragmentation Needed and Don't Fragment was Set (タイプ 3、コード 4) を削除します。

aws ec2 revoke-security-group-ingress \
    --group-id sg-026c12253ce15eff7 \
    --ip-permissions IpProtocol=icmp,FromPort=3,ToPort=4,IpRanges=[{CidrIp=0.0.0.0/0}]

このコマンドが成功すると、出力は生成されません。

詳細については、「Amazon ユーザーガイド」の「セキュリティグループ」を参照してください。 EC2

  • API 詳細については、「 コマンドリファレンスRevokeSecurityGroupIngress」の「」を参照してください。 AWS CLI

次の例は、run-instances を使用する方法を説明しています。

AWS CLI

例 1: インスタンスをデフォルトサブネット内で起動するには

次のrun-instances例では、現在のリージョンのデフォルトサブネットt2.microに タイプの単一のインスタンスを起動し、リージョンのデフォルトサブネットに関連付けVPCます。(Linux) または SSH (RDPWindows) を使用してインスタンスに接続する予定がない場合は、キーペアはオプションです。

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --key-name MyKeyPair

出力:

{
    "Instances": [
        {
            "AmiLaunchIndex": 0,
            "ImageId": "ami-0abcdef1234567890",
            "InstanceId": "i-1231231230abcdef0",
            "InstanceType": "t2.micro",
            "KeyName": "MyKeyPair",
            "LaunchTime": "2018-05-10T08:05:20.000Z",
            "Monitoring": {
                "State": "disabled"
            },
            "Placement": {
                "AvailabilityZone": "us-east-2a",
                "GroupName": "",
                "Tenancy": "default"
            },
            "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
            "PrivateIpAddress": "10.0.0.157",
            "ProductCodes": [],
            "PublicDnsName": "",
            "State": {
                "Code": 0,
                "Name": "pending"
            },
            "StateTransitionReason": "",
            "SubnetId": "subnet-04a636d18e83cfacb",
            "VpcId": "vpc-1234567890abcdef0",
            "Architecture": "x86_64",
            "BlockDeviceMappings": [],
            "ClientToken": "",
            "EbsOptimized": false,
            "Hypervisor": "xen",
            "NetworkInterfaces": [
                {
                    "Attachment": {
                        "AttachTime": "2018-05-10T08:05:20.000Z",
                        "AttachmentId": "eni-attach-0e325c07e928a0405",
                        "DeleteOnTermination": true,
                        "DeviceIndex": 0,
                        "Status": "attaching"
                    },
                    "Description": "",
                    "Groups": [
                        {
                            "GroupName": "MySecurityGroup",
                            "GroupId": "sg-0598c7d356eba48d7"
                        }
                    ],
                    "Ipv6Addresses": [],
                    "MacAddress": "0a:ab:58:e0:67:e2",
                    "NetworkInterfaceId": "eni-0c0a29997760baee7",
                    "OwnerId": "123456789012",
                    "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                    "PrivateIpAddress": "10.0.0.157",
                    "PrivateIpAddresses": [
                        {
                            "Primary": true,
                            "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                            "PrivateIpAddress": "10.0.0.157"
                        }
                    ],
                    "SourceDestCheck": true,
                    "Status": "in-use",
                    "SubnetId": "subnet-04a636d18e83cfacb",
                    "VpcId": "vpc-1234567890abcdef0",
                    "InterfaceType": "interface"
                }
            ],
            "RootDeviceName": "/dev/xvda",
            "RootDeviceType": "ebs",
            "SecurityGroups": [
                {
                    "GroupName": "MySecurityGroup",
                    "GroupId": "sg-0598c7d356eba48d7"
                }
            ],
            "SourceDestCheck": true,
            "StateReason": {
                "Code": "pending",
                "Message": "pending"
            },
            "Tags": [],
            "VirtualizationType": "hvm",
            "CpuOptions": {
                "CoreCount": 1,
                "ThreadsPerCore": 1
            },
            "CapacityReservationSpecification": {
                "CapacityReservationPreference": "open"
            },
            "MetadataOptions": {
                "State": "pending",
                "HttpTokens": "optional",
                "HttpPutResponseHopLimit": 1,
                "HttpEndpoint": "enabled"
            }
        }
    ],
    "OwnerId": "123456789012",
    "ReservationId": "r-02a3f596d91211712"
}

例 2: デフォルトではないサブネットでインスタンスを起動し、パブリック IP アドレスを追加するには

次の run-instances の例では、デフォルト以外のサブネットで起動するインスタンスのパブリック IP アドレスをリクエストします。インスタンスは指定されたセキュリティグループに関連付けられます。

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --subnet-id subnet-08fc749671b2d077c \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --associate-public-ip-address \
    --key-name MyKeyPair

run-instances の出力例については、例 1 を参照してください。

例 3: ボリュームを追加してインスタンスを起動するには

次の run-instances の例では、mapping.json で指定されたブロックデバイスマッピングを使用して、起動時に追加のボリュームをアタッチします。ブロックデバイスマッピングでは、EBSボリューム、インスタンスストアボリューム、またはEBSボリュームとインスタンスストアボリュームの両方を指定できます。

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --subnet-id subnet-08fc749671b2d077c \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --key-name MyKeyPair \
    --block-device-mappings file://mapping.json

mapping.json の内容。この例では/dev/sdh、サイズが 100 GiB の空のEBSボリュームを追加します。

[
    {
        "DeviceName": "/dev/sdh",
        "Ebs": {
            "VolumeSize": 100
        }
    }
]

mapping.json の内容。この例は、ephemeral1 をインスタンスストアボリュームとして追加しています。

[
    {
        "DeviceName": "/dev/sdc",
        "VirtualName": "ephemeral1"
    }
]

run-instances の出力例については、例 1 を参照してください。

ブロックデバイスマッピングの詳細については、「Amazon EC2ユーザーガイド」の「ブロックデバイスマッピング」を参照してください。

例 4: インスタンスを起動し、作成時にタグを追加するには

次の run-instances の例では、キー webserver と値 production のタグをインスタンスに追加しています。このコマンドは、 のキーcost-centerと の値を持つタグcc123を、作成されたすべてのEBSボリューム (この場合はルートボリューム) にも適用します。

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --count 1 \
    --subnet-id subnet-08fc749671b2d077c \
    --key-name MyKeyPair \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]'

run-instances の出力例については、例 1 を参照してください。

例 5: ユーザーデータを使用してインスタンスを起動するには

次の run-instances の例では、インスタンスの設定スクリプトを含む my_script.txt というファイルにユーザーデータを渡します。このスクリプトは起動時に実行されます。

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --count 1 \
    --subnet-id subnet-08fc749671b2d077c \
    --key-name MyKeyPair \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --user-data file://my_script.txt

run-instances の出力例については、例 1 を参照してください。

インスタンスユーザーデータの詳細については、「Amazon ユーザーガイド」の「インスタンスユーザーデータの使用」を参照してください。 EC2

例 6: バーストパフォーマンスインスタンスを起動するには

次の run-instances の例では、unlimited クレジットオプションを使用して t2.micro インスタンスを起動しています。T2 インスタンスを起動する際に --credit-specification を指定しない場合、デフォルトは standard クレジットオプションです。T3 インスタンスを起動する際、デフォルトは unlimited クレジットオプションです。

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --count 1 \
    --subnet-id subnet-08fc749671b2d077c \
    --key-name MyKeyPair \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --credit-specification CpuCredits=unlimited

run-instances の出力例については、例 1 を参照してください。

バーストパフォーマンスインスタンスの詳細については、「Amazon EC2ユーザーガイド」の「バーストパフォーマンスインスタンス」を参照してください。

  • API 詳細については、「 コマンドリファレンスRunInstances」の「」を参照してください。 AWS CLI

次のコード例は、run-scheduled-instances を使用する方法を示しています。

AWS CLI

スケジュールされたインスタンスを起動するには

この例では、 で指定されたスケジュールされたインスタンスを起動しますVPC。

コマンド:

aws ec2 run-scheduled-instances --scheduled-instance-id sci-1234-1234-1234-1234-123456789012 --instance-count 1 --launch-specification file://launch-specification.json

Launch-specification.json:

{
  "ImageId": "ami-12345678",
  "KeyName": "my-key-pair",
  "InstanceType": "c4.large",
  "NetworkInterfaces": [
    {
        "DeviceIndex": 0,
        "SubnetId": "subnet-12345678",
        "AssociatePublicIpAddress": true,
        "Groups": ["sg-12345678"]
    }
  ],
  "IamInstanceProfile": {
      "Name": "my-iam-role"
  }
}

出力:

{
  "InstanceIdSet": [
      "i-1234567890abcdef0"
  ]
}

この例では、EC2-Classic で指定されたスケジュールされたインスタンスを起動します。

コマンド:

aws ec2 run-scheduled-instances --scheduled-instance-id sci-1234-1234-1234-1234-123456789012 --instance-count 1 --launch-specification file://launch-specification.json

Launch-specification.json:

{
  "ImageId": "ami-12345678",
  "KeyName": "my-key-pair",
  "SecurityGroupIds": ["sg-12345678"],
  "InstanceType": "c4.large",
  "Placement": {
    "AvailabilityZone": "us-west-2b"
  }
  "IamInstanceProfile": {
      "Name": "my-iam-role"
  }
}

出力:

{
  "InstanceIdSet": [
      "i-1234567890abcdef0"
  ]
}

  • API 詳細については、「 コマンドリファレンスRunScheduledInstances」の「」を参照してください。 AWS CLI

次の例は、search-local-gateway-routes を使用する方法を説明しています。

AWS CLI

ローカルゲートウェイルートテーブルでルートを検索するには

次のsearch-local-gateway-routes例では、指定されたローカルゲートウェイルートテーブルで静的ルートを検索します。

aws ec2 search-local-gateway-routes \
    --local-gateway-route-table-id lgw-rtb-059615ef7dEXAMPLE \
    --filters "Name=type,Values=static"

出力:

{
    "Route": {
        "DestinationCidrBlock": "0.0.0.0/0",
        "LocalGatewayVirtualInterfaceGroupId": "lgw-vif-grp-07145b276bEXAMPLE",
        "Type": "static",
        "State": "deleted",
        "LocalGatewayRouteTableId": "lgw-rtb-059615ef7EXAMPLE"
    }
}

  • API 詳細については、「 コマンドリファレンスSearchLocalGatewayRoutes」の「」を参照してください。 AWS CLI

次の例は、search-transit-gateway-multicast-groups を使用する方法を説明しています。

AWS CLI

1 つ以上の Transit Gateway マルチキャストグループを検索し、グループメンバーシップ情報を返します。

次のsearch-transit-gateway-multicast-groups例では、指定されたマルチキャストグループのグループメンバーシップを返します。

aws ec2 search-transit-gateway-multicast-groups \
    --transit-gateway-multicast-domain-id tgw-mcast-domain-000fb24d04EXAMPLE

出力:

{
    "MulticastGroups": [
        {
            "GroupIpAddress": "224.0.1.0",
            "TransitGatewayAttachmentId": "tgw-attach-0372e72386EXAMPLE",
            "SubnetId": "subnet-0187aff814EXAMPLE",
            "ResourceId": "vpc-0065acced4EXAMPLE",
            "ResourceType": "vpc",
            "NetworkInterfaceId": "eni-03847706f6EXAMPLE",
            "GroupMember": false,
            "GroupSource": true,
            "SourceType": "static"
        }
    ]
}

詳細については、「 Transit Gateways ガイド」の「マルチキャストグループの管理」を参照してください。

次のコード例は、search-transit-gateway-routes を使用する方法を示しています。

AWS CLI

指定されたトランジットゲートウェイルートテーブルでルートを検索するには

次のsearch-transit-gateway-routes例では、指定されたルートテーブルstaticでタイプ のすべてのルートを返します。

aws ec2 search-transit-gateway-routes \
    --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \
    --filters "Name=type,Values=static"

出力:

{
    "Routes": [
        {
            "DestinationCidrBlock": "10.0.2.0/24",
            "TransitGatewayAttachments": [
                {
                    "ResourceId": "vpc-4EXAMPLE",
                    "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
                    "ResourceType": "vpc"
                }
            ],
            "Type": "static",
            "State": "active"
        },
        {
            "DestinationCidrBlock": "10.1.0.0/24",
            "TransitGatewayAttachments": [
                {
                    "ResourceId": "vpc-4EXAMPLE",
                    "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
                    "ResourceType": "vpc"
                }
            ],
            "Type": "static",
            "State": "active"
        }
    ],
    "AdditionalRoutesAvailable": false
}

詳細については、「トランジットゲートウェイガイド」の「トランジットゲートウェイルートテーブル」を参照してください。

  • API 詳細については、「 コマンドリファレンスSearchTransitGatewayRoutes」の「」を参照してください。 AWS CLI

次のコード例は、send-diagnostic-interrupt を使用する方法を示しています。

AWS CLI

診断割り込みを送信するには

次のsend-diagnostic-interrupt例では、指定されたインスタンスに診断割り込みを送信します。

aws ec2 send-diagnostic-interrupt \
    --instance-id i-1234567890abcdef0

このコマンドでは何も出力されません。

  • API 詳細については、「 コマンドリファレンスSendDiagnosticInterrupt」の「」を参照してください。 AWS CLI

次の例は、start-instances を使用する方法を説明しています。

AWS CLI

Amazon EC2インスタンスを起動するには

この例では、指定された Amazon EBS-backed インスタンスを起動します。

コマンド:

aws ec2 start-instances --instance-ids i-1234567890abcdef0

出力:

{
    "StartingInstances": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "CurrentState": {
                "Code": 0,
                "Name": "pending"
            },
            "PreviousState": {
                "Code": 80,
                "Name": "stopped"
            }
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスの停止と起動」を参照してください。

  • API 詳細については、「 コマンドリファレンスStartInstances」の「」を参照してください。 AWS CLI

次の例は、start-network-insights-access-scope-analysis を使用する方法を説明しています。

AWS CLI

Network Insights アクセススコープ分析を開始するには

次のstart-network-insights-access-scope-analysis例では、 AWS アカウントでスコープ分析を開始します。

aws ec2 start-network-insights-access-scope-analysis \
    --region us-east-1 \
    --network-insights-access-scope-id nis-123456789111

出力:

{
    "NetworkInsightsAccessScopeAnalysis": {
        "NetworkInsightsAccessScopeAnalysisId": "nisa-123456789222",
        "NetworkInsightsAccessScopeAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-access-scope-analysis/nisa-123456789222",
        "NetworkInsightsAccessScopeId": "nis-123456789111",
        "Status": "running",
        "StartDate": "2022-01-26T00:47:06.814000+00:00"
    }
}

詳細については、「Network Access Analyzer ガイド」の「 を使用した Network Access Analyzer の開始 AWS CLI方法」を参照してください。

次の例は、start-network-insights-analysis を使用する方法を説明しています。

AWS CLI

パスを分析するには

次のstart-network-insights-analysis例では、送信元と送信先の間のパスを分析します。パス分析の結果を表示するには、 describe-network-insights-analyses コマンドを使用します。

aws ec2 start-network-insights-analysis \
    --network-insights-path-id nip-0b26f224f1d131fa8

出力:

{
    "NetworkInsightsAnalysis": {
        "NetworkInsightsAnalysisId": "nia-02207aa13eb480c7a",
        "NetworkInsightsAnalysisArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-analysis/nia-02207aa13eb480c7a",
        "NetworkInsightsPathId": "nip-0b26f224f1d131fa8",
        "StartDate": "2021-01-20T22:58:37.495Z",
        "Status": "running"
    }
}

詳細については、「Reachability Analyzer ガイド」の「 の使用開始 AWS CLI」を参照してください。

  • API 詳細については、「 コマンドリファレンスStartNetworkInsightsAnalysis」の「」を参照してください。 AWS CLI

次のコード例は、start-vpc-endpoint-service-private-dns-verification を使用する方法を示しています。

AWS CLI

DNS検証プロセスを開始するには

次のstart-vpc-endpoint-service-private-dns-verification例では、指定されたエンドポイントサービスDNSの検証プロセスを開始します。

aws ec2 start-vpc-endpoint-service-private-dns-verification \
    --service-id vpce-svc-071afff70666e61e0

このコマンドでは何も出力されません。

詳細については、「 ユーザーガイド」のDNS「名前の管理AWS PrivateLink 」を参照してください。

次の例は、stop-instances を使用する方法を説明しています。

AWS CLI

例 1: Amazon EC2インスタンスを停止するには

次のstop-instances例では、指定された Amazon EBS-backed インスタンスを停止します。

aws ec2 stop-instances \
    --instance-ids i-1234567890abcdef0

出力:

{
    "StoppingInstances": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "CurrentState": {
                "Code": 64,
                "Name": "stopping"
            },
            "PreviousState": {
                "Code": 16,
                "Name": "running"
            }
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「インスタンスの停止と起動」を参照してください。

例 2: Amazon EC2インスタンスを休止するには

次のstop-instances例では、インスタンスが休止が有効で、休止の前提条件を満たしている場合、Amazon EBS-backed インスタンスを休止します。インスタンスが休止状態になると、インスタンスは停止されます。

aws ec2 stop-instances \
    --instance-ids i-1234567890abcdef0 \
    --hibernate

出力:

{
    "StoppingInstances": [
        {
            "CurrentState": {
                "Code": 64,
                "Name": "stopping"
            },
            "InstanceId": "i-1234567890abcdef0",
            "PreviousState": {
                "Code": 16,
                "Name": "running"
            }
        }
    ]
}

詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」でオンデマンド Linux インスタンスの休止方法を参照してください。

  • API 詳細については、「 コマンドリファレンスStopInstances」の「」を参照してください。 AWS CLI

次の例は、terminate-client-vpn-connections を使用する方法を説明しています。

AWS CLI

クライアントVPNエンドポイントへの接続を終了するには

次のterminate-client-vpn-connections例では、クライアントVPNエンドポイントへの指定された接続を終了します。

aws ec2 terminate-client-vpn-connections \
    --client-vpn-endpoint-id vpn-endpoint-123456789123abcde \
    --connection-id cvpn-connection-04edd76f5201e0cb8

出力:

{
    "ClientVpnEndpointId": "vpn-endpoint-123456789123abcde",
    "ConnectionStatuses": [
        {
            "ConnectionId": "cvpn-connection-04edd76f5201e0cb8",
            "PreviousStatus": {
                "Code": "active"
            },
            "CurrentStatus": {
                "Code": "terminating"
            }
        }
    ]
}

詳細については、「クライアント管理者ガイド」の「クライアント接続」を参照してください。 AWS VPN

次の例は、terminate-instances を使用する方法を説明しています。

AWS CLI

Amazon EC2インスタンスを終了するには

この例では、指定されたインスタンスを終了します。

コマンド:

aws ec2 terminate-instances --instance-ids i-1234567890abcdef0

出力:

{
    "TerminatingInstances": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "CurrentState": {
                "Code": 32,
                "Name": "shutting-down"
            },
            "PreviousState": {
                "Code": 16,
                "Name": "running"
            }
        }
    ]
}

詳細については、 AWS コマンドラインインターフェイスユーザーガイドの「Amazon EC2 インスタンスの使用」を参照してください。

  • API 詳細については、「 コマンドリファレンスTerminateInstances」の「」を参照してください。 AWS CLI

次の例は、unassign-ipv6-addresses を使用する方法を説明しています。

AWS CLI

ネットワークインターフェイスからIPv6アドレスの割り当てを解除するには

この例では、指定されたネットワークインターフェイスから指定されたIPv6アドレスの割り当てを解除します。

コマンド:

aws ec2 unassign-ipv6-addresses --ipv6-addresses 2001:db8:1234:1a00:3304:8879:34cf:4071 --network-interface-id eni-23c49b68

出力:

{
  "NetworkInterfaceId": "eni-23c49b68",
  "UnassignedIpv6Addresses": [
      "2001:db8:1234:1a00:3304:8879:34cf:4071"
  ]
}

  • API 詳細については、AWS CLI 「 コマンドリファレンス」のUnassignIpv6Addresses」を参照してください。

次のコード例は、unassign-private-ip-addresses を使用する方法を示しています。

AWS CLI

ネットワークインターフェイスからセカンダリプライベート IP アドレスの割り当てを解除するには

この例では、指定されたプライベート IP アドレスを指定されたネットワークインターフェイスから割り当て解除します。コマンドが成功した場合、出力は返りません。

コマンド:

aws ec2 unassign-private-ip-addresses --network-interface-id eni-e5aa89a3 --private-ip-addresses 10.0.0.82

  • API 詳細については、「 コマンドリファレンスUnassignPrivateIpAddresses」の「」を参照してください。 AWS CLI

次のコード例は、unassign-private-nat-gateway-address を使用する方法を示しています。

AWS CLI

プライベートNATゲートウェイからプライベート IP アドレスの割り当てを解除するには

次のunassign-private-nat-gateway-address例では、指定されたプライベートNATゲートウェイから指定された IP アドレスの割り当てを解除します。

aws ec2 unassign-private-nat-gateway-address \
    --nat-gateway-id nat-1234567890abcdef0 \
    --private-ip-addresses 10.0.20.197

出力:

{
    "NatGatewayId": "nat-0ee3edd182361f662",
    "NatGatewayAddresses": [
        {
            "NetworkInterfaceId": "eni-0065a61b324d1897a",
            "PrivateIp": "10.0.20.197",
            "IsPrimary": false,
            "Status": "unassigning"
        }
    ]
}

詳細については、「Amazon VPCユーザーガイドNAT」の「ゲートウェイ」を参照してください。

次のコード例は、unlock-snapshot を使用する方法を示しています。

AWS CLI

スナップショットのロックを解除するには

次のunlock-snapshot例では、指定されたスナップショットをロック解除します。

aws ec2 unlock-snapshot \
    --snapshot-id snap-0b5e733b4a8df6e0d

出力:

{
    "SnapshotId": "snap-0b5e733b4a8df6e0d"
}

詳細については、「Amazon ユーザーガイド」の「スナップショットロック」を参照してください。 EBS

  • API 詳細については、「 コマンドリファレンスUnlockSnapshot」の「」を参照してください。 AWS CLI

次のコード例は、unmonitor-instances を使用する方法を示しています。

AWS CLI

インスタンスの詳細モニタリングを無効にするには

このコマンド例は、指定されたインスタンスの詳細モニタリングを無効にします。

コマンド:

aws ec2 unmonitor-instances --instance-ids i-1234567890abcdef0

出力:

{
  "InstanceMonitorings": [
      {
          "InstanceId": "i-1234567890abcdef0",
          "Monitoring": {
              "State": "disabling"
          }
      }
  ]
}

  • API 詳細については、「 コマンドリファレンスUnmonitorInstances」の「」を参照してください。 AWS CLI

次のコード例は、update-security-group-rule-descriptions-egress を使用する方法を示しています。

AWS CLI

アウトバウンドセキュリティグループルールの説明を更新するには

次のupdate-security-group-rule-descriptions-egress例では、指定されたポートとIPv4アドレス範囲のセキュリティグループルールの説明を更新します。説明 'Outbound HTTP access to server 2' は、ルールの既存の説明を置き換えます。

aws ec2 update-security-group-rule-descriptions-egress \
    --group-id sg-02f0d35a850ba727f \
    --ip-permissions IpProtocol=tcp,FromPort=80,ToPort=80,IpRanges=[{CidrIp=203.0.113.0/24,Description="Outbound HTTP access to server 2"}]

出力:

{
    "Return": true
}

詳細については、「Amazon ユーザーガイド」の「セキュリティグループのルール」を参照してください。 EC2

次のコード例は、update-security-group-rule-descriptions-ingress を使用する方法を示しています。

AWS CLI

例 1: インバウンドセキュリティグループルールの説明をCIDRソースで更新するには

次のupdate-security-group-rule-descriptions-ingress例では、指定されたポートとIPv4アドレス範囲のセキュリティグループルールの説明を更新します。説明 'SSH access from ABC office' は、ルールの既存の説明を置き換えます。

aws ec2 update-security-group-rule-descriptions-ingress \
    --group-id sg-02f0d35a850ba727f \
    --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,IpRanges='[{CidrIp=203.0.113.0/16,Description="SSH access from corpnet"}]'

出力:

{
    "Return": true
}

詳細については、「Amazon ユーザーガイド」の「セキュリティグループのルール」を参照してください。 EC2

例 2: プレフィックスリストソースを使用してインバウンドセキュリティグループルールの説明を更新するには

次のupdate-security-group-rule-descriptions-ingress例では、指定されたポートとプレフィックスリストのセキュリティグループルールの説明を更新します。説明 'SSH access from ABC office' は、ルールの既存の説明を置き換えます。

aws ec2 update-security-group-rule-descriptions-ingress \
    --group-id sg-02f0d35a850ba727f \
    --ip-permissions IpProtocol=tcp,FromPort=22,ToPort=22,PrefixListIds='[{PrefixListId=pl-12345678,Description="SSH access from corpnet"}]'

出力:

{
    "Return": true
}

詳細については、「Amazon ユーザーガイド」の「セキュリティグループのルール」を参照してください。 EC2

次の例は、withdraw-byoip-cidr を使用する方法を説明しています。

AWS CLI

アドレス範囲のアドバタイズを停止するには

次のwithdraw-byoip-cidr例では、指定されたアドレス範囲のアドバタイズを停止します。

aws ec2 withdraw-byoip-cidr
    --cidr 203.0.113.25/24

出力:

{
    "ByoipCidr": {
        "Cidr": "203.0.113.25/24",
        "StatusMessage": "ipv4pool-ec2-1234567890abcdef0",
        "State": "advertised"
    }
}

  • API 詳細については、「 コマンドリファレンスWithdrawByoipCidr」の「」を参照してください。 AWS CLI