com.vmware.vcenter.trusted_infrastructure.trusted_clusters package¶
Submodules¶
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.attestation_client module¶
The
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.attestation_client
module provides classes for configuring Attestation Services for Trusted
Clusters.
-
class
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.attestation_client.
Services
(config)¶ Bases:
vmware.vapi.bindings.stub.VapiInterface
The
Services
class contains information about thecom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instances a cluster uses. This class was added in vSphere API 7.0.0.- Parameters
config (
vmware.vapi.bindings.stub.StubConfiguration
) – Configuration to be used for creating the stub.
-
class
CreateSpec
(type=None, service=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.CreateSpec
class contains the data necessary for adding acom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
to the environment. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
type (
Services.CreateSpec.SourceType
) – Source of truth for the configuration of the Attestation Service. This attribute was added in vSphere API 7.0.0.service (
str
) – The service’s unique ID. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
. This attribute is optional and it is only relevant when the value oftype
isServices.CreateSpec.SourceType.SERVICE
.trust_authority_cluster (
str
) – The attestation cluster’s unique ID. This attribute was added in vSphere API 7.0.0. This attribute is optional and it is only relevant when the value oftype
isServices.CreateSpec.SourceType.CLUSTER
.
-
class
SourceType
(string)¶ Bases:
vmware.vapi.bindings.enum.Enum
The
Services.CreateSpec.SourceType
class lists options which source the the Attestation Service to use for its configuration. This enumeration was added in vSphere API 7.0.0.Note
This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.
- Parameters
string (
str
) – String value for theSourceType
instance.
-
CLUSTER
= SourceType(string='CLUSTER')¶ The Attestation Service will be configured based on an ID of a whole attestation cluster. This class attribute was added in vSphere API 7.0.0.
-
SERVICE
= SourceType(string='SERVICE')¶ The Attestation Service will be configured based on an ID of an specific Attestation Service. This class attribute was added in vSphere API 7.0.0.
-
class
FilterSpec
(services=None, address=None, group=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.FilterSpec
class contains the data necessary for identifying acom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
services (
set
ofstr
orNone
) – A set of IDs by which to filter the services. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
. If None, the services will not be filtered by ID.address (
list
ofcom.vmware.vcenter.trusted_infrastructure_client.NetworkAddress
orNone
) – The service’s address. This attribute was added in vSphere API 7.0.0. If None, the services will not be filtered by address.group (
set
ofstr
orNone
) – The group determines whichcom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instances can accept reports issued by thiscom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instance. This attribute was added in vSphere API 7.0.0. If None, the services will not be filtered by group.trust_authority_cluster (
set
ofstr
orNone
) – The cluster determines which Trust Authority Cluster thisServices
belongs to. This attribute was added in vSphere API 7.0.0. If None, the services will not be filtered by trustAuthorityCluster.
-
class
Info
(address=None, trusted_ca=None, group=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.Info
class contains all the stored information about acom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
address (
com.vmware.vcenter.trusted_infrastructure_client.NetworkAddress
) – The service’s address. This attribute was added in vSphere API 7.0.0.trusted_ca (
com.vmware.vcenter.trusted_infrastructure_client.X509CertChain
) – The service’s TLS certificate chain. This attribute was added in vSphere API 7.0.0.group (
str
) – The group ID determines whichcom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instances thiscom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
can communicate with. This attribute was added in vSphere API 7.0.0.trust_authority_cluster (
str
) – The cluster determines which Trust Authority Cluster thisServices
belongs to. This attribute was added in vSphere API 7.0.0.
-
class
Summary
(service=None, address=None, group=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.Summary
class contains a summary of acom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
service (
str
) – The service’s unique identifier. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
.address (
com.vmware.vcenter.trusted_infrastructure_client.NetworkAddress
) – The service’s address. This attribute was added in vSphere API 7.0.0.group (
str
) – The group determines whichcom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instances can accept reports issued by thiscom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instance. This attribute was added in vSphere API 7.0.0.trust_authority_cluster (
str
) – The cluster determines which Trust Authority Cluster thisServices
belongs to. This attribute was added in vSphere API 7.0.0.
-
create_task
(cluster, spec)¶ Configures the cluster to use a new
com.vmware.vcenter.trusted_infrastructure.attestation_client.Services
. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – The ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.spec (
Services.CreateSpec
) – Describes thecom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
.
- Return type
- class
vmware.vapi.stdlib.client.task.Task
- Returns
Task instance
- Raise
com.vmware.vapi.std.errors_client.AlreadyExists
if thecom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
is already configured for this cluster- Raise
com.vmware.vapi.std.errors_client.Error
for any other error.- Raise
com.vmware.vapi.std.errors_client.InvalidArgument
if the CreateSpec is not valid.- Raise
com.vmware.vapi.std.errors_client.NotFound
if the cluster ID is not valid.- Raise
com.vmware.vapi.std.errors_client.UnableToAllocateResource
if all the hosts in the cluster do not have VMware vSphere Trust Authority enabled license.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.
-
delete_task
(cluster, service)¶ Marks the
com.vmware.vcenter.trusted_infrastructure.attestation_client.Services
so that it will no longer be used by the cluster. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – the unique ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.service (
str
) – thecom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instance unique identifier. The parameter must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
.
- Raise
com.vmware.vapi.std.errors_client.Error
if there is a generic error.- Raise
com.vmware.vapi.std.errors_client.NotFound
if thecom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
or the cluster are not found.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.
-
get
(cluster, service)¶ Returns detailed information for a
com.vmware.vcenter.trusted_infrastructure.attestation_client.Services
configured for a cluster. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – The ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.service (
str
) – The ID of the service. The parameter must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.attestation.Service
.
- Return type
- Returns
Info for the specified
com.vmware.vcenter.trusted_infrastructure.attestation_client.Services
.- Raise
com.vmware.vapi.std.errors_client.Error
if there is a generic error.- Raise
com.vmware.vapi.std.errors_client.NotFound
if the cluster or the service ID is invalid.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.- Raise
com.vmware.vapi.std.errors_client.Unauthorized
if you do not have all of the privileges described as follows:Method execution requires
TrustedAdmin.ReadTrustedHosts
.The resource
ClusterComputeResource
referenced by the parametercluster
requiresSystem.View
.
-
list
(cluster, spec=None)¶ Returns the list of all
com.vmware.vcenter.trusted_infrastructure.attestation_client.Services
configured for a cluster. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – The ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.spec (
Services.FilterSpec
orNone
) – Only return services matching the filters. If {\@term.unset} return all services.
- Return type
- Returns
List of all
com.vmware.vcenter.trusted_infrastructure.attestation_client.Services
used by this cluster.- Raise
com.vmware.vapi.std.errors_client.Error
if there is a generic error.- Raise
com.vmware.vapi.std.errors_client.NotFound
if the cluster ID is invalid.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.- Raise
com.vmware.vapi.std.errors_client.Unauthorized
if you do not have all of the privileges described as follows:Method execution requires
TrustedAdmin.ReadTrustedHosts
.The resource
ClusterComputeResource
referenced by the parametercluster
requiresSystem.View
.
-
class
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.attestation_client.
StubFactory
(stub_config)¶ Bases:
vmware.vapi.bindings.stub.StubFactoryBase
Initialize StubFactoryBase
- Parameters
stub_config (
vmware.vapi.bindings.stub.StubConfiguration
) – Stub config instance
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.kms_client module¶
The com.vmware.vcenter.trusted_infrastructure.trusted_clusters.kms_client
module provides classes for configuring Key Provider Services for Trusted
Clusters.
-
class
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.kms_client.
Services
(config)¶ Bases:
vmware.vapi.bindings.stub.VapiInterface
The
Services
class contains information about thecom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instances a cluster uses. This class was added in vSphere API 7.0.0.- Parameters
config (
vmware.vapi.bindings.stub.StubConfiguration
) – Configuration to be used for creating the stub.
-
class
CreateSpec
(type=None, service=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.CreateSpec
class contains the data necessary for adding acom.vmware.vcenter.trusted_infrastructure.kms_client.Services
to the environment. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
type (
Services.CreateSpec.SourceType
) – Source of truth for the configuration of the Key Provider Service. This attribute was added in vSphere API 7.0.0.service (
str
) – The service’s unique ID. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
. This attribute is optional and it is only relevant when the value oftype
isServices.CreateSpec.SourceType.SERVICE
.trust_authority_cluster (
str
) – The attestation cluster’s unique ID. This attribute was added in vSphere API 7.0.0. This attribute is optional and it is only relevant when the value oftype
isServices.CreateSpec.SourceType.CLUSTER
.
-
class
SourceType
(string)¶ Bases:
vmware.vapi.bindings.enum.Enum
The
Services.CreateSpec.SourceType
class lists options which source the the Key Provider Service to use for its configuration. This enumeration was added in vSphere API 7.0.0.Note
This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.
- Parameters
string (
str
) – String value for theSourceType
instance.
-
CLUSTER
= SourceType(string='CLUSTER')¶ The Key Provider Service will be configured based on an ID of a whole attestation cluster. This class attribute was added in vSphere API 7.0.0.
-
SERVICE
= SourceType(string='SERVICE')¶ The Key Provider Service will be configured based on an ID of an specific Key Provider Service. This class attribute was added in vSphere API 7.0.0.
-
class
FilterSpec
(services=None, address=None, group=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.FilterSpec
class contains the data necessary for identifying acom.vmware.vcenter.trusted_infrastructure.kms_client.Services
. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
services (
set
ofstr
orNone
) – A set of IDs by which to filter the services. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
. If None, the services will not be filtered by ID.address (
list
ofcom.vmware.vcenter.trusted_infrastructure_client.NetworkAddress
orNone
) – The service’s address. This attribute was added in vSphere API 7.0.0. If None, the services will not be filtered by address.group (
set
ofstr
orNone
) – The group determines reports issued by whichcom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instances can thiscom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instance accept. This attribute was added in vSphere API 7.0.0. If None, the services will not be filtered by group.trust_authority_cluster (
set
ofstr
orNone
) – The cluster determines which Trust Authority Cluster thisServices
belongs to. This attribute was added in vSphere API 7.0.0. If None, the services will not be filtered by trustAuthorityCluster.
-
class
Info
(address=None, trusted_ca=None, group=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.Info
class contains all the stored information about acom.vmware.vcenter.trusted_infrastructure.kms_client.Services
. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
address (
com.vmware.vcenter.trusted_infrastructure_client.NetworkAddress
) – The service’s address. This attribute was added in vSphere API 7.0.0.trusted_ca (
com.vmware.vcenter.trusted_infrastructure_client.X509CertChain
) – The service’s TLS certificate chain. This attribute was added in vSphere API 7.0.0.group (
str
) – The group determines reports issued by whichcom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instances can thiscom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instance accept. This attribute was added in vSphere API 7.0.0.trust_authority_cluster (
str
) – The cluster determines which Trust Authority Cluster thisServices
belongs to. This attribute was added in vSphere API 7.0.0.
-
class
Summary
(service=None, address=None, group=None, trust_authority_cluster=None)¶ Bases:
vmware.vapi.bindings.struct.VapiStruct
The
Services.Summary
class contains a summary of acom.vmware.vcenter.trusted_infrastructure.kms_client.Services
. This class was added in vSphere API 7.0.0.Tip
The arguments are used to initialize data attributes with the same names.
- Parameters
service (
str
) – The service’s unique identifier. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
.address (
com.vmware.vcenter.trusted_infrastructure_client.NetworkAddress
) – The service’s address. This attribute was added in vSphere API 7.0.0.group (
str
) – The group determines reports issued by whichcom.vmware.vcenter.trusted_infrastructure.attestation_client.Services
instances can thiscom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instance accept. This attribute was added in vSphere API 7.0.0.trust_authority_cluster (
str
) – The cluster determines which Trust Authority Cluster thisServices
belongs to. This attribute was added in vSphere API 7.0.0.
-
create_task
(cluster, spec)¶ Configures the cluster to use a new
com.vmware.vcenter.trusted_infrastructure.kms_client.Services
. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – The ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.spec (
Services.CreateSpec
) – Describes thecom.vmware.vcenter.trusted_infrastructure.kms_client.Services
.
- Return type
- class
vmware.vapi.stdlib.client.task.Task
- Returns
Task instance
- Raise
com.vmware.vapi.std.errors_client.AlreadyExists
if thecom.vmware.vcenter.trusted_infrastructure.kms_client.Services
is already configured for this cluster- Raise
com.vmware.vapi.std.errors_client.Error
for any other error.- Raise
com.vmware.vapi.std.errors_client.InvalidArgument
if the CreateSpec is not valid.- Raise
com.vmware.vapi.std.errors_client.NotFound
if the cluster ID is not valid.- Raise
com.vmware.vapi.std.errors_client.UnableToAllocateResource
if all the hosts in the cluster do not have VMware vSphere Trust Authority enabled license.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.
-
delete_task
(cluster, service)¶ Marks the
com.vmware.vcenter.trusted_infrastructure.kms_client.Services
so that it will no longer be used by the cluster. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – the unique ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.service (
str
) – thecom.vmware.vcenter.trusted_infrastructure.kms_client.Services
instance unique identifier. The parameter must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
.
- Raise
com.vmware.vapi.std.errors_client.Error
if there is a generic error.- Raise
com.vmware.vapi.std.errors_client.NotFound
if thecom.vmware.vcenter.trusted_infrastructure.kms_client.Services
or the cluster are not found.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.
-
get
(cluster, service)¶ Returns detailed information for a
com.vmware.vcenter.trusted_infrastructure.kms_client.Services
configured for a cluster. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – The ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.service (
str
) – The ID of the service. The parameter must be an identifier for the resource type:com.vmware.vcenter.trusted_platform.kms.Service
.
- Return type
- Returns
Info for the specified
com.vmware.vcenter.trusted_infrastructure.kms_client.Services
.- Raise
com.vmware.vapi.std.errors_client.Error
if there is a generic error.- Raise
com.vmware.vapi.std.errors_client.NotFound
if the cluster or the service ID is invalid.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.- Raise
com.vmware.vapi.std.errors_client.Unauthorized
if you do not have all of the privileges described as follows:Method execution requires
TrustedAdmin.ReadTrustedHosts
.The resource
ClusterComputeResource
referenced by the parametercluster
requiresSystem.View
.
-
list
(cluster, spec=None)¶ Returns the list of all
com.vmware.vcenter.trusted_infrastructure.kms_client.Services
configured for a cluster. This method was added in vSphere API 7.0.0.- Parameters
cluster (
str
) – The ID of the cluster. The parameter must be an identifier for the resource type:ClusterComputeResource
.spec (
Services.FilterSpec
orNone
) – Only return services matching the filters. If {\@term.unset} return all services.
- Return type
- Returns
List of all
com.vmware.vcenter.trusted_infrastructure.kms_client.Services
used by this cluster.- Raise
com.vmware.vapi.std.errors_client.Error
if there is a generic error.- Raise
com.vmware.vapi.std.errors_client.NotFound
if the cluster ID is invalid.- Raise
com.vmware.vapi.std.errors_client.Unauthenticated
if the user can not be authenticated.- Raise
com.vmware.vapi.std.errors_client.Unauthorized
if you do not have all of the privileges described as follows:Method execution requires
TrustedAdmin.ReadTrustedHosts
.The resource
ClusterComputeResource
referenced by the parametercluster
requiresSystem.View
.
-
class
com.vmware.vcenter.trusted_infrastructure.trusted_clusters.kms_client.
StubFactory
(stub_config)¶ Bases:
vmware.vapi.bindings.stub.StubFactoryBase
Initialize StubFactoryBase
- Parameters
stub_config (
vmware.vapi.bindings.stub.StubConfiguration
) – Stub config instance