# Ordem de limpeza da gaiola ![](https://docs.equinix.com/pt-BR/assets/images/OrdeCageCleanUp-cf6045398fa2a762e4063cadd13fbfaa.png) ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") 1. Para obter detalhes do Smart Hands, você deve ter `Smart Hands` permissão. 2. 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. 3. Get Smart Hands Types - Envie uma `GET` solicitação para o [`/v1/orders/smarthands/types`](https://docs.equinix.com/pt-BR/api-catalog/smarthandsv1/smarthands/smarthandtypes.md) terminal para obter todos os tipos de pedidos Smart Hands. Você pode ignorar esta etapa se já souber o tipo de pedido Smart Hands. 4. Obter informações de localização - Envie uma `GET` solicitação ao [`/v1/orders/smarthands/locations`](https://docs.equinix.com/pt-BR/api-catalog/smarthandsv1/smarthands/getlocation.md) terminal para recuperar os locais IBX disponíveis aos quais você tem acesso. Você pode pular esta etapa se já souber as informações de localização. ## Pedido uma limpeza de Cage - exemplo mínimo[​](#pedido-uma-limpeza-de-cage---exemplo-mínimo "Link direto para Pedido uma limpeza de Cage - exemplo mínimo") Para solicitar a remoção da lixeira ou a limpeza do cage para um cage específico, envie uma `POST` solicitação para o [`/smarthands/cageCleanup`](https://docs.equinix.com/pt-BR/api-catalog/smarthandsv1/smarthands/handlesmarthandcagecleanuporder.md) terminal. Especifique o local, a programação, os contatos e os detalhes do serviço no corpo da solicitação. Exemplo de solicitação cURL: ``` curl -X POST "https://api.equinix.com/v1/orders/smarthands/cageCleanup" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "ibxLocation": {     "ibx": "AM1",     "cages": [       {         "cage": "AM1:0J:00JD11",         "accountNumber": "126854"       }     ]   },   "serviceDetails": {     "permissionToDiscardBoxes": true,     "dampMoistMopRequired": true,     "scopeOfWork": "Light dusting of equipment, microfiber mop to be used."   },   "schedule": {     "scheduleType": "SCHEDULED_MAINTENANCE",     "requestedStartDate": "2019-08-30T22:00:49.776Z",     "requestedCompletionDate": "2019-08-31T22:00:49.776Z"   },   "contacts": [     {         "contactType": "ORDERING",         "userName": "johndoe"     },     {         "contactType": "TECHNICAL",         "userName": "johndoe",         "workPhonePrefToCall": "ANYTIME"     },     {         "contactType": "NOTIFICATION",         "userName": "johndoe"     }   ] }' ``` Para obter uma lista completa dos parâmetros e descrições do corpo, consulte [a Referência do API](https://docs.equinix.com/pt-BR/api-catalog/smarthandsv1/smarthands/handlesmarthandcagecleanuporder.md) . Exemplo de resposta: ``` {     "OrderNumber": "1-190368976438" } ``` A resposta indica que o pedido foi bem-sucedido e retorna o número do pedido. ## Pedido uma limpeza de Cage - exemplo estendido[​](#pedido-uma-limpeza-de-cage---exemplo-estendido "Link direto para Pedido uma limpeza de Cage - exemplo estendido") Para solicitar a remoção da lixeira ou a limpeza do cage para um cage específico, envie uma `POST` solicitação para o [`/smarthands/cageCleanup`](https://docs.equinix.com/pt-BR/api-catalog/smarthandsv1/smarthands/handlesmarthandcagecleanuporder.md) terminal. Especifique o local, a programação, os contatos e os detalhes do serviço no corpo da solicitação. Use o `attachments` objeto para incluir detalhes adicionais para um técnico. > **Observação** > > Antes de criar um pedido com anexo, ligue para o [`Attachments File`](https://docs.equinix.com/pt-BR/api-catalog/attachmentsv1/attachments/createattachment.md) terminal. ``` curl -X POST "https://api.equinix.com/v1/orders/smarthands/cageCleanup" -H "content-type: application/json" -H "authorization: Bearer " -d '{    "ibxLocation": {     "ibx": "AM1",     "cages": [       {         "cage": "AM1:0J:00JD11",         "cabinets": [           "AM1:0J:00JD11:0001"         ],         "accountNumber": "126854"       }     ]   },   "serviceDetails": {     "permissionToDiscardBoxes": true,     "dampMoistMopRequired": true,     "scopeOfWork": "Light dusting of equipment, microfiber mop to be used.",     "needSupportFromASubmarineCableStationEngineer": true   },   "attachments": [     {       "id": "fcb2k8763-2947-456e-8d68-f280753d60ba",       "name": "PhotoForCageCleanupServiceDetails.docx"     }   ],   "schedule": {     "scheduleType": "SCHEDULED_MAINTENANCE",     "requestedStartDate": "2019-08-30T22:00:49.776Z",     "requestedCompletionDate": "2019-08-31T22:00:49.776Z"   },   "customerReferenceNumber": "EQX-PO2019-08-001",   "purchaseOrder": {     "purchaseOrderType": "EXEMPTED",     "attachment": {       "id": "abc1fd2e-345f-67g4-hi89-01jk234l5m6n",       "name": "PurchaseOrderExemptionForm123.docx"     }   },   "contacts": [     {       "contactType": "ORDERING",       "userName": "johndoe"     },     {       "contactType": "TECHNICAL",       "name": "Jane Smith",       "email": "janesmith@corporation.com",       "workPhoneCountryCode": "+44",       "workPhone": "0148211111",       "workPhonePrefToCall": "MY_BUSINESS_HOURS",       "workPhoneTimeZone": "Europe/London",       "mobilePhoneCountryCode": "+44",       "mobilePhone": "0123456789",       "mobilePhonePrefToCall": "MY_BUSINESS_HOURS",       "mobilePhoneTimeZone": "Europe/London"     },     {       "contactType": "NOTIFICATION",       "userName": "johndoe"     },     {       "contactType": "NOTIFICATION",       "userName": "janesmith"     }   ] }' ``` Para obter uma lista completa dos parâmetros e descrições do corpo, consulte [a Referência do API](https://docs.equinix.com/pt-BR/api-catalog/smarthandsv1/smarthands/handlesmarthandcagecleanuporder.md) .