Amazon GameLift Create and Resolve a Fleet Alias

arazzo: 1.0.1
info:
  title: Amazon GameLift Create and Resolve a Fleet Alias
  summary: Create a SIMPLE alias that points to a fleet, then resolve and describe it to confirm the routing.
  description: >-
    Aliases give a stable identifier that routes to whichever fleet is currently
    active, letting you swap fleets without changing client configuration. This
    workflow creates a SIMPLE routing alias targeting a fleet, resolves the
    alias to confirm it points at the expected fleet, and then describes the
    alias to read back its full record. Each step spells out its AWS JSON
    protocol request inline, including the X-Amz-Target header, so the flow can
    be read and executed without opening the underlying OpenAPI description.
  version: 1.0.0
sourceDescriptions:
- name: xAmzTargetGameliftCreatealiasApi
  url: ../openapi/amazon-gamelift-x-amz-target-gamelift-createalias-api-openapi.yml
  type: openapi
- name: xAmzTargetGameliftDescribealiasApi
  url: ../openapi/amazon-gamelift-x-amz-target-gamelift-describealias-api-openapi.yml
  type: openapi
- name: xAmzTargetGameliftResolvealiasApi
  url: ../openapi/amazon-gamelift-x-amz-target-gamelift-resolvealias-api-openapi.yml
  type: openapi
workflows:
- workflowId: create-resolve-alias
  summary: Create a SIMPLE alias to a fleet, resolve it, and describe it.
  description: >-
    Creates an alias with a SIMPLE routing strategy targeting a fleet, resolves
    it to verify the fleet target, and reads back the alias record.
  inputs:
    type: object
    required:
    - aliasName
    - fleetId
    properties:
      aliasName:
        type: string
        description: A descriptive label for the alias.
      aliasDescription:
        type: string
        description: Optional human-readable description of the alias.
      fleetId:
        type: string
        description: The fleet ID the SIMPLE alias should route to.
  steps:
  - stepId: createAlias
    description: >-
      Create a new alias with a SIMPLE routing strategy that points to the
      target fleet.
    operationId: CreateAlias
    parameters:
    - name: X-Amz-Target
      in: header
      value: GameLift.CreateAlias
    requestBody:
      contentType: application/x-amz-json-1.1
      payload:
        Name: $inputs.aliasName
        Description: $inputs.aliasDescription
        RoutingStrategy:
          Type: SIMPLE
          FleetId: $inputs.fleetId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      aliasId: $response.body#/Alias/AliasId
      aliasArn: $response.body#/Alias/AliasArn
  - stepId: resolveAlias
    description: >-
      Resolve the alias to the fleet ID it currently points to, confirming the
      SIMPLE routing target.
    operationId: ResolveAlias
    parameters:
    - name: X-Amz-Target
      in: header
      value: GameLift.ResolveAlias
    requestBody:
      contentType: application/x-amz-json-1.1
      payload:
        AliasId: $steps.createAlias.outputs.aliasId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      resolvedFleetId: $response.body#/FleetId
  - stepId: describeAlias
    description: >-
      Read back the full alias record to confirm its name, description, and
      routing strategy.
    operationId: DescribeAlias
    parameters:
    - name: X-Amz-Target
      in: header
      value: GameLift.DescribeAlias
    requestBody:
      contentType: application/x-amz-json-1.1
      payload:
        AliasId: $steps.createAlias.outputs.aliasId
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      routingType: $response.body#/Alias/RoutingStrategy/Type
  outputs:
    aliasId: $steps.createAlias.outputs.aliasId
    resolvedFleetId: $steps.resolveAlias.outputs.resolvedFleetId