VMware vCloud Suite SDK for .NET 6.0.0
vmware::vapi::std::errors::Unauthorized Class Reference

The Unauthorized error indicates that the user is not authorized to perform the method. More...

Inherits vmware::vapi::std::errors::Error.

List of all members.

Public Member Functions

 Unauthorized (global::System.Collections.Generic.List< vmware.vapi.std.LocalizableMessage > messages, vmware.vapi.bindings.IStructure data)
 Creates a new instance of this type using the given arguments.
 Unauthorized ()
 Creates a default new instance.
override
vmware.vapi.bindings.type.StructType 
_GetType ()
override
vmware.vapi.data.StructValue 
_GetDataValue ()
override void _Validate ()
override bool _HasTypeNameOf< T > ()
override T _ConvertTo< T > ()
override bool Equals (object obj)
override int GetHashCode ()

Properties

override string Message [get]

Detailed Description

The Unauthorized error indicates that the user is not authorized to perform the method.

API requests may include a security context containing user credentials. For example, the user credentials could be a SAML token, a user name and password, or the session identifier for a previously established session. Invoking the method may require that the user identified by those credentials has particular privileges on the method or on one or more resource identifiers passed to the method.

Examples:

  • The method requires that the user have one or more privileges on the method, but the user identified by the credentials in the security context does not have the required privileges.
  • The method requires that the user have one or more privileges on a resource identifier passed to the method, but the user identified by the credentials in the security context does not have the required privileges.

Counterexamples:

  • The SAML token in the request's security context has expired. A Unauthenticated error would be used instead.
  • The user name and password in the request's security context are invalid. The Unauthenticated error would be used instead.
  • The session identifier in the request's security context identifies a session that has expired. The Unauthenticated error would be used instead.

For security reasons, the Error.data field in this error is null, and the Error.messages field in this error does not disclose why the user is not authorized to perform the method. For example the messages would not disclose which privilege the user did not have or which resource identifier the user did not have the required privilege to access. The API documentation should indicate what privileges are required.


Constructor & Destructor Documentation

vmware::vapi::std::errors::Unauthorized::Unauthorized ( global::System.Collections.Generic.List< vmware.vapi.std.LocalizableMessage messages,
vmware.vapi.bindings.IStructure  data 
) [inline]

Creates a new instance of this type using the given arguments.

vmware::vapi::std::errors::Unauthorized::Unauthorized ( ) [inline]

Creates a default new instance.


Member Function Documentation

override T vmware::vapi::std::errors::Unauthorized::_ConvertTo< T > ( ) [inline]

Reimplemented from vmware::vapi::std::errors::Error.

override vmware.vapi.data.StructValue vmware::vapi::std::errors::Unauthorized::_GetDataValue ( ) [inline]

Reimplemented from vmware::vapi::std::errors::Error.

override vmware.vapi.bindings.type.StructType vmware::vapi::std::errors::Unauthorized::_GetType ( ) [inline, virtual]

Reimplemented from vmware::vapi::std::errors::Error.

override bool vmware::vapi::std::errors::Unauthorized::_HasTypeNameOf< T > ( ) [inline]

Reimplemented from vmware::vapi::std::errors::Error.

override void vmware::vapi::std::errors::Unauthorized::_Validate ( ) [inline, virtual]

Reimplemented from vmware::vapi::std::errors::Error.

override bool vmware::vapi::std::errors::Unauthorized::Equals ( object  obj) [inline]

Reimplemented from vmware::vapi::std::errors::Error.

override int vmware::vapi::std::errors::Unauthorized::GetHashCode ( ) [inline]

Reimplemented from vmware::vapi::std::errors::Error.


Property Documentation

override string vmware::vapi::std::errors::Unauthorized::Message [get]

Reimplemented from vmware::vapi::std::errors::Error.


The documentation for this class was generated from the following file: