创建新资源
此 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。 |
默认值:不适用 |
LOCATION |
资源的位置。 |
默认值:不适用 |
DNSNAME |
资源的 DNS 名称。 |
默认值:不适用 |
DEPARTMENT |
资源所属的部门。 |
默认值:不适用 |
资源描述 |
资源的描述。 |
默认值:不适用 |
DOMAINNAME |
与资源关联的域名。 |
默认值:不适用 |
RESOURCEGROUPNAME |
将添加该资源的资源组名称。 |
默认值:不适用 |
ENABLEPRIVATEKEY |
指定是否为该资源启用私钥。 |
默认值:不适用 |
RESOURCEPASSWORDPOLICY |
要分配给该资源的密码策略。 |
默认值:该 资源将使用 PAM360 中配置的默认密码策略。 |
ACCOUNTPASSWORDPOLICY |
要分配给该帐户的密码策略。 |
默认值:该账户 将使用 PAM360 中配置为默认的密码策略。 |
OWNERNAME |
资源所有者的名称。 |
默认值:不适用 |
RECORD_CONFIGURED_ |
为已配置的资源 URL 启用会话录制。启用后,对于通过 PAM360 界面启动的会话,录制将在资源 URL 启动时立即开始,包括登录窗口。 |
默认值:False |
DISABLE_TAB_DUPLICATION |
指定是否禁用该资源的重复选项卡。 |
默认值:False |
WEBSITE_SESSION_RECORDING |
指定是否启用网站会话录制。 |
默认值:False |
GATEWAY_SESSION_RECORDING |
指定是否启用网关会话录制。 |
默认值:False |
SAP_USER_TYPE |
指定要创建的 SAP 用户帐户的类型。 |
默认值:不适用 |
RESOURCECUSTOMFIELD |
资源的自定义字段。每个对象应包含CUSTOMLABEL和CUSTOMVALUE。 |
默认值:不适用 |
ACCOUNTCUSTOMFIELD |
账户的自定义字段。每个对象应包含CUSTOMLABEL和CUSTOMVALUE。 |
默认值:不适用 |
请求示例
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"
}
}