创建新资源

POST

此 API 用于在 PAM360 中创建新资源。响应将确认资源已成功创建,并提供其唯一的资源 ID。

请求 URL

https://<PAM360 服务器的主机名或 IP 地址>:<端口>/restapi/json/v1/resources

请求头参数

{
    "AUTHTOKEN":"<<由PAM360生成的认证令牌>>",
    "orgName"  :"<<组织显示名称>>"
}

参数 描述

AUTHTOKEN

用户用于授权 API 请求的身份验证令牌。
类型:字符串
必填:是

默认值:不适用

orgName

PAM360 中可用的组织名称。
类型:字符串
必填:否

默认值: 用户所属的组织

正文参数

INPUT_DATA={
    "operation": {
        "Details": {
            "RESOURCENAME":"Windows Server",
            "ACCOUNTNAME":"Administrator",
            "RESOURCETYPE":"Windows",
			"PASSWORD":"Test123#@!",
            "NOTES":"测试 API",
            "RESOURCEURL":"http://windowsserver/adminconsole",
            "LOCATION":"印度",
            "DNSNAME":"localhost",
			"部门":"IT",
            "资源描述":"资源",
            "域名":"localhost",
            "资源组名称":"group",
            "启用私有密钥":true,
			"RESOURCEPASSWORDPOLICY":"Strong",
            "ACCOUNTPASSWORDPOLICY":"Strong",
            "OWNERNAME":"admin",
            "RECORD_CONFIGURED_RESOURCE_URL":"https://localhost",
			"DISABLE_TAB_DUPLICATION":true,
            "WEBSITE_SESSION_RECORDING":true,
            "GATEWAY_SESSION_RECORDING":true,
			"SAP_USER_TYPE":"A",
            "RESOURCECUSTOMFIELD": [
                {
                    "CUSTOMLABEL":"安全资源",
                    "CUSTOMVALUE":"YES"
                }
            ],
			"ACCOUNTCUSTOMFIELD": [
                {
                    "CUSTOMLABEL":"安全账户",
                    "CUSTOMVALUE":"YES"
                }
            ]
        }
    }
}

参数 描述

RESOURCENAME

要添加的资源的名称。
类型:字符串
必填:是

默认值:不适用

ACCOUNTNAME

与该资源关联的账户名称。
类型:字符串
必填:否

默认值:不适用

RESOURCETYPE

正在创建的资源的类型。
类型:字符串
必填:否

默认值: 在 PAM360 中配置的默认资源类型。

PASSWORD

关联账户的密码。
类型:字符串
必填:否

默认值: 系统会根据配置的密码策略自动生成密码

备注

帐户的其他详细信息。
类型:字符串
必填:否

默认值:不适用

RESOURCEURL

与资源关联的 URL。
类型:URL
必填:否

默认值:不适用

LOCATION

资源的位置。
类型:字符串
必填:否

默认值:不适用

DNSNAME

资源的 DNS 名称。
类型:字符串
必填:否

默认值:不适用

DEPARTMENT

资源所属的部门。
类型:字符串
必填:否

默认值:不适用

资源描述

资源的描述。
类型:字符串
必填:否

默认值:不适用

DOMAINNAME

与资源关联的域名。
类型:字符串
必填:否

默认值:不适用

RESOURCEGROUPNAME

将添加该资源的资源组名称。
类型:字符串
必填:否

默认值:不适用

ENABLEPRIVATEKEY

指定是否为该资源启用私钥。
类型:布尔
必填:否

默认值:不适用

RESOURCEPASSWORDPOLICY

要分配给该资源的密码策略。
类型:字符串
必填:否

默认值:该 资源将使用 PAM360 中配置的默认密码策略。
允许的值: PAM360中可用的密码策略。

ACCOUNTPASSWORDPOLICY

要分配给该帐户的密码策略。
类型:字符串
必填:否

默认值:该账户 将使用 PAM360 中配置为默认的密码策略。
允许的值: PAM360中可用的密码策略。

OWNERNAME

资源所有者的名称。
类型:字符串
必填:否

默认值:不适用

RECORD_CONFIGURED_
资源URL

为已配置的资源 URL 启用会话录制。启用后,对于通过 PAM360 界面启动的会话,录制将在资源 URL 启动时立即开始,包括登录窗口。
类型:布尔型
必填:否
支持的版本:7500

默认值:False

DISABLE_TAB_DUPLICATION

指定是否禁用该资源的重复选项卡。
类型:布尔型
必填:否
支持的版本:7500

默认值:False

WEBSITE_SESSION_RECORDING

指定是否启用网站会话录制。
类型:布尔值
必填:否
支持的版本:7500

默认值:False

GATEWAY_SESSION_RECORDING

指定是否启用网关会话录制。
类型:布尔值
必填:否
支持的版本:7500

默认值:False

