devices

Creates, updates, deletes, gets or lists a devices resource.

Overview

Name	devices
Type	Resource
Id	google.sasportal.devices

Fields

The following fields are returned by SELECT queries:

customers_deployments_devices_list

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

customers_devices_get

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

customers_nodes_devices_list

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

deployments_devices_get

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

nodes_deployments_devices_list

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

nodes_devices_get

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

nodes_nodes_devices_list

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

customers_devices_list

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

nodes_devices_list

Name	Datatype	Description
name	string	Output only. The resource path name.
activeConfig	object	Output only. Current configuration of the device as registered to the SAS. (id: SasPortalDeviceConfig)
currentChannels	array	Output only. Current channels with scores.
deviceMetadata	object	Device parameters that can be overridden by both SAS Portal and SAS registration requests. (id: SasPortalDeviceMetadata)
displayName	string	Device display name.
fccId	string	The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
grantRangeAllowlists	array	Only ranges that are within the allowlists are available for new grants.
grants	array	Output only. Grants held by the device.
preloadedConfig	object	Configuration of the device, as specified via SAS Portal API. (id: SasPortalDeviceConfig)
serialNumber	string	A serial number assigned to the device by the device manufacturer.
state	string	Output only. Device state. (DEVICE_STATE_UNSPECIFIED, RESERVED, REGISTERED, DEREGISTERED)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
customers_deployments_devices_list	select	customersId, deploymentsId	filter, pageSize, pageToken	Lists devices under a node or customer.
customers_devices_get	select	customersId, devicesId		Gets details about a device.
customers_nodes_devices_list	select	customersId, nodesId	filter, pageSize, pageToken	Lists devices under a node or customer.
deployments_devices_get	select	deploymentsId, devicesId		Gets details about a device.
nodes_deployments_devices_list	select	nodesId, deploymentsId	filter, pageSize, pageToken	Lists devices under a node or customer.
nodes_devices_get	select	nodesId, devicesId		Gets details about a device.
nodes_nodes_devices_list	select	nodesId, nodesId1	filter, pageSize, pageToken	Lists devices under a node or customer.
customers_devices_list	select	customersId	filter, pageSize, pageToken	Lists devices under a node or customer.
nodes_devices_list	select	nodesId	filter, pageSize, pageToken	Lists devices under a node or customer.
customers_deployments_devices_create	insert	customersId, deploymentsId		Creates a device under a node or customer.
customers_nodes_devices_create	insert	customersId, nodesId		Creates a device under a node or customer.
nodes_deployments_devices_create	insert	nodesId, deploymentsId		Creates a device under a node or customer.
nodes_nodes_devices_create	insert	nodesId, nodesId1		Creates a device under a node or customer.
customers_devices_create	insert	customersId		Creates a device under a node or customer.
nodes_devices_create	insert	nodesId		Creates a device under a node or customer.
customers_devices_patch	update	customersId, devicesId	updateMask	Updates a device.
deployments_devices_patch	update	deploymentsId, devicesId	updateMask	Updates a device.
nodes_devices_patch	update	nodesId, devicesId	updateMask	Updates a device.
customers_devices_delete	delete	customersId, devicesId		Deletes a device.
deployments_devices_delete	delete	deploymentsId, devicesId		Deletes a device.
nodes_devices_delete	delete	nodesId, devicesId		Deletes a device.
customers_devices_move	exec	customersId, devicesId		Moves a device under another node or customer.
customers_devices_sign_device	exec	customersId, devicesId		Signs a device.
deployments_devices_move	exec	deploymentsId, devicesId		Moves a device under another node or customer.
deployments_devices_sign_device	exec	deploymentsId, devicesId		Signs a device.
nodes_devices_move	exec	nodesId, devicesId		Moves a device under another node or customer.
nodes_devices_sign_device	exec	nodesId, devicesId		Signs a device.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
customersId	string
deploymentsId	string
devicesId	string
nodesId	string
nodesId1	string
filter	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)

SELECT examples

customers_deployments_devices_list

