Create Subscriptions
Initiates the creation of a subscription
Request
URI
POST
https://vmc.vmware.com/vmc/api/orgs/{org}/subscriptions
COPY
Path Parameters
string
org
Required
Organization identifier.
Request Body
subscriptionRequest
SubscriptionRequest
of type(s)
application/json
Required
{
"product": "host",
"product_type": "host - deprecated",
"quantity": 1,
"commitment_term": "12",
"offer_version": "1.0",
"region": "US_WEST_2",
"type": "i3.metal",
"offer_name": "VMware Cloud on AWS"
}
string
product
Optional
The product for which subscription needs to be created. Refer /vmc/api/orgs/{orgId}/products.
string
product_type
Required
Old identifier for product. Deprecarted. See product and type
integer
quantity
Required
quantity
string
product_charge_id
Optional
product_charge_id
string
commitment_term
Required
commitment_term
integer
price
Optional
price
string
product_id
Optional
product_id
string
offer_context_id
Optional
offer_context_id
string
offer_version
Required
offer_version
string
region
Required
region
string
type
Optional
The type of the product for which the subscription needs to be created.
string
offer_name
Required
offer_name
Responses
202
Accepted
Returns
Task
of type(s)
application/json
This response body class contains all of the following:
AbstractEntity
{
"updated_by_user_name": "string",
"updated_by_user_id": "string",
"user_id": "string",
"user_name": "string",
"created": "string",
"id": "1d1c83ee-e0b7-4de9-b660-9a9ca1d22f32",
"updated": "string",
"version": 5,
"error_message": "string",
"localized_error_message": "string",
"progress_percent": 75,
"parent_task_id": "string",
"sub_status": "string",
"phase_in_progress": "string",
"org_type": "string",
"end_time": "string",
"resource_type": "string",
"end_resource_entity_version": 5,
"start_time": "string",
"task_progress_phases": [
{
"progress_percent": 0,
"name": "string",
"id": "string"
}
],
"org_id": "1d1c83ee-e0b7-4de9-b660-9a9ca1d22f32",
"start_resource_entity_version": 0,
"resource_id": "string",
"correlation_id": "string",
"task_type": "string",
"task_version": "string",
"service_errors": [
{
"original_service_error_code": "string",
"default_message": "string",
"original_service": "string",
"localized_message": "string"
}
],
"estimated_remaining_minutes": 4,
"status": "string"
}
401
Unauthorized
Operation doesn't return any data structure
403
Forbidden
Operation doesn't return any data structure
500
Server error. Check retryable flag to see if request should be retried.
Returns
ErrorResponse
of type(s)
application/json
{
"retryable": false,
"path": "string",
"error_code": "string",
"error_messages": [
"string"
],
"status": 0
}
boolean
retryable
Required
If true, client should retry operation
string
path
Required
Originating request URI
string
error_code
Required
unique error code
array of
string
error_messages
Required
localized error messages
integer
status
Required
HTTP status code