# SAS Portal API (Testing) . customers . deployments . devices

## Instance Methods

Close httplib2 connections.

Creates a device under a node or customer.

Creates a signed device under a node or customer.

Lists devices under a node or customer.

Retrieves the next page of results.

### Method Details

`close()`

    Close httplib2 connections.

`create(parent, body=None, x__xgafv=None)`

    Creates a device under a node or customer.

    Args:
      parent: string, Required. The name of the parent resource. (required)
      body: object, The request body.
        The object takes the form of:

    {
      "deviceMetadata": { # Device data overridable by both SAS Portal and registration requests. # Device parameters that can be overridden by both SAS Portal and SAS registration requests.
      },
      "name": "A String", # Output only. The resource path name.
      "activeConfig": { # Information about the device configuration. # Output only. Current configuration of the device as registered to the SAS.
        "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
          "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
          "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
          "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
          "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
          "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
          "heightType": "A String", # Specifies how the height is measured.
          "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
          "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
          "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
          "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
          "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
          "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
          "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
          "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
        },
        "model": { # Information about the model of the device. # Information about this device model.
          "hardwareVersion": "A String", # The hardware version of the device.
          "firmwareVersion": "A String", # The firmware version of the device.
          "name": "A String", # The name of the device model.
          "vendor": "A String", # The name of the device vendor.
          "softwareVersion": "A String", # The software version of the device.
        },
        "state": "A String", # State of the configuration.
        "measurementCapabilities": [ # Measurement reporting capabilities of the device.
          "A String",
        ],
        "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
        "userId": "A String", # The identifier of a device user.
        "updateTime": "A String", # Output-only. The last time the device configuration was edited.
        "callSign": "A String", # The call sign of the device operator.
        "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
          "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
          "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
        },
        "category": "A String", # FCC category of the device.
      },
      "grants": [ # Output only. Grants held by the device.
        { # Device grant. It is an authorization provided by the Spectrum Access System to a device to transmit using specified operating parameters after a successful heartbeat by the device.
          "moveList": [ # The DPA move lists on which this grant appears.
            { # An entry in a DPA's move list.
              "dpaId": "A String", # The ID of the DPA.
              "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The frequency range that the move list affects.
                "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
                "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
              },
            },
          ],
          "suspensionReason": [ # If the grant is suspended, the reason(s) for suspension.
            "A String",
          ],
          "expireTime": "A String", # The expiration time of the grant.
          "maxEirp": 3.14, # Maximum Equivalent Isotropically Radiated Power (EIRP) permitted by the grant. The maximum EIRP is in units of dBm/MHz. The value of maxEirp represents the average (RMS) EIRP that would be measured by the procedure defined in FCC part 96.41(e)(3).
          "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The transmission frequency range.
            "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
            "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
          },
          "channelType": "A String", # Type of channel used.
          "grantId": "A String", # Grant Id.
          "state": "A String", # State of the grant.
        },
      ],
      "serialNumber": "A String", # A serial number assigned to the device by the device manufacturer.
      "displayName": "A String", # Device display name.
      "fccId": "A String", # The FCC identifier of the device.
      "state": "A String", # Output only. Device state.
      "preloadedConfig": { # Information about the device configuration. # Configuration of the device, as specified via SAS Portal API.
        "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
          "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
          "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
          "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
          "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
          "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
          "heightType": "A String", # Specifies how the height is measured.
          "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
          "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
          "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
          "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
          "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
          "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
          "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
          "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
        },
        "model": { # Information about the model of the device. # Information about this device model.
          "hardwareVersion": "A String", # The hardware version of the device.
          "firmwareVersion": "A String", # The firmware version of the device.
          "name": "A String", # The name of the device model.
          "vendor": "A String", # The name of the device vendor.
          "softwareVersion": "A String", # The software version of the device.
        },
        "state": "A String", # State of the configuration.
        "measurementCapabilities": [ # Measurement reporting capabilities of the device.
          "A String",
        ],
        "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
        "userId": "A String", # The identifier of a device user.
        "updateTime": "A String", # Output-only. The last time the device configuration was edited.
        "callSign": "A String", # The call sign of the device operator.
        "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
          "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
          "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
        },
        "category": "A String", # FCC category of the device.
      },
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        {
        "deviceMetadata": { # Device data overridable by both SAS Portal and registration requests. # Device parameters that can be overridden by both SAS Portal and SAS registration requests.
        },
        "name": "A String", # Output only. The resource path name.
        "activeConfig": { # Information about the device configuration. # Output only. Current configuration of the device as registered to the SAS.
          "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
            "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
            "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
            "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
            "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
            "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
            "heightType": "A String", # Specifies how the height is measured.
            "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
            "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
            "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
            "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
            "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
            "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
            "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
            "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
          },
          "model": { # Information about the model of the device. # Information about this device model.
            "hardwareVersion": "A String", # The hardware version of the device.
            "firmwareVersion": "A String", # The firmware version of the device.
            "name": "A String", # The name of the device model.
            "vendor": "A String", # The name of the device vendor.
            "softwareVersion": "A String", # The software version of the device.
          },
          "state": "A String", # State of the configuration.
          "measurementCapabilities": [ # Measurement reporting capabilities of the device.
            "A String",
          ],
          "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
          "userId": "A String", # The identifier of a device user.
          "updateTime": "A String", # Output-only. The last time the device configuration was edited.
          "callSign": "A String", # The call sign of the device operator.
          "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
            "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
            "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
          },
          "category": "A String", # FCC category of the device.
        },
        "grants": [ # Output only. Grants held by the device.
          { # Device grant. It is an authorization provided by the Spectrum Access System to a device to transmit using specified operating parameters after a successful heartbeat by the device.
            "moveList": [ # The DPA move lists on which this grant appears.
              { # An entry in a DPA's move list.
                "dpaId": "A String", # The ID of the DPA.
                "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The frequency range that the move list affects.
                  "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
                  "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
                },
              },
            ],
            "suspensionReason": [ # If the grant is suspended, the reason(s) for suspension.
              "A String",
            ],
            "expireTime": "A String", # The expiration time of the grant.
            "maxEirp": 3.14, # Maximum Equivalent Isotropically Radiated Power (EIRP) permitted by the grant. The maximum EIRP is in units of dBm/MHz. The value of maxEirp represents the average (RMS) EIRP that would be measured by the procedure defined in FCC part 96.41(e)(3).
            "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The transmission frequency range.
              "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
              "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
            },
            "channelType": "A String", # Type of channel used.
            "grantId": "A String", # Grant Id.
            "state": "A String", # State of the grant.
          },
        ],
        "serialNumber": "A String", # A serial number assigned to the device by the device manufacturer.
        "displayName": "A String", # Device display name.
        "fccId": "A String", # The FCC identifier of the device.
        "state": "A String", # Output only. Device state.
        "preloadedConfig": { # Information about the device configuration. # Configuration of the device, as specified via SAS Portal API.
          "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
            "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
            "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
            "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
            "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
            "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
            "heightType": "A String", # Specifies how the height is measured.
            "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
            "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
            "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
            "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
            "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
            "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
            "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
            "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
          },
          "model": { # Information about the model of the device. # Information about this device model.
            "hardwareVersion": "A String", # The hardware version of the device.
            "firmwareVersion": "A String", # The firmware version of the device.
            "name": "A String", # The name of the device model.
            "vendor": "A String", # The name of the device vendor.
            "softwareVersion": "A String", # The software version of the device.
          },
          "state": "A String", # State of the configuration.
          "measurementCapabilities": [ # Measurement reporting capabilities of the device.
            "A String",
          ],
          "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
          "userId": "A String", # The identifier of a device user.
          "updateTime": "A String", # Output-only. The last time the device configuration was edited.
          "callSign": "A String", # The call sign of the device operator.
          "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
            "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
            "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
          },
          "category": "A String", # FCC category of the device.
        },
      }

