Package com.vmware.nsx_policy.orgs.projects.infra

Interface Constraints

All Superinterfaces:

ConstraintsTypes, com.vmware.vapi.bindings.Service

All Known Implementing Classes:

ConstraintsStub

public interface Constraints
extends com.vmware.vapi.bindings.Service, ConstraintsTypes

Field Summary

Fields inherited from interface com.vmware.nsx_policy.orgs.projects.infra.ConstraintsTypes

_VAPI_SERVICE_ID

Method Summary

Modifier and Type	Method	Description
void	delete(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId)	Delete tenant constraint.
void	delete(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback)	Delete tenant constraint.
void	delete(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Delete tenant constraint.
void	delete(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Delete tenant constraint.
Constraint	get(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId)	Read tenant constraint.
void	get(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback)	Read tenant constraint.
void	get(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Read tenant constraint.
Constraint	get(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Read tenant constraint.
ConstraintListResult	list(java.lang.String orgId, java.lang.String projectId, java.lang.String cursor, java.lang.Boolean includeMarkForDeleteObjects, java.lang.String includedFields, java.lang.Long pageSize, java.lang.Boolean sortAscending, java.lang.String sortBy)	List tenant constraints.
void	list(java.lang.String orgId, java.lang.String projectId, java.lang.String cursor, java.lang.Boolean includeMarkForDeleteObjects, java.lang.String includedFields, java.lang.Long pageSize, java.lang.Boolean sortAscending, java.lang.String sortBy, com.vmware.vapi.bindings.client.AsyncCallback<ConstraintListResult> asyncCallback)	List tenant constraints.
void	list(java.lang.String orgId, java.lang.String projectId, java.lang.String cursor, java.lang.Boolean includeMarkForDeleteObjects, java.lang.String includedFields, java.lang.Long pageSize, java.lang.Boolean sortAscending, java.lang.String sortBy, com.vmware.vapi.bindings.client.AsyncCallback<ConstraintListResult> asyncCallback, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	List tenant constraints.
ConstraintListResult	list(java.lang.String orgId, java.lang.String projectId, java.lang.String cursor, java.lang.Boolean includeMarkForDeleteObjects, java.lang.String includedFields, java.lang.Long pageSize, java.lang.Boolean sortAscending, java.lang.String sortBy, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	List tenant constraints.
void	patch(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint)	Create tenant constraint if not exists, otherwise update the existing constraint.
void	patch(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint, com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback)	Create tenant constraint if not exists, otherwise update the existing constraint.
void	patch(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint, com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Create tenant constraint if not exists, otherwise update the existing constraint.
void	patch(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Create tenant constraint if not exists, otherwise update the existing constraint.
Constraint	update(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint)	Create tenant constraint if it does not exist, otherwise replace the existing constraint.
void	update(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint, com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback)	Create tenant constraint if it does not exist, otherwise replace the existing constraint.
void	update(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint, com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Create tenant constraint if it does not exist, otherwise replace the existing constraint.
Constraint	update(java.lang.String orgId, java.lang.String projectId, java.lang.String constraintId, Constraint constraint, com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)	Create tenant constraint if it does not exist, otherwise replace the existing constraint.

Method Detail

delete

void delete(java.lang.String orgId,
            java.lang.String projectId,
            java.lang.String constraintId)

Delete tenant constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

delete

void delete(java.lang.String orgId,
            java.lang.String projectId,
            java.lang.String constraintId,
            com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Delete tenant constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

invocationConfig - Configuration for the method invocation.

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

delete

void delete(java.lang.String orgId,
            java.lang.String projectId,
            java.lang.String constraintId,
            com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback)

Delete tenant constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

delete

void delete(java.lang.String orgId,
            java.lang.String projectId,
            java.lang.String constraintId,
            com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback,
            com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Delete tenant constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

get

Constraint get(java.lang.String orgId,
               java.lang.String projectId,
               java.lang.String constraintId)

Read tenant constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

Returns:

com.vmware.nsx_policy.model.Constraint

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

get

Constraint get(java.lang.String orgId,
               java.lang.String projectId,
               java.lang.String constraintId,
               com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Read tenant constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

invocationConfig - Configuration for the method invocation.

Returns:

com.vmware.nsx_policy.model.Constraint

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

get

void get(java.lang.String orgId,
         java.lang.String projectId,
         java.lang.String constraintId,
         com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback)

Read tenant constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
com.vmware.nsx_policy.model.Constraint

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

get

void get(java.lang.String orgId,
         java.lang.String projectId,
         java.lang.String constraintId,
         com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback,
         com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Read tenant constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
com.vmware.nsx_policy.model.Constraint

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

list

ConstraintListResult list(java.lang.String orgId,
                          java.lang.String projectId,
                          java.lang.String cursor,
                          java.lang.Boolean includeMarkForDeleteObjects,
                          java.lang.String includedFields,
                          java.lang.Long pageSize,
                          java.lang.Boolean sortAscending,
                          java.lang.String sortBy)

List tenant constraints.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

cursor - Opaque cursor to be used for getting next page of records (supplied by current result page) (optional)

includeMarkForDeleteObjects - Include objects that are marked for deletion in results (optional, default to false)

includedFields - Comma separated list of fields that should be included in query result (optional)

pageSize - Maximum number of results to return in this page (server may return fewer) (optional, default to 1000)

sortAscending - (optional)

sortBy - Field by which records are sorted (optional)

Returns:

com.vmware.nsx_policy.model.ConstraintListResult

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

list

ConstraintListResult list(java.lang.String orgId,
                          java.lang.String projectId,
                          java.lang.String cursor,
                          java.lang.Boolean includeMarkForDeleteObjects,
                          java.lang.String includedFields,
                          java.lang.Long pageSize,
                          java.lang.Boolean sortAscending,
                          java.lang.String sortBy,
                          com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

List tenant constraints.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

cursor - Opaque cursor to be used for getting next page of records (supplied by current result page) (optional)

includeMarkForDeleteObjects - Include objects that are marked for deletion in results (optional, default to false)

includedFields - Comma separated list of fields that should be included in query result (optional)

pageSize - Maximum number of results to return in this page (server may return fewer) (optional, default to 1000)

sortAscending - (optional)

sortBy - Field by which records are sorted (optional)

invocationConfig - Configuration for the method invocation.

Returns:

com.vmware.nsx_policy.model.ConstraintListResult

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

list

void list(java.lang.String orgId,
          java.lang.String projectId,
          java.lang.String cursor,
          java.lang.Boolean includeMarkForDeleteObjects,
          java.lang.String includedFields,
          java.lang.Long pageSize,
          java.lang.Boolean sortAscending,
          java.lang.String sortBy,
          com.vmware.vapi.bindings.client.AsyncCallback<ConstraintListResult> asyncCallback)

List tenant constraints.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
com.vmware.nsx_policy.model.ConstraintListResult

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

cursor - Opaque cursor to be used for getting next page of records (supplied by current result page) (optional)

includeMarkForDeleteObjects - Include objects that are marked for deletion in results (optional, default to false)

includedFields - Comma separated list of fields that should be included in query result (optional)

pageSize - Maximum number of results to return in this page (server may return fewer) (optional, default to 1000)

sortAscending - (optional)

sortBy - Field by which records are sorted (optional)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

list

void list(java.lang.String orgId,
          java.lang.String projectId,
          java.lang.String cursor,
          java.lang.Boolean includeMarkForDeleteObjects,
          java.lang.String includedFields,
          java.lang.Long pageSize,
          java.lang.Boolean sortAscending,
          java.lang.String sortBy,
          com.vmware.vapi.bindings.client.AsyncCallback<ConstraintListResult> asyncCallback,
          com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

List tenant constraints.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
com.vmware.nsx_policy.model.ConstraintListResult

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

cursor - Opaque cursor to be used for getting next page of records (supplied by current result page) (optional)

includeMarkForDeleteObjects - Include objects that are marked for deletion in results (optional, default to false)

includedFields - Comma separated list of fields that should be included in query result (optional)

pageSize - Maximum number of results to return in this page (server may return fewer) (optional, default to 1000)

sortAscending - (optional)

sortBy - Field by which records are sorted (optional)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

patch

void patch(java.lang.String orgId,
           java.lang.String projectId,
           java.lang.String constraintId,
           Constraint constraint)

Create tenant constraint if not exists, otherwise update the existing constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

patch

void patch(java.lang.String orgId,
           java.lang.String projectId,
           java.lang.String constraintId,
           Constraint constraint,
           com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Create tenant constraint if not exists, otherwise update the existing constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

invocationConfig - Configuration for the method invocation.

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

patch

void patch(java.lang.String orgId,
           java.lang.String projectId,
           java.lang.String constraintId,
           Constraint constraint,
           com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback)

Create tenant constraint if not exists, otherwise update the existing constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

patch

void patch(java.lang.String orgId,
           java.lang.String projectId,
           java.lang.String constraintId,
           Constraint constraint,
           com.vmware.vapi.bindings.client.AsyncCallback<java.lang.Void> asyncCallback,
           com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Create tenant constraint if not exists, otherwise update the existing constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.

update

Constraint update(java.lang.String orgId,
                  java.lang.String projectId,
                  java.lang.String constraintId,
                  Constraint constraint)

Create tenant constraint if it does not exist, otherwise replace the existing constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

Returns:

com.vmware.nsx_policy.model.Constraint

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

update

Constraint update(java.lang.String orgId,
                  java.lang.String projectId,
                  java.lang.String constraintId,
                  Constraint constraint,
                  com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Create tenant constraint if it does not exist, otherwise replace the existing constraint.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

invocationConfig - Configuration for the method invocation.

Returns:

com.vmware.nsx_policy.model.Constraint

Throws:

com.vmware.vapi.std.errors.InvalidRequest - Bad Request, Precondition Failed

com.vmware.vapi.std.errors.Unauthorized - Forbidden

com.vmware.vapi.std.errors.ServiceUnavailable - Service Unavailable

com.vmware.vapi.std.errors.InternalServerError - Internal Server Error

com.vmware.vapi.std.errors.NotFound - Not Found

update

void update(java.lang.String orgId,
            java.lang.String projectId,
            java.lang.String constraintId,
            Constraint constraint,
            com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback)

Create tenant constraint if it does not exist, otherwise replace the existing constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
com.vmware.nsx_policy.model.Constraint

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

update

void update(java.lang.String orgId,
            java.lang.String projectId,
            java.lang.String constraintId,
            Constraint constraint,
            com.vmware.vapi.bindings.client.AsyncCallback<Constraint> asyncCallback,
            com.vmware.vapi.bindings.client.InvocationConfig invocationConfig)

Create tenant constraint if it does not exist, otherwise replace the existing constraint.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
com.vmware.nsx_policy.model.Constraint

Operation Errors:
InvalidRequest - Bad Request, Precondition Failed
Unauthorized - Forbidden
ServiceUnavailable - Service Unavailable
InternalServerError - Internal Server Error
NotFound - Not Found

Parameters:

orgId - The organization ID (required)

projectId - The project ID (required)

constraintId - (required)

constraint - (required)

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.