跳至主内容

创建公司

此方法用于创建客户或合作伙伴公司账户。

参数

参数

类型

可选

描述

类型

数字

公司类型。可选值:

  • 0 合作伙伴公司时,

  • 1 客户公司时。

name

字符串

公司名称。必须唯一。

parentId

字符串

母公司合作伙伴的ID。

address

字符串

公司的实际地址。

country

字符串

公司运营所在国家。取值必须符合 ISO 3166格式 。默认值: 不适用 .

state

字符串

公司运营所在国家的州/省。取值必须符合 ISO 3166格式 。默认值: 不适用 .

电话

字符串

公司的电话号码。

行业

整数

公司所属行业。可能的值:

  • 0 - 未定义

  • 1 - 航空航天

  • 101 - 航空航天制造

  • 102 - 航空航天技术研究

  • 2 - 农业

  • 201 - 农业化学品与肥料

  • 202 - 农作物与动物生产

  • 203 - 农业机械设备

  • 204 - 农业种植

  • 205 - 渔业

  • 206 - 农业_林业

  • 207 - 农业_狩猎

  • 208 - 农业_产品

  • 3 - 艺术_娱乐

  • 301 - 艺术_娱乐_文化活动

  • 302 - 艺术_娱乐_赌博

  • 4 - 汽车业

  • 401 - 汽车业_汽车卡车摩托车零部件

  • 402 - 汽车业_机械

  • 403 - 汽车业_制造商

  • 404 - 汽车业_市场营销

  • 5 - 商业协会

  • 6 - 化学制品

  • 7 - 商业服务

  • 701 - 商业服务_兽医

  • 8 - 综合企业

  • 9 - 建筑

  • 901 - 建筑_土木工程

  • 902 - 建筑_房屋建筑

  • 903 - 建筑_承包商

  • 904 - 建筑_工程

  • 905 - 建筑_材料

  • 906 - 建筑_专业化施工

  • 907 - 建筑_公用事业系统

  • 10 - 咨询

  • 11 - 容器_包装

  • 12 - 国防

  • 1201 - 国防_船舶制造_航空

  • 1202 - 国防_航天

  • 13 - 教育_研究

  • 1301 - 教育科研_科学研究与开发

  • 14 - 能源

  • 1401 - 能源设备与技术

  • 1402 - 能源基础设施

  • 1403 - 能源石油天然气及消耗性燃料

  • 1404 - 能源可再生能源

  • 15 - 工程

  • 16 - 金融服务

  • 1601 - 金融服务银行

  • 1602 - 金融服务多元化

  • 1603 - 金融服务保险

  • 1604 - 金融服务投资

  • 1605 - 金融服务房地产

  • 17 - 食品饮料

  • 18 - 政府

  • 1801 - 地方政府

  • 1802 - 国家政府

  • 1803 - 政府私营承包商

  • 1804 - 政府公共行政与国防

  • 1805 - 政府公共服务

  • 1806 - 区域政府

  • 19 - 医疗保健

  • 1901 - 医疗保健设备服务

  • 1902 - 医疗保健制药生物技术与生命科学

  • 1903 - 医疗保健研究

  • 20 - 酒店与休闲

  • 2001 - 酒店与休闲_酒店汽车旅馆邮轮

  • 2002 - 酒店与休闲_休闲娱乐

  • 2003 - 酒店与休闲_餐厅酒吧

  • 21 - 制造业

  • 2101 - 制造业_基础金属

  • 2102 - 制造业_饮料

  • 2103 - 制造业_化学品及制品

  • 2104 - 制造业_电气设备

  • 2105 - 制造业_电子产品

  • 2106 - 制造业_金属制品

  • 2107 - 制造业_食品

  • 2108 - 制造业_家具

  • 2109 - 制造业_机械设备

  • 2110 - 制造业_机动车辆

  • 2111 - 制造业_非金属矿物制品

  • 2112 - 制造业_纸制品

  • 2113 - 制造业_石油产品

  • 2114 - 制造业_药品

  • 2115 - 制造业_纺织品

  • 2116 - 制造业_烟草

  • 2117 - 制造业_运输设备

  • 2118 - 制造业_服装

  • 2119 - 制造业_木材

  • 22 - 海洋

  • 23 - 媒体

  • 2301 - 媒体_广告营销

  • 2302 - 媒体_广播

  • 2303 - 媒体_娱乐

  • 2304 - 媒体_出版

  • 24 - 采矿

  • 2401 - 采矿_煤炭和褐煤

  • 2402 - 采矿_金属矿石

  • 2403 - 采矿_石油和天然气

  • 2404 - 采矿_贵金属

  • 2405 - 采矿与采石

  • 2406 - 采矿服务

  • 25 - 非营利组织

  • 26 - 律师事务所

  • 27 - 纸制品与林产品

  • 28 - 零售

  • 2801 - 零售饮料

  • 2802 - 零售书籍与新闻

  • 2803 - 零售建筑材料

  • 2804 - 零售服装店

  • 2805 - 零售分销商

  • 2806 - 零售电子购物

  • 2807 - 零售电子产品

  • 2808 - 零售加油站

  • 2809 - 零售家居装饰

  • 2810 - 零售_奢侈品店

  • 2811 - 零售_多品类零售

  • 2812 - 零售_个人护理用品店

  • 2814 - 零售_超市

  • 2815 - 零售_日用品店

  • 2816 - 零售_车辆

  • 29 - 支持服务活动

  • 2901 - 支持服务活动_商业支持

  • 2902 - 支持服务活动_就业服务

  • 2903 - 支持服务活动_维修服务

  • 2904 - 支持服务活动_租赁服务

  • 2905 - 支持服务活动_安保与调查

  • 2906 - 支持服务活动_社会援助

  • 2907 - 支持服务活动_旅行社

  • 30 - 科技

  • 3001 - 技术_人工智能

  • 3002 - 技术_电子设备与元件

  • 3003 - 技术_硬件

  • 3004 - 技术_IT服务

  • 3005 - 技术_安全

  • 3006 - 技术_半导体与半导体设备

  • 3007 - 技术_软件

  • 31 - 电信服务

  • 3101 - 电信服务_通信基础设施

  • 3102 - 电信服务_综合电信

  • 3103 - 电信服务_无线通信

  • 32 - 交通运输

  • 3201 - 交通运输_航空运输

  • 3202 - 交通运输_深海、沿海及五大湖水域运输

  • 3203 - 交通运输_普通货运卡车运输

  • 3204 - 交通运输基础设施

  • 3205 - 交通运输内河运输

  • 3206 - 交通运输管道运输

  • 3207 - 交通运输邮政与快递

  • 3208 - 交通运输铁路运输

  • 3209 - 交通运输公路运输

  • 3210 - 交通运输观光运输

  • 3211 - 交通运输城市公交系统

  • 3212 - 交通运输水上运输

  • 33 - 公用事业

  • 3301 - 公用事业电力燃气

  • 3302 - 公用事业供水

  • 34 - 批发

  • 3401 - 批发服装

  • 3402 - 批发饮料

  • 3403 - 批发建筑材料

  • 3404 - 批发化学品

  • 3405 - 批发药品

  • 3406 - 批发电子市场

  • 3407 - 批发电子产品

  • 3408 - 批发农产品

  • 3409 - 批发食品杂货

  • 3410 - 批发家居用品

  • 3411 - 批发金属和矿物

  • 3412 - 批发非耐用品

  • 3413 - 批发石油

  • 3414 - 批发供应品

  • 3415 - 批发车辆

