全部產品
Search
文件中心

Resource Orchestration Service: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"
        ]
      }
    }
  }
}