Skip to main content

deployments

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

Overview

Namedeployments
TypeResource
Idgoogle.prod_tt_sasportal.deployments

Fields

The following fields are returned by SELECT queries:

Successful response

NameDatatypeDescription
namestringOutput only. Resource name.
displayNamestringThe deployment's display name.
frnsarrayOutput only. The FCC Registration Numbers (FRNs) copied from its direct parent.
sasUserIdsarrayUser ID used by the devices belonging to this deployment. Each deployment should be associated with one unique user ID.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
customers_nodes_deployments_listselectcustomersId, nodesIdpageSize, pageToken, filterLists deployments.
customers_deployments_getselectcustomersId, deploymentsIdReturns a requested deployment.
nodes_nodes_deployments_listselectnodesId, nodesId1pageSize, pageToken, filterLists deployments.
nodes_deployments_getselectnodesId, deploymentsIdReturns a requested deployment.
customers_deployments_listselectcustomersIdpageSize, pageToken, filterLists deployments.
nodes_deployments_listselectnodesIdpageSize, pageToken, filterLists deployments.
deployments_getselectdeploymentsIdReturns a requested deployment.
customers_nodes_deployments_createinsertcustomersId, nodesIdCreates a new deployment.
nodes_nodes_deployments_createinsertnodesId, nodesId1Creates a new deployment.
customers_deployments_createinsertcustomersIdCreates a new deployment.
customers_deployments_patchupdatecustomersId, deploymentsIdupdateMaskUpdates an existing deployment.
nodes_deployments_patchupdatenodesId, deploymentsIdupdateMaskUpdates an existing deployment.
customers_deployments_deletedeletecustomersId, deploymentsIdDeletes a deployment.
nodes_deployments_deletedeletenodesId, deploymentsIdDeletes a deployment.
customers_deployments_moveexeccustomersId, deploymentsIdMoves a deployment under another node or customer.
nodes_deployments_moveexecnodesId, deploymentsIdMoves a deployment under another node or customer.

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.

NameDatatypeDescription
customersIdstring
deploymentsIdstring
nodesIdstring
nodesId1string
filterstring
pageSizeinteger (int32)
pageTokenstring
updateMaskstring (google-fieldmask)

SELECT examples

Lists deployments.

SELECT
name,
displayName,
frns,
sasUserIds
FROM google.prod_tt_sasportal.deployments
WHERE customersId = '{{ customersId }}' -- required
AND nodesId = '{{ nodesId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}';

INSERT examples

Creates a new deployment.

INSERT INTO google.prod_tt_sasportal.deployments (
data__displayName,
data__sasUserIds,
customersId,
nodesId
)
SELECT
'{{ displayName }}',
'{{ sasUserIds }}',
'{{ customersId }}',
'{{ nodesId }}'
RETURNING
name,
displayName,
frns,
sasUserIds
;

UPDATE examples

Updates an existing deployment.

UPDATE google.prod_tt_sasportal.deployments
SET
data__displayName = '{{ displayName }}',
data__sasUserIds = '{{ sasUserIds }}'
WHERE
customersId = '{{ customersId }}' --required
AND deploymentsId = '{{ deploymentsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
displayName,
frns,
sasUserIds;

DELETE examples

Deletes a deployment.

DELETE FROM google.prod_tt_sasportal.deployments
WHERE customersId = '{{ customersId }}' --required
AND deploymentsId = '{{ deploymentsId }}' --required;

Lifecycle Methods

Moves a deployment under another node or customer.

EXEC google.prod_tt_sasportal.deployments.customers_deployments_move 
@customersId='{{ customersId }}' --required,
@deploymentsId='{{ deploymentsId }}' --required
@@json=
'{
"destination": "{{ destination }}"
}';