Skip to content

StartJob

Source: src/AWS/Location/StartJob.ts

Starts a Location batch metadata job (e.g. batch address validation over an S3 input file).

Runtime binding for the StartJob operation (IAM action geo:StartJob). Bind the IAM Role Location assumes to read the S3 input and write the S3 output — its ARN is injected as ExecutionRoleArn and the host is additionally granted iam:PassRole on it. Jobs are named at runtime so the geo:StartJob grant is on *. Provide the implementation with Effect.provide(AWS.Location.StartJobHttp).

const startJob = yield* Location.StartJob(jobsRole);
const job = yield* startJob({
Action: "ValidateAddress",
InputOptions: { Format: "CSV", Location: "s3://my-bucket/addresses.csv" },
OutputOptions: { Format: "CSV", Location: "s3://my-bucket/results/" },
});
// job.JobId → poll with Location.GetJob