Method: customers.policies.networks.defineCertificate
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينشئ شهادة في وحدة تنظيمية محدّدة لعميل.
طلب HTTP
POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineCertificate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
customer |
string
مطلوب. العميل الذي ستسري الشهادة عليه.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
{
"targetResource": string,
"ceritificateName": string,
"certificate": string,
"settings": [
{
object (NetworkSetting )
}
]
} |
الحقول |
targetResource |
string
مطلوب. المورد المستهدف الذي يتم تطبيق هذه الشهادة عليه. الموارد التالية متاحة: * الوحدة التنظيمية ("orgunits/{orgunit_id}")
|
ceritificateName |
string
اختياريّ. تمثّل هذه السمة الاسم الاختياري للشهادة. إذا لم يتم تحديده، سيتم استخدام جهة إصدار الشهادة كاسم.
|
certificate |
string
مطلوب. المحتوى الأولي لملف .PEM أو .CRT أو .CER
|
settings[] |
object (NetworkSetting )
اختياريّ. إعدادات الشهادات ضمن مساحة الاسم chrome.networks.certificates.
|
نص الاستجابة
كائن الردّ لإنشاء شهادة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"settings": [
{
object (NetworkSetting )
}
],
"networkId": string,
"targetResource": string
} |
الحقول |
settings[] |
object (NetworkSetting )
الإعدادات التابعة للشهادة (لم يتم تنفيذها)
|
networkId |
string
دليل الشهادة الذي تم إنشاؤه من خلال الإجراء.
|
targetResource |
string
المورد الذي يتم تعريف الشهادة فيه.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.policy
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDefines a certificate at a specified organizational unit (OU) for a customer using a POST request.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the certificate data, target resource, and optionally, a certificate name and settings.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful creation, the response includes the certificate's settings, network ID, and target resource.\u003c/p\u003e\n"],["\u003cp\u003eNeeds 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.defineCertificate\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.DefineCertificateResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a certificate at a specified OU for a customer.\n\n### HTTP request\n\n`POST https://chromepolicy.googleapis.com/v1/{customer=customers/*}/policies/networks:defineCertificate`\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 for which the certificate will apply. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"targetResource\": string, \"ceritificateName\": string, \"certificate\": string, \"settings\": [ { object (/chrome/policy/reference/rest/v1/NetworkSetting) } ] } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `targetResource` | `string` Required. The target resource on which this certificate is applied. The following resources are supported: \\* Organizational Unit (\"orgunits/{orgunit_id}\") |\n| `ceritificateName` | `string` Optional. The optional name of the certificate. If not specified, the certificate issuer will be used as the name. |\n| `certificate` | `string` Required. The raw contents of the .PEM, .CRT, or .CER file. |\n| `settings[]` | `object (`[NetworkSetting](/chrome/policy/reference/rest/v1/NetworkSetting)`)` Optional. Certificate settings within the chrome.networks.certificates namespace. |\n\n### Response body\n\nResponse object for creating a certificate.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"settings\": [ { object (/chrome/policy/reference/rest/v1/NetworkSetting) } ], \"networkId\": string, \"targetResource\": string } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| `settings[]` | `object (`[NetworkSetting](/chrome/policy/reference/rest/v1/NetworkSetting)`)` the affiliated settings of the certificate (NOT IMPLEMENTED) |\n| `networkId` | `string` The guid of the certificate created by the action. |\n| `targetResource` | `string` the resource at which the certificate is defined. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.policy`"]]