vapi metadata metamodel: service info

The service_info structure contains the metamodel information of all the operation elements, structure elements and enumeration elements containted in a service element.

Representation:

{
    "constants"[
        {
            "key""string",
            "value"{
                "documentation""string",
                "type"{
                    "builtin_type""VOID",
                    "category""BUILTIN",
                    "generic_instantiation"{
                        "element_type"{
                            "builtin_type""VOID",
                            "category""BUILTIN",
                            "generic_instantiation"{
                                "generic_type""LIST"
                            },
                            "user_defined_type"{
                                "resource_id""obj-103",
                                "resource_type""string"
                            }
                        },
                        "generic_type""LIST"
                    },
                    "user_defined_type"{
                        "resource_id""obj-103",
                        "resource_type""string"
                    }
                },
                "value"{
                    "category""PRIMITIVE",
                    "list_value"[
                        {
                            "boolean_value"true,
                            "double_value"1.5,
                            "long_value"1,
                            "string_value""string",
                            "type""BOOLEAN"
                        },
                        {
                            "boolean_value"true,
                            "double_value"1.5,
                            "long_value"1,
                            "string_value""string",
                            "type""BOOLEAN"
                        }
                    ],
                    "primitive_value"{
                        "boolean_value"true,
                        "double_value"1.5,
                        "long_value"1,
                        "string_value""string",
                        "type""BOOLEAN"
                    }
                }
            }
        }
    ],
    "documentation""string",
    "enumerations"[
        {
            "key""obj-103",
            "value"{
                "documentation""string",
                "metadata"[
                    {
                        "key""string",
                        "value"{
                            "elements"[
                                {
                                    "key""string",
                                    "value"{
                                        "list_value"[
                                            "string",
                                            "string"
                                        ],
                                        "long_value"1,
                                        "string_value""string",
                                        "structure_id""obj-103",
                                        "structure_ids"[
                                            "obj-103",
                                            "obj-103"
                                        ],
                                        "type""LONG"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "name""string",
                "values"[
                    {
                        "documentation""string",
                        "metadata"[
                            {
                                "key""string",
                                "value"{
                                    "elements"[
                                        {
                                            "key""string",
                                            "value"{
                                                "list_value"[
                                                    "string",
                                                    "string"
                                                ],
                                                "long_value"1,
                                                "string_value""string",
                                                "structure_id""obj-103",
                                                "structure_ids"[
                                                    "obj-103",
                                                    "obj-103"
                                                ],
                                                "type""LONG"
                                            }
                                        }
                                    ]
                                }
                            }
                        ],
                        "value""string"
                    },
                    {
                        "documentation""string",
                        "metadata"[
                            {
                                "key""string",
                                "value"{
                                    "elements"[
                                        {
                                            "key""string",
                                            "value"{
                                                "list_value"[
                                                    "string",
                                                    "string"
                                                ],
                                                "long_value"1,
                                                "string_value""string",
                                                "structure_id""obj-103",
                                                "structure_ids"[
                                                    "obj-103",
                                                    "obj-103"
                                                ],
                                                "type""LONG"
                                            }
                                        }
                                    ]
                                }
                            }
                        ],
                        "value""string"
                    }
                ]
            }
        }
    ],
    "metadata"[
        {
            "key""string",
            "value"{
                "elements"[
                    {
                        "key""string",
                        "value"{
                            "list_value"[
                                "string",
                                "string"
                            ],
                            "long_value"1,
                            "string_value""string",
                            "structure_id""obj-103",
                            "structure_ids"[
                                "obj-103",
                                "obj-103"
                            ],
                            "type""LONG"
                        }
                    }
                ]
            }
        }
    ],
    "name""string",
    "operations"[
        {
            "key""obj-103",
            "value"{
                "documentation""string",
                "errors"[
                    {
                        "documentation""string",
                        "structure_id""obj-103"
                    },
                    {
                        "documentation""string",
                        "structure_id""obj-103"
                    }
                ],
                "metadata"[
                    {
                        "key""string",
                        "value"{
                            "elements"[
                                {
                                    "key""string",
                                    "value"{
                                        "list_value"[
                                            "string",
                                            "string"
                                        ],
                                        "long_value"1,
                                        "string_value""string",
                                        "structure_id""obj-103",
                                        "structure_ids"[
                                            "obj-103",
                                            "obj-103"
                                        ],
                                        "type""LONG"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "name""string",
                "output"{
                    "documentation""string",
                    "metadata"[
                        {
                            "key""string",
                            "value"{
                                "elements"[
                                    {
                                        "key""string",
                                        "value"{
                                            "list_value"[
                                                "string",
                                                "string"
                                            ],
                                            "long_value"1,
                                            "string_value""string",
                                            "structure_id""obj-103",
                                            "structure_ids"[
                                                "obj-103",
                                                "obj-103"
                                            ],
                                            "type""LONG"
                                        }
                                    }
                                ]
                            }
                        }
                    ],
                    "type"{
                        "builtin_type""VOID",
                        "category""BUILTIN",
                        "generic_instantiation"{
                            "element_type"{
                                "builtin_type""VOID",
                                "category""BUILTIN",
                                "generic_instantiation"{
                                    "generic_type""LIST"
                                },
                                "user_defined_type"{
                                    "resource_id""obj-103",
                                    "resource_type""string"
                                }
                            },
                            "generic_type""LIST"
                        },
                        "user_defined_type"{
                            "resource_id""obj-103",
                            "resource_type""string"
                        }
                    }
                },
                "params"[
                    {
                        "documentation""string",
                        "metadata"[
                            {
                                "key""string",
                                "value"{
                                    "elements"[
                                        {
                                            "key""string",
                                            "value"{
                                                "list_value"[
                                                    "string",
                                                    "string"
                                                ],
                                                "long_value"1,
                                                "string_value""string",
                                                "structure_id""obj-103",
                                                "structure_ids"[
                                                    "obj-103",
                                                    "obj-103"
                                                ],
                                                "type""LONG"
                                            }
                                        }
                                    ]
                                }
                            }
                        ],
                        "name""string",
                        "type"{
                            "builtin_type""VOID",
                            "category""BUILTIN",
                            "generic_instantiation"{
                                "element_type"{
                                    "builtin_type""VOID",
                                    "category""BUILTIN",
                                    "generic_instantiation"{
                                        "generic_type""LIST"
                                    },
                                    "user_defined_type"{
                                        "resource_id""obj-103",
                                        "resource_type""string"
                                    }
                                },
                                "generic_type""LIST"
                            },
                            "user_defined_type"{
                                "resource_id""obj-103",
                                "resource_type""string"
                            }
                        }
                    },
                    {
                        "documentation""string",
                        "metadata"[
                            {
                                "key""string",
                                "value"{
                                    "elements"[
                                        {
                                            "key""string",
                                            "value"{
                                                "list_value"[
                                                    "string",
                                                    "string"
                                                ],
                                                "long_value"1,
                                                "string_value""string",
                                                "structure_id""obj-103",
                                                "structure_ids"[
                                                    "obj-103",
                                                    "obj-103"
                                                ],
                                                "type""LONG"
                                            }
                                        }
                                    ]
                                }
                            }
                        ],
                        "name""string",
                        "type"{
                            "builtin_type""VOID",
                            "category""BUILTIN",
                            "generic_instantiation"{
                                "element_type"{
                                    "builtin_type""VOID",
                                    "category""BUILTIN",
                                    "generic_instantiation"{
                                        "generic_type""LIST"
                                    },
                                    "user_defined_type"{
                                        "resource_id""obj-103",
                                        "resource_type""string"
                                    }
                                },
                                "generic_type""LIST"
                            },
                            "user_defined_type"{
                                "resource_id""obj-103",
                                "resource_type""string"
                            }
                        }
                    }
                ]
            }
        }
    ],
    "structures"[
        {
            "key""obj-103",
            "value"{
                "constants"[
                    {
                        "key""string",
                        "value"{
                            "documentation""string",
                            "type"{
                                "builtin_type""VOID",
                                "category""BUILTIN",
                                "generic_instantiation"{
                                    "element_type"{
                                        "builtin_type""VOID",
                                        "category""BUILTIN",
                                        "generic_instantiation"{
                                            "generic_type""LIST"
                                        },
                                        "user_defined_type"{
                                            "resource_id""obj-103",
                                            "resource_type""string"
                                        }
                                    },
                                    "generic_type""LIST"
                                },
                                "user_defined_type"{
                                    "resource_id""obj-103",
                                    "resource_type""string"
                                }
                            },
                            "value"{
                                "category""PRIMITIVE",
                                "list_value"[
                                    {
                                        "boolean_value"true,
                                        "double_value"1.5,
                                        "long_value"1,
                                        "string_value""string",
                                        "type""BOOLEAN"
                                    },
                                    {
                                        "boolean_value"true,
                                        "double_value"1.5,
                                        "long_value"1,
                                        "string_value""string",
                                        "type""BOOLEAN"
                                    }
                                ],
                                "primitive_value"{
                                    "boolean_value"true,
                                    "double_value"1.5,
                                    "long_value"1,
                                    "string_value""string",
                                    "type""BOOLEAN"
                                }
                            }
                        }
                    }
                ],
                "documentation""string",
                "enumerations"[
                    {
                        "key""obj-103",
                        "value"{
                            "documentation""string",
                            "metadata"[
                                {
                                    "key""string",
                                    "value"{
                                        "elements"[
                                            {
                                                "key""string",
                                                "value"{
                                                    "list_value"[
                                                        "string",
                                                        "string"
                                                    ],
                                                    "long_value"1,
                                                    "string_value""string",
                                                    "structure_id""obj-103",
                                                    "structure_ids"[
                                                        "obj-103",
                                                        "obj-103"
                                                    ],
                                                    "type""LONG"
                                                }
                                            }
                                        ]
                                    }
                                }
                            ],
                            "name""string",
                            "values"[
                                {
                                    "documentation""string",
                                    "metadata"[
                                        {
                                            "key""string",
                                            "value"{
                                                "elements"[
                                                    {
                                                        "key""string",
                                                        "value"{
                                                            "list_value"[
                                                                "string",
                                                                "string"
                                                            ],
                                                            "long_value"1,
                                                            "string_value""string",
                                                            "structure_id""obj-103",
                                                            "structure_ids"[
                                                                "obj-103",
                                                                "obj-103"
                                                            ],
                                                            "type""LONG"
                                                        }
                                                    }
                                                ]
                                            }
                                        }
                                    ],
                                    "value""string"
                                },
                                {
                                    "documentation""string",
                                    "metadata"[
                                        {
                                            "key""string",
                                            "value"{
                                                "elements"[
                                                    {
                                                        "key""string",
                                                        "value"{
                                                            "list_value"[
                                                                "string",
                                                                "string"
                                                            ],
                                                            "long_value"1,
                                                            "string_value""string",
                                                            "structure_id""obj-103",
                                                            "structure_ids"[
                                                                "obj-103",
                                                                "obj-103"
                                                            ],
                                                            "type""LONG"
                                                        }
                                                    }
                                                ]
                                            }
                                        }
                                    ],
                                    "value""string"
                                }
                            ]
                        }
                    }
                ],
                "fields"[
                    {
                        "documentation""string",
                        "metadata"[
                            {
                                "key""string",
                                "value"{
                                    "elements"[
                                        {
                                            "key""string",
                                            "value"{
                                                "list_value"[
                                                    "string",
                                                    "string"
                                                ],
                                                "long_value"1,
                                                "string_value""string",
                                                "structure_id""obj-103",
                                                "structure_ids"[
                                                    "obj-103",
                                                    "obj-103"
                                                ],
                                                "type""LONG"
                                            }
                                        }
                                    ]
                                }
                            }
                        ],
                        "name""string",
                        "type"{
                            "builtin_type""VOID",
                            "category""BUILTIN",
                            "generic_instantiation"{
                                "element_type"{
                                    "builtin_type""VOID",
                                    "category""BUILTIN",
                                    "generic_instantiation"{
                                        "generic_type""LIST"
                                    },
                                    "user_defined_type"{
                                        "resource_id""obj-103",
                                        "resource_type""string"
                                    }
                                },
                                "generic_type""LIST"
                            },
                            "user_defined_type"{
                                "resource_id""obj-103",
                                "resource_type""string"
                            }
                        }
                    },
                    {
                        "documentation""string",
                        "metadata"[
                            {
                                "key""string",
                                "value"{
                                    "elements"[
                                        {
                                            "key""string",
                                            "value"{
                                                "list_value"[
                                                    "string",
                                                    "string"
                                                ],
                                                "long_value"1,
                                                "string_value""string",
                                                "structure_id""obj-103",
                                                "structure_ids"[
                                                    "obj-103",
                                                    "obj-103"
                                                ],
                                                "type""LONG"
                                            }
                                        }
                                    ]
                                }
                            }
                        ],
                        "name""string",
                        "type"{
                            "builtin_type""VOID",
                            "category""BUILTIN",
                            "generic_instantiation"{
                                "element_type"{
                                    "builtin_type""VOID",
                                    "category""BUILTIN",
                                    "generic_instantiation"{
                                        "generic_type""LIST"
                                    },
                                    "user_defined_type"{
                                        "resource_id""obj-103",
                                        "resource_type""string"
                                    }
                                },
                                "generic_type""LIST"
                            },
                            "user_defined_type"{
                                "resource_id""obj-103",
                                "resource_type""string"
                            }
                        }
                    }
                ],
                "metadata"[
                    {
                        "key""string",
                        "value"{
                            "elements"[
                                {
                                    "key""string",
                                    "value"{
                                        "list_value"[
                                            "string",
                                            "string"
                                        ],
                                        "long_value"1,
                                        "string_value""string",
                                        "structure_id""obj-103",
                                        "structure_ids"[
                                            "obj-103",
                                            "obj-103"
                                        ],
                                        "type""LONG"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "name""string",
                "type""STRUCTURE"
            }
        }
    ]
}

Attributes:

Name Type Description
Required
name string Dot separated name of the service element. The segments in the name reflect the organization of the APIs. The format of each segment is lower case with underscores. Each underscore represents a word boundary. If there are acronyms in the word, the capitalization is preserved. This format makes it easy to translate the segment into a different naming convention.

operations list Metamodel information of all the operation elements contained in the service element. The key in the key/value pairs is the identifier of the operation element and the value in the key/value pairs is the metamodel information for the operation element.

When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: com.vmware.vapi.operation. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: com.vmware.vapi.operation.List of {"key": string, "value": operation_info}

structures list Metamodel information of all the structure elements contained in the service element. The key in the key/value pairs is the identifier of the structure element and the value in the key/value pairs is the metamodel information for the structure element.

When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: com.vmware.vapi.structure. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: com.vmware.vapi.structure.List of {"key": string, "value": structure_info}

enumerations list Metamodel information of all the enumeration elements contained in the service element. The key in the key/value pairs is the identifier of the enumeration element and the value in the key/value pairs is the metamodel information for the enumeration element.

When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: com.vmware.vapi.enumeration. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: com.vmware.vapi.enumeration.List of {"key": string, "value": enumeration_info}

constants list Metamodel information of all the constant elements contained in the service element. The key in the key/value pairs is the name of the constant element and the value in the key/value pairs is the metamodel information for the contant element.

List of {"key": string, "value": constant_info}

metadata list Generic metadata elements for the service element. The key in the key/value pairs is the name of the metadata element and the value is the data associated with that metadata element.

The vapi.metadata.metamodel.metadata_identifier contains possible string values for keys in the key/value pairs.

List of {"key": string, "value": element_map}

documentation string English language documentation for the service element. It can contain HTML markup and Javadoc tags. The first sentence of the service documentation is a complete sentence that identifies the service by name and summarizes the purpose of the service. The remaining part of the documentation provides a summary of how to use the operations defined in the service.