默认值: 0 .

可由上级管理

布尔型

用于定义新公司安全是否可由其合作伙伴公司管理的选项。可选值: 。默认值为 .

强制双因素认证

布尔型

该参数定义公司内所有 GravityZone 用户账户是否强制启用双因素认证(2FA)。该值始终为 .

双因素认证豁免期

数值型

以天为单位定义的期限,在此期间公司用户可免于在认证时提供双因素代码。可选值: 0 , 1 , 3 , 7 , 14 , 3090 .

accountEmail

字符串

待关联至新公司的新用户账户邮箱。若参数 canBeManagedByAbove 设为 false 时,则必须传递 accountEmail 参数。

accountFullName

字符串

待关联至新公司的新用户账户全名。当参数 canBeManagedByAbove 设为 false .

contactPerson

对象

包含公司指定联系人的相关信息。该对象包含以下字段:

  • fullName - 联系人的姓名。

  • email - 其商务邮箱地址。

    重要提示

    当请求中包含 contactPerson 参数时,此字段为必填项。

  • phoneNumber ,其商务电话号码。

  • companyRole ,其在公司中的职位。

accountTimezone

字符串

要关联到新公司的新用户账户的时区。默认值为 GMT(UTC) .

accountLanguage

字符串

要关联到新公司的新用户账户的用户界面语言。默认值为 en_US .

