全部產品
Search
文件中心

:DATASOURCE::ECS::NetworkInterfaces

更新時間:Oct 30, 2024

DATASOURCE::ECS::NetworkInterfaces類型用於查詢彈性網卡(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

彈性網卡的狀態。

取值:

  • Available:可用。

  • Attaching:綁定中。

  • InUse:已綁定。

  • Detaching:解除綁定中。

  • Deleting:刪除中。

說明

如果不指定該參數,則查詢所有狀態的彈性網卡。

PrivateIpAddresses

List

彈性網卡的輔助私網IPv4地址。

最多支援指定100個IP地址,多個IP地址間用半形逗號(,)分隔。

ServiceManaged

Boolean

彈性網卡的使用者是否為雲產品或虛商。

取值:

  • true:使用者是雲產品或虛商。

  • false:使用者不是雲產品或虛商。

ResourceGroupId

String

資源群組ID。

InstanceId

String

彈性網卡關聯的ECS執行個體ID。

SecurityGroupId

String

輔助網卡對應的安全性群組ID。

如果您需要通過安全性群組ID查詢輔助網卡的資訊,請指定該參數。

VSwitchId

String

彈性網卡所屬的交換器ID。

NetworkInterfaceName

String

彈性網卡的名稱。

NetworkInterfaceIds

List

彈性網卡ID。

最多支援指定100個彈性網卡ID,多個彈性網卡ID間用半形逗號(,)分隔。

PrimaryIpAddress

String

彈性網卡主私網IPv4地址。

Ipv6Addresses

List

彈性網卡的IPv6地址。

最多支援指定100個IP地址,多個IP地址間用半形逗號(,)分隔。

Type

String

彈性網卡的類型。

取值:

  • Primary:主網卡。

  • Secondary:輔助網卡。

說明

如果不指定該參數,則查詢所有類型的彈性網卡。

VpcId

String

彈性網卡所屬的專用網路ID。

Tags

List

彈性網卡的標籤。

最多支援指定20個標籤。

更多資訊,請參見Tags屬性

RefreshOptions

String

當資源棧更新時,資料來源資源的重新整理策略。

有效值:

  • Never(預設值):更新堆棧時,從不重新整理資料來源資源。

  • Always:更新堆棧時,始終重新整理資料來源資源。

Tags文法

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

Tags屬性

屬性名稱

類型

必須

允許更新

描述

約束

Value

String

彈性網卡的標籤值。

Key

String

彈性網卡的標籤鍵。

返回資料(Fn::GetAtt)

  • NetworkInterfaceIds:彈性網卡執行個體ID列表。

  • NetworkInterfaces:彈性網卡執行個體詳情列表。

屬性名稱

類型

描述

約束

NetworkInterfaceIds

List

彈性網卡執行個體ID列表。

NetworkInterfaces

List

彈性網卡執行個體詳情列表。

VpcId

String

彈性網卡所屬的專用網路ID。

Type

String

彈性網卡的類型。

取值:

  • Primary:主網卡。

  • Secondary:輔助網卡。

Status

String

彈性網卡的狀態。

取值:

  • Available:可用。

  • Attaching:綁定中。

  • InUse:已綁定。

  • Detaching:解除綁定中。

  • Deleting:刪除中。

NetworkInterfaceTrafficMode

String

彈性網卡的通訊模式。

取值:

  • Standard:TCP通訊模式。

  • HighPerformance:RDMA通訊模式。

NetworkInterfaceId

String

彈性網卡ID。

InstanceId

String

彈性網卡關聯的ECS執行個體ID。

OwnerId

String

彈性網卡所屬的阿里雲帳號ID。

VSwitchId

String

彈性網卡所屬的交換器ID。

ResourceGroupId

String

資源群組ID。

ZoneId

String

可用性區域ID。

PrivateIpAddress

String

彈性網卡的輔助私網IPv4地址清單。

QueueNumber

Number

彈性網卡的隊列數。

取值:

  • 如果輔助網卡是已掛載(InUse)狀態且沒有修改過隊列數,則返回執行個體規格預設的輔助網卡隊列數。

  • 如果輔助網卡修改過隊列數,則返回修改後的隊列數。

  • 如果輔助網卡是未掛載(Available)狀態且未修改過隊列數,則傳回值為空白。

  • 主網卡返回執行個體規格預設的主網卡隊列數。

PrivateIpSets

List

執行個體的私網IP地址資訊列表。

Ipv6Sets

List

為彈性網卡分配的IPv6地址清單。

Tags

List

標籤。

SecurityGroupIds

List

彈性網卡所屬的安全性群組列表。

AssociatedPublicIp

List

彈性網卡輔助私人IP地址關聯的Elastic IP Address地址清單。

樣本

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"
        ]
      }
    }
  }
}