`createSigned(parent, body=None, x__xgafv=None)`

    Creates a signed device under a node or customer.

    Args:
      parent: string, Required. The name of the parent resource. (required)
      body: object, The request body.
        The object takes the form of:

    { # Request for CreateSignedDevice method.
        "encodedDevice": "A String", # Required. JSON Web Token signed using a CPI private key. Payload must be the JSON encoding of the [Device]. The user_id field must be set.
        "installerId": "A String", # Required. Unique installer id (cpiId) from the Certified Professional Installers database.
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        {
        "deviceMetadata": { # Device data overridable by both SAS Portal and registration requests. # Device parameters that can be overridden by both SAS Portal and SAS registration requests.
        },
        "name": "A String", # Output only. The resource path name.
        "activeConfig": { # Information about the device configuration. # Output only. Current configuration of the device as registered to the SAS.
          "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
            "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
            "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
            "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
            "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
            "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
            "heightType": "A String", # Specifies how the height is measured.
            "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
            "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
            "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
            "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
            "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
            "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
            "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
            "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
          },
          "model": { # Information about the model of the device. # Information about this device model.
            "hardwareVersion": "A String", # The hardware version of the device.
            "firmwareVersion": "A String", # The firmware version of the device.
            "name": "A String", # The name of the device model.
            "vendor": "A String", # The name of the device vendor.
            "softwareVersion": "A String", # The software version of the device.
          },
          "state": "A String", # State of the configuration.
          "measurementCapabilities": [ # Measurement reporting capabilities of the device.
            "A String",
          ],
          "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
          "userId": "A String", # The identifier of a device user.
          "updateTime": "A String", # Output-only. The last time the device configuration was edited.
          "callSign": "A String", # The call sign of the device operator.
          "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
            "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
            "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
          },
          "category": "A String", # FCC category of the device.
        },
        "grants": [ # Output only. Grants held by the device.
          { # Device grant. It is an authorization provided by the Spectrum Access System to a device to transmit using specified operating parameters after a successful heartbeat by the device.
            "moveList": [ # The DPA move lists on which this grant appears.
              { # An entry in a DPA's move list.
                "dpaId": "A String", # The ID of the DPA.
                "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The frequency range that the move list affects.
                  "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
                  "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
                },
              },
            ],
            "suspensionReason": [ # If the grant is suspended, the reason(s) for suspension.
              "A String",
            ],
            "expireTime": "A String", # The expiration time of the grant.
            "maxEirp": 3.14, # Maximum Equivalent Isotropically Radiated Power (EIRP) permitted by the grant. The maximum EIRP is in units of dBm/MHz. The value of maxEirp represents the average (RMS) EIRP that would be measured by the procedure defined in FCC part 96.41(e)(3).
            "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The transmission frequency range.
              "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
              "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
            },
            "channelType": "A String", # Type of channel used.
            "grantId": "A String", # Grant Id.
            "state": "A String", # State of the grant.
          },
        ],
        "serialNumber": "A String", # A serial number assigned to the device by the device manufacturer.
        "displayName": "A String", # Device display name.
        "fccId": "A String", # The FCC identifier of the device.
        "state": "A String", # Output only. Device state.
        "preloadedConfig": { # Information about the device configuration. # Configuration of the device, as specified via SAS Portal API.
          "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
            "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
            "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
            "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
            "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
            "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
            "heightType": "A String", # Specifies how the height is measured.
            "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
            "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
            "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
            "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
            "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
            "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
            "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
            "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
          },
          "model": { # Information about the model of the device. # Information about this device model.
            "hardwareVersion": "A String", # The hardware version of the device.
            "firmwareVersion": "A String", # The firmware version of the device.
            "name": "A String", # The name of the device model.
            "vendor": "A String", # The name of the device vendor.
            "softwareVersion": "A String", # The software version of the device.
          },
          "state": "A String", # State of the configuration.
          "measurementCapabilities": [ # Measurement reporting capabilities of the device.
            "A String",
          ],
          "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
          "userId": "A String", # The identifier of a device user.
          "updateTime": "A String", # Output-only. The last time the device configuration was edited.
          "callSign": "A String", # The call sign of the device operator.
          "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
            "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
            "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
          },
          "category": "A String", # FCC category of the device.
        },
      }

