Microsoft Azure List Providers and Resources

arazzo: 1.0.1
info:
  title: Microsoft Azure List Providers and Resources
  summary: Confirm a subscription is enabled, list its resource providers, then list its resources.
  description: >-
    A capability-and-inventory discovery flow. The workflow gets the subscription
    to confirm it is Enabled, lists the resource providers registered against it
    so a caller can see which Azure services are available, and then lists the
    resources currently provisioned. It is useful for tooling that needs both the
    provider registration picture and the live resource inventory in one pass.
    Every step spells out its request inline so the flow can be read and executed
    without opening the underlying OpenAPI description.
  version: 1.0.0
  x-realizes-capability-ids:
  - BC-600.50
  x-capability-derivation:
    method: 'deterministic join: sourceDescriptions -> per-tag OpenAPI -> tag/capability edge. No classification at this step.'
    min_confidence: 0.7
    sources:
    - capability_id: BC-600.50
      capability_name: IT Infrastructure Management
      spec: microsoft-azure-resources-api-openapi.yml
      confidence: 0.85
    model: Turbo EA Capabilities by Vincent Verdet — Turbo EA, https://github.com/vincentmakes/turbo-ea-capabilities, CC BY 4.0
sourceDescriptions:
- name: providersApi
  url: ../openapi/microsoft-azure-providers-api-openapi.yml
  type: openapi
- name: resourcesApi
  url: ../openapi/microsoft-azure-resources-api-openapi.yml
  type: openapi
- name: subscriptionsApi
  url: ../openapi/microsoft-azure-subscriptions-api-openapi.yml
  type: openapi
workflows:
- workflowId: list-providers-and-resources
  summary: Enumerate a subscription's resource providers and its provisioned resources.
  description: >-
    Confirms the subscription is enabled, lists its resource providers, then
    lists all resources in the subscription.
  inputs:
    type: object
    required:
    - accessToken
    - subscriptionId
    properties:
      accessToken:
        type: string
        description: An Azure Resource Manager OAuth2 bearer access token.
      subscriptionId:
        type: string
        description: The ID of the target subscription.
      apiVersion:
        type: string
        description: The Azure Resource Manager API version.
        default: '2024-03-01'
  steps:
  - stepId: getSubscription
    description: >-
      Get the subscription and branch: only enumerate when it reports Enabled,
      otherwise end the flow.
    operationId: Subscriptions_Get
    parameters:
    - name: Authorization
      in: header
      value: Bearer $inputs.accessToken
    - name: subscriptionId
      in: path
      value: $inputs.subscriptionId
    - name: api-version
      in: query
      value: $inputs.apiVersion
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      state: $response.body#/state
    onSuccess:
    - name: subscriptionEnabled
      type: goto
      stepId: listProviders
      criteria:
      - context: $response.body
        condition: $.state == "Enabled"
        type: jsonpath
    - name: subscriptionNotEnabled
      type: end
      criteria:
      - context: $response.body
        condition: $.state != "Enabled"
        type: jsonpath
  - stepId: listProviders
    description: >-
      List the resource providers registered for the subscription, expanding
      resource types so available services are visible.
    operationId: Providers_List
    parameters:
    - name: Authorization
      in: header
      value: Bearer $inputs.accessToken
    - name: subscriptionId
      in: path
      value: $inputs.subscriptionId
    - name: api-version
      in: query
      value: $inputs.apiVersion
    - name: $expand
      in: query
      value: resourceTypes/aliases
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      providers: $response.body#/value
  - stepId: listResources
    description: List every resource in the subscription alongside the provider picture.
    operationId: Resources_List
    parameters:
    - name: Authorization
      in: header
      value: Bearer $inputs.accessToken
    - name: subscriptionId
      in: path
      value: $inputs.subscriptionId
    - name: api-version
      in: query
      value: $inputs.apiVersion
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      resources: $response.body#/value
  outputs:
    providers: $steps.listProviders.outputs.providers
    resources: $steps.listResources.outputs.resources