Find deployment targets in an Octopus Deploy space
find_deployment_targetsRead-onlyIdempotent
Find deployment targets in a space: get a single target by ID or list all with optional filters like name, roles, health status, and environment.
Instructions
Find deployment targets (machines) in a space - can retrieve a single target by ID or list all targets
This unified tool can either:
Get detailed information about a specific deployment target when targetId is provided
List all deployment targets in a space when targetId is omitted
You can optionally filter by various parameters like name, roles, health status, etc. when listing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| spaceName | Yes | ||
| targetId | No | The ID of a specific deployment target to retrieve. If omitted, lists all deployment targets. | |
| skip | No | Number of targets to skip for pagination (only used when listing) | |
| take | No | Number of targets to take for pagination (only used when listing) | |
| name | No | Filter by exact name (only used when listing) | |
| ids | No | Filter by specific target IDs (only used when listing) | |
| partialName | No | Filter by partial name match (only used when listing) | |
| roles | No | A list of roles / target tags to filter by (only used when listing) | |
| isDisabled | No | Filter by disabled status (only used when listing) | |
| healthStatuses | No | Possible values: Healthy, Unhealthy, Unavailable, Unknown, HasWarnings (only used when listing) | |
| commStyles | No | Filter by communication styles (only used when listing) | |
| tenantIds | No | Filter by tenant IDs (only used when listing) | |
| tenantTags | No | Filter by tenant tags (only used when listing) | |
| environmentIds | No | Filter by environment IDs (only used when listing) | |
| thumbprint | No | Filter by thumbprint (only used when listing) | |
| deploymentId | No | Filter by deployment ID (only used when listing) | |
| shellNames | No | Filter by shell names (only used when listing) | |
| deploymentTargetTypes | No | Filter by deployment target types (only used when listing) |