licenseSubscription

对象

包含许可证详细信息的对象:

  • type ,一个表示许可证订阅类型的整数。可能的值: 1 (试用版), 2 (正式版), 3 (月度订阅), 4 (月度许可试用), 5 (月度订阅试用) 或 6 (FRAT订阅).

  • licenseKey , 表示有效许可证密钥的字符串。该参数对于许可证订阅类型 2 (许可) 是必填项。

  • reservedSlots , 表示为目标公司预留的席位数的整数。有效值介于1与父合作伙伴公司的空闲席位数量之间。当许可证订阅类型为 35 (继承) 时需设置此参数。若未指定,所有许可证席位将从与其他公司共享的许可证池中获取。

  • endSubscription , 表示产品订阅UTC截止日期的字符串。当许可证订阅类型为 3 (月度订阅) 时可设置此参数。若要取消 endSubscription 设置,请使用空字符串:""。

  • autoRenewPeriod , 表示自动续期后许可证有效月数的整数。当许可证订阅类型为 3 (月度订阅) 时可设置此参数。默认值为12(需已设置endSubscription)。若无需自动续期,请使用 0 .

  • manageExchange 一个布尔值,用于指定公司是否可以使用Security for Exchange。默认值为 false 。此参数仅在创建许可证类型为 35 (月度继承订阅)的公司时有效。若省略,则服务将不可用。

  • minimumUsage ,一个对象,包含许可证类型及公司通过法律协议承诺每月使用的最低席位数量。此参数仅在许可证订阅类型为 3 (月度订阅)时设置。

    • endpointMonthlyUsage ,客户同意从主许可证中使用的最低端点数量。

  • assignedProductType ,一个整数,表示公司将使用的产品类型。可能的值: 0 表示终端安全, 3 表示Bitdefender EDR。默认值为0。此参数仅适用于以下许可证类型: 3 表示月度订阅, 5 表示月度订阅试用。

  • additionalProductTypes ,一个整数数组,表示产品类型。此参数允许创建的合作伙伴公司为其客户分配多种产品。数组元素的可能值: 0 表示终端安全, 3 表示Bitdefender EDR。若设置,则必须至少包含assignedProductType的值。默认值与assignedProductType相同。此参数仅适用于以下许可证类型: 3 用于月度订阅, 5 用于月度订阅试用。

  • assignedProtectionModel ,表示公司将采用保护模型类型的字符串。

    可选值:

    • aLaCarte

    • mspSecure

    • mspSecurePlus

    • mspSecureExtra

    默认值:取决于合作公司提供的保护模型。

    仅在满足以下全部条件时方可使用此参数:

    • type = 3 (月度订阅)

    • assignedProductType = 0 (终端安全)

    注意

    此参数的赋值将自动为 additionalProtectionModels 数组分配一个或多个值。

    assignedProtectionModel

    的默认值为 additionalProtectionModels

    aLaCarte

    aLaCarte

    msp安全版

    msp安全版

    msp安全增强版

    msp安全版 , msp安全增强版

    msp安全高级版

    msp安全版 , msp安全增强版 , msp安全高级版

  • 附加保护模式 ,一个表示保护模型类型的字符串数组。该参数允许被创建的合作伙伴公司为其客户分配除 分配的保护模型 对象提供的保护模型之外的其他保护模型。

    可选值:

    • 单点选购

    • msp安全版

    • msp安全增强版

    • msp安全高级版

    默认值:取决于 分配的保护模型 字段的值。

    只有在满足以下任一条件时才能使用此参数:

    • 分配的产品类型 = 3 (Bitdefender EDR), 附加产品类型 必须包含 0 (终端安全),且 类型 = 3 (月度订阅)。

    • 分配产品类型 = 0 (终端安全), 类型 = 3 (月度安全),且 分配保护模型 包含在请求中。

  • 管理完整性监控 - 布尔值,指定公司是否可使用完整性监控服务。默认值为 false 。此参数仅在创建许可证类型为 35 (月度继承订阅)的公司时有效。若省略,该服务将不可用。

  • 管理合规管理器 - 布尔值,指定公司是否可使用合规管理器服务。默认值为 false 。此参数仅在创建许可证类型为 35 (月度继承订阅)。若未指定,则服务不可用。

  • manageHyperDetect - 布尔值,指定公司是否可使用完整性监控服务。默认值为 false 。此参数仅在创建许可证类型为 35 (月度继承订阅)的公司时有效。若未指定,则服务不可用。

  • manageEASM ,布尔值,指定公司是否可使用EASM。默认值为 false 。此参数仅在创建许可证类型为 35 (月度继承订阅)的公司时有效。若未指定,则服务不可用。

  • imDataRetention - 整数,指定事件存储天数。仅当 manageIntegrityMonitoring 设置为 true 时返回此选项。可选值: 0 ( 7 天保留期)、 1 ( 90 天保留期), 2 ( 180 天保留期), 3 ( 365 天保留期)。默认值为 0 ( 7 天保留期)。许可证 类型 设置为 5 (月度订阅试用版)的公司只能将此选项设为 0 ( 7 天保留期)。

  • edrDataRetention ,一个整数,表示是否为该公司启用了EDR数据保留功能,以及数据存储时长。可能的值:

    • 0 - 未启用数据保留。

    • 1 - 数据保留启用时长为90天。

    • 2 - 数据保留期限设置为180天。

    • 3 - 数据保留期限设置为1年。

    要使用此参数, manageEventCorrelator 参数也必须包含在请求中并设置为 true 如果 assignedProtectionModel 设置为 aLaCarte .

  • ownUse ,包含公司服务和附加功能激活设置的对象。此设置仅适用于许可证类型为 35 (月度继承订阅)的公司。

    • manageXDRIdentityProviders ,提供对Azure AD和Active Directory的传感器管理集成访问权限。可选值: truefalse .

    • manageXDRProductivityApps ,提供对Office 365的传感器管理集成访问权限。可选值: truefalse .

    • manageXDRNetwork ,提供对网络传感器的传感器管理集成访问权限。可用值: truefalse .

    • manageXDRCloudWorkloads ,提供对AWS的传感器管理集成访问权限。可用值: truefalse .

      重要提示

      要为上述任一参数分配 true 值,必须将 manageEventCorrelator 参数或 manageEventCorrelator 属性(位于 ownuse 参数下)设置为 true .

      注意

      若将 true 分配给任何 manageXDRIdentityProviders , manageXDRProductivityApps , manageXDRNetworkmanageXDRCloudWorkloads 任一设置将激活XDR。要停用XDR,需将所有相关参数设置为 false .

    • manageRemoteEnginesScanning 为可选参数,用于为您的公司激活虚拟化环境安全服务。可选值: truefalse 。默认值: false .

      重要提示

      仅当 assignedProtectionModel 参数被赋值为 aLaCarte 时,此设置方可设为true。

      注意

      manageRemoteEnginesScanning 参数存在于 ownUse 对象之外,则不可使用此设置。

    • manageContainerProtection 为可选参数,用于为您的公司激活容器保护服务。可选值: truefalse .

      重要提示

      仅当 assignedProtectionModel 参数被赋值为 aLaCarte 时,此设置才能设为true。

      注意

      若存在 manageContainerProtection 参数位于 ownUse 对象之外,则不可使用此设置。

    • manageEventCorrelator ,布尔值,用于指定公司是否可使用端点检测与响应(EDR)功能。默认值为 false 。若将此参数设为 true ,将自动将 manageSandboxAnalyzermanageHyperDetect 设置项在 ownuse 参数下设为 true .

      注意

      manageEventCorrelator 参数存在于 ownUse 对象之外,则不可使用此设置。

    • manageSandboxAnalyzer ,布尔值,指定公司是否可使用沙箱分析器。默认值为 false .

      注意

      manageSandboxAnalyzer 参数存在于 ownUse 对象之外,则不可使用此设置。

    • manageHyperDetect ,布尔值,指定公司是否可使用HyperDetect。默认值为 false .

      注意

      manageHyperDetect 参数存在于 ownUse 对象之外,则不可使用此设置。

    • managePHASR ,布尔值,指定公司是否可使用PHASR。默认值为 false .

      注意

      此设置仅在 assignedProtectionModel 具有 mspSecure , mspSecurePlusmspSecureExtra 值时才能设为true。

      注意

      若存在 managePHASR 参数位于 ownUse 对象之外,则不可使用此设置。

    • manageEASM ,用于指定公司是否可使用EASM的布尔值,默认为 false .

      注意

      此设置仅在 assignedProtectionModel 具有 mspSecure , mspSecurePlusmspSecureExtra 值时才能设为true。

      注意

      manageEASM 参数存在于 ownUse 对象之外,则不可使用此设置。

    • manageComplianceManager ,布尔值,用于指定公司是否可使用合规管理器插件。默认值为 false .

      注意

      manageComplianceManager 参数存在于 ownUse 对象之外,则不可使用此设置。

  • resell ,包含公司服务和插件转售设置的对象。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有效。

    • manageXDRResell - 允许向客户销售扩展检测与响应服务。可用值: truefalse .

      注意

      若为 true ,则 manageXDRIdentityProviders , manageXDRProductivityApps , manageXDRNetworkmanageXDRCloudWorkloads 将自动设置为 true (适用于您管理的公司)。

    • manageRemoteEnginesScanningResell (可选)允许向客户销售虚拟化环境安全服务。可选值: truefalse 。默认值: false .

      重要提示

      仅当 assignedProtectionModel 分配了 aLaCarte 值时,此设置才能设为true。

      注意

      若存在 manageRemoteEnginesScanning 参数(位于 resell 对象之外),则不可使用此设置。

    • manageContainerProtectionResell (可选)允许向客户销售容器保护服务。可选值: truefalse 。默认值: false .

      重要提示

      仅当 additionalProtectionModels 参数被赋值为 aLaCarte 时,此设置才可设为true。

      注意

      若存在 manageContainerProtection 参数且不在 ownUse 对象内,则不可使用此设置。

    • manageEventCorrelatorResell ,可选,允许向客户销售端点检测与响应(EDR)服务。可选值: truefalse 。默认值: false 。将此设置设为 true 将自动同步设置 manageSandboxAnalyzerResellmanageHyperDetectResell 设置位于 resell 参数下,将其设为 true .

      注意

      若存在 manageEventCorrelator 参数位于 ownUse 对象之外,则无法使用此设置。

    • manageSandboxAnalyzerResell (可选)允许向客户销售沙箱分析器。可选值: truefalse 。默认值: false .

      注意

      若存在 manageS 参数位于 ownUse 对象之外,则无法使用此设置。

    • manageHyperDetectResell (可选)允许向客户销售HyperDetect。默认值为 false .

      注意

      manageHyperDetect 参数出现在 ownUse 对象外部,则不可使用此设置。

    • managePHASRResell ,允许向客户销售PHASR。默认值为 false .

      注意

      managePHASR 参数出现在 resell 对象外部,则不可使用此设置。

    • manageEASMResell ,允许向客户销售EASM。默认值为 false .

      注意

      manageEASM 参数出现在 resell 对象外部,则不可使用此设置。

    • manageComplianceManagerResell ,可选,允许向客户销售Compliance Manager附加组件。可选值: truefalse 。默认值: false .

      注意

      若存在 manageComplianceManager 参数且位于 resell 对象外部时,不可使用此设置。

  • manageEncryption ,布尔值,指定公司是否可使用全盘加密。默认值为 false 。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有效。若省略,该服务将不可用。

  • manageRemoteEnginesScanning ,布尔值,指定公司是否可使用虚拟化环境安全功能。默认值为 false 。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有效。若省略,该服务将不可用。

    重要

    仅当 assignedProtectionModel 被赋值为 aLaCarte 时,此设置方可设为true。

    注意

    若存在 manageRemoteEnginesScanningmanageRemoteEnginesScanningResell 设置中的任意一项位于 自用转售 对象存在。

  • 管理HyperDetect ,一个布尔值,指定公司是否可以使用HyperDetect。默认值为 false 。此参数仅在创建具有类型3或5许可证(月度继承订阅)的公司时有意义。如果省略,该服务将不可用。

    注意

    如果存在任何 manageHyperDetectmanageHyperDetectResell 设置,位于 自用转售 对象参数下,则不能使用此参数。

  • 管理沙箱分析器 ,一个布尔值,指定公司是否可以使用沙箱分析器。默认值为 false 。此参数仅在创建具有类型3或5许可证(月度继承订阅)的公司时有意义。如果省略,该服务将不可用。

    注意

    如果存在任何 manageSandboxAnalyzermanageSandboxAnalyzerReell 设置,位于 自用转售 对象参数存在。

  • 管理补丁管理 ,一个布尔值,用于指定公司是否可以使用补丁管理服务。默认值为 false 。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有意义。若省略,该服务将不可用。

  • 管理事件关联器 ,一个布尔值,用于指定公司是否可以使用端点检测与响应(EDR)服务。默认值为 false 。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有意义。EDR要求启用沙箱分析器和HyperDetect功能。因此,将此参数设为true将自动将以下两个参数设为true:manageSandboxAnalyzer和manageHyperDetect。若省略该参数,服务将不可用。

    注意

    如果存在以下任一参数,则不能使用此参数: manageEventCorrelatormanageEventCorrelatorResell 设置位于 自用转售 对象参数中。

  • 管理邮件安全 ,一个布尔值,用于指定公司是否可以使用邮件安全服务。默认值为 false 。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有意义。若省略,该服务将不可用。

  • 管理移动安全 ,一个布尔值,用于指定公司是否可以使用移动安全服务。默认值为 false 。此参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有意义。若省略,该服务将不可用。

  • 管理容器保护 ,一个布尔值,用于指定公司是否可以使用容器保护服务。默认值为 false 该参数仅在创建许可证类型为3或5(按月继承订阅)的公司时有效。若省略,则服务不可用。且当 trueassignedProtectionModel 设置为 mspSecure , mspSecurePlusmspSecureExtra .

    重要提示

    仅当 assignedProtectionModel 被赋予 aLaCarte 值时,此设置才可设为true。

    注意

    manageContainerProtectionmanageContainerProtectionResell 配置存在于 ownUseresell 对象参数下时,此参数不可使用。

  • licensedServices ,包含公司服务设置的对象。该参数仅在创建许可证类型为 3 。若省略此参数,则相关服务将不可用。

    • mdrServiceOwnUse ,一个整数,表示公司自用的MDR服务类型。可选值: 0 表示禁用, 1 表示基础版。启用此选项将同时启用EDR。若省略此参数,则相关服务将不可用。

      该参数仅在 true 时才能设置为 type 参数设置为 1 (公司类型设置为客户)时生效。

    • mdrServiceResell ,一个布尔值,指定公司是否被允许向其创建的公司转售MDR服务。若省略此参数,则转售功能将不可用。此参数仅对合作伙伴公司有效。

