Method: nodes.devices.createSigned
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
HTTP-Anfrage
POST https://sasportal.googleapis.com/v1alpha1/{parent=nodes/*}/devices:createSigned
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Der Name der übergeordneten Ressource.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"encodedDevice": string,
"installerId": string
} |
| Felder |
encodedDevice |
string (bytes format)
Erforderlich. 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\u003eCreates a signed device under a node or customer using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eRequires a JSON Web Token in the request body with the device details and installer ID.\u003c/p\u003e\n"],["\u003cp\u003eReturns the created device details in the response if successful.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/sasportal\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUses gRPC Transcoding for the URL structure.\u003c/p\u003e\n"]]],["This describes how to create a signed device under a node or customer using a POST request. The URL structure, defined using gRPC Transcoding, includes a required `parent` path parameter. The request body, in JSON format, must contain `encodedDevice` (a base64-encoded, signed JSON Web Token representing the device) and a unique `installerId`. A successful operation returns a device object in the response body. Authorization requires the `https://www.googleapis.com/auth/sasportal` OAuth scope.\n"],null,["# Method: nodes.devices.createSigned\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\nCreates a signed [device](/spectrum-access-system/reference/rest/v1alpha1/customers.deployments.devices#Device) under a [node](/spectrum-access-system/reference/rest/v1alpha1/customers.nodes#Node) or [customer](/spectrum-access-system/reference/rest/v1alpha1/customers#Customer).\n\n### HTTP request\n\n`POST https://sasportal.googleapis.com/v1alpha1/{parent=nodes/*}/devices:createSigned`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------|\n| `parent` | `string` Required. The name of the parent resource. |\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. 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`"]]
