REST API - create

esx trusted infrastructure kms providers: create

Add a new provider. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Request:

HTTP request

POST https://{server}/api/esx/trusted-infrastructure/kms/providers

{
    "provider" : "obj-103",
    "native_spec" : {
        "key_id" : "string",
        "key_derivation_key" : "secret string"
    }
}

Body Parameters:

Name	Type	Description
bold = required
-	create_spec	Provider information.
-.provider	string	Name of the provider. A unique string chosen by the client. . Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: `com.vmware.esx.trusted_infrastructure.kms.provider`. When operations return a value of this structure as a result, the field will be an identifier for the resource type: `com.vmware.esx.trusted_infrastructure.kms.provider`.
-.native_spec	native_provider_create_spec	Configuration for new NATIVE provider. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Optional. This field is currently required. It may be optional in a future version.
-.native_spec.key_id	string	Key identifier for the provider. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
-.native_spec.key_derivation_key	secret	Key used to derive data encryption keys. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Response:

HTTP Status Code: 204

Headers:

None

Type:

None

Errors:

HTTP Status Code	Type	Description
400	already_exists	if the provider already exists.
500	error	if there is a generic error.
400	invalid_argument	if the spec is invalid.
401	unauthenticated	if the caller is not authenticated.
403	unauthorized	if the caller is not authorized.