SAP_USER_TYPE

指定要创建的 SAP 用户帐户的类型。
类型:字符串
必填:否
支持的版本:8500

默认值:不适用
允许的值:A (对话用户)、B(系统用户)、C(通信用户)、S(服务用户)、L(参考用户)

RESOURCECUSTOMFIELD

资源的自定义字段。每个对象应包含CUSTOMLABELCUSTOMVALUE
类型:JSON
必填:否

默认值:不适用

ACCOUNTCUSTOMFIELD

账户的自定义字段。每个对象应包含CUSTOMLABELCUSTOMVALUE
类型:JSON
必填:否

默认值:不适用

请求示例

cURL Python PowerShell
curl -X POST -H "AUTHTOKEN:<<由PAM360生成的认证令牌>>" -H "Content-Type: text/json" "https://<PAM360服务器的主机名或IP地址>:<端口>/restapi/json/v1/resources" --data-urlencode "INPUT_DATA={\"operation\":{\"Details\":{\"RESOURCENAME\":\"Windows Server1\",\"ACCOUNTNAME\":\"Administrator\",\"RESOURCETYPE\":\"Windows\",\"PASSWORD\":\"Test@123\",\"RESOURCEPASSWORDPOLICY\":\"Strong\",\"ACCOUNTPASSWORDPOLICY\":\"Strong\",\"RESOURCECUSTOMFIELD\":[{\"CUSTOMLABEL\":\"安全资源\",\"CUSTOMVALUE\":\"YES\"}],\"ACCOUNTCUSTOMFIELD\":[{\"CUSTOMLABEL\":\"安全账户\",\"CUSTOMVALUE\":\"YES\"}]}}}"
#!/usr/bin/env python3

import requests
import urllib3
import json

urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)

def main():
    config = {
        "auth_token":"<<由PAM360生成的认证令牌>>",
        "host_name": "https://<PAM360服务器的主机名或IP地址>:<端口号>"
    }

    session = requests.Session()
    session.verify = True

	try:
        test_url = f"{config['host_name']}/restapi/json/v1/resources"
        headers = {
            "AUTHTOKEN": config["auth_token"],
            "Content-Type":"text/json"
        }

		# INPUT_DATA 有效载荷
        payload = {
            "INPUT_DATA": json.dumps({
                "operation": {
                    "Details": {
                        "RESOURCENAME":"Windows Server1",
						"ACCOUNTNAME":"Administrator",
                        "RESOURCETYPE":"Windows",
                        "PASSWORD":"Test@123",
                        "RESOURCEPASSWORDPOLICY":"Strong",
						"ACCOUNTPASSWORDPOLICY":"Strong",
                        "RESOURCECUSTOMFIELD": [
                            {"CUSTOMLABEL":"Secure Resource","CUSTOMVALUE":"YES"}
                        ],
						"ACCOUNTCUSTOMFIELD": [
                            {"CUSTOMLABEL":"安全账户","CUSTOMVALUE":"YES"}
                        ]
                    }
                }
            })
        }

		response = session.post(test_url, headers=headers, data=payload, timeout=10)

        print(response.text)

    except Exception as e:
        print(f"错误: {e}")

    session.close()

if __name__ == "__main__":
    main()
# API 配置
$authToken="<<由 PAM360 生成的认证令牌>>"
$url= "https://<PAM360服务器的主机名或IP地址>:<端口>/restapi/json/v1/resources" # 请求头 $headers = @{"AUTHTOKEN"=$authToken; "Content-Type"="application/x-www-form-urlencoded" } # INPUT_DATA 有效载荷(固定、紧凑) $inputData = @{ operation = @{ Details = @{ "RESOURCENAME"="Windows Server1"; "ACCOUNTNAME"="Administrator"; "RESOURCETYPE"="Windows"; "PASSWORD"="Test@123"; "RESOURCEPASSWORDPOLICY"="Strong"; "ACCOUNTPASSWORDPOLICY"="Strong"; "RESOURCECUSTOMFIELD"=@(@{"CUSTOMLABEL"="Secure Resource";"CUSTOMVALUE"="YES"}); "ACCOUNTCUSTOMFIELD"=@(@{"CUSTOMLABEL"="安全账户";"CUSTOMVALUE"="YES"}) } } } | ConvertTo-Json -Depth 10 -Compress # 表单编码的请求主体 $body = "INPUT_DATA=$inputData" # 发送 POST 请求 $response = Invoke-RestMethod -Uri $url -Method Post -Headers $headers -Body $body # 显示响应 $response | ConvertTo-Json -Depth 5

响应示例

{
  "operation": {
    "result": {
      "message":"资源 pmp-centos6-ptuser1 已成功添加",
      "status":"Success"
    },
    "Details": {
      "RESOURCEID":"304"
    },
   "name":"CREATE RESOURCE"
  }
}



Top