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-license-manager:amazon-license-manager-grant-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: AWS License Manager Grant API
  version: '2018-08-01'
  description: Generated from AWS's published Smithy model for AWS License Manager. 5 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://license-manager.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Grant
paths:
  /#AcceptGrant:
    post:
      operationId: AcceptGrant
      summary: Accept Grant
      description: Accepts the specified grant.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AcceptGrantResponse'
        '401':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '403':
          description: AuthorizationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AuthorizationException'
        '400':
          description: InvalidParameterValueException; ResourceLimitExceededException; ValidationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '429':
          description: RateLimitExceededException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RateLimitExceededException'
        '500':
          description: ServerInternalException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ServerInternalException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSLicenseManager.AcceptGrant
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/AcceptGrantRequest'
      tags:
      - Grant
  /#CreateGrant:
    post:
      operationId: CreateGrant
      summary: Create Grant
      description: 'Creates a grant for the specified license. A grant shares the use of license entitlements with a specific Amazon Web Services account, an organization, or an organizational unit (OU). For more information, see Granted licenses in License Manager in the License Manager User Guide. Set the type of grant with the GrantType field: BuyerGrant - The default grant type, created by the seller when a customer subscribes to a product. The seller creates a license for the subscription and a buyer grant for the customer. With a buyer grant, the customer can use, consume, and distribute the license, according to the permissions the seller sets in the product contract. DelegateGrant - A delegate grant gives the grantee read-only visibility into the licenses and grants that you have distributed to buyers for a product. The grantee can monitor that activity on your behalf, and can also listen for the related Amazon EventBridge events. A delegate grant conveys no entitlement to use the licenses, and its only allowed operation is ListReceivedLicenses. You must create the delegate grant, and its license, from the same Amazon Web Services account that you used to create those buyer licenses and grants'
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/CreateGrantResponse'
        '401':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '403':
          description: AuthorizationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AuthorizationException'
        '400':
          description: InvalidParameterValueException; ResourceLimitExceededException; ValidationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '429':
          description: RateLimitExceededException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RateLimitExceededException'
        '500':
          description: ServerInternalException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ServerInternalException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSLicenseManager.CreateGrant
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/CreateGrantRequest'
      tags:
      - Grant
  /#DeleteGrant:
    post:
      operationId: DeleteGrant
      summary: Delete Grant
      description: Deletes the specified grant.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/DeleteGrantResponse'
        '401':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '403':
          description: AuthorizationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AuthorizationException'
        '400':
          description: InvalidParameterValueException; ResourceLimitExceededException; ValidationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '429':
          description: RateLimitExceededException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RateLimitExceededException'
        '500':
          description: ServerInternalException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ServerInternalException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSLicenseManager.DeleteGrant
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/DeleteGrantRequest'
      tags:
      - Grant
  /#GetGrant:
    post:
      operationId: GetGrant
      summary: Get Grant
      description: Gets detailed information about the specified grant.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/GetGrantResponse'
        '401':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '403':
          description: AuthorizationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AuthorizationException'
        '400':
          description: InvalidParameterValueException; ResourceLimitExceededException; ValidationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '429':
          description: RateLimitExceededException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RateLimitExceededException'
        '500':
          description: ServerInternalException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ServerInternalException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSLicenseManager.GetGrant
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/GetGrantRequest'
      tags:
      - Grant
  /#RejectGrant:
    post:
      operationId: RejectGrant
      summary: Reject Grant
      description: Rejects the specified grant.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RejectGrantResponse'
        '401':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '403':
          description: AuthorizationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/AuthorizationException'
        '400':
          description: InvalidParameterValueException; ResourceLimitExceededException; ValidationException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/InvalidParameterValueException'
        '429':
          description: RateLimitExceededException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/RateLimitExceededException'
        '500':
          description: ServerInternalException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ServerInternalException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSLicenseManager.RejectGrant
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/RejectGrantRequest'
      tags:
      - Grant