若未指定,公司将以许可证订阅类型 1 (试用版)创建。

mdrContactInformation

对象

注意

创建合作伙伴公司或其他类型许可证的公司时为必填项。

包含公司指定紧急联系信息的对象,供MDR团队在安全事件或事故时使用。

注意

此信息必须有效,且对以下公司类型为必填项:

  • 任何希望启用MDR服务的年度许可证公司。

包含以下详细信息:

  • phoneNumber ,一个包含公司联系信息的对象,用于通过电话联系该组织。其包含以下信息:

    • countryPrefix ,一个整数,表示公司所在国家的电话区号前缀。

      注意

      对于没有唯一前缀的国家,需同时包含 countryCode 参数。

      以下前缀为多国共用: +1 , +599 , +39 , +7 , +39 .

    • countryCode ,一个字符串,表示公司所在国家的ISO 3166-1 alpha-2代码。

      注意

      该参数仅在公司所在地区与其他国家共用电话区号时用于标识国家。

    • subscriberNumber ,一个字符串,表示公司电话号码的本地部分(不含国家前缀或国内拨号代码)。

  • fullName ,一个字符串,包含公司指定紧急联系人的全名。

  • email ,一个字符串,包含公司指定紧急联系人的电子邮件地址。

    注意

    若指定邮箱地址尚未通过验证, emailVerificationCode 则请求中必须同时包含该验证码。

  • emailVerificationCode ,用于验证指定邮箱所有权的字符串或数字代码。

    注意

    可通过调用 generateEmailVerificationCode 方法获取此代码。

  • useDataFromAccount ——表示 GravityZone 用户账户ID的字符串,将从此账户导入所有相关联系信息(包括全名、邮箱及电话号码)。

    注意

    指定此参数时,将覆盖 phoneNumber , fullNameemail 参数。这些参数与 useDataFromAccount .

    若指定用户账户尚未通过验证, emailVerificationCode 则请求中必须同时包含该验证码。

  • useDataFromCompany ——表示 GravityZone 企业账户ID的字符串,将从此账户导入所有相关联系信息(包括全名、邮箱及电话号码)。

    注意

    当指定此参数时,它将替换 phoneNumber , fullName 和email。这些参数,以及 emailVerificationCode ,与 useDataFromCompany .

