Jump to

• Request
• Response

Upload And Redeploy This Application

post

/management/weblogic/{version}/edit/internalAppDeployments/{name}/redeploy

Upload and redeploy this application.

This method supports both asynchronous and best effort synchronous invocations. The behavior is controlled by the 'Prefer' header.

Request

Supported Media Types

• multipart/form-data

Path Parameters

• name(required): string
  The name property of the instance in the collection.
• version(required): string
  The version of the WebLogic REST interface.

Header Parameters

• Prefer: string
  The 'Prefer' header parameter can be used to specify the preference on how this method runs. A value of 'respond-async' specifies a preference to submit the request and return immediately without waiting for completion. Alternatively a value of 'wait=#seconds' specifies a preference to wait for #seconds for method completion before returning. If the Prefer header is not specified or invalid, then a 300 second wait will be used.
• 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'.

Form Parameters

• model(required): string

  Contains the rest of the deployment information.

  This string parameter must contain a JSON object matching the following schema:

  {
      "type": "object",
      "properties": {
          "archiveVersion": {
              "type": "string",
              "description": "The archive version (optional)."
          },
          "bundle": {
              "type": "object",
              "title": "Application Bundle",
              "properties": {
                  "altDescriptorPath": {
                      "x-weblogic-legalNull": true,
                      "type": "string",
                      "description": "Optional relative path to the selected alternate standard application descriptor. Omit or use JSON null for none.
  Constraints
  legal null"
                  },
                  "altWlsDescriptorPath": {
                      "x-weblogic-legalNull": true,
                      "type": "string",
                      "description": "Optional relative path to an alternate weblogic-application.xml for an EAR application (archived or exploded). This selector is not supported for standalone modules, including WAR applications; use a deployment plan for their external WebLogic descriptors. Omit or use JSON null for none.
  Constraints
  legal null"
                  },
                  "applicationPath": {
                      "type": "string",
                      "description": "Required relative path selecting exactly one application. Arbitrary version-directory depth is allowed. Preserve the original application basename, for example v2/app/orders.war. Directory names do not specify deployment versions.For exploded bundles, a single dot selects the ZIP root; that root must contain recognizable application descriptors. Otherwise select a named application directory, including its original suffix where applicable."
                  },
                  "layout": {
                      "type": "string",
                      "description": "Required: exploded or installation. exploded selects an application directory; installation selects an archive or directory from an installation tree."
                  },
                  "planPath": {
                      "x-weblogic-legalNull": true,
                      "type": "string",
                      "description": "Required: the relative path to the selected deployment plan file, or JSON null to explicitly deploy without a plan. No plan or version is selected automatically. Multiple plans may coexist in the bundle.Keep external descriptors and AppFileOverrides with the selected plan. The supplied plan and its config-root are not rewritten.
  Constraints
  legal null"
                  }
              },
              "required": [
                  "applicationPath",
                  "layout",
                  "planPath"
              ],
              "description": "Explicit selectors for a sourceBundle upload. Required with sourceBundle; not used with sourcePath."
          },
          "legacyEmptyBeansXmlDiscovery": {
              "type": "boolean",
              "description": "Controls discovery for qualifying empty beans.xml descriptors.true enables legacy discovery of all beans; false uses Jakarta CDI annotated discovery. If omitted, the application's existing explicit, unset, or inherited setting is preserved."
          },
          "planVersion": {
              "type": "string",
              "description": "The deployment plan's version (optional)."
          },
          "stageMode": {
              "type": "string",
              "description": "Optional for sourceBundle only: stage, nostage, or external_stage. If omitted, preserve the application's current staging mode. With external_stage, the caller must prepare the application and plan resources in each target server's staging directory."
          },
          "validatePersistenceXmlSchema": {
              "type": "boolean",
              "description": "Controls XML Schema validation for META-INF/persistence.xmltrue validates the descriptor; false skips only XSD validation. If omitted, the application's existing explicit, unset, or inherited setting is preserved."
          }
      }
  }

• planPath: file

  The deployment plan to upload (optional).

• sourceBundle: file

  A ZIP transport bundle containing an exploded application or an Application Installation Directory. Requires model.bundle and cannot be combined with sourcePath or a separate planPath part.

  The server extracts only the outer ZIP into a new request-owned directory under the configured upload directory, using normal filesystem permissions and inherited access controls as with weblogic.Deployer uploads. It preserves selected application basenames, directories, embedded archives, and supplied plan bytes. Paths in model.bundle are relative to the ZIP root, not to the client or server filesystem. Use forward slashes on every platform; absolute paths, backslashes, and parent-directory segments are not accepted.

  Invalid bundle requests are rejected with HTTP 400; resource-limit violations use HTTP 413. Symbolic links, encrypted entries, unsafe paths, duplicate entries, and conflicting file/directory entries are not supported.

• sourcePath: file

  The application archive to upload. Specify exactly one of sourcePath and sourceBundle. sourcePath retains archive-upload behavior; its contents are not extracted as a directory bundle.

Security

• Admin: basic
  Type: basic

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

  Description: A user in the Deployer security role.

Back to Top

Response

200 Response

Returns the following fields:

Back to Top