components:
  schemas:
    GetGrantResponse:
      type: object
      properties:
        Grant:
          $ref: '#/components/schemas/Grant'
    DeleteGrantRequest:
      type: object
      properties:
        GrantArn:
          type: string
          description: Amazon Resource Name (ARN) of the grant.
        StatusReason:
          type: string
          description: The Status reason for the delete request.
        Version:
          type: string
          description: Current version of the grant.
      required:
      - GrantArn
      - Version
    InvalidParameterValueException:
      type: object
      properties:
        Message:
          type: string
    AuthorizationException:
      type: object
      properties:
        Message:
          type: string
    AcceptGrantResponse:
      type: object
      properties:
        GrantArn:
          type: string
          description: Grant ARN.
        Status:
          type: string
          enum:
          - PENDING_WORKFLOW
          - PENDING_ACCEPT
          - REJECTED
          - ACTIVE
          - FAILED_WORKFLOW
          - DELETED
          - PENDING_DELETE
          - DISABLED
          - WORKFLOW_COMPLETED
          description: Grant status.
        Version:
          type: string
          description: Grant version.
    ServerInternalException:
      type: object
      properties:
        Message:
          type: string
    CreateGrantRequest:
      type: object
      properties:
        ClientToken:
          type: string
          description: Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
        GrantName:
          type: string
          description: Grant name.
        LicenseArn:
          type: string
          description: Amazon Resource Name (ARN) of the license.
        Principals:
          type: array
          items:
            type: string
          description: 'The grant principals. You can specify one of the following as an Amazon Resource Name (ARN): An Amazon Web Services account, which includes only the account specified. An organizational unit (OU), which includes all accounts in the OU. An organization, which will include all accounts across your organization.'
        HomeRegion:
          type: string
          description: Home Region of the grant.
        AllowedOperations:
          type: array
          items:
            type: string
            enum:
            - CreateGrant
            - CheckoutLicense
            - CheckoutBorrowLicense
            - CheckInLicense
            - ExtendConsumptionLicense
            - ListPurchasedLicenses
            - CreateToken
            - ListReceivedLicenses
          description: Allowed operations for the grant.
        Tags:
          type: array
          items:
            $ref: '#/components/schemas/Tag'
          description: Tags to add to the grant. For more information about tagging support in License Manager, see the TagResource operation.
        GrantType:
          type: string
          enum:
          - BuyerGrant
          - DelegateGrant
          description: 'The type of grant to create. For more information about each type, see the preceding description of this operation. Valid values: BuyerGrant - The default grant type if you don''t specify a value. Conveys the entitlement to use the license. DelegateGrant - Gives the grantee read-only visibility into the licenses and grants that you have distributed to buyers, with no entitlement to use them.'
        Options:
          $ref: '#/components/schemas/Options'
      required:
      - ClientToken
      - GrantName
      - LicenseArn
      - Principals
      - HomeRegion
      - AllowedOperations
    AccessDeniedException:
      type: object
      properties:
        Message:
          type: string
    RejectGrantResponse:
      type: object
      properties:
        GrantArn:
          type: string
          description: Grant ARN.
        Status:
          type: string
          enum:
          - PENDING_WORKFLOW
          - PENDING_ACCEPT
          - REJECTED
          - ACTIVE
          - FAILED_WORKFLOW
          - DELETED
          - PENDING_DELETE
          - DISABLED
          - WORKFLOW_COMPLETED
          description: Grant status.
        Version:
          type: string
          description: Grant version.
    RateLimitExceededException:
      type: object
      properties:
        Message:
          type: string
    CreateGrantResponse:
      type: object
      properties:
        GrantArn:
          type: string
          description: Grant ARN.
        Status:
          type: string
          enum:
          - PENDING_WORKFLOW
          - PENDING_ACCEPT
          - REJECTED
          - ACTIVE
          - FAILED_WORKFLOW
          - DELETED
          - PENDING_DELETE
          - DISABLED
          - WORKFLOW_COMPLETED
          description: Grant status.
        Version:
          type: string
          description: Grant version.
    Grant:
      type: object
      properties:
        GrantArn:
          type: string
          description: Amazon Resource Name (ARN) of the grant.
        GrantName:
          type: string
          description: Grant name.
        ParentArn:
          type: string
          description: Parent ARN.
        LicenseArn:
          type: string
          description: License ARN.
        GranteePrincipalArn:
          type: string
          description: The grantee principal ARN.
        HomeRegion:
          type: string
          description: Home Region of the grant.
        GrantStatus:
          type: string
          enum:
          - PENDING_WORKFLOW
          - PENDING_ACCEPT
          - REJECTED
          - ACTIVE
          - FAILED_WORKFLOW
          - DELETED
          - PENDING_DELETE
          - DISABLED
          - WORKFLOW_COMPLETED
          description: Grant status.
        StatusReason:
          type: string
          description: Grant status reason.
        Version:
          type: string
          description: Grant version.
        GrantedOperations:
          type: array
          items:
            type: string
            enum:
            - CreateGrant
            - CheckoutLicense
            - CheckoutBorrowLicense
            - CheckInLicense
            - ExtendConsumptionLicense
            - ListPurchasedLicenses
            - CreateToken
            - ListReceivedLicenses
          description: Granted operations.
        Options:
          $ref: '#/components/schemas/Options'
        GrantType:
          type: string
          enum:
          - BuyerGrant
          - DelegateGrant
          description: 'The type of the grant. Valid values: BuyerGrant - Grants the entitlement to use the license. DelegateGrant - Gives the grantee read-only visibility into the licenses and grants distributed to buyers, with no entitlement to use them.'
      required:
      - GrantArn
      - GrantName
      - ParentArn
      - LicenseArn
      - GranteePrincipalArn
      - HomeRegion
      - GrantStatus
      - Version
      - GrantedOperations
    DeleteGrantResponse:
      type: object
      properties:
        GrantArn:
          type: string
          description: Grant ARN.
        Status:
          type: string
          enum:
          - PENDING_WORKFLOW
          - PENDING_ACCEPT
          - REJECTED
          - ACTIVE
          - FAILED_WORKFLOW
          - DELETED
          - PENDING_DELETE
          - DISABLED
          - WORKFLOW_COMPLETED
          description: Grant status.
        Version:
          type: string
          description: Grant version.
    Options:
      type: object
      properties:
        ActivationOverrideBehavior:
          type: string
          enum:
          - DISTRIBUTED_GRANTS_ONLY
          - ALL_GRANTS_PERMITTED_BY_ISSUER
          description: An activation option for your grant that determines the behavior of activating a grant. Activation options can only be used with granted licenses sourced from the Amazon Web Services Marketplace. Additionally, the operation must activate the grant. For the CreateGrantVersion operation, specify ACTIVE for the Status parameter. For the CreateGrant operation, specify ACTIVE for the DesiredStatus option. As a license administrator, you can optionally specify an ActivationOverrideBehavior when activating a grant. As a grantor, you can optionally specify an ActivationOverrideBehavior when you activa
        DesiredStatus:
          type: string
          enum:
          - PENDING_WORKFLOW
          - PENDING_ACCEPT
          - REJECTED
          - ACTIVE
          - FAILED_WORKFLOW
          - DELETED
          - PENDING_DELETE
          - DISABLED
          - WORKFLOW_COMPLETED
          description: The status of the grant after License Manager creates it. The only supported value is ACTIVE. Specify ACTIVE to create and activate the grant in one request. You can specify this option only for the CreateGrant operation, and only when the grant principal is an organization or an organizational unit (OU). To change the status of an existing grant, use the Status parameter of the CreateGrantVersion operation.
    Tag:
      type: object
      properties:
        Key:
          type: string
          description: The tag key.
        Value:
          type: string
          description: The tag value.
    RejectGrantRequest:
      type: object
      properties:
        GrantArn:
          type: string
          description: Amazon Resource Name (ARN) of the grant.
      required:
      - GrantArn
    AcceptGrantRequest:
      type: object
      properties:
        GrantArn:
          type: string
          description: Amazon Resource Name (ARN) of the grant.
      required:
      - GrantArn
    GetGrantRequest:
      type: object
      properties:
        GrantArn:
          type: string
          description: Amazon Resource Name (ARN) of the grant.
        Version:
          type: string
          description: Grant version.
      required:
      - GrantArn
  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: license-manager
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/license-manager/service/2018-08-01/license-manager-2018-08-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)