openapi: 3.0.0 info: version: '2012-01-25' x-release: v4 title: 'Amazon Simple Workflow Service #X Amz Target=SimpleWorkflowService.CountClosedWorkflowExecutions #X Amz Target=SimpleWorkflowService.CountClosedWorkflowExecutions #X Amz Target=SimpleWorkflowService.CountOpenWorkflowExecutions API' description: Amazon Simple Workflow Service

The Amazon Simple Workflow Service (Amazon SWF) makes it easy to build applications that use Amazon's cloud to coordinate work across distributed components. In Amazon SWF, a task represents a logical unit of work that is performed by a component of your workflow. Coordinating tasks in a workflow involves managing intertask dependencies, scheduling, and concurrency in accordance with the logical flow of the application.

Amazon SWF gives you full control over implementing tasks and coordinating them without worrying about underlying complexities such as tracking their progress and maintaining their state.

This documentation serves as reference only. For a broader overview of the Amazon SWF programming model, see the Amazon SWF Developer Guide .

x-logo: url: https://twitter.com/awscloud/profile_image?size=original backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: swf x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/swf-2012-01-25.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://swf.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Amazon SWF multi-region endpoint - url: https://swf.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Amazon SWF multi-region endpoint - url: http://swf.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Amazon SWF endpoint for China (Beijing) and China (Ningxia) - url: https://swf.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Amazon SWF endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: '#X Amz Target=SimpleWorkflowService.CountOpenWorkflowExecutions' paths: /#X-Amz-Target=SimpleWorkflowService.CountOpenWorkflowExecutions: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CountOpenWorkflowExecutions description: '

Returns the number of open workflow executions within the given domain that meet the specified filtering criteria.

This operation is eventually consistent. The results are best effort and may not exactly reflect recent updates and changes.

Access Control

You can use IAM policies to control this action''s access to Amazon SWF resources as follows:

If the caller doesn''t have sufficient permissions to invoke the action, or the parameter values fall outside the specified constraints, the action fails. The associated event attribute''s cause parameter is set to OPERATION_NOT_PERMITTED. For details and example IAM policies, see Using IAM to Manage Access to Amazon SWF Workflows in the Amazon SWF Developer Guide.

' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/WorkflowExecutionCount' '480': description: UnknownResourceFault content: application/json: schema: $ref: '#/components/schemas/UnknownResourceFault' '481': description: OperationNotPermittedFault content: application/json: schema: $ref: '#/components/schemas/OperationNotPermittedFault' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CountOpenWorkflowExecutionsInput' parameters: - name: X-Amz-Target in: header required: true schema: type: string enum: - SimpleWorkflowService.CountOpenWorkflowExecutions example: SimpleWorkflowService.CountOpenWorkflowExecutions summary: Amazon SWF Count Open Workflow Executions x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - '#X Amz Target=SimpleWorkflowService.CountOpenWorkflowExecutions' components: parameters: X-Amz-Credential: name: X-Amz-Credential in: header schema: type: string required: false X-Amz-Security-Token: name: X-Amz-Security-Token in: header schema: type: string required: false X-Amz-Date: name: X-Amz-Date in: header schema: type: string required: false X-Amz-Algorithm: name: X-Amz-Algorithm in: header schema: type: string required: false X-Amz-SignedHeaders: name: X-Amz-SignedHeaders in: header schema: type: string required: false X-Amz-Content-Sha256: name: X-Amz-Content-Sha256 in: header schema: type: string required: false X-Amz-Signature: name: X-Amz-Signature in: header schema: type: string required: false schemas: WorkflowId: type: string minLength: 1 maxLength: 256 UnknownResourceFault: {} TagFilter: type: object required: - tag properties: tag: allOf: - $ref: '#/components/schemas/Tag' - description: '

Specifies the tag that must be associated with the execution for it to meet the filter criteria.

Tags may only contain unicode letters, digits, whitespace, or these symbols: _ . : / = + - @.

' description: Used to filter the workflow executions in visibility APIs based on a tag. Tag: type: string minLength: 0 maxLength: 256 Truncated: type: boolean Count: type: integer minimum: 0 WorkflowTypeFilter: type: object required: - name properties: name: allOf: - $ref: '#/components/schemas/Name' - description: ' Name of the workflow type.' version: allOf: - $ref: '#/components/schemas/VersionOptional' - description: Version of the workflow type. description: Used to filter workflow execution query results by type. Each parameter, if specified, defines a rule that must be satisfied by each returned result. DomainName: type: string minLength: 1 maxLength: 256 OperationNotPermittedFault: {} WorkflowExecutionFilter: type: object required: - workflowId properties: workflowId: allOf: - $ref: '#/components/schemas/WorkflowId' - description: The workflowId to pass of match the criteria of this filter. description: Used to filter the workflow executions in visibility APIs by their workflowId. VersionOptional: type: string maxLength: 64 Name: type: string minLength: 1 maxLength: 256 CountOpenWorkflowExecutionsInput: type: object required: - domain - startTimeFilter title: CountOpenWorkflowExecutionsInput properties: domain: allOf: - $ref: '#/components/schemas/DomainName' - description: The name of the domain containing the workflow executions to count. startTimeFilter: allOf: - $ref: '#/components/schemas/ExecutionTimeFilter' - description: Specifies the start time criteria that workflow executions must meet in order to be counted. typeFilter: allOf: - $ref: '#/components/schemas/WorkflowTypeFilter' - description:

Specifies the type of the workflow executions to be counted.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

tagFilter: allOf: - $ref: '#/components/schemas/TagFilter' - description:

If specified, only executions that have a tag that matches the filter are counted.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

executionFilter: allOf: - $ref: '#/components/schemas/WorkflowExecutionFilter' - description:

If specified, only workflow executions matching the WorkflowId in the filter are counted.

executionFilter, typeFilter and tagFilter are mutually exclusive. You can specify at most one of these in a request.

Timestamp: type: string format: date-time WorkflowExecutionCount: type: object required: - count properties: count: allOf: - $ref: '#/components/schemas/Count' - description: The number of workflow executions. truncated: allOf: - $ref: '#/components/schemas/Truncated' - description: If set to true, indicates that the actual count was more than the maximum supported by this API and the count returned is the truncated value. description: 'Contains the count of workflow executions returned from CountOpenWorkflowExecutions or CountClosedWorkflowExecutions ' ExecutionTimeFilter: type: object required: - oldestDate properties: oldestDate: allOf: - $ref: '#/components/schemas/Timestamp' - description: Specifies the oldest start or close date and time to return. latestDate: allOf: - $ref: '#/components/schemas/Timestamp' - description: Specifies the latest start or close date and time to return. description: 'Used to filter the workflow executions in visibility APIs by various time-based rules. Each parameter, if specified, defines a rule that must be satisfied by each returned query result. The parameter values are in the Unix Time format. For example: "oldestDate": 1325376070. ' securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/swf/ x-hasEquivalentPaths: true