{ "baseUrl": "https://prod-tt-sasportal.googleapis.com/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/sasportal": { "description": "Read, create, update, and delete your SAS Portal data." } } } }, "canonicalName": "SAS Portal Testing", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "ownerDomain": "google.com", "fullyEncodeReservedExpansion": true, "resources": { "nodes": { "resources": { "deployments": { "methods": { "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalDeployment" }, "httpMethod": "PATCH", "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}", "description": "Updates an existing deployment.", "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalDeployment" }, "parameters": { "name": { "location": "path", "description": "Output only. Resource name.", "type": "string", "pattern": "^nodes/[^/]+/deployments/[^/]+$", "required": true }, "updateMask": { "description": "Fields to be updated.", "format": "google-fieldmask", "location": "query", "type": "string" } }, "id": "prod_tt_sasportal.nodes.deployments.patch" }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.nodes.deployments.delete", "parameterOrder": [ "name" ], "httpMethod": "DELETE", "response": { "$ref": "SasPortalEmpty" }, "description": "Deletes a deployment.", "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}", "parameters": { "name": { "type": "string", "pattern": "^nodes/[^/]+/deployments/[^/]+$", "required": true, "location": "path", "description": "Required. The name of the deployment." } } }, "move": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.nodes.deployments.move", "response": { "$ref": "SasPortalOperation" }, "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}:move", "path": "v1alpha1/{+name}:move", "request": { "$ref": "SasPortalMoveDeploymentRequest" }, "httpMethod": "POST", "description": "Moves a deployment under another node or customer.", "parameters": { "name": { "type": "string", "pattern": "^nodes/[^/]+/deployments/[^/]+$", "required": true, "description": "Required. The name of the deployment to move.", "location": "path" } }, "parameterOrder": [ "name" ] }, "get": { "description": "Returns a requested deployment.", "parameterOrder": [ "name" ], "id": "prod_tt_sasportal.nodes.deployments.get", "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}", "parameters": { "name": { "pattern": "^nodes/[^/]+/deployments/[^/]+$", "location": "path", "type": "string", "description": "Required. The name of the deployment.", "required": true } }, "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDeployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "GET" }, "list": { "response": { "$ref": "SasPortalListDeploymentsResponse" }, "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.nodes.deployments.list", "flatPath": "v1alpha1/nodes/{nodesId}/deployments", "path": "v1alpha1/{+parent}/deployments", "httpMethod": "GET", "description": "Lists deployments.", "parameters": { "pageSize": { "description": "The maximum number of deployments to return in the response.", "location": "query", "format": "int32", "type": "integer" }, "filter": { "location": "query", "type": "string", "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no deployments are filtered." }, "parent": { "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "required": true, "location": "path", "type": "string", "pattern": "^nodes/[^/]+$" }, "pageToken": { "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from.", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] } }, "resources": { "devices": { "methods": { "list": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/devices", "id": "prod_tt_sasportal.nodes.deployments.devices.list", "response": { "$ref": "SasPortalListDevicesResponse" }, "httpMethod": "GET", "parameters": { "parent": { "type": "string", "pattern": "^nodes/[^/]+/deployments/[^/]+$", "required": true, "description": "Required. The name of the parent resource.", "location": "path" }, "pageToken": { "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.", "type": "string", "location": "query" }, "filter": { "location": "query", "description": "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.", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "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]." } }, "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}/devices", "description": "Lists devices under a node or customer." }, "createSigned": { "response": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/devices:createSigned", "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}/devices:createSigned", "parameters": { "parent": { "required": true, "type": "string", "description": "Required. The name of the parent resource.", "location": "path", "pattern": "^nodes/[^/]+/deployments/[^/]+$" } }, "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "id": "prod_tt_sasportal.nodes.deployments.devices.createSigned", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "description": "Creates a signed device under a node or customer." }, "create": { "request": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}/devices", "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalDevice" }, "parameters": { "parent": { "location": "path", "type": "string", "required": true, "pattern": "^nodes/[^/]+/deployments/[^/]+$", "description": "Required. The name of the parent resource." } }, "description": "Creates a device under a node or customer.", "id": "prod_tt_sasportal.nodes.deployments.devices.create", "httpMethod": "POST", "parameterOrder": [ "parent" ] } } } } }, "nodes": { "resources": { "devices": { "methods": { "list": { "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/devices", "parameterOrder": [ "parent" ], "httpMethod": "GET", "response": { "$ref": "SasPortalListDevicesResponse" }, "id": "prod_tt_sasportal.nodes.nodes.devices.list", "parameters": { "pageToken": { "type": "string", "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.", "location": "query" }, "filter": { "location": "query", "type": "string", "description": "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." }, "parent": { "location": "path", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string", "required": true, "description": "Required. The name of the parent resource." }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "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]." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Lists devices under a node or customer.", "path": "v1alpha1/{+parent}/devices" }, "create": { "path": "v1alpha1/{+parent}/devices", "httpMethod": "POST", "parameterOrder": [ "parent" ], "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalDevice" }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/devices", "parameters": { "parent": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "description": "Required. The name of the parent resource.", "type": "string", "location": "path", "required": true } }, "description": "Creates a device under a node or customer.", "id": "prod_tt_sasportal.nodes.nodes.devices.create" }, "createSigned": { "id": "prod_tt_sasportal.nodes.nodes.devices.createSigned", "path": "v1alpha1/{+parent}/devices:createSigned", "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "parameterOrder": [ "parent" ], "description": "Creates a signed device under a node or customer.", "httpMethod": "POST", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/devices:createSigned", "parameters": { "parent": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "location": "path", "description": "Required. The name of the parent resource.", "type": "string", "required": true } } } } }, "deployments": { "methods": { "list": { "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/deployments", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from." }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of deployments to return in the response." }, "filter": { "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no deployments are filtered.", "type": "string", "location": "query" }, "parent": { "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "location": "path", "type": "string", "required": true } }, "description": "Lists deployments.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" }, "id": "prod_tt_sasportal.nodes.nodes.deployments.list" }, "create": { "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/deployments", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The parent resource name where the deployment is to be created.", "required": true, "pattern": "^nodes/[^/]+/nodes/[^/]+$" } }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/deployments", "description": "Creates a new deployment.", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.nodes.nodes.deployments.create", "request": { "$ref": "SasPortalDeployment" }, "response": { "$ref": "SasPortalDeployment" } } } }, "nodes": { "methods": { "create": { "description": "Creates a new node.", "httpMethod": "POST", "path": "v1alpha1/{+parent}/nodes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "parent": { "type": "string", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "required": true, "location": "path", "description": "Required. The parent resource name where the node is to be created." } }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/nodes", "id": "prod_tt_sasportal.nodes.nodes.nodes.create", "parameterOrder": [ "parent" ], "request": { "$ref": "SasPortalNode" }, "response": { "$ref": "SasPortalNode" } }, "list": { "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/nodes", "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "pageToken": { "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from.", "location": "query", "type": "string" }, "filter": { "type": "string", "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no nodes are filtered.", "location": "query" }, "parent": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string", "required": true, "description": "Required. The parent resource name, for example, \"nodes/1\".", "location": "path" }, "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of nodes to return in the response." } }, "response": { "$ref": "SasPortalListNodesResponse" }, "description": "Lists nodes.", "id": "prod_tt_sasportal.nodes.nodes.nodes.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/nodes" } } } }, "methods": { "patch": { "description": "Updates an existing node.", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}", "httpMethod": "PATCH", "id": "prod_tt_sasportal.nodes.nodes.patch", "response": { "$ref": "SasPortalNode" }, "parameters": { "updateMask": { "description": "Fields to be updated.", "format": "google-fieldmask", "type": "string", "location": "query" }, "name": { "required": true, "description": "Output only. Resource name.", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "location": "path", "type": "string" } }, "parameterOrder": [ "name" ], "path": "v1alpha1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalNode" } }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Lists nodes.", "id": "prod_tt_sasportal.nodes.nodes.list", "parameters": { "pageToken": { "location": "query", "type": "string", "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from." }, "filter": { "type": "string", "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no nodes are filtered.", "location": "query" }, "parent": { "pattern": "^nodes/[^/]+$", "location": "path", "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\".", "required": true }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The maximum number of nodes to return in the response." } }, "parameterOrder": [ "parent" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes", "response": { "$ref": "SasPortalListNodesResponse" }, "httpMethod": "GET", "path": "v1alpha1/{+parent}/nodes" }, "get": { "response": { "$ref": "SasPortalNode" }, "parameters": { "name": { "location": "path", "description": "Required. The name of the node.", "required": true, "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string" } }, "description": "Returns a requested node.", "httpMethod": "GET", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.nodes.nodes.get", "path": "v1alpha1/{+name}" }, "move": { "httpMethod": "POST", "parameterOrder": [ "name" ], "id": "prod_tt_sasportal.nodes.nodes.move", "path": "v1alpha1/{+name}:move", "parameters": { "name": { "required": true, "pattern": "^nodes/[^/]+/nodes/[^/]+$", "description": "Required. The name of the node to move.", "type": "string", "location": "path" } }, "response": { "$ref": "SasPortalOperation" }, "request": { "$ref": "SasPortalMoveNodeRequest" }, "description": "Moves a node under another node or customer.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}:move" }, "create": { "flatPath": "v1alpha1/nodes/{nodesId}/nodes", "request": { "$ref": "SasPortalNode" }, "response": { "$ref": "SasPortalNode" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.nodes.nodes.create", "path": "v1alpha1/{+parent}/nodes", "parameters": { "parent": { "type": "string", "pattern": "^nodes/[^/]+$", "required": true, "description": "Required. The parent resource name where the node is to be created.", "location": "path" } }, "description": "Creates a new node." }, "delete": { "parameterOrder": [ "name" ], "description": "Deletes a node.", "path": "v1alpha1/{+name}", "httpMethod": "DELETE", "response": { "$ref": "SasPortalEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}", "id": "prod_tt_sasportal.nodes.nodes.delete", "parameters": { "name": { "required": true, "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string", "description": "Required. The name of the node.", "location": "path" } } } } }, "devices": { "methods": { "signDevice": { "response": { "$ref": "SasPortalEmpty" }, "id": "prod_tt_sasportal.nodes.devices.signDevice", "path": "v1alpha1/{+name}:signDevice", "request": { "$ref": "SasPortalSignDeviceRequest" }, "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}:signDevice", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^nodes/[^/]+/devices/[^/]+$", "location": "path", "type": "string", "description": "Output only. The resource path name.", "required": true } }, "httpMethod": "POST", "description": "Signs a device." }, "move": { "path": "v1alpha1/{+name}:move", "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalOperation" }, "parameters": { "name": { "required": true, "description": "Required. The name of the device to move.", "location": "path", "type": "string", "pattern": "^nodes/[^/]+/devices/[^/]+$" } }, "description": "Moves a device under another node or customer.", "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}:move", "httpMethod": "POST", "request": { "$ref": "SasPortalMoveDeviceRequest" }, "id": "prod_tt_sasportal.nodes.devices.move", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "patch": { "id": "prod_tt_sasportal.nodes.devices.patch", "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}", "description": "Updates a device.", "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}", "httpMethod": "PATCH", "request": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "name" ], "parameters": { "updateMask": { "description": "Fields to be updated.", "format": "google-fieldmask", "location": "query", "type": "string" }, "name": { "location": "path", "pattern": "^nodes/[^/]+/devices/[^/]+$", "required": true, "type": "string", "description": "Output only. The resource path name." } } }, "delete": { "parameters": { "name": { "location": "path", "description": "Required. The name of the device.", "type": "string", "pattern": "^nodes/[^/]+/devices/[^/]+$", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "DELETE", "response": { "$ref": "SasPortalEmpty" }, "parameterOrder": [ "name" ], "description": "Deletes a device.", "id": "prod_tt_sasportal.nodes.devices.delete", "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}" }, "updateSigned": { "id": "prod_tt_sasportal.nodes.devices.updateSigned", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalUpdateSignedDeviceRequest" }, "description": "Updates a signed device.", "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}:updateSigned", "httpMethod": "PATCH", "path": "v1alpha1/{+name}:updateSigned", "parameters": { "name": { "required": true, "pattern": "^nodes/[^/]+/devices/[^/]+$", "description": "Required. The name of the device to update.", "location": "path", "type": "string" } }, "response": { "$ref": "SasPortalDevice" } }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalDevice" }, "parameters": { "parent": { "type": "string", "pattern": "^nodes/[^/]+$", "location": "path", "description": "Required. The name of the parent resource.", "required": true } }, "description": "Creates a device under a node or customer.", "id": "prod_tt_sasportal.nodes.devices.create", "httpMethod": "POST", "response": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "parent" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices", "path": "v1alpha1/{+parent}/devices" }, "createSigned": { "response": { "$ref": "SasPortalDevice" }, "httpMethod": "POST", "path": "v1alpha1/{+parent}/devices:createSigned", "id": "prod_tt_sasportal.nodes.devices.createSigned", "parameters": { "parent": { "location": "path", "description": "Required. The name of the parent resource.", "type": "string", "required": true, "pattern": "^nodes/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices:createSigned", "description": "Creates a signed device under a node or customer.", "parameterOrder": [ "parent" ], "request": { "$ref": "SasPortalCreateSignedDeviceRequest" } }, "get": { "response": { "$ref": "SasPortalDevice" }, "parameters": { "name": { "pattern": "^nodes/[^/]+/devices/[^/]+$", "location": "path", "type": "string", "required": true, "description": "Required. The name of the device." } }, "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.nodes.devices.get", "path": "v1alpha1/{+name}", "description": "Gets details about a device." }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "pageToken": { "location": "query", "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.", "type": "string" }, "parent": { "pattern": "^nodes/[^/]+$", "location": "path", "description": "Required. The name of the parent resource.", "required": true, "type": "string" }, "filter": { "description": "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.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "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]." } }, "httpMethod": "GET", "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" }, "description": "Lists devices under a node or customer.", "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.nodes.devices.list", "flatPath": "v1alpha1/nodes/{nodesId}/devices" } } } }, "methods": { "get": { "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the node.", "pattern": "^nodes/[^/]+$", "type": "string" } }, "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalNode" }, "httpMethod": "GET", "flatPath": "v1alpha1/nodes/{nodesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Returns a requested node.", "id": "prod_tt_sasportal.nodes.get", "parameterOrder": [ "name" ] } } }, "customers": { "methods": { "listLegacyOrganizations": { "flatPath": "v1alpha1/customers:listLegacyOrganizations", "parameterOrder": [], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/customers:listLegacyOrganizations", "description": "Returns a list of legacy organizations.", "id": "prod_tt_sasportal.customers.listLegacyOrganizations", "response": { "$ref": "SasPortalListLegacyOrganizationsResponse" }, "parameters": {}, "httpMethod": "GET" }, "migrateOrganization": { "flatPath": "v1alpha1/customers:migrateOrganization", "parameterOrder": [], "request": { "$ref": "SasPortalMigrateOrganizationRequest" }, "response": { "$ref": "SasPortalOperation" }, "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/customers:migrateOrganization", "description": "Migrates a SAS organization to the cloud. This will create GCP projects for each deployment and associate them. The SAS Organization is linked to the gcp project that called the command. go/sas-legacy-customer-migration", "parameters": {}, "id": "prod_tt_sasportal.customers.migrateOrganization" }, "patch": { "flatPath": "v1alpha1/customers/{customersId}", "request": { "$ref": "SasPortalCustomer" }, "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalCustomer" }, "id": "prod_tt_sasportal.customers.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Updates an existing customer.", "parameters": { "name": { "description": "Output only. Resource name of the customer.", "required": true, "type": "string", "location": "path", "pattern": "^customers/[^/]+$" }, "updateMask": { "location": "query", "description": "Fields to be updated.", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "httpMethod": "PATCH" }, "listGcpProjectDeployments": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/customers:listGcpProjectDeployments", "parameterOrder": [], "path": "v1alpha1/customers:listGcpProjectDeployments", "response": { "$ref": "SasPortalListGcpProjectDeploymentsResponse" }, "parameters": {}, "description": "Returns a list of SAS deployments associated with current GCP project. Includes whether SAS analytics has been enabled or not.", "httpMethod": "GET", "id": "prod_tt_sasportal.customers.listGcpProjectDeployments" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.customers.list", "parameterOrder": [], "path": "v1alpha1/customers", "httpMethod": "GET", "response": { "$ref": "SasPortalListCustomersResponse" }, "flatPath": "v1alpha1/customers", "description": "Returns a list of requested customers.", "parameters": { "pageSize": { "description": "The maximum number of customers to return in the response.", "type": "integer", "location": "query", "format": "int32" }, "pageToken": { "description": "A pagination token returned from a previous call to ListCustomers that indicates where this listing should continue from.", "location": "query", "type": "string" } } }, "setupSasAnalytics": { "parameters": {}, "path": "v1alpha1/customers:setupSasAnalytics", "description": "Setups the a GCP Project to receive SAS Analytics messages via GCP Pub/Sub with a subscription to BigQuery. All the Pub/Sub topics and BigQuery tables are created automatically as part of this service.", "id": "prod_tt_sasportal.customers.setupSasAnalytics", "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [], "request": { "$ref": "SasPortalSetupSasAnalyticsRequest" }, "response": { "$ref": "SasPortalOperation" }, "flatPath": "v1alpha1/customers:setupSasAnalytics" }, "provisionDeployment": { "path": "v1alpha1/customers:provisionDeployment", "parameters": {}, "id": "prod_tt_sasportal.customers.provisionDeployment", "parameterOrder": [], "httpMethod": "POST", "request": { "$ref": "SasPortalProvisionDeploymentRequest" }, "flatPath": "v1alpha1/customers:provisionDeployment", "description": "Creates a new SAS deployment through the GCP workflow. Creates a SAS organization if an organization match is not found.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalProvisionDeploymentResponse" } }, "get": { "parameters": { "name": { "pattern": "^customers/[^/]+$", "type": "string", "required": true, "description": "Required. The name of the customer.", "location": "path" } }, "parameterOrder": [ "name" ], "path": "v1alpha1/{+name}", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.customers.get", "flatPath": "v1alpha1/customers/{customersId}", "response": { "$ref": "SasPortalCustomer" }, "description": "Returns a requested customer." } }, "resources": { "deployments": { "methods": { "create": { "parameters": { "parent": { "required": true, "description": "Required. The parent resource name where the deployment is to be created.", "type": "string", "pattern": "^customers/[^/]+$", "location": "path" } }, "description": "Creates a new deployment.", "httpMethod": "POST", "path": "v1alpha1/{+parent}/deployments", "request": { "$ref": "SasPortalDeployment" }, "flatPath": "v1alpha1/customers/{customersId}/deployments", "id": "prod_tt_sasportal.customers.deployments.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDeployment" }, "parameterOrder": [ "parent" ] }, "move": { "path": "v1alpha1/{+name}:move", "id": "prod_tt_sasportal.customers.deployments.move", "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalMoveDeploymentRequest" }, "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}:move", "parameters": { "name": { "description": "Required. The name of the deployment to move.", "pattern": "^customers/[^/]+/deployments/[^/]+$", "location": "path", "type": "string", "required": true } }, "httpMethod": "POST", "description": "Moves a deployment under another node or customer.", "response": { "$ref": "SasPortalOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "get": { "path": "v1alpha1/{+name}", "description": "Returns a requested deployment.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDeployment" }, "parameters": { "name": { "location": "path", "description": "Required. The name of the deployment.", "type": "string", "required": true, "pattern": "^customers/[^/]+/deployments/[^/]+$" } }, "id": "prod_tt_sasportal.customers.deployments.get", "httpMethod": "GET", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}" }, "patch": { "request": { "$ref": "SasPortalDeployment" }, "path": "v1alpha1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}", "httpMethod": "PATCH", "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalDeployment" }, "parameters": { "updateMask": { "description": "Fields to be updated.", "format": "google-fieldmask", "location": "query", "type": "string" }, "name": { "pattern": "^customers/[^/]+/deployments/[^/]+$", "required": true, "type": "string", "location": "path", "description": "Output only. Resource name." } }, "id": "prod_tt_sasportal.customers.deployments.patch", "description": "Updates an existing deployment." }, "delete": { "httpMethod": "DELETE", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^customers/[^/]+/deployments/[^/]+$", "required": true, "location": "path", "type": "string", "description": "Required. The name of the deployment." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.customers.deployments.delete", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}", "response": { "$ref": "SasPortalEmpty" }, "description": "Deletes a deployment.", "path": "v1alpha1/{+name}" }, "list": { "path": "v1alpha1/{+parent}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "pageToken": { "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from.", "location": "query", "type": "string" }, "filter": { "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no deployments are filtered.", "location": "query", "type": "string" }, "pageSize": { "format": "int32", "location": "query", "type": "integer", "description": "The maximum number of deployments to return in the response." }, "parent": { "location": "path", "pattern": "^customers/[^/]+$", "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "required": true } }, "id": "prod_tt_sasportal.customers.deployments.list", "parameterOrder": [ "parent" ], "httpMethod": "GET", "flatPath": "v1alpha1/customers/{customersId}/deployments", "description": "Lists deployments." } }, "resources": { "devices": { "methods": { "list": { "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}/devices", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalListDevicesResponse" }, "path": "v1alpha1/{+parent}/devices", "httpMethod": "GET", "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.customers.deployments.devices.list", "parameters": { "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "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]." }, "pageToken": { "location": "query", "type": "string", "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from." }, "filter": { "type": "string", "location": "query", "description": "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." }, "parent": { "required": true, "type": "string", "pattern": "^customers/[^/]+/deployments/[^/]+$", "description": "Required. The name of the parent resource.", "location": "path" } }, "description": "Lists devices under a node or customer." }, "createSigned": { "parameterOrder": [ "parent" ], "description": "Creates a signed device under a node or customer.", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}/devices:createSigned", "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The name of the parent resource.", "location": "path", "pattern": "^customers/[^/]+/deployments/[^/]+$" } }, "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "id": "prod_tt_sasportal.customers.deployments.devices.createSigned", "path": "v1alpha1/{+parent}/devices:createSigned" }, "create": { "request": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/devices", "parameterOrder": [ "parent" ], "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}/devices", "description": "Creates a device under a node or customer.", "httpMethod": "POST", "id": "prod_tt_sasportal.customers.deployments.devices.create", "response": { "$ref": "SasPortalDevice" }, "parameters": { "parent": { "type": "string", "required": true, "description": "Required. The name of the parent resource.", "location": "path", "pattern": "^customers/[^/]+/deployments/[^/]+$" } } } } } } }, "nodes": { "resources": { "devices": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.customers.nodes.devices.list", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/devices", "description": "Lists devices under a node or customer.", "parameters": { "parent": { "required": true, "type": "string", "location": "path", "description": "Required. The name of the parent resource.", "pattern": "^customers/[^/]+/nodes/[^/]+$" }, "pageSize": { "format": "int32", "type": "integer", "description": "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].", "location": "query" }, "filter": { "description": "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.", "location": "query", "type": "string" }, "pageToken": { "location": "query", "type": "string", "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from." } }, "parameterOrder": [ "parent" ], "response": { "$ref": "SasPortalListDevicesResponse" }, "httpMethod": "GET", "path": "v1alpha1/{+parent}/devices" }, "createSigned": { "parameters": { "parent": { "description": "Required. The name of the parent resource.", "type": "string", "location": "path", "pattern": "^customers/[^/]+/nodes/[^/]+$", "required": true } }, "id": "prod_tt_sasportal.customers.nodes.devices.createSigned", "description": "Creates a signed device under a node or customer.", "httpMethod": "POST", "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/devices:createSigned", "response": { "$ref": "SasPortalDevice" }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/devices:createSigned", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalCreateSignedDeviceRequest" } }, "create": { "description": "Creates a device under a node or customer.", "parameters": { "parent": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The name of the parent resource." } }, "path": "v1alpha1/{+parent}/devices", "httpMethod": "POST", "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.customers.nodes.devices.create", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDevice" }, "request": { "$ref": "SasPortalDevice" }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/devices" } } }, "nodes": { "methods": { "create": { "id": "prod_tt_sasportal.customers.nodes.nodes.create", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/nodes", "request": { "$ref": "SasPortalNode" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "response": { "$ref": "SasPortalNode" }, "parameters": { "parent": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "required": true, "description": "Required. The parent resource name where the node is to be created.", "type": "string", "location": "path" } }, "description": "Creates a new node.", "httpMethod": "POST", "path": "v1alpha1/{+parent}/nodes" }, "list": { "parameters": { "pageSize": { "type": "integer", "format": "int32", "location": "query", "description": "The maximum number of nodes to return in the response." }, "pageToken": { "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from.", "location": "query", "type": "string" }, "filter": { "location": "query", "type": "string", "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no nodes are filtered." }, "parent": { "location": "path", "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\".", "required": true, "pattern": "^customers/[^/]+/nodes/[^/]+$" } }, "path": "v1alpha1/{+parent}/nodes", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/nodes", "response": { "$ref": "SasPortalListNodesResponse" }, "httpMethod": "GET", "description": "Lists nodes.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.customers.nodes.nodes.list" } } }, "deployments": { "methods": { "list": { "httpMethod": "GET", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/deployments", "parameters": { "pageToken": { "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from.", "type": "string", "location": "query" }, "parent": { "required": true, "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "pattern": "^customers/[^/]+/nodes/[^/]+$", "location": "path" }, "pageSize": { "location": "query", "description": "The maximum number of deployments to return in the response.", "format": "int32", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no deployments are filtered." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/deployments", "response": { "$ref": "SasPortalListDeploymentsResponse" }, "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.customers.nodes.deployments.list", "description": "Lists deployments." }, "create": { "path": "v1alpha1/{+parent}/deployments", "parameterOrder": [ "parent" ], "parameters": { "parent": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "type": "string", "required": true, "description": "Required. The parent resource name where the deployment is to be created.", "location": "path" } }, "httpMethod": "POST", "response": { "$ref": "SasPortalDeployment" }, "description": "Creates a new deployment.", "id": "prod_tt_sasportal.customers.nodes.deployments.create", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/deployments", "request": { "$ref": "SasPortalDeployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] } } } }, "methods": { "get": { "parameters": { "name": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "location": "path", "description": "Required. The name of the node.", "type": "string", "required": true } }, "description": "Returns a requested node.", "httpMethod": "GET", "path": "v1alpha1/{+name}", "id": "prod_tt_sasportal.customers.nodes.get", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}", "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalNode" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "move": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalMoveNodeRequest" }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}:move", "parameterOrder": [ "name" ], "id": "prod_tt_sasportal.customers.nodes.move", "response": { "$ref": "SasPortalOperation" }, "parameters": { "name": { "type": "string", "required": true, "pattern": "^customers/[^/]+/nodes/[^/]+$", "description": "Required. The name of the node to move.", "location": "path" } }, "description": "Moves a node under another node or customer.", "path": "v1alpha1/{+name}:move", "httpMethod": "POST" }, "patch": { "description": "Updates an existing node.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalNode" }, "path": "v1alpha1/{+name}", "parameters": { "name": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "location": "path", "type": "string", "description": "Output only. Resource name.", "required": true }, "updateMask": { "location": "query", "type": "string", "format": "google-fieldmask", "description": "Fields to be updated." } }, "response": { "$ref": "SasPortalNode" }, "id": "prod_tt_sasportal.customers.nodes.patch", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}", "httpMethod": "PATCH" }, "create": { "id": "prod_tt_sasportal.customers.nodes.create", "flatPath": "v1alpha1/customers/{customersId}/nodes", "response": { "$ref": "SasPortalNode" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/nodes", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "required": true, "description": "Required. The parent resource name where the node is to be created.", "type": "string", "location": "path" } }, "request": { "$ref": "SasPortalNode" }, "httpMethod": "POST", "description": "Creates a new node.", "parameterOrder": [ "parent" ] }, "list": { "parameters": { "pageToken": { "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from.", "type": "string", "location": "query" }, "filter": { "location": "query", "description": "The filter expression. The filter should have the following format: \"DIRECT_CHILDREN\" or format: \"direct_children\". The filter is case insensitive. If empty, then no nodes are filtered.", "type": "string" }, "parent": { "pattern": "^customers/[^/]+$", "required": true, "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\".", "location": "path" }, "pageSize": { "location": "query", "description": "The maximum number of nodes to return in the response.", "format": "int32", "type": "integer" } }, "flatPath": "v1alpha1/customers/{customersId}/nodes", "response": { "$ref": "SasPortalListNodesResponse" }, "httpMethod": "GET", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Lists nodes.", "path": "v1alpha1/{+parent}/nodes", "id": "prod_tt_sasportal.customers.nodes.list" }, "delete": { "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}", "id": "prod_tt_sasportal.customers.nodes.delete", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "name": { "type": "string", "required": true, "location": "path", "description": "Required. The name of the node.", "pattern": "^customers/[^/]+/nodes/[^/]+$" } }, "response": { "$ref": "SasPortalEmpty" }, "parameterOrder": [ "name" ], "path": "v1alpha1/{+name}", "description": "Deletes a node." } } }, "devices": { "methods": { "delete": { "description": "Deletes a device.", "path": "v1alpha1/{+name}", "parameters": { "name": { "location": "path", "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The name of the device.", "required": true, "type": "string" } }, "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "name" ], "id": "prod_tt_sasportal.customers.devices.delete", "response": { "$ref": "SasPortalEmpty" }, "httpMethod": "DELETE" }, "move": { "path": "v1alpha1/{+name}:move", "id": "prod_tt_sasportal.customers.devices.move", "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}:move", "httpMethod": "POST", "request": { "$ref": "SasPortalMoveDeviceRequest" }, "response": { "$ref": "SasPortalOperation" }, "parameters": { "name": { "location": "path", "description": "Required. The name of the device to move.", "type": "string", "pattern": "^customers/[^/]+/devices/[^/]+$", "required": true } }, "description": "Moves a device under another node or customer.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "patch": { "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}", "id": "prod_tt_sasportal.customers.devices.patch", "path": "v1alpha1/{+name}", "httpMethod": "PATCH", "description": "Updates a device.", "request": { "$ref": "SasPortalDevice" }, "parameters": { "updateMask": { "type": "string", "description": "Fields to be updated.", "location": "query", "format": "google-fieldmask" }, "name": { "type": "string", "required": true, "description": "Output only. The resource path name.", "location": "path", "pattern": "^customers/[^/]+/devices/[^/]+$" } }, "response": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "create": { "httpMethod": "POST", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "parameters": { "parent": { "type": "string", "pattern": "^customers/[^/]+$", "location": "path", "description": "Required. The name of the parent resource.", "required": true } }, "request": { "$ref": "SasPortalDevice" }, "path": "v1alpha1/{+parent}/devices", "id": "prod_tt_sasportal.customers.devices.create", "flatPath": "v1alpha1/customers/{customersId}/devices", "response": { "$ref": "SasPortalDevice" }, "description": "Creates a device under a node or customer." }, "updateSigned": { "response": { "$ref": "SasPortalDevice" }, "httpMethod": "PATCH", "path": "v1alpha1/{+name}:updateSigned", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "name": { "required": true, "type": "string", "location": "path", "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The name of the device to update." } }, "id": "prod_tt_sasportal.customers.devices.updateSigned", "request": { "$ref": "SasPortalUpdateSignedDeviceRequest" }, "parameterOrder": [ "name" ], "description": "Updates a signed device.", "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}:updateSigned" }, "get": { "description": "Gets details about a device.", "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}", "parameterOrder": [ "name" ], "id": "prod_tt_sasportal.customers.devices.get", "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "name": { "pattern": "^customers/[^/]+/devices/[^/]+$", "required": true, "type": "string", "description": "Required. The name of the device.", "location": "path" } }, "httpMethod": "GET" }, "list": { "flatPath": "v1alpha1/customers/{customersId}/devices", "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" }, "id": "prod_tt_sasportal.customers.devices.list", "description": "Lists devices under a node or customer.", "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameters": { "pageToken": { "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.", "location": "query", "type": "string" }, "parent": { "description": "Required. The name of the parent resource.", "pattern": "^customers/[^/]+$", "location": "path", "required": true, "type": "string" }, "filter": { "location": "query", "type": "string", "description": "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": { "format": "int32", "location": "query", "type": "integer", "description": "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]." } } }, "createSigned": { "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Creates a signed device under a node or customer.", "path": "v1alpha1/{+parent}/devices:createSigned", "flatPath": "v1alpha1/customers/{customersId}/devices:createSigned", "httpMethod": "POST", "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "parameters": { "parent": { "description": "Required. The name of the parent resource.", "location": "path", "type": "string", "required": true, "pattern": "^customers/[^/]+$" } }, "parameterOrder": [ "parent" ], "id": "prod_tt_sasportal.customers.devices.createSigned" }, "signDevice": { "parameters": { "name": { "type": "string", "location": "path", "pattern": "^customers/[^/]+/devices/[^/]+$", "required": true, "description": "Output only. The resource path name." } }, "path": "v1alpha1/{+name}:signDevice", "httpMethod": "POST", "request": { "$ref": "SasPortalSignDeviceRequest" }, "parameterOrder": [ "name" ], "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}:signDevice", "description": "Signs a device.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalEmpty" }, "id": "prod_tt_sasportal.customers.devices.signDevice" } } } } }, "installer": { "methods": { "generateSecret": { "parameterOrder": [], "request": { "$ref": "SasPortalGenerateSecretRequest" }, "description": "Generates a secret to be used with the ValidateInstaller.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/installer:generateSecret", "path": "v1alpha1/installer:generateSecret", "response": { "$ref": "SasPortalGenerateSecretResponse" }, "id": "prod_tt_sasportal.installer.generateSecret", "httpMethod": "POST", "parameters": {} }, "validate": { "parameterOrder": [], "path": "v1alpha1/installer:validate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalValidateInstallerRequest" }, "id": "prod_tt_sasportal.installer.validate", "response": { "$ref": "SasPortalValidateInstallerResponse" }, "parameters": {}, "description": "Validates the identity of a Certified Professional Installer (CPI).", "flatPath": "v1alpha1/installer:validate", "httpMethod": "POST" } } }, "deployments": { "resources": { "devices": { "methods": { "signDevice": { "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}:signDevice", "parameterOrder": [ "name" ], "httpMethod": "POST", "path": "v1alpha1/{+name}:signDevice", "description": "Signs a device.", "parameters": { "name": { "location": "path", "description": "Output only. The resource path name.", "type": "string", "required": true, "pattern": "^deployments/[^/]+/devices/[^/]+$" } }, "request": { "$ref": "SasPortalSignDeviceRequest" }, "response": { "$ref": "SasPortalEmpty" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.deployments.devices.signDevice" }, "patch": { "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}", "httpMethod": "PATCH", "id": "prod_tt_sasportal.deployments.devices.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalDevice" }, "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Output only. The resource path name.", "pattern": "^deployments/[^/]+/devices/[^/]+$" }, "updateMask": { "type": "string", "location": "query", "description": "Fields to be updated.", "format": "google-fieldmask" } }, "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "name" ], "description": "Updates a device." }, "move": { "parameters": { "name": { "pattern": "^deployments/[^/]+/devices/[^/]+$", "required": true, "description": "Required. The name of the device to move.", "location": "path", "type": "string" } }, "response": { "$ref": "SasPortalOperation" }, "httpMethod": "POST", "request": { "$ref": "SasPortalMoveDeviceRequest" }, "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}:move", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}:move", "id": "prod_tt_sasportal.deployments.devices.move", "description": "Moves a device under another node or customer.", "parameterOrder": [ "name" ] }, "get": { "parameters": { "name": { "required": true, "type": "string", "location": "path", "description": "Required. The name of the device.", "pattern": "^deployments/[^/]+/devices/[^/]+$" } }, "parameterOrder": [ "name" ], "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}", "response": { "$ref": "SasPortalDevice" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Gets details about a device.", "id": "prod_tt_sasportal.deployments.devices.get" }, "updateSigned": { "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}:updateSigned", "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalUpdateSignedDeviceRequest" }, "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.deployments.devices.updateSigned", "httpMethod": "PATCH", "path": "v1alpha1/{+name}:updateSigned", "description": "Updates a signed device.", "parameters": { "name": { "description": "Required. The name of the device to update.", "required": true, "pattern": "^deployments/[^/]+/devices/[^/]+$", "location": "path", "type": "string" } } }, "delete": { "parameters": { "name": { "type": "string", "pattern": "^deployments/[^/]+/devices/[^/]+$", "required": true, "location": "path", "description": "Required. The name of the device." } }, "path": "v1alpha1/{+name}", "httpMethod": "DELETE", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "prod_tt_sasportal.deployments.devices.delete", "description": "Deletes a device.", "response": { "$ref": "SasPortalEmpty" }, "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}", "parameterOrder": [ "name" ] } } } }, "methods": { "get": { "description": "Returns a requested deployment.", "path": "v1alpha1/{+name}", "parameterOrder": [ "name" ], "id": "prod_tt_sasportal.deployments.get", "response": { "$ref": "SasPortalDeployment" }, "httpMethod": "GET", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/deployments/{deploymentsId}", "parameters": { "name": { "pattern": "^deployments/[^/]+$", "type": "string", "location": "path", "description": "Required. The name of the deployment.", "required": true } } } } }, "policies": { "methods": { "set": { "parameterOrder": [], "id": "prod_tt_sasportal.policies.set", "path": "v1alpha1/policies:set", "request": { "$ref": "SasPortalSetPolicyRequest" }, "flatPath": "v1alpha1/policies:set", "description": "Sets the access control policy on the specified resource. Replaces any existing policy.", "parameters": {}, "httpMethod": "POST", "response": { "$ref": "SasPortalPolicy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "get": { "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "request": { "$ref": "SasPortalGetPolicyRequest" }, "parameters": {}, "response": { "$ref": "SasPortalPolicy" }, "flatPath": "v1alpha1/policies:get", "httpMethod": "POST", "id": "prod_tt_sasportal.policies.get", "parameterOrder": [], "path": "v1alpha1/policies:get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "test": { "response": { "$ref": "SasPortalTestPermissionsResponse" }, "parameterOrder": [], "path": "v1alpha1/policies:test", "request": { "$ref": "SasPortalTestPermissionsRequest" }, "flatPath": "v1alpha1/policies:test", "description": "Returns permissions that a caller has on the specified resource.", "parameters": {}, "id": "prod_tt_sasportal.policies.test", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST" } } } }, "rootUrl": "https://prod-tt-sasportal.googleapis.com/", "ownerName": "Google", "description": "", "id": "prod_tt_sasportal:v1alpha1", "servicePath": "", "documentationLink": "https://developers.google.com/spectrum-access-system/", "batchPath": "batch", "title": "SAS Portal API (Testing)", "version": "v1alpha1", "discoveryVersion": "v1", "parameters": { "access_token": { "description": "OAuth access token.", "location": "query", "type": "string" }, "alt": { "default": "json", "type": "string", "enum": [ "json", "media", "proto" ], "description": "Data format for response.", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query" }, "prettyPrint": { "type": "boolean", "default": "true", "description": "Returns response with indentations and line breaks.", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "$.xgafv": { "enum": [ "1", "2" ], "description": "V1 error format.", "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "type": "string", "location": "query" }, "upload_protocol": { "location": "query", "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")." }, "callback": { "location": "query", "type": "string", "description": "JSONP" }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "type": "string", "location": "query" }, "key": { "location": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "type": "string" }, "oauth_token": { "type": "string", "location": "query", "description": "OAuth 2.0 token for the current user." } }, "mtlsRootUrl": "https://prod-tt-sasportal.mtls.googleapis.com/", "version_module": true, "kind": "discovery#restDescription", "schemas": { "SasPortalDeviceMetadata": { "type": "object", "properties": { "interferenceCoordinationGroup": { "type": "string", "description": "Interference Coordination Group (ICG). A group of CBSDs that manage their own interference with the group. For more details, see [CBRSA-TS-2001 V3.0.0](https://ongoalliance.org/wp-content/uploads/2020/02/CBRSA-TS-2001-V3.0.0_Approved-for-publication.pdf)." }, "antennaModel": { "description": "If populated, the Antenna Model Pattern to use. Format is: `RecordCreatorId:PatternId`", "type": "string" }, "nrqzValidation": { "readOnly": true, "$ref": "SasPortalNrqzValidation", "description": "Output only. National Radio Quiet Zone validation info." }, "commonChannelGroup": { "description": "Common Channel Group (CCG). A group of CBSDs in the same ICG requesting a common primary channel assignment. For more details, see [CBRSA-TS-2001 V3.0.0](https://ongoalliance.org/wp-content/uploads/2020/02/CBRSA-TS-2001-V3.0.0_Approved-for-publication.pdf).", "type": "string" }, "nrqzValidated": { "readOnly": true, "type": "boolean", "deprecated": true, "description": "Output only. Set to `true` if a CPI has validated that they have coordinated with the National Quiet Zone office." } }, "description": "Device data overridable by both SAS Portal and registration requests.", "id": "SasPortalDeviceMetadata" }, "SasPortalMigrateOrganizationResponse": { "description": "Response for [MigrateOrganization]. [spectrum.sas.portal.v1alpha1.Provisioning.MigrateOrganization].", "properties": { "deploymentAssociation": { "items": { "$ref": "SasPortalDeploymentAssociation" }, "description": "Optional. A list of deployment association that were created for the migration, or current associations if they already exist.", "type": "array" } }, "type": "object", "id": "SasPortalMigrateOrganizationResponse" }, "SasPortalListGcpProjectDeploymentsResponse": { "id": "SasPortalListGcpProjectDeploymentsResponse", "description": "Response for [ListGcpProjectDeployments].", "type": "object", "properties": { "deployments": { "type": "array", "description": "Optional. Deployments associated with the GCP project", "items": { "$ref": "SasPortalGcpProjectDeployment" } } } }, "SasPortalListDeploymentsResponse": { "description": "Response for ListDeployments.", "properties": { "nextPageToken": { "description": "A pagination token returned from a previous call to ListDeployments that indicates from where listing should continue. If the field is missing or empty, it means there are no more deployments.", "type": "string" }, "deployments": { "description": "The deployments that match the request.", "type": "array", "items": { "$ref": "SasPortalDeployment" } } }, "type": "object", "id": "SasPortalListDeploymentsResponse" }, "SasPortalAssignment": { "description": "Associates `members` with a `role`.", "properties": { "role": { "type": "string", "description": "Required. Role that is assigned to `members`." }, "members": { "description": "The identities the role is assigned to. It can have the following values: * `{user_email}`: An email address that represents a specific Google account. For example: `alice@gmail.com`. * `{group_email}`: An email address that represents a Google group. For example, `viewers@gmail.com`.", "type": "array", "items": { "type": "string" } } }, "id": "SasPortalAssignment", "type": "object" }, "SasPortalDeviceAirInterface": { "properties": { "supportedSpec": { "description": "Optional. This field is related to the `radioTechnology` and provides the air interface specification that the CBSD is compliant with at the time of registration.", "type": "string" }, "radioTechnology": { "enumDescriptions": [ "", "", "", "", "", "", "", "", "", "" ], "enum": [ "RADIO_TECHNOLOGY_UNSPECIFIED", "E_UTRA", "CAMBIUM_NETWORKS", "FOUR_G_BBW_SAA_1", "NR", "DOODLE_CBRS", "CW", "REDLINE", "TARANA_WIRELESS", "FAROS" ], "description": "Conditional. This field specifies the radio access technology that is used for the CBSD.", "type": "string" } }, "description": "Information about the device's air interface.", "id": "SasPortalDeviceAirInterface", "type": "object" }, "SasPortalMigrateOrganizationRequest": { "description": "Request for [MigrateOrganization]. [spectrum.sas.portal.v1alpha1.Provisioning.MigrateOrganization]. GCP Project, Organization Info, and caller's GAIA ID should be retrieved from the RPC handler, and used to check authorization on SAS Portal organization and to create GCP Projects.", "properties": { "organizationId": { "type": "string", "description": "Required. Id of the SAS organization to be migrated.", "format": "int64" } }, "id": "SasPortalMigrateOrganizationRequest", "type": "object" }, "SasPortalCustomer": { "properties": { "name": { "description": "Output only. Resource name of the customer.", "type": "string" }, "sasUserIds": { "items": { "type": "string" }, "type": "array", "description": "User IDs used by the devices belonging to this customer." }, "displayName": { "description": "Required. Name of the organization that the customer entity represents.", "type": "string" } }, "type": "object", "id": "SasPortalCustomer", "description": "Entity representing a SAS customer." }, "SasPortalOrganization": { "id": "SasPortalOrganization", "properties": { "displayName": { "type": "string", "description": "Name of organization" }, "id": { "description": "Id of organization", "format": "int64", "type": "string" } }, "description": "Organization details.", "type": "object" }, "SasPortalGenerateSecretResponse": { "properties": { "secret": { "description": "The secret generated by the string and used by ValidateInstaller.", "type": "string" } }, "description": "Response for GenerateSecret.", "id": "SasPortalGenerateSecretResponse", "type": "object" }, "SasPortalDeploymentAssociation": { "type": "object", "id": "SasPortalDeploymentAssociation", "description": "Association between a gcp project and a SAS user id.", "properties": { "userId": { "type": "string", "description": "User id of the deployment." }, "gcpProjectId": { "type": "string", "description": "GCP project id of the associated project." } } }, "SasPortalPolicy": { "type": "object", "id": "SasPortalPolicy", "properties": { "assignments": { "description": "List of assignments", "type": "array", "items": { "$ref": "SasPortalAssignment" } }, "etag": { "description": "The etag is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the etag in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An etag is returned in the response to GetPolicy, and systems are expected to put that etag in the request to SetPolicy to ensure that their change will be applied to the same version of the policy. If no etag is provided in the call to GetPolicy, then the existing policy is overwritten blindly.", "type": "string", "format": "byte" } }, "description": "Defines an access control policy to the resources." }, "SasPortalTestPermissionsRequest": { "type": "object", "properties": { "permissions": { "description": "The set of permissions to check for the `resource`.", "type": "array", "items": { "type": "string" } }, "resource": { "description": "Required. The resource for which the permissions are being requested.", "type": "string" } }, "description": "Request message for `TestPermissions` method.", "id": "SasPortalTestPermissionsRequest" }, "SasPortalDeviceConfig": { "type": "object", "properties": { "state": { "enumDescriptions": [ "", "", "" ], "enum": [ "DEVICE_CONFIG_STATE_UNSPECIFIED", "DRAFT", "FINAL" ], "description": "State of the configuration.", "type": "string" }, "callSign": { "type": "string", "description": "The call sign of the device operator." }, "userId": { "description": "The identifier of a device user.", "type": "string" }, "measurementCapabilities": { "type": "array", "description": "Measurement reporting capabilities of the device.", "items": { "enum": [ "MEASUREMENT_CAPABILITY_UNSPECIFIED", "MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT", "MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT" ], "type": "string", "enumDescriptions": [ "", "", "" ] } }, "updateTime": { "type": "string", "description": "Output only. The last time the device configuration was edited.", "format": "google-datetime" }, "airInterface": { "$ref": "SasPortalDeviceAirInterface", "description": "Information about this device's air interface." }, "model": { "description": "Information about this device model.", "$ref": "SasPortalDeviceModel" }, "installationParams": { "description": "Installation parameters for the device.", "$ref": "SasPortalInstallationParams" }, "isSigned": { "type": "boolean", "description": "Output only. Whether the configuration has been signed by a CPI." }, "category": { "description": "FCC category of the device.", "enumDescriptions": [ "Unspecified device category.", "Category A.", "Category B." ], "enum": [ "DEVICE_CATEGORY_UNSPECIFIED", "DEVICE_CATEGORY_A", "DEVICE_CATEGORY_B" ], "type": "string" } }, "description": "Information about the device configuration.", "id": "SasPortalDeviceConfig" }, "SasPortalDpaMoveList": { "properties": { "frequencyRange": { "description": "The frequency range that the move list affects.", "$ref": "SasPortalFrequencyRange" }, "dpaId": { "description": "The ID of the DPA.", "type": "string" } }, "type": "object", "description": "An entry in a DPA's move list.", "id": "SasPortalDpaMoveList" }, "SasPortalMoveDeviceRequest": { "id": "SasPortalMoveDeviceRequest", "type": "object", "properties": { "destination": { "description": "Required. The name of the new parent resource node or customer to reparent the device under.", "type": "string" } }, "description": "Request for MoveDevice." }, "SasPortalStatus": { "type": "object", "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "SasPortalStatus", "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" }, "details": { "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } } } }, "SasPortalDeviceGrant": { "description": "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.", "id": "SasPortalDeviceGrant", "properties": { "maxEirp": { "type": "number", "description": "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).", "format": "double" }, "channelType": { "type": "string", "description": "Type of channel used.", "enumDescriptions": [ "", "", "" ], "enum": [ "CHANNEL_TYPE_UNSPECIFIED", "CHANNEL_TYPE_GAA", "CHANNEL_TYPE_PAL" ] }, "lastHeartbeatTransmitExpireTime": { "format": "google-datetime", "type": "string", "description": "The transmit expiration time of the last heartbeat." }, "suspensionReason": { "items": { "type": "string" }, "description": "If the grant is suspended, the reason(s) for suspension.", "type": "array" }, "moveList": { "items": { "$ref": "SasPortalDpaMoveList" }, "description": "The DPA move lists on which this grant appears.", "type": "array" }, "frequencyRange": { "description": "The transmission frequency range.", "$ref": "SasPortalFrequencyRange" }, "state": { "enumDescriptions": [ "", "The grant has been granted but the device is not heartbeating on it.", "The grant has been terminated by the SAS.", "The grant has been suspended by the SAS.", "The device is currently transmitting.", "The grant has expired." ], "description": "State of the grant.", "type": "string", "enum": [ "GRANT_STATE_UNSPECIFIED", "GRANT_STATE_GRANTED", "GRANT_STATE_TERMINATED", "GRANT_STATE_SUSPENDED", "GRANT_STATE_AUTHORIZED", "GRANT_STATE_EXPIRED" ] }, "expireTime": { "type": "string", "description": "The expiration time of the grant.", "format": "google-datetime" }, "grantId": { "type": "string", "description": "Grant Id." } }, "type": "object" }, "SasPortalUpdateSignedDeviceRequest": { "id": "SasPortalUpdateSignedDeviceRequest", "properties": { "installerId": { "description": "Required. Unique installer ID (CPI ID) from the Certified Professional Installers database.", "type": "string" }, "encodedDevice": { "format": "byte", "type": "string", "description": "Required. The 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." } }, "description": "Request for UpdateSignedDevice.", "type": "object" }, "SasPortalOperation": { "id": "SasPortalOperation", "description": "This resource represents a long-running operation that is the result of a network API call.", "type": "object", "properties": { "done": { "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", "type": "boolean" }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any." }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "response": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`." }, "error": { "$ref": "SasPortalStatus", "description": "The error result of the operation in case of failure or cancellation." } } }, "SasPortalProvisionDeploymentRequest": { "id": "SasPortalProvisionDeploymentRequest", "properties": { "newOrganizationDisplayName": { "type": "string", "description": "Optional. If this field is set, and a new SAS Portal Organization needs to be created, its display name will be set to the value of this field." }, "newDeploymentDisplayName": { "type": "string", "description": "Optional. If this field is set, and a new SAS Portal Deployment needs to be created, its display name will be set to the value of this field." }, "organizationId": { "format": "int64", "type": "string", "description": "Optional. If this field is set then a new deployment will be created under the organization specified by this id." } }, "description": "Request for [ProvisionDeployment]. [spectrum.sas.portal.v1alpha1.Provisioning.ProvisionDeployment]. GCP Project, Organization Info, and caller’s GAIA ID should be retrieved from the RPC handler, and used as inputs to create a new SAS organization (if not exists) and a new SAS deployment.", "type": "object" }, "SasPortalSetupSasAnalyticsMetadata": { "properties": {}, "id": "SasPortalSetupSasAnalyticsMetadata", "description": "Metadata returned by the long running operation for the SetupSasAnalytics rpc.", "type": "object" }, "SasPortalListNodesResponse": { "description": "Response for ListNodes.", "type": "object", "id": "SasPortalListNodesResponse", "properties": { "nextPageToken": { "description": "A pagination token returned from a previous call to ListNodes that indicates from where listing should continue. If the field is missing or empty, it means there is no more nodes.", "type": "string" }, "nodes": { "items": { "$ref": "SasPortalNode" }, "description": "The nodes that match the request.", "type": "array" } } }, "SasPortalCreateSignedDeviceRequest": { "description": "Request for CreateSignedDevice.", "properties": { "encodedDevice": { "type": "string", "format": "byte", "description": "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": { "type": "string", "description": "Required. Unique installer id (CPI ID) from the Certified Professional Installers database." } }, "type": "object", "id": "SasPortalCreateSignedDeviceRequest" }, "SasPortalGetPolicyRequest": { "properties": { "resource": { "description": "Required. The resource for which the policy is being requested.", "type": "string" } }, "description": "Request message for `GetPolicy` method.", "type": "object", "id": "SasPortalGetPolicyRequest" }, "SasPortalSignDeviceRequest": { "id": "SasPortalSignDeviceRequest", "type": "object", "description": "Request for SignDevice.", "properties": { "device": { "$ref": "SasPortalDevice", "description": "Required. The device to sign. The device fields name, fcc_id and serial_number must be set. The user_id field must be set." } } }, "SasPortalDevice": { "properties": { "displayName": { "type": "string", "description": "Device display name." }, "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.", "type": "string" }, "serialNumber": { "description": "A serial number assigned to the device by the device manufacturer.", "type": "string" }, "name": { "description": "Output only. The resource path name.", "type": "string" }, "currentChannels": { "items": { "$ref": "SasPortalChannelWithScore" }, "description": "Output only. Current channels with scores.", "deprecated": true, "readOnly": true, "type": "array" }, "grants": { "items": { "$ref": "SasPortalDeviceGrant" }, "type": "array", "description": "Output only. Grants held by the device." }, "deviceMetadata": { "description": "Device parameters that can be overridden by both SAS Portal and SAS registration requests.", "$ref": "SasPortalDeviceMetadata" }, "state": { "enum": [ "DEVICE_STATE_UNSPECIFIED", "RESERVED", "REGISTERED", "DEREGISTERED" ], "description": "Output only. Device state.", "enumDescriptions": [ "Unspecified state.", "Device created in the SAS Portal, however, not yet registered with SAS.", "Device registered with SAS.", "Device de-registered with SAS." ], "type": "string" }, "preloadedConfig": { "$ref": "SasPortalDeviceConfig", "description": "Configuration of the device, as specified via SAS Portal API." }, "grantRangeAllowlists": { "type": "array", "items": { "$ref": "SasPortalFrequencyRange" }, "description": "Only ranges that are within the allowlists are available for new grants." }, "activeConfig": { "$ref": "SasPortalDeviceConfig", "description": "Output only. Current configuration of the device as registered to the SAS." } }, "type": "object", "id": "SasPortalDevice" }, "SasPortalNrqzValidation": { "id": "SasPortalNrqzValidation", "type": "object", "properties": { "latitude": { "format": "double", "type": "number", "description": "Device latitude that's associated with the validation." }, "longitude": { "description": "Device longitude that's associated with the validation.", "type": "number", "format": "double" }, "caseId": { "type": "string", "description": "Validation case ID." }, "cpiId": { "description": "CPI who signed the validation.", "type": "string" }, "state": { "type": "string", "description": "State of the NRQZ validation info.", "enum": [ "STATE_UNSPECIFIED", "DRAFT", "FINAL" ], "enumDescriptions": [ "Unspecified state.", "Draft state.", "Final state." ] } }, "description": "Information about National Radio Quiet Zone validation." }, "SasPortalProvisionDeploymentResponse": { "properties": { "errorMessage": { "type": "string", "description": "Optional. Optional error message if the provisioning request is not successful." } }, "type": "object", "description": "Response for [ProvisionDeployment]. [spectrum.sas.portal.v1alpha1.Provisioning.ProvisionDeployment].", "id": "SasPortalProvisionDeploymentResponse" }, "SasPortalListDevicesResponse": { "properties": { "nextPageToken": { "description": "A pagination token returned from a previous call to ListDevices that indicates from where listing should continue. If the field is missing or empty, it means there is no more devices.", "type": "string" }, "devices": { "items": { "$ref": "SasPortalDevice" }, "type": "array", "description": "The devices that match the request." } }, "type": "object", "description": "Response for ListDevices.", "id": "SasPortalListDevicesResponse" }, "SasPortalSetupSasAnalyticsRequest": { "type": "object", "description": "Request for the SetupSasAnalytics rpc.", "properties": { "userId": { "description": "Optional. User id to setup analytics for, if not provided the user id associated with the project is used. optional", "type": "string" } }, "id": "SasPortalSetupSasAnalyticsRequest" }, "SasPortalListLegacyOrganizationsResponse": { "id": "SasPortalListLegacyOrganizationsResponse", "description": "Response for [ListLegacyOrganizations]. [spectrum.sas.portal.v1alpha1.Provisioning.ListLegacyOrganizations].", "properties": { "organizations": { "description": "Optional. Legacy SAS organizations.", "items": { "$ref": "SasPortalOrganization" }, "type": "array" } }, "type": "object" }, "SasPortalMoveNodeRequest": { "id": "SasPortalMoveNodeRequest", "properties": { "destination": { "type": "string", "description": "Required. The name of the new parent resource node or customer to reparent the node under." } }, "type": "object", "description": "Request for MoveNode." }, "SasPortalTestPermissionsResponse": { "type": "object", "description": "Response message for `TestPermissions` method.", "id": "SasPortalTestPermissionsResponse", "properties": { "permissions": { "items": { "type": "string" }, "type": "array", "description": "A set of permissions that the caller is allowed." } } }, "SasPortalDeviceModel": { "id": "SasPortalDeviceModel", "properties": { "firmwareVersion": { "description": "The firmware version of the device.", "type": "string" }, "hardwareVersion": { "type": "string", "description": "The hardware version of the device." }, "name": { "description": "The name of the device model.", "type": "string" }, "softwareVersion": { "description": "The software version of the device.", "type": "string" }, "vendor": { "description": "The name of the device vendor.", "type": "string" } }, "type": "object", "description": "Information about the model of the device." }, "SasPortalChannelWithScore": { "properties": { "frequencyRange": { "$ref": "SasPortalFrequencyRange", "description": "The frequency range of the channel." }, "score": { "type": "number", "description": "The channel score, normalized to be in the range [0,100].", "format": "double" } }, "id": "SasPortalChannelWithScore", "type": "object", "description": "The channel with score." }, "SasPortalValidateInstallerResponse": { "description": "Response for ValidateInstaller.", "type": "object", "properties": {}, "id": "SasPortalValidateInstallerResponse" }, "SasPortalMoveDeploymentRequest": { "id": "SasPortalMoveDeploymentRequest", "type": "object", "properties": { "destination": { "description": "Required. The name of the new parent resource node or customer to reparent the deployment under.", "type": "string" } }, "description": "Request for MoveDeployment." }, "SasPortalNode": { "id": "SasPortalNode", "description": "The Node.", "properties": { "displayName": { "type": "string", "description": "The node's display name." }, "sasUserIds": { "description": "User ids used by the devices belonging to this node.", "type": "array", "items": { "type": "string" } }, "name": { "description": "Output only. Resource name.", "type": "string" } }, "type": "object" }, "SasPortalSetPolicyRequest": { "type": "object", "properties": { "policy": { "$ref": "SasPortalPolicy", "description": "Required. The policy to be applied to the `resource`." }, "disableNotification": { "description": "Optional. Set the field as `true` to disable the onboarding notification.", "type": "boolean" }, "resource": { "description": "Required. The resource for which the policy is being specified. This policy replaces any existing policy.", "type": "string" } }, "description": "Request message for `SetPolicy` method.", "id": "SasPortalSetPolicyRequest" }, "SasPortalSetupSasAnalyticsResponse": { "type": "object", "description": "Response returned by the long running operation for the SetupSasAnalytics rpc.", "properties": {}, "id": "SasPortalSetupSasAnalyticsResponse" }, "SasPortalInstallationParams": { "type": "object", "id": "SasPortalInstallationParams", "properties": { "antennaBeamwidth": { "type": "integer", "description": "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.", "format": "int32" }, "antennaGain": { "type": "number", "format": "double", "description": "Peak antenna gain in dBi. This parameter is a double with a value between -127 and +128 (dBi) inclusive. Part of Release 2 to support floating-point value" }, "longitude": { "type": "number", "format": "double", "description": "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." }, "verticalAccuracy": { "format": "double", "description": "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.", "type": "number" }, "eirpCapability": { "description": "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.", "type": "integer", "format": "int32" }, "antennaModel": { "type": "string", "description": "If an external antenna is used, the antenna model is optionally provided in this field. The string has a maximum length of 128 octets." }, "indoorDeployment": { "type": "boolean", "description": "Whether the device antenna is indoor or not. `true`: indoor. `false`: outdoor." }, "antennaAzimuth": { "format": "int32", "description": "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.", "type": "integer" }, "height": { "type": "number", "format": "double", "description": "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." }, "heightType": { "description": "Specifies how the height is measured.", "enumDescriptions": [ "Unspecified height type.", "AGL height is measured relative to the ground level.", "AMSL height is measured relative to the mean sea level." ], "enum": [ "HEIGHT_TYPE_UNSPECIFIED", "HEIGHT_TYPE_AGL", "HEIGHT_TYPE_AMSL" ], "type": "string" }, "horizontalAccuracy": { "type": "number", "format": "double", "description": "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." }, "latitude": { "description": "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.", "format": "double", "type": "number" }, "antennaDowntilt": { "description": "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.", "format": "int32", "type": "integer" }, "cpeCbsdIndication": { "description": "If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.", "type": "boolean" } }, "description": "Information about the device installation parameters." }, "SasPortalDeployment": { "description": "The Deployment.", "type": "object", "id": "SasPortalDeployment", "properties": { "name": { "description": "Output only. Resource name.", "type": "string", "readOnly": true }, "frns": { "description": "Output only. The FCC Registration Numbers (FRNs) copied from its direct parent.", "readOnly": true, "items": { "type": "string" }, "type": "array" }, "displayName": { "type": "string", "description": "The deployment's display name." }, "sasUserIds": { "items": { "type": "string" }, "description": "User ID used by the devices belonging to this deployment. Each deployment should be associated with one unique user ID.", "type": "array" } } }, "SasPortalGcpProjectDeployment": { "id": "SasPortalGcpProjectDeployment", "type": "object", "description": "Deployment associated with the GCP project. Includes whether SAS analytics has been enabled or not.", "properties": { "deployment": { "$ref": "SasPortalDeployment", "description": "Deployment associated with the GCP project." }, "hasEnabledAnalytics": { "description": "Whether SAS analytics has been enabled.", "type": "boolean" } } }, "SasPortalFrequencyRange": { "type": "object", "id": "SasPortalFrequencyRange", "description": "Frequency range from `low_frequency` to `high_frequency`.", "properties": { "lowFrequencyMhz": { "format": "double", "description": "The lowest frequency of the frequency range in MHz.", "type": "number" }, "highFrequencyMhz": { "description": "The highest frequency of the frequency range in MHz.", "type": "number", "format": "double" } } }, "SasPortalGenerateSecretRequest": { "description": "Request for GenerateSecret.", "properties": {}, "type": "object", "id": "SasPortalGenerateSecretRequest" }, "SasPortalMigrateOrganizationMetadata": { "type": "object", "id": "SasPortalMigrateOrganizationMetadata", "description": "Long-running operation metadata message returned by the MigrateOrganization.", "properties": { "operationState": { "enum": [ "OPERATION_STATE_UNSPECIFIED", "OPERATION_STATE_PENDING", "OPERATION_STATE_RUNNING", "OPERATION_STATE_SUCCEEDED", "OPERATION_STATE_FAILED" ], "enumDescriptions": [ "Unspecified.", "Pending (Not started).", "In-progress.", "Done successfully.", "Done with errors." ], "type": "string", "description": "Output only. Current operation state", "readOnly": true } } }, "SasPortalValidateInstallerRequest": { "id": "SasPortalValidateInstallerRequest", "description": "Request for ValidateInstaller.", "properties": { "installerId": { "type": "string", "description": "Required. Unique installer id (CPI ID) from the Certified Professional Installers database." }, "encodedSecret": { "description": "Required. JSON Web Token signed using a CPI private key. Payload must include a \"secret\" claim whose value is the secret.", "type": "string" }, "secret": { "type": "string", "description": "Required. Secret returned by the GenerateSecret." } }, "type": "object" }, "SasPortalEmpty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "properties": {}, "id": "SasPortalEmpty", "type": "object" }, "SasPortalListCustomersResponse": { "type": "object", "description": "Response for `ListCustomers`.", "properties": { "nextPageToken": { "type": "string", "description": "A pagination token returned from a previous call to ListCustomers that indicates from where listing should continue. If the field is missing or empty, it means there are no more customers." }, "customers": { "description": "The list of customers that match the request.", "type": "array", "items": { "$ref": "SasPortalCustomer" } } }, "id": "SasPortalListCustomersResponse" } }, "revision": "20260930", "name": "prod_tt_sasportal", "basePath": "", "protocol": "rest" }