编辑资源

PUT

此 API 允许您编辑 PAM360 中现有资源的详细信息。通过提供资源的 RESOURCEID，您可以更新其属性，例如名称、类型、所有者、描述、位置以及任何相关的自定义字段。

请求 URL

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

参数	描述	取值
资源ID	资源的ID。类型：Long 必填：是	默认值：不适用

请求体参数

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

参数	描述	值
AUTHTOKEN	用户用于授权 API 请求的身份验证令牌。类型：字符串必填：是	默认值：不适用
orgName	PAM360 中可用的组织名称。类型：字符串必填：否	默认值：用户所属的组织。

正文参数

INPUT_DATA={
"operation": {
    "Details": {
    "RESOURCENAME":"Windows Server",
    "LOCATION":"india",
    "DNSNAME":"localhost",
    "DEPARTMENT":"IT",
    "OWNERNAME":"admin",
	"RESOURCEURL":"http://windowsserver/adminconsole",
    "RESOURCEDESCRIPTION":"资源 asda",
    "RESOURCETYPE":"Windows",
    "RESOURCETYPEID":101,
	"RESOURCEPASSWORDPOLICY":"强密码",
    "RESOURCEPASSWORDPOLICYID":"101",
    "RECORD_CONFIGURED_RESOURCE_URL":true,
    "DISABLE_TAB_DUPLICATION":true,
    "WEBSITE_SESSION_RECORDING":true,
	"GATEWAY_SESSION_RECORDING":true,
    "RESOURCECUSTOMFIELD": [
        {
        "CUSTOMLABEL":"安全资源",
        "CUSTOMVALUE":"YES"
        }
    ]
    }
}
}

参数	描述	值
RESOURCENAME	待编辑资源的名称。类型：字符串必填：否	默认值：不适用
LOCATION	资源的位置。类型：字符串必填：否	默认值：不适用
DNSNAME	资源的 DNS 名称。类型：字符串必填：否	默认值：不适用
DEPARTMENT	资源所属的部门。类型：字符串必填：否	默认值：不适用
OWNERNAME	资源的所有者。类型：字符串必填：否	默认值：不适用
RESOURCEURL	与资源关联的 URL。类型：URL 必填：否	默认值：不适用
RESOURCEDESCRIPTION	资源的描述。类型：字符串必填：否	默认值：不适用
RESOURCETYPE	资源类型。类型：字符串必填：否	默认值：不适用
RESOURCEPASSWORDPOLICY	分配给该资源的密码策略。类型：字符串必填：否	默认值：不适用允许的值： PAM360 中可用的密码策略。
RECORD_CONFIGURED_ RECORD_CONFIGURED_RESOURCE_URL	为已配置的资源 URL 启用会话录制。启用后，对于通过 PAM360 界面启动的会话，资源 URL 一启动（包括登录窗口）即开始录制。类型：布尔值必填：否支持的版本：7500	默认值：不适用
DISABLE_TAB_DUPLICATION	指定是否禁用资源的重复选项卡。类型：布尔值必填：否支持的版本：7500	默认值：不适用
WEBSITE_SESSION_RECORDING	指定是否启用网站会话录制。类型：布尔值必填：否支持的版本：7500	默认值：不适用
GATEWAY_SESSION_RECORDING	指定是否启用网关会话录制。类型：布尔值必填：否支持的版本：7500	默认值：不适用
RESOURCECUSTOMFIELD	资源的自定义字段。每个对象应包含CUSTOMLABEL和CUSTOMVALUE。类型：JSON 必填：否	默认值：不适用

请求示例

cURL Python PowerShell

curl -X PUT -k "https://<PAM360服务器的主机名或IP地址>:<端口>/restapi/json/v1/resources/603" -H "Content-Type: application/x-www-form-urlencoded" -H "AUTHTOKEN:<由PAM360生成的认证令牌>" --data-urlencode "INPUT_DATA={\"operation\":{\"Details\":{\"RESOURCENAME\":\"Windows Server Operation\",\"DNSNAME\":\"127.0.0.1\",\"DEPARTMENT\":\"IT Services\",\"RESOURCEURL\":\"http://windowsserver\",\"RESOURCETYPE\":\"Windows Domain\",\"RESOURCEPASSWORDPOLICY\":\"Medium\",\"WEBSITE_SESSION_RECORDING\":false}}}"

#!/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/603"
        headers = {
            "AUTHTOKEN": config['auth_token'],
            "Content-Type": "application/x-www-form-urlencoded"
        }

		payload = {
            "INPUT_DATA": json.dumps({
                "operation": {
                    "Details": {
                        "RESOURCENAME":"Windows Serveraa",
                        "DNSNAME":"127.0.0.1",
						"DEPARTMENT":"IT Services",
                        "RESOURCEURL":"http://windowsserver",
                        "RESOURCETYPE":"Windows Domain"
                    }
                }
            })
        }

		response = session.put(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 端点
$Url= "https://<PAM360 服务器的主机名或 IP 地址>:<端口>/restapi/json/v1/resources/603"

# 请求头
$headers = @{
    "Content-Type" = "application/x-www-form-urlencoded"
    "AUTHTOKEN"="<<由PAM360生成的认证令牌>>"
}

# 请求正文 (INPUT_DATA)
$body = @{
    "INPUT_DATA" = @'
{
    "operation": {
        "Details": {
            "RESOURCENAME": "Windows Server Operation",
            "DNSNAME": "127.0.0.1",
            "DEPARTMENT": "IT Services",
			"RESOURCEURL": "http://windowsserver",
            "RESOURCETYPE": "Windows Domain",
            "RESOURCEPASSWORDPOLICY": "Medium",
            "WEBSITE_SESSION_RECORDING":false
        }
    }
}
'@
}

# 发送 PUT 请求
$response = Invoke-WebRequest `
    -Uri $Url `
    -Method Put `
    -Headers $headers `
    -Body $body `
     

# 仅打印 API 响应正文
$response.Content

响应示例

{
  "operation": {
    "result": {
      "message":"Windows Server 资源操作已成功修改。",
      "status":"Success"
    },
    "name":"EDIT RESOURCE"
  }
}