Creación de puertos

Requisitos previos

Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.

Crear un puerto

Para crear un puerto, envíe una solicitud POST al punto final /fabric/v4/ports.

Method	POST
URL or Endpoint	/fabric/v4/ports
Headers	Authorization, Content-Type
Path Parameters	Not applicable
Query Parameters	dryRun
Body Parameters	type, id, uuid, name, description, physicalPortsSpeed, connectionsCount, physicalPortsType, physicalPortsCount, connectivitySourceType, bmmrType, project, state, order, cvpId, operation, account, change, changeLog, availableBandwidth, usedBandwidth, location, device, interface, demarcationPointIbx, tetherIbx, demarcationPoint, redundancy, encapsulation, lagEnabled, lag, asn, package, settings, physicalPortQuantity, notifications, additionalInfo, endCustomer, physicalPorts, loas

Para validar de forma segura esta solicitud en producción sin crear ni modificar recursos, consulte Pruebas en producción (API Dry Run).

Ejemplo de solicitud cURL - Colocation, puerto no LAG:

curl -X POST 'https://api.equinix.com/fabric/v4/ports'  
-H 'Content-Type: application/json'  
-H 'Authorization: Bearer <token>'  
-d '{
  "type": "XF_PORT",
  "physicalPortsSpeed": 1000,
  "physicalPortsType": "1000BASE_LX",
  "connectivitySourceType": "COLO",
  "location": {
    "metroCode": "GV"
  },
  "demarcationPointIbx": "GV1",
  "package": {
    "code": "STANDARD"
  },
  "lagEnabled": false,
  "encapsulation": {
    "type": "DOT1Q",
    "tagProtocolId": 33024
  },
  "project": {
    "projectId": "8f23b36f-db8f-44c8-a6e5-606e1b485931"
  },
  "account": {
    "accountNumber": 270848
  },
  "notifications": [
    {
      "registeredUsers": [
        "jaguarsuser-port-order"
      ],
      "type": "TECHNICAL"
    }
  ],
  "order": {
    "purchaseOrder": {
      "number": 156576,
      "amount": 10,
      "startDate": "2018-06-11T22:25:52.206Z",
      "endDate": "2018-07-11T22:25:52.206Z",
      "type": "NEW"
    },
    "signature": {
      "signatory": "DELEGATE",
      "delegate": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@company.com"
      }
    }
  },
  "physicalPorts": [
    {
      "demarcationPoint": {
        "ibx": "GV1",
        "cabinetUniqueSpaceId": "Demarc",
        "cageUniqueSpaceId": "GV1:01:002174",
        "patchPanel": "CP:Demarc:1259684",
        "connectorType": "SC"
      }
    }
  ]
}'

Respuesta de muestra:

{
  "type": "XF_PORT",
  "physicalPortsType": "10GBASE_L",
  "physicalPortsSpeed": 10000,
  "physicalPortsCount": 1,
  "location": {
    "metroCode": "AM"
  },
  "demarcationPointIbx": "AM1",
  "redundancy": {
    "group": 1,
    "priority": "PRIMARY"
  },
  "lagEnabled": true,
  "encapsulation": {
    "type": "DOT1Q",
    "tagProtocolId": 33024
  },
  "package": {
    "code": "STANDARD"
  },
  "settings": {
    "sharedPortType": false
  },
  "project": {
    "projectId": 567
  },
  "account": {
    "accountNumber": 1000
  },
  "order": {
    "orderNumber": "1-207799950758",
    "signature": {
      "signatory": "DELEGATE",
      "delegate": {
        "email": "testEmail1@equinix.com"
      }
    }
  },
  "notifications": [
    {
      "type": "TECHNICAL",
      "registeredUsers": [
        "jaguarsuser-port-order"
      ]
    },
    {
      "type": "NOTIFICATION",
      "registeredUsers": [
        "jaguarsuser-port-order"
      ]
    },
    {
      "type": "PEERING",
      "registeredUsers": [
        "jaguarsuser-port-order"
      ]
    },
    {
      "type": "ESCALATION",
      "registeredUsers": [
        "jaguarsuser-port-order"
      ]
    }
  ]
}

Para una descripción detallada de la respuesta, o para más ejemplos, consulte la Referencia API.