`list(parent, pageToken=None, filter=None, pageSize=None, x__xgafv=None)`

    Lists devices under a node or customer.

    Args:
      parent: string, Required. The name of the parent resource. (required)
      pageToken: string, A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.
      filter: string, The filter expression. The filter should have one of the following formats: "sn=123454" or "display_name=MyDevice". sn corresponds to serial_number of the device. The filter is case insensitive.
      pageSize: integer, The maximum number of devices to return in the response. If empty or zero, all devices will be listed. Must be in the range [0, 1000].
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Response for ListDevices method.
        "devices": [ # The devices that match the request.
          {
            "deviceMetadata": { # Device data overridable by both SAS Portal and registration requests. # Device parameters that can be overridden by both SAS Portal and SAS registration requests.
            },
            "name": "A String", # Output only. The resource path name.
            "activeConfig": { # Information about the device configuration. # Output only. Current configuration of the device as registered to the SAS.
              "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
                "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
                "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
                "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
                "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
                "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
                "heightType": "A String", # Specifies how the height is measured.
                "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
                "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
                "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
                "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
                "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
                "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
                "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
                "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
              },
              "model": { # Information about the model of the device. # Information about this device model.
                "hardwareVersion": "A String", # The hardware version of the device.
                "firmwareVersion": "A String", # The firmware version of the device.
                "name": "A String", # The name of the device model.
                "vendor": "A String", # The name of the device vendor.
                "softwareVersion": "A String", # The software version of the device.
              },
              "state": "A String", # State of the configuration.
              "measurementCapabilities": [ # Measurement reporting capabilities of the device.
                "A String",
              ],
              "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
              "userId": "A String", # The identifier of a device user.
              "updateTime": "A String", # Output-only. The last time the device configuration was edited.
              "callSign": "A String", # The call sign of the device operator.
              "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
                "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
                "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
              },
              "category": "A String", # FCC category of the device.
            },
            "grants": [ # Output only. Grants held by the device.
              { # Device grant. It is an authorization provided by the Spectrum Access System to a device to transmit using specified operating parameters after a successful heartbeat by the device.
                "moveList": [ # The DPA move lists on which this grant appears.
                  { # An entry in a DPA's move list.
                    "dpaId": "A String", # The ID of the DPA.
                    "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The frequency range that the move list affects.
                      "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
                      "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
                    },
                  },
                ],
                "suspensionReason": [ # If the grant is suspended, the reason(s) for suspension.
                  "A String",
                ],
                "expireTime": "A String", # The expiration time of the grant.
                "maxEirp": 3.14, # Maximum Equivalent Isotropically Radiated Power (EIRP) permitted by the grant. The maximum EIRP is in units of dBm/MHz. The value of maxEirp represents the average (RMS) EIRP that would be measured by the procedure defined in FCC part 96.41(e)(3).
                "frequencyRange": { # Frequency range from `low_frequency` to `high_frequency`. # The transmission frequency range.
                  "highFrequencyMhz": 3.14, # The highest frequency of the frequency range in MHz.
                  "lowFrequencyMhz": 3.14, # The lowest frequency of the frequency range in MHz.
                },
                "channelType": "A String", # Type of channel used.
                "grantId": "A String", # Grant Id.
                "state": "A String", # State of the grant.
              },
            ],
            "serialNumber": "A String", # A serial number assigned to the device by the device manufacturer.
            "displayName": "A String", # Device display name.
            "fccId": "A String", # The FCC identifier of the device.
            "state": "A String", # Output only. Device state.
            "preloadedConfig": { # Information about the device configuration. # Configuration of the device, as specified via SAS Portal API.
              "installationParams": { # Information about the device installation parameters. # Installation parameters for the device.
                "height": 3.14, # Device antenna height in meters. When the heightType parameter value is "AGL", the antenna height should be given relative to ground level. When the heightType parameter value is "AMSL", it is given with respect to WGS84 datum.
                "antennaModel": "A String", # If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets.
                "eirpCapability": 42, # This parameter is the maximum device EIRP in units of dBm/10MHz and is an integer with a value between -127 and +47 (dBm/10 MHz) inclusive. If not included, SAS interprets it as maximum allowable EIRP in units of dBm/10MHz for device category.
                "longitude": 3.14, # Longitude of the device antenna location. in degrees relative to the WGS 84 datum. The allowed range is from -180.000000 to +180.000000. Positive values represent longitudes east of the prime meridian; negative values west of the prime meridian.
                "antennaGain": 42, # Peak antenna gain in dBi. This parameter is an integer with a value between -127 and +128 (dBi) inclusive.
                "heightType": "A String", # Specifies how the height is measured.
                "indoorDeployment": True or False, # Whether the device antenna is indoor or not. True: indoor. False: outdoor.
                "antennaDowntilt": 42, # Antenna downtilt in degrees and is an integer with a value between -90 and +90 inclusive; a negative value means the antenna is tilted up (above horizontal). This parameter is optional for Category A devices and conditional for Category B devices.
                "horizontalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna horizontal location. This optional parameter should only be present if its value is less than the FCC requirement of 50 meters.
                "cpeCbsdIndication": True or False, # If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.
                "antennaAzimuth": 42, # Boresight direction of the horizontal plane of the antenna in degrees with respect to true north. The value of this parameter is an integer with a value between 0 and 359 inclusive. A value of 0 degrees means true north; a value of 90 degrees means east. This parameter is optional for Category A devices and conditional for Category B devices.
                "antennaBeamwidth": 42, # 3-dB antenna beamwidth of the antenna in the horizontal-plane in degrees. This parameter is an unsigned integer having a value between 0 and 360 (degrees) inclusive; it is optional for Category A devices and conditional for Category B devices.
                "latitude": 3.14, # Latitude of the device antenna location in degrees relative to the WGS 84 datum. The allowed range is from -90.000000 to +90.000000. Positive values represent latitudes north of the equator; negative values south of the equator.
                "verticalAccuracy": 3.14, # A positive number in meters to indicate accuracy of the device antenna vertical location. This optional parameter should only be present if its value is less than the FCC requirement of 3 meters.
              },
              "model": { # Information about the model of the device. # Information about this device model.
                "hardwareVersion": "A String", # The hardware version of the device.
                "firmwareVersion": "A String", # The firmware version of the device.
                "name": "A String", # The name of the device model.
                "vendor": "A String", # The name of the device vendor.
                "softwareVersion": "A String", # The software version of the device.
              },
              "state": "A String", # State of the configuration.
              "measurementCapabilities": [ # Measurement reporting capabilities of the device.
                "A String",
              ],
              "isSigned": True or False, # Output-only. Whether the configuration has been signed by a CPI.
              "userId": "A String", # The identifier of a device user.
              "updateTime": "A String", # Output-only. The last time the device configuration was edited.
              "callSign": "A String", # The call sign of the device operator.
              "airInterface": { # Information about the device's air interface. # Information about this device's air interface.
                "supportedSpec": "A String", # This field is related to the radioTechnology field and provides the air interface specification that the CBSD is compliant with at the time of registration. Optional
                "radioTechnology": "A String", # This field specifies the radio access technology that is used for the CBSD. Conditional
              },
              "category": "A String", # FCC category of the device.
            },
          },
        ],
        "nextPageToken": "A String", # A pagination token returned from a previous call to ListDevices method that indicates from where listing should continue. If the field is missing or empty, it means there is no more devices.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.