Method: customers.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=customers/*/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. 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/userinfo.email
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\u003eThis documentation outlines the process for updating a signed device using a \u003ccode\u003ePATCH\u003c/code\u003e request to the specified endpoint.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires path and body parameters, including device name, encoded device data, and installer ID.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response returns the updated device information.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/userinfo.email\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details updating a signed device via a PATCH request to `https://sasportal.googleapis.com/v1alpha1/{name=customers/*/devices/*}:updateSigned`. The request requires a `name` path parameter identifying the device. The request body, in JSON, includes `encodedDevice`, a base64-encoded, signed JSON Web Token representing the device, and `installerId`, a unique CPI ID. A successful response returns an instance of the updated `Device`. Authorization requires the `https://www.googleapis.com/auth/userinfo.email` OAuth scope.\n"],null,["# Method: customers.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/customers.devices#Device).\n\n### HTTP request\n\n`PATCH https://sasportal.googleapis.com/v1alpha1/{name=customers/*/devices/*}:updateSigned`\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| `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](/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/customers.devices#Device). A base64-encoded string. \u003cbr /\u003e |\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/customers.devices#Device).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/userinfo.email`"]]
