Jump to

• Request
• Response

Refresh Server Certificate

post

/management/weblogic/{version}/serverRuntime/certificateManagementRuntime/refreshServerCertificate

Refresh the server certificate for alias alias. When invoked on a Managed Server, the authenticated WebLogic caller's identity is delegated to the Admin Server certificate service. This is an authenticated manual runtime operation. When isActiveOnly is false, it permits any valid alias whether that alias is bound to this server, bound only to another server, or not yet bound to any server. Automatic certificate refresh does not use this broader selection and remains restricted to active aliases.

Request

Supported Media Types

• application/json

Path Parameters

• version(required): string
  The version of the WebLogic REST interface.

Header Parameters

• X-Requested-By(required): string
  The 'X-Requested-By' header is used to protect against Cross-Site Request Forgery (CSRF) attacks. The value is an arbitrary name such as 'MyClient'.

Body ()

Must contain the following fields:

Root Schema : Arguments

Type: object

Title: Arguments

Show Source

• alias: string

  The alias of the certificate to refresh. Aliases are case-insensitive.

• isActiveOnly: boolean

  If true, the certificate will only be refreshed if the alias is in use by an enabled channel or service, or is a built-in Domain PKI alias. If false, any valid alias may be refreshed, including an alias configured for this server, configured only for another server, or not yet configured for any server. This permits certificate pre-provisioning before a channel or service is enabled; automatic refresh remains active-only.

• isForceUpdate: boolean

  If true, force the certificate to be updated even if it is already present and valid. Normally, certificates are only updated if they are missing or invalid (expired).

{
    "type":"object",
    "title":"Arguments",
    "properties":{
        "alias":{
            "type":"string",
            "description":"<p>The alias of the certificate to refresh. Aliases are case-insensitive.</p>"
        },
        "isActiveOnly":{
            "type":"boolean",
            "description":"<p>If true, the certificate will only be refreshed if the alias is in use by an enabled channel or service, or is a built-in Domain PKI alias. If false, any valid alias may be refreshed, including an alias configured for this server, configured only for another server, or not yet configured for any server. This permits certificate pre-provisioning before a channel or service is enabled; automatic refresh remains active-only.</p>"
        },
        "isForceUpdate":{
            "type":"boolean",
            "description":"<p>If true, force the certificate to be updated even if it is already present and valid. Normally, certificates are only updated if they are missing or invalid (expired).</p>"
        }
    },
    "description":""
}

Security

• Admin: basic
  Type: basic

  Description: A user in the Admin security role.
• Operator: basic
  Type: basic

  Description: A user in the Operator security role.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Returns the following fields:

Body ()

Root Schema : Return

Type: object

Title: Return

Show Source

• return: boolean

  Returns the action's result.

{
    "type":"object",
    "title":"Return",
    "properties":{
        "return":{
            "type":"boolean",
            "description":"<p>Returns the action's result.</p>"
        }
    },
    "description":""
}

Back to Top