customFields

对象

包含公司自定义字段值的对象。

返回值

此方法返回一个字符串:新创建公司的ID。

示例

请求 :

一个使用月度订阅许可证的合作伙伴公司,具有端点安全产品类型和按需保护模型:

{
    "params": {
        "type": 0,
        "name": "Partner LTD",
        "parentId": "64babaafab366c53d20c83ca",
        "address": "Str Example No 1",
        "country": "US",
        "state": "US-CA",
        "phone": "0040740000000",
        "industry": 2,
        "canBeManagedByAbove": true,
        "enforce2FA": true,
        "skip2FAPeriod": 3,
        "accountEmail": "partner@example.com",
        "accountFullName": "Partner account",
        "contactPerson": {
            "fullName": "Stephen Johnson",
            "email": "stephen.johnson@example.email.com",
            "phoneNumber": "0040740000001",
            "companyRole": "Owner / President"
        },
        "licenseSubscription": {
            "type": 3,
            "reservedSlots": 120,
            "endSubscription": "2028-04-14",
            "autoRenewPeriod": 12,
            "manageExchange": false,
            "manageEncryption": false,
            "managePatchManagement": false,
            "manageIntegrityMonitoring": true,
            "imDataRetention": 2,
            "manageEmailSecurity": true,
            "manageMobileSecurity": true,
            "edrDataRetention": 2,
            "ownUse": {
                "manageXDRIdentityProviders": true,
                "manageXDRProductivityApps": true,
                "manageXDRNetwork": true,
                "manageXDRCloudWorkloads": true,
                "manageRemoteEnginesScanning": true,
                "manageContainerProtection": true,
                "manageHyperDetect": true,
                "manageSandboxAnalyzer": true,
                "manageEventCorrelator": true,
                "manageComplianceManager": true
            },
            "resell": {
                "manageXDRResell": true,
                "manageRemoteEnginesScanningResell": true,
                "manageContainerProtectionResell": true,
                "manageHyperDetectResell": true,
                "manageSandboxAnalyzerResell": true,
                "manageEventCorrelatorResell": true,
                "manageComplianceManagerResell": true
            },
            "minimumUsage": {
                "endpointMonthlyUsage": 120
            },
            "assignedProductType": 0,
            "additionalProductTypes": [
                0
            ],
            "assignedProtectionModel": "aLaCarte",
            "additionalProtectionModels": [
                "aLaCarte",
                "mspSecure",
                "mspSecurePlus",
                "mspSecureExtra"
            ],
            "licensedServices": {
                "mdrServiceOwnUse": 1
            }
        },
        "mdrContactInformation": {
            "phoneNumber": {
                "countryPrefix": "+4",     
                "subscriberNumber": "112345"
            },
            "fullName": "Contact",
            "email": "mdrcontact@nebula.local",
            "emailVerificationCode": "43728676"
        },
        "customFields": {
            "referenceID": "004562",
            "vertical": "healthcare",
            "partner_type": "platinum",
            "security_level": "high",
            "payment_status": "goodstanding"
        }
    },
    "jsonrpc": "2.0",
    "method": "createCompany",
    "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588"
}

