OPoptum

Get a lease by Id

Changed on
get/leases/{id}

Request

Path parameters

idstring required

Id for lease

Response

OK

idstring

Lease ID

principalIdstring

principalId of the lease to get

accountIdstring

accountId of the AWS account

leaseStatus'Active' | 'Inactive'

Status of the Lease. "Active": The principal is leased and has access to the account "Inactive": The lease has become inactive, either through expiring, exceeding budget, or by request.

leaseStatusReason'LeaseExpired' | 'LeaseOverBudget' | 'LeaseDestroyed' | 'LeaseActive' | 'LeaseRolledBack'

A reason behind the lease status. "LeaseExpired": The lease exceeded its expiration time ("expiresOn") and the associated account was reset and returned to the account pool. "LeaseOverBudget": The lease exceeded its budgeted amount and the associated account was reset and returned to the account pool. "LeaseDestroyed": The lease was adminstratively ended, which can be done via the leases API. "LeaseActive": The lease is active. "LeaseRolledBack": A system error occurred while provisioning the lease. and it was rolled back.

createdOnnumber

creation date in epoch seconds

lastModifiedOnnumber

date last modified in epoch seconds

budgetAmountnumber

budget amount

budgetCurrencystring

budget currency

budgetNotificationEmailsstring[]

budget notification emails

leaseStatusModifiedOnnumber

date lease status was last modified in epoch seconds

expiresOnnumber

date lease should expire in epoch seconds

Changes

  • eed5055f8eb6Revision changes
    • warning

      the optional response header Access-Control-Allow-Headers removed for the status 200

    • warning

      the optional response header Access-Control-Allow-Methods removed for the status 200

    • warning

      the optional response header Access-Control-Allow-Origin removed for the status 200