Lists devices under a node or customer.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE customersId = '{{ customersId }}' -- required
AND deploymentsId = '{{ deploymentsId }}' -- required
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

customers_devices_get

Gets details about a device.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE customersId = '{{ customersId }}' -- required
AND devicesId = '{{ devicesId }}' -- required
;

customers_nodes_devices_list

Lists devices under a node or customer.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE customersId = '{{ customersId }}' -- required
AND nodesId = '{{ nodesId }}' -- required
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

deployments_devices_get

Gets details about a device.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE deploymentsId = '{{ deploymentsId }}' -- required
AND devicesId = '{{ devicesId }}' -- required
;

nodes_deployments_devices_list

Lists devices under a node or customer.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE nodesId = '{{ nodesId }}' -- required
AND deploymentsId = '{{ deploymentsId }}' -- required
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

nodes_devices_get

Gets details about a device.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE nodesId = '{{ nodesId }}' -- required
AND devicesId = '{{ devicesId }}' -- required
;

nodes_nodes_devices_list

Lists devices under a node or customer.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE nodesId = '{{ nodesId }}' -- required
AND nodesId1 = '{{ nodesId1 }}' -- required
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

customers_devices_list

Lists devices under a node or customer.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE customersId = '{{ customersId }}' -- required
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

nodes_devices_list

Lists devices under a node or customer.

SELECT
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
FROM google.sasportal.devices
WHERE nodesId = '{{ nodesId }}' -- required
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

customers_deployments_devices_create

Creates a device under a node or customer.

INSERT INTO google.sasportal.devices (
data__activeConfig,
data__deviceMetadata,
data__displayName,
data__fccId,
data__grantRangeAllowlists,
data__grants,
data__name,
data__preloadedConfig,
data__serialNumber,
data__state,
customersId,
deploymentsId
)
SELECT 
'{{ activeConfig }}',
'{{ deviceMetadata }}',
'{{ displayName }}',
'{{ fccId }}',
'{{ grantRangeAllowlists }}',
'{{ grants }}',
'{{ name }}',
'{{ preloadedConfig }}',
'{{ serialNumber }}',
'{{ state }}',
'{{ customersId }}',
'{{ deploymentsId }}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
;

customers_nodes_devices_create

Creates a device under a node or customer.

INSERT INTO google.sasportal.devices (
data__activeConfig,
data__deviceMetadata,
data__displayName,
data__fccId,
data__grantRangeAllowlists,
data__grants,
data__name,
data__preloadedConfig,
data__serialNumber,
data__state,
customersId,
nodesId
)
SELECT 
'{{ activeConfig }}',
'{{ deviceMetadata }}',
'{{ displayName }}',
'{{ fccId }}',
'{{ grantRangeAllowlists }}',
'{{ grants }}',
'{{ name }}',
'{{ preloadedConfig }}',
'{{ serialNumber }}',
'{{ state }}',
'{{ customersId }}',
'{{ nodesId }}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
;

nodes_deployments_devices_create

Creates a device under a node or customer.

INSERT INTO google.sasportal.devices (
data__activeConfig,
data__deviceMetadata,
data__displayName,
data__fccId,
data__grantRangeAllowlists,
data__grants,
data__name,
data__preloadedConfig,
data__serialNumber,
data__state,
nodesId,
deploymentsId
)
SELECT 
'{{ activeConfig }}',
'{{ deviceMetadata }}',
'{{ displayName }}',
'{{ fccId }}',
'{{ grantRangeAllowlists }}',
'{{ grants }}',
'{{ name }}',
'{{ preloadedConfig }}',
'{{ serialNumber }}',
'{{ state }}',
'{{ nodesId }}',
'{{ deploymentsId }}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
;

nodes_nodes_devices_create

Creates a device under a node or customer.

