获取相互依赖的镜像和L3网络(GetInterdependentL3NetworksImages)

ZStack中一个三层网络属于一个区域，而镜像所在的镜像服务器可以加载到一个或多个区域。镜像服务器本身跟集群也存在依赖关系，例如Ceph的镜像服务器只能跟Ceph的主存储一起工作。由于这种依赖关系的存在，创建云主机的时候指定的三层网络和镜像可能并不能一起工作。用户可以通过该API获得镜像或三层网络的相互依赖。

当指定了l3NetworkUuids参数时，返回的是可以跟这些三层网络一起工作的镜像清单。

当指定了imageUuid参数时，返回的是可以跟该镜像一起工作的三层网络清单。

API请求

URLs
GET zstack/v1/images-l3networks/dependencies
Headers
Authorization: OAuth the-session-uuid
Body
{
  "params": {
    "zoneUuid": "55852cdc71ef4774a9dc1eaf85a29c42",
    "imageUuid": "012be26a00ac4e9583afb5ef9d8dc322"
  },
  "systemTags": [],
  "userTags": []
}
Note: 上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。
Curl示例
curl -H "Content-Type: application/json" \
-H "Authorization: OAuth ecd5117a63cf444cb71bba734e7458c4" \
-X GET http://localhost:8080/zstack/v1/images-l3networks/dependencies?\
zoneUuid=55466c2e90ae46d88df91c4f72c3e304&imageUuid=40b1783bc2614500bf0926499bdc9b4a
参数列表
名字 类型 位置 描述 可选值 起始版本
zoneUuid String query 区域UUID。必须指定，以确定三层网络和镜像依赖关系。 0.6
l3NetworkUuids (可选) List query 三层网络UUID列表 0.6
imageUuid (可选) String query 镜像UUID 0.6
systemTags (可选) List query 系统标签 0.6
userTags (可选) List query 用户标签 0.6

API返回

返回示例
{
  "inventories": [
    {
      "uuid": "e177bad0286f4ee38ac29f0ad0e772e6",
      "name": "private L3",
      "type": "L3BasicNetwork",
      "zoneUuid": "0f8c102ff69a43b0afa89c2833ed42bc",
      "l2NetworkUuid": "c110e7bdffce47578351477ec0728685",
      "state": "Enabled",
      "createDate": "May 11, 2017 1:22:45 PM",
      "lastOpDate": "May 11, 2017 1:22:45 PM",
      "ipRanges": [
        {
          "uuid": "703becbb056f426b8fe5997648fd7607",
          "l3NetworkUuid": "e177bad0286f4ee38ac29f0ad0e772e6",
          "name": "ip range",
          "startIp": "192.168.0.10",
          "endIp": "192.168.0.100",
          "netmask": "255.255.255.0",
          "gateway": "192.168.0.1",
          "createDate": "May 11, 2017 1:22:45 PM",
          "lastOpDate": "May 11, 2017 1:22:45 PM"
        }
      ],
      "networkServices": [
        {
          "l3NetworkUuid": "e177bad0286f4ee38ac29f0ad0e772e6",
          "networkServiceProviderUuid": "294f4a419cc44d51b1fcbf7352fe6c0d",
          "networkServiceType": "DHCP"
        },
        {
          "l3NetworkUuid": "e177bad0286f4ee38ac29f0ad0e772e6",
          "networkServiceProviderUuid": "294f4a419cc44d51b1fcbf7352fe6c0d",
          "networkServiceType": "DNS"
        },
        {
          "l3NetworkUuid": "e177bad0286f4ee38ac29f0ad0e772e6",
          "networkServiceProviderUuid": "294f4a419cc44d51b1fcbf7352fe6c0d",
          "networkServiceType": "SNAT"
        }
      ]
    }
  ]
}
名字 类型 描述 起始版本
inventories List 若输入参数是l3NetworkUuids，为镜像清单;若输入参数是imageUuid，为三层网络清单 0.6
error ErrorCode 错误码，若不为null，则表示操作失败, 操作成功时该字段为null。 详情参考error 0.6
#error
名字 类型 描述 起始版本
code String 错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001 0.6
description String 错误的概要描述 0.6
details String 错误的详细信息 0.6
elaboration String 保留字段，默认为null 0.6
opaque LinkedHashMap 保留字段，默认为null 0.6
cause ErrorCode 根错误，引发当前错误的源错误，若无原错误，该字段为null 0.6

SDK示例

Java SDK
GetInterdependentL3NetworksImagesAction \
action = new GetInterdependentL3NetworksImagesAction();
action.zoneUuid = "e4f01bb336a04285a27c6107f6dfeb68";
action.imageUuid = "05ec09f400684e4ab552d74053fc002e";
action.sessionId = "833c8307f9c540058f1a3b0c9a369f89";
GetInterdependentL3NetworksImagesAction.Result res = action.call();
Python SDK
GetInterdependentL3NetworksImagesAction \
action = GetInterdependentL3NetworksImagesAction()
action.zoneUuid = "9dff772313f64618896ce53c9d8a3594"
action.imageUuid = "9e91392ee23f4427bc82e7a9734c4966"
action.sessionId = "7713d16ef34c4ebdbe94a1b2261dcbeb"
GetInterdependentL3NetworksImagesAction.Result res = action.call()