{ "title": "SAS Portal API", "servicePath": "", "baseUrl": "https://sasportal.googleapis.com/", "kind": "discovery#restDescription", "protocol": "rest", "revision": "20261006", "version": "v1alpha1", "name": "sasportal", "ownerName": "Google", "parameters": { "prettyPrint": { "default": "true", "description": "Returns response with indentations and line breaks.", "location": "query", "type": "boolean" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "key": { "location": "query", "type": "string", "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." }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "alt": { "description": "Data format for response.", "location": "query", "default": "json", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "type": "string", "enum": [ "json", "media", "proto" ] }, "$.xgafv": { "type": "string", "description": "V1 error format.", "location": "query", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ] }, "access_token": { "location": "query", "type": "string", "description": "OAuth access token." }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "location": "query", "type": "string" }, "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" }, "fields": { "location": "query", "type": "string", "description": "Selector specifying which fields to include in a partial response." } }, "discoveryVersion": "v1", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/sasportal": { "description": "Read, create, update, and delete your SAS Portal data." }, "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." } } } }, "documentationLink": "https://developers.google.com/spectrum-access-system/", "version_module": true, "fullyEncodeReservedExpansion": true, "batchPath": "batch", "basePath": "", "ownerDomain": "google.com", "mtlsRootUrl": "https://sasportal.mtls.googleapis.com/", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "rootUrl": "https://sasportal.googleapis.com/", "resources": { "installer": { "methods": { "generateSecret": { "response": { "$ref": "SasPortalGenerateSecretResponse" }, "description": "Generates a secret to be used with the ValidateInstaller.", "path": "v1alpha1/installer:generateSecret", "request": { "$ref": "SasPortalGenerateSecretRequest" }, "httpMethod": "POST", "parameters": {}, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/installer:generateSecret", "id": "sasportal.installer.generateSecret", "parameterOrder": [] }, "validate": { "httpMethod": "POST", "parameters": {}, "response": { "$ref": "SasPortalValidateInstallerResponse" }, "parameterOrder": [], "request": { "$ref": "SasPortalValidateInstallerRequest" }, "description": "Validates the identity of a Certified Professional Installer (CPI).", "id": "sasportal.installer.validate", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/installer:validate", "path": "v1alpha1/installer:validate" } } }, "nodes": { "resources": { "devices": { "methods": { "updateSigned": { "httpMethod": "PATCH", "parameters": { "name": { "description": "Required. The name of the device to update.", "type": "string", "location": "path", "required": true, "pattern": "^nodes/[^/]+/devices/[^/]+$" } }, "id": "sasportal.nodes.devices.updateSigned", "parameterOrder": [ "name" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}:updateSigned", "description": "Updates a signed device.", "request": { "$ref": "SasPortalUpdateSignedDeviceRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}:updateSigned", "response": { "$ref": "SasPortalDevice" } }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}", "description": "Gets details about a device.", "httpMethod": "GET", "parameters": { "name": { "type": "string", "pattern": "^nodes/[^/]+/devices/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the device." } }, "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.nodes.devices.get", "path": "v1alpha1/{+name}" }, "delete": { "response": { "$ref": "SasPortalEmpty" }, "description": "Deletes a device.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^nodes/[^/]+/devices/[^/]+$", "description": "Required. The name of the device.", "type": "string" } }, "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}", "parameterOrder": [ "name" ], "id": "sasportal.nodes.devices.delete" }, "createSigned": { "path": "v1alpha1/{+parent}/devices:createSigned", "description": "Creates a signed device under a node or customer.", "parameterOrder": [ "parent" ], "id": "sasportal.nodes.devices.createSigned", "response": { "$ref": "SasPortalDevice" }, "flatPath": "v1alpha1/nodes/{nodesId}/devices:createSigned", "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^nodes/[^/]+$", "description": "Required. The name of the parent resource.", "type": "string" } } }, "signDevice": { "request": { "$ref": "SasPortalSignDeviceRequest" }, "path": "v1alpha1/{+name}:signDevice", "response": { "$ref": "SasPortalEmpty" }, "parameterOrder": [ "name" ], "description": "Signs a device.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}:signDevice", "httpMethod": "POST", "parameters": { "name": { "pattern": "^nodes/[^/]+/devices/[^/]+$", "description": "Output only. The resource path name.", "location": "path", "required": true, "type": "string" } }, "id": "sasportal.nodes.devices.signDevice" }, "create": { "request": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalDevice" }, "httpMethod": "POST", "parameters": { "parent": { "type": "string", "description": "Required. The name of the parent resource.", "pattern": "^nodes/[^/]+$", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices", "id": "sasportal.nodes.devices.create", "description": "Creates a device under a node or customer." }, "list": { "description": "Lists devices under a node or customer.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/devices", "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "parent": { "pattern": "^nodes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the parent resource." }, "pageSize": { "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", "type": "integer", "format": "int32" }, "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" }, "pageToken": { "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.", "type": "string", "location": "query" } }, "id": "sasportal.nodes.devices.list", "path": "v1alpha1/{+parent}/devices", "response": { "$ref": "SasPortalListDevicesResponse" } }, "move": { "path": "v1alpha1/{+name}:move", "description": "Moves a device under another node or customer.", "response": { "$ref": "SasPortalOperation" }, "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}:move", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalMoveDeviceRequest" }, "parameterOrder": [ "name" ], "id": "sasportal.nodes.devices.move", "httpMethod": "POST", "parameters": { "name": { "pattern": "^nodes/[^/]+/devices/[^/]+$", "description": "Required. The name of the device to move.", "type": "string", "location": "path", "required": true } } }, "patch": { "path": "v1alpha1/{+name}", "id": "sasportal.nodes.devices.patch", "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalDevice" }, "description": "Updates a device.", "flatPath": "v1alpha1/nodes/{nodesId}/devices/{devicesId}", "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "PATCH", "parameters": { "updateMask": { "description": "Fields to be updated.", "type": "string", "location": "query", "format": "google-fieldmask" }, "name": { "location": "path", "required": true, "pattern": "^nodes/[^/]+/devices/[^/]+$", "description": "Output only. The resource path name.", "type": "string" } } } } }, "deployments": { "methods": { "get": { "response": { "$ref": "SasPortalDeployment" }, "description": "Returns a requested deployment.", "path": "v1alpha1/{+name}", "id": "sasportal.nodes.deployments.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "pattern": "^nodes/[^/]+/deployments/[^/]+$", "description": "Required. The name of the deployment.", "type": "string" } }, "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}", "parameterOrder": [ "name" ] }, "list": { "flatPath": "v1alpha1/nodes/{nodesId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Lists deployments.", "id": "sasportal.nodes.deployments.list", "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "pattern": "^nodes/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "format": "int32", "type": "integer", "description": "The maximum number of deployments to return in the response.", "location": "query" }, "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" }, "pageToken": { "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from.", "type": "string", "location": "query" } }, "response": { "$ref": "SasPortalListDeploymentsResponse" }, "path": "v1alpha1/{+parent}/deployments" }, "move": { "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the deployment to move.", "pattern": "^nodes/[^/]+/deployments/[^/]+$" } }, "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}:move", "request": { "$ref": "SasPortalMoveDeploymentRequest" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalOperation" }, "path": "v1alpha1/{+name}:move", "description": "Moves a deployment under another node or customer.", "id": "sasportal.nodes.deployments.move" }, "patch": { "id": "sasportal.nodes.deployments.patch", "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalDeployment" }, "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}", "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalDeployment" }, "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "required": true, "pattern": "^nodes/[^/]+/deployments/[^/]+$", "description": "Output only. Resource name.", "type": "string" }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Fields to be updated." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Updates an existing deployment." }, "delete": { "parameterOrder": [ "name" ], "id": "sasportal.nodes.deployments.delete", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the deployment.", "pattern": "^nodes/[^/]+/deployments/[^/]+$", "type": "string" } }, "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Deletes a deployment.", "response": { "$ref": "SasPortalEmpty" }, "path": "v1alpha1/{+name}" } }, "resources": { "devices": { "methods": { "createSigned": { "description": "Creates a signed device under a node or customer.", "path": "v1alpha1/{+parent}/devices:createSigned", "response": { "$ref": "SasPortalDevice" }, "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^nodes/[^/]+/deployments/[^/]+$", "description": "Required. The name of the parent resource.", "type": "string", "location": "path", "required": true } }, "id": "sasportal.nodes.deployments.devices.createSigned", "parameterOrder": [ "parent" ], "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}/devices:createSigned" }, "list": { "path": "v1alpha1/{+parent}/devices", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}/devices", "description": "Lists devices under a node or customer.", "id": "sasportal.nodes.deployments.devices.list", "response": { "$ref": "SasPortalListDevicesResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "parameters": { "parent": { "pattern": "^nodes/[^/]+/deployments/[^/]+$", "description": "Required. The name of the parent resource.", "type": "string", "location": "path", "required": true }, "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.", "type": "string", "location": "query" }, "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]." }, "pageToken": { "type": "string", "location": "query", "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from." } } }, "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDevice" }, "request": { "$ref": "SasPortalDevice" }, "id": "sasportal.nodes.deployments.devices.create", "description": "Creates a device under a node or customer.", "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The name of the parent resource.", "pattern": "^nodes/[^/]+/deployments/[^/]+$", "type": "string", "location": "path", "required": true } }, "path": "v1alpha1/{+parent}/devices", "flatPath": "v1alpha1/nodes/{nodesId}/deployments/{deploymentsId}/devices" } } } } }, "nodes": { "methods": { "create": { "flatPath": "v1alpha1/nodes/{nodesId}/nodes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "description": "Creates a new node.", "path": "v1alpha1/{+parent}/nodes", "request": { "$ref": "SasPortalNode" }, "response": { "$ref": "SasPortalNode" }, "id": "sasportal.nodes.nodes.create", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^nodes/[^/]+$", "description": "Required. The parent resource name where the node is to be created.", "location": "path", "required": true, "type": "string" } } }, "patch": { "path": "v1alpha1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}", "description": "Updates an existing node.", "httpMethod": "PATCH", "parameters": { "updateMask": { "location": "query", "description": "Fields to be updated.", "format": "google-fieldmask", "type": "string" }, "name": { "location": "path", "required": true, "description": "Output only. Resource name.", "type": "string", "pattern": "^nodes/[^/]+/nodes/[^/]+$" } }, "id": "sasportal.nodes.nodes.patch", "request": { "$ref": "SasPortalNode" }, "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalNode" } }, "delete": { "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "description": "Required. The name of the node.", "location": "path", "required": true } }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.nodes.nodes.delete", "path": "v1alpha1/{+name}", "parameterOrder": [ "name" ], "description": "Deletes a node.", "response": { "$ref": "SasPortalEmpty" } }, "list": { "httpMethod": "GET", "parameters": { "parent": { "pattern": "^nodes/[^/]+$", "description": "Required. The parent resource name, for example, \"nodes/1\".", "type": "string", "location": "path", "required": true }, "pageSize": { "description": "The maximum number of nodes to return in the response.", "type": "integer", "format": "int32", "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" }, "pageToken": { "type": "string", "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from.", "location": "query" } }, "description": "Lists nodes.", "id": "sasportal.nodes.nodes.list", "flatPath": "v1alpha1/nodes/{nodesId}/nodes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/nodes", "response": { "$ref": "SasPortalListNodesResponse" }, "parameterOrder": [ "parent" ] }, "move": { "description": "Moves a node under another node or customer.", "id": "sasportal.nodes.nodes.move", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}:move", "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "description": "Required. The name of the node to move.", "location": "path", "required": true, "type": "string" } }, "request": { "$ref": "SasPortalMoveNodeRequest" }, "response": { "$ref": "SasPortalOperation" }, "path": "v1alpha1/{+name}:move", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "get": { "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "description": "Required. The name of the node." } }, "description": "Returns a requested node.", "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalNode" }, "id": "sasportal.nodes.nodes.get", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}" } }, "resources": { "deployments": { "methods": { "create": { "response": { "$ref": "SasPortalDeployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Creates a new deployment.", "request": { "$ref": "SasPortalDeployment" }, "httpMethod": "POST", "parameters": { "parent": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "description": "Required. The parent resource name where the deployment is to be created.", "type": "string", "location": "path", "required": true } }, "id": "sasportal.nodes.nodes.deployments.create", "parameterOrder": [ "parent" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/deployments", "path": "v1alpha1/{+parent}/deployments" }, "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/deployments", "httpMethod": "GET", "parameters": { "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": { "location": "query", "format": "int32", "description": "The maximum number of deployments to return in the response.", "type": "integer" }, "parent": { "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "location": "path", "required": true, "pattern": "^nodes/[^/]+/nodes/[^/]+$" }, "pageToken": { "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from.", "type": "string", "location": "query" } }, "description": "Lists deployments.", "response": { "$ref": "SasPortalListDeploymentsResponse" }, "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/deployments", "id": "sasportal.nodes.nodes.deployments.list" } } }, "nodes": { "methods": { "create": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "response": { "$ref": "SasPortalNode" }, "id": "sasportal.nodes.nodes.nodes.create", "description": "Creates a new node.", "path": "v1alpha1/{+parent}/nodes", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string", "description": "Required. The parent resource name where the node is to be created.", "location": "path", "required": true } }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/nodes", "request": { "$ref": "SasPortalNode" } }, "list": { "id": "sasportal.nodes.nodes.nodes.list", "path": "v1alpha1/{+parent}/nodes", "response": { "$ref": "SasPortalListNodesResponse" }, "httpMethod": "GET", "parameters": { "pageSize": { "format": "int32", "description": "The maximum number of nodes to return in the response.", "type": "integer", "location": "query" }, "pageToken": { "type": "string", "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from.", "location": "query" }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\".", "pattern": "^nodes/[^/]+/nodes/[^/]+$" }, "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" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Lists nodes.", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/nodes", "parameterOrder": [ "parent" ] } } }, "devices": { "methods": { "list": { "response": { "$ref": "SasPortalListDevicesResponse" }, "path": "v1alpha1/{+parent}/devices", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "id": "sasportal.nodes.nodes.devices.list", "httpMethod": "GET", "parameters": { "filter": { "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.", "location": "query" }, "pageSize": { "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", "format": "int32" }, "parent": { "location": "path", "required": true, "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string", "description": "Required. The name of the parent resource." }, "pageToken": { "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from.", "type": "string", "location": "query" } }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/devices", "description": "Lists devices under a node or customer." }, "create": { "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The name of the parent resource.", "type": "string", "pattern": "^nodes/[^/]+/nodes/[^/]+$", "location": "path", "required": true } }, "description": "Creates a device under a node or customer.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/devices", "parameterOrder": [ "parent" ], "id": "sasportal.nodes.nodes.devices.create", "response": { "$ref": "SasPortalDevice" }, "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/devices", "request": { "$ref": "SasPortalDevice" } }, "createSigned": { "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "id": "sasportal.nodes.nodes.devices.createSigned", "description": "Creates a signed device under a node or customer.", "flatPath": "v1alpha1/nodes/{nodesId}/nodes/{nodesId1}/devices:createSigned", "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "pattern": "^nodes/[^/]+/nodes/[^/]+$", "type": "string", "description": "Required. The name of the parent resource.", "location": "path", "required": true } }, "path": "v1alpha1/{+parent}/devices:createSigned" } } } } } }, "methods": { "get": { "id": "sasportal.nodes.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalNode" }, "flatPath": "v1alpha1/nodes/{nodesId}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the node.", "pattern": "^nodes/[^/]+$", "location": "path", "required": true, "type": "string" } }, "description": "Returns a requested node.", "parameterOrder": [ "name" ] } } }, "policies": { "methods": { "set": { "parameterOrder": [], "httpMethod": "POST", "parameters": {}, "path": "v1alpha1/policies:set", "id": "sasportal.policies.set", "flatPath": "v1alpha1/policies:set", "response": { "$ref": "SasPortalPolicy" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalSetPolicyRequest" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy." }, "get": { "path": "v1alpha1/policies:get", "httpMethod": "POST", "parameters": {}, "id": "sasportal.policies.get", "response": { "$ref": "SasPortalPolicy" }, "request": { "$ref": "SasPortalGetPolicyRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1alpha1/policies:get", "parameterOrder": [] }, "test": { "flatPath": "v1alpha1/policies:test", "description": "Returns permissions that a caller has on the specified resource.", "request": { "$ref": "SasPortalTestPermissionsRequest" }, "id": "sasportal.policies.test", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/policies:test", "parameterOrder": [], "response": { "$ref": "SasPortalTestPermissionsResponse" }, "httpMethod": "POST", "parameters": {} } } }, "customers": { "methods": { "listGcpProjectDeployments": { "path": "v1alpha1/customers:listGcpProjectDeployments", "parameterOrder": [], "flatPath": "v1alpha1/customers:listGcpProjectDeployments", "description": "Returns a list of SAS deployments associated with current GCP project. Includes whether SAS analytics has been enabled or not.", "response": { "$ref": "SasPortalListGcpProjectDeploymentsResponse" }, "httpMethod": "GET", "parameters": {}, "id": "sasportal.customers.listGcpProjectDeployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "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", "parameterOrder": [], "flatPath": "v1alpha1/customers:migrateOrganization", "path": "v1alpha1/customers:migrateOrganization", "request": { "$ref": "SasPortalMigrateOrganizationRequest" }, "httpMethod": "POST", "parameters": {}, "id": "sasportal.customers.migrateOrganization", "response": { "$ref": "SasPortalOperation" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "patch": { "id": "sasportal.customers.patch", "flatPath": "v1alpha1/customers/{customersId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalCustomer" }, "request": { "$ref": "SasPortalCustomer" }, "path": "v1alpha1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "pattern": "^customers/[^/]+$", "location": "path", "required": true, "description": "Output only. Resource name of the customer." }, "updateMask": { "location": "query", "type": "string", "description": "Fields to be updated.", "format": "google-fieldmask" } }, "description": "Updates an existing customer." }, "get": { "path": "v1alpha1/{+name}", "description": "Returns a requested customer.", "flatPath": "v1alpha1/customers/{customersId}", "response": { "$ref": "SasPortalCustomer" }, "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^customers/[^/]+$", "description": "Required. The name of the customer." } }, "parameterOrder": [ "name" ], "id": "sasportal.customers.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "list": { "flatPath": "v1alpha1/customers", "path": "v1alpha1/customers", "description": "Returns a list of requested customers.", "parameterOrder": [], "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "A pagination token returned from a previous call to ListCustomers that indicates where this listing should continue from." }, "pageSize": { "type": "integer", "format": "int32", "description": "The maximum number of customers to return in the response.", "location": "query" } }, "response": { "$ref": "SasPortalListCustomersResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.customers.list" }, "listLegacyOrganizations": { "flatPath": "v1alpha1/customers:listLegacyOrganizations", "id": "sasportal.customers.listLegacyOrganizations", "path": "v1alpha1/customers:listLegacyOrganizations", "parameterOrder": [], "httpMethod": "GET", "parameters": {}, "description": "Returns a list of legacy organizations.", "response": { "$ref": "SasPortalListLegacyOrganizationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "provisionDeployment": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalProvisionDeploymentResponse" }, "path": "v1alpha1/customers:provisionDeployment", "id": "sasportal.customers.provisionDeployment", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "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." }, "setupSasAnalytics": { "httpMethod": "POST", "parameters": {}, "response": { "$ref": "SasPortalOperation" }, "request": { "$ref": "SasPortalSetupSasAnalyticsRequest" }, "path": "v1alpha1/customers:setupSasAnalytics", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "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": "sasportal.customers.setupSasAnalytics", "flatPath": "v1alpha1/customers:setupSasAnalytics", "parameterOrder": [] } }, "resources": { "nodes": { "resources": { "nodes": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.customers.nodes.nodes.list", "description": "Lists nodes.", "httpMethod": "GET", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The parent resource name, for example, \"nodes/1\".", "pattern": "^customers/[^/]+/nodes/[^/]+$" }, "pageToken": { "location": "query", "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from.", "type": "string" }, "pageSize": { "description": "The maximum number of nodes to return in the response.", "type": "integer", "location": "query", "format": "int32" }, "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 nodes are filtered.", "type": "string", "location": "query" } }, "response": { "$ref": "SasPortalListNodesResponse" }, "path": "v1alpha1/{+parent}/nodes", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/nodes", "parameterOrder": [ "parent" ] }, "create": { "description": "Creates a new node.", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalNode" }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/nodes", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The parent resource name where the node is to be created." } }, "path": "v1alpha1/{+parent}/nodes", "request": { "$ref": "SasPortalNode" }, "id": "sasportal.customers.nodes.nodes.create" } } }, "deployments": { "methods": { "list": { "path": "v1alpha1/{+parent}/deployments", "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "location": "query", "description": "A pagination token returned from a previous call to ListDeployments that indicates where this listing should continue from." }, "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 deployments are filtered.", "type": "string" }, "pageSize": { "description": "The maximum number of deployments to return in the response.", "format": "int32", "location": "query", "type": "integer" }, "parent": { "location": "path", "required": true, "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2.", "pattern": "^customers/[^/]+/nodes/[^/]+$", "type": "string" } }, "response": { "$ref": "SasPortalListDeploymentsResponse" }, "id": "sasportal.customers.nodes.deployments.list", "description": "Lists deployments.", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ] }, "create": { "description": "Creates a new deployment.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The parent resource name where the deployment is to be created.", "pattern": "^customers/[^/]+/nodes/[^/]+$", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "SasPortalDeployment" }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/deployments", "id": "sasportal.customers.nodes.deployments.create", "request": { "$ref": "SasPortalDeployment" }, "path": "v1alpha1/{+parent}/deployments" } } }, "devices": { "methods": { "list": { "id": "sasportal.customers.nodes.devices.list", "httpMethod": "GET", "parameters": { "parent": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "location": "path", "required": true, "description": "Required. The name of the parent resource.", "type": "string" }, "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": { "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].", "format": "int32", "type": "integer", "location": "query" }, "pageToken": { "location": "query", "type": "string", "description": "A pagination token returned from a previous call to ListDevices that indicates where this listing should continue from." } }, "response": { "$ref": "SasPortalListDevicesResponse" }, "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/devices", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/devices", "description": "Lists devices under a node or customer." }, "create": { "id": "sasportal.customers.nodes.devices.create", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the parent resource." } }, "parameterOrder": [ "parent" ], "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/devices", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/devices", "request": { "$ref": "SasPortalDevice" }, "description": "Creates a device under a node or customer." }, "createSigned": { "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+/nodes/[^/]+$", "description": "Required. The name of the parent resource." } }, "path": "v1alpha1/{+parent}/devices:createSigned", "description": "Creates a signed device under a node or customer.", "id": "sasportal.customers.nodes.devices.createSigned", "parameterOrder": [ "parent" ], "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}/devices:createSigned", "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] } } } }, "methods": { "delete": { "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^customers/[^/]+/nodes/[^/]+$", "type": "string", "description": "Required. The name of the node." } }, "description": "Deletes a node.", "response": { "$ref": "SasPortalEmpty" }, "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}", "id": "sasportal.customers.nodes.delete", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "name" ] }, "patch": { "description": "Updates an existing node.", "request": { "$ref": "SasPortalNode" }, "httpMethod": "PATCH", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Fields to be updated.", "type": "string" }, "name": { "pattern": "^customers/[^/]+/nodes/[^/]+$", "description": "Output only. Resource name.", "location": "path", "required": true, "type": "string" } }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}", "response": { "$ref": "SasPortalNode" }, "path": "v1alpha1/{+name}", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.customers.nodes.patch" }, "get": { "response": { "$ref": "SasPortalNode" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Returns a requested node.", "id": "sasportal.customers.nodes.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the node.", "type": "string", "pattern": "^customers/[^/]+/nodes/[^/]+$" } }, "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}", "path": "v1alpha1/{+name}" }, "create": { "id": "sasportal.customers.nodes.create", "path": "v1alpha1/{+parent}/nodes", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "description": "Required. The parent resource name where the node is to be created.", "type": "string", "location": "path", "required": true } }, "description": "Creates a new node.", "parameterOrder": [ "parent" ], "flatPath": "v1alpha1/customers/{customersId}/nodes", "request": { "$ref": "SasPortalNode" }, "response": { "$ref": "SasPortalNode" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "list": { "httpMethod": "GET", "parameters": { "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" }, "pageToken": { "type": "string", "location": "query", "description": "A pagination token returned from a previous call to ListNodes that indicates where this listing should continue from." }, "parent": { "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+$", "description": "Required. The parent resource name, for example, \"nodes/1\"." }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "The maximum number of nodes to return in the response." } }, "flatPath": "v1alpha1/customers/{customersId}/nodes", "path": "v1alpha1/{+parent}/nodes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "description": "Lists nodes.", "response": { "$ref": "SasPortalListNodesResponse" }, "id": "sasportal.customers.nodes.list" }, "move": { "parameterOrder": [ "name" ], "flatPath": "v1alpha1/customers/{customersId}/nodes/{nodesId}:move", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "POST", "parameters": { "name": { "description": "Required. The name of the node to move.", "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+/nodes/[^/]+$" } }, "description": "Moves a node under another node or customer.", "response": { "$ref": "SasPortalOperation" }, "id": "sasportal.customers.nodes.move", "path": "v1alpha1/{+name}:move", "request": { "$ref": "SasPortalMoveNodeRequest" } } } }, "deployments": { "methods": { "list": { "flatPath": "v1alpha1/customers/{customersId}/deployments", "path": "v1alpha1/{+parent}/deployments", "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "GET", "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": { "pattern": "^customers/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The parent resource name, for example, \"nodes/1\", customer/1/nodes/2." }, "pageSize": { "format": "int32", "description": "The maximum number of deployments to return in the response.", "type": "integer", "location": "query" }, "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." } }, "response": { "$ref": "SasPortalListDeploymentsResponse" }, "id": "sasportal.customers.deployments.list", "description": "Lists deployments." }, "move": { "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the deployment to move.", "pattern": "^customers/[^/]+/deployments/[^/]+$" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "request": { "$ref": "SasPortalMoveDeploymentRequest" }, "path": "v1alpha1/{+name}:move", "response": { "$ref": "SasPortalOperation" }, "description": "Moves a deployment under another node or customer.", "id": "sasportal.customers.deployments.move", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}:move" }, "delete": { "id": "sasportal.customers.deployments.delete", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^customers/[^/]+/deployments/[^/]+$", "type": "string", "description": "Required. The name of the deployment.", "location": "path", "required": true } }, "description": "Deletes a deployment.", "path": "v1alpha1/{+name}", "response": { "$ref": "SasPortalEmpty" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "patch": { "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "required": true, "type": "string", "pattern": "^customers/[^/]+/deployments/[^/]+$", "description": "Output only. Resource name." }, "updateMask": { "description": "Fields to be updated.", "type": "string", "format": "google-fieldmask", "location": "query" } }, "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}", "id": "sasportal.customers.deployments.patch", "description": "Updates an existing deployment.", "path": "v1alpha1/{+name}", "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalDeployment" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDeployment" } }, "get": { "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}", "description": "Returns a requested deployment.", "path": "v1alpha1/{+name}", "id": "sasportal.customers.deployments.get", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The name of the deployment.", "location": "path", "required": true, "pattern": "^customers/[^/]+/deployments/[^/]+$", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalDeployment" } }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "SasPortalDeployment" }, "path": "v1alpha1/{+parent}/deployments", "flatPath": "v1alpha1/customers/{customersId}/deployments", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.customers.deployments.create", "response": { "$ref": "SasPortalDeployment" }, "description": "Creates a new deployment.", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "location": "path", "required": true, "description": "Required. The parent resource name where the deployment is to be created.", "type": "string" } } } }, "resources": { "devices": { "methods": { "list": { "path": "v1alpha1/{+parent}/devices", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Lists devices under a node or customer.", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}/devices", "id": "sasportal.customers.deployments.devices.list", "response": { "$ref": "SasPortalListDevicesResponse" }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "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" }, "parent": { "location": "path", "required": true, "type": "string", "description": "Required. The name of the parent resource.", "pattern": "^customers/[^/]+/deployments/[^/]+$" }, "pageSize": { "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].", "type": "integer" }, "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." } } }, "createSigned": { "response": { "$ref": "SasPortalDevice" }, "description": "Creates a signed device under a node or customer.", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+/deployments/[^/]+$", "type": "string", "description": "Required. The name of the parent resource.", "location": "path", "required": true } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+parent}/devices:createSigned", "parameterOrder": [ "parent" ], "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "id": "sasportal.customers.deployments.devices.createSigned", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}/devices:createSigned" }, "create": { "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDevice" }, "id": "sasportal.customers.deployments.devices.create", "description": "Creates a device under a node or customer.", "path": "v1alpha1/{+parent}/devices", "flatPath": "v1alpha1/customers/{customersId}/deployments/{deploymentsId}/devices", "request": { "$ref": "SasPortalDevice" }, "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "description": "Required. The name of the parent resource.", "type": "string", "pattern": "^customers/[^/]+/deployments/[^/]+$" } } } } } } }, "devices": { "methods": { "createSigned": { "id": "sasportal.customers.devices.createSigned", "parameterOrder": [ "parent" ], "httpMethod": "POST", "parameters": { "parent": { "location": "path", "required": true, "pattern": "^customers/[^/]+$", "description": "Required. The name of the parent resource.", "type": "string" } }, "path": "v1alpha1/{+parent}/devices:createSigned", "flatPath": "v1alpha1/customers/{customersId}/devices:createSigned", "response": { "$ref": "SasPortalDevice" }, "request": { "$ref": "SasPortalCreateSignedDeviceRequest" }, "description": "Creates a signed device under a node or customer.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "patch": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Updates a device.", "parameterOrder": [ "name" ], "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}", "response": { "$ref": "SasPortalDevice" }, "id": "sasportal.customers.devices.patch", "request": { "$ref": "SasPortalDevice" }, "httpMethod": "PATCH", "parameters": { "name": { "description": "Output only. The resource path name.", "type": "string", "location": "path", "required": true, "pattern": "^customers/[^/]+/devices/[^/]+$" }, "updateMask": { "location": "query", "format": "google-fieldmask", "type": "string", "description": "Fields to be updated." } } }, "get": { "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalDevice" }, "description": "Gets details about a device.", "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The name of the device.", "type": "string", "location": "path", "required": true } }, "id": "sasportal.customers.devices.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ] }, "updateSigned": { "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}:updateSigned", "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The name of the device to update.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "name" ], "description": "Updates a signed device.", "path": "v1alpha1/{+name}:updateSigned", "id": "sasportal.customers.devices.updateSigned", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalDevice" }, "request": { "$ref": "SasPortalUpdateSignedDeviceRequest" } }, "signDevice": { "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}:signDevice", "path": "v1alpha1/{+name}:signDevice", "description": "Signs a device.", "request": { "$ref": "SasPortalSignDeviceRequest" }, "id": "sasportal.customers.devices.signDevice", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "response": { "$ref": "SasPortalEmpty" }, "httpMethod": "POST", "parameters": { "name": { "pattern": "^customers/[^/]+/devices/[^/]+$", "location": "path", "required": true, "description": "Output only. The resource path name.", "type": "string" } }, "parameterOrder": [ "name" ] }, "list": { "description": "Lists devices under a node or customer.", "httpMethod": "GET", "parameters": { "pageSize": { "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].", "format": "int32", "type": "integer" }, "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", "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" }, "parent": { "pattern": "^customers/[^/]+$", "type": "string", "description": "Required. The name of the parent resource.", "location": "path", "required": true } }, "flatPath": "v1alpha1/customers/{customersId}/devices", "response": { "$ref": "SasPortalListDevicesResponse" }, "id": "sasportal.customers.devices.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "parameterOrder": [ "parent" ], "path": "v1alpha1/{+parent}/devices" }, "move": { "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "required": true, "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The name of the device to move." } }, "description": "Moves a device under another node or customer.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}:move", "id": "sasportal.customers.devices.move", "request": { "$ref": "SasPortalMoveDeviceRequest" }, "path": "v1alpha1/{+name}:move", "response": { "$ref": "SasPortalOperation" } }, "delete": { "description": "Deletes a device.", "response": { "$ref": "SasPortalEmpty" }, "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "required": true, "pattern": "^customers/[^/]+/devices/[^/]+$", "description": "Required. The name of the device.", "type": "string" } }, "path": "v1alpha1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "id": "sasportal.customers.devices.delete", "parameterOrder": [ "name" ], "flatPath": "v1alpha1/customers/{customersId}/devices/{devicesId}" }, "create": { "id": "sasportal.customers.devices.create", "request": { "$ref": "SasPortalDevice" }, "response": { "$ref": "SasPortalDevice" }, "description": "Creates a device under a node or customer.", "httpMethod": "POST", "parameters": { "parent": { "pattern": "^customers/[^/]+$", "type": "string", "location": "path", "required": true, "description": "Required. The name of the parent resource." } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/customers/{customersId}/devices", "path": "v1alpha1/{+parent}/devices" } } } } }, "deployments": { "methods": { "get": { "id": "sasportal.deployments.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Returns a requested deployment.", "httpMethod": "GET", "parameters": { "name": { "pattern": "^deployments/[^/]+$", "description": "Required. The name of the deployment.", "location": "path", "required": true, "type": "string" } }, "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/deployments/{deploymentsId}", "parameterOrder": [ "name" ], "response": { "$ref": "SasPortalDeployment" } } }, "resources": { "devices": { "methods": { "move": { "id": "sasportal.deployments.devices.move", "response": { "$ref": "SasPortalOperation" }, "parameterOrder": [ "name" ], "path": "v1alpha1/{+name}:move", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Moves a device under another node or customer.", "request": { "$ref": "SasPortalMoveDeviceRequest" }, "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}:move", "httpMethod": "POST", "parameters": { "name": { "location": "path", "required": true, "description": "Required. The name of the device to move.", "type": "string", "pattern": "^deployments/[^/]+/devices/[^/]+$" } } }, "patch": { "id": "sasportal.deployments.devices.patch", "response": { "$ref": "SasPortalDevice" }, "httpMethod": "PATCH", "parameters": { "name": { "location": "path", "required": true, "pattern": "^deployments/[^/]+/devices/[^/]+$", "type": "string", "description": "Output only. The resource path name." }, "updateMask": { "description": "Fields to be updated.", "format": "google-fieldmask", "location": "query", "type": "string" } }, "request": { "$ref": "SasPortalDevice" }, "path": "v1alpha1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}", "description": "Updates a device.", "parameterOrder": [ "name" ] }, "delete": { "id": "sasportal.deployments.devices.delete", "path": "v1alpha1/{+name}", "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}", "description": "Deletes a device.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "description": "Required. The name of the device.", "pattern": "^deployments/[^/]+/devices/[^/]+$", "location": "path", "required": true } }, "response": { "$ref": "SasPortalEmpty" } }, "get": { "id": "sasportal.deployments.devices.get", "description": "Gets details about a device.", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "required": true, "description": "Required. The name of the device.", "pattern": "^deployments/[^/]+/devices/[^/]+$" } }, "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}", "response": { "$ref": "SasPortalDevice" }, "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}" }, "updateSigned": { "httpMethod": "PATCH", "parameters": { "name": { "description": "Required. The name of the device to update.", "pattern": "^deployments/[^/]+/devices/[^/]+$", "location": "path", "required": true, "type": "string" } }, "response": { "$ref": "SasPortalDevice" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "description": "Updates a signed device.", "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}:updateSigned", "parameterOrder": [ "name" ], "request": { "$ref": "SasPortalUpdateSignedDeviceRequest" }, "path": "v1alpha1/{+name}:updateSigned", "id": "sasportal.deployments.devices.updateSigned" }, "signDevice": { "parameterOrder": [ "name" ], "httpMethod": "POST", "parameters": { "name": { "description": "Output only. The resource path name.", "location": "path", "required": true, "type": "string", "pattern": "^deployments/[^/]+/devices/[^/]+$" } }, "id": "sasportal.deployments.devices.signDevice", "request": { "$ref": "SasPortalSignDeviceRequest" }, "response": { "$ref": "SasPortalEmpty" }, "description": "Signs a device.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/sasportal" ], "path": "v1alpha1/{+name}:signDevice", "flatPath": "v1alpha1/deployments/{deploymentsId}/devices/{devicesId}:signDevice" } } } } } }, "id": "sasportal:v1alpha1", "description": "", "schemas": { "SasPortalGenerateSecretRequest": { "description": "Request for GenerateSecret.", "type": "object", "properties": {}, "id": "SasPortalGenerateSecretRequest" }, "SasPortalDeploymentAssociation": { "description": "Association between a gcp project and a SAS user id.", "id": "SasPortalDeploymentAssociation", "type": "object", "properties": { "userId": { "description": "User id of the deployment.", "type": "string" }, "gcpProjectId": { "description": "GCP project id of the associated project.", "type": "string" } } }, "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)." }, "nrqzValidated": { "deprecated": true, "description": "Output only. Set to `true` if a CPI has validated that they have coordinated with the National Quiet Zone office.", "type": "boolean", "readOnly": true }, "commonChannelGroup": { "type": "string", "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)." }, "antennaModel": { "type": "string", "description": "If populated, the Antenna Model Pattern to use. Format is: `RecordCreatorId:PatternId`" }, "nrqzValidation": { "description": "Output only. National Radio Quiet Zone validation info.", "readOnly": true, "$ref": "SasPortalNrqzValidation" } }, "description": "Device data overridable by both SAS Portal and registration requests.", "id": "SasPortalDeviceMetadata" }, "SasPortalGetPolicyRequest": { "properties": { "resource": { "type": "string", "description": "Required. The resource for which the policy is being requested." } }, "id": "SasPortalGetPolicyRequest", "description": "Request message for `GetPolicy` method.", "type": "object" }, "SasPortalValidateInstallerResponse": { "properties": {}, "description": "Response for ValidateInstaller.", "type": "object", "id": "SasPortalValidateInstallerResponse" }, "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": [ "", "", "", "", "", "", "", "", "", "" ], "type": "string", "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." } }, "id": "SasPortalDeviceAirInterface", "type": "object", "description": "Information about the device's air interface." }, "SasPortalCustomer": { "properties": { "name": { "description": "Output only. Resource name of the customer.", "type": "string" }, "sasUserIds": { "description": "User IDs used by the devices belonging to this customer.", "type": "array", "items": { "type": "string" } }, "displayName": { "description": "Required. Name of the organization that the customer entity represents.", "type": "string" } }, "description": "Entity representing a SAS customer.", "type": "object", "id": "SasPortalCustomer" }, "SasPortalMoveNodeRequest": { "properties": { "destination": { "description": "Required. The name of the new parent resource node or customer to reparent the node under.", "type": "string" } }, "description": "Request for MoveNode.", "id": "SasPortalMoveNodeRequest", "type": "object" }, "SasPortalDeviceModel": { "type": "object", "properties": { "firmwareVersion": { "type": "string", "description": "The firmware version of the device." }, "hardwareVersion": { "description": "The hardware version of the device.", "type": "string" }, "softwareVersion": { "type": "string", "description": "The software version of the device." }, "name": { "description": "The name of the device model.", "type": "string" }, "vendor": { "type": "string", "description": "The name of the device vendor." } }, "id": "SasPortalDeviceModel", "description": "Information about the model of the device." }, "SasPortalPolicy": { "properties": { "assignments": { "description": "List of assignments", "items": { "$ref": "SasPortalAssignment" }, "type": "array" }, "etag": { "type": "string", "format": "byte", "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." } }, "description": "Defines an access control policy to the resources.", "id": "SasPortalPolicy", "type": "object" }, "SasPortalGenerateSecretResponse": { "properties": { "secret": { "description": "The secret generated by the string and used by ValidateInstaller.", "type": "string" } }, "id": "SasPortalGenerateSecretResponse", "description": "Response for GenerateSecret.", "type": "object" }, "SasPortalDeviceGrant": { "properties": { "lastHeartbeatTransmitExpireTime": { "format": "google-datetime", "description": "The transmit expiration time of the last heartbeat.", "type": "string" }, "grantId": { "description": "Grant Id.", "type": "string" }, "moveList": { "items": { "$ref": "SasPortalDpaMoveList" }, "description": "The DPA move lists on which this grant appears.", "type": "array" }, "expireTime": { "format": "google-datetime", "type": "string", "description": "The expiration time of the grant." }, "suspensionReason": { "items": { "type": "string" }, "type": "array", "description": "If the grant is suspended, the reason(s) for suspension." }, "maxEirp": { "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).", "type": "number", "format": "double" }, "state": { "type": "string", "enum": [ "GRANT_STATE_UNSPECIFIED", "GRANT_STATE_GRANTED", "GRANT_STATE_TERMINATED", "GRANT_STATE_SUSPENDED", "GRANT_STATE_AUTHORIZED", "GRANT_STATE_EXPIRED" ], "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." }, "frequencyRange": { "$ref": "SasPortalFrequencyRange", "description": "The transmission frequency range." }, "channelType": { "type": "string", "enum": [ "CHANNEL_TYPE_UNSPECIFIED", "CHANNEL_TYPE_GAA", "CHANNEL_TYPE_PAL" ], "enumDescriptions": [ "", "", "" ], "description": "Type of channel used." } }, "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", "type": "object" }, "SasPortalTestPermissionsResponse": { "type": "object", "properties": { "permissions": { "description": "A set of permissions that the caller is allowed.", "items": { "type": "string" }, "type": "array" } }, "description": "Response message for `TestPermissions` method.", "id": "SasPortalTestPermissionsResponse" }, "SasPortalEmpty": { "id": "SasPortalEmpty", "properties": {}, "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); }", "type": "object" }, "SasPortalMigrateOrganizationResponse": { "id": "SasPortalMigrateOrganizationResponse", "properties": { "deploymentAssociation": { "description": "Optional. A list of deployment association that were created for the migration, or current associations if they already exist.", "items": { "$ref": "SasPortalDeploymentAssociation" }, "type": "array" } }, "description": "Response for [MigrateOrganization]. [spectrum.sas.portal.v1alpha1.Provisioning.MigrateOrganization].", "type": "object" }, "SasPortalOperation": { "type": "object", "id": "SasPortalOperation", "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "name": { "type": "string", "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}`." }, "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "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." }, "error": { "$ref": "SasPortalStatus", "description": "The error result of the operation in case of failure or cancellation." }, "response": { "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`.", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "type": "object" }, "done": { "type": "boolean", "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." } } }, "SasPortalListLegacyOrganizationsResponse": { "id": "SasPortalListLegacyOrganizationsResponse", "description": "Response for [ListLegacyOrganizations]. [spectrum.sas.portal.v1alpha1.Provisioning.ListLegacyOrganizations].", "properties": { "organizations": { "items": { "$ref": "SasPortalOrganization" }, "description": "Optional. Legacy SAS organizations.", "type": "array" } }, "type": "object" }, "SasPortalCreateSignedDeviceRequest": { "type": "object", "description": "Request for CreateSignedDevice.", "id": "SasPortalCreateSignedDeviceRequest", "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." } } }, "SasPortalDevice": { "properties": { "grantRangeAllowlists": { "description": "Only ranges that are within the allowlists are available for new grants.", "items": { "$ref": "SasPortalFrequencyRange" }, "type": "array" }, "state": { "type": "string", "enum": [ "DEVICE_STATE_UNSPECIFIED", "RESERVED", "REGISTERED", "DEREGISTERED" ], "enumDescriptions": [ "Unspecified state.", "Device created in the SAS Portal, however, not yet registered with SAS.", "Device registered with SAS.", "Device de-registered with SAS." ], "description": "Output only. Device state." }, "displayName": { "type": "string", "description": "Device display name." }, "currentChannels": { "description": "Output only. Current channels with scores.", "readOnly": true, "deprecated": true, "type": "array", "items": { "$ref": "SasPortalChannelWithScore" } }, "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" }, "preloadedConfig": { "$ref": "SasPortalDeviceConfig", "description": "Configuration of the device, as specified via SAS Portal API." }, "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" }, "grants": { "type": "array", "items": { "$ref": "SasPortalDeviceGrant" }, "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" }, "activeConfig": { "$ref": "SasPortalDeviceConfig", "description": "Output only. Current configuration of the device as registered to the SAS." } }, "type": "object", "id": "SasPortalDevice" }, "SasPortalMigrateOrganizationMetadata": { "type": "object", "id": "SasPortalMigrateOrganizationMetadata", "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." ], "description": "Output only. Current operation state", "type": "string", "readOnly": true } }, "description": "Long-running operation metadata message returned by the MigrateOrganization." }, "SasPortalSetupSasAnalyticsResponse": { "properties": {}, "id": "SasPortalSetupSasAnalyticsResponse", "description": "Response returned by the long running operation for the SetupSasAnalytics rpc.", "type": "object" }, "SasPortalMoveDeviceRequest": { "id": "SasPortalMoveDeviceRequest", "description": "Request for MoveDevice.", "properties": { "destination": { "description": "Required. The name of the new parent resource node or customer to reparent the device under.", "type": "string" } }, "type": "object" }, "SasPortalDeviceConfig": { "properties": { "callSign": { "type": "string", "description": "The call sign of the device operator." }, "isSigned": { "description": "Output only. Whether the configuration has been signed by a CPI.", "type": "boolean" }, "model": { "description": "Information about this device model.", "$ref": "SasPortalDeviceModel" }, "measurementCapabilities": { "description": "Measurement reporting capabilities of the device.", "items": { "type": "string", "enum": [ "MEASUREMENT_CAPABILITY_UNSPECIFIED", "MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT", "MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT" ], "enumDescriptions": [ "", "", "" ] }, "type": "array" }, "installationParams": { "$ref": "SasPortalInstallationParams", "description": "Installation parameters for the device." }, "state": { "enumDescriptions": [ "", "", "" ], "description": "State of the configuration.", "type": "string", "enum": [ "DEVICE_CONFIG_STATE_UNSPECIFIED", "DRAFT", "FINAL" ] }, "airInterface": { "$ref": "SasPortalDeviceAirInterface", "description": "Information about this device's air interface." }, "updateTime": { "type": "string", "description": "Output only. The last time the device configuration was edited.", "format": "google-datetime" }, "userId": { "description": "The identifier of a device user.", "type": "string" }, "category": { "enumDescriptions": [ "Unspecified device category.", "Category A.", "Category B." ], "type": "string", "enum": [ "DEVICE_CATEGORY_UNSPECIFIED", "DEVICE_CATEGORY_A", "DEVICE_CATEGORY_B" ], "description": "FCC category of the device." } }, "type": "object", "id": "SasPortalDeviceConfig", "description": "Information about the device configuration." }, "SasPortalTestPermissionsRequest": { "properties": { "permissions": { "items": { "type": "string" }, "description": "The set of permissions to check for the `resource`.", "type": "array" }, "resource": { "type": "string", "description": "Required. The resource for which the permissions are being requested." } }, "description": "Request message for `TestPermissions` method.", "type": "object", "id": "SasPortalTestPermissionsRequest" }, "SasPortalMoveDeploymentRequest": { "type": "object", "description": "Request for MoveDeployment.", "id": "SasPortalMoveDeploymentRequest", "properties": { "destination": { "description": "Required. The name of the new parent resource node or customer to reparent the deployment under.", "type": "string" } } }, "SasPortalDpaMoveList": { "id": "SasPortalDpaMoveList", "description": "An entry in a DPA's move list.", "type": "object", "properties": { "frequencyRange": { "description": "The frequency range that the move list affects.", "$ref": "SasPortalFrequencyRange" }, "dpaId": { "description": "The ID of the DPA.", "type": "string" } } }, "SasPortalGcpProjectDeployment": { "description": "Deployment associated with the GCP project. Includes whether SAS analytics has been enabled or not.", "type": "object", "id": "SasPortalGcpProjectDeployment", "properties": { "hasEnabledAnalytics": { "description": "Whether SAS analytics has been enabled.", "type": "boolean" }, "deployment": { "$ref": "SasPortalDeployment", "description": "Deployment associated with the GCP project." } } }, "SasPortalProvisionDeploymentRequest": { "properties": { "newOrganizationDisplayName": { "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.", "type": "string" }, "newDeploymentDisplayName": { "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.", "type": "string" }, "organizationId": { "type": "string", "description": "Optional. If this field is set then a new deployment will be created under the organization specified by this id.", "format": "int64" } }, "id": "SasPortalProvisionDeploymentRequest", "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" }, "SasPortalUpdateSignedDeviceRequest": { "id": "SasPortalUpdateSignedDeviceRequest", "type": "object", "properties": { "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." }, "installerId": { "type": "string", "description": "Required. Unique installer ID (CPI ID) from the Certified Professional Installers database." } }, "description": "Request for UpdateSignedDevice." }, "SasPortalValidateInstallerRequest": { "type": "object", "description": "Request for ValidateInstaller.", "properties": { "secret": { "description": "Required. Secret returned by the GenerateSecret.", "type": "string" }, "encodedSecret": { "type": "string", "description": "Required. JSON Web Token signed using a CPI private key. Payload must include a \"secret\" claim whose value is the secret." }, "installerId": { "type": "string", "description": "Required. Unique installer id (CPI ID) from the Certified Professional Installers database." } }, "id": "SasPortalValidateInstallerRequest" }, "SasPortalNrqzValidation": { "properties": { "longitude": { "description": "Device longitude that's associated with the validation.", "format": "double", "type": "number" }, "caseId": { "type": "string", "description": "Validation case ID." }, "latitude": { "type": "number", "format": "double", "description": "Device latitude that's associated with the validation." }, "cpiId": { "type": "string", "description": "CPI who signed the validation." }, "state": { "description": "State of the NRQZ validation info.", "type": "string", "enum": [ "STATE_UNSPECIFIED", "DRAFT", "FINAL" ], "enumDescriptions": [ "Unspecified state.", "Draft state.", "Final state." ] } }, "id": "SasPortalNrqzValidation", "type": "object", "description": "Information about National Radio Quiet Zone validation." }, "SasPortalStatus": { "properties": { "details": { "type": "array", "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } } }, "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" }, "code": { "type": "integer", "format": "int32", "description": "The status code, which should be an enum value of google.rpc.Code." } }, "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", "type": "object" }, "SasPortalListCustomersResponse": { "id": "SasPortalListCustomersResponse", "description": "Response for `ListCustomers`.", "type": "object", "properties": { "customers": { "type": "array", "items": { "$ref": "SasPortalCustomer" }, "description": "The list of customers that match the request." }, "nextPageToken": { "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.", "type": "string" } } }, "SasPortalSetPolicyRequest": { "id": "SasPortalSetPolicyRequest", "description": "Request message for `SetPolicy` method.", "type": "object", "properties": { "policy": { "description": "Required. The policy to be applied to the `resource`.", "$ref": "SasPortalPolicy" }, "resource": { "description": "Required. The resource for which the policy is being specified. This policy replaces any existing policy.", "type": "string" }, "disableNotification": { "description": "Optional. Set the field as `true` to disable the onboarding notification.", "type": "boolean" } } }, "SasPortalListDeploymentsResponse": { "type": "object", "id": "SasPortalListDeploymentsResponse", "properties": { "deployments": { "type": "array", "items": { "$ref": "SasPortalDeployment" }, "description": "The deployments that match the request." }, "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" } }, "description": "Response for ListDeployments." }, "SasPortalChannelWithScore": { "properties": { "frequencyRange": { "description": "The frequency range of the channel.", "$ref": "SasPortalFrequencyRange" }, "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." }, "SasPortalAssignment": { "description": "Associates `members` with a `role`.", "id": "SasPortalAssignment", "properties": { "members": { "type": "array", "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`.", "items": { "type": "string" } }, "role": { "description": "Required. Role that is assigned to `members`.", "type": "string" } }, "type": "object" }, "SasPortalMigrateOrganizationRequest": { "id": "SasPortalMigrateOrganizationRequest", "type": "object", "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": { "description": "Required. Id of the SAS organization to be migrated.", "format": "int64", "type": "string" } } }, "SasPortalSetupSasAnalyticsMetadata": { "type": "object", "id": "SasPortalSetupSasAnalyticsMetadata", "description": "Metadata returned by the long running operation for the SetupSasAnalytics rpc.", "properties": {} }, "SasPortalProvisionDeploymentResponse": { "description": "Response for [ProvisionDeployment]. [spectrum.sas.portal.v1alpha1.Provisioning.ProvisionDeployment].", "id": "SasPortalProvisionDeploymentResponse", "type": "object", "properties": { "errorMessage": { "type": "string", "description": "Optional. Optional error message if the provisioning request is not successful." } } }, "SasPortalDeployment": { "id": "SasPortalDeployment", "type": "object", "properties": { "name": { "readOnly": true, "type": "string", "description": "Output only. Resource name." }, "frns": { "items": { "type": "string" }, "readOnly": true, "description": "Output only. The FCC Registration Numbers (FRNs) copied from its direct parent.", "type": "array" }, "sasUserIds": { "type": "array", "description": "User ID used by the devices belonging to this deployment. Each deployment should be associated with one unique user ID.", "items": { "type": "string" } }, "displayName": { "type": "string", "description": "The deployment's display name." } }, "description": "The Deployment." }, "SasPortalListNodesResponse": { "type": "object", "properties": { "nodes": { "items": { "$ref": "SasPortalNode" }, "description": "The nodes that match the request.", "type": "array" }, "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" } }, "id": "SasPortalListNodesResponse", "description": "Response for ListNodes." }, "SasPortalSetupSasAnalyticsRequest": { "properties": { "userId": { "type": "string", "description": "Optional. User id to setup analytics for, if not provided the user id associated with the project is used. optional" } }, "type": "object", "id": "SasPortalSetupSasAnalyticsRequest", "description": "Request for the SetupSasAnalytics rpc." }, "SasPortalInstallationParams": { "id": "SasPortalInstallationParams", "properties": { "cpeCbsdIndication": { "description": "If present, this parameter specifies whether the CBSD is a CPE-CBSD or not.", "type": "boolean" }, "horizontalAccuracy": { "format": "double", "type": "number", "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." }, "height": { "type": "number", "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.", "format": "double" }, "longitude": { "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.", "format": "double", "type": "number" }, "indoorDeployment": { "description": "Whether the device antenna is indoor or not. `true`: indoor. `false`: outdoor.", "type": "boolean" }, "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" }, "heightType": { "enumDescriptions": [ "Unspecified height type.", "AGL height is measured relative to the ground level.", "AMSL height is measured relative to the mean sea level." ], "description": "Specifies how the height is measured.", "type": "string", "enum": [ "HEIGHT_TYPE_UNSPECIFIED", "HEIGHT_TYPE_AGL", "HEIGHT_TYPE_AMSL" ] }, "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" }, "antennaAzimuth": { "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", "format": "int32" }, "eirpCapability": { "type": "integer", "format": "int32", "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." }, "verticalAccuracy": { "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.", "format": "double", "type": "number" }, "antennaModel": { "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.", "type": "string" }, "antennaGain": { "type": "number", "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", "format": "double" }, "antennaBeamwidth": { "format": "int32", "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.", "type": "integer" } }, "type": "object", "description": "Information about the device installation parameters." }, "SasPortalNode": { "properties": { "displayName": { "description": "The node's display name.", "type": "string" }, "name": { "type": "string", "description": "Output only. Resource name." }, "sasUserIds": { "type": "array", "description": "User ids used by the devices belonging to this node.", "items": { "type": "string" } } }, "description": "The Node.", "id": "SasPortalNode", "type": "object" }, "SasPortalListGcpProjectDeploymentsResponse": { "type": "object", "id": "SasPortalListGcpProjectDeploymentsResponse", "properties": { "deployments": { "items": { "$ref": "SasPortalGcpProjectDeployment" }, "type": "array", "description": "Optional. Deployments associated with the GCP project" } }, "description": "Response for [ListGcpProjectDeployments]." }, "SasPortalSignDeviceRequest": { "id": "SasPortalSignDeviceRequest", "properties": { "device": { "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.", "$ref": "SasPortalDevice" } }, "description": "Request for SignDevice.", "type": "object" }, "SasPortalFrequencyRange": { "properties": { "lowFrequencyMhz": { "format": "double", "description": "The lowest frequency of the frequency range in MHz.", "type": "number" }, "highFrequencyMhz": { "format": "double", "type": "number", "description": "The highest frequency of the frequency range in MHz." } }, "id": "SasPortalFrequencyRange", "type": "object", "description": "Frequency range from `low_frequency` to `high_frequency`." }, "SasPortalListDevicesResponse": { "id": "SasPortalListDevicesResponse", "description": "Response for ListDevices.", "type": "object", "properties": { "devices": { "items": { "$ref": "SasPortalDevice" }, "type": "array", "description": "The devices that match the request." }, "nextPageToken": { "type": "string", "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." } } }, "SasPortalOrganization": { "properties": { "displayName": { "type": "string", "description": "Name of organization" }, "id": { "description": "Id of organization", "format": "int64", "type": "string" } }, "type": "object", "id": "SasPortalOrganization", "description": "Organization details." } } }