すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:DATASOURCE::ECS::NetworkInterfaces

最終更新日:Jan 16, 2025

DATASOURCE::ECS::NetworkInterfaces は、Elastic Network Interface(ENI)に関する情報を照会するために使用されます。

構文

{
  "Type": "DATASOURCE::ECS::NetworkInterfaces",
  "Properties": {
    "Status": String,
    "PrivateIpAddresses": List,
    "ServiceManaged": Boolean,
    "ResourceGroupId": String,
    "InstanceId": String,
    "SecurityGroupId": String,
    "VSwitchId": String,
    "NetworkInterfaceName": String,
    "NetworkInterfaceIds": List,
    "PrimaryIpAddress": String,
    "Ipv6Addresses": List,
    "Type": String,
    "VpcId": String,
    "Tags": List,
    "RefreshOptions": String
  }
}

プロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Status

String

いいえ

はい

ENI のステータス。

有効な値:

  • Available:ENI は使用可能です。

  • Attaching:ENI はインスタンスにアタッチされています。

  • InUse:ENI はインスタンスにアタッチされています。

  • Detaching:ENI はインスタンスからデタッチされています。

  • Deleting:ENI は削除されています。

説明

このプロパティを空のままにすると、すべての状態の ENI が照会されます。

PrivateIpAddresses

List

いいえ

はい

ENI のセカンダリ プライベート IPv4 アドレス。

最大 100 個の IP アドレスを指定できます。複数の IP アドレスはコンマ(,)で区切ります。

ServiceManaged

Boolean

いいえ

はい

ENI のユーザーが Alibaba Cloud サービスかディストリビューターかを指定します。

有効な値:

  • true

  • false

ResourceGroupId

String

いいえ

はい

リソース グループの ID。

なし。

InstanceId

String

いいえ

はい

ENI がアタッチされている Elastic Compute Service(ECS)インスタンスの ID。

なし。

SecurityGroupId

String

いいえ

はい

セカンダリ ENI が属するセキュリティ グループの ID。

セキュリティ グループの ID に基づいてセカンダリ ENI に関する情報を照会する場合は、このプロパティを指定します。

VSwitchId

String

いいえ

はい

ENI が接続されている vSwitch の ID。

なし。

NetworkInterfaceName

String

いいえ

はい

ENI 名。

なし。

NetworkInterfaceIds

List

いいえ

はい

ENI の ID。

最大 100 個の ENI ID を指定できます。複数の ID はコンマ(,)で区切ります。

PrimaryIpAddress

String

いいえ

はい

ENI のプライマリ プライベート IPv4 アドレス。

なし。

Ipv6Addresses

List

いいえ

はい

ENI の IPv6 アドレス。

最大 100 個の IP アドレスを指定できます。複数の IP アドレスはコンマ(,)で区切ります。

Type

String

いいえ

はい

ENI タイプ。

有効な値:

  • Primary

  • Secondary

説明

このプロパティを空のままにすると、すべてのタイプの ENI が照会されます。

VpcId

String

いいえ

はい

ENI が属する Virtual Private Cloud(VPC)の ID。

なし。

Tags

List

いいえ

はい

ENI のタグ。

最大 20 個のタグを追加できます。

詳細については、タグ プロパティをご参照ください。

RefreshOptions

String

いいえ

はい

スタックが更新されたときのデータ ソース リソースの更新ポリシー。

有効な値:

  • Never(デフォルト):スタックが更新されたときにデータ ソース リソースを更新しません。

  • Always:スタックが更新されたときにデータ ソース リソースを更新します。

タグの構文

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

タグのプロパティ

プロパティ

タイプ

必須

編集可能

説明

制約

Value

String

いいえ

いいえ

ENI のタグ値。

なし。

Key

String

はい

いいえ

ENI のタグ キー。

なし。

戻り値 (Fn::GetAtt)

  • NetworkInterfaceIds:ENI の ID。

  • NetworkInterfaces:ENI の詳細。

プロパティ

タイプ

説明

制約

NetworkInterfaceIds

List

ENI の ID。

なし。

NetworkInterfaces

List

ENI の詳細。

なし。

VpcId

String

ENI が属する VPC の ID。

なし。

Type

String

ENI タイプ。

有効な値:

  • Primary

  • Secondary

Status

String

ENI のステータス。

有効な値:

  • Available:ENI は使用可能です。

  • Attaching:ENI はインスタンスにアタッチされています。

  • InUse:ENI はインスタンスにアタッチされています。

  • Detaching:ENI はインスタンスからデタッチされています。

  • Deleting:ENI は削除されています。

NetworkInterfaceTrafficMode

String

ENI の通信モード。

有効な値:

  • Standard:TCP 通信モード

  • HighPerformance:Remote Direct Memory Access(RDMA)通信モード

NetworkInterfaceId

String

ENI ID。

なし。

InstanceId

String

ENI がアタッチされている ECS インスタンスの ID。

なし。

OwnerId

String

ENI が属する Alibaba Cloud アカウントの ID。

なし。

VSwitchId

String

ENI が接続されている vSwitch の ID。

なし。

ResourceGroupId

String

リソース グループの ID。

なし。

ZoneId

String

ゾーン ID。

なし。

PrivateIpAddress

String

ENI のセカンダリ プライベート IPv4 アドレス。

なし。

QueueNumber

Number

ENI でサポートされているキューの数。

有効な値:

  • ENI が InUse 状態のセカンダリ ENI で、ENI でサポートされているキューの数が変更されていない場合は、インスタンス タイプがサポートするセカンダリ ENI あたりのデフォルトのキューの数が返されます。

  • ENI がセカンダリ ENI で、ENI でサポートされているキューの数が変更されている場合は、新しいキューの数が返されます。

  • ENI が Available 状態のセカンダリ ENI で、ENI でサポートされているキューの数が変更されていない場合は、空の値が返されます。

  • ENI がプライマリ ENI の場合は、インスタンス タイプがサポートするプライマリ ENI あたりのデフォルトのキューの数が返されます。

PrivateIpSets

List

インスタンスのプライベート IP アドレス。

なし。

Ipv6Sets

List

ENI に割り当てられた IPv6 アドレス。

なし。

Tags

List

タグ。

なし。

SecurityGroupIds

List

ENI が属するセキュリティ グループの ID。

なし。

AssociatedPublicIp

List

ENI のセカンダリ プライベート IP アドレスに関連付けられている Elastic IP アドレス(EIP)。

なし。

JSON 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "Tags": {
      "Type": "Json",
      "Default": {"Key": "acs:privatelink:serviceType", "Value": "natgw"}
    }
  },
  "Resources": {
    "NetworkInterfaces": {
      "Type": "DATASOURCE::ECS::NetworkInterfaces",
      "Properties": {
        "RegionId": {
          "Ref": "ALIYUN::Region"
        },
        "Tags": {
          "Ref": "Tags"
        }
      }
    }
  },
  "Outputs": {
    "Images": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "NetworkInterfaceIds"
        ]
      }
    },
    "ImageIds": {
      "Value": {
        "Fn::GetAtt": [
          "NetworkInterfaces",
          "NetworkInterfaces"
        ]
      }
    }
  }
}