Administre las puertas de enlace SiteWise Edge

Para enumerar las puertas de enlace de SiteWise Edge

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Vea la lista de todas sus puertas de enlace SiteWise Edge.

• Usa el comando list-gateways para ver todas tus pasarelas:

  aws iotsitewise list-gateways

  Este comando devuelve una lista de sus puertas de enlace con sus nombres y otra IDs información.

  También puede especificar los parámetros de paginación:

  aws iotsitewise list-gateways --max-results 10 --next-token your-token

Para ver los detalles de la puerta de enlace

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Elija el nombre de la puerta de enlace de la que desea ver los detalles.

4. Vea los detalles de la puerta de enlace en la página de detalles de la puerta de enlace de Edge.

• Usa el comando describe-gateway con el ID de la puerta de enlace:

  aws iotsitewise describe-gateway --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE

  Este comando devuelve información detallada sobre la puerta de enlace.

Para crear una puerta de enlace SiteWise Edge

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Seleccione Crear puerta de enlace.

4. Introduzca un nombre para la puerta de enlace.

5. Seleccione el grupo Greengrass para su puerta de enlace.

6. Si lo desea, añada etiquetas a su puerta de enlace.

7. Seleccione Crear.

• Utilice el comando create-gateway para crear una nueva puerta de enlace:

  aws iotsitewise create-gateway \
      --gateway-name "NewSiteWiseGateway" \
      --gateway-platform '{
          "greengrass": {
              "groupArn": "arn:aws:greengrass:us-east-1:123456789012:group/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
          }
      }' \
      --tags '{
          "Environment": "Production",
          "Location": "Factory1"
      }'

  Este comando devuelve el ID y el ARN de la nueva puerta de enlace:

  {
      "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
      "gatewayArn": "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
  }

Para actualizar una puerta de enlace SiteWise Edge

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Seleccione la puerta de enlace que desee actualizar.

4. Seleccione Editar.

5. Actualice el nombre de la puerta de enlace u otros ajustes según sea necesario.

6. Seleccione Save.

• Usa el comando update-gateway para actualizar el nombre de una puerta de enlace:

  aws iotsitewise update-gateway \
      --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
      --gateway-name "UpdatedGatewayName"

  Este comando no genera ninguna salida si se realiza correctamente.

Para actualizar la configuración de la capacidad de la pasarela

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Elija el nombre de la puerta de enlace que desea actualizar.

4. En la sección Fuentes de datos, elija Editar.

5. Actualice la configuración de la fuente de datos según sea necesario.

6. Seleccione Save.

• Utilice el update-gateway-capability-configuration comando para actualizar la configuración de la capacidad:

  aws iotsitewise update-gateway-capability-configuration \
      --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
      --capability-namespace "iotsitewise:opcuacollector:1" \
      --capability-configuration '{
          "sources": [
              {
                  "name": "OPC-UA Server",
                  "endpoint": {
                      "certificateTrust": {
                          "type": "TrustAny"
                      },
                      "endpointUri": "opc.tcp://10.0.0.1:4840",
                      "securityPolicy": "NONE",
                      "messageSecurityMode": "NONE",
                      "identityProvider": {
                          "type": "Anonymous"
                      }
                  },
                  "measurementDataStreamPrefix": ""
              }
          ]
      }'

  Este comando devuelve el espacio de nombres de la capacidad y el estado de sincronización:

  {
      "capabilityNamespace": "iotsitewise:opcuacollector:1",
      "capabilitySyncStatus": "CONFIGURING"
  }

Para etiquetar un recurso de puerta de enlace

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Elija el nombre de la puerta de enlace que desee etiquetar.

4. Elija la pestaña Etiquetas.

5. Elija Administrar etiquetas.

6. Elija Añadir nueva etiqueta e introduzca una clave y un valor para cada etiqueta.

7. Seleccione Save.

• Usa el comando tag-resource para añadir etiquetas a una puerta de enlace:

  aws iotsitewise tag-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
      --tags '{
          "Department": "Operations",
          "Project": "FactoryAutomation"
      }'

  Este comando no genera ninguna salida si se realiza correctamente.

Para enumerar las etiquetas de una puerta de enlace

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Elija el nombre de la puerta de enlace cuyas etiquetas desee ver.

4. Elija la pestaña Etiquetas.

5. Vea la lista de etiquetas asociadas a la puerta de enlace.

• Utilice el list-tags-for-resource comando para enumerar las etiquetas de una puerta de enlace:

  aws iotsitewise list-tags-for-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"

  Este comando devuelve las etiquetas asociadas a la puerta de enlace:

  {
      "tags": {
          "Environment": "Production",
          "Location": "Factory1",
          "Department": "Operations",
          "Project": "FactoryAutomation"
      }
  }

Para eliminar etiquetas de una puerta de enlace

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Elija el nombre de la puerta de enlace de la que desea eliminar las etiquetas.

4. Elija la pestaña Etiquetas.

5. Elija Administrar etiquetas.

6. Seleccione el icono de eliminación (X) situado junto a cada etiqueta que desee eliminar.

7. Seleccione Save.

• Usa el comando untag-resource para eliminar las etiquetas de una puerta de enlace:

  aws iotsitewise untag-resource \
      --resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
      --tag-keys '["Project", "Department"]'

  Este comando no genera ninguna salida si se realiza correctamente.

Para eliminar la puerta de enlace de SiteWise Edge

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, seleccione Puertas de enlace Edge.

3. Elija la puerta de enlace que desea eliminar.

4. Elija Eliminar.

5. Para confirmar que desea eliminar la puerta de enlace, escriba «eliminar» y, a continuación, seleccione Eliminar en la ventana que aparece.

1. Enumere sus puertas de enlace para identificar el ID de la puerta de enlace que desea eliminar.

   aws iotsitewise list-gateways

   Este comando devuelve una lista de sus puertas de enlace con sus IDs nombres y otra información:

   {
       "gatewaySummaries": [
           {
               "gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
               "gatewayName": "ExampleCorpGateway",
               "gatewayCapabilitySummaries": [
                   {
                       "capabilityNamespace": "iotsitewise:opcuacollector:1",
                       "capabilitySyncStatus": "IN_SYNC"
                   }
               ],
               "creationDate": 1588369971.457,
               "lastUpdateDate": 1588369971.457
           }
       ]
   }

2. Elimine la puerta de enlace especificando su ID:

   aws iotsitewise delete-gateway --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE

   Este comando no genera ninguna salida si se realiza correctamente.

   nota

   Al eliminar una puerta de enlace, algunos de los archivos de la puerta de enlace permanecen en el sistema de archivos de la puerta de enlace.

3. Para comprobar que la puerta de enlace se ha eliminado, puede volver a enumerarlas:

   aws iotsitewise list-gateways

   La puerta de enlace eliminada ya no debería aparecer en la lista.