Method: customers.policies.networks.defineNetwork
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Definieren Sie ein neues Netzwerk.
HTTP-Anfrage
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineNetwork
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
customer |
string
Erforderlich. Der Kunde, dem dieses neue Netzwerk gehört.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
{
"targetResource": string,
"name": string,
"settings": [
{
object (NetworkSetting )
}
]
} |
Felder |
targetResource |
string
Erforderlich. Die Zielressource, in der dieses neue Netzwerk definiert wird. Die folgenden Ressourcen werden unterstützt: * Organisationseinheit ("orgunits/{orgunit_id}")
|
name |
string
Erforderlich. Name des neu erstellten Netzwerks.
|
settings[] |
object (NetworkSetting )
Erforderlich. Detaillierte Netzwerkeinstellungen.
|
Antworttext
Antwortobjekt zum Erstellen eines Netzwerks.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"networkId": string,
"targetResource": string,
"settings": [
{
object (NetworkSetting )
}
]
} |
Felder |
networkId |
string
Netzwerk-ID des neu erstellten Netzwerks.
|
targetResource |
string
Die Zielressource, in der dieses neue Netzwerk definiert wird. Die folgenden Ressourcen werden unterstützt: * Organisationseinheit ("orgunits/{orgunit_id}")
|
settings[] |
object (NetworkSetting )
Detaillierte Einstellungen für das neu erstellte Netzwerk
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/chrome.management.policy
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\u003eDefine a new network with specific settings for a target resource, such as an organizational unit.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires the target resource, network name, and detailed network settings.\u003c/p\u003e\n"],["\u003cp\u003eThe response body provides the network ID, target resource, and network settings of the newly created network.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.policy\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: customers.policies.networks.defineNetwork\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 - [JSON representation](#body.DefineNetworkResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDefine a new network.\n\n### HTTP request\n\n`POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineNetwork`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|----------------------------------------------------------------|\n| `customer` | `string` Required. The customer who will own this new network. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"targetResource\": string, \"name\": string, \"settings\": [ { object (/chrome/policy/reference/rest/v1/NetworkSetting) } ] } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `targetResource` | `string` Required. The target resource on which this new network will be defined. The following resources are supported: \\* Organizational Unit (\"orgunits/{orgunit_id}\") |\n| `name` | `string` Required. name of the new created network. |\n| `settings[]` | `object (`[NetworkSetting](/chrome/policy/reference/rest/v1/NetworkSetting)`)` Required. Detailed network settings. |\n\n### Response body\n\nResponse object for creating a network.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"networkId\": string, \"targetResource\": string, \"settings\": [ { object (/chrome/policy/reference/rest/v1/NetworkSetting) } ] } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `networkId` | `string` Network ID of the new created network. |\n| `targetResource` | `string` The target resource on which this new network will be defined. The following resources are supported: \\* Organizational Unit (\"orgunits/{orgunit_id}\") |\n| `settings[]` | `object (`[NetworkSetting](/chrome/policy/reference/rest/v1/NetworkSetting)`)` Detailed network settings of the new created network |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.policy`"]]