# Gerenciando assinaturas Você pode gerenciar suas assinaturas usando os seguintes endpoints de API . ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") * 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 mais informações sobre como autenticar suas solicitações no Equinix API. ## Obtenha suas assinaturas[​](#obtenha-suas-assinaturas "Link direto para Obtenha suas assinaturas") Para retornar uma lista de todas as suas assinaturas de streaming, envie uma `GET` solicitação para o [`/smartview/v2/streaming/subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/smartviewv2/streaming-subscription-api/getallsubscriptions.md) endpoint. Exemplo de solicitação cURL: ``` curl -X GET 'https://api.equinix.com/smartview/v2/streaming/subscriptions' -H 'authorization: Bearer ' ``` Exemplo de resposta: ``` [ { "id": "606349eca6171829c70d8777", "status": "PENDING", "messageType": { "asset": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "assetClassification": [ "MECHANICAL" ], "assetId": [ "string" ] } ], "environmental": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "level": [ "ZONE" ] } ], "power": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "meteredPower": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "systemAlert": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "customAlert": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "user": "abc" } ] }, "channel": { "channelType": "AWS_IOT_CORE", "awsIotCoreChannelConfiguration": { "url": "https://b4c3mzxe8syvhd-ats.iot.us-west-2.amazonaws.com" } }, "orgId": "123", "createdBy": "abc", "createdDateTime": "2019-08-24T14:15:22Z", "updatedBy": "abc", "updatedDateTime": "2019-08-24T14:15:22Z" } ] ``` ## Obtenha detalhes de assinaturas[​](#obtenha-detalhes-de-assinaturas "Link direto para Obtenha detalhes de assinaturas") Para obter os detalhes de uma assinatura especificada, envie uma `GET` solicitação para o [`/smartview/v2/streaming/subscriptions/{id}`](https://docs.equinix.com/pt-BR/api-catalog/smartviewv2/streaming-subscription-api/getsubscriptionbyid.md) terminal. Exemplo de solicitação cURL: ``` curl -X GET 'https://api.equinix.com/smartview/v2/streaming/subscriptions/606349eca6171829c70d8777' -H 'authorization: Bearer ' ``` Exemplo de resposta: ``` { "id": "606349eca6171829c70d8777", "status": "ACTIVE", "messageType": { "asset": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "assetClassification": [ "MECHANICAL" ], "assetId": [ "string" ] } ], "environmental": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "level": [ "ZONE" ] } ], "power": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "meteredPower": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "systemAlert": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "customAlert": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "user": "abc" } ] }, "channel": { "channelType": "AWS_IOT_CORE", "awsIotCoreChannelConfiguration": { "url": "https://b4c3mzxe8syvhd-ats.iot.us-west-2.amazonaws.com" } }, "orgId": "123", "createdBy": "abc", "createdDateTime": "2019-08-24T14:15:22Z", "updatedBy": "abc", "updatedDateTime": "2019-08-24T14:15:22Z" } ``` ## Atualizar uma assinatura[​](#atualizar-uma-assinatura "Link direto para Atualizar uma assinatura") Para modificar uma assinatura, envie uma `PUT` solicitação para o [`/smartview/v2/streaming/subscriptions/{id}`](https://docs.equinix.com/pt-BR/api-catalog/smartviewv2/streaming-subscription-api/updatesubscription.md) terminal. O novo corpo de solicitação substitui a configuração de assinatura atual. Exemplo de solicitação cURL: ``` curl -X PUT 'https://api.equinix.com/smartview/v2/streaming/subscriptions/{id}' -H 'authorization: Bearer ' -d '{ "messageType": { "asset": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "assetClassification": [ "MECHANICAL" ], "assetId": [ "string" ] } ], "environmental": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "level": [ "ZONE" ] } ], "power": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "meteredPower": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "systemAlert": [ { "accountNumber": "135888", "ibx": [ "DE2" ] } ], "customAlert": [ { "accountNumber": "135888", "ibx": [ "DE2" ], "user": "abc" } ] }, "channel": { "channelType": "AWS_IOT_CORE", "awsIotCoreChannelConfiguration": { "url": "https://b4c3mzxe8syvhd-ats.iot.us-west-2.amazonaws.com" } } }' ``` ## Eliminar uma Assinatura[​](#eliminar-uma-assinatura "Link direto para Eliminar uma Assinatura") Para excluir uma assinatura, envie uma `DELETE` solicitação para o [`/smartview/v2/streaming/subscriptions/{id}`](https://docs.equinix.com/pt-BR/api-catalog/smartviewv2/streaming-subscription-api/deletesubscriptionbyid.md) terminal. Os eventos não estarão mais disponíveis para a assinatura depois que uma solicitação de exclusão for recebida. Exemplo de solicitação cURL: ``` curl -X DELETE 'https://api.equinix.com/smartview/v2/streaming/subscriptions/606349eca6171829c70d8777' -H 'authorization: Bearer ' ```