一个使用月度订阅许可证的合作伙伴公司,具有端点安全产品类型和安全保护模型:

{
    "params": {
        "type": 0,
        "name": "合作伙伴有限公司",
        "parentId": "64babaafab366c53d20c83ca",
        "address": "示例街道1号",
        "country": "美国",
        "state": "美国-加利福尼亚州",
        "phone": "0040740000000",
        "industry": 2,
        "canBeManagedByAbove": true,
        "enforce2FA": true,
        "skip2FAPeriod": 3,
        "accountEmail": "partner@example.com",
        "accountFullName": "合作伙伴账户",
        "contactPerson": {
            "fullName": "斯蒂芬·约翰逊",
            "email": "stephen.johnson@example.email.com",
            "phoneNumber": "0040740000001",
            "companyRole": "所有者/总裁"
        },
        "licenseSubscription": {
            "type": 3,
            "reservedSlots": 120,
            "endSubscription": "2028-04-14",
            "autoRenewPeriod": 12,
            "manageExchange": false,
            "manageEncryption": false,
            "managePatchManagement": false,
            "manageIntegrityMonitoring": true,
            "imDataRetention": 2,
            "manageEmailSecurity": true,
            "manageMobileSecurity": true,
            "edrDataRetention": 2,
            "ownUse": {
                "manageXDRIdentityProviders": true,
                "manageXDRProductivityApps": true,
                "manageXDRNetwork": true,
                "manageXDRCloudWorkloads": true,
                "manageHyperDetect": true,
                "manageSandboxAnalyzer": true,
                "manageEventCorrelator": true,
                "managePHASR": false,
                "manageEASM": false,
                "manageComplianceManager": true
            },
            "resell": {
                "manageXDRResell": true,
                "manageHyperDetectResell": true,
                "manageSandboxAnalyzerResell": true,
                "manageEventCorrelatorResell": true,
                "managePHASRResell": true,
                "manageEASMResell": true,
                "manageComplianceManagerResell": true
            },
            "minimumUsage": {
                "endpointMonthlyUsage": 120
            },
            "assignedProductType": 0,
            "additionalProductTypes": [
                0
            ],
            "assignedProtectionModel": "mspSecure",
            "additionalProtectionModels": [
                "mspSecure",
            ],
            "licensedServices": {
                "mdrServiceOwnUse": 1
            }
        },
        "mdrContactInformation": {
            "phoneNumber": {
                "countryPrefix": "+4",     
                "subscriberNumber": "112345"
            },
            "fullName": "联系人",
            "email": "mdrcontact@nebula.local",
            "emailVerificationCode": "43728676"
        },
        "customFields": {
            "referenceID": "004562",
            "vertical": "医疗保健",
            "partner_type": "白金级",
            "security_level": "高",
            "payment_status": "信用良好"
        }
    },
    "jsonrpc": "2.0",
    "method": "createCompany",
    "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588"
}