INSERT INTO google.sasportal.devices (
data__activeConfig,
data__deviceMetadata,
data__displayName,
data__fccId,
data__grantRangeAllowlists,
data__grants,
data__name,
data__preloadedConfig,
data__serialNumber,
data__state,
nodesId,
nodesId1
)
SELECT 
'{{ activeConfig }}',
'{{ deviceMetadata }}',
'{{ displayName }}',
'{{ fccId }}',
'{{ grantRangeAllowlists }}',
'{{ grants }}',
'{{ name }}',
'{{ preloadedConfig }}',
'{{ serialNumber }}',
'{{ state }}',
'{{ nodesId }}',
'{{ nodesId1 }}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
;

customers_devices_create

Creates a device under a node or customer.

INSERT INTO google.sasportal.devices (
data__activeConfig,
data__deviceMetadata,
data__displayName,
data__fccId,
data__grantRangeAllowlists,
data__grants,
data__name,
data__preloadedConfig,
data__serialNumber,
data__state,
customersId
)
SELECT 
'{{ activeConfig }}',
'{{ deviceMetadata }}',
'{{ displayName }}',
'{{ fccId }}',
'{{ grantRangeAllowlists }}',
'{{ grants }}',
'{{ name }}',
'{{ preloadedConfig }}',
'{{ serialNumber }}',
'{{ state }}',
'{{ customersId }}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
;

nodes_devices_create

Creates a device under a node or customer.

INSERT INTO google.sasportal.devices (
data__activeConfig,
data__deviceMetadata,
data__displayName,
data__fccId,
data__grantRangeAllowlists,
data__grants,
data__name,
data__preloadedConfig,
data__serialNumber,
data__state,
nodesId
)
SELECT 
'{{ activeConfig }}',
'{{ deviceMetadata }}',
'{{ displayName }}',
'{{ fccId }}',
'{{ grantRangeAllowlists }}',
'{{ grants }}',
'{{ name }}',
'{{ preloadedConfig }}',
'{{ serialNumber }}',
'{{ state }}',
'{{ nodesId }}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state
;

Manifest

