Method: customers.devices.signDevice
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://sasportal.googleapis.com/v1alpha1/{device.name=customers/*/devices/*}:signDevice
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
device.name |
string
僅供輸出。資源路徑名稱。
|
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"device": {
"name": string,
"fccId": string,
"serialNumber": string,
"preloadedConfig": {
object (DeviceConfig )
},
"activeConfig": {
object (DeviceConfig )
},
"state": enum (State ),
"grants": [
{
object (DeviceGrant )
}
]
}
} |
欄位 |
device.fccId |
string
裝置的 FCC ID。
|
device.serialNumber |
string
裝置製造商為裝置指派的序號。
|
device.preloadedConfig |
object (DeviceConfig )
裝置設定,透過 SAS 入口網站 API 指定。
|
device.activeConfig |
object (DeviceConfig )
僅供輸出。裝置目前向 SAS 註冊的設定。
|
device.state |
enum (State )
僅供輸出。裝置狀態。
|
device.grants[] |
object (DeviceGrant )
僅供輸出。裝置持有的授權。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/userinfo.email
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eSigns a device with the provided FCC ID and serial number using the SAS Portal API.\u003c/p\u003e\n"],["\u003cp\u003eRequires a POST request to the specific endpoint \u003ccode\u003ehttps://sasportal.googleapis.com/v1alpha1/{device.name=customers/*/devices/*}:signDevice\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes device details like FCC ID, serial number, preloaded and active configurations.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful signing, the response body will be empty.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the scope \u003ccode\u003ehttps://www.googleapis.com/auth/userinfo.email\u003c/code\u003e.\u003c/p\u003e\n"]]],["This document details how to sign a device using a POST HTTP request to `https://sasportal.googleapis.com/v1alpha1/{device.name=customers/*/devices/*}:signDevice`. The request requires a JSON body including the device's `fccId`, `serialNumber`, `preloadedConfig`, `activeConfig`, `state`, and `grants`. `device.name` is a path parameter indicating the resource path. A successful request returns an empty body. Authorization requires the `https://www.googleapis.com/auth/userinfo.email` OAuth scope.\n"],null,["# Method: customers.devices.signDevice\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION.device.SCHEMA_REPRESENTATION)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION.device.SCHEMA_REPRESENTATION_1)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION.device.SCHEMA_REPRESENTATION_2)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nSigns a [device](/spectrum-access-system/reference/rest/customers.devices#Device).\n\n### HTTP request\n\n`POST https://sasportal.googleapis.com/v1alpha1/{device.name=customers/*/devices/*}:signDevice`\n\nThe URL uses [gRPC Transcoding](https://github.com/googleapis/googleapis/blob/master/google/api/http.proto) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------------------|\n| `device.name` | `string` Output only. The resource path name. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"device\": { \"name\": string, \"fccId\": string, \"serialNumber\": string, \"preloadedConfig\": { object (/spectrum-access-system/reference/rest/customers.devices#Device.DeviceConfig) }, \"activeConfig\": { object (/spectrum-access-system/reference/rest/customers.devices#Device.DeviceConfig) }, \"state\": enum (/spectrum-access-system/reference/rest/customers.devices#Device.State_1), \"grants\": [ { object (/spectrum-access-system/reference/rest/customers.devices#Device.DeviceGrant) } ] } } ``` |\n\n| Fields ||\n|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `device.fccId` | `string` The FCC identifier of the device. |\n| `device.serialNumber` | `string` A serial number assigned to the device by the device manufacturer. |\n| `device.preloadedConfig` | `object (`[DeviceConfig](/spectrum-access-system/reference/rest/customers.devices#Device.DeviceConfig)`)` Configuration of the device, as specified via SAS Portal API. |\n| `device.activeConfig` | `object (`[DeviceConfig](/spectrum-access-system/reference/rest/customers.devices#Device.DeviceConfig)`)` Output only. Current configuration of the device as registered to the SAS. |\n| `device.state` | `enum (`[State](/spectrum-access-system/reference/rest/customers.devices#Device.State_1)`)` Output only. Device state. |\n| `device.grants[]` | `object (`[DeviceGrant](/spectrum-access-system/reference/rest/customers.devices#Device.DeviceGrant)`)` Output only. Grants held by the device. |\n\n### Response body\n\nIf successful, the response body will be empty.\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/userinfo.email`"]]