ServiceProvider - MoveBlufis

A ServiceProvider may need to move a Blufi from one project to another. This API may be used to move Blufis from one ManagedProject to another ManagedProject, assuming that both projects are managed by this ServiceProvider.

This API does NOT make any configuration changes to the Blufi. If all projects are using the same WIFI Credentials, then the Blufi will be able to connect to the network and then Bluzone. If the credentials are different, then a user will need to apply the WIFI credentials via a Mobile App or SDK.

Rules for usage

  1. Batch Limits: The API currently accepts no more than 20 Blufi id64 values at a time.

  2. Location Entity: The API will assign the Blufi to the first Location entity found for the target project. If this is not the desired Location, then the user will need to then login to the Bluzone Console and manually change the Location. If the project has no Locations created, the API will create a default one (similarly to how this is done in Blufi Provisioning).

  3. Blufi-Templates: If the Blufi in the source project has a Blufi-Template associated with it, then the API will copy that Blufi-Template to the new project.

  4. Batch Errors: The API will skip devices that are not able to be moved, if for example, they do not belong to a ServiceProvider’s ManagedProject.

Example Request

1 2 3 4 5 6 7 8 9 10 11 12 PUT {{baseUrl}}/portal/service/{{serviceProviderId}}/_moveBlufis HTTP/1.1 Content-Type: application/json Accept: application/json bzspid: {{bzspid}} { "targetProjectId": 1, "id64s": [ "1111", "2222" ] }

On success, the API will respond with a HTTP Response Code of 200 and a JSON message. Devices that are not able to be moved will listed in the messages section of the response.

Example Response

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 HTTP/1.1 200 OK Connection: close Date: Thu, 24 Jun 2021 17:18:15 GMT Vary: Origin, Access-Control-Request-Method, Access-Control-Request-Headers, Accept-Encoding, User-Agent Content-Type: application/json X-Content-Type-Options: nosniff X-XSS-Protection: 1; mode=block Cache-Control: no-cache, no-store, max-age=0, must-revalidate Pragma: no-cache Expires: 0 X-Frame-Options: DENY Content-Encoding: gzip { "requestId": "4624555095478", "messages": [ "Blufi[2222] skipped - already part of target project", "Moved 1 Blufis to target project[1]" ] }