你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

NetApp Resource - Query Network Sibling Set

服务:
Azure NetApp Files
API 版本:
2026-05-01

描述网络同级集
获取指定网络同级集的详细信息。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/queryNetworkSiblingSet?api-version=2026-05-01

URI 参数

名称 在 必需 类型 说明
location
 path True

string

minLength: 1

Azure 区域的名称。
subscriptionId
 path True

string (uuid)

目标订阅的 ID。 该值必须是 UUID。
api-version
 query True

string

minLength: 1

用于此操作的 API 版本。

请求正文

名称 必需 类型 说明
networkSiblingSetId True

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

子网中共享网络资源的一组卷的网络同级集 ID。
subnetId True

string (arm-id)

委托子网的Azure资源 URI。 必须具有委派Microsoft。NetApp/volumes。 示例 /subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft。Network/virtualNetworks/testVnet/subnets/{mySubnet}

响应

名称 类型 说明
200 OK

NetworkSiblingSet

请求已成功。
Other Status Codes

ErrorResponse

未预期的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 冒充您的用户账户

示例

NetworkSiblingSet_Query

示例请求

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.NetApp/locations/eastus/queryNetworkSiblingSet?api-version=2026-05-01

{
  "networkSiblingSetId": "9760acf5-4638-11e7-9bdb-020073ca3333",
  "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testVnet/subnets/testSubnet"
}

示例响应

状态代码:
200 
{
  "networkFeatures": "Standard",
  "networkSiblingSetId": "9760acf5-4638-11e7-9bdb-020073ca3333",
  "networkSiblingSetStateId": "12345_44420.8001578125",
  "nicInfoList": [
    {
      "ipAddress": "1.2.3.4",
      "volumeResourceIds": [
        "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume10",
        "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume11"
      ]
    },
    {
      "ipAddress": "1.2.3.5",
      "volumeResourceIds": [
        "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account2/capacityPools/pool2/volumes/volume20",
        "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account2/capacityPools/pool2/volumes/volume21"
      ]
    },
    {
      "ipAddress": "1.2.3.9",
      "volumeResourceIds": []
    }
  ],
  "provisioningState": "Succeeded",
  "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testVnet/subnets/testSubnet"
}

定义

名称 说明
ErrorAdditionalInfo

资源管理错误附加信息。
ErrorDetail

错误详情
ErrorResponse

错误响应
NetworkFeatures

可用于卷或当前更新状态的网络功能。
NetworkSiblingSet

描述网络同级集的内容。
NetworkSiblingSetProvisioningState

获取调用作时 NetworkSiblingSet 的状态。
NicInfo

NIC 信息及拥有主挂载 IP 地址的卷列表。
QueryNetworkSiblingSetRequest

网络同级集查询。

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称 类型 说明
info

object

附加信息。
type

string

其他信息类型。

ErrorDetail

对象

错误详情

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误的附加信息。
code

string

错误代码。
details

ErrorDetail[]

错误详情。
message

string

错误消息。
target

string

错误的目标。

ErrorResponse

对象

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

NetworkFeatures

枚举

可用于卷或当前更新状态的网络功能。

值 说明
Basic

基本网络功能。
Standard

标准网络功能。
Basic_Standard

从基本网络功能更新到标准网络功能。
Standard_Basic

从标准网络功能更新到基本网络功能。

NetworkSiblingSet

对象

描述网络同级集的内容。

名称 类型 默认值 说明
networkFeatures

NetworkFeatures

Basic

可用于卷或当前更新状态的网络功能。
networkSiblingSetId

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

子网中共享网络资源的一组卷的网络同级集 ID。
networkSiblingSetStateId

string

标识同级集的当前状态的网络同级集状态 ID。
nicInfoList

NicInfo[]

NIC 信息列表
provisioningState

NetworkSiblingSetProvisioningState

获取调用作时 NetworkSiblingSet 的状态。
subnetId

string (arm-id)

委托子网的Azure资源 URI。 必须具有委派Microsoft。NetApp/volumes。 示例 /subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft。Network/virtualNetworks/testVnet/subnets/{mySubnet}

NetworkSiblingSetProvisioningState

枚举

获取调用作时 NetworkSiblingSet 的状态。

值 说明
Succeeded
Failed
Canceled
Updating

NicInfo

对象

NIC 信息及拥有主挂载 IP 地址的卷列表。

名称 类型 说明
ipAddress

string

IP 地址
volumeResourceIds

string[] (arm-id)

卷资源 ID

QueryNetworkSiblingSetRequest

对象

网络同级集查询。

名称 类型 说明
networkSiblingSetId

string

minLength: 36
maxLength: 36
pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

子网中共享网络资源的一组卷的网络同级集 ID。
subnetId

string (arm-id)

委托子网的Azure资源 URI。 必须具有委派Microsoft。NetApp/volumes。 示例 /subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft。Network/virtualNetworks/testVnet/subnets/{mySubnet}