# Description fields are for documentation purposes
- name: devices
props:
  - name: customersId
    value: "{{ customersId }}"
    description: Required parameter for the devices resource.
  - name: deploymentsId
    value: "{{ deploymentsId }}"
    description: Required parameter for the devices resource.
  - name: nodesId
    value: "{{ nodesId }}"
    description: Required parameter for the devices resource.
  - name: nodesId1
    value: "{{ nodesId1 }}"
    description: Required parameter for the devices resource.
  - name: activeConfig
    description: |
      Output only. Current configuration of the device as registered to the SAS.
    value:
      airInterface:
        radioTechnology: "{{ radioTechnology }}"
        supportedSpec: "{{ supportedSpec }}"
      callSign: "{{ callSign }}"
      category: "{{ category }}"
      installationParams:
        antennaAzimuth: {{ antennaAzimuth }}
        antennaBeamwidth: {{ antennaBeamwidth }}
        antennaDowntilt: {{ antennaDowntilt }}
        antennaGain: {{ antennaGain }}
        antennaModel: "{{ antennaModel }}"
        cpeCbsdIndication: {{ cpeCbsdIndication }}
        eirpCapability: {{ eirpCapability }}
        height: {{ height }}
        heightType: "{{ heightType }}"
        horizontalAccuracy: {{ horizontalAccuracy }}
        indoorDeployment: {{ indoorDeployment }}
        latitude: {{ latitude }}
        longitude: {{ longitude }}
        verticalAccuracy: {{ verticalAccuracy }}
      isSigned: {{ isSigned }}
      measurementCapabilities:
        - "{{ measurementCapabilities }}"
      model:
        firmwareVersion: "{{ firmwareVersion }}"
        hardwareVersion: "{{ hardwareVersion }}"
        name: "{{ name }}"
        softwareVersion: "{{ softwareVersion }}"
        vendor: "{{ vendor }}"
      state: "{{ state }}"
      updateTime: "{{ updateTime }}"
      userId: "{{ userId }}"
  - name: deviceMetadata
    description: |
      Device parameters that can be overridden by both SAS Portal and SAS registration requests.
    value:
      antennaModel: "{{ antennaModel }}"
      commonChannelGroup: "{{ commonChannelGroup }}"
      interferenceCoordinationGroup: "{{ interferenceCoordinationGroup }}"
      nrqzValidated: {{ nrqzValidated }}
      nrqzValidation:
        caseId: "{{ caseId }}"
        cpiId: "{{ cpiId }}"
        latitude: {{ latitude }}
        longitude: {{ longitude }}
        state: "{{ state }}"
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Device display name.
  - name: fccId
    value: "{{ fccId }}"
    description: |
      The FCC identifier of the device. Refer to https://www.fcc.gov/oet/ea/fccid for FccID format. Accept underscores and periods because some test-SAS customers use them.
  - name: grantRangeAllowlists
    description: |
      Only ranges that are within the allowlists are available for new grants.
    value:
      - highFrequencyMhz: {{ highFrequencyMhz }}
        lowFrequencyMhz: {{ lowFrequencyMhz }}
  - name: grants
    description: |
      Output only. Grants held by the device.
    value:
      - channelType: "{{ channelType }}"
        expireTime: "{{ expireTime }}"
        frequencyRange:
          highFrequencyMhz: {{ highFrequencyMhz }}
          lowFrequencyMhz: {{ lowFrequencyMhz }}
        grantId: "{{ grantId }}"
        lastHeartbeatTransmitExpireTime: "{{ lastHeartbeatTransmitExpireTime }}"
        maxEirp: {{ maxEirp }}
        moveList: "{{ moveList }}"
        state: "{{ state }}"
        suspensionReason: "{{ suspensionReason }}"
  - name: name
    value: "{{ name }}"
    description: |
      Output only. The resource path name.
  - name: preloadedConfig
    description: |
      Configuration of the device, as specified via SAS Portal API.
    value:
      airInterface:
        radioTechnology: "{{ radioTechnology }}"
        supportedSpec: "{{ supportedSpec }}"
      callSign: "{{ callSign }}"
      category: "{{ category }}"
      installationParams:
        antennaAzimuth: {{ antennaAzimuth }}
        antennaBeamwidth: {{ antennaBeamwidth }}
        antennaDowntilt: {{ antennaDowntilt }}
        antennaGain: {{ antennaGain }}
        antennaModel: "{{ antennaModel }}"
        cpeCbsdIndication: {{ cpeCbsdIndication }}
        eirpCapability: {{ eirpCapability }}
        height: {{ height }}
        heightType: "{{ heightType }}"
        horizontalAccuracy: {{ horizontalAccuracy }}
        indoorDeployment: {{ indoorDeployment }}
        latitude: {{ latitude }}
        longitude: {{ longitude }}
        verticalAccuracy: {{ verticalAccuracy }}
      isSigned: {{ isSigned }}
      measurementCapabilities:
        - "{{ measurementCapabilities }}"
      model:
        firmwareVersion: "{{ firmwareVersion }}"
        hardwareVersion: "{{ hardwareVersion }}"
        name: "{{ name }}"
        softwareVersion: "{{ softwareVersion }}"
        vendor: "{{ vendor }}"
      state: "{{ state }}"
      updateTime: "{{ updateTime }}"
      userId: "{{ userId }}"
  - name: serialNumber
    value: "{{ serialNumber }}"
    description: |
      A serial number assigned to the device by the device manufacturer.
  - name: state
    value: "{{ state }}"
    description: |
      Output only. Device state.
    valid_values: ['DEVICE_STATE_UNSPECIFIED', 'RESERVED', 'REGISTERED', 'DEREGISTERED']

UPDATE examples

customers_devices_patch

Updates a device.

UPDATE google.sasportal.devices
SET 
data__activeConfig = '{{ activeConfig }}',
data__deviceMetadata = '{{ deviceMetadata }}',
data__displayName = '{{ displayName }}',
data__fccId = '{{ fccId }}',
data__grantRangeAllowlists = '{{ grantRangeAllowlists }}',
data__grants = '{{ grants }}',
data__name = '{{ name }}',
data__preloadedConfig = '{{ preloadedConfig }}',
data__serialNumber = '{{ serialNumber }}',
data__state = '{{ state }}'
WHERE 
customersId = '{{ customersId }}' --required
AND devicesId = '{{ devicesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state;

