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:

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_deployments_getselectcustomersId, deploymentsIdReturns a requested deployment.
customers_nodes_deployments_listselectcustomersId, nodesIdfilter, pageSize, pageTokenLists deployments.
nodes_deployments_getselectnodesId, deploymentsIdReturns a requested deployment.
nodes_nodes_deployments_listselectnodesId, nodesId1filter, pageSize, pageTokenLists deployments.
customers_deployments_listselectcustomersIdfilter, pageSize, pageTokenLists deployments.
deployments_getselectdeploymentsIdReturns a requested deployment.
nodes_deployments_listselectnodesIdfilter, pageSize, pageTokenLists deployments.
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​

Returns a requested deployment.

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

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 }}"
}'
;