一家使用年度许可的客户公司,具有:

{
    "params": {
        "type": 0,
        "name": "客户有限公司",
        "address": "示例街1号",
        "country": "美国",
        "state": "美国-加利福尼亚州",
        "phone": "0040740000000",
        "industry": 2,
        "enforce2FA": true,
        "skip2FAPeriod": 3,
        "accountEmail": "customer@example.com",
        "accountFullName": "客户账户",
        "contactPerson": {
            "fullName": "斯蒂芬·约翰逊",
            "email": "stephen.johnson@example.email.com",
            "phoneNumber": "0040740000001",
            "companyRole": "所有者/总裁"
        },
        "licenseSubscription": {
            "type": 2,
            "licenseKey": "1b2b3c",
            "reservedSlots": 120,
            "endSubscription": "2028-04-14",
            "autoRenewPeriod": 12
        },
        "mdrContactInformation": {
            "phoneNumber": {
                "countryPrefix": "+4",     
                "subscriberNumber": "112345"
            },
            "fullName": "联系人",
            "email": "mdrcontact@nebula.local",
            "emailVerificationCode": "43728676"
        },
        "customFields": {
            "referenceID": "004562",
            "vertical": "医疗保健",
            "partner_type": "白金",
            "security_level": "高",
            "payment_status": "良好"
        }
    },
    "jsonrpc": "2.0",
    "method": "createCompany",
    "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588"
}

响应 :

{
    "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588",
    "jsonrpc": "2.0",
    "result": "5493dcd2b1a43df00b7b23c6"
}