Amazon Resilience Hub Resource Management API

Map and import resources into app versions.

Operations 3

POST /add-draft-app-version-resource-mappings Add Draft App Version Resource Mappings #
POST /import-resources-to-draft-app-version Import Resources To Draft App Version #
POST /resolve-app-version-resources Resolve App Version Resources #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-resilience-hub:amazon-resilience-hub-resource-management-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-resilience-hub-resource-management-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: AWS Resilience Hub Resource Management API
  version: '2020-04-30'
  description: Generated from AWS's published Smithy model for AWS Resilience Hub. 3 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://resiliencehub.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /add-draft-app-version-resource-mappings:
    post:
      operationId: AddDraftAppVersionResourceMappings
      summary: Add Draft App Version Resource Mappings
      description: 'Adds the source of resource-maps to the draft version of an application. During assessment, Resilience
        Hub will use these resource-maps to resolve the latest physical ID for each resource in the application template.
        For more information about different types of resources supported by Resilience Hub and how to add them in your application,
        see Step 2: How is your application managed? in the Resilience Hub User Guide.'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddDraftAppVersionResourceMappingsResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddDraftAppVersionResourceMappingsRequest'
      tags:
      - Resource Management
  /import-resources-to-draft-app-version:
    post:
      operationId: ImportResourcesToDraftAppVersion
      summary: Import Resources To Draft App Version
      description: Imports resources to Resilience Hub application draft version from different input sources. For more information
        about the input sources supported by Resilience Hub, see Discover the structure and describe your Resilience Hub application.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportResourcesToDraftAppVersionResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportResourcesToDraftAppVersionRequest'
      tags:
      - Resource Management
  /resolve-app-version-resources:
    post:
      operationId: ResolveAppVersionResources
      summary: Resolve App Version Resources
      description: Resolves the resources for an application version.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolveAppVersionResourcesResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationException'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResolveAppVersionResourcesRequest'
      tags:
      - Resource Management
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: resiliencehub
  schemas:
    AccessDeniedException:
      type: object
      properties:
        message:
          type: string
    AddDraftAppVersionResourceMappingsRequest:
      type: object
      properties:
        appArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
            For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
            guide.'
        resourceMappings:
          type: array
          items:
            $ref: '#/components/schemas/ResourceMapping'
          description: Mappings used to map logical resources from the template to physical resources. You can use the mapping
            type CFN_STACK if the application template uses a logical stack name. Or you can map individual resources by using
            the mapping type RESOURCE. We recommend using the mapping type CFN_STACK if the application is backed by a CloudFormation
            stack.
      required:
      - appArn
      - resourceMappings
    AddDraftAppVersionResourceMappingsResponse:
      type: object
      properties:
        appArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
            For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
            guide.'
        appVersion:
          type: string
          description: The version of the application.
        resourceMappings:
          type: array
          items:
            $ref: '#/components/schemas/ResourceMapping'
          description: List of sources that are used to map a logical resource from the template to a physical resource. You
            can use sources such as CloudFormation, Terraform state files, AppRegistry applications, or Amazon EKS.
      required:
      - appArn
      - appVersion
      - resourceMappings
    ConflictException:
      type: object
      properties:
        message:
          type: string
        resourceId:
          type: string
          description: The identifier of the resource that the exception applies to.
        resourceType:
          type: string
          description: The type of the resource that the exception applies to.
    EksSource:
      type: object
      properties:
        eksClusterArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Amazon Elastic Kubernetes Service cluster. The format for this ARN
            is: arn:aws:eks:region:account-id:cluster/cluster-name. For more information about ARNs, see Amazon Resource Names
            (ARNs) in the Amazon Web Services General Reference guide.'
        namespaces:
          type: array
          items:
            type: string
          description: The list of namespaces located on your Amazon Elastic Kubernetes Service cluster.
      required:
      - eksClusterArn
      - namespaces
    ImportResourcesToDraftAppVersionRequest:
      type: object
      properties:
        appArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
            For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
            guide.'
        sourceArns:
          type: array
          items:
            type: string
          description: The Amazon Resource Names (ARNs) for the resources.
        terraformSources:
          type: array
          items:
            $ref: '#/components/schemas/TerraformSource'
          description: A list of terraform file s3 URLs you need to import.
        importStrategy:
          type: string
          enum:
          - AddOnly
          - ReplaceAll
          description: The import strategy you would like to set to import resources into Resilience Hub application.
        eksSources:
          type: array
          items:
            $ref: '#/components/schemas/EksSource'
          description: The input sources of the Amazon Elastic Kubernetes Service resources you need to import.
      required:
      - appArn
    ImportResourcesToDraftAppVersionResponse:
      type: object
      properties:
        appArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
            For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
            guide.'
        appVersion:
          type: string
          description: The version of the application.
        sourceArns:
          type: array
          items:
            type: string
          description: The Amazon Resource Names (ARNs) for the resources you have imported.
        status:
          type: string
          enum:
          - Pending
          - InProgress
          - Failed
          - Success
          description: Status of the action.
        terraformSources:
          type: array
          items:
            $ref: '#/components/schemas/TerraformSource'
          description: A list of terraform file s3 URLs you have imported.
        eksSources:
          type: array
          items:
            $ref: '#/components/schemas/EksSource'
          description: The input sources of the Amazon Elastic Kubernetes Service resources you have imported.
      required:
      - appArn
      - appVersion
      - status
    InternalServerException:
      type: object
      properties:
        message:
          type: string
    PhysicalResourceId:
      type: object
      properties:
        identifier:
          type: string
          description: Identifier of the physical resource.
        type:
          type: string
          enum:
          - Arn
          - Native
          description: 'Specifies the type of physical resource identifier. Arn The resource identifier is an Amazon Resource
            Name (ARN) and it can identify the following list of resources: AWS::ECS::Service AWS::EFS::FileSystem AWS::ElasticLoadBalancingV2::LoadBalancer
            AWS::Lambda::Function AWS::SNS::Topic Native The resource identifier is an Resilience Hub-native identifier and
            it can identify the following list of resources: AWS::ApiGateway::RestApi AWS::ApiGatewayV2::Api AWS::AutoScaling::AutoScalingGroup
            AWS::DocDB::DBCluster AWS::DocDB::DBGlobalCluster AWS::DocDB::DBInstance AWS::DynamoDB::GlobalTable AWS::Dyna'
        awsRegion:
          type: string
          description: The Amazon Web Services Region that the physical resource is located in.
        awsAccountId:
          type: string
          description: The Amazon Web Services account that owns the physical resource.
      required:
      - identifier
      - type
    ResolveAppVersionResourcesRequest:
      type: object
      properties:
        appArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
            For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
            guide.'
        appVersion:
          type: string
          description: The version of the application.
      required:
      - appArn
      - appVersion
    ResolveAppVersionResourcesResponse:
      type: object
      properties:
        appArn:
          type: string
          description: 'Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:partition:resiliencehub:region:account:app/app-id.
            For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference
            guide.'
        appVersion:
          type: string
          description: The version of the application.
        resolutionId:
          type: string
          description: The identifier for a specific resolution.
        status:
          type: string
          enum:
          - Pending
          - InProgress
          - Failed
          - Success
          description: Status of the action.
      required:
      - appArn
      - appVersion
      - resolutionId
      - status
    ResourceMapping:
      type: object
      properties:
        resourceName:
          type: string
          description: Name of the resource that this resource is mapped to when the mappingType is Resource.
        logicalStackName:
          type: string
          description: Name of the CloudFormation stack this resource is mapped to when the mappingType is CfnStack.
        appRegistryAppName:
          type: string
          description: Name of the application this resource is mapped to when the mappingType is AppRegistryApp.
        resourceGroupName:
          type: string
          description: Name of the Resource Groups that this resource is mapped to when the mappingType is ResourceGroup.
        mappingType:
          type: string
          enum:
          - CfnStack
          - Resource
          - AppRegistryApp
          - ResourceGroup
          - Terraform
          - EKS
          description: Specifies the type of resource mapping.
        physicalResourceId:
          $ref: '#/components/schemas/PhysicalResourceId'
        terraformSourceName:
          type: string
          description: Name of the Terraform source that this resource is mapped to when the mappingType is Terraform.
        eksSourceName:
          type: string
          description: Name of the Amazon Elastic Kubernetes Service cluster and namespace that this resource is mapped to
            when the mappingType is EKS. This parameter accepts values in "eks-cluster/namespace" format.
      required:
      - mappingType
      - physicalResourceId
    ResourceNotFoundException:
      type: object
      properties:
        message:
          type: string
        resourceId:
          type: string
          description: The identifier of the resource that the exception applies to.
        resourceType:
          type: string
          description: The type of the resource that the exception applies to.
    ServiceQuotaExceededException:
      type: object
      properties:
        message:
          type: string
    TerraformSource:
      type: object
      properties:
        s3StateFileUrl:
          type: string
          description: The URL of the Terraform s3 state file you need to import.
      required:
      - s3StateFileUrl
    ThrottlingException:
      type: object
      properties:
        message:
          type: string
        retryAfterSeconds:
          type: integer
          description: The number of seconds to wait before retrying the operation.
    ValidationException:
      type: object
      properties:
        message:
          type: string
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/resiliencehub/service/2020-04-30/resiliencehub-2020-04-30.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)