Skip to main content

List related environments for application

GET 
/applications/:applicationId/related-environments

The operation allows you to retrieve a collection of all environments associated with the application. When performing operations on an application that require a specific environment (e.g. creating a deployment configuration, deploying an application), only the environments flagged as related will be available.
To update the list of related environments, you can use the UPDATE /applications/{applicationId} operation.

Request​

Path Parameters

    applicationId stringrequired

    Possible values: non-empty

Header Parameters

    X-Codenow-Api-Key anyrequired

    CodeNOW API Key

Responses​

application-related-environments-list 200 response

Schema

  • Array [

    • id stringrequired


    The user-defined identifier for the environment. It allows users to assign a custom and unique ID to the environment during the creation process.

    displayName stringrequired


    The user-friendly name or label for the environment. It allows users to provide a clear and descriptive name that helps in identifying and distinguishing different environments easily. The field accepts free text with alphanumeric and special characters.
    If the displayName is not explicitly set during creation, the system will automatically use the Environment ID as the default displayName, ensuring the environment has a recognizable and unique name.

    description stringnullable


    The detailed textual description of the environment. It allows users to add additional context, notes, or any relevant information about the purpose, usage, or characteristics of the environment.

    customerClusterId stringrequired


    The unique identifier of the cluster where the environment will be placed. To obtain this identifier, use the GET /clusters operation to retrieve a list of available clusters.

    errorCode stringnullable
    errorMessage stringnullable
    createdAt date-timerequired


    The timestamp when the environment was created. It is an automatically generated value that records the exact date and time when the environment was added to the system.

    status EnvironmentStatus (string)

    Possible values: [READY, CREATING, DOWN, DELETING, FAILED_TO_CREATE, UNKNOWN]


    Status of the environment.
    READY - Environment is ready to be used.
    CREATING - Environment is in the process of being created.
    DOWN - Environment is down / not usable.
    DELETING - Environment is in the process of being deleted.
    FAILED_TO_CREATE - Environment creation has failed.
    UNKNOWN - Environment status is unknown.

    hasDeployment boolean


    Expandable with query value expand=deployments

    Indicates whether there are any deployments associated with the environment. If set to true, there are active or completed deployments within this environment. If set to false, no deployments have taken place in this environment.

    allowTriggerDeployment booleanrequired


    A boolean flag indicating whether the environment can be targeted by Continuous Integration (CI) triggers for automated deployments. If set to true, CI triggers are allowed to deploy changes to this environment automatically. If set to false, CI triggers are disabled for this environment, and manual intervention is required for deployments.

    effectivePermissions string[]


    Effective user permissions.

  • ]

Loading...