2 つ以上の vSphere Distributed Switch (vDS) を持つ VI ワークロード ドメインを作成する場合、または 3 つ以上の物理 NIC を持つ ESXi ホストを使用する場合は、VMware Cloud Foundation API を使用する必要があります。

この手順では、domainCreationSpec を使用して、VMware Cloud Foundation API を介して新しい VI ワークロード ドメインを作成します。2 つ以上の Distributed Switch を持つ VI ワークロード ドメインを作成したり、3 つ以上の物理 NIC を持つ ESXi ホストを使用したりするための、domainCreationSpec の hostSpecs と vdsSpecs の 2 つのセクションに焦点を当てます。

これらのセクションを変更し、環境に必要な domainCreationSpec の他のセクションを完了する必要があります。 のすべてのセクションの詳細については、『VMware Cloud Foundation API リファレンス ガイドdomainCreationSpec』を参照してください。この手順の最後の完全な domainCreationSpec の例を参照してください。

手順の例は、次のシナリオに基づいています。
2 台の vSphere Distributed Switch
  • sfo-w01-cl01-vds01
  • sfo-w01-cl01-vds02
4 つの物理 NIC
  • vmnic0
  • vmnic1
  • vmnic2
  • vmnic3
物理 NIC から Distributed Switch へのマッピング
  • vmnic0 および vmnic1 から sfo-w01-cl01-vds01
  • vmnic2 および vmnic3 から sfo-w01-cl01-vds02
Distributed Switch からトラフィック タイプへのマッピング
  • sfo-w01-cl01-vds01：管理および vMotion
  • sfo-w01-cl01-vds02：vSAN、ホスト オーバーレイ、Edge アップリンク
VMware Cloud Foundation 環境に基づいて例を変更します。
注： VCF+ を使用している場合、ライセンス キーは必要ありません。

前提条件

ワークロード ドメインの前提条件を参照してください。

