> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建 VPC 网络

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值：application/json。
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="clusterId" type="string" required={true}>
  集群 ID。可以调用[获取集群信息](/gpus/reference-list-clusters)接口获取。字符串，长度限制：1-255 字符。
</ParamField>

<ParamField body="name" type="string" required={false}>
  VPC 网络的名称。自定义设置。字符串，长度限制：0-30 字符。
</ParamField>

## 响应参数

<ResponseField name="network" type="object[]" required={true}>
  VPC 网络信息。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="Id" type="string" required={true}>
      VPC 网络的ID。
    </ResponseField>

    <ResponseField name="user" type="string" required={true}>
      用户账号 ID。
    </ResponseField>

    <ResponseField name="name" type="string" required={true}>
      VPC 网络的名称。
    </ResponseField>

    <ResponseField name="state" type="object[]" required={true}>
      VPC 网络的状态。

      <Expandable title="properties" defaultOpen={true}>
        <ResponseField name="state" type="string" required={true}>
          VPC 网络的状态。取值：

          * creating：创建中。
          * ready：创建成功。
        </ResponseField>

        <ResponseField name="error" type="string" required={false}>
          VPC 网络创建失败或者网络不可用时的错误提示。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="segment" type="string" required={true}>
      VPC 网络的网段。
    </ResponseField>

    <ResponseField name="clusterId" type="string" required={true}>
      集群 ID。
    </ResponseField>

    <ResponseField name="Addresses" type="object[]" required={true}>
      VPC 网络下的实例信息。

      <Expandable title="properties" defaultOpen={true}>
        <ResponseField name="Id" type="string" required={true}>
          实例 ID。
        </ResponseField>

        <ResponseField name="Ip" type="string" required={true}>
          实例的 IP 地址。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="createTime" type="string" required={true}>
      VPC 网络的创建时间。
    </ResponseField>
  </Expandable>
</ResponseField>