Method: nodes.devices.updateSigned
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Aktualisiert eine signierte device.
HTTP-Anfrage
PATCH https://sasportal.googleapis.com/v1alpha1/{name=nodes/*/devices/*}:updateSigned
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Der Name des Geräts, das aktualisiert werden soll.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"encodedDevice": string,
"installerId": string
} |
| Felder |
encodedDevice |
string (bytes format)
Erforderlich. Das JSON Web Token, das mit einem privaten CPI-Schlüssel signiert wurde. Die Nutzlast muss die JSON-Codierung von device sein. Das Feld userId muss festgelegt werden. Ein base64-codierter String.
|
installerId |
string
Erforderlich. Eindeutige ID des Installateurs (CPI-ID) aus der Datenbank für zertifizierte professionelle Installateure.
|
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Device.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/sasportal
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eUpdates a signed device using a PATCH request to a specific endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the device name as a path parameter and device details in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a JSON Web Token with the device details and the installer ID.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns the updated device details.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/sasportal\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details the process of updating a signed device via a PATCH request to the specified URL, `/v1alpha1/{name=nodes/*/devices/*}:updateSigned`. The request requires a `name` path parameter (the device's name), and a JSON request body. This body includes `encodedDevice` (a base64-encoded JSON Web Token of the device) and `installerId` (a unique CPI ID). Successful requests return an instance of the updated device, and the process requires the `https://www.googleapis.com/auth/sasportal` OAuth scope for authorization.\n"],null,["# Method: nodes.devices.updateSigned\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- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nUpdates a signed [device](/spectrum-access-system/reference/rest/v1alpha1/customers.deployments.devices#Device).\n\n### HTTP request\n\n`PATCH https://sasportal.googleapis.com/v1alpha1/{name=nodes/*/devices/*}:updateSigned`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|------------------------------------------------------|\n| `name` | `string` Required. The name of the device to update. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------|\n| ``` { \"encodedDevice\": string, \"installerId\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `encodedDevice` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` Required. The JSON Web Token signed using a CPI private key. Payload must be the JSON encoding of the [device](/spectrum-access-system/reference/rest/v1alpha1/customers.deployments.devices#Device). The [userId](/spectrum-access-system/reference/rest/v1alpha1/customers.deployments.devices#Device.DeviceConfig.FIELDS.user_id) field must be set. A base64-encoded string. |\n| `installerId` | `string` Required. Unique installer ID (CPI ID) from the Certified Professional Installers database. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Device](/spectrum-access-system/reference/rest/v1alpha1/customers.deployments.devices#Device).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/sasportal`"]]