手順

  1. VI ワークロード ドメインに追加する ESXi ホストの ID を取得します。
    1. SDDC Manager ユーザー インターフェイス で、[デベロッパー センター] > [API Explorer] の順にクリックします。
    2. [ホスト管理用の API] セクションを展開し、[GET/v1/hosts] を展開します。
    3. ステータス テキスト ボックスに UNASSIGNED_USEABLE と入力し、[実行] をクリックします。
    4. 応答で、VI ワークロード ドメインに追加する各ホストの ID を見つけてコピーします。
  2. テキスト エディタで、[hostSpecs] の JSON 仕様を作成します。例： 
    "hostSpecs" : [ {
        "id" : "0ac30e66-7f65-4477-8331-80c3777c153c",
        "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
        "username" : "root",
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "vmnic0",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic1",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic2",
            "vdsName" : "sfo-w01-cl01-vds02"
          }, {
            "id" : "vmnic3",
            "vdsName" : "sfo-w01-cl01-vds02"
          } ]
        }
      },
    ESXi ホストごとに、以下を含むセクションを追加します。
    • id
    • licenseKey
    • userName
    • hostNetworkSpec
    手順 1 の ESXi ホスト ID を使用します。
  3. テキスト エディタで、[vdsSpecs] の JSON 仕様を作成します。例： 
    "vdsSpecs": [
               {
                   "name": "sfo-w01-cl01-vds01",
                   "portGroupSpecs": [
                       {
                           "name": "sfo01-w01-cl01-vds01-pg-mgmt",
                           "transportType": "MANAGEMENT"
                       },
                       {
                           "name": "sfo01-w01-cl01-vds01-pg-vmotion",
                           "transportType": "VMOTION"
                       }
                   ]
               },
               {
                   "name": "sfo-w01-cl01-vds02",
                   "portGroupSpecs": [
                       {
                           "name": "sfo01-w01-cl01-vds02-pg-vsan",
                           "transportType": "VSAN"
                       }
                   ],
                   "isUsedByNsxt": true
               }
    注： Distributed Switch がホスト オーバーレイ トラフィックに使用する "isUsedByNsxt": true を指定します。vSphere Distributed Switch が複数ある場合は、そのうちの 1 つのみが "isUsedByNsxt": true を指定できます。
  4. SDDC Manager ユーザー インターフェイス で、[デベロッパー センター] > [API Explorer] の順にクリックします。
  5. [ドメイン管理用の API] セクションを展開し、[POST /v1/domains/validations] をクリックします。
  6. [説明/データ型] 列で、[DomainCreationSpec] をクリックします。
    API Explorer での domainCreationSpec 検証
  7. [hostSpecs] セクションを hostSpecs JSON ファイルの情報に置き換えます。
  8. [vdsSpecs] セクションを vdsSpecs JSON ファイルの情報に置き換えます。
  9. 作成する VI ワークロード ドメインに基づいて、必要に応じて [domainCreationSpec] の他のセクションを更新または削除します。
    この手順の最後の完全な domainCreationSpec の例を参照してください。
  10. [実行] をクリックして、[domainCreationSpec] を検証します。
    検証が成功した場合は、domainCreationSpec コンテンツをコピーして、次の手順に進みます。検証に失敗した場合は、応答内のエラーを確認し、domainCreationSpec を更新して、再度検証します。
  11. [ドメイン管理用の API] セクションを展開し、[POST /v1/domains] をクリックします。
  12. 検証済みの domainCreationSpec コンテンツを貼り付け、[実行] をクリックします。
    SDDC Manager ユーザー インターフェイス の [タスク] パネルを使用して、VI ワークロード ドメインの作成を監視します。

例

完全な domainCreationSpec の例 
{
  "domainName" : "sfo-w01",
  "vcenterSpec" : {
    "name" : "sfo-w01-vc01",
    "networkDetailsSpec" : {
      "ipAddress" : "10.0.0.43",
      "dnsName" : "sfo-w01-vc01.vrack.vsphere.local",
      "gateway" : "10.0.0.250",
      "subnetMask" : "255.255.255.0"
    },
    "rootPassword" : "<password>",
    "datacenterName" : "sfo-w01-dc01",
    "vmSize" : "medium",
    "storageSize" : "lstorage"
  },
  "computeSpec" : {
    "clusterSpecs" : [ {
      "name" : "sfo-w01-cl01",
      "hostSpecs" : [ {
        "id" : "0ac30e66-7f65-4477-8331-80c3777c153c",
        "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
        "username" : "root",
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "vmnic0",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic1",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic2",
            "vdsName" : "sfo-w01-cl01-vds02"
          }, {
            "id" : "vmnic3",
            "vdsName" : "sfo-w01-cl01-vds02"
          } ]
        }
      }, {
        "id" : "05d1a8df-773a-46bb-8838-dcb5bb3358ea",
        "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
        "username" : "root",
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "vmnic0",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic1",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic2",
            "vdsName" : "sfo-w01-cl01-vds02"
          }, {
            "id" : "vmnic3",
            "vdsName" : "sfo-w01-cl01-vds02"
          } ]
        }
      }, {
        "id" : "2b8b770f-265d-4a63-b830-9c98038c81b2",
        "licenseKey": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
        "username" : "root",
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "vmnic0",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic1",
            "vdsName" : "sfo-w01-cl01-vds01"
          }, {
            "id" : "vmnic2",
            "vdsName" : "sfo-w01-cl01-vds02"
          }, {
            "id" : "vmnic3",
            "vdsName" : "sfo-w01-cl01-vds02"
          } ]
        }
      } ],
      "datastoreSpec" : {
        "vsanDatastoreSpec" : {
          "failuresToTolerate" : 1,
          "licenseKey" : "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
          "datastoreName" : "sfo-w01-cl01-ds-vsan01"
        }
      },
      "networkSpec" : {
        "vdsSpecs" : [ {
          "name" : "sfo-w01-cl01-vds01",
          "portGroupSpecs" : [ {
            "name" : "sfo-w01-cl01-vds01-pg-mgmt",
            "transportType" : "MANAGEMENT"
          }, {
            "name" : "sfo-w01-cl01-vds01-pg-vmotion",
            "transportType" : "VMOTION"
          }]
        }, {
          "name" : "sfo-w01-cl01-vds02",
          "portGroupSpecs" : [ {
            "name" : "sfo-w01-cl01-vds02-pg-vsan",
            "transportType" : "VSAN"
          } ],
          "isUsedByNsxt" : true
        } ],
        "nsxClusterSpec" : {
          "nsxTClusterSpec" : {
            "geneveVlanId" : 2,
            "ipAddressPoolSpec" : {
                "name" : "static-ip-pool-01",
                "subnets" : [ {
                  "ipAddressPoolRanges" : [ {
                    "start" : "10.0.11.50",
                    "end" : "10.0.11.70"
                  }, {
                    "start" : "10.0.11.80",
                    "end" : "10.0.11.150"
                  } ],
                  "cidr" : "10.0.11.0/24",
                  "gateway" : "10.0.11.250"
                } ]
              }
          }
        }
      }
    } ]
  },
  "nsxTSpec" : {
    "nsxManagerSpecs" : [ {
      "name" : "sfo-w01-nsx01a",
      "networkDetailsSpec" : {
        "ipAddress" : "10.0.0.44",
        "dnsName" : "sfo-w01-nsx01a.vrack.vsphere.local",
        "gateway" : "10.0.0.250",
        "subnetMask" : "255.255.255.0"
      }
    }, {
      "name" : "sfo-w01-nsx01b",
      "networkDetailsSpec" : {
        "ipAddress" : "10.0.0.45",
        "dnsName" : "sfo-w01-nsx01b.vrack.vsphere.local",
        "gateway" : "10.0.0.250",
        "subnetMask" : "255.255.255.0"
      }
    }, {
      "name" : "sfo-w01-nsx01c",
      "networkDetailsSpec" : {
        "ipAddress" : "10.0.0.46",
        "dnsName" : "sfo-w01-nsx01c.vrack.vsphere.local",
        "gateway" : "10.0.0.250",
        "subnetMask" : "255.255.255.0"
      }
    } ],
    "vip" : "10.0.0.166",
    "vipFqdn" : "sfo-w01-nsx01.vrack.vsphere.local",
    "licenseKey" : "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
    "nsxManagerAdminPassword" : "<password>",
    "formFactor" : "large"
  }
}