# Criando Portas ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais. ## Criar uma porta[​](#criar-uma-porta "Link direto para Criar uma porta") Para criar uma porta, envie uma `POST` solicitação para o [`/fabric/v4/ports`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/ports/createport.md) terminal. | | | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Método | `POST` | | URL ou ponto final | `/fabric/v4/ports` | | Cabeçalhos | `Authorization`, `Content-Type` | | Parâmetros do caminho | Não aplicável | | Parâmetros de consulta | `dryRun` | | Parâmetros Corporais | `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 com segurança essa solicitação na produção sem criar ou alterar recursos, consulte [Testes em produção (Execução seca do API)](https://docs.equinix.com/pt-BR/equinix-api/testing/testing-in-production-dry-run.md). Exemplo de solicitação cURL - colocation, porta não LAG: ``` curl -X POST 'https://api.equinix.com/fabric/v4/ports' -H 'Content-Type: application/json' -H 'Authorization: Bearer ' -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" } } ] }' ``` Exemplo de resposta: ``` { "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 obter uma descrição detalhada da resposta, ou para obter mais exemplos, consulte a [Referência do API](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/ports/createport.md) .