Get cloud onboarding deployments by connector ID Experimental; added in 9.5.0

GET /api/fleet/cloud_onboarding_deployments/connector/{connectorId}
Api key auth Basic auth

Spaces method and path for this operation:

get /s/{space_id}/api/fleet/cloud_onboarding_deployments/connector/{connectorId}

Refer to Spaces for more information.

List all cloud onboarding deployments for a given connector ID.

[Required authorization] Route required privileges: fleet-agent-policies-read OR integrations-read.

Path parameters

  • connectorId string Required

    The fleet-cloud-connector ID to list deployments for.

    Minimum length is 1.

Responses

  • 200 application/json

    Successful response

    Hide response attribute Show response attribute object
    • items array[object] Required

      Not more than 100 elements.

      Hide items attributes Show items attributes object
      • agentPolicyId string

        Agent policy ID created for agent-based deployments. Present only when agent_based is in mechanisms.

      • apiKeyId string

        Elasticsearch API key ID for push mechanisms (ecf). Set by the backend; used for key rotation/revocation.

      • attemptCount number Required

        Number of deployment attempts, including the current one.

        Minimum value is 1.

      • authMethod string

        Authentication method for managed integrations.

        Values are identity_federation or static_keys.

      • connectorId string

        ID of the fleet-cloud-connector this deployment belongs to. Absent for static-keys deployments.

      • dataFormat string

        Data format: ecs or otel.

        Values are ecs or otel.

      • deploymentId string

        Opaque deployment identifier; for AWS, the CFN stack ARN.

      • deploymentName string

        Opaque deployment name; for AWS, the CFN stack name.

      • ecfStacks array[object]

        ECF CloudFormation stacks launched as part of this deployment. Written by the wizard after the user clicks Launch.

        Not more than 10 elements.

        Hide ecfStacks attributes Show ecfStacks attributes object
        • family string Required

          ECF template family.

          Values are unified, otel, or crowdstrike.

        • stackName string Required

          CloudFormation stack name (128-char AWS limit).

          Minimum length is 1, maximum length is 128.

        • templateVersion string Required

          ECF semantic version resolved at launch time, e.g. "1.10.0".

          Minimum length is 1, maximum length is 32.

      • globalRegion string

        Global AWS region from the Service Settings step.

      • id string Required
      • mechanisms array[string] Required

        Delivery mechanism: managed_integration, ecf, or agent_based.

        Not more than 10 elements. Values are managed_integration, ecf, or agent_based.

      • packagePolicyIds array[string]

        Package policy IDs created for managed_integration services.

        Not more than 100 elements.

      • provider string Required

        Cloud provider.

        Values are aws, azure, or gcp.

      • services array[string] Required

        Service IDs covered by this deployment.

        Not more than 1000 elements.

      • serviceVars object

        Per-service config keyed by instance ID. Each value is the ServiceVars object from the Service Settings step.

        Hide serviceVars attribute Show serviceVars attribute object
        • * object Additional properties
      • status string Required

        Deployment status.

        Values are pending, deploying, succeeded, or failed.

      • statusMessage string

        Error context when status is failed.
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • attributes Required
    • error string
    • errorType string
    • message string Required
    • statusCode number
GET /api/fleet/cloud_onboarding_deployments/connector/{connectorId} 
curl \
 --request GET 'https://localhost:5601/api/fleet/cloud_onboarding_deployments/connector/{connectorId}' \
 --header "Authorization: $API_KEY"
Response examples (200)
List of cloud onboarding deployments for a connector 
{
  "items": [
    {
      "attemptCount": 1,
      "connectorId": "cloud-connector-id-1",
      "deploymentId": "arn:aws:cloudformation:us-east-1:123456789012:stack/elastic-aws-onboarding/aaa-bbb-ccc",
      "deploymentName": "elastic-aws-onboarding",
      "id": "onboarding-deployment-id-1",
      "mechanisms": [
        "managed_integration"
      ],
      "packagePolicyIds": [
        "package-policy-id-1"
      ],
      "provider": "aws",
      "services": [
        "cloudwatch_metrics"
      ],
      "status": "succeeded"
    },
    {
      "attemptCount": 1,
      "connectorId": "cloud-connector-id-1",
      "id": "onboarding-deployment-id-2",
      "mechanisms": [
        "managed_integration",
        "ecf"
      ],
      "provider": "aws",
      "services": [
        "cloudfront_logs"
      ],
      "serviceVars": {
        "cloudfront_logs": {
          "regions": [
            "us-east-1"
          ],
          "s3_bucket_arn": "arn:aws:s3:::my-cloudfront-logs-bucket"
        }
      },
      "status": "deploying"
    }
  ]
}
Response examples (400)
Example of a generic error response 
{
  "error": "Bad Request",
  "message": "An error message describing what went wrong",
  "statusCode": 400
}