deployments_devices_patch

Updates a device.

UPDATE google.sasportal.devices
SET 
data__activeConfig = '{{ activeConfig }}',
data__deviceMetadata = '{{ deviceMetadata }}',
data__displayName = '{{ displayName }}',
data__fccId = '{{ fccId }}',
data__grantRangeAllowlists = '{{ grantRangeAllowlists }}',
data__grants = '{{ grants }}',
data__name = '{{ name }}',
data__preloadedConfig = '{{ preloadedConfig }}',
data__serialNumber = '{{ serialNumber }}',
data__state = '{{ state }}'
WHERE 
deploymentsId = '{{ deploymentsId }}' --required
AND devicesId = '{{ devicesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state;

nodes_devices_patch

Updates a device.

UPDATE google.sasportal.devices
SET 
data__activeConfig = '{{ activeConfig }}',
data__deviceMetadata = '{{ deviceMetadata }}',
data__displayName = '{{ displayName }}',
data__fccId = '{{ fccId }}',
data__grantRangeAllowlists = '{{ grantRangeAllowlists }}',
data__grants = '{{ grants }}',
data__name = '{{ name }}',
data__preloadedConfig = '{{ preloadedConfig }}',
data__serialNumber = '{{ serialNumber }}',
data__state = '{{ state }}'
WHERE 
nodesId = '{{ nodesId }}' --required
AND devicesId = '{{ devicesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
activeConfig,
currentChannels,
deviceMetadata,
displayName,
fccId,
grantRangeAllowlists,
grants,
preloadedConfig,
serialNumber,
state;

DELETE examples

customers_devices_delete

Deletes a device.

DELETE FROM google.sasportal.devices
WHERE customersId = '{{ customersId }}' --required
AND devicesId = '{{ devicesId }}' --required
;

deployments_devices_delete

Deletes a device.

DELETE FROM google.sasportal.devices
WHERE deploymentsId = '{{ deploymentsId }}' --required
AND devicesId = '{{ devicesId }}' --required
;

nodes_devices_delete

Deletes a device.

DELETE FROM google.sasportal.devices
WHERE nodesId = '{{ nodesId }}' --required
AND devicesId = '{{ devicesId }}' --required
;

Lifecycle Methods

customers_devices_move

Moves a device under another node or customer.

EXEC google.sasportal.devices.customers_devices_move 
@customersId='{{ customersId }}' --required, 
@devicesId='{{ devicesId }}' --required 
@@json=
'{
"destination": "{{ destination }}"
}'
;

customers_devices_sign_device

Signs a device.

EXEC google.sasportal.devices.customers_devices_sign_device 
@customersId='{{ customersId }}' --required, 
@devicesId='{{ devicesId }}' --required 
@@json=
'{
"device": "{{ device }}"
}'
;

deployments_devices_move

Moves a device under another node or customer.

EXEC google.sasportal.devices.deployments_devices_move 
@deploymentsId='{{ deploymentsId }}' --required, 
@devicesId='{{ devicesId }}' --required 
@@json=
'{
"destination": "{{ destination }}"
}'
;

deployments_devices_sign_device

Signs a device.

EXEC google.sasportal.devices.deployments_devices_sign_device 
@deploymentsId='{{ deploymentsId }}' --required, 
@devicesId='{{ devicesId }}' --required 
@@json=
'{
"device": "{{ device }}"
}'
;

nodes_devices_move

Moves a device under another node or customer.

EXEC google.sasportal.devices.nodes_devices_move 
@nodesId='{{ nodesId }}' --required, 
@devicesId='{{ devicesId }}' --required 
@@json=
'{
"destination": "{{ destination }}"
}'
;

nodes_devices_sign_device

Signs a device.

EXEC google.sasportal.devices.nodes_devices_sign_device 
@nodesId='{{ nodesId }}' --required, 
@devicesId='{{ devicesId }}' --required 
@@json=
'{
"device": "{{ device }}"
}'
;